Simple - bakefile

The simple example is a standalone bakefile.py: the PEP 723 header at the top declares its own dependencies, so uv creates the environment and nothing else in the directory is required.

# /// script
# requires-python = ">=3.14"
# dependencies = [
#     "bakefile>=0.0.0",
# ]
#
# [tool.uv.sources]
# bakefile = { path = "../../", editable = true }
# ///

import logging
from pathlib import Path

import typer

from bake import Bakebook, command, console, params

logger = logging.getLogger(__name__)


class MyBakebook(Bakebook):
    foo_url: str = "https://example.com"

    @command()
    def foo(self):
        console.echo(f"Doing foo with {self.foo_url}")

    @command()
    def update(
        self,
        fast: params.FastOption = 0,
    ) -> None:
        _ = fast
        self.ctx.run("bakefile lock --upgrade")
        self.ctx.run("bakefile sync")


bakebook = MyBakebook()


@bakebook.command(name="hello")
def hello(name: str = typer.Option("world", help="Name to greet")) -> None:
    logger.debug(f"Hello {name}!")
    logger.info(f"Hello {name}!")
    logger.warning(f"Hello {name}!")
    logger.error(f"Hello {name}!")
    console.echo(f"Hello {name}!")


@bakebook.command()
def cwd() -> None:
    console.out.print(Path.cwd())

What it shows

Both command patterns in one file: @command() on class methods, @bakebook.command() on standalone functions (see Commands).
A typed setting (foo_url) used inside a task (see Settings).
A typed option via params.FastOption, reused from bakefile’s own options.
Log calls at every level, so bake -v hello shows verbosity filtering in action (see Logging).
The dev-only [tool.uv.sources] block pointing at the local repo. A real project would install from PyPI instead (see PEP 723).

Try it

cd examples/simple
bake --help
bake hello --name Alice
bake update      # lock --upgrade + sync for the inline deps

For a pyproject.toml-based project instead, see the python-package example.

Last modified on September 6, 2026