Metadata-Version: 2.4
Name: envoic
Version: 0.0.4
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: typer>=0.9.0
Provides-Extra: rich
Requires-Dist: rich>=13.0.0; extra == 'rich'
Description-Content-Type: text/markdown

# envoic

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`.

- Docs: https://mahimailabs.github.io/envoic/
- PyPI: https://pypi.org/project/envoic/

## Install

```bash
uv tool install envoic
# or
pipx install envoic
```

Run without installing:

```bash
uvx envoic scan .
```

## Usage

```bash
envoic scan [PATH]
envoic list [PATH]
envoic info <ENV_PATH>
envoic version
```

Common examples:

```bash
envoic scan . --deep
envoic scan . --json
envoic scan . --path-mode name      # name | relative | absolute
envoic list . --path-mode relative
envoic info .venv
```

## Local Development

```bash
uv sync --group dev
uv run pytest
uv run python -m envoic.cli scan . --deep --path-mode name
```

## License

BSD-3-Clause
