Scikit-build

Quick fix for quick fix in 0.9.1; if `cmake` is a broken script (which can
happen if you pip install outside an environment then enter an environment,
there was an unbound local error instead of ignoring the broken cmake script.

Fixes:

- Unbound local error by henryiii in 719

Quick fix for Pyodide (WebAssembly) builds.

Fixes:

- Try `--version` if `-E capabilities` fails by henryiii in 717

==================

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.

This version fixes a few small issues related to configuration. The wheel tag is
fixed when `wheel.platlib` is False, inplace editable installs ignore
`build-dir`, and `install-dir` no longer affects the generate path.

Fixes:

- Ensure `wheel.platlib` being false sets `<abi>-<platform>` as `"none-any"` by
jcfr in 655
- Inplace editable install should ignore `build-dir` by henryiii in 644
- `install-dir` shouldn't affect generate path by henryiii in 654
- Expand info printing by henryiii in 651

Documentation:

- Clarify requirement for using "inplace" editable mode by jcfr in 643
- Update README to use modern GitHub admonition by jcfr in 641
- be explicit about what it means to "use SKBUILD_SOABI" by minrk in 646

==================

Bug fixes
---------

* Fix ``bdist_wheel`` command to support ``wheel >= 0.32.0``. Thanks :user:`fbudin69500` for reporting
issue :issue:`360`.

Tests
-----

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

==================

New Features
------------

* Introduced :const:`skbuild.constants.CMAKE_DEFAULT_EXECUTABLE` to facilitate distribution
of scikit-build in package manager like `Nixpkgs <https://github.com/NixOS/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 <https://en.wikipedia.org/wiki/Windows-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
-------------

* README: Update overall download count.

* Add logo and update sphinx configuration. Thanks :user:`SteveJordanKW` for the design work.

* Update :ref:`CMake installation <installation_cmake>` section. Thanks :user:`thewtex`.

* Add :ref:`support_isolated_build` section.

* Add :ref:`optimized_incremental_build` section.

* Update :ref:`usage documentation <usage-setuptools_options>` to specify that ``--universal`` and
``--python-tags`` have no effect.
Thanks :user:`bgermann` for the suggestion. See :issue:`353`.

* Simplify documentation merging ``Extension Build System`` section with the ``Advanced Usage`` section.
Thanks :user:`thewtex` for the suggestion.

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 <https://github.com/warner/python-versioneer/>`_
and update :ref:`making_a_release` documentation.