Please see the main documentation. This file is a brief summary of how to use Py-gnumake in your builds.

Py-gnumake is the unholy union of Python and makefiles. It is a GNU make plugin that lets you write portions of your makefiles in Python. Python code run through Py-gnumake has access to makefile variables, functions, and etc., just like regular makefile code.

This module requires GNU make >= 4.0 and currently only supports Python 3.3 or greater. It has currently been tested on Ubuntu Linux only.

First clone the git repo somewhere in your source tree. (Git submodules work nicely for this.) In the Py-gnumake directory you will find the makefile load-python.mk. To use Py-gnumake, simply add the following to your makefile:

include path/to/load-python.mk

This will build Py-gnumake if necessary, and then load it into your makefile. (Including this file multiple times is benign.)

Install Py-gnumake from PYPI, or build it from source. Then add the following to your makefile:

$(eval $(shell python3 -m gnumake))

(Note that while you can import gnumake into any Python script when it is installed in this manner, this module is completely nonfunctional unless invoked from a makefile.)