Installation
Install venvm from PyPI:
python -m pip install venvm
Usage
Select an environment and script interactively:
venvm
In an interactive terminal, use the arrow keys and Enter or type an option number and press Enter. Numbered prompts remain available in non-interactive terminals.
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. When run from a subdirectory, venvm searches parent
directories for the nearest .venvm.json and uses its directory as the project
root.
Development
Install the repository in editable mode:
python -m pip install -e .
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.3.0.tar.gz.
File metadata
- Download URL: venvm-0.3.0.tar.gz
- Upload date:
- Size: 15.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
94a2df270fe7e6ff7c043967e3e6d776316cde0a7ed61647b9a1aae35df28be3
|
|
| MD5 |
dfca89792f14d54a0a0f59eb7f439cc3
|
|
| BLAKE2b-256 |
ffd0fc8d938a5f56cedb507300b02ed2530ecb1f2feb8416fcc67e75eedbf939
|
Provenance
The following attestation bundles were made for venvm-0.3.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.3.0.tar.gz -
Subject digest:
94a2df270fe7e6ff7c043967e3e6d776316cde0a7ed61647b9a1aae35df28be3 - Sigstore transparency entry: 2325440748
- Sigstore integration time:
-
Permalink:
fastfingertips/venvm@09ebc66005c84b3138ce7fbbccdabd7627ebffd8 -
Branch / Tag:
refs/tags/v0.3.0 - Owner: https://github.com/fastfingertips
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@09ebc66005c84b3138ce7fbbccdabd7627ebffd8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file venvm-0.3.0-py3-none-any.whl.
File metadata
- Download URL: venvm-0.3.0-py3-none-any.whl
- Upload date:
- Size: 12.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 |
0a917fc562098151cbc0b17496e95548b36d3f4d2cd1b40c9214df96668985a4
|
|
| MD5 |
bb0fe49d69b16b5a5a4686f7878154fd
|
|
| BLAKE2b-256 |
57a7881690b8023f9ad8197c797c8908d3f87f0ee7d8f0d8daeb598b0512f64d
|
Provenance
The following attestation bundles were made for venvm-0.3.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.3.0-py3-none-any.whl -
Subject digest:
0a917fc562098151cbc0b17496e95548b36d3f4d2cd1b40c9214df96668985a4 - Sigstore transparency entry: 2325440802
- Sigstore integration time:
-
Permalink:
fastfingertips/venvm@09ebc66005c84b3138ce7fbbccdabd7627ebffd8 -
Branch / Tag:
refs/tags/v0.3.0 - Owner: https://github.com/fastfingertips
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@09ebc66005c84b3138ce7fbbccdabd7627ebffd8 -
Trigger Event:
push
-
Statement type:
