diff options
author | Adam J. Stewart <ajstewart426@gmail.com> | 2022-07-11 16:23:28 -0700 |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-07-11 16:23:28 -0700 |
commit | 5bd1074afb79710c115fc64ce49f57c424235801 (patch) | |
tree | 72ecd6271cc2355448cd92f89badd6a0d09531c5 /lib | |
parent | 18b51e19df6ff70528802e7daa8d9f82f9ca647c (diff) | |
download | spack-5bd1074afb79710c115fc64ce49f57c424235801.tar.gz spack-5bd1074afb79710c115fc64ce49f57c424235801.tar.bz2 spack-5bd1074afb79710c115fc64ce49f57c424235801.tar.xz spack-5bd1074afb79710c115fc64ce49f57c424235801.zip |
py-hatchling: add new packages, document new build backend (#31512)
* py-hatchling: add new package, document new build backend
* Minor doc changes
Co-authored-by: Tamara Dahlgren <35777542+tldahlgren@users.noreply.github.com>
Co-authored-by: Tamara Dahlgren <35777542+tldahlgren@users.noreply.github.com>
Diffstat (limited to 'lib')
-rw-r--r-- | lib/spack/docs/build_systems/pythonpackage.rst | 33 |
1 files changed, 31 insertions, 2 deletions
diff --git a/lib/spack/docs/build_systems/pythonpackage.rst b/lib/spack/docs/build_systems/pythonpackage.rst index b246ed1445..de79324de1 100644 --- a/lib/spack/docs/build_systems/pythonpackage.rst +++ b/lib/spack/docs/build_systems/pythonpackage.rst @@ -48,8 +48,9 @@ important to understand. **build backend** Libraries used to define how to build a wheel. Examples include `setuptools <https://setuptools.pypa.io/>`__, - `flit <https://flit.readthedocs.io/>`_, and - `poetry <https://python-poetry.org/>`_. + `flit <https://flit.readthedocs.io/>`_, + `poetry <https://python-poetry.org/>`_, and + `hatchling <https://hatch.pypa.io/latest/>`_. ^^^^^^^^^^^ Downloading @@ -326,6 +327,33 @@ for specifying the version requirements. Note that ``~=`` works differently in poetry than in setuptools and flit for versions that start with a zero. +""""""""" +hatchling +""""""""" + +If the ``pyproject.toml`` lists ``hatchling.build`` as the +``build-backend``, it uses the hatchling build system. Look for +dependencies under the following keys: + +* ``requires-python`` + + This specifies the version of Python that is required + +* ``project.dependencies`` + + These packages are required for building and installation. You can + add them with ``type=('build', 'run')``. + +* ``project.optional-dependencies`` + + This section includes keys with lists of optional dependencies + needed to enable those features. You should add a variant that + optionally adds these dependencies. This variant should be ``False`` + by default. + +See https://hatch.pypa.io/latest/config/dependency/ for more +information. + """""" wheels """""" @@ -666,3 +694,4 @@ For more information on build backend tools, see: * setuptools: https://setuptools.pypa.io/ * flit: https://flit.readthedocs.io/ * poetry: https://python-poetry.org/ +* hatchling: https://hatch.pypa.io/latest/ |