Metadata-Version: 2.1
Name: scikit-build
Version: 0.16.5
Summary: Improved build system generator for Python C/C++/Fortran/Cython extensions
Home-page: https://github.com/scikit-build/scikit-build
Author: The scikit-build team
License: MIT
Project-URL: Documentation, https://scikit-build.readthedocs.io/
Project-URL: Bug Tracker, https://github.com/scikit-build/scikit-build/issues
Project-URL: Changelog, https://scikit-build.readthedocs.io/en/latest/changes.html
Project-URL: Discussions, https://github.com/orgs/scikit-build/discussions
Project-URL: Examples, https://github.com/scikit-build/scikit-build-sample-projects
Keywords: scikit-build
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Typing :: Typed
Requires-Python: >=3.6
Description-Content-Type: text/x-rst; charset=UTF-8
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: distro
Requires-Dist: packaging
Requires-Dist: setuptools (>=42.0.0)
Requires-Dist: wheel (>=0.32.0)
Requires-Dist: typing-extensions (>=3.7) ; python_version < "3.8"
Provides-Extra: cov
Requires-Dist: codecov (>=2.0.5) ; extra == 'cov'
Requires-Dist: coverage (>=4.2) ; extra == 'cov'
Requires-Dist: pytest-cov (>=2.7.1) ; extra == 'cov'
Provides-Extra: docs
Requires-Dist: pygments ; extra == 'docs'
Requires-Dist: sphinx (>=4) ; extra == 'docs'
Requires-Dist: sphinx-issues ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme (>=1.0) ; extra == 'docs'
Requires-Dist: sphinxcontrib-moderncmakedomain (>=3.19) ; extra == 'docs'
Provides-Extra: doctest
Requires-Dist: ubelt (>=0.8.2) ; extra == 'doctest'
Requires-Dist: xdoctest (>=0.10.0) ; extra == 'doctest'
Provides-Extra: test
Requires-Dist: build (>=0.7) ; extra == 'test'
Requires-Dist: cython (>=0.25.1) ; extra == 'test'
Requires-Dist: pytest (>=6.0.0) ; extra == 'test'
Requires-Dist: pytest-mock (>=1.10.4) ; extra == 'test'
Requires-Dist: pytest-virtualenv (>=1.2.5) ; extra == 'test'
Requires-Dist: requests ; extra == 'test'
Requires-Dist: virtualenv ; extra == 'test'
Requires-Dist: importlib-metadata ; (python_version < "3.8") and extra == 'test'

===============================
scikit-build
===============================

.. image:: https://github.com/scikit-build/scikit-build/actions/workflows/ci.yml/badge.svg
    :target: https://github.com/scikit-build/scikit-build/actions/workflows/ci.yml

.. image:: https://dev.azure.com/scikit-build/scikit-build/_apis/build/status/scikit-build.scikit-build?branchName=master
   :target: https://dev.azure.com/scikit-build/scikit-build/_build/latest?definitionId=1&branchName=master

.. image:: https://codecov.io/gh/scikit-build/scikit-build/branch/master/graph/badge.svg
    :target: https://codecov.io/gh/scikit-build/scikit-build
    :alt: Code coverage status

.. image:: https://img.shields.io/static/v1?label=Discussions&message=Ask&color=blue&logo=github
    :target: https://github.com/orgs/scikit-build/discussions
    :alt: GitHub Discussion

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 <https://cmake.org/>`_.

To get started, see `this example <https://scikit-build.readthedocs.io/en/latest/usage.html#example-of-setup-py-cmakelists-txt-and-pyproject-toml>`_ and `scikit-build-sample-projects <https://github.com/scikit-build/scikit-build-sample-projects>`_.


Latest Release
--------------

.. table::

  +-----------------------------------------------------------------------------+-------------------------------------------------------------------------------+
  | Versions                                                                    | Downloads                                                                     |
  +=============================================================================+===============================================================================+
  | .. image:: https://img.shields.io/pypi/v/scikit-build.svg                   | .. image:: https://img.shields.io/pypi/dm/scikit-build                        |
  |     :target: https://pypi.python.org/pypi/scikit-build                      |     :target: https://pypi.python.org/pypi/scikit-build                        |
  +-----------------------------------------------------------------------------+-------------------------------------------------------------------------------+
  | .. image:: https://anaconda.org/conda-forge/scikit-build/badges/version.svg | .. image:: https://anaconda.org/conda-forge/scikit-build/badges/downloads.svg |
  |     :target: https://anaconda.org/conda-forge/scikit-build                  |     :target: https://anaconda.org/conda-forge/scikit-build                    |
  +-----------------------------------------------------------------------------+-------------------------------------------------------------------------------+



Known Issues
------------

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 ``test`` command, ``easy_install``, etc.
* Python 3.6
  support is deprecated, as setuptools, pytest, and everything else we use has
  dropped it already.
* 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).
* Our primary branch will change to ``main``

If you need any of these features, please open or find an issue explaining what
and why you need something.

Miscellaneous
-------------

* 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 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=2209877>`_.




History
-------

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.
