mkmake 0.2.0

Generate project and meta Makefiles with a Python API

mkmake

mkmake is a Python package for generating Makefiles for multiple related C projects from code.

Installation

pip install mkmake

Features

• Generate project and meta Makefiles from Python project definitions.
• Model mixed project types with a shared API (CProject, YYProject, TestProject).
• Discover and wire header dependencies for C projects.
• Inject dependency include paths and library linkage across project boundaries.
• Let TestProject opt into dependency private headers for unit-test-only coupling.
• Configure build variants through debug and test generation flags.

Quick Start

from mkmake import make_projects
from mkmake.projects import CProject, TestProject, YYProject

Define projects in a dictionary, then call make_projects(...) with build flags:

projects = {
    "core": CProject("core", output_name="libcore.a"),
    "parser": YYProject("parser", output_name="libparser.a", depends=["core"]),
    "tests": TestProject("tests", test_command="python3 {0} {1}", depends=["core", "parser"]),
}
make_projects(projects, debug=True, test=True)

If test code needs a dependency's private headers from src/include, opt in explicitly:

"tests": TestProject(
    "tests",
    test_command="python3 {0} {1}",
    depends=["core", "parser"],
    private_depends=["core"],
)

Notes:

• private_depends is test-only and should be used sparingly.
• Every private_depends entry must also be present in depends.
• On header basename collisions, local project headers remain authoritative.

Full usage example: examples/generic_make.py

Limitations

• package-only API surface
• no CLI in package code