Metadata-Version: 2.4
Name: wox
Version: 0.0.4
Summary: A declarative CLI that runs reproducible tasks inside isolated Python environments
Author: wbarillon
License-Expression: MIT
Project-URL: Source, https://gitlab.com/wbarillon/wox
Project-URL: Documentation, https://wbarillon.gitlab.io/wox/
Keywords: cli,command-line,task-runner,workflow,automation,developer-tools,build-tools,reproducible-tasks,workspace-management,python-tools,tooling,utility,make,invoke
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Requires-Python: >=3.11.3
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: colorlog<7.0.0,>=6.0.0
Requires-Dist: mslex<2.0.0,>=1.0.0
Requires-Dist: packaging==25.0
Requires-Dist: rich<15.0.0,>=14.0.0
Provides-Extra: uv
Requires-Dist: uv<0.10.0,>=0.9.0; extra == "uv"
Provides-Extra: doc
Requires-Dist: furo==2025.9.25; extra == "doc"
Requires-Dist: sphinx_design==0.6.1; extra == "doc"
Provides-Extra: dev
Requires-Dist: ruff==0.12.8; extra == "dev"
Requires-Dist: git-cliff==2.10.0; extra == "dev"
Requires-Dist: pre-commit==4.3.0; extra == "dev"
Requires-Dist: coverage==7.10.3; extra == "dev"
Requires-Dist: pytest==8.4.1; extra == "dev"
Requires-Dist: pytest-html==4.1.1; extra == "dev"
Requires-Dist: pytest-rerunfailures==16.1; extra == "dev"
Requires-Dist: pytest-subtests==0.15.0; extra == "dev"
Dynamic: license-file

# wox

[![pipeline status](https://gitlab.com/wbarillon/wox/badges/main/pipeline.svg?key_text=🔄+Pipeline+status&key_width=113)](https://gitlab.com/wbarillon/wox/-/commits/main)
[![coverage report](https://gitlab.com/wbarillon/wox/badges/main/coverage.svg?key_text=✅+Coverage+report&key_width=122)](https://gitlab.com/wbarillon/wox/-/commits/main)

Wox is a lightweight Python task automation tool designed to simplify development workflows.
It allows you to run tasks in isolated Python environments, manage dependencies, and execute commands exactly as you would in your terminal.

With wox, you can:

- Run tests across multiple Python versions effortlessly.
- Automate common tasks like linting, formatting, or documentation generation.
- Execute any shell command or entry point from Python or other languages (Java, C, JavaScript, …) in a controlled environment.
- Keep your workspace clean with ``.wox``, where virtual environments and logs are automatically managed.

Wox gives you **full transparency and control** over your automation: no hidden behaviors, no surprises. You declare your tasks in a ``wox.toml`` or ``pyproject.toml`` file, and wox handles the rest.

## Quickstart

Install with pip:

```bash
pip install wox
```

Or use [pipx][pipx-landing-page] to run wox without Python virtual environments:

```bash
pipx install wox
```

Then, create a task in your ``wox.toml`` and run it with:

```bash
wox
```

Check the documentation for detailed guides and examples.

[pipx-landing-page]: https://pipx.pypa.io/stable/
