Skip to content

Configuration

load_bigfoot_config 

load_bigfoot_config(start=None)

Walk up from start (default: Path.cwd()) to find pyproject.toml.

Returns the [tool.bigfoot] table as a dict, or {} if: - no pyproject.toml found in start or any ancestor directory - pyproject.toml found but has no [tool.bigfoot] section

Raises tomllib.TOMLDecodeError if pyproject.toml is malformed. This is intentional: a malformed pyproject.toml is a user error that must not silently produce empty config.

Source code in src/bigfoot/_config.py 
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
def load_bigfoot_config(start: Path | None = None) -> dict[str, Any]:
    """Walk up from start (default: Path.cwd()) to find pyproject.toml.

    Returns the [tool.bigfoot] table as a dict, or {} if:
    - no pyproject.toml found in start or any ancestor directory
    - pyproject.toml found but has no [tool.bigfoot] section

    Raises tomllib.TOMLDecodeError if pyproject.toml is malformed.
    This is intentional: a malformed pyproject.toml is a user error that
    must not silently produce empty config.
    """
    search = start or Path.cwd()
    for directory in (search, *search.parents):
        candidate = directory / "pyproject.toml"
        if candidate.is_file():
            with candidate.open("rb") as f:
                data = tomllib.load(f)
            result: dict[str, Any] = data.get("tool", {}).get("bigfoot", {})
            return result
    return {}