foga 1.0.0

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. These repositories often accumulate shell scripts, Make targets, CI snippets, and project notes for each workflow. foga centralizes that workflow definition in one foga.yml file and exposes it through one CLI.

Install

pip install foga

Quick start

Start from one of the examples if you want a working baseline quickly. The tutorial examples are the best starting point for new users, and the larger reference examples show how foga looks in more realistic repositories.

A minimal foga.yml can look like this:

project:
  name: demo

build:
  python:
    backend: python-build

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

After you have created foga.yml, validate and inspect before you run anything for real:

foga validate
foga inspect
foga build --dry-run
foga test --dry-run

Documentation

Full documentation available at https://fedluc.github.io/foga/