Skip to main content

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

  1. Create a Virtual Environment

    • Choose the manager (venv, virtualenv, or conda).
    • Specify the environment name and location.
    • PolyVirt automatically records it in its registry.
  2. List and Search

    • Lists all tracked environments, grouped by manager.
    • Offers a filesystem scan mode to find untracked environments.
  3. 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 for path\Scripts\activate.bat.
  4. Remove Environments

    • Remove environments from the registry only, or remove them from disk entirely (--purge).
  5. Automatic Manager Detection

    • If a selected manager (venv, virtualenv, conda) is not available, PolyVirt will exit gracefully with an informative message.
  6. Custom Decorators

    • Demonstrates usage of decorators (decorators.py) to display environment usage info.
  7. Future GUI

    • Currently, PolyVirt is a CLI tool (via argparse). A future GUI can be built on top of the same modules.

Requirements

  • Python 3.7+
  • colored
  • tqdm

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)

Source distribution for polyvirt 0.1.0
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)

Table of built distributions (wheels) for polyvirt 0.1.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page