pylax

Zero-friction Python environment orchestrator.

Never activate. Never guess. Always be correct.

pylax removes the need for source .venv/bin/activate by directly dispatching commands to your project's virtual environment.

The Core Idea

Most Python projects start with:

python -m venv .venv
source .venv/bin/activate  # <-- The friction point
pip install -r requirements.txt

With pylax, you just do:

pylax init
pylax run app.py

pylax effectively runs .venv/bin/python app.py. It is not a shell tool; it is a dispatcher.

Installation

pip install pylax

Or for global safety (recommended):

pipx install pylax

Usage

Initialize a Project

Creates .venv, upgrades pip, and installs requirements.txt (if present).

cd myproject
pylax init

Run a Script

Runs the script using the project's virtual environment.

pylax run app.py

Equivalent to: .venv/bin/python app.py

Run a Command

Run any executable from the venv (like pip, black, pytest).

pylax run pip list
pylax run pytest

Spawn a Shell (Optional)

If you really need a shell where python and pip map to the venv versions:

pylax shell

Structure

Pylax enforces a standard, clean structure:

• Virtual environments are always named .venv.
• It relies on standard requirements.txt.
• It works on macOS, Linux, and Windows.

Development & Testing

Running Tests

We use pytest for testing.

1. Initialize the dev environment:

   # You can even use pylax to develop pylax!
   python3 -m venv .venv
   .venv/bin/pip install -e .[test]
   

2. Run tests:

   pytest
   

License

MIT © Nuhman PK