This releases backports additions for Windows ARM cross-compiling via cibuildwheel from scikit-build-core 0.1.4.

• Initial experimental support for Windows ARM cross-compile in #824 and #818
• Replace mailing list with GitHub Discussions board in #823
• Some CI updates in #811 and #812

Full Changelog: https://github.com/scikit-build/scikit-build/compare/0.16.3...0.16.4

This release fixes logging issues using setuptools 65.6+ affecting our tests. Pytest 7.2+ is now supported. setup.py <command> and setup_requires are deprecated, and tests are marked as such.

• Fix typo in usage.rst in #795, thanks to @chohner.
• Support pytest 7.2+ in #801.
• Change warning filtering in #802.
• Handle logging changes in setuptools 65.6+ in #807.
• Add deprecated markers to some tests in #807.
• Allow known warnings to show up in the tests #807.

New Contributors

• @chohner made their first contribution in https://github.com/scikit-build/scikit-build/pull/795

Full Changelog: https://github.com/scikit-build/scikit-build/compare/0.16.2...0.16.3

This addresses one more small regression with the FindPython change from 0.16.0 that was affecting conda. #793

This was a quick patch release that fixed a missing Python requires setting and some missing files #790, and addressed a warning from setuptools in the tests.

• Ignored distutils warning #785. Thanks to @bnavigator!

