bakefile
An OOP task runner. Write tasks once, reuse everywhere. Like a Makefile, but reusable and in Python.
Documentation: bakefile.wisl.dev
Why bakefile?
- Reusable - Makefile and Justfile work well, but reusing tasks across projects is hard. bakefile makes tasks Python class methods, so you inherit and share them like any other code.
- Python - Write Python instead of a DSL. Real language features, type checking with ruff and ty, and the rest of Python's tooling.
ctx.run()still handles normal CLI commands through subprocess. - Language-agnostic - Tasks are Python, but the commands they run can target any language (Go, Rust, JS, etc.).
Tasks are class methods you inherit, override, and compose, so reusable task libraries (bakelib Spaces) just work. bakefile is new, built on modern typed Python (Typer + Pydantic). Production-proven: I run it daily at my company.
See how bakefile compares to Make, Just, Task, mise, and Invoke in Why bakefile.
Installation
pip install bakefile
Or via uv:
uv tool install bakefile
Quick Start
from bake import Bakebook, command, console
class MyBakebook(Bakebook):
@command()
def build(self) -> None:
console.echo("Building...")
self.ctx.run("cargo build")
bakebook = MyBakebook()
bake build
Generate a bakefile with bakefile init, or start from the simple example. Full walkthrough in the quickstart.
Documentation
Full documentation lives at bakefile.wisl.dev:
- Why bakefile - comparison with Make, Just, Task, mise, and Invoke
- Concepts - Bakebook, commands, context, PEP 723
- Usage - logging, settings
- CLI reference -
bakeandbakefile - bakelib - Spaces, environments, cache, secrets
- Examples and troubleshooting
Development
git clone https://github.com/wislertt/bakefile.git
cd bakefile
uv tool install bakefile
bake setup-dev # Setup development environment (macOS only)
bake assert-setup-dev # Verify the setup is correct
bake test # Unit tests (fast)
bake test-integration # Integration tests (slow, real subprocess)
bake lint # prettier, toml-sort, ruff format, ruff check, ty, deptry
bake setup-dev only supports macOS. On other platforms, run bake --dry-run setup-dev to see the commands and follow platform-specific alternatives.
The project uses uv for dependency management.
Contributing
Contributions are welcome. See CLAUDE.md for development guidelines, including project structure, testing conventions, and the development workflow.
Author
Wisaroot Lertthaweedech – wisl.dev
License
Licensed under the Apache License 2.0. See LICENSE for the full text.
The wordmark in docs/img/brand/ uses outlined paths from Shantell Sans, licensed under the SIL Open Font License 1.1.
1 maintainer
Metadata
1 maintainer
Release files for bakefile 0.0.79
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| bakefile-0.0.79.tar.gz | 86.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bakefile-0.0.79-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 205.4 kB
Release files / bakefile-0.0.79.tar.gz
| Download URL | bakefile-0.0.79.tar.gz |
|---|---|
| Size | 86.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8145558ed9294053fabd72b3ac3408632d1adfb91788245355099d157831d3a1
|
|
BLAKE2b-256 checksum How to use checksums |
b71d49c517b0ff12de0d744fdf609dc6de0521decb524593a905d184b6055473
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.24 {"installer":{"name":"uv","version":"0.12.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / bakefile-0.0.79-py3-none-any.whl
| Download URL | bakefile-0.0.79-py3-none-any.whl |
|---|---|
| Size | 119.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
800544ed700fc49599ce7539c4cbc0ead6a40a9ee0023b69133965d012dfdb8d
|
|
BLAKE2b-256 checksum How to use checksums |
85688d2e390c6679c6d4afb2af50734a8fb4dea775ea99076b4cdaf4f37e95ed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.24 {"installer":{"name":"uv","version":"0.12.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
