diff --git a/source/conf.py b/source/conf.py index 75bf14be0..6c50b0ad0 100644 --- a/source/conf.py +++ b/source/conf.py @@ -141,6 +141,7 @@ "dh-virtualenv": ("https://dh-virtualenv.readthedocs.io/en/latest/", None), "distlib": ("https://distlib.readthedocs.io/en/latest/", None), "flexx": ("https://flexx.readthedocs.io/en/latest/", None), + "flit": ("https://flit.pypa.io/en/stable/", None), "nox": ("https://nox.thea.codes/en/latest/", None), "openstack": ("https://docs.openstack.org/glance/latest/", None), "packaging": ("https://packaging.pypa.io/en/latest/", None), diff --git a/source/tutorials/packaging-projects.rst b/source/tutorials/packaging-projects.rst index 23742c7d8..f1098590b 100644 --- a/source/tutorials/packaging-projects.rst +++ b/source/tutorials/packaging-projects.rst @@ -529,14 +529,16 @@ differences: At this point if you want to read more on packaging Python libraries here are some things you can do: -.. TODO: Add links to other guides -.. TODO: Add links to backend configuration docs - +* Read about advanced configuration for your chosen build backend: + `Hatchling `_, + :doc:`setuptools `, + :doc:`Flit `, `PDM `_. +* Look at the :doc:`guides ` on this site for more advanced + practical information, or the :doc:`discussions ` + for explanations and background on specific topics. * Consider packaging tools that provide a single command-line interface for project management and packaging, such as :ref:`hatch`, :ref:`flit`, :ref:`pdm`, and :ref:`poetry`. -* Read :pep:`517` and :pep:`518` for background and details on build tool configuration. -* Read about :doc:`/guides/packaging-binary-extensions`. ---- @@ -549,3 +551,7 @@ some things you can do: and considered an **advanced topic** (not covered in this tutorial). If you are only getting started with Python packaging, it is recommended to stick with *regular packages* and ``__init__.py`` (even if the file is empty). + + +.. _hatchling-config: https://hatch.pypa.io/latest/config/metadata/ +.. _pdm-config: https://pdm-project.org/latest/reference/pep621/