Python Package

A pyproject-based Python package managed with PythonSpace. Inherited tasks, one override, one custom task.

The python-package example is a normal uv package (src layout, pyproject.toml, tests) whose bakefile.py inherits PythonSpace instead of writing tasks from scratch:

from bake import command, console
from bakelib import PythonSpace


class MyBakebook(PythonSpace):
    def _get_mise_tools(self) -> set[str]:
        mise_tools = super()._get_mise_tools()
        mise_tools.remove("pipx:bakefile")
        return mise_tools

    # Override an inherited task: same tests, but stop at the first failure
    def test(self) -> None:
        self._test(tests_paths="tests/", extra_args="-x")

    # A project-specific task on top of the space
    @command(help="Build the package into dist/")
    def build(self) -> None:
        self.ctx.run("uv build")


bakebook = MyBakebook()


@bakebook.command()
def hello(name: str = "world"):
    console.echo(f"Hello {name}!")

What it shows

• Inheriting a Space: lint, test, setup-dev, tools, update, version, clean, and more arrive preconfigured (ruff, ty, deptry, pytest with coverage, uv).
• Overriding one inherited task. test reuses the space’s own _test helper with extra_args="-x" to stop at the first failure. No @command() needed, the inherited registration carries over.
• Adding a project-specific task (build) with @command() as usual.
• A private hook tweak: _get_mise_tools drops pipx:bakefile because this project gets bakefile from its own venv (bakefile[lib] in pyproject.toml), so the pipx copy would be redundant.

Try it

cd examples/python-package
bake setup-dev    # install tools, create venv, install pre-commit
bake lint         # prettier, toml-sort, ruff format, ruff, ty, deptry
bake test         # pytest with coverage, stops at first failure (the override)
bake build        # uv build into dist/