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             # oxfmt, toml-sort, ruff format, ruff check, ty, deptry
bake lint --slow      # adds the locked-pins guard (CI runs this)

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 CONTRIBUTING.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.85

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.85
File Size Uploaded Provenance Actions
bakefile-0.0.85.tar.gz 113.3 kB Without provenance Details for bakefile-0.0.85.tar.gz

Built distribution (wheel)

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

Total release size: 250.6 kB

Release files / bakefile-0.0.85.tar.gz

Download URL bakefile-0.0.85.tar.gz
Size 113.3 kB
Tags Source
SHA-256 checksum
How to use checksums
1a6f74c881840edb7c3a67105b4a8aee2b79cf4cacc06f31b1e8b01dfc3ea5a9
BLAKE2b-256 checksum
How to use checksums
0a9779f4d64b6d05d124c52f965015a63f625fe65f16c0cd1316166585d9da9a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","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.85-py3-none-any.whl

Download URL bakefile-0.0.85-py3-none-any.whl
Size 137.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
323ff790ed41993e0b156e4957b7c8ea4a9a85d018b23865901bed11fd8dff98
BLAKE2b-256 checksum
How to use checksums
0452229277084403bb946786bc8541d71ae382e5948de517042430c969d9b0cd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","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.85

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.85 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