Skip to content

Commit 7153008

Browse files
committed
Normalize terms to lowercase
1 parent f6a1cfe commit 7153008

1 file changed

Lines changed: 21 additions & 20 deletions

File tree

source/tutorials/packaging-projects.rst

Lines changed: 21 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -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

453454
Uploading 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

592593
Next steps
593594
----------

0 commit comments

Comments
 (0)