Improved build system generator for CPython C/C++/Fortran/Cython extensions.
Better support is available for additional compilers, build systems, cross compilation, and locating dependencies and determining their build requirements.
The scikit-build package is fundamentally just glue between
the setuptools Python module and CMake.
To get started, see this example and scikit-build-sample-projects.
| Versions | Downloads |
|---|---|
Please use the first citation when referencing scikit-build in scientific publications.
- Jean-Christophe Fillion-Robin, Matt McCormick, Omar Padron, Max Smolens, Michael Grauer, & Michael Sarahan. (2018, July 13). jcfr/scipy_2018_scikit-build_talk: SciPy 2018 Talk | scikit-build: A Build System Generator for CPython C/C++/Fortran/Cython Extensions. Zenodo. https://doi.org/10.5281/zenodo.2565368
- Schreiner, Henry, Rickerby, Joe, Grosse-Kunstleve, Ralf, Jakob, Wenzel, Darbois, Matthieu, Gokaslan, Aaron, Fillion-Robin, Jean-Christophe, & McCormick, Matt. (2022, August 1). Building Binary Extensions with pybind11, scikit-build, and cibuildwheel. https://doi.org/10.25080/majora-212e5952-033
PyCMake was created at SciPy 2014 in response to general difficulties building C++ and Fortran based Python extensions across platforms. It was renamed to "scikit-build" in 2016.
These issues are likely to be addressed in upcoming releases.
- Editable installs do not work with the latest versions of Setuptools (and had issues with older versions, too).
- Configuration scikit-build cares about _must_ be specified in
setup()currently. - The cache directory (
_skbuild) may need to be deleted between builds in some cases (like rebuilding with a different Python interpreter).
We are also working on improving scikit-build, so there are some upcoming changes and deprecations:
- All deprecated setuptools/distutils features are also deprecated in
scikit-build, like the
testcommand,easy_install, etc. - Older versions of CMake (<3.15) are not recommended; a future version will remove support for older CMake's (along with providing a better mechanism for ensuring a proper CMake is available).
If you need any of these features, please open or find an issue explaining what and why you need something.
- Free software: MIT license
- Documentation: http://scikit-build.readthedocs.org
- Source code: https://github.com/scikit-build/scikit-build
- Discussions: https://github.com/orgs/scikit-build/discussions
Support for this work was provided by NSF cooperative agreement OAC-2209877.