What is this?

This is a simple project demonstrating how to build a C++ library using SPM and wrap it into a Python package.

Building

First, make sure you have Swift installed. I only verified it on macOS with Xcode installed, but theoretically should work on Linux and Windows as well.

Also, make sure you have uv installed, this is what we will use here to manage Python dependencies.

Then, create a Python environment. Python project is the entry point for the build process:

uv venv
source venv/bin/activate

Then, install dev dependencies:

uv pip install -r requirements_dev.txt

Finally, build the project:

./build.sh

This will:

• build the C++ library using SPM as an external command
• build Python bindings using pybind11
• link the C++ library with the Python bindings
• create a Python package

You can now install the Python package with:

uv pip install dist/parallel_sum-*.whl

Examples

There are three example in the examples directory:

• sum_example.py - demonstrates how to use the library with a simple function
• callback_example.py - demonstrates how to use the library with a callback back to Python
• parallel_example.py - demonstrates how native threads can call back to Python through GIL

After installing the package, just run them:

python ./examples/parallel_example.py