Skip to main content

tests release quality-gate-status security-rating vulnerabilities codecov ruff ty pypi status license downloads python

bakefile logo

bakefile

An OOP task runner. Write tasks once, reuse everywhere. Like a Makefile, but reusable and in Python.

Documentation: bakefile.wisl.dev

Define tasks as Python methods, list them, and run them with bake

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:

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.

Metadata

Release files for bakefile 0.0.83

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bakefile 0.0.83
File Size Uploaded Provenance Actions
bakefile-0.0.83.tar.gz 107.2 kB Without provenance Details for bakefile-0.0.83.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for bakefile 0.0.83
File Interpreter ABI Platform Actions
bakefile-0.0.83-py3-none-any.whl Python 3 none any Details for bakefile-0.0.83-py3-none-any.whl

Total release size: 243.4 kB

Release files / bakefile-0.0.83.tar.gz

Download URL bakefile-0.0.83.tar.gz
Size 107.2 kB
Tags Source
SHA-256 checksum
How to use checksums
097c5171e2f7a5b608a1428c572f4b19887a71c568caaa68d5fa77f6adb31ff4
BLAKE2b-256 checksum
How to use checksums
f7b7572d61af4705b70a51d37226246d2ff444b0aeb808d3b7e0b9c6854dae30
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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.83-py3-none-any.whl

Download URL bakefile-0.0.83-py3-none-any.whl
Size 136.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
04d34a5b41b7275f24ef6579a2504f22bcccc1750b719aaac99c18e80b238942
BLAKE2b-256 checksum
How to use checksums
5402f78392afec594dc92bdd0e0519a0aed0db651b7b6c9bdeb7ea89a855f88d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for bakefile 0.0.83

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.83 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page