Overview

Brujería is a python library that simplifies development workflow for native
extensions. It does this by providing import hooks that allow you to compile
your extensions on import (much like cppimport) so you can play around with
the API in a REPL. Lastly, it provides some hooks so that using these from
tools like poetry are just a single line. It does all of this via CMake, but
in a way to reduce the need to touch CMake in the first place.

Brujería currently utilizes IXM to reduce the overhead of
maintaining a CMake project.

Features

Currently, Brujería provides the following:

• Automatic discovery of C and C++ extensions.
• Basic MinGW Support (CPython does not guarantee this)
• Works on Windows, macOS, and Linux
• The ability to mix C and C++ in a single extension (distutils/

  `setuptools` do not currently permit this)

• Basic poetry integration via preprovided build function.
• pyproject.toml integration for configuration settings

Why the name?

Brujería is a spanish word for “witchcraft”. Given the strange, mystic, and
sometimes arcane steps that distutils and setuptools must take when building
native extensions, it only makes sense that a library that takes advantage of
various undocumented hooks might be labelled Black Magic.