Skip to content

Commit 4be5230

Browse files
authored
Merge pull request #1432 from jeanas/tut-refs
Improve "further reading" at end of "packaging projects" tutorial
2 parents 51e8fa4 + 9d1ba31 commit 4be5230

File tree

2 files changed

+12
-5
lines changed

2 files changed

+12
-5
lines changed

source/conf.py

+1
Original file line numberDiff line numberDiff line change
@@ -141,6 +141,7 @@
141141
"dh-virtualenv": ("https://dh-virtualenv.readthedocs.io/en/latest/", None),
142142
"distlib": ("https://distlib.readthedocs.io/en/latest/", None),
143143
"flexx": ("https://flexx.readthedocs.io/en/latest/", None),
144+
"flit": ("https://flit.pypa.io/en/stable/", None),
144145
"nox": ("https://nox.thea.codes/en/latest/", None),
145146
"openstack": ("https://docs.openstack.org/glance/latest/", None),
146147
"packaging": ("https://packaging.pypa.io/en/latest/", None),

source/tutorials/packaging-projects.rst

+11-5
Original file line numberDiff line numberDiff line change
@@ -529,14 +529,16 @@ differences:
529529
At this point if you want to read more on packaging Python libraries here are
530530
some things you can do:
531531

532-
.. TODO: Add links to other guides
533-
.. TODO: Add links to backend configuration docs
534-
532+
* Read about advanced configuration for your chosen build backend:
533+
`Hatchling <hatchling-config_>`_,
534+
:doc:`setuptools <setuptools:userguide/pyproject_config>`,
535+
:doc:`Flit <flit:pyproject_toml>`, `PDM <pdm-config_>`_.
536+
* Look at the :doc:`guides </guides/index>` on this site for more advanced
537+
practical information, or the :doc:`discussions </discussions/index>`
538+
for explanations and background on specific topics.
535539
* Consider packaging tools that provide a single command-line interface for
536540
project management and packaging, such as :ref:`hatch`, :ref:`flit`,
537541
:ref:`pdm`, and :ref:`poetry`.
538-
* Read :pep:`517` and :pep:`518` for background and details on build tool configuration.
539-
* Read about :doc:`/guides/packaging-binary-extensions`.
540542

541543

542544
----
@@ -549,3 +551,7 @@ some things you can do:
549551
and considered an **advanced topic** (not covered in this tutorial).
550552
If you are only getting started with Python packaging, it is recommended to
551553
stick with *regular packages* and ``__init__.py`` (even if the file is empty).
554+
555+
556+
.. _hatchling-config: https://hatch.pypa.io/latest/config/metadata/
557+
.. _pdm-config: https://pdm-project.org/latest/reference/pep621/

0 commit comments

Comments
 (0)