foga 0.3.5

Unified developer CLI for Python packages with C and C++ bindings.

foga is a Python package and CLI for developers maintaining Python packages with C or C++ bindings. It replaces ad-hoc repository scripts with a single YAML configuration file that drives build, test, docs, format, lint, install, deploy, inspect, and cleanup workflows.

What foga does

• build Python packages and C++ artifacts from one config file
• run Python and C++ test workflows through one CLI
• run Python and C++ format and lint workflows through one CLI
• generate Python and C++ documentation through one CLI
• install local packages and external dependencies through one CLI
• switch environment-specific settings with named profiles
• inspect the resolved config and planned commands before running anything
• keep escape hatches explicit through structured hooks

Install

pip install foga

Minimal example

project:
  name: demo

build:
  python:
    backend: python-build

test:
  runners:
    unit:
      backend: pytest
      path: tests

For runnable examples that build up gradually, start with examples/tutorial/ or the Examples guide. Each tutorial README lists the local prerequisites, and this repository also includes examples/tutorial/run-example.py if you want to run the tutorials with only Docker and Python instead of installing the example-specific tools locally.

Quick start

foga validate
foga inspect
foga build --dry-run
foga test --dry-run
foga docs --dry-run
foga format --dry-run
foga lint --dry-run
foga install --dry-run
foga deploy --target pypi --dry-run

Python lint targets can use ruff-check or pylint, and C++ lint targets can use clang-tidy.

build.cpp supports both cmake and meson backends for C++ builds, while build.python uses python-build for packaging workflows.

Documentation

• Docs site: https://fedluc.github.io/foga/
• Docs source: docs/
• Example configs: examples/

Start with:

• Getting Started
• Configuration Overview
• CLI Reference
• Examples