Metadata-Version: 2.4
Name: envoic
Version: 0.0.5
Summary: Discover and report Python virtual environments on your system
Project-URL: Homepage, https://github.com/mahimailabs/envoic
Project-URL: Repository, https://github.com/mahimailabs/envoic
Project-URL: Issues, https://github.com/mahimailabs/envoic/issues
Author-email: Mahimai <hello@mahimai.dev>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: <4,>=3.11
Requires-Dist: questionary>=2.0.0
Requires-Dist: typer>=0.9.0
Provides-Extra: rich
Requires-Dist: rich>=13.0.0; extra == 'rich'
Description-Content-Type: text/markdown

<p align="center">
  <img src="assets/envoic.png" width="1000" alt="envoic logo" />
</p>

<p align="center">
  <a href="https://coderabbit.ai">
    <img alt="CodeRabbit Pull Request Reviews" src="https://img.shields.io/coderabbit/prs/github/mahimailabs/envoic?utm_source=oss&utm_medium=github&utm_campaign=mahimailabs%2Fenvoic&labelColor=171717&color=FF570A&link=https%3A%2F%2Fcoderabbit.ai&label=CodeRabbit+Reviews" />
  </a>
  <a href="https://pypi.org/project/envoic/">
    <img alt="PyPI version" src="https://img.shields.io/pypi/v/envoic" />
  </a>
  <a href="https://pypi.org/project/envoic/">
    <img alt="Python versions" src="https://img.shields.io/pypi/pyversions/envoic" />
  </a>
  <a href="LICENSE">
    <img alt="License" src="https://img.shields.io/github/license/mahimailabs/envoic" />
  </a>
  <a href="https://mahimailabs.github.io/envoic/">
    <img alt="Docs" src="https://img.shields.io/badge/docs-GitHub%20Pages-222222?logo=githubpages" />
  </a>
</p>

---

Discover Python virtual environments and report them in a compact terminal layout.


> [!WARNING]
> `envoic` is still experimental and therefore subject to major changes across releases. Breaking changes may occur until `v1.0.0`.



# Installation

```bash
$ uv tool install envoic

# or

$ pipx install envoic
```

Run without installing:

```bash
$ uvx envoic scan .
```



# Sample Outputs

## 1. Scan

Scan the current directory for Python virtual environments.
Use `--depth` to control recursion and `--deep` to include size/package metadata.

<img src="assets/scan_sample.png" alt="envoic scan command output" width="900" />

## 2. List

List discovered Python virtual environments in a compact table.

<img src="assets/list_sample.png" alt="envoic list command output" width="900" />

## 3. Info

Get the information about the Python virtual environment in the current directory.

<img src="assets/info_sample.png" alt="envoic info command output" width="900" />

## 4. Manage

Interactively select environments and delete the selected ones with confirmation.

<img src="assets/manage_sample.png" alt="envoic manage command output" width="900" />

## 5. Clean

Delete stale environments in batch mode (supports `--dry-run` and confirmation).

<img src="assets/clean_sample.png" alt="envoic clean command output" width="900" />

## Usage

```bash
$ envoic scan [PATH]

$ envoic list [PATH]

$ envoic manage [PATH]

$ envoic clean [PATH]

$ envoic info <ENV_PATH>

$ envoic version
```

Read more at [Documentation](https://mahimailabs.github.io/envoic/)


## Local Development

```bash
$ uv sync --group dev

$ uv run pytest

$ uv run python -m envoic.cli scan . --deep --path-mode name
```

## License

[MIT](LICENSE)
