@@ -193,12 +193,12 @@ an escape hatch when absolutely necessary.
193193 the project that contains all Python source files for the package --- so
194194 in this case the ``src `` directory is designated the root package.
195195 - ``packages `` is a list of all Python :term: `import packages <Import
196- Package> ` that should be included in the :term: `Distribution Package `.
197- Instead of listing each package manually, we can use the `` find: `` directive
198- to automatically discover all packages and subpackages and
199- ``options.packages.find `` to specify the ``package_dir `` to use. In this
200- case, the list of packages will be ``example_pkg `` as that's the only
201- package present.
196+ Package> ` that should be included in the :term: `distribution package
197+ <Distribution Package> `. Instead of listing each package manually, we can
198+ use the `` find: `` directive to automatically discover all packages and
199+ subpackages and ``options.packages.find `` to specify the ``package_dir ``
200+ to use. In this case, the list of packages will be ``example_pkg `` as
201+ that's the only package present.
202202 - ``python_requires `` gives the versions of Python supported by your
203203 project. Installers like pip will look back though older versions of
204204 packages until it finds one that has a matching Python version.
@@ -306,11 +306,11 @@ an escape hatch when absolutely necessary.
306306 package --- so in this case the ``src `` directory is designated the root
307307 package.
308308 - ``packages `` is a list of all Python :term: `import packages <Import
309- Package> ` that should be included in the :term: `Distribution Package `.
310- Instead of listing each package manually, we can use :func: ` find_packages `
311- to automatically discover all packages and subpackages under `` package_dir ``.
312- In this case, the list of packages will be `` example_pkg `` as that's the
313- only package present.
309+ Package> ` that should be included in the :term: `distribution package
310+ <Distribution Package> `. Instead of listing each package manually, we can
311+ use :func: ` find_packages ` to automatically discover all packages and
312+ subpackages under `` package_dir ``. In this case, the list of packages will
313+ be `` example_pkg `` as that's the only package present.
314314 - ``python_requires `` gives the versions of Python supported by your
315315 project. Installers like pip will look back though older versions of
316316 packages until it finds one that has a matching Python version.
@@ -443,12 +443,13 @@ files in the :file:`dist` directory:
443443 https://github.com/pypa/packaging-problems/issues/new?title=Trouble+following+packaging+libraries+tutorial
444444
445445
446- The ``tar.gz `` file is a :term: `Source Archive ` whereas the ``.whl `` file is a
447- :term: `Built Distribution `. Newer :ref: `pip ` versions preferentially install
448- built distributions, but will fall back to source archives if needed. You
449- should always upload a source archive and provide built archives for the
450- platforms your project is compatible with. In this case, our example package is
451- compatible with Python on any platform so only one built distribution is needed.
446+ The ``tar.gz `` file is a :term: `source archive <Source Archive> ` whereas the
447+ ``.whl `` file is a :term: `built distribution <Built Distribution> `. Newer
448+ :ref: `pip ` versions preferentially install built distributions, but will fall
449+ back to source archives if needed. You should always upload a source archive and
450+ provide built archives for the platforms your project is compatible with. In
451+ this case, our example package is compatible with Python on any platform so only
452+ one built distribution is needed.
452453
453454Uploading the distribution archives
454455-----------------------------------
@@ -585,9 +586,9 @@ and from the interpreter shell import the package:
585586
586587 >> > import example_pkg
587588
588- Note that the :term: `Import Package ` is ``example_pkg `` regardless of what
589- name you gave your :term: `Distribution Package `
590- in :file: `setup.py ` (in this case, ``example-pkg-YOUR-USERNAME-HERE ``).
589+ Note that the :term: `import package < Import Package> ` is ``example_pkg ``
590+ regardless of what name you gave your :term: `distribution package <Distribution
591+ Package> ` in :file: `setup.py ` (in this case, ``example-pkg-YOUR-USERNAME-HERE ``).
591592
592593Next steps
593594----------
0 commit comments