Files
archie/examples/skills/archie-wf-python/SKILL.md
T
sam 6c32550345 chore: replace personal owner names in tests and config with generic values
Test fixtures used 'sam', 'samcharles93', and 'sam/<repo>' as owner
names. These are personal and machine-specific — the repo should use
generic placeholders like 'acme' (matching the existing convention in
worktree_test.go).

config.example.toml: samcharles93 -> your-github-username
Test owner: sam -> acme
Repo refs: sam/archie-core -> acme/archie-core, etc.
Example skills: sam -> acme
2026-07-31 02:15:41 +10:00

81 lines
2.1 KiB
Markdown

---
name: ecosystem-python
description: >
Python project conventions for archie-core: venv, pytest, ruff, mypy, pip-audit.
Use when working on Python repositories with archie-core.
version: 1.0.0
metadata:
archie:
tools: [python, pytest, ruff, mypy, pip-audit]
engine: 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.
## Recommended gate configuration
```toml
[[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:
```bash
python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
pip install pytest ruff mypy pip-audit
```
For `pyproject.toml` projects:
```bash
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