PolyVirt
PolyVirt is a Python CLI tool to create, track, and manage virtual environments across different environment managers (such as venv, virtualenv, and conda). It maintains a simple JSON-based registry and can optionally search your filesystem for untracked environments. It also allows for removing environments from the registry or completely deleting them from disk.
Features
-
Create a Virtual Environment
- Choose the manager (
venv,virtualenv, orconda). - Specify the environment name and location.
- PolyVirt automatically records it in its registry.
- Choose the manager (
-
List and Search
- Lists all tracked environments, grouped by manager.
- Offers a filesystem scan mode to find untracked environments.
-
Activate and Switch
- You can select/activate a virtual environment from your tracked list.
- On Unix-like shells, you’ll see instructions for
source path/bin/activate; on Windows, instructions forpath\Scripts\activate.bat.
-
Remove Environments
- Remove environments from the registry only, or remove them from disk entirely (
--purge).
- Remove environments from the registry only, or remove them from disk entirely (
-
Automatic Manager Detection
- If a selected manager (
venv,virtualenv,conda) is not available, PolyVirt will exit gracefully with an informative message.
- If a selected manager (
-
Custom Decorators
- Demonstrates usage of decorators (
decorators.py) to display environment usage info.
- Demonstrates usage of decorators (
-
Future GUI
- Currently, PolyVirt is a CLI tool (via
argparse). A future GUI can be built on top of the same modules.
- Currently, PolyVirt is a CLI tool (via
Requirements
- Python 3.7+
coloredtqdm
Install dependencies using:
pip install -r requirements.txt
Installation
Install PolyVirt locally in editable mode:
cd polyvirt
pip install -e .
To install from PyPI (after it is published):
pip install polyvirt
Run it:
polyvirt --help
Usage
Create a new environment
polyvirt create --manager venv --name myenv --path /home/user/myenv
Create a Conda environment
polyvirt create --manager conda --name condaenv --path /home/user/condaenv
List tracked environments
polyvirt list
Scan filesystem for untracked environments
polyvirt scan --start /home/user --max-depth 4
Show activation instructions for an environment
polyvirt activate --name myenv
Remove environment from registry only
polyvirt remove --name myenv
Remove environment from registry AND delete from disk
polyvirt remove --name myenv --purge
License
PolyVirt is licensed under the MIT License. See LICENSE for details.
Metadata
Release files for polyvirt 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| polyvirt-0.1.0.tar.gz | 9.1 kB | Without provenance | Details for polyvirt-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| polyvirt-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for polyvirt-0.1.0-py3-none-any.whl |
Total release size: 20.3 kB
Release files / polyvirt-0.1.0.tar.gz
| Download URL | polyvirt-0.1.0.tar.gz |
|---|---|
| Size | 9.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b81b66d6af5aea7fb884ad249551d6442a882c29ce467232ff8bb81af6cb7c83
|
|
BLAKE2b-256 checksum How to use checksums |
7d4879c2b55c3938f9d20ed1152000a3c38ad16bc619eba4528d91a744115460
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.12.3
|
Release files / polyvirt-0.1.0-py3-none-any.whl
| Download URL | polyvirt-0.1.0-py3-none-any.whl |
|---|---|
| Size | 11.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d015cc3a20bf420a66978884ca1cf52c6a47b8f82231fff12eb731a66a1d5dc7
|
|
BLAKE2b-256 checksum How to use checksums |
7d76c6204bee0fbf7a132d6fe179aea85a4126d0b4e58d602e0f2a846d3f8510
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.12.3
|
Security for polyvirt 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.