Files
archie/examples/skills/archie-wf-python/SKILL.md
T

2.1 KiB

name, description, version, metadata
name description version metadata
ecosystem-python Python project conventions for archie-core: venv, pytest, ruff, mypy, pip-audit. Use when working on Python repositories with archie-core. 1.0.0
archie
tools engine
python
pytest
ruff
mypy
pip-audit
any

Python Ecosystem Conventions

Preflight

When archie-core's [[repos]] entry sets ecosystem = "python", the daemon runs python --version as the preflight check before any agent stage.

[[repos]]
owner = "acme"
name = "my-python-project"
ecosystem = "python"

[[repos.gate]] = ["ruff", "check", "."]
[[repos.gate]] = ["ruff", "format", "--check", "."]
[[repos.gate]] = ["mypy", "."]
[[repos.gate]] = ["pytest", "-x", "--tb=short"]

Test glob

The default test glob for Python is test_*.py. The TDD workflow's repro-tests stage write-protects files matching this glob during the fix stage.

Override with test_glob = "tests/**/*.py" in the repo config for projects with test files outside the package root.

Package management

arcie-core assumes:

  • requirements.txt or pyproject.toml at the repo root
  • Tests run with pytest (the ecosystem default)
  • Linting with ruff (recommended) or flake8
  • Type checking with mypy
  • Security auditing with pip-audit

Virtual environment

Before the gate runs, ensure dependencies are installed:

python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
pip install pytest ruff mypy pip-audit

For pyproject.toml projects:

pip install -e ".[dev]"

Common gate failures

ruff

  • F401: unused import -- remove it
  • E501: line too long -- break the line
  • I001: import order -- let ruff fix it with ruff check --fix

mypy

  • Missing type annotation on public function -- add it
  • Cannot determine type -- add explicit annotation
  • Import errors -- check the package is installed in the venv

pytest

  • Test discovery failed -- check __init__.py files and test naming
  • Import errors -- verify the package is installed (pip install -e .)
  • Assertion failures -- fix the code, not the test