setuptools-cpp

setuptools-cpp

Simplified packaging for pybind11-based C++ extensions

Build Coverage Netlify status
Package version

Documentation: https://setuptools-cpp.davidmontague.xyz

Source Code: https://github.com/dmontagu/setuptools-cpp

Features

  • Pybind11Extension: For standard Pybind11 extensions from C++ source files
  • CMakeExtension: Useful for incorporating CMake-dependent libraries like CGAL
  • Poetry Compatibility: Easy to use with poetry‘s custom build system

Basic Usage

You can use the CMakeExtension or Pybind11Extension classes in your setup.py as follows:

from setuptools import setup

from setuptools_cpp import CMakeExtension, ExtensionBuilder, Pybind11Extension

ext_modules = [
    # A basic pybind11 extension in <project_root>/src/ext1:
    Pybind11Extension(
        "my_pkg.ext1", ["src/ext1/ext1.cpp"], include_dirs=["src/ext1/include"]
    ),
    # An extension with a custom <project_root>/src/ext2/CMakeLists.txt:
    CMakeExtension(f"my_pkg.ext2", sourcedir="src/ext2")
]

setup(
    name="my_pkg",
    version="0.1.0",
    packages=["my_pkg"],
    # ... other setup kwargs ...
    ext_modules=ext_modules,
    cmdclass=dict(build_ext=ExtensionBuilder),
    zip_safe=False,
)

You can then use standard setuptools commands like python setup.py install.

See the User Guide for more details.

Requirements

This package is intended for use with Python 3.6+.

Installation

pip install setuptools-cpp

License

This project is licensed under the terms of the MIT license.