Skip to content

Commit 894d53f

Browse files
Update messages.pot as of version a3a9e2b
1 parent 11eff4e commit 894d53f

File tree

1 file changed

+28
-28
lines changed

1 file changed

+28
-28
lines changed

locales/messages.pot

Lines changed: 28 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Python Packaging User Guide \n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2026-02-04 00:18+0000\n"
11+
"POT-Creation-Date: 2026-03-02 12:07+0000\n"
1212
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1313
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1414
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -5176,10 +5176,6 @@ msgstr ""
51765176
msgid "This can be worked around by setting all dependencies in ``__main__.__requires__`` before importing ``pkg_resources`` for the first time, but that approach does mean that standard command line invocations of the affected tools can't be used - it's necessary to write a custom wrapper script or use ``python3 -c '<command>'`` to invoke the application's main entry point directly."
51775177
msgstr ""
51785178

5179-
#: ../source/guides/multi-version-installs.rst:41
5180-
msgid "Refer to the `pkg_resources documentation <https://setuptools.readthedocs.io/en/latest/pkg_resources.html#workingset-objects>`__ for more details."
5181-
msgstr ""
5182-
51835179
#: ../source/guides/packaging-binary-extensions.rst:5
51845180
msgid "Packaging binary extensions"
51855181
msgstr ""
@@ -5589,71 +5585,75 @@ msgid "Legacy namespace packages"
55895585
msgstr ""
55905586

55915587
#: ../source/guides/packaging-namespace-packages.rst:160
5592-
msgid "These two methods, that were used to create namespace packages prior to :pep:`420`, are now considered to be obsolete and should not be used unless you need compatibility with packages already using this method. Also, :doc:`pkg_resources <setuptools:pkg_resources>` has been deprecated."
5588+
msgid "These two methods, that were used to create namespace packages prior to :pep:`420`, are now considered to be obsolete and should not be used unless you need compatibility with packages already using one of these methods."
55935589
msgstr ""
55945590

5595-
#: ../source/guides/packaging-namespace-packages.rst:165
5591+
#: ../source/guides/packaging-namespace-packages.rst:164
55965592
msgid "To migrate an existing package, all packages sharing the namespace must be migrated simultaneously."
55975593
msgstr ""
55985594

5599-
#: ../source/guides/packaging-namespace-packages.rst:167
5595+
#: ../source/guides/packaging-namespace-packages.rst:166
56005596
msgid "While native namespace packages and pkgutil-style namespace packages are largely compatible, pkg_resources-style namespace packages are not compatible with the other methods. It's inadvisable to use different methods in different distributions that provide packages to the same namespace."
56015597
msgstr ""
56025598

5603-
#: ../source/guides/packaging-namespace-packages.rst:174
5599+
#: ../source/guides/packaging-namespace-packages.rst:173
56045600
msgid "pkgutil-style namespace packages"
56055601
msgstr ""
56065602

5607-
#: ../source/guides/packaging-namespace-packages.rst:176
5608-
msgid "Python 2.3 introduced the :doc:`pkgutil <python:library/pkgutil>` module and the :py:func:`python:pkgutil.extend_path` function. This can be used to declare namespace packages that need to be compatible with both Python 2.3+ and Python 3. This is the recommended approach for the highest level of compatibility."
5603+
#: ../source/guides/packaging-namespace-packages.rst:175
5604+
msgid "Python 2.3 introduced the :doc:`pkgutil <python:library/pkgutil>` module and the :py:func:`python:pkgutil.extend_path` function. This can be used to declare namespace packages that need to be compatible with both Python 2.3+ and Python 3. This was the recommended approach for the highest level of compatibility."
56095605
msgstr ""
56105606

5611-
#: ../source/guides/packaging-namespace-packages.rst:181
5607+
#: ../source/guides/packaging-namespace-packages.rst:180
56125608
msgid "To create a pkgutil-style namespace package, you need to provide an :file:`__init__.py` file for the namespace package:"
56135609
msgstr ""
56145610

5615-
#: ../source/guides/packaging-namespace-packages.rst:195
5616-
#: ../source/guides/packaging-namespace-packages.rst:242
5611+
#: ../source/guides/packaging-namespace-packages.rst:194
5612+
#: ../source/guides/packaging-namespace-packages.rst:249
56175613
msgid "The :file:`__init__.py` file for the namespace package needs to contain the following:"
56185614
msgstr ""
56195615