This release adds support for Python 3.11 and removes support for Python 2.7 and 3.5 (#688). Testing and static checking improved, including being fully statically typed internally (though setuptools is not fully typed, so it is of limited use).

All deprecated setuptools/distutils features are also deprecated in scikit-build, like the test command, easy_install, etc. Editable mode is still unsupported. Python 3.6 support is deprecated. 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.

New Features

• Cython module now supports FindPython mode. #743
• PyPy is discovered without extra settings in FindPython mode #744

Bug fixes

• FindPython mode uses a new path specification, should help make it usable. #774
• Better flushing and output streams for more consistent output ordering. #781

This release is the final (again) release for Python < 3.6 and MSVC<2017. Support for FindPython from CMake 3.12+ was added, including FindPython2. Support for Cygwin added.

New Features

• Add support for FindPython (including 2 and 3). Thanks @hameerabbasi for the contribution. See #712.
• Add support for Cygwin. Thanks @ax3l and @DWesl and @poikilos for the help! See #485.

Bug fixes

• Fixed issue with distutils usage in Python 3.10. Thanks to @SuperSandro2000 for the contribution in #700.

This release fixes a regression, and reverts a fix in 0.14.0. Some changes made to CI to fix recent removals.

Bug fixes

• Fix issue with SKBUILD_CONFIGURE_OPTIONS not being read.
• Reverted manifest install changes.

This is the final release for Python <3.6 and MSVC<2017.

New Features

• Add support for --install-target scikit-build command line option. And cmake_install_target in setup.py. Allows providing an install target different than the default install. Thanks @phcerdan for the contribution. See #477.

Bug fixes

• The manifest install location computation was fixed. Thanks @kratsg for the contribution in #682.
• Byte-compilation was skipped due to a missing return. Thanks @pekkarr in #678.
• Packages can now be computed from the same shared collections, before this could confuse Scikit-build. Thanks @vyasr in #675.
• Fixed library detection for PyPy 3.9. Thanks @rkaminsk in #673.

Internal

• Scikit-build now uses pyproject.toml and setuptools_scm to build. If you are packaging scikit-build itself, you might need to update your requirements. See #634.
• The codebase is now formatted with Black. #665

This release fixes two bugs affecting Windows. Users should use "ninja; platform_system!='Windows'", at least for now, since MSVC ships with Ninja, and that Ninja is better at finding the matching MSVC than the Python package is. Including it may slow down the search and force the IDE generator instead, but will at least no longer discover GCC instead.

Bug fixes

• On Windows, don't let Ninja find something other than what it's supposed to look for. Ensure the Ninja package is used for the search, just like normal runs, if installed. #653
• Do not throw an error when printing info and a logger is disconnected. #652

This is likely one of the final releases to support Python 2.7 and 3.5; future releases will likely target at least Python 3.6+ and MSVC 2017+.

If you are using scikit-build via pyproject.toml, please remember to include setuptools and wheel. A future version of scikit-build may remove the setuptools install-time hard requirement.

New Features

• CMake module /cmake-modules/Cython now uses Cython default arguments. This no longer adds --no-docstrings in Release and MinSizeRel builds, so Cython docstrings are now retained by default. Additionally, --embed-positions is no longer added to Debug and RelWithDebInfo builds. Users can enable these and other Cython arguments via the option CYTHON_FLAGS. See #518 and #519, thanks to @bdice for the improvement.
• Experimental support for ARM64 on Windows. Thanks to @gaborkertesz-linaro in #612.
• Support for MSVC 2022. Thanks to @tttapa for the contribution in #627.
• Support the modern form of target_link_libraries, via SKBUILD_LINK_LIBRARIES_KEYWORD (somewhat experimental). Thanks to @maxbachmann in #611.

Bug fixes

• Update the Ninja path if using the ninja package. This fixes repeated isolated builds. Further path inspection and updates for isolated builds may be considered in the future. #631, thanks to @RUrlus and @segevfiner for help in tracking this down.
• Allow OpenBSD to pass the platform check (untested). See #586.
• Avoid forcing the min macOS version. Behaviour is now inline with setuptools. Users should set MACOSX_DEPLOYMENT_TARGET when building (automatic with cibuildwheel), otherwise you will get the same value Python was compiled with. Note: This may seem like a regression for PyPy until the next release (7.3.8), since it was compiled with 10.7, which is too old to build with on modern macOS - manually set MACOSX_DEPLOYMENT_TARGET (including setting it if unset in your setup.py) for PyPy until 7.3.8. #607
• Fix logging issue when using Setuptools 60.2+. #623
• MacOS cross compiling support fix (for conda-forge) for built-in modules. Thanks to @isuruf for the contribution in #622.
• Better detection of the library path, fixes some issues with PyPy. Thanks to @rkaminsk for the contribution in #620 and #630. PyPy is now part of our testing matrix as of #624. Also @robtaylor in #632.
• Fixed issue when cross-compiling on conda-forge (probably upstream bug, but easy to avoid). #646.

The scikit-build GitHub organization welcomes henryiii and mayeut as core contributors and maintainers. Both are also maintainers of cibuildwheel.

@henryiii is a pybind11 and pypa/build maintainer, has been instrumental in adding Apple Silicon support, adding support for Visual Studio 2019, updating the Continuous Integration infrastructure, as well as helping review & integrate contributions, and addressing miscellaneous issues. Additionally, henryiii has worked on an example project to build with pybind11 and scikit-build.

@mayeut is a manylinux maintainer and focused his effort on updating the cmake-python-distributions and ninja-python-distributions so that the corresponding wheels are available on all supported platforms including Apple Silicon and all flavors of manylinux.

New Features

• Support Apple Silicon, including producing Universal2 wheels (#530) and respecting standard setuptools cross-compile variables (#555). Thanks to @YannickJadoul for the contributions.
• Support MSVC 2019 without having to run it with the MSVC activation variables, just like 2017 and earlier versions. Thanks to @YannickJadoul for the contribution in #526.

Bug fixes

• Support -A and -T internally when setting up MSVC generators. Architecture now always passed through -A to MSVC generators. Thanks @YannickJadoul for the contribution. See #557 and #536.
• Fixed a regression that caused setuptools to complain about unknown setup option (cmake_process_manifest_hook). Thanks @Jmennius for the contribution. See #498.
• If it applies, ensure generator toolset is used to configure the project. Thanks @YannickJadoul for the contributions. See #526.
• Read CYTHON_FLAGS where needed, instead of once, allowing the user to define multiple modules with different flags. Thanks @oiffrig for the contributions in #536.
• Avoid an IndexError if prefix was empty. Thanks @dfaure for the contributions in #522.

Documentation

• Update Conda: Step-by-step release guide available in /make_a_release section.
• Update links to CMake documentation pages in /generators. Thanks @Eothred for the contributions in #508.

Tests

• Improve and simplify Continuous Integration infrastructure.
  • Support nox for running the tests locally. See #540.
  • Use GitHub Actions for Continuous Integration and remove use of scikit-ci, tox, TravisCI, AppVeyor and CircleCI. See #549, #551 and #552.
  • Add support for testing against Python 3.10. See #565.
  • Style checking handled by pre-commit. See #541.
  • Check for misspellings adding GitHub Actions workflow using codespell. See #541.
• Fix linting error F522 reported with flake8 >= 3.8.x. Thanks @benbovy for the contributions. See #494.
• Fix regex in tests to support Python 3.10. Thanks @mgorny for the contributions in #544.

See https://scikit-build.readthedocs.io/en/latest/changes.html#scikit-build-0-11-1

See https://scikit-build.readthedocs.io/en/latest/changes.html#scikit-build-0-11-0

See https://scikit-build.readthedocs.io/en/latest/changes.html#scikit-build-0-10-0

See https://scikit-build.readthedocs.io/en/latest/changes.html#scikit-build-0-9-0

See https://scikit-build.readthedocs.io/en/latest/changes.html#scikit-build-0-8-1

See https://scikit-build.readthedocs.io/en/latest/changes.html#scikit-build-0-8-0

Scikit-build 0.7.1

Documentation

• Fix description and classifier list in setup.py.
• Fix link in README.

Scikit-build 0.7.0

New Features

• Faster incremental build by re-configuring the project only if needed. This was achieved by (1) adding support to retrieve the environment mapping associated with the generator set in the CMakeCache.txt file, (2) introducing a CMake spec file storing the CMake version as well as the the CMake arguments and (3) re-configuring only if either the generator or the CMake specs change. Thanks @xoviat for the contribution. See #301.
• CMake modules:
  • CMake module PythonExtensions: Set symbol visibility to export only the module init function. This applies to GNU and MSVC compilers. Thanks @xoviat. See #299.
  • Add CMake module F2PY useful to find the f2py executable for building Python extensions with Fortran. Thanks to @xoviat for moving forward with the integration. Concept for the module comes from the work of @scopatz done in PyNE project. See #273.
  • Update CMake module NumPy setting variables NumPy_CONV_TEMPLATE_EXECUTABLE and NumPy_FROM_TEMPLATE_EXECUTABLE. Thanks @xoviat for the contribution. See #278.
• Setup keywords:
  • Add support for cmake_languages setup keyword.
  • Add support for include_package_data and exclude_package_data setup keywords as well as parsing of MANIFEST.in. See #315. Thanks @reiver-dev for reporting the issue.
  • Add support for cmake_minimum_required_version setup keyword. See #312. Suggested by @henryiii.
  • Install cmake if found in setup_requires list. See #313. Suggested by @henryiii.
• Add support for --cmake-executable scikit-build command line option. Thanks @henryborchers for the suggestion. See #317.
• Use _skbuild/platform-X.Y instead of _skbuild to build package. This allows to have a different build directory for each python version. Thanks @isuruf for the suggestion and @xoviat for contributing the feature. See #283.
• Run cmake and develop command when command test is executed.

Bug fixes

• Fix support of --hide-listing when building wheel.
• CMake module Cython: Fix escaping of spaces associated with CYTHON_FLAGS when provided as command line arguments to the cython executable through CMake cache entries. See #265 fixed by @neok-m4700.
• Ensure package data files specified in the setup() function using package_data keyword are packaged and installed.
• Support specifying a default directory for all packages not already associated with one using syntax like package_dir={'':'src'} in setup.py. Thanks @benjaminjack for reporting the issue. See #274.
• Improve --skip-cmake command line option support so that it can re-generate a source distribution or a python wheel without having to run cmake executable to re-configure and build. Thanks to @jonwoodring for reporting the issue on the mailing list.
• Set skbuild <version> as wheel generator. See PEP-0427 and #191.
• Ensure MANIFEST.in is considered when generating source distribution. Thanks @seanlis for reporting the problem and providing an initial patch, and thanks @henryiii for implementing the corresponding test. See #260.
• Support generation of source distribution for git repository having submodules. This works only for version of git >= 2.11 supporting the --recurse-submodules option with ls-files command.

Internal API

• Add skbuild.cmaker.get_cmake_version().

Python Support

• Tests using Python 3.3.x were removed and support for this version of python is not guaranteed anymore. Support was removed following the deprecation warnings reported by version 0.31.0 of wheel package, these were causing the tests test_source_distribution and test_wheel to fail.

Tests

• Speedup execution of tests that do not require any CMake language enabled. This is achieved by (1) introducing the test project hello-no-language, (2) updating test utility functions execute_setup_py and project_setup_py_test to accept the optional parameter disable_languages_test allowing to skip unneeded compiler detection in test project used to verify that the selected CMake generator works as expected, and (3) updating relevant tests to use the new test project and parameters.

  Overall testing time on all continuous integration services was reduced:

  • AppVeyor:
    • from ~16 to ~7 minutes for 64 and 32-bit Python 2.7 tests done using Visual Studio Express 2008
    • from more than 2 hours to ~50 minutes for 64 and 32-bit Python 3.5 tests done using Visual Studio 2015. Improvement specific to Python 3.x were obtained by caching the results of slow calls to distutils.msvc9compiler.query_vcvarsall (for Python 3.3 and 3.4) and distutils._msvccompiler._get_vc_env (for Python 3.5 and above). These functions were called multiple times to create the list of skbuild.platform_specifics.windows.CMakeVisualStudioCommandLineGenerator used in skbuild.platform_specifics.windows.WindowsPlatform.
  • CircleCI: from ~7 to ~5 minutes.
  • TravisCI: from ~21 to ~10 minutes.

• Update maximum line length specified in flake8 settings from 80 to 120 characters.

• Add prepend_sys_path utility function.

• Ensure that the project directory is prepended to sys.path when executing test building sample project with the help of execute_setup_py function.

• Add codecov config file for better defaults and prevent associated Pull Request checks from reporting failure when coverage only slightly changes.

Documentation

• Improve internal API documentation:
  • skbuild.platform_specifics.windows
  • skbuild.command
  • skbuild.command.generate_source_manifest
  • skbuild.utils
• Split usage documentation into a Basic Usage and Advanced Usage sections.

Cleanups

• Fix miscellaneous pylint warnings.

Scikit-build 0.6.1

Bug fixes

• Ensure CMake arguments passed to scikit-build and starting with -DCMAKE_* are passed to the test project allowing to determine which generator to use. For example, this ensures that arguments like -DCMAKE_MAKE_PROGRAM:FILEPATH=/path/to/program are passed. See #256.

Documentation

• Update Making a release section including instructions to update README.rst with up-to-date pypi download statistics based on Google big table.

Scikit-build 0.6.0

New features

• Improve py_modules support: Python modules generated by CMake are now properly included in binary distribution.
• Improve developer mode support for py_modules generated by CMake.

Bug fixes

• Do not implicitly install python modules when the beginning of their name match a package explicitly listed. For example, if a project has a package foo/__init__.py and a module fooConfig.py, and only package foo was listed in setup.py, fooConfig.py is not installed anymore.
• CMake module targetLinkLibrariesWithDynamicLookup: Fix the caching of dynamic lookup variables. See #240 fixed by @blowekamp.

Requirements

• wheel: As suggested by @thewtex, unpinning version of the package by requiring >=0.29.0 instead of ==0.29.0 will avoid uninstalling a newer version of wheel package on up-to-date system.

Documentation

• Add a command line CMake Options section to Usage.
• Fix table listing Visual Studio IDE version and corresponding with CPython version in C Runtime, Compiler and Build System Generator.
• Improve Making a release section.

Tests

• Extend test_hello, test_setup, and test_sdist_hide_listing to (1) check if python modules are packaged into source and wheel distributions and (2) check if python modules are copied into the source tree when developer mode is enabled.

Internal API

• Fix skbuild.setuptools_wrap.strip_package() to handle empty package.
• Teach skbuild.command.build_py.build_py.find_modules() function to look for py_module file in CMAKE_INSTALL_DIR.
• Teach skbuild.utils.PythonModuleFinder to search for python module in the CMake install tree.
• Update skbuild.setuptools_wrap._consolidate() to copy file into the CMake tree only if it exists.
• Update skbuild.setuptools_wrap._copy_file() to create directory only if there is one associated with the destination file.

Scikit-build 0.5.1

Bug fixes

• Ensure file copied in “develop” mode have “mode bits” maintained.

Scikit-build 0.5.0

New features

• Improve user experience by running CMake only if needed. See #207
• Add support for cmake_with_sdist setup keyword argument.
• Add support for --force-cmake and --skip-cmake global setup command-line options.
• scikit-build conda-forge recipe added by @isuruf. See conda-forge/staged-recipes#1989
• Add support for development mode. (#187).
• Improved C Runtime, Compiler and Build System Generator selection:
• If available, uses Ninja build system generator on all platforms. An advantages is that ninja automatically parallelizes the build based on the number of CPUs.
• Automatically set the expected Visual Studio environment when Ninja or NMake Makefiles generators are used.
• Support Microsoft Visual C++ Compiler for Python 2.7. See #216.
• Prompt for user to install the required compiler if it is not available. See #27.
• Improve targetLinkLibrariesWithDynamicLookup CMake Module extending the API of check_dynamic_lookup function:
• Update long signature: <LinkFlagsVar> is now optional
• Add support for short signature: check_dynamic_lookup(<ResultVar>). See SimpleITK/SimpleITK#80.

Bug fixes

• Fix scikit-build source distribution and add test. See #214 Thanks @isuruf for reporting the issue.
• Support building extension within a virtualenv on windows. See #119.

Documentation

• add C Runtime, Compiler and Build System Generator section
• add Release Notes section
• allow github issues and users to easily be referenced using :issue:XYand:user:username markups. This functionality is enabled by the sphinx-issue sphinx extension
• make_a_release: Ensure uploaded distributions are signed
• usage:
• Add empty cross-compilation / wheels building sections
• Add Why should I use scikit-build ?
• Add Setup options section
• hacking:
• Add Internal API section generated using sphinx-apidoc.
• Add Internal CMake Modules to document targetLinkLibrariesWithDynamicLookup CMake module.

Requirements

• setuptools: As suggested by @mivade in #212, remove the hard requirement for ==28.8.0 and require version >= 28.0.0. This allows to “play” nicely with conda where it is problematic to update the version of setuptools. See pypa/pip#2751 and ContinuumIO/anaconda-issues#542.

Tests

• Improve “push_dir” tests to not rely on build directory name. Thanks @isuruf for reporting the issue.
• travis/install_pyenv: Improve MacOSX build time updating scikit-ci-addons
• Add get_cmakecache_variables utility function.

Internal API

• skbuild.cmaker.CMaker.configure(): Change parameter name from generator_id to generator_name. This is consistent with how generator are identified in CMake documentation. This change breaks backward compatibility.
• skbuild.platform_specifics.abstract.CMakePlatform.get_best_generator(): Change parameter name from generato to generator_name. Note that this function is also directly importable from skbuild.platform_specifics. This change breaks backward compatibility.
• skbuild.platform_specifics.abstract.CMakeGenerator: This class allows to handle generators as sophisticated object instead of simple string. This is done anticipating the support for CMAKE_GENERATOR_PLATFORM and CMAKE_GENERATOR_TOOLSET. Note also that the class is directly importable from skbuild.platform_specifics and is now returned by skbuild.platform_specifics.get_best_generator(). This change breaks backward compatibility.

Cleanups

• appveyor.yml:
• Remove unused “on_failure: event logging” and “notifications: GitHubPullRequest”
• Remove unused SKIP env variable

Scikit-build 0.4.0 Release Notes

Updates since 0.3.0

• Do not package python modules under "purelib" dir in non-pure wheel
• Add support for --hide-listing option
  • allow to build distributions without displaying files being included
  • useful when building large project on Continuous Integration service limiting the amount of log produced by the build.

CMake modules

• skbuild/resources/cmake/FindPythonExtensions.cmake
  • Function python_extension_module: add support for module suffix
• skbuild/resources/cmake/targetLinkLibrariesWithDynamicLookup.cmake:
  • Fix the logic checking for cross-compilation (the regression was introduced by scikit-build/scikit-build#51 and scikit-build/scikit-build#47
  • It configure the text project setting CMAKE_ENABLE_EXPORTS to ON. Doing so ensure the executable compiled in the test exports symbols (if supported by the underlying platform).

Docs

• Add short note explaining how to include scikit-build CMake module
• Move "Controlling CMake using scikit-build" into a "hacking" section
• Add initial version of "extension_build_system" documentation

Tests

• tests/samples: Simplify project removing unneeded install rules and file copy
• Simplify continuous integration
  • use scikit-ci and scikit-ci-addons
  • speed up build setting up caching
• Makefile:
  • Fix coverage target
  • Add docs-only target allowing to regenerator the Sphinx documentation without opening a new page in the browser.

Scikit-build 0.3.0 Release Notes

Updates since 0.2.0

• Fix dispatch of arguments to setuptools, CMake and build tool (#118)
• Improve support for "pure", "CMake" and "hybrid" python package
  • a "pure" package is a python package that have all files living in the project source tree
  • an "hybrid" package is a python package that have some files living in the project source tree and some files installed by CMake
  • a "CMake" package is a python package that is fully generated and installed by CMake without any of his files existing in the source tree
• Force binary wheel generation (#106)
• Add support for source distribution (#84)
• Add support for setup arguments specific to scikit-build:
  • cmake_args: additional option passed to CMake
  • cmake_install_dir: relative directory where the CMake project being built should be installed
  • cmake_source_dir: location of the CMake project
• Fix support for py_modules (6716723)
• Add CMake module FindNumPy.cmake
• Automatically set package_dir to reasonable defaults
• Support building project without CMakeLists.txt
• Do not raise error if calling "clean" command twice

Docs

• Improvement of documentation published on http://scikit-build.readthedocs.io/en/latest/
• Add docstrings for most of the modules, classes and functions

Tests

• Ensure each test run in a dedicated temporary directory
• Add tests to raise coverage from 70% to 91%
• Refactor CI testing infrastructure introducing CI drivers written in python for AppVeyor, CircleCI and TravisCI
• Switch from nose to py.test
• Relocate sample projects into a dedicated home: https://github.com/scikit-build/scikit-build-sample-projects

Cleanups

• Refactor commands introducing set_build_base_mixin and new_style
• Remove unused code