footman
A task runner with the soul of duty and the UX of typer: typed function signatures become real flags and positionals, modules become nested command groups, independent tasks run in parallel by default, and shell completion answers from a cached manifest in ~25 ms — without importing your code.
Ships two console scripts, footman and the two-letter fm. Zero runtime
dependencies. Python 3.11+.
[!NOTE] Beta. footman is pre-1.0: the surface is settling, but minor versions may still include breaking changes — always called out in the changelog, never in a patch release. Pin the minor (
footman~=0.25.0) if you build on it. The written stability promise lands with 1.0 — the road there is in ROADMAP.md.
Why
duty gets a lot right — the run() capture model, the decorator
ergonomics — and footman keeps those ideas. Where it pushes is the parts
that compound: completion served from a cache instead of re-importing your
project on every TAB (~15× faster, measured), eager type and choice
validation with errors that teach, a DAG scheduler that runs independent
tasks concurrently (the same four-step check lands ~4× sooner than duty
or invoke, measured) with true fail-fast that kills in-flight work on the
first failure, runnable command groups and parameter forwarding that make
composite commands like fm lint and check first-class, a monorepo task
cascade that merges a tasks.py per folder, and a first-party story for
testing your tasks. The receipts live
in the comparison —
every number reproducible from comparison/.
Taste
uv add --dev footman # or: pip install footman
# tasks.py
from footman import task, group, run
from footman.tools import pytest, ruff
@task
def lint(fix: bool = False):
"Run ruff over the project."
ruff.check("src", fix=fix)
@task(pre=[lint])
def test(*pytest_args):
"Run the test suite (extra args after --)."
pytest(*pytest_args)
docs = group("docs", help="Documentation")
@docs.task(infinite=True)
def serve(port: int = 8000):
"Serve the docs locally."
run(f"mkdocs serve -a localhost:{port}")
$ fm lint --fix
$ fm lint test docs.serve --port=8001 # one chain; independent tasks run in parallel
$ fm test -- -k grammar -x # everything after -- goes to pytest
$ fm deploy produ
fm: deploy: <target> must be one of dev|staging|prod (got 'produ') — did you mean 'prod'?
$ fm --install-completion # detects your shell; TAB answers in ~25 ms
Learn more
Documentation — start with Getting started, then the good parts: typed signatures · chaining & parallelism · monorepos · composing tasks · running tools · testing your tasks · completion · CI & automation · comparison with duty / invoke / poe / typer
MIT licensed. The road to 1.0 lives in ROADMAP.md.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file footman-0.25.0.tar.gz.
File metadata
- Download URL: footman-0.25.0.tar.gz
- Upload date:
- Size: 398.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0ba8e4cd6743b77c727a78070d6cbf08fcbb24d50988e4c7c99fa724338b3cdd
|
|
| MD5 |
155cfbc99b24ad6dc26d66796256539e
|
|
| BLAKE2b-256 |
93a7bb00fc6e7d1c616d8253cfc67c0b001c0eeb85d77692a00f511461e90a02
|
Provenance
The following attestation bundles were made for footman-0.25.0.tar.gz:
Publisher:
release.yml on willemkokke/footman
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
footman-0.25.0.tar.gz -
Subject digest:
0ba8e4cd6743b77c727a78070d6cbf08fcbb24d50988e4c7c99fa724338b3cdd - Sigstore transparency entry: 2259867400
- Sigstore integration time:
-
Permalink:
willemkokke/footman@1c0ca8e44581250e35e6dff98e250643ff6be5c6 -
Branch / Tag:
refs/tags/v0.25.0 - Owner: https://github.com/willemkokke
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1c0ca8e44581250e35e6dff98e250643ff6be5c6 -
Trigger Event:
push
-
Statement type:
File details
Details for the file footman-0.25.0-py3-none-any.whl.
File metadata
- Download URL: footman-0.25.0-py3-none-any.whl
- Upload date:
- Size: 442.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eb831a4bd3b015566959126dc27001c3dbd35aa4b9b85361571341bb1e87e674
|
|
| MD5 |
8817b9e9015f57d57d11a2f53f10ea4c
|
|
| BLAKE2b-256 |
9a91f19c4cebd8755759e064ec5045b326a117964cd0498d75543a8f99d756a3
|
Provenance
The following attestation bundles were made for footman-0.25.0-py3-none-any.whl:
Publisher:
release.yml on willemkokke/footman
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
footman-0.25.0-py3-none-any.whl -
Subject digest:
eb831a4bd3b015566959126dc27001c3dbd35aa4b9b85361571341bb1e87e674 - Sigstore transparency entry: 2259867451
- Sigstore integration time:
-
Permalink:
willemkokke/footman@1c0ca8e44581250e35e6dff98e250643ff6be5c6 -
Branch / Tag:
refs/tags/v0.25.0 - Owner: https://github.com/willemkokke
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1c0ca8e44581250e35e6dff98e250643ff6be5c6 -
Trigger Event:
push
-
Statement type:
