bakefile

bakefile is an Object-Oriented Programming (OOP) task runner designed to streamline the way developers manage tasks. Unlike traditional task systems such as Makefile, which can be cumbersome for reusability across projects, bakefile allows tasks to be defined once and utilized anywhere, leveraging the power of Python classes.

Key Features

• Reusable Tasks: Tasks in bakefile are defined as Python class methods, enabling easy inheritance and sharing, thereby promoting reusable task libraries known as bakelib Spaces.
• Built with Python: Unlike other task runners that require domain-specific languages (DSLs), bakefile employs Python, giving developers access to the full features of the language, including type checking with tools like Ruff and Ty.
• Language-Agnostic: While tasks are written in Python, the commands executed can target multiple programming languages such as Go, Rust, JavaScript, and more, making it versatile for various software development environments.

Getting Started

A quick way to start using bakefile is by defining your tasks in a custom Bakebook:

from bake import Bakebook, command, console

class MyBakebook(Bakebook):
    @command()
    def build(self) -> None:
        console.echo("Building...")
        self.ctx.run("cargo build")

bakebook = MyBakebook()

You can then execute the defined tasks with a simple command:

bake build

To create a new bakefile, use bakefile init or consult the simple example.

For comprehensive documentation, visit bakefile.wisl.dev where you can find resources on:

• Comparing bakefile with other task runners like Make, Just, Task, mise, and Invoke.
• Key concepts including Bakebook, commands, context, and compliance with PEP 723.
• Detailed usage instructions and logging options.
• A complete CLI reference.
• Example scenarios and troubleshooting guides.

Development and Contributions

To contribute to the project, clone the repository and follow the development setup instructions outlined in the accompanying documentation. The project employs uv for dependency management, ensuring efficient project upkeep. Contributions are welcome, and clear guidelines for development can be found in the CLAUDE.md document in the repository.

Learn more about the author at wisl.dev.
Explore the full functionality of bakefile and see how it can enhance your task management processes.