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

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.84
File Size Uploaded Provenance Actions
bakefile-0.0.84.tar.gz 107.7 kB Without provenance Details for bakefile-0.0.84.tar.gz

Built distribution (wheel)

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

Total release size: 244.6 kB

Release files / bakefile-0.0.84.tar.gz

Download URL bakefile-0.0.84.tar.gz
Size 107.7 kB
Tags Source
SHA-256 checksum
How to use checksums
21a0981d75f02615909fe79c2f6d280028a87fe8dbf61bbc9099800183105284
BLAKE2b-256 checksum
How to use checksums
c1e5e3206907a5ee49c8113bf5d04a532411dfb07971885a2370f99dcd1e8961
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.84-py3-none-any.whl

Download URL bakefile-0.0.84-py3-none-any.whl
Size 136.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c2b7c0669570cef5ba0abf3043abdc65e51369cc2fe57dab73e252baed8bea31
BLAKE2b-256 checksum
How to use checksums
146334717b57616d104db99ebde7b6b17a74b4ec801d89e1ef8b5008fc2e4f85
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.84

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