Skip to content

Latest commit

 

History

History
768 lines (500 loc) · 27.9 KB

CHANGES.rst

File metadata and controls

768 lines (500 loc) · 27.9 KB
Raw

Release Notes

This is the list of changes to scikit-build between each release. For full details, see the commit logs at http://github.com/scikit-build/scikit-build

Next Release

New Features

Bug fixes

Documentation

  • Add :doc:`/notes` section to the For maintainers top-level category that includes a comparison between sysconfig and distutils.sysconfig modules.
  • Remove obsolete comment in cmaker.py. See :issue:`439`. Thanks :user:`isuruf`

Tests

  • Continuous Integration

Scikit-build 0.10.0

New Features

  • Improve message displayed when discovering a working environment for building projects. For example, instead of displaying -- Trying "Ninja" generator, it now displays a message like -- Trying "Ninja (Visual Studio 15 2017 Win64 v140)" generator.

Bug fixes

Internal API

Documentation

Tests

  • Introduce check_sdist_content() and fix tests that are checking content of sdist to account for changes introduced in Python 3.8 and backported to python 2.7, 3.6 and 3.7. The changes introduced in python/cpython#9419 adds directory entries to ZIP files created by distutils. Thanks :user:`anibali` for the contribution. See :issue:`404`.
  • Fix check_wheel_content() to consider changes in 0.33.1 < wheel.__version__ < 0.33.4 where directory entries are included when building wheel. See pypa/wheel#294 <pypa/wheel#294>.
  • Fix reporting of AssertionError raised in check_wheel_content() function by relocating the source code into a dedicated module tests.pytest_helpers and by adding a conftest.py configuration file registering it for pytest assertion rewriting. See https://docs.pytest.org/en/latest/writing_plugins.html#assertion-rewriting and :issue:`403`.
  • Fix test_generator_selection when building with "Visual C++ for Python 2.7" installed for all users. This addresses failure associated with win_c_compilervs2008cxx_compilervs2008python2.7 when running test in scikit-build-feedstock where "Visual C++ for Python 2.7" is installed using (vcpython27 chocolatey package.
  • Continuous Integration
    • Add support for Azure Pipelines for Python 3.7 32-bit and 64-bit
    • AppVeyor: Disable test for Python 3.7 32-bit and 64-bit.
    • CircleCI: Update version of docker images from jessie to stretch. This addresses issue circleci/circleci-images#370.
    • TravisCI: Remove obsolete Python 3.4 testing. It reached end-of-life on March 18 2019.

Scikit-build 0.9.0

New Features

  • Add support for building distutils based extensions associated with ext_modules setup keyword along side skbuild based extensions. This means using build_ext command (and associated --inplace argument) is supported. Thanks :user:`Erotemic` for the contribution. See :issue:`284`.

Bug fixes

  • Fix build of wheels if path includes spaces. See issue :issue:`375`. Thanks :user:`padraic-padraic` for the contribution.
  • Ensure wheel platform name is correctly set when providing custom CMAKE_OSX_DEPLOYMENT_TARGET and CMAKE_OSX_ARCHITECTURES values are provided. Thanks :user:`nonhermitian` for the contribution. See :issue:`377`.
  • Fix testing with recent version of pytest by updating the pytest-runner requirements expression in setup.py. Thanks :user:`mackelab` for the contribution.

Scikit-build 0.8.1

Bug fixes

Tests

  • Fix test_distribution.py updating use of Path.files() and requiring path.py>=11.5.0.

Scikit-build 0.8.0

New Features

  • Introduced :const:`skbuild.constants.CMAKE_DEFAULT_EXECUTABLE` to facilitate distribution of scikit-build in package manager like Nixpkgs where all paths to dependencies are hardcoded. Suggested by :user:`FRidh`.
  • Setup keywords:
    • If not already set, zip_safe option is set to False. Suggested by :user:`blowekamp`.
  • Add support for --skip-generator-test when a generator is explicitly selected using --generator. This allows to speed up overall build when the build environment is known.

Bug fixes

  • Fix support for building project with CMake source directory outside of the setup.py directory. See :issue:`335` fixed by :user:`massich`.
  • Fix reading of .cmake files having any character not available in CP-1252 (the default code page on windows). See :issue:`334` fixed by :user:`bgermann`.
  • Fix parsing of macOS specific arguments like --plat-name macosx-X.Y-x86_64 and -DCMAKE_OSX_DEPLOYMENT_TARGET:STRING=X.Y and ensure that the ones specified as command line arguments override the default values or the one hard-coded in the cmake_args setup keyword. Thanks :user:`yonip` for the help addressing :issue:`342`.
  • Support case where relative directory set in package_dir has an ending slash. For example, specifying package_dir={'awesome': 'src/awesome/'}, is now properly handled.
  • Fix support for isolated build environment ensuring the CMake project is reconfigured when pip install -e . is called multiple times. See :issue:`352`.

Documentation

Tests

  • Add check_wheel_content utility function.
  • Skip test_setup_requires_keyword_include_cmake if running in conda test environment or if https://pypi.org is not reachable. Suggested by :user:`Luthaf`.
  • Continuous Integration
    • TravisCI:
      • Remove testing of linux now covered by CircleCI, add testing for Python 3.5, 3.6 and 3.7 on macOS.
      • Ensure system python uses latest version of pip
    • AppVeyor, CircleCI: Add testing for Python 3.7
    • Remove uses of unneeded $<RUN_ENV> command wrapper. scikit-build should already take care of setting up the expected environment.
    • Always install up-to-date scikit-ci and scikit-ci-addons.
    • Simplify release process managing versioning with python-versioneer and update :ref:`making_a_release` documentation.

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

Bug fixes

  • Fix support of --hide-listing when building wheel.
  • CMake module :doc:`/cmake-modules/Cython`: Fix escaping of spaces associated with CYTHON_FLAGS when provided as command line arguments to the cython executable through CMake cache entries. See :issue:`265` fixed by :user:`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 :user:`benjaminjack` for reporting the issue. See :issue:`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 :user:`jonwoodring` for reporting the issue on the mailing list.
  • Set skbuild <version> as wheel generator. See PEP-0427 and :issue:`191`.
  • Ensure MANIFEST.in is considered when generating source distribution. Thanks :user:`seanlis` for reporting the problem and providing an initial patch, and thanks :user:`henryiii` for implementing the corresponding test. See :issue:`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

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:
    • 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

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 :issue:`256`.

Documentation

  • Update :doc:`/make_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 :doc:`/cmake-modules/targetLinkLibrariesWithDynamicLookup`: Fix the caching of dynamic lookup variables. See :issue:`240` fixed by :user:`blowekamp`.

Requirements

  • wheel: As suggested by :user:`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

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

Scikit-build 0.5.1

Bug fixes

  • Ensure file copied in "develop" mode have "mode bits" maintained.

Scikit-build 0.5.0

New features

  • If available, uses :ref:`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 :issue:`216`.
  • 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 :issue:`214` Thanks :user:`isuruf` for reporting the issue.
  • Support building extension within a virtualenv on windows. See :issue:`119`.

Documentation

  • add :doc:`/generators` section
  • add :doc:`/changes` section
  • allow github issues and users to easily be referenced using :issue:`XY` and :user:`username` markups. This functionality is enabled by the sphinx-issue sphinx extension
  • make_a_release: Ensure uploaded distributions are signed
  • usage:
  • hacking:

Requirements

Tests

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

Internal API

Cleanups

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

Scikit-build 0.4.0

New features

  • 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 module: skbuild/resources/cmake/FindPythonExtensions.cmake
  • Function python_extension_module: add support for module suffix

Bug fixes

  • Do not package python modules under "purelib" dir in non-pure wheel
  • CMake module: skbuild/resources/cmake/targetLinkLibrariesWithDynamicLookup.cmake:
  • Fix the logic checking for cross-compilation (the regression was introduced by :issue:`51` and :issue:`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

Tests

  • tests/samples: Simplify project removing unneeded install rules and file copy
  • Simplify continuous integration
  • Makefile:
  • Fix coverage target
  • Add docs-only target allowing to regenerate the Sphinx documentation without opening a new page in the browser.

Scikit-build 0.3.0

New features

  • 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
  • Add support for source distribution. See :issue:`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
  • Add CMake module FindNumPy.cmake
  • Automatically set package_dir to reasonable defaults
  • Support building project without CMakeLists.txt

Bug fixes

  • Fix dispatch of arguments to setuptools, CMake and build tool. See :issue:`118`
  • Force binary wheel generation. See :issue:`106`
  • Fix support for py_modules (6716723)
  • Do not raise error if calling "clean" command twice

Documentation

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