Python Toolchain

Name: toolchain-python
Rating: 88
Author: ThinkfleetAI

Common commands for Python projects.

Virtual environments

bash

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

bash

# Poetry
poetry install
poetry shell
poetry add requests
poetry add --group dev pytest

bash

# uv (fast)
uv venv
uv pip install -r requirements.txt
uv pip install requests

Testing

bash

# pytest
python3 -m pytest
python3 -m pytest -v --tb=short
python3 -m pytest tests/test_api.py -k "test_login"
python3 -m pytest --cov=src --cov-report=term-missing

# unittest
python3 -m unittest discover -s tests

Linting & formatting

bash

# Ruff (fast, replaces flake8+isort+black)
ruff check .
ruff check --fix .
ruff format .

# Black
black .

# Mypy (type checking)
mypy src/

Running

bash

python3 src/main.py
python3 -m mypackage

# Flask
flask run --debug

# Django
python3 manage.py runserver
python3 manage.py migrate
python3 manage.py createsuperuser

Debugging

bash

python3 -m pdb src/main.py         # PDB debugger
python3 -c "import sys; print(sys.version)"
python3 -c "import pkg; print(pkg.__version__)"

Packaging

bash

pip install build
python3 -m build                    # Build wheel + sdist
pip install -e .                    # Editable install

Dependencies

bash

pip list --outdated
pip freeze > requirements.txt
pip-audit                           # Security audit

Notes

•Check for pyproject.toml, setup.py, or requirements.txt to understand project structure.
•Prefer virtual environments to avoid global package conflicts.
•Use python3 explicitly (not python) for portability.