5620-
#: ../source/guides/packaging-namespace-packages.rst:202
5621-
#: ../source/guides/packaging-namespace-packages.rst:249
5616+
#: ../source/guides/packaging-namespace-packages.rst:201
5617+
#: ../source/guides/packaging-namespace-packages.rst:256
56225618
msgid "**Every** distribution that uses the namespace package must include such an :file:`__init__.py`. If any distribution does not, it will cause the namespace logic to fail and the other sub-packages will not be importable. Any additional code in :file:`__init__.py` will be inaccessible."
56235619
msgstr ""
56245620

5625-
#: ../source/guides/packaging-namespace-packages.rst:207
5621+
#: ../source/guides/packaging-namespace-packages.rst:206
56265622
msgid "A complete working example of two pkgutil-style namespace packages can be found in the `pkgutil namespace example project`_."
56275623
msgstr ""
56285624

5629-
#: ../source/guides/packaging-namespace-packages.rst:217
5625+
#: ../source/guides/packaging-namespace-packages.rst:216
56305626
msgid "pkg_resources-style namespace packages"
56315627
msgstr ""
56325628

5633-
#: ../source/guides/packaging-namespace-packages.rst:219
5634-
msgid ":doc:`Setuptools <setuptools:index>` provides the `pkg_resources.declare_namespace`_ function and the ``namespace_packages`` argument to :func:`~setuptools.setup`. Together these can be used to declare namespace packages. While this approach is no longer recommended, it is widely present in most existing namespace packages. If you are creating a new distribution within an existing namespace package that uses this method then it's recommended to continue using this as the different methods are not cross-compatible and it's not advisable to try to migrate an existing package."
5629+
#: ../source/guides/packaging-namespace-packages.rst:220
5630+
msgid "The information in this section is obsolete and is no longer functional (as of Setuptools 82.0.0). It is only retained for historical reference."
5631+
msgstr ""
5632+
5633+
#: ../source/guides/packaging-namespace-packages.rst:223
5634+
msgid "``pkg_resources`` has been deprecated and was fully removed in Setuptools 82.0.0."
56355635
msgstr ""
56365636

5637-
#: ../source/guides/packaging-namespace-packages.rst:228
5637+
#: ../source/guides/packaging-namespace-packages.rst:225
5638+
msgid ":doc:`Setuptools <setuptools:index>` previously provided the ``pkg_resources.declare_namespace`` function and the ``namespace_packages`` argument to :func:`~setuptools.setup`. Together these could be used to declare namespace packages. While this approach is no longer supported, it may still be encountered in environments using older ``setuptools`` versions. If you are creating a new distribution within an existing namespace package that uses this method then it's recommended to continue using this as the different methods are not cross-compatible and it's not advisable to try to migrate an existing package."
5639+
msgstr ""
5640+
5641+
#: ../source/guides/packaging-namespace-packages.rst:235
56385642
msgid "To create a pkg_resources-style namespace package, you need to provide an :file:`__init__.py` file for the namespace package:"
56395643
msgstr ""
56405644

5641-
#: ../source/guides/packaging-namespace-packages.rst:254
5645+
#: ../source/guides/packaging-namespace-packages.rst:261
56425646
msgid "Some older recommendations advise the following in the namespace package :file:`__init__.py`:"
56435647
msgstr ""
56445648

5645-
#: ../source/guides/packaging-namespace-packages.rst:264
5649+
#: ../source/guides/packaging-namespace-packages.rst:271
56465650
msgid "The idea behind this was that in the rare case that setuptools isn't available packages would fall-back to the pkgutil-style packages. This isn't advisable because pkgutil and pkg_resources-style namespace packages are not cross-compatible. If the presence of setuptools is a concern then the package should just explicitly depend on setuptools via ``install_requires``."
56475651
msgstr ""
56485652

5649-
#: ../source/guides/packaging-namespace-packages.rst:271
5653+
#: ../source/guides/packaging-namespace-packages.rst:278
56505654
msgid "Finally, every distribution must provide the ``namespace_packages`` argument to :func:`~setuptools.setup` in :file:`setup.py`. For example:"
56515655
msgstr ""
56525656

5653-
#: ../source/guides/packaging-namespace-packages.rst:285
5654-
msgid "A complete working example of two pkg_resources-style namespace packages can be found in the `pkg_resources namespace example project`_."
5655-
msgstr ""
5656-
56575657
#: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:5
56585658
msgid "Publishing package distribution releases using GitHub Actions CI/CD workflows"
56595659
msgstr ""

0 commit comments

Comments
 (0)