venvm
venvm selects a Python virtual environment in the current directory and runs
a Python script or module with that environment's interpreter.
Installation
Install the development version from the repository:
python -m pip install -e .
Usage
Select an environment and script interactively:
venvm
Run a script with arguments:
venvm app.py --port 8000
Select an environment explicitly or use the system interpreter:
venvm --env .venv app.py
venvm --system app.py
Run a Python module:
venvm --env .venv --module pytest -q
venvm --system --module http.server 8000
Values after --module are passed directly to the module. Place environment
options before --module.
List detected environments without running anything:
venvm --list
--yes accepts confirmation prompts. If multiple environments exist, .venv
is used when available. Otherwise, specify the environment with --env.
Use --install-deps to install detected dependency sources without additional
confirmation. --yes alone never installs dependencies automatically.
The command scans direct children of the current directory for pyvenv.cfg and
the platform-specific Python executable. If no environment exists, it offers to
create .venv. The system Python interpreter remains available as an option.
After creating an environment, venvm detects requirements.txt,
requirements-dev.txt, and pyproject.toml. It asks for confirmation before
installing each source.
Project Configuration
Add .venvm.json to the project root to define defaults:
{
"environment": ".venv",
"script": "app.py"
}
For a module:
{
"environment": ".venv",
"module": "pytest"
}
script and module cannot be used together. Command-line values override the
configuration file.
Development
Run the standard-library test suite:
python -m unittest discover -s tests
Roadmap
Planned configuration and project management work is tracked in
.github/TODO.md.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file venvm-0.1.0.tar.gz.
File metadata
- Download URL: venvm-0.1.0.tar.gz
- Upload date:
- Size: 11.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d28c433f748d43c4677481509164c56a2a158a7b5d4d866edfc09dd5f39b6ab8
|
|
| MD5 |
bc3f288e2632eee0ce9b1d96abc7b131
|
|
| BLAKE2b-256 |
1a9003fa32d0a8c8fd6824b2e7ffd022653b252ee33dbb7e0832d214bb1b8b3b
|
Provenance
The following attestation bundles were made for venvm-0.1.0.tar.gz:
Publisher:
release.yml on fastfingertips/venvm
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
venvm-0.1.0.tar.gz -
Subject digest:
d28c433f748d43c4677481509164c56a2a158a7b5d4d866edfc09dd5f39b6ab8 - Sigstore transparency entry: 2324032421
- Sigstore integration time:
-
Permalink:
fastfingertips/venvm@3732b9d8bea9d47ac56017cb4679389550245698 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/fastfingertips
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@3732b9d8bea9d47ac56017cb4679389550245698 -
Trigger Event:
push
-
Statement type:
File details
Details for the file venvm-0.1.0-py3-none-any.whl.
File metadata
- Download URL: venvm-0.1.0-py3-none-any.whl
- Upload date:
- Size: 9.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5912f56cfd6ca4c81b4bae15dd48474e5ee8c346bd23209cbb27dd06ccf1fea8
|
|
| MD5 |
60fd6821dfc94665f97f6a992d6dbab4
|
|
| BLAKE2b-256 |
238091f9c2391fcbdfd63d93a0b7ad5c8b0cb0059cb486415da414fd67c937f6
|
Provenance
The following attestation bundles were made for venvm-0.1.0-py3-none-any.whl:
Publisher:
release.yml on fastfingertips/venvm
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
venvm-0.1.0-py3-none-any.whl -
Subject digest:
5912f56cfd6ca4c81b4bae15dd48474e5ee8c346bd23209cbb27dd06ccf1fea8 - Sigstore transparency entry: 2324032574
- Sigstore integration time:
-
Permalink:
fastfingertips/venvm@3732b9d8bea9d47ac56017cb4679389550245698 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/fastfingertips
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@3732b9d8bea9d47ac56017cb4679389550245698 -
Trigger Event:
push
-
Statement type:
