diff --git a/locales/ar/LC_MESSAGES/messages.po b/locales/ar/LC_MESSAGES/messages.po index 11b3c5674..dabfe6cbc 100644 --- a/locales/ar/LC_MESSAGES/messages.po +++ b/locales/ar/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -513,7 +513,7 @@ msgstr "" #: ../source/discussions/deploying-python-applications.rst:11 #: ../source/specifications/externally-managed-environments.rst:130 -#: ../source/specifications/platform-compatibility-tags.rst:21 +#: ../source/specifications/platform-compatibility-tags.rst:14 msgid "Overview" msgstr "" @@ -2725,7 +2725,7 @@ msgid "" msgstr "" #: ../source/guides/analyzing-pypi-package-downloads.rst:335 -#: ../source/specifications/dependency-specifiers.rst:489 +#: ../source/specifications/dependency-specifiers.rst:487 msgid "References" msgstr "" @@ -8274,7 +8274,7 @@ msgid "" msgstr "" #: ../source/key_projects.rst:184 -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "pip" msgstr "" @@ -10359,7 +10359,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:22 -#: ../source/specifications/platform-compatibility-tags.rst:46 +#: ../source/specifications/platform-compatibility-tags.rst:39 msgid "Details" msgstr "" @@ -10557,7 +10557,7 @@ msgid "E.g. 'py27', 'py2', 'py3'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:128 -#: ../source/specifications/platform-compatibility-tags.rst:27 +#: ../source/specifications/platform-compatibility-tags.rst:20 msgid "abi tag" msgstr "" @@ -10566,7 +10566,7 @@ msgid "E.g. 'cp33m', 'abi3', 'none'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:131 -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "platform tag" msgstr "" @@ -10748,7 +10748,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:226 -#: ../source/specifications/recording-installed-packages.rst:39 +#: ../source/specifications/recording-installed-packages.rst:23 msgid "The .dist-info directory" msgstr "" @@ -10890,7 +10890,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:314 -#: ../source/specifications/platform-compatibility-tags.rst:244 +#: ../source/specifications/platform-compatibility-tags.rst:237 msgid "FAQ" msgstr "" @@ -11027,36 +11027,38 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:419 -#: ../source/specifications/direct-url-data-structure.rst:266 -#: ../source/specifications/direct-url.rst:66 +#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/dependency-specifiers.rst:476 +#: ../source/specifications/direct-url-data-structure.rst:267 +#: ../source/specifications/direct-url.rst:67 +#: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 #: ../source/specifications/inline-script-metadata.rst:239 #: ../source/specifications/name-normalization.rst:42 +#: ../source/specifications/platform-compatibility-tags.rst:301 #: ../source/specifications/pyproject-toml.rst:442 +#: ../source/specifications/recording-installed-packages.rst:252 #: ../source/specifications/source-distribution-format.rst:144 #: ../source/specifications/version-specifiers.rst:1262 +#: ../source/specifications/virtual-environments.rst:54 msgid "History" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -msgid "This specification was originally approved as :pep:`427`." -msgstr "" - -#: ../source/specifications/binary-distribution-format.rst:423 -msgid "The following changes were applied since the initial version:" +msgid "February 2013: This specification was approved through :pep:`427`." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:425 +#: ../source/specifications/binary-distribution-format.rst:422 msgid "" -"The rules on escaping in wheel filenames were revised, to bring them into " -"line with what popular tools actually do (February 2021)." +"February 2021: The rules on escaping in wheel filenames were revised, to " +"bring them into line with what popular tools actually do." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:430 +#: ../source/specifications/binary-distribution-format.rst:427 msgid "Appendix" msgstr "" -#: ../source/specifications/binary-distribution-format.rst:432 +#: ../source/specifications/binary-distribution-format.rst:429 msgid "Example urlsafe-base64-nopad implementation::" msgstr "" @@ -11954,11 +11956,55 @@ msgid "" "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:854 +msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:855 +msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" +msgstr "" + +#: ../source/specifications/core-metadata.rst:856 +msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:857 +msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:859 +msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:860 +msgid "Added canonical method for transforming metadata to JSON." +msgstr "" + +#: ../source/specifications/core-metadata.rst:861 +msgid "Restricted the grammar of the ``Name`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:863 +msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:865 +msgid "Added the ``Dynamic`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:867 +msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:869 +msgid "Restricted extra names to be normalized." +msgstr "" + +#: ../source/specifications/core-metadata.rst:873 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:858 +#: ../source/specifications/core-metadata.rst:878 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" @@ -12410,35 +12456,29 @@ msgstr "" msgid "A test program - if the grammar is in a string ``grammar``:" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:476 -msgid "Summary of changes to PEP 508" -msgstr "" - #: ../source/specifications/dependency-specifiers.rst:478 -msgid "" -"The following changes were made based on feedback after its initial " -"implementation:" +msgid "November 2015: This specification was approved through :pep:`508`." msgstr "" -#: ../source/specifications/dependency-specifiers.rst:481 +#: ../source/specifications/dependency-specifiers.rst:479 msgid "" -"The definition of ``python_version`` was changed from ``platform." -"python_version()[:3]`` to ``'.'.join(platform.python_version_tuple()[:2])``, " -"to accommodate potential future versions of Python with 2-digit major and " -"minor versions (e.g. 3.10). [#future_versions]_" +"July 2019: The definition of ``python_version`` was `changed `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12465,7 +12505,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12549,10 +12589,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12900,17 +12938,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13112,6 +13149,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13711,7 +13754,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13928,7 +13971,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14000,16 +14045,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14023,137 +14066,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14161,11 +14180,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14174,41 +14193,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14216,26 +14235,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14243,7 +14262,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14251,7 +14270,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14260,7 +14279,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14268,89 +14287,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14358,7 +14377,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14369,14 +14388,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14385,69 +14404,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14458,11 +14477,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14472,7 +14491,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14480,11 +14499,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14492,13 +14511,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14509,23 +14528,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14533,11 +14552,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14547,33 +14566,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14581,13 +14600,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14596,6 +14615,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15259,8 +15302,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15284,36 +15334,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15325,7 +15353,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15336,7 +15364,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15348,41 +15376,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15390,7 +15418,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15398,58 +15426,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15457,7 +15485,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15465,13 +15493,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15480,7 +15508,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15489,18 +15517,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15508,7 +15536,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15518,11 +15546,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15530,15 +15558,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15546,11 +15574,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15558,29 +15586,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15589,11 +15617,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15601,14 +15629,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15617,13 +15645,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15902,26 +15950,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17525,10 +17571,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17600,6 +17643,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/ars/LC_MESSAGES/messages.po b/locales/ars/LC_MESSAGES/messages.po index f27d09a66..8718c5463 100644 --- a/locales/ars/LC_MESSAGES/messages.po +++ b/locales/ars/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -513,7 +513,7 @@ msgstr "" #: ../source/discussions/deploying-python-applications.rst:11 #: ../source/specifications/externally-managed-environments.rst:130 -#: ../source/specifications/platform-compatibility-tags.rst:21 +#: ../source/specifications/platform-compatibility-tags.rst:14 msgid "Overview" msgstr "" @@ -2725,7 +2725,7 @@ msgid "" msgstr "" #: ../source/guides/analyzing-pypi-package-downloads.rst:335 -#: ../source/specifications/dependency-specifiers.rst:489 +#: ../source/specifications/dependency-specifiers.rst:487 msgid "References" msgstr "" @@ -8274,7 +8274,7 @@ msgid "" msgstr "" #: ../source/key_projects.rst:184 -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "pip" msgstr "" @@ -10359,7 +10359,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:22 -#: ../source/specifications/platform-compatibility-tags.rst:46 +#: ../source/specifications/platform-compatibility-tags.rst:39 msgid "Details" msgstr "" @@ -10557,7 +10557,7 @@ msgid "E.g. 'py27', 'py2', 'py3'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:128 -#: ../source/specifications/platform-compatibility-tags.rst:27 +#: ../source/specifications/platform-compatibility-tags.rst:20 msgid "abi tag" msgstr "" @@ -10566,7 +10566,7 @@ msgid "E.g. 'cp33m', 'abi3', 'none'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:131 -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "platform tag" msgstr "" @@ -10748,7 +10748,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:226 -#: ../source/specifications/recording-installed-packages.rst:39 +#: ../source/specifications/recording-installed-packages.rst:23 msgid "The .dist-info directory" msgstr "" @@ -10890,7 +10890,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:314 -#: ../source/specifications/platform-compatibility-tags.rst:244 +#: ../source/specifications/platform-compatibility-tags.rst:237 msgid "FAQ" msgstr "" @@ -11027,36 +11027,38 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:419 -#: ../source/specifications/direct-url-data-structure.rst:266 -#: ../source/specifications/direct-url.rst:66 +#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/dependency-specifiers.rst:476 +#: ../source/specifications/direct-url-data-structure.rst:267 +#: ../source/specifications/direct-url.rst:67 +#: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 #: ../source/specifications/inline-script-metadata.rst:239 #: ../source/specifications/name-normalization.rst:42 +#: ../source/specifications/platform-compatibility-tags.rst:301 #: ../source/specifications/pyproject-toml.rst:442 +#: ../source/specifications/recording-installed-packages.rst:252 #: ../source/specifications/source-distribution-format.rst:144 #: ../source/specifications/version-specifiers.rst:1262 +#: ../source/specifications/virtual-environments.rst:54 msgid "History" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -msgid "This specification was originally approved as :pep:`427`." -msgstr "" - -#: ../source/specifications/binary-distribution-format.rst:423 -msgid "The following changes were applied since the initial version:" +msgid "February 2013: This specification was approved through :pep:`427`." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:425 +#: ../source/specifications/binary-distribution-format.rst:422 msgid "" -"The rules on escaping in wheel filenames were revised, to bring them into " -"line with what popular tools actually do (February 2021)." +"February 2021: The rules on escaping in wheel filenames were revised, to " +"bring them into line with what popular tools actually do." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:430 +#: ../source/specifications/binary-distribution-format.rst:427 msgid "Appendix" msgstr "" -#: ../source/specifications/binary-distribution-format.rst:432 +#: ../source/specifications/binary-distribution-format.rst:429 msgid "Example urlsafe-base64-nopad implementation::" msgstr "" @@ -11954,11 +11956,55 @@ msgid "" "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:854 +msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:855 +msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" +msgstr "" + +#: ../source/specifications/core-metadata.rst:856 +msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:857 +msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:859 +msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:860 +msgid "Added canonical method for transforming metadata to JSON." +msgstr "" + +#: ../source/specifications/core-metadata.rst:861 +msgid "Restricted the grammar of the ``Name`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:863 +msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:865 +msgid "Added the ``Dynamic`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:867 +msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:869 +msgid "Restricted extra names to be normalized." +msgstr "" + +#: ../source/specifications/core-metadata.rst:873 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:858 +#: ../source/specifications/core-metadata.rst:878 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" @@ -12410,35 +12456,29 @@ msgstr "" msgid "A test program - if the grammar is in a string ``grammar``:" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:476 -msgid "Summary of changes to PEP 508" -msgstr "" - #: ../source/specifications/dependency-specifiers.rst:478 -msgid "" -"The following changes were made based on feedback after its initial " -"implementation:" +msgid "November 2015: This specification was approved through :pep:`508`." msgstr "" -#: ../source/specifications/dependency-specifiers.rst:481 +#: ../source/specifications/dependency-specifiers.rst:479 msgid "" -"The definition of ``python_version`` was changed from ``platform." -"python_version()[:3]`` to ``'.'.join(platform.python_version_tuple()[:2])``, " -"to accommodate potential future versions of Python with 2-digit major and " -"minor versions (e.g. 3.10). [#future_versions]_" +"July 2019: The definition of ``python_version`` was `changed `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12465,7 +12505,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12549,10 +12589,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12900,17 +12938,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13112,6 +13149,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13711,7 +13754,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13928,7 +13971,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14000,16 +14045,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14023,137 +14066,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14161,11 +14180,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14174,41 +14193,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14216,26 +14235,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14243,7 +14262,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14251,7 +14270,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14260,7 +14279,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14268,89 +14287,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14358,7 +14377,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14369,14 +14388,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14385,69 +14404,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14458,11 +14477,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14472,7 +14491,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14480,11 +14499,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14492,13 +14511,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14509,23 +14528,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14533,11 +14552,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14547,33 +14566,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14581,13 +14600,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14596,6 +14615,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15259,8 +15302,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15284,36 +15334,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15325,7 +15353,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15336,7 +15364,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15348,41 +15376,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15390,7 +15418,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15398,58 +15426,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15457,7 +15485,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15465,13 +15493,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15480,7 +15508,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15489,18 +15517,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15508,7 +15536,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15518,11 +15546,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15530,15 +15558,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15546,11 +15574,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15558,29 +15586,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15589,11 +15617,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15601,14 +15629,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15617,13 +15645,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15902,26 +15950,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17525,10 +17571,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17600,6 +17643,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/de/LC_MESSAGES/messages.po b/locales/de/LC_MESSAGES/messages.po index c708d2240..d2fb397e8 100644 --- a/locales/de/LC_MESSAGES/messages.po +++ b/locales/de/LC_MESSAGES/messages.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2023-10-07 12:11+0000\n" "Last-Translator: Jean-Luc Tibaux \n" "Language-Team: German `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12505,7 +12545,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12589,10 +12629,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12940,17 +12978,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13152,6 +13189,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13755,7 +13798,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13974,7 +14017,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14046,16 +14091,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14069,137 +14112,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14207,11 +14226,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14220,42 +14239,42 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 #, fuzzy msgid "``manylinux``" msgstr "Betreuer" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14263,26 +14282,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14290,7 +14309,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14298,7 +14317,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14307,7 +14326,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14315,89 +14334,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14405,7 +14424,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14416,14 +14435,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14432,69 +14451,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14505,11 +14524,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14519,7 +14538,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14527,11 +14546,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14539,13 +14558,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14556,23 +14575,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14580,11 +14599,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14594,33 +14613,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14628,13 +14647,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14643,6 +14662,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15307,8 +15350,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15332,36 +15382,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15373,7 +15401,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15384,7 +15412,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15396,41 +15424,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15438,7 +15466,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15446,58 +15474,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15505,7 +15533,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15513,13 +15541,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15528,7 +15556,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15537,18 +15565,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15556,7 +15584,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15566,11 +15594,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15578,15 +15606,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15594,11 +15622,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15606,29 +15634,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15637,11 +15665,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15649,14 +15677,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15665,13 +15693,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15950,26 +15998,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17573,10 +17619,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17648,6 +17691,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/eo/LC_MESSAGES/messages.po b/locales/eo/LC_MESSAGES/messages.po index 721bde7f2..422474a44 100644 --- a/locales/eo/LC_MESSAGES/messages.po +++ b/locales/eo/LC_MESSAGES/messages.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2021-08-06 05:45+0000\n" "Last-Translator: meowmeowmeowcat \n" "Language-Team: Esperanto `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12722,7 +12762,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12807,10 +12847,8 @@ msgstr "Uzi ``pip`` por instali Pipenv:" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -13158,17 +13196,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13370,6 +13407,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13981,7 +14024,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -14207,7 +14250,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14280,16 +14325,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14303,142 +14346,118 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 #, fuzzy msgid "python tag" msgstr "python" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 #, fuzzy msgid "Python Tag" msgstr "python" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 #, fuzzy msgid "cp: CPython" msgstr "python" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 #, fuzzy msgid "ip: IronPython" msgstr "python" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 #, fuzzy msgid "jy: Jython" msgstr "python" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14446,11 +14465,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14459,42 +14478,42 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 #, fuzzy msgid "``manylinux``" msgstr "Prizorganto" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14502,26 +14521,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14529,7 +14548,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14537,7 +14556,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14546,7 +14565,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14554,89 +14573,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14644,7 +14663,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14655,14 +14674,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14671,69 +14690,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14744,11 +14763,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14758,7 +14777,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14766,11 +14785,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14778,13 +14797,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14795,23 +14814,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14819,11 +14838,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14833,33 +14852,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14867,13 +14886,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14882,6 +14901,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15550,8 +15593,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15575,36 +15625,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15616,7 +15644,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15627,7 +15655,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15639,41 +15667,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15681,7 +15709,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15689,58 +15717,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15748,7 +15776,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15756,13 +15784,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15771,7 +15799,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15780,18 +15808,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15799,7 +15827,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15809,11 +15837,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15821,15 +15849,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15837,11 +15865,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15849,29 +15877,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15880,11 +15908,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15892,14 +15920,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15908,13 +15936,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -16197,26 +16245,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17832,10 +17878,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17909,6 +17952,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/es/LC_MESSAGES/messages.po b/locales/es/LC_MESSAGES/messages.po index e9e60a600..d3216e3fc 100644 --- a/locales/es/LC_MESSAGES/messages.po +++ b/locales/es/LC_MESSAGES/messages.po @@ -13,7 +13,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2023-12-03 17:38+0000\n" "Last-Translator: gallegonovato \n" "Language-Team: Spanish `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12639,7 +12679,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12724,10 +12764,8 @@ msgstr "Sírvase de ``pip`` para instalar Sphinx:" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -13075,17 +13113,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13287,6 +13324,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 #, fuzzy msgid "Externally Managed Environments" @@ -13899,7 +13942,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -14125,7 +14168,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14199,16 +14244,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14222,137 +14265,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14360,11 +14379,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14373,42 +14392,42 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 #, fuzzy msgid "``manylinux``" msgstr "Responsable" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14416,26 +14435,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14443,7 +14462,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14451,7 +14470,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14460,7 +14479,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14468,89 +14487,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "Herramienta" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14558,7 +14577,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14569,14 +14588,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14585,69 +14604,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14658,11 +14677,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14672,7 +14691,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14680,11 +14699,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14692,13 +14711,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14709,23 +14728,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14733,11 +14752,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14747,33 +14766,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14781,13 +14800,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14796,6 +14815,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "El archivo :file:`.pypirc`" @@ -15463,8 +15506,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15488,36 +15538,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15529,7 +15557,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15540,7 +15568,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15552,7 +15580,7 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 #, fuzzy msgid "" "This ``.dist-info`` directory may contain the following files, described in " @@ -15561,37 +15589,37 @@ msgstr "" "El directorio ``.dist-info`` puede contener los archivos que se describen a " "detalle a continuación:" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "``METADATA``: contiene metadatos sobre el proyecto" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "``RECORD``: registra la lista de archivos instalados." -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" "``INSTALLER``: registra el nombre de la herramienta utilizada para instalar " "el proyecto." -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15599,7 +15627,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15607,58 +15635,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "El archivo METADATA" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "El archivo RECORD" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "delimitador de campos: ``,`` (coma)," -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15666,7 +15694,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15674,13 +15702,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15689,7 +15717,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15698,18 +15726,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15717,7 +15745,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15734,11 +15762,11 @@ msgstr "" "lo contrario la desinstalación del paquete dejará archivos no listados en su " "lugar (posiblemente resultando en un paquete de espacio de nombres zombie)." -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "El archivo INSTALLER" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15746,15 +15774,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15762,11 +15790,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15774,29 +15802,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15805,11 +15833,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15817,14 +15845,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15833,13 +15861,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "Formatos de archivo de distribución de paquetes" @@ -16121,26 +16169,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17754,10 +17800,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17831,6 +17874,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "Cómo obtener asistencia" diff --git a/locales/fa/LC_MESSAGES/messages.po b/locales/fa/LC_MESSAGES/messages.po index f433325cc..c2558a63d 100644 --- a/locales/fa/LC_MESSAGES/messages.po +++ b/locales/fa/LC_MESSAGES/messages.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2023-02-15 07:52+0000\n" "Last-Translator: Arsalan Dehghani \n" "Language-Team: Persian `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12474,7 +12514,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12558,10 +12598,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12909,17 +12947,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13121,6 +13158,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13720,7 +13763,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13937,7 +13980,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14010,16 +14055,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14033,137 +14076,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14171,11 +14190,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14184,41 +14203,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14226,26 +14245,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14253,7 +14272,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14261,7 +14280,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14270,7 +14289,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14278,89 +14297,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14368,7 +14387,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14379,14 +14398,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14395,69 +14414,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14468,11 +14487,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14482,7 +14501,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14490,11 +14509,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14502,13 +14521,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14519,23 +14538,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14543,11 +14562,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14557,33 +14576,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14591,13 +14610,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14606,6 +14625,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15269,8 +15312,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15294,36 +15344,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15335,7 +15363,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15346,7 +15374,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15358,41 +15386,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15400,7 +15428,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15408,58 +15436,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15467,7 +15495,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15475,13 +15503,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15490,7 +15518,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15499,18 +15527,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15518,7 +15546,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15528,11 +15556,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15540,15 +15568,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15556,11 +15584,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15568,29 +15596,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15599,11 +15627,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15611,14 +15639,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15627,13 +15655,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15912,26 +15960,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17541,10 +17587,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17616,6 +17659,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/fil/LC_MESSAGES/messages.po b/locales/fil/LC_MESSAGES/messages.po index 39b64004f..c2521a5ad 100644 --- a/locales/fil/LC_MESSAGES/messages.po +++ b/locales/fil/LC_MESSAGES/messages.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2022-11-19 08:28+0000\n" "Last-Translator: RedFurrFox \n" "Language-Team: Filipino `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12471,7 +12511,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12555,10 +12595,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12906,17 +12944,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13118,6 +13155,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13717,7 +13760,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13934,7 +13977,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14006,16 +14051,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14029,137 +14072,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14167,11 +14186,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14180,41 +14199,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14222,26 +14241,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14249,7 +14268,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14257,7 +14276,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14266,7 +14285,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14274,89 +14293,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14364,7 +14383,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14375,14 +14394,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14391,69 +14410,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14464,11 +14483,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14478,7 +14497,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14486,11 +14505,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14498,13 +14517,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14515,23 +14534,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14539,11 +14558,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14553,33 +14572,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14587,13 +14606,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14602,6 +14621,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15265,8 +15308,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15290,36 +15340,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15331,7 +15359,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15342,7 +15370,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15354,41 +15382,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15396,7 +15424,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15404,58 +15432,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15463,7 +15491,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15471,13 +15499,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15486,7 +15514,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15495,18 +15523,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15514,7 +15542,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15524,11 +15552,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15536,15 +15564,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15552,11 +15580,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15564,29 +15592,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15595,11 +15623,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15607,14 +15635,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15623,13 +15651,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15908,26 +15956,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17531,10 +17577,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17606,6 +17649,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/fr/LC_MESSAGES/messages.po b/locales/fr/LC_MESSAGES/messages.po index bd5dde3e2..d4c2b8ab2 100644 --- a/locales/fr/LC_MESSAGES/messages.po +++ b/locales/fr/LC_MESSAGES/messages.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2022-04-09 02:09+0000\n" "Last-Translator: Nathan \n" "Language-Team: French `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12727,7 +12767,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12811,10 +12851,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -13162,17 +13200,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13374,6 +13411,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 #, fuzzy msgid "Externally Managed Environments" @@ -13984,7 +14027,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -14206,7 +14249,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14280,16 +14325,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14303,143 +14346,119 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 #, fuzzy msgid "python tag" msgstr "python" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 #, fuzzy msgid "Use" msgstr "Usage :" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 #, fuzzy msgid "Python Tag" msgstr "python" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 #, fuzzy msgid "cp: CPython" msgstr "python" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 #, fuzzy msgid "ip: IronPython" msgstr "python" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 #, fuzzy msgid "jy: Jython" msgstr "python" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14447,11 +14466,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14460,41 +14479,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14502,26 +14521,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14529,7 +14548,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14537,7 +14556,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14546,7 +14565,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14554,89 +14573,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14644,7 +14663,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14655,14 +14674,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14671,69 +14690,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14744,11 +14763,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14758,7 +14777,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14766,11 +14785,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14778,13 +14797,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14795,23 +14814,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14819,11 +14838,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14833,33 +14852,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14867,13 +14886,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14882,6 +14901,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15547,8 +15590,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15572,36 +15622,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15613,7 +15641,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15624,7 +15652,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15636,41 +15664,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15678,7 +15706,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15686,58 +15714,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15745,7 +15773,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15753,13 +15781,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15768,7 +15796,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15777,18 +15805,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15796,7 +15824,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15806,11 +15834,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15818,15 +15846,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15834,11 +15862,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15846,29 +15874,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15877,11 +15905,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15889,14 +15917,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15905,13 +15933,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -16192,26 +16240,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17828,10 +17874,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17904,6 +17947,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/frc/LC_MESSAGES/messages.po b/locales/frc/LC_MESSAGES/messages.po index 28ced9002..03761161e 100644 --- a/locales/frc/LC_MESSAGES/messages.po +++ b/locales/frc/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -513,7 +513,7 @@ msgstr "" #: ../source/discussions/deploying-python-applications.rst:11 #: ../source/specifications/externally-managed-environments.rst:130 -#: ../source/specifications/platform-compatibility-tags.rst:21 +#: ../source/specifications/platform-compatibility-tags.rst:14 msgid "Overview" msgstr "" @@ -2725,7 +2725,7 @@ msgid "" msgstr "" #: ../source/guides/analyzing-pypi-package-downloads.rst:335 -#: ../source/specifications/dependency-specifiers.rst:489 +#: ../source/specifications/dependency-specifiers.rst:487 msgid "References" msgstr "" @@ -8274,7 +8274,7 @@ msgid "" msgstr "" #: ../source/key_projects.rst:184 -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "pip" msgstr "" @@ -10359,7 +10359,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:22 -#: ../source/specifications/platform-compatibility-tags.rst:46 +#: ../source/specifications/platform-compatibility-tags.rst:39 msgid "Details" msgstr "" @@ -10557,7 +10557,7 @@ msgid "E.g. 'py27', 'py2', 'py3'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:128 -#: ../source/specifications/platform-compatibility-tags.rst:27 +#: ../source/specifications/platform-compatibility-tags.rst:20 msgid "abi tag" msgstr "" @@ -10566,7 +10566,7 @@ msgid "E.g. 'cp33m', 'abi3', 'none'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:131 -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "platform tag" msgstr "" @@ -10748,7 +10748,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:226 -#: ../source/specifications/recording-installed-packages.rst:39 +#: ../source/specifications/recording-installed-packages.rst:23 msgid "The .dist-info directory" msgstr "" @@ -10890,7 +10890,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:314 -#: ../source/specifications/platform-compatibility-tags.rst:244 +#: ../source/specifications/platform-compatibility-tags.rst:237 msgid "FAQ" msgstr "" @@ -11027,36 +11027,38 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:419 -#: ../source/specifications/direct-url-data-structure.rst:266 -#: ../source/specifications/direct-url.rst:66 +#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/dependency-specifiers.rst:476 +#: ../source/specifications/direct-url-data-structure.rst:267 +#: ../source/specifications/direct-url.rst:67 +#: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 #: ../source/specifications/inline-script-metadata.rst:239 #: ../source/specifications/name-normalization.rst:42 +#: ../source/specifications/platform-compatibility-tags.rst:301 #: ../source/specifications/pyproject-toml.rst:442 +#: ../source/specifications/recording-installed-packages.rst:252 #: ../source/specifications/source-distribution-format.rst:144 #: ../source/specifications/version-specifiers.rst:1262 +#: ../source/specifications/virtual-environments.rst:54 msgid "History" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -msgid "This specification was originally approved as :pep:`427`." -msgstr "" - -#: ../source/specifications/binary-distribution-format.rst:423 -msgid "The following changes were applied since the initial version:" +msgid "February 2013: This specification was approved through :pep:`427`." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:425 +#: ../source/specifications/binary-distribution-format.rst:422 msgid "" -"The rules on escaping in wheel filenames were revised, to bring them into " -"line with what popular tools actually do (February 2021)." +"February 2021: The rules on escaping in wheel filenames were revised, to " +"bring them into line with what popular tools actually do." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:430 +#: ../source/specifications/binary-distribution-format.rst:427 msgid "Appendix" msgstr "" -#: ../source/specifications/binary-distribution-format.rst:432 +#: ../source/specifications/binary-distribution-format.rst:429 msgid "Example urlsafe-base64-nopad implementation::" msgstr "" @@ -11954,11 +11956,55 @@ msgid "" "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:854 +msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:855 +msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" +msgstr "" + +#: ../source/specifications/core-metadata.rst:856 +msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:857 +msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:859 +msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:860 +msgid "Added canonical method for transforming metadata to JSON." +msgstr "" + +#: ../source/specifications/core-metadata.rst:861 +msgid "Restricted the grammar of the ``Name`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:863 +msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:865 +msgid "Added the ``Dynamic`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:867 +msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:869 +msgid "Restricted extra names to be normalized." +msgstr "" + +#: ../source/specifications/core-metadata.rst:873 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:858 +#: ../source/specifications/core-metadata.rst:878 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" @@ -12410,35 +12456,29 @@ msgstr "" msgid "A test program - if the grammar is in a string ``grammar``:" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:476 -msgid "Summary of changes to PEP 508" -msgstr "" - #: ../source/specifications/dependency-specifiers.rst:478 -msgid "" -"The following changes were made based on feedback after its initial " -"implementation:" +msgid "November 2015: This specification was approved through :pep:`508`." msgstr "" -#: ../source/specifications/dependency-specifiers.rst:481 +#: ../source/specifications/dependency-specifiers.rst:479 msgid "" -"The definition of ``python_version`` was changed from ``platform." -"python_version()[:3]`` to ``'.'.join(platform.python_version_tuple()[:2])``, " -"to accommodate potential future versions of Python with 2-digit major and " -"minor versions (e.g. 3.10). [#future_versions]_" +"July 2019: The definition of ``python_version`` was `changed `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12465,7 +12505,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12549,10 +12589,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12900,17 +12938,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13112,6 +13149,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13711,7 +13754,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13928,7 +13971,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14000,16 +14045,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14023,137 +14066,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14161,11 +14180,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14174,41 +14193,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14216,26 +14235,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14243,7 +14262,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14251,7 +14270,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14260,7 +14279,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14268,89 +14287,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14358,7 +14377,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14369,14 +14388,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14385,69 +14404,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14458,11 +14477,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14472,7 +14491,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14480,11 +14499,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14492,13 +14511,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14509,23 +14528,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14533,11 +14552,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14547,33 +14566,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14581,13 +14600,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14596,6 +14615,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15259,8 +15302,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15284,36 +15334,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15325,7 +15353,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15336,7 +15364,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15348,41 +15376,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15390,7 +15418,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15398,58 +15426,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15457,7 +15485,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15465,13 +15493,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15480,7 +15508,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15489,18 +15517,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15508,7 +15536,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15518,11 +15546,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15530,15 +15558,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15546,11 +15574,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15558,29 +15586,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15589,11 +15617,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15601,14 +15629,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15617,13 +15645,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15902,26 +15950,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17525,10 +17571,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17600,6 +17643,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/gl/LC_MESSAGES/messages.po b/locales/gl/LC_MESSAGES/messages.po index 7ea4e9ab4..b01187cf0 100644 --- a/locales/gl/LC_MESSAGES/messages.po +++ b/locales/gl/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -513,7 +513,7 @@ msgstr "" #: ../source/discussions/deploying-python-applications.rst:11 #: ../source/specifications/externally-managed-environments.rst:130 -#: ../source/specifications/platform-compatibility-tags.rst:21 +#: ../source/specifications/platform-compatibility-tags.rst:14 msgid "Overview" msgstr "" @@ -2725,7 +2725,7 @@ msgid "" msgstr "" #: ../source/guides/analyzing-pypi-package-downloads.rst:335 -#: ../source/specifications/dependency-specifiers.rst:489 +#: ../source/specifications/dependency-specifiers.rst:487 msgid "References" msgstr "" @@ -8274,7 +8274,7 @@ msgid "" msgstr "" #: ../source/key_projects.rst:184 -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "pip" msgstr "" @@ -10359,7 +10359,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:22 -#: ../source/specifications/platform-compatibility-tags.rst:46 +#: ../source/specifications/platform-compatibility-tags.rst:39 msgid "Details" msgstr "" @@ -10557,7 +10557,7 @@ msgid "E.g. 'py27', 'py2', 'py3'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:128 -#: ../source/specifications/platform-compatibility-tags.rst:27 +#: ../source/specifications/platform-compatibility-tags.rst:20 msgid "abi tag" msgstr "" @@ -10566,7 +10566,7 @@ msgid "E.g. 'cp33m', 'abi3', 'none'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:131 -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "platform tag" msgstr "" @@ -10748,7 +10748,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:226 -#: ../source/specifications/recording-installed-packages.rst:39 +#: ../source/specifications/recording-installed-packages.rst:23 msgid "The .dist-info directory" msgstr "" @@ -10890,7 +10890,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:314 -#: ../source/specifications/platform-compatibility-tags.rst:244 +#: ../source/specifications/platform-compatibility-tags.rst:237 msgid "FAQ" msgstr "" @@ -11027,36 +11027,38 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:419 -#: ../source/specifications/direct-url-data-structure.rst:266 -#: ../source/specifications/direct-url.rst:66 +#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/dependency-specifiers.rst:476 +#: ../source/specifications/direct-url-data-structure.rst:267 +#: ../source/specifications/direct-url.rst:67 +#: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 #: ../source/specifications/inline-script-metadata.rst:239 #: ../source/specifications/name-normalization.rst:42 +#: ../source/specifications/platform-compatibility-tags.rst:301 #: ../source/specifications/pyproject-toml.rst:442 +#: ../source/specifications/recording-installed-packages.rst:252 #: ../source/specifications/source-distribution-format.rst:144 #: ../source/specifications/version-specifiers.rst:1262 +#: ../source/specifications/virtual-environments.rst:54 msgid "History" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -msgid "This specification was originally approved as :pep:`427`." -msgstr "" - -#: ../source/specifications/binary-distribution-format.rst:423 -msgid "The following changes were applied since the initial version:" +msgid "February 2013: This specification was approved through :pep:`427`." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:425 +#: ../source/specifications/binary-distribution-format.rst:422 msgid "" -"The rules on escaping in wheel filenames were revised, to bring them into " -"line with what popular tools actually do (February 2021)." +"February 2021: The rules on escaping in wheel filenames were revised, to " +"bring them into line with what popular tools actually do." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:430 +#: ../source/specifications/binary-distribution-format.rst:427 msgid "Appendix" msgstr "" -#: ../source/specifications/binary-distribution-format.rst:432 +#: ../source/specifications/binary-distribution-format.rst:429 msgid "Example urlsafe-base64-nopad implementation::" msgstr "" @@ -11954,11 +11956,55 @@ msgid "" "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:854 +msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:855 +msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" +msgstr "" + +#: ../source/specifications/core-metadata.rst:856 +msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:857 +msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:859 +msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:860 +msgid "Added canonical method for transforming metadata to JSON." +msgstr "" + +#: ../source/specifications/core-metadata.rst:861 +msgid "Restricted the grammar of the ``Name`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:863 +msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:865 +msgid "Added the ``Dynamic`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:867 +msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:869 +msgid "Restricted extra names to be normalized." +msgstr "" + +#: ../source/specifications/core-metadata.rst:873 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:858 +#: ../source/specifications/core-metadata.rst:878 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" @@ -12410,35 +12456,29 @@ msgstr "" msgid "A test program - if the grammar is in a string ``grammar``:" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:476 -msgid "Summary of changes to PEP 508" -msgstr "" - #: ../source/specifications/dependency-specifiers.rst:478 -msgid "" -"The following changes were made based on feedback after its initial " -"implementation:" +msgid "November 2015: This specification was approved through :pep:`508`." msgstr "" -#: ../source/specifications/dependency-specifiers.rst:481 +#: ../source/specifications/dependency-specifiers.rst:479 msgid "" -"The definition of ``python_version`` was changed from ``platform." -"python_version()[:3]`` to ``'.'.join(platform.python_version_tuple()[:2])``, " -"to accommodate potential future versions of Python with 2-digit major and " -"minor versions (e.g. 3.10). [#future_versions]_" +"July 2019: The definition of ``python_version`` was `changed `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12465,7 +12505,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12549,10 +12589,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12900,17 +12938,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13112,6 +13149,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13711,7 +13754,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13928,7 +13971,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14000,16 +14045,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14023,137 +14066,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14161,11 +14180,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14174,41 +14193,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14216,26 +14235,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14243,7 +14262,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14251,7 +14270,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14260,7 +14279,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14268,89 +14287,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14358,7 +14377,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14369,14 +14388,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14385,69 +14404,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14458,11 +14477,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14472,7 +14491,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14480,11 +14499,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14492,13 +14511,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14509,23 +14528,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14533,11 +14552,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14547,33 +14566,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14581,13 +14600,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14596,6 +14615,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15259,8 +15302,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15284,36 +15334,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15325,7 +15353,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15336,7 +15364,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15348,41 +15376,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15390,7 +15418,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15398,58 +15426,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15457,7 +15485,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15465,13 +15493,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15480,7 +15508,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15489,18 +15517,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15508,7 +15536,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15518,11 +15546,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15530,15 +15558,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15546,11 +15574,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15558,29 +15586,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15589,11 +15617,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15601,14 +15629,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15617,13 +15645,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15902,26 +15950,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17525,10 +17571,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17600,6 +17643,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/hi/LC_MESSAGES/messages.po b/locales/hi/LC_MESSAGES/messages.po index 26e828852..c82838d04 100644 --- a/locales/hi/LC_MESSAGES/messages.po +++ b/locales/hi/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2022-09-29 05:18+0000\n" "Last-Translator: Aryan 'Ba3a' Kumar \n" "Language-Team: Hindi `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12496,7 +12536,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12580,10 +12620,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12931,17 +12969,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13143,6 +13180,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13744,7 +13787,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13963,7 +14006,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14035,16 +14080,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14058,137 +14101,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14196,11 +14215,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14209,41 +14228,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14251,26 +14270,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14278,7 +14297,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14286,7 +14305,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14295,7 +14314,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14303,89 +14322,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14393,7 +14412,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14404,14 +14423,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14420,69 +14439,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14493,11 +14512,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14507,7 +14526,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14515,11 +14534,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14527,13 +14546,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14544,23 +14563,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14568,11 +14587,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14582,33 +14601,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14616,13 +14635,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14631,6 +14650,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15294,8 +15337,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15319,36 +15369,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15360,7 +15388,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15371,7 +15399,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15383,41 +15411,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15425,7 +15453,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15433,58 +15461,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15492,7 +15520,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15500,13 +15528,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15515,7 +15543,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15524,18 +15552,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15543,7 +15571,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15553,11 +15581,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15565,15 +15593,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15581,11 +15609,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15593,29 +15621,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15624,11 +15652,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15636,14 +15664,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15652,13 +15680,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15937,26 +15985,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17560,10 +17606,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17635,6 +17678,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/id/LC_MESSAGES/messages.po b/locales/id/LC_MESSAGES/messages.po index 4371bc18f..ef1e23e9c 100644 --- a/locales/id/LC_MESSAGES/messages.po +++ b/locales/id/LC_MESSAGES/messages.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2022-04-19 10:04+0000\n" "Last-Translator: SimpleXtra \n" "Language-Team: Indonesian `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12506,7 +12546,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12590,10 +12630,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12941,17 +12979,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13153,6 +13190,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13754,7 +13797,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13973,7 +14016,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14046,16 +14091,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14069,137 +14112,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14207,11 +14226,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14220,41 +14239,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14262,26 +14281,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14289,7 +14308,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14297,7 +14316,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14306,7 +14325,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14314,89 +14333,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14404,7 +14423,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14415,14 +14434,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14431,69 +14450,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14504,11 +14523,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14518,7 +14537,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14526,11 +14545,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14538,13 +14557,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14555,23 +14574,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14579,11 +14598,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14593,33 +14612,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14627,13 +14646,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14642,6 +14661,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15305,8 +15348,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15330,36 +15380,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15371,7 +15399,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15382,7 +15410,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15394,41 +15422,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15436,7 +15464,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15444,58 +15472,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15503,7 +15531,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15511,13 +15539,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15526,7 +15554,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15535,18 +15563,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15554,7 +15582,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15564,11 +15592,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15576,15 +15604,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15592,11 +15620,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15604,29 +15632,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15635,11 +15663,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15647,14 +15675,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15663,13 +15691,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15948,26 +15996,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17577,10 +17623,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17652,6 +17695,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/ja/LC_MESSAGES/messages.po b/locales/ja/LC_MESSAGES/messages.po index 7e5d8c41b..b05fdd9bb 100644 --- a/locales/ja/LC_MESSAGES/messages.po +++ b/locales/ja/LC_MESSAGES/messages.po @@ -8,17 +8,17 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" -"PO-Revision-Date: 2023-12-20 20:17+0000\n" -"Last-Translator: nikkie \n" -"Language-Team: Japanese \n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" +"PO-Revision-Date: 2023-12-29 19:23+0000\n" +"Last-Translator: moto kawasaki \n" +"Language-Team: Japanese \n" "Language: ja\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=1; plural=0;\n" -"X-Generator: Weblate 5.3\n" +"X-Generator: Weblate 5.4-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" @@ -643,7 +643,7 @@ msgstr "2021-8-24" #: ../source/discussions/deploying-python-applications.rst:11 #: ../source/specifications/externally-managed-environments.rst:130 -#: ../source/specifications/platform-compatibility-tags.rst:21 +#: ../source/specifications/platform-compatibility-tags.rst:14 msgid "Overview" msgstr "概要" @@ -816,6 +816,14 @@ msgid "" "Alternatively, the term \"distribution package\" can be used to refer to a " "specific file that contains a certain version of a project." msgstr "" +"配布パッケージとは、インストール可能な一片のソフトウェアです。ほとんどの場合" +"、これは \"プロジェクト \" と同義です。 ``pip install pkg`` " +"とタイプする時、あるいは、 ``pyproject.toml`` に ``dependencies = [\"pkg\"]``" +" と書く時、 ``pkg`` のところには配布パッケージの名前を書きます。Python " +"のライブラリやツール類の集約された源として最も広く知られている PyPI_ で検索し" +"たり閲覧する時、あなたが目にするものは配布パッケージのリストです。あるいは、" +"\"配布パッケージ\" という言葉があるプロジェクトの特定のバージョンを内包した特" +"定のファイルのことを指す場合もあります。" #: ../source/discussions/distribution-package-vs-import-package.rst:24 msgid "" @@ -824,12 +832,15 @@ msgid "" "by the system package manager of the `Linux distribution `_, which " "is a different meaning." msgstr "" +"Linux の世界では、 \"配布パッケージ \" が " +"\"ディストロパッケージ \" か単に \"パッケージ \" " +"と短縮形で呼ばれることが通常であり、 `Linux ディストリビューション `" +"_ のシステムパッケージ管理者によって提供される何かのことであって、異なる意味" +"で使われているということは意識しておいてください。" #: ../source/discussions/distribution-package-vs-import-package.rst:31 -#, fuzzy -#| msgid "and import the package:" msgid "What's an import package?" -msgstr "そして、パッケージをインポートしましょう:" +msgstr "パッケージをインポートする、とは何でしょうか？" #: ../source/discussions/distribution-package-vs-import-package.rst:33 msgid "" @@ -841,16 +852,23 @@ msgid "" "is a directory on the file system, containing modules as ``.py`` files and " "subpackages as subdirectories." msgstr "" +"インポートパッケージは Python モジュールです。したがって、 Python コードに ``" +"import pkg`` もしくは ``from pkg import func`` と書く時、``pkg`` の部分はイン" +"ポートパッケージの名称です。より精確には、インポートパッケージは、" +"サブモジュールを内包することができる特別な Python モジュールです。通常は、イ" +"ンポートパッケージはファイルシステム上のディレクトリであって、モジュールを ``" +".py`` の形で含み、サブパッケージをサブディレクトリの形で含むものです。" #: ../source/discussions/distribution-package-vs-import-package.rst:42 msgid "" "You can use an import package as soon as you have installed a distribution " "package that provides it." -msgstr "" +msgstr "インポートパッケージを提供する配布パッケージをインストールするや否や、インポ" +"ートパッケージを使用することができます。" #: ../source/discussions/distribution-package-vs-import-package.rst:47 msgid "What are the links between distribution packages and import packages?" -msgstr "" +msgstr "配布パッケージとインポートパッケージの間の繋がりとは何でしょうか？" #: ../source/discussions/distribution-package-vs-import-package.rst:49 msgid "" @@ -858,6 +876,9 @@ msgid "" "(or non-package module), with a matching name. For example, ``pip install " "numpy`` lets you ``import numpy``." msgstr "" +"ほとんどの場合、配布パッケージはあるひとつのインポートパッケージ " +"(またはパッケージではないモジュール) を対応する名称で提供します。例えば、 ``" +"pip install numpy`` を行えば ``import numpy`` として使うことができます。" #: ../source/discussions/distribution-package-vs-import-package.rst:53 msgid "" @@ -867,6 +888,12 @@ msgid "" "blindly install the PyPI package ``foo`` if you see ``import foo``; this may " "install an unintended, and potentially even malicious package.)" msgstr "" +"しかしながら、これは単なる慣習です。PyPI や他のパッケージインデックスでは、" +"配布パッケージとそれが提供するインポートパッケージの名称の間に " +"*なんらかの関係性を強制することはしません* 。 (このことの帰結として、 ``" +"import foo`` を見たからと言って盲目的に PyPI のパッケージ ``foo`` " +"をインストールすることはできません; これは意図しないか、あるいは潜在的には悪" +"意のあるパッケージをインストールしてしまうことになりかねません。)" #: ../source/discussions/distribution-package-vs-import-package.rst:59 msgid "" @@ -879,6 +906,14 @@ msgid "" "generally, a fork of an existing library is a common reason for differing " "names between the distribution package and the import package." msgstr "" +"配布パッケージは、異なる名称でインポートパッケージを提供することが可能です。" +"この例としては、画像処理分野で人気のある Pillow_ です。" +"配布パッケージの名称は ``Pillow`` ですが、インポートパッケージとしては " +"``PIL`` を提供しています。これには歴史的な理由があります: Pillow は PIL " +"ライブラリのフォークとして始まり、PIL の既存のユーザがあまり手間をかけずに " +"Pillow に移行できるようにインポート名称の ``PIL`` を使い続けたのです。もっと" +"一般的にいうと、配布パッケージとインポートパッケージの間で異なる名称を使う時" +"のよくある理由が既存のライブラリからのフォークなのです。" #: ../source/discussions/distribution-package-vs-import-package.rst:69 msgid "" @@ -887,6 +922,10 @@ msgid "" "packages with the same name can be provided by several distribution " "packages. Again, forks are a common reason for this." msgstr "" +"(PyPI のような) あるパッケージインデックス内では、配布パッケージの名称は一意" +"でなければなりません。他方で、インポートパッケージにはそのような要求事項はあ" +"りません。同じ名称のインポートパッケージが複数の配布パッケージから提供される" +"ということも可能です。繰り返しますが、これのよくある理由はフォークです。" #: ../source/discussions/distribution-package-vs-import-package.rst:74 msgid "" @@ -895,10 +934,15 @@ msgid "" "which provides both an ``attrs`` import package with a newer API, and an " "``attr`` import package with an older but supported API." msgstr "" +"一方で、あまり見かけませんが、配布パッケージは複数のインポートパッケージを提" +"供することができます。その例は attrs_ 配布パッケージで、より新しい API " +"を持つ ``attrs`` インポートパッケージと、旧来のものだがサポートされている " +"API を持つ ``attr`` の両方を提供します。" #: ../source/discussions/distribution-package-vs-import-package.rst:81 msgid "How do distribution package names and import package names compare?" -msgstr "" +msgstr "配布パッケージの名称とインポートパッケージの名称は、どのように比較されるので" +"しょうか？" #: ../source/discussions/distribution-package-vs-import-package.rst:83 msgid "" @@ -907,6 +951,10 @@ msgid "" "[#non-identifier-mod-name]_. In particular, they use underscores ``_`` as " "word separator and they are case-sensitive." msgstr "" +"インポートパッケージは、その名称として正当な Python 識別子 (Python " +"の説明文書の中に :ref:`exact rules ` が見つかるでしょう) " +"[#non-identifier-mod-name]_ を持っているべきです。特に、" +"単語間の区切りにアンダースコア ``_`` を使い、また、大文字小文字を区別します。" #: ../source/discussions/distribution-package-vs-import-package.rst:88 msgid "" @@ -918,6 +966,14 @@ msgid "" "``pip install awesome-package`` (the precise rules are given in the :ref:" "`name normalization specification `)." msgstr "" +"他方で、配布パッケージはハイフン ``-`` でもアンダースコア ``_`` " +"でも使うことができます。また、 :ref:`名前空間パッケージ ` " +"のサブパッケージをパッケージングするために使われることがあるドット ``.`` " +"を含むこともできます。ほとんどの目的においては、大文字小文字や ``-`` 対 ``_``" +" の違いをを区別せず、例えば、 ``pip install Awesome_Package`` と ``pip " +"install awesome-package`` は同じものです (詳細な規則は :ref:`名前正規化仕様 " +"` にあります) 。" #: ../source/discussions/distribution-package-vs-import-package.rst:101 msgid "" @@ -925,6 +981,10 @@ msgid "" "have a valid Python identifier as their name, using :doc:`importlib `, this is vanishingly rare and strongly discouraged." msgstr "" +"正当な Python " +"識別子をその名称として持たないパッケージ/モジュールをインストールすることは、" +" :doc:`importlib ` を使うことで技術的には可能ではあ" +"りますが、絶無と言って良いほど稀であり、強く抑制されています。" #: ../source/discussions/index.rst:4 msgid "" @@ -1256,14 +1316,6 @@ msgstr "" "ん。" #: ../source/discussions/setup-py-deprecated.rst:10 -#, fuzzy -#| msgid "" -#| "Setuptools is perfectly usable as a :term:`build backend` for packaging " -#| "Python projects. And :file:`setup.py` is a valid configuration file for :" -#| "ref:`setuptools` that happens to be written in Python, instead of in " -#| "*TOML* for example (a similar practice is used by other tools like *nox* " -#| "and its :file:`nox.py` configuration file, or *pytest* and :file:" -#| "`conftest.py`)." msgid "" "Setuptools is perfectly usable as a :term:`build backend` for packaging " "Python projects. And :file:`setup.py` is a valid configuration file for :ref:" @@ -1271,11 +1323,12 @@ msgid "" "example (a similar practice is used by other tools like *nox* and its :file:" "`noxfile.py` configuration file, or *pytest* and :file:`conftest.py`)." msgstr "" -"Setuptools は、 Python のプロジェクトをパッケージングすることに完璧に使用可能" -"です。そして、 :file:`setup.py` は、例えば *TOML* の代わりにたまたま Python " -"で書かれている :ref:`setuptools` 向けの正当な設定ファイルです (*nox* とその設" -"定ファイルである :file:`nox.py` や *pytest* と :file:`conftest` のような他の" -"ツール類でも、よく似たパターンが使われています)。" +"Setuptools は、 :term:`ビルドバックエンド ` として Python " +"のプロジェクトをパッケージングすることに完璧に使用可能です。そして、 " +":file:`setup.py` は、例えば *TOML* の代わりにたまたま Python で書かれている " +":ref:`setuptools` 向けの正当な設定ファイルです (*nox* " +"とその設定ファイルである :file:`nox.filepy` や *pytest* と :file:`conftest." +"py` のような他のツール類でも、よく似たパターンが使われています)。" #: ../source/discussions/setup-py-deprecated.rst:18 msgid "" @@ -2383,15 +2436,6 @@ msgstr "" "ユーザがインターネットからダウンロードしてインストールするものです。" #: ../source/glossary.rst:64 -#, fuzzy -#| msgid "" -#| "A distribution package is more commonly referred to with the single words " -#| "\"package\" or \"distribution\", but this guide may use the expanded term " -#| "when more clarity is needed to prevent confusion with an :term:`Import " -#| "Package` (which is also commonly called a \"package\") or another kind of " -#| "distribution (e.g. a Linux distribution or the Python language " -#| "distribution), which are often referred to with the single term " -#| "\"distribution\"." msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2402,11 +2446,12 @@ msgid "" "\"distribution\". See :ref:`distribution-package-vs-import-package` for a " "breakdown of the differences." msgstr "" -"配布物パッケージは単語ひとつで「パッケージ」や「配布物」と呼ばれることもしば" -"しばですが、 :term:`Import Package`(これも通常は単に「パッケージ」と呼ばれま" -"す)や他の種類の配布物(例えばLinuxディストリビューションやPython言語の配布物)" -"でよく単語ひとつの「配布物」と呼ばれるものとの混同を避けるために明確に述べる" -"必要がある場合には、本ガイドでは長い方の呼び方を用いることがあります。" +"配布パッケージは単語ひとつで「パッケージ」や「配布物」と呼ばれることもしばし" +"ばですが、本ガイドでは、 :term:`インポートパッケージ `(これも" +"通常は単に「パッケージ」と呼ばれます)や他の種類の配布物(例えばLinuxディストリ" +"ビューションやPython言語の配布物)でよく単語ひとつの「配布物」と呼ばれるものと" +"の混同を避けるために明確に述べる必要がある場合には、長い方の用語を用いること" +"があります。" #: ../source/glossary.rst:72 msgid "Egg" @@ -2462,7 +2507,7 @@ msgstr "" #: ../source/glossary.rst:98 msgid "Import Package" -msgstr "パッケージ" +msgstr "インポートパッケージ" #: ../source/glossary.rst:101 msgid "" @@ -2473,12 +2518,6 @@ msgstr "" "Pythonモジュール。" #: ../source/glossary.rst:104 -#, fuzzy -#| msgid "" -#| "An import package is more commonly referred to with the single word " -#| "\"package\", but this guide will use the expanded term when more clarity " -#| "is needed to prevent confusion with a :term:`Distribution Package` which " -#| "is also commonly called a \"package\"." msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2486,10 +2525,10 @@ msgid "" "also commonly called a \"package\". See :ref:`distribution-package-vs-import-" "package` for a breakdown of the differences." msgstr "" -"インポートパッケージは、より普通には「パッケージ」という用語で呼ばれますが、" -"本ガイドでは、同様に単に「パッケージ」と呼ばれることが普通である :term:`配布" -"物パッケージ `との混同を避けるために必要な場合には、長" -"い方の用語を用いることにします。" +"インポートパッケージは、より普通には「パッケージ」という１単語の用語で呼ばれ" +"ますが、本ガイドでは、同様に単に「パッケージ」と呼ばれることが普通である " +":term:`配布物パッケージ `との混同を避けるために必要な場" +"合には、長い方の用語を用いることにします。" #: ../source/glossary.rst:109 msgid "Module" @@ -2703,27 +2742,18 @@ msgid "Requirement Specifier" msgstr "要求事項識別子" #: ../source/glossary.rst:211 -#, fuzzy -#| msgid "" -#| "A format used by :ref:`pip` to install packages from a :term:`Package " -#| "Index`. For an EBNF diagram of the format, see the `pkg_resources." -#| "Requirement `_ entry in the :ref:`setuptools` docs. For " -#| "example, \"foo>=1.3\" is a requirement specifier, where \"foo\" is the " -#| "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " "For example, \"foo>=1.3\" is a requirement specifier, where \"foo\" is the " "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -":term:`パッケージインデックス `からパッケージをインストールす" -"るために :ref:`pip` で用いられる様式。この様式の EBNF 文法構造については :" -"ref:`setuptools` のドキュメントにある <`pkg_resources.Requirement `_ の項をご覧ください。例えば、\"foo>=1.3\"は要求事項識別子であ" -"り、\"foo\"の部分がプロジェクトの名称、\">=1.3\"の部分が :term:`バージョン識" -"別子 ` に該当します。" +":term:`パッケージインデックス `" +"からパッケージをインストールするために :ref:`pip` で用いられる様式。" +"この様式の EBNF 文法構造については、 :ref:`依存関係指定子 ` を見てください。例えば、 \"foo>=1.3\" は要求事項識別子であり、 " +"\"foo\" の部分がプロジェクトの名称で、 \">=1.3\" の部分は :term:`" +"バージョン指定子 ` です" #: ../source/glossary.rst:216 msgid "Requirements File" @@ -3454,7 +3484,7 @@ msgstr "" "できます。" #: ../source/guides/analyzing-pypi-package-downloads.rst:335 -#: ../source/specifications/dependency-specifiers.rst:489 +#: ../source/specifications/dependency-specifiers.rst:487 msgid "References" msgstr "参考文献" @@ -5142,12 +5172,6 @@ msgid "Hosting your own simple repository" msgstr "あなた自身の単純なリポジトリをホストする" #: ../source/guides/hosting-your-own-index.rst:8 -#, fuzzy -#| msgid "" -#| "If you wish to host your own simple repository [1]_, you can either use a " -#| "software package like :doc:`devpi ` or you can use simply " -#| "create the proper directory structure and use any web server that can " -#| "serve static files and generate an autoindex." msgid "" "If you wish to host your own simple repository [1]_, you can either use a " "software package like :doc:`devpi ` or you can simply create " @@ -5155,9 +5179,9 @@ msgid "" "files and generate an autoindex." msgstr "" "あなた自身の単純なリポジトリ [1]_ をホストしたいのであれば、 :doc:`devpi " -"` のようなソフトウェアパッケージを使うこともできますし、単にウェ" -"ブサーバ上に適当なディレクトリを作成して静的ファイルをそこに置き、自動でイン" -"デックスを生成させることも可能です。" +"` のようなソフトウェアパッケージを使うこともできますし、単に " +"web サーバ上に適切なディレクトリを作成して静的ファイルを提供し自動でインデッ" +"クスを生成させることも可能です。" #: ../source/guides/hosting-your-own-index.rst:13 msgid "" @@ -8204,12 +8228,18 @@ msgid "" "need compatibility with packages already using this method. Also, :doc:" "`pkg_resources ` has been deprecated." msgstr "" +"これらのふたつの方法は、 :pep:`420` 以前に名前空間を作成するのに使われました" +"が、今では過去のやり方であると考えられていて、すでにこの方法を使っているパッ" +"ケージとの互換性を必要とする場合を除いては使われるべきではないと考えられてい" +"ます。また、 :doc:`pkg_resources ` " +"は非推奨になりました。" #: ../source/guides/packaging-namespace-packages.rst:165 msgid "" "To migrate an existing package, all packages sharing the namespace must be " "migrated simultaneously." -msgstr "" +msgstr "既存のパッケージを移植するためには、名前空間を共有するすべてのパッケージが同" +"時に移植されなければなりません。" #: ../source/guides/packaging-namespace-packages.rst:167 msgid "" @@ -8251,28 +8281,25 @@ msgstr "" #: ../source/guides/packaging-namespace-packages.rst:195 #: ../source/guides/packaging-namespace-packages.rst:242 -#, fuzzy msgid "" "The :file:`__init__.py` file for the namespace package needs to contain the " "following:" -msgstr "" -"名前空間パッケージ用の :file:`__init__.py` ファイルは、次に示すもの **だけ** " -"を含んでいる必要があります:" +msgstr "名前空間パッケージ用の :file:`__init__.py` " +"ファイルは、次に示すものを含んでいる必要があります:" #: ../source/guides/packaging-namespace-packages.rst:202 #: ../source/guides/packaging-namespace-packages.rst:249 -#, fuzzy 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." msgstr "" -"名前空間パッケージを用いる **すべての** 配布物は、同一の :file:`__init__.py` " -"を持たなければなりません。もしいずれかの配布物で異なっていれば、名前空間の論" -"理破綻を招き、他のサブパッケージをインポートすることができなくなるでしょ" -"う。 :file:`__init__.py` に他のコードを追加しても、それはアクセスできないもの" -"となるでしょう。" +"ある名前空間パッケージを用いる **すべての** 配布物は、 :file:`__init__.py` を" +"持っていなければなりません。もしいずれかの配布物でそうなっていなければ、名前" +"空間の論理破綻を招き、他のサブパッケージをインポートすることができなくなるで" +"しょう。 :file:`__init__.py` " +"に他のコードを追加しても、それはアクセスできないものとなるでしょう。" #: ../source/guides/packaging-namespace-packages.rst:207 msgid "" @@ -8711,6 +8738,12 @@ msgid "" "increased, but a better solution may constitute to use a PyPI-compatible " "server like :ref:`pypiserver` in the CI for testing purposes." msgstr "" +"リポジトリで活発に頻繁なコミットがあって、前述のようにあらゆるプッシュが " +"TestPyPI へアップロードされているなら、そのプロジェクトは `PyPI " +"プロジェクトサイズ制限 `_ " +"を超過するかもしれません。この制限を緩和することもできますが、" +"より良い解決策は試験目的の CI の中で :ref:`pypiserver` のような PyPI " +"と互換のあるサーバを使うように構成することかもしれません。" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:232 msgid "" @@ -8721,18 +8754,16 @@ msgstr "" "ます。" #: ../source/guides/section-build-and-publish.rst:3 -#, fuzzy msgid "Building and Publishing" -msgstr "プロジェクトをビルドして公開する:" +msgstr "ビルドすることと公開すること" #: ../source/guides/section-hosting.rst:3 msgid "Hosting" -msgstr "" +msgstr "ホスティング" #: ../source/guides/section-install.rst:3 -#, fuzzy msgid "Installation" -msgstr "インストールフォーマット" +msgstr "インストール" #: ../source/guides/single-sourcing-package-version.rst:5 msgid "Single-sourcing the package version" @@ -8740,11 +8771,11 @@ msgstr "パッケージのバージョンを１箇所で管理する" #: ../source/guides/single-sourcing-package-version.rst:7 msgid "Todo" -msgstr "" +msgstr "Todo" #: ../source/guides/single-sourcing-package-version.rst:7 msgid "Update this page for build backends other than setuptools." -msgstr "" +msgstr "setuptools 以外のビルドバックエンドについてこのページを更新すること。" #: ../source/guides/single-sourcing-package-version.rst:9 msgid "" @@ -9902,13 +9933,12 @@ msgid "Including files in source distributions with ``MANIFEST.in``" msgstr "``MANIFEST.in`` を使ってソースコード配布物にファイルを含める" #: ../source/guides/using-manifest-in.rst:7 -#, fuzzy msgid "" "The information on this page has moved to :doc:`setuptools:userguide/" "miscellaneous` in the setuptools documentation." msgstr "" -"詳しくは、 :doc:`setuptools 説明文書 ` の中の :doc:`エント" -"リポイント ` を見てください。" +"このページの情報は、setuptools 説明文書の中の :doc:`setuptools:userguide/" +"miscellaneous` に移されました。" #: ../source/guides/using-testpypi.rst:7 msgid "" @@ -9996,21 +10026,16 @@ msgid "Setting up TestPyPI in :file:`.pypirc`" msgstr ":file:`.pypirc` ファイルで TestPyPI を設定する" #: ../source/guides/using-testpypi.rst:75 -#, fuzzy -#| msgid "" -#| "If you want to avoid entering your username, you can configure TestPyPI " -#| "in your :file:`$HOME/.pypirc`:" msgid "" "If you want to avoid being prompted for your username and password every " "time, you can configure TestPyPI in your :file:`$HOME/.pypirc`:" msgstr "" -"(毎回 TestPyPI の) ユーザ名を入力するのが面倒なら、 :file:`$HOME/.pypirc` " -"ファイルに TestPyPI 関連の設定をしておくことができます:" +"ユーザ名やパスワードの入力を毎回促されるのを避けたいなら、 :file:`$HOME/." +"pypirc` 内で TestPyPI の設定をしておくことができます。" #: ../source/guides/writing-pyproject-toml.rst:5 -#, fuzzy msgid "Writing your ``pyproject.toml``" -msgstr "pyproject.toml を作成する" +msgstr "``pyproject.toml`` を書く" #: ../source/guides/writing-pyproject-toml.rst:7 msgid "" @@ -10018,6 +10043,9 @@ msgid "" "as other tools such as linters, type checkers, etc. There are three possible " "TOML tables in this file." msgstr "" +"``pyproject.toml`` は、lintersやtype " +"checkersやその他のパッケージングツール群でも同様に使われる設定ファイルです。" +"このファイルの中には３個の TOML テーブルを置くことが可能です。" #: ../source/guides/writing-pyproject-toml.rst:11 msgid "" @@ -10025,6 +10053,10 @@ msgid "" "declare which :term:`build backend` you use and which other dependencies are " "needed to build your project." msgstr "" +"``[build-system]`` テーブルは、 **強く推奨されています** 。これを使うことで、" +"どの :term:`ビルドバックエンド ` を使うのか、また、そのプロジ" +"ェクトをビルドするためには他のどんな依存関係が必要なのかを宣言することができ" +"ます。" #: ../source/guides/writing-pyproject-toml.rst:15 msgid "" @@ -10032,6 +10064,8 @@ msgid "" "specify your project's basic metadata, such as the dependencies, your name, " "etc." msgstr "" +"``[project]`` テーブルは、依存関係や作者の名前など、そのプロジェクトの基本的" +"なメタデータを指定するためにほとんどのビルドバックエンドが用いるものです。" #: ../source/guides/writing-pyproject-toml.rst:18 msgid "" @@ -10040,6 +10074,11 @@ msgid "" "because its contents are defined by each tool. Consult the particular tool's " "documentation to know what it can contain." msgstr "" +"``[tool]`` テーブルは、例えば ``[tool.hatch]`` や ``[tool.black]`` や ``[tool" +".mypy]`` のような、ツールに特化したサブテーブルを持っています。テーブルの内容" +"がツール毎に定義されているので、ここでは簡単に触れるだけに留めます。何を含め" +"ておくことができるのかを知るためには、それぞれのツールの説明文書に当たってみ" +"てください。" #: ../source/guides/writing-pyproject-toml.rst:25 msgid "" @@ -10049,6 +10088,12 @@ msgid "" "latter is understood by *most* build backends, but some build backends use a " "different format." msgstr "" +"``[build-system]`` と ``[project]`` " +"の二つのテーブルの間には、大きな差異があります。どんなビルドバックエンドを使" +"うのかに関わりなく前者は常に存在していなければなりません " +"(というのも、どのツールを使うのかをこのテーブルで定義するからです)。後者は、 " +"*ほとんどの* ビルドバックエンドが理解しますが、一部のバックエンドは異なったフ" +"ォーマットのものを用います。" #: ../source/guides/writing-pyproject-toml.rst:31 msgid "" @@ -10056,6 +10101,9 @@ msgid "" "backend that does not use the ``[project]`` table (it uses the ``[tool." "poetry]`` table instead)." msgstr "" +"これを書いている時点 (2023年11月) では、 ``[project]`` " +"テーブルを使わないビルドバックエンドとしては、 Poetry_ が有名です (代わりに " +"``[tool.poetry]`` テーブルを使います) 。" #: ../source/guides/writing-pyproject-toml.rst:35 msgid "" @@ -10066,11 +10114,17 @@ msgid "" "but the ``setup.cfg`` and ``setup.py`` formats are still valid. See :ref:" "`setup-py-deprecated`." msgstr "" +"また、setuptools_ のビルドバックエンドは、 ``[project]`` テーブルと ``setup." +"cfg`` ないし ``setup.py`` の中のより古い形の両方をサポートしています。" +"新しく始めるプロジェクトでは ``[project]`` テーブルを使用し、 (C " +"言語拡張をビルドする場合のような) " +"何かプログラム面での設定が必要とされる場合に限って ``setup.py`` " +"を使い続けることが推奨されていますが、依然として ``setup.cfg`` と ``setup." +"py`` の形式は正当なものです。 :ref:`setup-py-deprecated` をご覧ください。" #: ../source/guides/writing-pyproject-toml.rst:45 -#, fuzzy msgid "Declaring the build backend" -msgstr "ビルドシステムの依存関係を宣言する" +msgstr "ビルドバックエンドを宣言する" #: ../source/guides/writing-pyproject-toml.rst:47 msgid "" @@ -10081,6 +10135,12 @@ msgid "" "dependencies. You can also constrain the versions, e.g., ``requires = " "[\"setuptools >= 61.0\"]``." msgstr "" +"``[build-system]`` テーブルは、使用されるべきビルドバックエンドを指定する " +"``build-backend`` キーを含んでいます。また、 " +"プロジェクトをビルドするのに必要な依存関係のリストである ``requires`` " +"キーも含んでいます -- これは典型的にはビルドバクエンドのパッケージだけですが" +"、追加の依存関係を含んでいてもかまいません。さらに、例えば ``requires = [" +"\"setuptools >= 61.0\"]`` のようにバージョンを制限することもできます。" #: ../source/guides/writing-pyproject-toml.rst:53 msgid "" @@ -10088,15 +10148,17 @@ msgid "" "(after :ref:`choosing your build backend `). Here " "are the values for some common build backends:" msgstr "" +"通常は、ビルドバックエンドの説明文書が (:ref:`ビルドバックエンドを選択する " +"`) 示唆するものをコピーするだけでしょう。よく知られた" +"バックエンドでの値をいくつか挙げておきます:" #: ../source/guides/writing-pyproject-toml.rst:92 msgid "Static vs. dynamic metadata" -msgstr "" +msgstr "静的なメタデータと動的なメタデータ" #: ../source/guides/writing-pyproject-toml.rst:94 -#, fuzzy msgid "The rest of this guide is devoted to the ``[project]`` table." -msgstr "``[project]`` テーブルで許容されるキーの完全なリストは次のとおりです:" +msgstr "このガイド文書の残りの部分は、``[project]`` テーブルに捧げます。" #: ../source/guides/writing-pyproject-toml.rst:96 msgid "" @@ -10104,6 +10166,9 @@ msgid "" "field. For example: ``requires-python = \">= 3.8\"``, or ``version = " "\"1.0\"``." msgstr "" +"ほとんどの場合、 ``[project]`` " +"フィールドに直接に値を書き込むことになるでしょう。例えば: ``requires-python " +"= \">= 3.8\"`` や ``version = \"1.0\"`` などです。" #: ../source/guides/writing-pyproject-toml.rst:100 msgid "" @@ -10112,16 +10177,24 @@ msgid "" "a ``__version__`` attribute in your code, a Git tag, or similar. In such " "cases, you should mark the field as dynamic using, e.g.," msgstr "" +"しかしながら、ビルドバックエンドにメタデータを計算させる方が役に立つ場合もあ" +"ります。例えば: 多くのビルドバックエンドがソースコードや Git " +"タグやその他似たようなものの中にある ``__version__`` 要素を読み取ることができ" +"ます。そのような場合には、以下の例のような方法を使ってそのフィールドを動的な" +"ものにしておくべきです、" #: ../source/guides/writing-pyproject-toml.rst:111 msgid "" "When a field is dynamic, it is the build backend's responsibility to fill " "it. Consult your build backend's documentation to learn how it does it." msgstr "" +"フィールドが動的となっている場合、そこを埋めるのはビルドバックエンドの責任で" +"す。どうすれば良いのかについては、ビルドバックエンドの説明文書に当たってみて" +"ください。" #: ../source/guides/writing-pyproject-toml.rst:117 msgid "Basic information" -msgstr "" +msgstr "基本的な情報" #: ../source/guides/writing-pyproject-toml.rst:122 #: ../source/specifications/pyproject-toml.rst:120 @@ -10134,29 +10207,20 @@ msgstr "``名称``" msgid "" "Put the name of your project on PyPI. This field is required and is the only " "field that cannot be marked as dynamic." -msgstr "" +msgstr "PyPI 上でのプロジェクト名称を書いてください。このフィールドは必須のもので、動" +"的であるとマークできない唯一のフィールドです。" #: ../source/guides/writing-pyproject-toml.rst:132 -#, fuzzy -#| msgid "" -#| "Consist only of ASCII letters, digits, underscores (``_``), hyphens (``-" -#| "``), and/or periods (``.``), and" msgid "" "The project name must consists of ASCII letters, digits, underscores " "\"``_``\", hyphens \"``-``\" and periods \"``.``\". It must not start or end " "with an underscore, hyphen or period." msgstr "" -"ASCII文字・数字・アンダースコア(``_``)・ハイフン(``-``)・ピリオド(``.``)だけ" -"を含むこと、かつ、" +"プロジェクトの名称は、ASCII文字・数字・アンダースコア \"``_``\"・ハイフン \"" +"``-``\"・ピリオド \"``.``\" だけでできていなければなりません。また、アンダー" +"スコア・ハイフン・ピリオドで始まってはなりません。" #: ../source/guides/writing-pyproject-toml.rst:136 -#, fuzzy -#| msgid "" -#| "Comparison of project names is case insensitive and treats arbitrarily-" -#| "long runs of underscores, hyphens, and/or periods as equal. For example, " -#| "if you register a project named ``cool-stuff``, users will be able to " -#| "download it or declare a dependency on it using any of the following " -#| "spellings::" msgid "" "Comparison of project names is case insensitive and treats arbitrarily long " "runs of underscores, hyphens, and/or periods as equal. For example, if you " @@ -10167,8 +10231,9 @@ msgstr "" "プロジェクト名の比較では、大文字小文字を区別せず、また、アンダースコア・ハイ" "フン・ピリオドは何文字連続していても同じものとして扱います。例えば、あなたが " "``cool-stuff`` という名前のプロジェクトを登録したなら、利用者がダウンロードし" -"たり依存関係を宣言したりするのに、次に挙げる綴りのどれでも使うことができま" -"す::" +"たり依存関係を宣言したりするのに、次に挙げる綴りのいずれであっても使うことが" +"できます: ``Cool-Stuff`` ・ ``cool.stuff`` ・ ``COOL_STUFF`` ・ " +"``CoOl__-.-__sTuFF`` 。" #: ../source/guides/writing-pyproject-toml.rst:144 #: ../source/specifications/pyproject-toml.rst:125 @@ -10178,9 +10243,8 @@ msgid "``version``" msgstr "" #: ../source/guides/writing-pyproject-toml.rst:146 -#, fuzzy msgid "Put the version of your project." -msgstr "プロジェクトに関するキーワード。" +msgstr "プロジェクトのバージョンを書いてください。" #: ../source/guides/writing-pyproject-toml.rst:153 msgid "" @@ -10188,10 +10252,14 @@ msgid "" "release) are possible; see the :ref:`specification ` for " "full details." msgstr "" +"(アルファ版のリリース用の) ``2020.0.0a1`` " +"のようなもっと込み入ったバージョン指定子も可能ですので、 詳細については " +":ref:`仕様 ` を見てください。" #: ../source/guides/writing-pyproject-toml.rst:157 msgid "This field is required, although it is often marked as dynamic using" -msgstr "" +msgstr "動的であるとマークされることがしばしばではありますが、このフィールドは必須の" +"ものです" #: ../source/guides/writing-pyproject-toml.rst:164 msgid "" @@ -10199,11 +10267,14 @@ msgid "" "attribute or a Git tag. Consult :ref:`Single sourcing the version` for more " "details." msgstr "" +"これによって、 ``__version__`` 要素や Git " +"のタグからバージョンを取得するような使い方が可能になります。 :ref:`" +"バージョンを１箇所で管理する ` " +"を見てみてください。" #: ../source/guides/writing-pyproject-toml.rst:170 -#, fuzzy msgid "Dependencies and requirements" -msgstr "requirements ファイルを使う" +msgstr "依存関係と要求事項" #: ../source/guides/writing-pyproject-toml.rst:173 #: ../source/specifications/pyproject-toml.rst:354 @@ -10212,7 +10283,7 @@ msgstr "``dependencies``/``optional-dependencies``" #: ../source/guides/writing-pyproject-toml.rst:175 msgid "If your project has dependencies, list them like this:" -msgstr "" +msgstr "もしプロジェクトに依存関係があるなら、このように列挙してください:" #: ../source/guides/writing-pyproject-toml.rst:187 msgid "" @@ -10985,7 +11056,7 @@ msgstr "" "データをもっともらしく読み込もうと試みます。" #: ../source/key_projects.rst:184 -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "pip" msgstr "pip" @@ -13702,7 +13773,7 @@ msgstr "" "アンパックすればインストールできます。" #: ../source/specifications/binary-distribution-format.rst:22 -#: ../source/specifications/platform-compatibility-tags.rst:46 +#: ../source/specifications/platform-compatibility-tags.rst:39 msgid "Details" msgstr "詳細" @@ -13952,7 +14023,7 @@ msgid "E.g. 'py27', 'py2', 'py3'." msgstr "例えば、 'py27' ・ 'py2' ・ 'py3' 。" #: ../source/specifications/binary-distribution-format.rst:128 -#: ../source/specifications/platform-compatibility-tags.rst:27 +#: ../source/specifications/platform-compatibility-tags.rst:20 msgid "abi tag" msgstr "abi タグ" @@ -13961,7 +14032,7 @@ msgid "E.g. 'cp33m', 'abi3', 'none'." msgstr "例えば、 'cp33m' ・ 'abi3' ・ 'none' 。" #: ../source/specifications/binary-distribution-format.rst:131 -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "platform tag" msgstr "プラットフォームタグ" @@ -14211,7 +14282,7 @@ msgstr "" "します。" #: ../source/specifications/binary-distribution-format.rst:226 -#: ../source/specifications/recording-installed-packages.rst:39 +#: ../source/specifications/recording-installed-packages.rst:23 msgid "The .dist-info directory" msgstr ".dist-info ディレクトリ" @@ -14409,7 +14480,7 @@ msgstr "" "https://datatracker.ietf.org/doc/html/draft-jones-jose-json-private-key-01" #: ../source/specifications/binary-distribution-format.rst:314 -#: ../source/specifications/platform-compatibility-tags.rst:244 +#: ../source/specifications/platform-compatibility-tags.rst:237 msgid "FAQ" msgstr "FAQ" @@ -14614,44 +14685,44 @@ msgstr "" "状態で再現するように要求されるであろうということを認識しておいてください。" #: ../source/specifications/binary-distribution-format.rst:419 -#: ../source/specifications/direct-url-data-structure.rst:266 -#: ../source/specifications/direct-url.rst:66 +#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/dependency-specifiers.rst:476 +#: ../source/specifications/direct-url-data-structure.rst:267 +#: ../source/specifications/direct-url.rst:67 +#: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 #: ../source/specifications/inline-script-metadata.rst:239 #: ../source/specifications/name-normalization.rst:42 +#: ../source/specifications/platform-compatibility-tags.rst:301 #: ../source/specifications/pyproject-toml.rst:442 +#: ../source/specifications/recording-installed-packages.rst:252 #: ../source/specifications/source-distribution-format.rst:144 #: ../source/specifications/version-specifiers.rst:1262 +#: ../source/specifications/virtual-environments.rst:54 msgid "History" msgstr "歴史" #: ../source/specifications/binary-distribution-format.rst:421 -msgid "This specification was originally approved as :pep:`427`." +msgid "February 2013: This specification was approved through :pep:`427`." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:423 +#: ../source/specifications/binary-distribution-format.rst:422 #, fuzzy #| msgid "" -#| "The following changes were made based on feedback after its initial " -#| "implementation:" -msgid "The following changes were applied since the initial version:" -msgstr "" -"以降の変更は、最初の実装 (ができた) 後に寄せられたフィードバックに基づくもの" -"です:" - -#: ../source/specifications/binary-distribution-format.rst:425 +#| "The rules on escaping in wheel filenames were revised, to bring them into " +#| "line with what popular tools actually do (February 2021)." msgid "" -"The rules on escaping in wheel filenames were revised, to bring them into " -"line with what popular tools actually do (February 2021)." +"February 2021: The rules on escaping in wheel filenames were revised, to " +"bring them into line with what popular tools actually do." msgstr "" "他の普及しているツールが実際にやるのと同じやり方に合わせて、 wheel のファイル" "名におけるエスケーピングの規則が修正されました。" -#: ../source/specifications/binary-distribution-format.rst:430 +#: ../source/specifications/binary-distribution-format.rst:427 msgid "Appendix" msgstr "補遺" -#: ../source/specifications/binary-distribution-format.rst:432 +#: ../source/specifications/binary-distribution-format.rst:429 msgid "Example urlsafe-base64-nopad implementation::" msgstr "urlsafe-base64-nopad の実装の例::" @@ -15838,11 +15909,59 @@ msgstr "" "しょう。 Torqued Python をインストールするなら、 Gorgon パッケージは削除され" "るべきです。" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:854 +msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:855 +msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" +msgstr "" + +#: ../source/specifications/core-metadata.rst:856 +msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:857 +msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:859 +#, fuzzy +#| msgid "" +#| "Added documentation for the ``Description-Content-Type`` field. (:pr:" +#| "`258`)" +msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." +msgstr "``Description-Content-Type`` 欄について説明を追加した。 (:pr:`258`)" + +#: ../source/specifications/core-metadata.rst:860 +msgid "Added canonical method for transforming metadata to JSON." +msgstr "" + +#: ../source/specifications/core-metadata.rst:861 +msgid "Restricted the grammar of the ``Name`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:863 +msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:865 +msgid "Added the ``Dynamic`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:867 +msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:869 +msgid "Restricted extra names to be normalized." +msgstr "" + +#: ../source/specifications/core-metadata.rst:873 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "reStructuredText マークアップ言語: https://docutils.sourceforge.io/" -#: ../source/specifications/core-metadata.rst:858 +#: ../source/specifications/core-metadata.rst:878 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "RFC 822 長形式ヘッダフィールド: :rfc:`822#section-3.1.1`" @@ -16419,31 +16538,29 @@ msgstr "完全な parsley 文法::" msgid "A test program - if the grammar is in a string ``grammar``:" msgstr "テストプログラム - もし ``grammar`` 文字列内に文法があれば::" -#: ../source/specifications/dependency-specifiers.rst:476 -msgid "Summary of changes to PEP 508" -msgstr "PEP 508 に対する変更の要旨" - #: ../source/specifications/dependency-specifiers.rst:478 -msgid "" -"The following changes were made based on feedback after its initial " -"implementation:" +msgid "November 2015: This specification was approved through :pep:`508`." msgstr "" -"以降の変更は、最初の実装 (ができた) 後に寄せられたフィードバックに基づくもの" -"です:" -#: ../source/specifications/dependency-specifiers.rst:481 +#: ../source/specifications/dependency-specifiers.rst:479 +#, fuzzy +#| msgid "" +#| "The definition of ``python_version`` was changed from ``platform." +#| "python_version()[:3]`` to ``'.'.join(platform.python_version_tuple()" +#| "[:2])``, to accommodate potential future versions of Python with 2-digit " +#| "major and minor versions (e.g. 3.10). [#future_versions]_" msgid "" -"The definition of ``python_version`` was changed from ``platform." -"python_version()[:3]`` to ``'.'.join(platform.python_version_tuple()[:2])``, " -"to accommodate potential future versions of Python with 2-digit major and " -"minor versions (e.g. 3.10). [#future_versions]_" +"July 2019: The definition of ``python_version`` was `changed `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" "``python_version`` の定義は、 Python の将来のバージョンが二桁のメジャーバー" "ジョンやマイナーバージョンを持つ場合 (例えば 3.10) でもそれを収容できるよう" "に、 ``platform.python_version()[:3]`` から ``'.'.join(platform." "python_version_tuple()[:2])`` へと変更されました。 [#future_versions]_" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" @@ -16451,11 +16568,11 @@ msgstr "" "Python のパッケージをインストールする際に推奨されるツールである pip (http://" "pip.readthedocs.org/en/stable/)" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "parsley PEG ライブラリ。 (https://pypi.python.org/pypi/parsley/)" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -16492,7 +16609,7 @@ msgstr "" "dist-info` ディレクトリに生成されなければなりません。" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -16597,13 +16714,9 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" -"2020年3月: ``direct_url.json`` メタデータファイルは、当初は :pep:`610` で仕様" -"を指定されていましたが、ここで正式に文書化されました。" #: ../source/specifications/direct-url-data-structure.rst:7 msgid "Direct URL Data Structure" @@ -17051,23 +17164,23 @@ msgstr "ローカルディレクトリ:" msgid "Local directory in editable mode:" msgstr "編集可能モード状態にあるローカルディレクトリ:" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -"2020年3月: このデータ構造は、当初は :pep:`610` で ``direct_url.json`` メタ" -"データファイルの一部として仕様を指定されていましたが、ここで正式に文書化され" -"ました。" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 +#, fuzzy +#| msgid "" +#| "January 2023: Added the ``archive_info.hashes`` key (`discussion `__)." msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" -"2023年1月: ``archive_info.hashes`` キーを追加しました ([議論] (https://" -"discuss.python.org/t/22299)) 。" +"2023年1月: ``archive_info.hashes`` キーを追加しました (`議論 `__) 。" #: ../source/specifications/entry-points.rst:5 msgid "Entry points specification" @@ -17372,6 +17485,12 @@ msgstr "" "の違いしかないような名前を使うことを避けるべきです。名前が大文字小文字しか違" "わない場合のインストールツールの挙動は未定義です。" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "外部から管理される環境" @@ -17996,7 +18115,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -18221,7 +18340,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -18303,23 +18424,15 @@ msgstr "``FrIeNdLy-._.-bArD`` (ひどい書き方の名前の例だが、正当 #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -"`2015年9月 `_: 正規化された名称は、元々は :pep:`503#normalized-" -"names` で仕様化されていました。" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" -"`2015年11月 `_: 正当であるが正規化されてはいない名称は、元々は :pep:" -"`508#names` で仕様化されていました。" #: ../source/specifications/platform-compatibility-tags.rst:6 msgid "Platform compatibility tags" @@ -18335,51 +18448,27 @@ msgstr "" "ツールが配布物に印を付けることができるようにし、インストーラが自身が動作して" "いるシステムと互換であるのはどの配布物であるかを理解できるようにします。" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "この仕様に貢献する PEP 群を以下に示す:" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr ":pep:`425`" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr ":pep:`513`" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr ":pep:`571`" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr ":pep:`599`" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr ":pep:`600`" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "タグの書式は、 ``{python tag}-{abi tag}-{platform tag}`` です。" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "python タグ" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "'py27' ・ 'cp33'" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "'cp33dmu' ・ 'none'" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "'linux_x86_64' ・ 'any'" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." @@ -18388,12 +18477,12 @@ msgstr "" "フォームで Python 2.7 (任意の Python 2.7 実装) との互換性を持つことを意味しま" "す。" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "使い方" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" @@ -18404,17 +18493,17 @@ msgstr "" "{platform tag}.whl`` の形で包含しています。他のパッケージフォーマットにはそれ" "ぞれ独自の慣習があるかもしれません。" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" "どのようなタグであれ、その中に潜在的に含まれる空白文字は ``_`` で置換されるべ" "きです。" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "Python タグ" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" @@ -18422,31 +18511,31 @@ msgstr "" "Python タグは、配布物が必要とする実装やバージョンを示します。主要な実装には短" "縮系のコードがあって、当初は:" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "py: 一般的な Python (実装に特有な機能を要求しません)" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "cp: CPython" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "ip: IronPython" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "pp: PyPy" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "jy: Jython" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "ほかの Python 実装には ``sys.implementation.name`` を用いるべきです。" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " @@ -18457,7 +18546,7 @@ msgstr "" "おそらく、ここに ``pp18`` や ``pp19`` といったそれ自身のバージョンを使いま" "す。" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." @@ -18465,7 +18554,7 @@ msgstr "" "多くの純 Python 配布物では、バージョンは ``2`` や ``3`` や ``py2`` ・ " "``py3`` といったメジャーバージョンだけにしておくことができます。" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " @@ -18476,7 +18565,7 @@ msgstr "" "て、これらのタグは、パッケージ作成者がいくつものバージョンに互換性を持つ配布" "物を意図的にリリースしたのです。" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." @@ -18485,11 +18574,11 @@ msgstr "" "ことができます。 後述の `タグの圧縮された組み合わせ `_ " "を参照してください。" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "ABI タグ" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -18501,13 +18590,13 @@ msgstr "" "ば ``cp33d`` がデバッグオプション付きの CPython 3.3 ABI のことを指すように、 " "Python タグと同様のやり方で短縮したものを使います。" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" "CPython の安定版 ABI のことは、共有ライブラリの拡張子と同様に ``abi3`` と書き" "ます。" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -18521,11 +18610,11 @@ msgstr "" "きな需要はないでしょう。それぞれの実装のコミュニティで ABI タグをどのように用" "いるのが最適かを決定すればよいでしょう。" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "プラットフォームタグ" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" @@ -18536,23 +18625,23 @@ msgstr "" "`distutils` が Python 3.12 で削除されるまでは、これは ``distutils.util." "get_platform()`` でした。" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "win32" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "linux_i386" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "linux_x86_64" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "``manylinux``" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " @@ -18563,7 +18652,7 @@ msgstr "" "けの wheel ファイル (および、一般に \\*nix 向けの wheel ファイル) の公開配布" "物としては不十分です。" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -18575,7 +18664,7 @@ msgstr "" "る ``manylinux`` プラットフォームタグ付きの wheel をビルドできるようにしてい" "ます。" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" @@ -18583,7 +18672,7 @@ msgstr "" "``manylinux`` 仕様は複数回の改訂があり、それぞれの版がその時々の Linux の共通" "のサブセットを表現しています:" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." @@ -18592,7 +18681,7 @@ msgstr "" "サポートしていて、 2007 年から互換性のある Linux プラットフォームに基づいてい" "ます。" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " @@ -18602,7 +18691,7 @@ msgstr "" "をサポートしており、以前の仕様を更新して、その代わりに 2010 年から互換性のあ" "る Linux プラットフォームに基づいています。" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -18613,7 +18702,7 @@ msgstr "" "``armv7l``, ``ppc64``, ``ppc64le``, and ``s390x``) へのサポートを追加し、ま" "た、2014 年以降の互換 Linux プラットフォームのベースを更新しました。" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -18627,7 +18716,7 @@ msgstr "" "の上で動作するはずです) 。以前に使われたタグは広報互換性を保つために依然とし" "てサポートされています。" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -18641,7 +18730,7 @@ msgstr "" "物が 2010 年よりも前に存在していたプラットフォームで動作するとは想定されてい" "ないということです) 。" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -18653,11 +18742,11 @@ msgstr "" "ろうという警告されていることもあって、パッケージ保守者は最も互換性のある仕様" "をターゲットにするように努力するべきです。" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "Manylinux 互換性サポート" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." @@ -18665,7 +18754,7 @@ msgstr "" "``manylinux2014`` 仕様は相対的に新しく、未だインストールツールに広く認識され" "たと言える状況ではありません。" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." @@ -18673,7 +18762,7 @@ msgstr "" "``manylinux_x_y`` 仕様は相対的に新しく、未だインストールツールに広く認識され" "たと言える状況ではありません。" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" @@ -18681,68 +18770,68 @@ msgstr "" "適切なプロジェクトがサポートするさまざまな ``manylinux`` 標準の最低限のバー" "ジョンを次に掲げる表に示します:" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "ツール" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "``manylinux1``" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "``manylinux2010``" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "``manylinux2014``" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "``manylinux_x_y``" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "``>=8.1.0``" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "``>=19.0``" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "``>=19.3``" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "``>=20.3``" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "auditwheel" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "``>=1.0.0``" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "``>=2.0.0``" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "``>=3.0.0``" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "``>=3.3.0`` [#]_" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" "audit wheel 3.3.0 では ``manylinux_2_24`` へのサポートだけが追加されました" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -18755,7 +18844,7 @@ msgstr "" "ています。ビルド済配布物のタグがリストに含まれて (``in`` ) いれば、それをイン" "ストールすることができます。" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -18773,7 +18862,7 @@ msgstr "" "は、純 Python であると広報しているビルド済みパッケージだけをダウンロードする" "ために、 ``*-none-any`` タグだけを受容しても構いません。" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " @@ -18783,7 +18872,7 @@ msgstr "" "好ましいという点で、インストーラに望まれるもうひとつの機能は \"可能ならソース" "コードから再コンパイルする\" でしょう。" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -18797,63 +18886,63 @@ msgstr "" "の (古いバージョンの Python でビルドされた純 Python の配布物) へ、という順序" "で並んでいます:" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "cp33-cp33m-linux_x86_64" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "cp33-abi3-linux_x86_64" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "cp3-abi3-linux_x86_64" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "cp33-none-linux_x86_64*" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "cp3-none-linux_x86_64*" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "py33-none-linux_x86_64*" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "py3-none-linux_x86_64*" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "cp33-none-any" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "cp3-none-any" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "py33-none-any" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "py3-none-any" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "py32-none-any" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "py31-none-any" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "py30-none-any" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." @@ -18862,7 +18951,7 @@ msgstr "" "を含んでいるなどのようなC 言語拡張以外の理由によって、特定のプラットフォーム" "向けであっても構いません。" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -18881,11 +18970,11 @@ msgstr "" "よりも選好されてインストールされるという形で、インデックスによってどちらかに" "決めることができます。" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "圧縮されたタグのセット" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -18902,7 +18991,7 @@ msgstr "" "うタグを付けた bdist として配布することができるでしょう。単純なタグの完全なリ" "ストは::" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -18915,11 +19004,11 @@ msgstr "" "ポートされていない \"不可能な\" タグを大量に生成すると思われるので、控えめに" "使うようにしてください。" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "デフォルトではどんなタグが使われますか？" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -18932,7 +19021,7 @@ msgstr "" "ば、それは彼らが異なる Python 間での互換性を提供しようという意図があったこと" "を示しています。" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" @@ -18940,7 +19029,7 @@ msgstr "" "自分の配布物が最新版の Python と相容れない機能を使っているとしたら、どんなタ" "グを使いますか？" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -18958,11 +19047,11 @@ msgstr "" "は、新しい機能を使う前のリリースである ``beaglevote-1.1.0`` 用の要求 " "(requirement) などを他の指定子を組み合わせなければなりません。" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "Python のバージョン番号に ``.`` がないのはなぜですか?" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " @@ -18973,13 +19062,13 @@ msgstr "" "区切る役割を果たしているので、他の実装では _ を区切り子として使っても構いませ" "ん。" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" "ハイフンやその他の英数字以外の文字をアンダースコアに正規化するのはなぜですか?" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -18991,11 +19080,11 @@ msgstr "" "るファイルシステムのファイル名に対する制限事項との間のより良い互換性のため" "に。" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "何故、 ``.`` や ``-`` の代わりに特殊な文字 を使わないのですか？" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -19012,11 +19101,11 @@ msgstr "" "うようにすること) を正当化するに足りるだけのアドバンテージがないから、のいず" "れかです。" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "誰が実装に関する短縮形のレジストリの維持管理をしているのですか？" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " @@ -19026,11 +19115,11 @@ msgstr "" "けることができるでしょう。経験上は、その時点で最も卓越した４個の実装のために" "省略形が予約されています。" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "互換性タグは METADATA に含まれるのか、あるいは PKG-INFO か？" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " @@ -19040,11 +19129,11 @@ msgstr "" "は、その配布物の単一のビルドではなく配布物の全体にとって正当なものであるべき" "です。" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "どうして私のお気に入りの Python 実装について言及しなかったの？" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -19056,14 +19145,14 @@ msgstr "" "が、しかしもっと長いタグになってしまうことでしょう。すべての \"純 Python\" な" "ビルド済み配布物が単に ``py`` を使うだけであることを思い出してください。" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" "どうして参照実装における ABI タグ (第２のタグ) は時々 \"none\" なのですか？" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -19077,6 +19166,30 @@ msgstr "" "が、それまでの間は \"知られていない\" ことを示すのに \"none\" とすることが必" "要十分な方法なのです。" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr ":file:`.pypirc` ファイル" @@ -19937,8 +20050,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -19973,40 +20093,8 @@ msgstr "" "は提供できない場合でさえも、インストール済みのプロジェクトの名前とバージョン" "を記録するべきです。" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "ワークフローの履歴と変更" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" -"ここで述べるメタデータは、 :pep:`376` で初めて定義されたもので、後に :pep:" -"`627` (およびその他の PEP 群) で改訂されました。以前は *インストール済みの " -"Python 配布物のデータベース* という名前で知られていました。他の PyPA 仕様と同" -"様に、 GitHab の Pull リクエストのワークフローを通じて、機能の面に影響しない" -"編集上の改訂を行うことが可能です。パッケージの作成やインストールツールを修正" -"するであろう機能面での変更提案は、 PEP のプロセス (:pep:`1` を見てください) " -"を通じて行わなければなりません。" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" -"この説明文書が規範的な仕様書である一方で、その変更を導入するような PEP 群は、" -"理論的根拠や後方互換性を保つための考慮点のような追加的な情報を含んでいても構" -"いません。" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." @@ -20015,7 +20103,7 @@ msgstr "" "ト可能なモジュールやパッケージの隣に位置する \"``.dist-info``\" ディレクトリ" "もインストールします (通常は ``site-packages`` ディレクトリ) 。" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 #, fuzzy msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " @@ -20036,7 +20124,7 @@ msgstr "" "ひとつだけのダッシュ (``-``) 文字をそのファイル名基幹部に持ち、それによって " "``name`` と ``version`` フィールドを分割していなければなりません。" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -20055,7 +20143,7 @@ msgstr "" "と ``version`` の両方のフィールドを上記の規則に従って正規化しなければならず、" "既存のツールもこれらのフィールドの正規化を始めることが推奨されています。" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -20075,7 +20163,7 @@ msgstr "" "イブラリは、配布物の情報を表示する時にツールが正規化されていない名前にアクセ" "スできるように、そのようなツール群が利用できるような API を提供するべきです。" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" @@ -20083,31 +20171,31 @@ msgstr "" "この ``.dist-info`` ディレクトリには、以下に詳細を述べるこれらのファイルを置" "くことができます:" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "``METADATA``: プロジェクトのメタデータを含みます" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "``RECORD``: インストールされるファイルを列挙して記録します。" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" "``INSTALLER``: プロジェクトをインストールするのに使われるツールの名前を記録し" "ます。" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" "``entry_points.txt``: 詳細については :ref:`entry-points` を見てください" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "``direct_url.json``: 詳細については :ref:`direct-url` を見てください" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " @@ -20117,7 +20205,7 @@ msgstr "" "ルの最良で省略可能です。インストーラ独自のファイルが他に存在しても構いませ" "ん。" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -20129,7 +20217,7 @@ msgstr "" "ようなファイルをインストールされたプロジェクトの ``.dist-info`` ディレクトリ" "にコピーしても構いません。" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -20141,11 +20229,11 @@ msgstr "" "標準化されるかもしれません。その元々の意味するところについては、 `PEP 376 " "`_ を見てください。" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "METADATA ファイル" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." @@ -20153,7 +20241,7 @@ msgstr "" "``METADATA`` ファイルには、 :ref:`コアとなるメタデータ ` 仕様" "のバージョン 1.1 またはそれ以降で記述されているようなメタデータを含みます。" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " @@ -20163,11 +20251,11 @@ msgstr "" "合や、必須のコアとなるメタデータが入手できない場合には、インストーラはエラー" "を発生させてプロジェクトのインストールを失敗させなければなりません。" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "RECORD ファイル" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." @@ -20175,7 +20263,7 @@ msgstr "" "``RECORD`` ファイルには、インストールされたファイル群を列挙します。CSV ファイ" "ルで、インストールされたファイルを１行に一つずつ書き込みます。" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" @@ -20183,19 +20271,19 @@ msgstr "" "CSV の亜種としては、 Python の ``csv`` モジュールの ``reader`` で読めるもので" "なければなりません:" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "フィールド区切り文字: ``,`` (コンマ)、" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "引用符: ``\"`` (ストレートダブルクォート)、" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "行末文字: ``\\r\\n`` か ``\\n`` のいずれか一方。" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." @@ -20203,7 +20291,7 @@ msgstr "" "各レコードは３個の要素から構成されます: ファイルの **パス** 、内容の **ハッ" "シュ値** 、そして、その **サイズ** です。" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -20215,7 +20303,7 @@ msgstr "" "Windows では、ディレクトリはスラッシュで区切ってもバックスラッシュで区切って" "も構いません (``/`` または ``\\``) 。" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -20228,7 +20316,7 @@ msgstr "" "urlsafe_b64encode(digest)`` の結果から末尾の ``=`` を取り除いたもの) で記した" "ものです。" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." @@ -20236,7 +20324,7 @@ msgstr "" "*size* は、空文字列か、または、ファイルサイズを 10 進数のバイト数で書いたもの" "です。" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -20250,7 +20338,7 @@ msgstr "" "なっています。その他のファイルについては、インストールされたプロジェクトに関" "する完全性を検証するために情報を与えておくことが推奨されています。" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -20265,7 +20353,7 @@ msgstr "" "ル自身を含む) については、書いておかなければなりません。ディレクトリについて" "は記入してはなりません。" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " @@ -20276,11 +20364,11 @@ msgstr "" "``.pyc`` ファイルと、アンインストールによって空になったすべてのディレクトリを" "削除する必要があります。" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "ありうる ``RECORD`` ファイルの一部を切り出した例をここに掲げます::" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -20292,7 +20380,7 @@ msgstr "" "トロにおけるシステムのパッケージ管理機構のような、それ以外の情報源に依存する" "ツールには適用されません。)" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -20302,11 +20390,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "INSTALLER ファイル" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -20318,16 +20406,16 @@ msgstr "" "動されるなら、 ``INSTALLER`` はそのコマンドの名前を含んでいるべきです。そうで" "なければ印刷可能な ASCII 文字を含んでいるべきです。" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" "ファイルは、0個またはそれ以上の ASCII 空白文字で終端することができます。" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "``INSTALLER`` ファイルについて、二つの可能な例を示します::" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -20339,11 +20427,11 @@ msgstr "" "場合には、そのツールは ``INSTALLER`` ファイルに書いてある (別の) ツールを使え" "ばアンインストールができるかもしれないと示唆しても構いません。" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "entry_points.txt ファイル" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -20355,15 +20443,15 @@ msgstr "" "りすることを意図したコンポーネントを当該パッケージが含んでいる場合には、イン" "ストーラがその由を表示するためにこのファイルを作っても構いません。" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "その詳細な仕様は :ref:`entry-points` にあります。" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "direct_url.json ファイル" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." @@ -20371,15 +20459,15 @@ msgstr "" "このファイルは、要求事項が指定するダイレクト URL (VCS の URL を含む) から配布" "物をインストールする際に、インストーラによって生成されなければなりません。" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "その詳細な仕様は :ref:`direct-url` にあります。" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "インストール済みのパッケージ群への変更を意図的に防ぐ" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -20393,12 +20481,12 @@ msgstr "" "いないことを、もしそんなことをしていればより広範な環境に互換性問題を引き起こ" "しかねないので、しっかりと確認することが望ましいです。" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" "これを達成するために、影響を被るツール群は次のような段階を踏むべきです:" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -20411,7 +20499,7 @@ msgstr "" "は、パッケージの内容物を他の手段で追跡・管理しているのであればファイルを完全" "に除外しておくこと) してください。" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " @@ -20422,7 +20510,7 @@ msgstr "" "るツール群が影響を被るパッケージを修正するように言われた時により良いエラー通" "知を提供できます)" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -20435,7 +20523,7 @@ msgstr "" "別の場所を使うようにすることで、プラットフォームが提供するパッケージ群を意図" "せずに修正してしまうことを防いでも構いません。" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" @@ -20446,6 +20534,26 @@ msgstr "" "ては :ref:`外部から管理される環境 ` を参照し" "てください" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "パッケージ配布物のファイルフォーマット" @@ -20831,28 +20939,36 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" -"2023-08: ソースコード配布物のアーカイブの機能について標準化 (: pep:`721`)" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" -msgstr "2022-09: ソースコード配布物のファイル名について標準化 (:pep:`625`)" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +#, fuzzy +#| msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "2021-07: ソースコードツリーとは何であるかを定義" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" -msgstr "2020-11: :pep:`643` をこの仕様に変換" +#, fuzzy +#| msgid "" +#| "September 2022: Standardized the filename of a source distribution (:pep:" +#| "`625`)" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." +msgstr "2022-09: ソースコード配布物のファイル名について標準化 (:pep:`625`)" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" -msgstr "2000-12: ソースコード配布物について :pep:`643` で標準化" +#: ../source/specifications/source-distribution-format.rst:151 +#, fuzzy +#| msgid "" +#| "August 2023: Standardized the source distribution archive features (:pep:" +#| "`721`)" +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." +msgstr "" +"2023-08: ソースコード配布物のアーカイブの機能について標準化 (: pep:`721`)" #: ../source/specifications/version-specifiers.rst:7 #: ../source/specifications/version-specifiers.rst:778 @@ -22487,10 +22603,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -22592,6 +22705,10 @@ msgstr "" "タイムにパッチを当てる ``sitecustomize.py``) であればどれでも、それと認識され" "て Python 仮想環境として振る舞います。" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "サポートを得るには" @@ -24343,6 +24460,119 @@ msgid "" "the file is empty)." msgstr "" +#, fuzzy +#~| msgid "" +#~| "The following changes were made based on feedback after its initial " +#~| "implementation:" +#~ msgid "The following changes were applied since the initial version:" +#~ msgstr "" +#~ "以降の変更は、最初の実装 (ができた) 後に寄せられたフィードバックに基づくも" +#~ "のです:" + +#~ msgid "Summary of changes to PEP 508" +#~ msgstr "PEP 508 に対する変更の要旨" + +#~ msgid "" +#~ "The following changes were made based on feedback after its initial " +#~ "implementation:" +#~ msgstr "" +#~ "以降の変更は、最初の実装 (ができた) 後に寄せられたフィードバックに基づくも" +#~ "のです:" + +#~ msgid "" +#~ "March 2020: the ``direct_url.json`` metadata file was originally " +#~ "specified in :pep:`610` and is formally documented here." +#~ msgstr "" +#~ "2020年3月: ``direct_url.json`` メタデータファイルは、当初は :pep:`610` で" +#~ "仕様を指定されていましたが、ここで正式に文書化されました。" + +#~ msgid "" +#~ "March 2020: this data structure was originally specified as part of the " +#~ "``direct_url.json`` metadata file in :pep:`610` and is formally " +#~ "documented here." +#~ msgstr "" +#~ "2020年3月: このデータ構造は、当初は :pep:`610` で ``direct_url.json`` メタ" +#~ "データファイルの一部として仕様を指定されていましたが、ここで正式に文書化さ" +#~ "れました。" + +#~ msgid "" +#~ "January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" +#~ "discuss.python.org/t/22299))." +#~ msgstr "" +#~ "2023年1月: ``archive_info.hashes`` キーを追加しました ([議論] (https://" +#~ "discuss.python.org/t/22299)) 。" + +#~ msgid "" +#~ "`September 2015 `_: normalized name was originally specified in :" +#~ "pep:`503#normalized-names`." +#~ msgstr "" +#~ "`2015年9月 `_: 正規化された名称は、元々は :pep:`503#normalized-" +#~ "names` で仕様化されていました。" + +#~ msgid "" +#~ "`November 2015 `_: valid non-normalized name was originally " +#~ "specified in :pep:`508#names`." +#~ msgstr "" +#~ "`2015年11月 `_: 正当であるが正規化されてはいない名称は、元々は :" +#~ "pep:`508#names` で仕様化されていました。" + +#~ msgid "The following PEPs contributed to this spec:" +#~ msgstr "この仕様に貢献する PEP 群を以下に示す:" + +#~ msgid ":pep:`425`" +#~ msgstr ":pep:`425`" + +#~ msgid ":pep:`513`" +#~ msgstr ":pep:`513`" + +#~ msgid ":pep:`571`" +#~ msgstr ":pep:`571`" + +#~ msgid ":pep:`599`" +#~ msgstr ":pep:`599`" + +#~ msgid ":pep:`600`" +#~ msgstr ":pep:`600`" + +#~ msgid "History and change workflow" +#~ msgstr "ワークフローの履歴と変更" + +#~ msgid "" +#~ "The metadata described here was first specified in :pep:`376`, and later " +#~ "amended in :pep:`627` (and other PEPs). It was formerly known as " +#~ "*Database of Installed Python Distributions*. As with other PyPA " +#~ "specifications, editorial amendments with no functional impact may be " +#~ "made through the GitHub pull request workflow. Proposals for functional " +#~ "changes that would require amendments to package building and/or " +#~ "installation tools must be made through the PEP process (see :pep:`1`)." +#~ msgstr "" +#~ "ここで述べるメタデータは、 :pep:`376` で初めて定義されたもので、後に :pep:" +#~ "`627` (およびその他の PEP 群) で改訂されました。以前は *インストール済み" +#~ "の Python 配布物のデータベース* という名前で知られていました。他の PyPA 仕" +#~ "様と同様に、 GitHab の Pull リクエストのワークフローを通じて、機能の面に影" +#~ "響しない編集上の改訂を行うことが可能です。パッケージの作成やインストール" +#~ "ツールを修正するであろう機能面での変更提案は、 PEP のプロセス (:pep:`1` を" +#~ "見てください) を通じて行わなければなりません。" + +#~ msgid "" +#~ "While this document is the normative specification, the PEPs that " +#~ "introduce changes to it may include additional information such as " +#~ "rationales and backwards compatibility considerations." +#~ msgstr "" +#~ "この説明文書が規範的な仕様書である一方で、その変更を導入するような PEP 群" +#~ "は、理論的根拠や後方互換性を保つための考慮点のような追加的な情報を含んでい" +#~ "ても構いません。" + +#~ msgid "November 2020: :pep:`643` converted to this specification" +#~ msgstr "2020-11: :pep:`643` をこの仕様に変換" + +#~ msgid "December 2000: Source distributions standardized in :pep:`643`" +#~ msgstr "2000-12: ソースコード配布物について :pep:`643` で標準化" + #~ msgid "" #~ "This is the name of your project, determining how your project is listed " #~ "on :term:`PyPI `. Per :pep:`508`, valid " @@ -25969,13 +26199,6 @@ msgstr "" #~ msgid "Local directory installed in editable mode:" #~ msgstr "編集可能モードでインストールされたローカルディレクトリ:" -#~ msgid "" -#~ "January 2023: Added the ``archive_info.hashes`` key (`discussion `__)." -#~ msgstr "" -#~ "2023年1月: ``archive_info.hashes`` キーを追加しました (`議論 `__) 。" - #~ msgid "" #~ "The platform compatibility tagging model used for the ``wheel`` " #~ "distribution format is defined in :pep:`425`." diff --git a/locales/ko/LC_MESSAGES/messages.po b/locales/ko/LC_MESSAGES/messages.po index 12ada7a26..fdc04b6e4 100644 --- a/locales/ko/LC_MESSAGES/messages.po +++ b/locales/ko/LC_MESSAGES/messages.po @@ -4,21 +4,22 @@ # Tanat , 2022, 2023. # Dongseop , 2023. # 고종환 , 2023. +# kkumtree , 2023. msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" -"PO-Revision-Date: 2023-12-08 13:49+0000\n" -"Last-Translator: 고종환 \n" -"Language-Team: Korean \n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" +"PO-Revision-Date: 2023-12-24 16:11+0000\n" +"Last-Translator: kkumtree \n" +"Language-Team: Korean \n" "Language: ko\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=1; plural=0;\n" -"X-Generator: Weblate 5.3-dev\n" +"X-Generator: Weblate 5.4-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" @@ -563,7 +564,7 @@ msgstr "" #: ../source/discussions/deploying-python-applications.rst:11 #: ../source/specifications/externally-managed-environments.rst:130 -#: ../source/specifications/platform-compatibility-tags.rst:21 +#: ../source/specifications/platform-compatibility-tags.rst:14 msgid "Overview" msgstr "" @@ -2041,7 +2042,7 @@ msgstr "" #: ../source/glossary.rst:128 msgid "Project" -msgstr "" +msgstr "프로젝트" #: ../source/glossary.rst:131 msgid "" @@ -2782,7 +2783,7 @@ msgid "" msgstr "" #: ../source/guides/analyzing-pypi-package-downloads.rst:335 -#: ../source/specifications/dependency-specifiers.rst:489 +#: ../source/specifications/dependency-specifiers.rst:487 msgid "References" msgstr "" @@ -8336,7 +8337,7 @@ msgid "" msgstr "" #: ../source/key_projects.rst:184 -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "pip" msgstr "" @@ -10421,7 +10422,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:22 -#: ../source/specifications/platform-compatibility-tags.rst:46 +#: ../source/specifications/platform-compatibility-tags.rst:39 msgid "Details" msgstr "" @@ -10619,7 +10620,7 @@ msgid "E.g. 'py27', 'py2', 'py3'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:128 -#: ../source/specifications/platform-compatibility-tags.rst:27 +#: ../source/specifications/platform-compatibility-tags.rst:20 msgid "abi tag" msgstr "" @@ -10628,7 +10629,7 @@ msgid "E.g. 'cp33m', 'abi3', 'none'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:131 -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "platform tag" msgstr "" @@ -10810,7 +10811,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:226 -#: ../source/specifications/recording-installed-packages.rst:39 +#: ../source/specifications/recording-installed-packages.rst:23 msgid "The .dist-info directory" msgstr "" @@ -10952,7 +10953,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:314 -#: ../source/specifications/platform-compatibility-tags.rst:244 +#: ../source/specifications/platform-compatibility-tags.rst:237 msgid "FAQ" msgstr "" @@ -11089,36 +11090,38 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:419 -#: ../source/specifications/direct-url-data-structure.rst:266 -#: ../source/specifications/direct-url.rst:66 +#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/dependency-specifiers.rst:476 +#: ../source/specifications/direct-url-data-structure.rst:267 +#: ../source/specifications/direct-url.rst:67 +#: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 #: ../source/specifications/inline-script-metadata.rst:239 #: ../source/specifications/name-normalization.rst:42 +#: ../source/specifications/platform-compatibility-tags.rst:301 #: ../source/specifications/pyproject-toml.rst:442 +#: ../source/specifications/recording-installed-packages.rst:252 #: ../source/specifications/source-distribution-format.rst:144 #: ../source/specifications/version-specifiers.rst:1262 +#: ../source/specifications/virtual-environments.rst:54 msgid "History" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -msgid "This specification was originally approved as :pep:`427`." -msgstr "" - -#: ../source/specifications/binary-distribution-format.rst:423 -msgid "The following changes were applied since the initial version:" +msgid "February 2013: This specification was approved through :pep:`427`." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:425 +#: ../source/specifications/binary-distribution-format.rst:422 msgid "" -"The rules on escaping in wheel filenames were revised, to bring them into " -"line with what popular tools actually do (February 2021)." +"February 2021: The rules on escaping in wheel filenames were revised, to " +"bring them into line with what popular tools actually do." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:430 +#: ../source/specifications/binary-distribution-format.rst:427 msgid "Appendix" msgstr "" -#: ../source/specifications/binary-distribution-format.rst:432 +#: ../source/specifications/binary-distribution-format.rst:429 msgid "Example urlsafe-base64-nopad implementation::" msgstr "" @@ -12016,11 +12019,55 @@ msgid "" "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:854 +msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:855 +msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" +msgstr "" + +#: ../source/specifications/core-metadata.rst:856 +msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:857 +msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:859 +msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:860 +msgid "Added canonical method for transforming metadata to JSON." +msgstr "" + +#: ../source/specifications/core-metadata.rst:861 +msgid "Restricted the grammar of the ``Name`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:863 +msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:865 +msgid "Added the ``Dynamic`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:867 +msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:869 +msgid "Restricted extra names to be normalized." +msgstr "" + +#: ../source/specifications/core-metadata.rst:873 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:858 +#: ../source/specifications/core-metadata.rst:878 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" @@ -12473,35 +12520,29 @@ msgstr "" msgid "A test program - if the grammar is in a string ``grammar``:" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:476 -msgid "Summary of changes to PEP 508" -msgstr "" - #: ../source/specifications/dependency-specifiers.rst:478 -msgid "" -"The following changes were made based on feedback after its initial " -"implementation:" +msgid "November 2015: This specification was approved through :pep:`508`." msgstr "" -#: ../source/specifications/dependency-specifiers.rst:481 +#: ../source/specifications/dependency-specifiers.rst:479 msgid "" -"The definition of ``python_version`` was changed from ``platform." -"python_version()[:3]`` to ``'.'.join(platform.python_version_tuple()[:2])``, " -"to accommodate potential future versions of Python with 2-digit major and " -"minor versions (e.g. 3.10). [#future_versions]_" +"July 2019: The definition of ``python_version`` was `changed `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12528,7 +12569,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12612,10 +12653,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12963,17 +13002,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13175,6 +13213,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13777,7 +13821,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13996,7 +14040,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14069,16 +14115,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14092,137 +14136,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14230,11 +14250,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14243,41 +14263,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14285,26 +14305,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14312,7 +14332,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14320,7 +14340,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14329,7 +14349,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14337,89 +14357,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14427,7 +14447,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14438,14 +14458,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14454,69 +14474,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14527,11 +14547,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14541,7 +14561,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14549,11 +14569,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14561,13 +14581,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14578,23 +14598,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14602,11 +14622,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14616,33 +14636,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14650,13 +14670,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14665,6 +14685,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15328,8 +15372,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15353,36 +15404,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15394,7 +15423,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15405,7 +15434,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15417,41 +15446,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15459,7 +15488,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15467,58 +15496,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15526,7 +15555,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15534,13 +15563,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15549,7 +15578,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15558,18 +15587,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15577,7 +15606,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15587,11 +15616,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15599,15 +15628,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15615,11 +15644,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15627,29 +15656,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15658,11 +15687,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15670,14 +15699,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15686,13 +15715,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15971,26 +16020,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17599,10 +17646,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17674,6 +17718,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/lzh/LC_MESSAGES/messages.po b/locales/lzh/LC_MESSAGES/messages.po index 50f786a05..f26978143 100644 --- a/locales/lzh/LC_MESSAGES/messages.po +++ b/locales/lzh/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -513,7 +513,7 @@ msgstr "" #: ../source/discussions/deploying-python-applications.rst:11 #: ../source/specifications/externally-managed-environments.rst:130 -#: ../source/specifications/platform-compatibility-tags.rst:21 +#: ../source/specifications/platform-compatibility-tags.rst:14 msgid "Overview" msgstr "" @@ -2725,7 +2725,7 @@ msgid "" msgstr "" #: ../source/guides/analyzing-pypi-package-downloads.rst:335 -#: ../source/specifications/dependency-specifiers.rst:489 +#: ../source/specifications/dependency-specifiers.rst:487 msgid "References" msgstr "" @@ -8274,7 +8274,7 @@ msgid "" msgstr "" #: ../source/key_projects.rst:184 -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "pip" msgstr "" @@ -10359,7 +10359,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:22 -#: ../source/specifications/platform-compatibility-tags.rst:46 +#: ../source/specifications/platform-compatibility-tags.rst:39 msgid "Details" msgstr "" @@ -10557,7 +10557,7 @@ msgid "E.g. 'py27', 'py2', 'py3'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:128 -#: ../source/specifications/platform-compatibility-tags.rst:27 +#: ../source/specifications/platform-compatibility-tags.rst:20 msgid "abi tag" msgstr "" @@ -10566,7 +10566,7 @@ msgid "E.g. 'cp33m', 'abi3', 'none'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:131 -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "platform tag" msgstr "" @@ -10748,7 +10748,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:226 -#: ../source/specifications/recording-installed-packages.rst:39 +#: ../source/specifications/recording-installed-packages.rst:23 msgid "The .dist-info directory" msgstr "" @@ -10890,7 +10890,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:314 -#: ../source/specifications/platform-compatibility-tags.rst:244 +#: ../source/specifications/platform-compatibility-tags.rst:237 msgid "FAQ" msgstr "" @@ -11027,36 +11027,38 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:419 -#: ../source/specifications/direct-url-data-structure.rst:266 -#: ../source/specifications/direct-url.rst:66 +#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/dependency-specifiers.rst:476 +#: ../source/specifications/direct-url-data-structure.rst:267 +#: ../source/specifications/direct-url.rst:67 +#: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 #: ../source/specifications/inline-script-metadata.rst:239 #: ../source/specifications/name-normalization.rst:42 +#: ../source/specifications/platform-compatibility-tags.rst:301 #: ../source/specifications/pyproject-toml.rst:442 +#: ../source/specifications/recording-installed-packages.rst:252 #: ../source/specifications/source-distribution-format.rst:144 #: ../source/specifications/version-specifiers.rst:1262 +#: ../source/specifications/virtual-environments.rst:54 msgid "History" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -msgid "This specification was originally approved as :pep:`427`." -msgstr "" - -#: ../source/specifications/binary-distribution-format.rst:423 -msgid "The following changes were applied since the initial version:" +msgid "February 2013: This specification was approved through :pep:`427`." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:425 +#: ../source/specifications/binary-distribution-format.rst:422 msgid "" -"The rules on escaping in wheel filenames were revised, to bring them into " -"line with what popular tools actually do (February 2021)." +"February 2021: The rules on escaping in wheel filenames were revised, to " +"bring them into line with what popular tools actually do." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:430 +#: ../source/specifications/binary-distribution-format.rst:427 msgid "Appendix" msgstr "" -#: ../source/specifications/binary-distribution-format.rst:432 +#: ../source/specifications/binary-distribution-format.rst:429 msgid "Example urlsafe-base64-nopad implementation::" msgstr "" @@ -11954,11 +11956,55 @@ msgid "" "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:854 +msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:855 +msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" +msgstr "" + +#: ../source/specifications/core-metadata.rst:856 +msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:857 +msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:859 +msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:860 +msgid "Added canonical method for transforming metadata to JSON." +msgstr "" + +#: ../source/specifications/core-metadata.rst:861 +msgid "Restricted the grammar of the ``Name`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:863 +msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:865 +msgid "Added the ``Dynamic`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:867 +msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:869 +msgid "Restricted extra names to be normalized." +msgstr "" + +#: ../source/specifications/core-metadata.rst:873 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:858 +#: ../source/specifications/core-metadata.rst:878 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" @@ -12410,35 +12456,29 @@ msgstr "" msgid "A test program - if the grammar is in a string ``grammar``:" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:476 -msgid "Summary of changes to PEP 508" -msgstr "" - #: ../source/specifications/dependency-specifiers.rst:478 -msgid "" -"The following changes were made based on feedback after its initial " -"implementation:" +msgid "November 2015: This specification was approved through :pep:`508`." msgstr "" -#: ../source/specifications/dependency-specifiers.rst:481 +#: ../source/specifications/dependency-specifiers.rst:479 msgid "" -"The definition of ``python_version`` was changed from ``platform." -"python_version()[:3]`` to ``'.'.join(platform.python_version_tuple()[:2])``, " -"to accommodate potential future versions of Python with 2-digit major and " -"minor versions (e.g. 3.10). [#future_versions]_" +"July 2019: The definition of ``python_version`` was `changed `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12465,7 +12505,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12549,10 +12589,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12900,17 +12938,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13112,6 +13149,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13711,7 +13754,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13928,7 +13971,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14000,16 +14045,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14023,137 +14066,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14161,11 +14180,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14174,41 +14193,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14216,26 +14235,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14243,7 +14262,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14251,7 +14270,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14260,7 +14279,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14268,89 +14287,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14358,7 +14377,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14369,14 +14388,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14385,69 +14404,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14458,11 +14477,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14472,7 +14491,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14480,11 +14499,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14492,13 +14511,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14509,23 +14528,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14533,11 +14552,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14547,33 +14566,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14581,13 +14600,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14596,6 +14615,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15259,8 +15302,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15284,36 +15334,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15325,7 +15353,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15336,7 +15364,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15348,41 +15376,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15390,7 +15418,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15398,58 +15426,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15457,7 +15485,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15465,13 +15493,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15480,7 +15508,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15489,18 +15517,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15508,7 +15536,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15518,11 +15546,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15530,15 +15558,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15546,11 +15574,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15558,29 +15586,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15589,11 +15617,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15601,14 +15629,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15617,13 +15645,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15902,26 +15950,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17525,10 +17571,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17600,6 +17643,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/mk/LC_MESSAGES/messages.po b/locales/mk/LC_MESSAGES/messages.po index 1a0efbefa..286d09112 100644 --- a/locales/mk/LC_MESSAGES/messages.po +++ b/locales/mk/LC_MESSAGES/messages.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2023-10-21 04:04+0000\n" "Last-Translator: \"Kristijan \\\"Fremen\\\" Velkovski\" \n" "Language-Team: Macedonian `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12469,7 +12509,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12553,10 +12593,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12904,17 +12942,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13116,6 +13153,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13715,7 +13758,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13932,7 +13975,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14004,16 +14049,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14027,137 +14070,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14165,11 +14184,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14178,41 +14197,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14220,26 +14239,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14247,7 +14266,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14255,7 +14274,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14264,7 +14283,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14272,89 +14291,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14362,7 +14381,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14373,14 +14392,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14389,69 +14408,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14462,11 +14481,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14476,7 +14495,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14484,11 +14503,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14496,13 +14515,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14513,23 +14532,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14537,11 +14556,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14551,33 +14570,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14585,13 +14604,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14600,6 +14619,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15263,8 +15306,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15288,36 +15338,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15329,7 +15357,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15340,7 +15368,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15352,41 +15380,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15394,7 +15422,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15402,58 +15430,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15461,7 +15489,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15469,13 +15497,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15484,7 +15512,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15493,18 +15521,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15512,7 +15540,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15522,11 +15550,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15534,15 +15562,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15550,11 +15578,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15562,29 +15590,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15593,11 +15621,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15605,14 +15633,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15621,13 +15649,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15906,26 +15954,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17529,10 +17575,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17604,6 +17647,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/pt_BR/LC_MESSAGES/messages.po b/locales/pt_BR/LC_MESSAGES/messages.po index 82cf98c3d..6281eb5d2 100644 --- a/locales/pt_BR/LC_MESSAGES/messages.po +++ b/locales/pt_BR/LC_MESSAGES/messages.po @@ -10,7 +10,7 @@ msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2023-12-21 17:40+0000\n" -"PO-Revision-Date: 2023-12-13 12:13+0000\n" +"PO-Revision-Date: 2023-12-22 21:48+0000\n" "Last-Translator: Rafael Fontenelle \n" "Language-Team: Portuguese (Brazil) \n" @@ -19,7 +19,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n > 1;\n" -"X-Generator: Weblate 5.3-rc\n" +"X-Generator: Weblate 5.4-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" @@ -639,6 +639,7 @@ msgstr "2021-8-24" #: ../source/discussions/deploying-python-applications.rst:11 #: ../source/specifications/externally-managed-environments.rst:130 #: ../source/specifications/platform-compatibility-tags.rst:21 +#: ../source/specifications/platform-compatibility-tags.rst:14 msgid "Overview" msgstr "Visão geral" @@ -782,10 +783,8 @@ msgid "Configuration management" msgstr "Gerenciamento de configuração" #: ../source/discussions/distribution-package-vs-import-package.rst:5 -#, fuzzy -#| msgid "Distribution Package" msgid "Distribution package vs. import package" -msgstr "Pacote de Distribuição" +msgstr "Pacote de distribuição vs. pacote de importação" #: ../source/discussions/distribution-package-vs-import-package.rst:7 msgid "" @@ -794,12 +793,14 @@ msgid "" "related meanings in Python packaging, \"distribution package\" and \"import " "package\"." msgstr "" +"Alguns conceitos diferentes são comumente referidos pela palavra \"pacote\". " +"Esta página esclarece as diferenças entre dois significados distintos, mas " +"relacionados no empacotamento do Python , \"pacote de distribuição\" e " +"\"pacote de importação\"." #: ../source/discussions/distribution-package-vs-import-package.rst:13 -#, fuzzy -#| msgid "Linux distribution packages" msgid "What's a distribution package?" -msgstr "Pacotes de distribuição Linux" +msgstr "O que é um pacote de distribuição?" #: ../source/discussions/distribution-package-vs-import-package.rst:15 msgid "" @@ -812,6 +813,15 @@ msgid "" "Alternatively, the term \"distribution package\" can be used to refer to a " "specific file that contains a certain version of a project." msgstr "" +"Um pacote de distribuição é um software que você pode instalar. Na maioria " +"das vezes, isso é sinônimo de \"projeto\". Quando você digita ``pip install " +"pkg``, ou quando você escreve ``dependencies = [\"pkg\"]`` em seu " +"``pyproject.toml``, ``pkg`` é o nome de um pacote de distribuição. Quando " +"você pesquisa ou navega no PyPI_, a fonte centralizada mais conhecida para " +"instalar Python bibliotecas e ferramentas, o que você vê é uma lista de " +"pacotes de distribuição. Alternativamente, o termo \"pacote de " +"distribuição\" pode ser usado para se referir a um arquivo específico que " +"contém uma determinada versão de um projeto." #: ../source/discussions/distribution-package-vs-import-package.rst:24 msgid "" @@ -820,12 +830,14 @@ msgid "" "by the system package manager of the `Linux distribution `_, which " "is a different meaning." msgstr "" +"Note que no mundo Linux, um \"pacote de distribuição\", mais comumente " +"abreviado como \"pacote de distro\" (em inglês, *distro package*) ou apenas " +"\"pacote\", é algo fornecido pelo gerenciador de pacotes do sistema da " +"\"distribuição Linux `_, que é um significado diferente." #: ../source/discussions/distribution-package-vs-import-package.rst:31 -#, fuzzy -#| msgid "and import the package:" msgid "What's an import package?" -msgstr "e importe o pacote:" +msgstr "O que é um pacote de importação?" #: ../source/discussions/distribution-package-vs-import-package.rst:33 msgid "" @@ -837,16 +849,26 @@ msgid "" "is a directory on the file system, containing modules as ``.py`` files and " "subpackages as subdirectories." msgstr "" +"Um pacote de importação é um módulo Python. Assim, quando você escreve " +"``import pkg`` ou ``from pkg import func`` em seu código Python, ``pkg`` é o " +"nome de um pacote de importação. Mais precisamente, os pacotes de importação " +"são módulos especiais Python que podem conter submódulos. Por exemplo, o " +"pacote ``numpy`` contém módulos como ``numpy.linalg`` e ``numpy.fft``. " +"Normalmente, um pacote de importação é um diretório no sistema de arquivos, " +"contendo módulos como arquivos ``.py`` e subpacotes como subdiretórios." #: ../source/discussions/distribution-package-vs-import-package.rst:42 msgid "" "You can use an import package as soon as you have installed a distribution " "package that provides it." msgstr "" +"Você pode usar um pacote de importação assim que tiver instalado um pacote " +"de distribuição que o fornece." #: ../source/discussions/distribution-package-vs-import-package.rst:47 msgid "What are the links between distribution packages and import packages?" msgstr "" +"Quais são as conexões entre pacotes de distribuição e pacotes de importação?" #: ../source/discussions/distribution-package-vs-import-package.rst:49 msgid "" @@ -854,6 +876,10 @@ msgid "" "(or non-package module), with a matching name. For example, ``pip install " "numpy`` lets you ``import numpy``." msgstr "" +"Na maioria das vezes, um pacote de distribuição fornece um único pacote de " +"importação (ou módulo de não embalagem), com um nome correspondente. Por " +"exemplo, ``pip install numpy` permite que você importe usando ``import " +"numpy``." #: ../source/discussions/distribution-package-vs-import-package.rst:53 msgid "" @@ -863,6 +889,12 @@ msgid "" "blindly install the PyPI package ``foo`` if you see ``import foo``; this may " "install an unintended, and potentially even malicious package.)" msgstr "" +"No entanto, esta é apenas uma convenção. PyPI e outros índices de pacotes " +"*não impõe nenhuma relação* entre o nome de um pacote de distribuição e os " +"pacotes de importação que ele fornece. (Uma consequência disso é que você " +"não pode instalar cegamente o pacote PyPI ``foo`` se você vir ``import " +"foo``; isso pode instalar um pacote não intencional, e potencialmente até " +"mesmo malicioso.)" #: ../source/discussions/distribution-package-vs-import-package.rst:59 msgid "" @@ -875,6 +907,15 @@ msgid "" "generally, a fork of an existing library is a common reason for differing " "names between the distribution package and the import package." msgstr "" +"Um pacote de distribuição pode fornecer um pacote de importação com um nome " +"diferente. Um exemplo disso é a popular biblioteca Pillow_ para " +"processamento de imagens. Seu nome do pacote de distribuição é ``Pillow``, " +"mas fornece o pacote de importação ``PIL``. Isto é por razões históricas: " +"Pillow começou como um fork da biblioteca PIL, assim manteve o nome de " +"importação ``PIL`` para que os usuários PIL existentes pudessem mudar para o " +"Pillow com pouco esforço. Mais geralmente, um fork de uma biblioteca " +"existente é uma razão comum para diferentes nomes entre o pacote de " +"distribuição e o pacote de importação." #: ../source/discussions/distribution-package-vs-import-package.rst:69 msgid "" @@ -883,6 +924,11 @@ msgid "" "packages with the same name can be provided by several distribution " "packages. Again, forks are a common reason for this." msgstr "" +"Em um determinado índice de pacotes (como PyPI), nomes de pacotes de " +"distribuição devem ser únicos. Por outro lado, os pacotes de importação não " +"têm tal exigência. Os pacotes de importação com o mesmo nome podem ser " +"fornecidos por vários pacotes de distribuição. Novamente, forks são uma " +"razão comum para isso." #: ../source/discussions/distribution-package-vs-import-package.rst:74 msgid "" @@ -891,6 +937,11 @@ msgid "" "which provides both an ``attrs`` import package with a newer API, and an " "``attr`` import package with an older but supported API." msgstr "" +"Por outro lado, um pacote de distribuição pode fornecer vários pacotes de " +"importação, embora isso seja menos comum. Um exemplo é o pacote de " +"distribuição attrs_, que fornece um pacote de importação ``attrs`` com uma " +"API mais recente, e um pacote de importação ``attr`` com uma API mais " +"antiga, mas suportada." #: ../source/discussions/distribution-package-vs-import-package.rst:81 msgid "How do distribution package names and import package names compare?" @@ -914,6 +965,14 @@ msgid "" "``pip install awesome-package`` (the precise rules are given in the :ref:" "`name normalization specification `)." msgstr "" +"Por outro lado, os pacotes de distribuição podem usar hífenes ``-`` ou " +"sublinhados ``_``. Eles também podem conter pontos ``.``, que às vezes é " +"usado para empacotar um subpacote de um :ref:`pacote de espaço de nomes " +"`. Para a maioria dos fins, eles não " +"diferenciam letras maiúsculas de minúsculas nem ``-`` de ``_``. Por exemplo, " +"``pip install Awesome_Package` é o mesmo que ``pip install awesome-package`` " +"(as regras precisas são dadas na :ref:`especificação de normalização de nome " +"`)." #: ../source/discussions/distribution-package-vs-import-package.rst:101 msgid "" @@ -1256,13 +1315,6 @@ msgstr "Não, :term:`setup.py` e :ref:`setuptools` não foram descontinuados." #: ../source/discussions/setup-py-deprecated.rst:10 #, fuzzy -#| msgid "" -#| "Setuptools is perfectly usable as a :term:`build backend` for packaging " -#| "Python projects. And :file:`setup.py` is a valid configuration file for :" -#| "ref:`setuptools` that happens to be written in Python, instead of in " -#| "*TOML* for example (a similar practice is used by other tools like *nox* " -#| "and its :file:`nox.py` configuration file, or *pytest* and :file:" -#| "`conftest.py`)." msgid "" "Setuptools is perfectly usable as a :term:`build backend` for packaging " "Python projects. And :file:`setup.py` is a valid configuration file for :ref:" @@ -2394,14 +2446,6 @@ msgstr "" #: ../source/glossary.rst:64 #, fuzzy -#| msgid "" -#| "A distribution package is more commonly referred to with the single words " -#| "\"package\" or \"distribution\", but this guide may use the expanded term " -#| "when more clarity is needed to prevent confusion with an :term:`Import " -#| "Package` (which is also commonly called a \"package\") or another kind of " -#| "distribution (e.g. a Linux distribution or the Python language " -#| "distribution), which are often referred to with the single term " -#| "\"distribution\"." msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2489,11 +2533,6 @@ msgstr "" #: ../source/glossary.rst:104 #, fuzzy -#| msgid "" -#| "An import package is more commonly referred to with the single word " -#| "\"package\", but this guide will use the expanded term when more clarity " -#| "is needed to prevent confusion with a :term:`Distribution Package` which " -#| "is also commonly called a \"package\"." msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2715,13 +2754,6 @@ msgstr "Especificador de Requisitos" #: ../source/glossary.rst:211 #, fuzzy -#| msgid "" -#| "A format used by :ref:`pip` to install packages from a :term:`Package " -#| "Index`. For an EBNF diagram of the format, see the `pkg_resources." -#| "Requirement `_ entry in the :ref:`setuptools` docs. For " -#| "example, \"foo>=1.3\" is a requirement specifier, where \"foo\" is the " -#| "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2964,10 +2996,6 @@ msgstr "" #: ../source/guides/analyzing-pypi-package-downloads.rst:35 #, fuzzy -#| msgid "" -#| "In short, because it's value is low for various reasons, and the " -#| "tradeoffs required to make it work are high, it has been not an effective " -#| "use of limited resources." msgid "" "In short, because its value is low for various reasons, and the tradeoffs " "required to make it work are high, it has been not an effective use of " @@ -3473,6 +3501,7 @@ msgstr "" #: ../source/guides/analyzing-pypi-package-downloads.rst:335 #: ../source/specifications/dependency-specifiers.rst:489 +#: ../source/specifications/dependency-specifiers.rst:487 msgid "References" msgstr "Referências" @@ -3726,7 +3755,6 @@ msgstr "" #: ../source/guides/distributing-packages-using-setuptools.rst:8 #, fuzzy -#| msgid "2013-12-08" msgid "2023-12-14" msgstr "2013-12-08" @@ -4014,11 +4042,6 @@ msgstr "" #: ../source/guides/distributing-packages-using-setuptools.rst:163 #, fuzzy -#| msgid "" -#| "The most relevant arguments are explained below. Most of the snippets " -#| "given are taken from the `setup.py `_ contained in " -#| "the `PyPA sample project `_." msgid "" "Most of the snippets given are taken from the `setup.py `_ " @@ -5063,7 +5086,6 @@ msgstr "" #: ../source/guides/dropping-older-python-versions.rst:81 #, fuzzy -#| msgid "Examples::" msgid "Examples:" msgstr "Exemplos::" @@ -5183,11 +5205,6 @@ msgstr "Hospedando seu próprio repositório simples" #: ../source/guides/hosting-your-own-index.rst:8 #, fuzzy -#| msgid "" -#| "If you wish to host your own simple repository [1]_, you can either use a " -#| "software package like :doc:`devpi ` or you can use simply " -#| "create the proper directory structure and use any web server that can " -#| "serve static files and generate an autoindex." msgid "" "If you wish to host your own simple repository [1]_, you can either use a " "software package like :doc:`devpi ` or you can simply create " @@ -6084,10 +6101,6 @@ msgstr "" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:48 #, fuzzy -#| msgid "" -#| "To create a virtual environment, go to your project's directory and run " -#| "``venv``. This will create a new virtual environment in a local folder ``." -#| "venv``:" msgid "" "To create a virtual environment, go to your project's directory and run the " "following command. This will create a new virtual environment in a local " @@ -10085,9 +10098,6 @@ msgstr "Configurando TestPyPI no :file:`.pypirc`" #: ../source/guides/using-testpypi.rst:75 #, fuzzy -#| msgid "" -#| "If you want to avoid entering your username, you can configure TestPyPI " -#| "in your :file:`$HOME/.pypirc`:" msgid "" "If you want to avoid being prompted for your username and password every " "time, you can configure TestPyPI in your :file:`$HOME/.pypirc`:" @@ -10274,9 +10284,6 @@ msgstr "" #: ../source/guides/writing-pyproject-toml.rst:132 #, fuzzy -#| msgid "" -#| "Consist only of ASCII letters, digits, underscores (``_``), hyphens (``-" -#| "``), and/or periods (``.``), and" msgid "" "The project name must consists of ASCII letters, digits, underscores " "\"``_``\", hyphens \"``-``\" and periods \"``.``\". It must not start or end " @@ -10287,12 +10294,6 @@ msgstr "" #: ../source/guides/writing-pyproject-toml.rst:136 #, fuzzy -#| msgid "" -#| "Comparison of project names is case insensitive and treats arbitrarily-" -#| "long runs of underscores, hyphens, and/or periods as equal. For example, " -#| "if you register a project named ``cool-stuff``, users will be able to " -#| "download it or declare a dependency on it using any of the following " -#| "spellings::" msgid "" "Comparison of project names is case insensitive and treats arbitrarily long " "runs of underscores, hyphens, and/or periods as equal. For example, if you " @@ -10471,9 +10472,6 @@ msgstr "``description``" #: ../source/guides/writing-pyproject-toml.rst:286 #, fuzzy -#| msgid "" -#| "This should be a one-line description of your project, to show as the " -#| "\"headline\" of your project page on PyPI (`example `_)." msgid "" "This should be a one-line description of your project, to show as the " "\"headline\" of your project page on PyPI (`example `_), and " @@ -10504,13 +10502,11 @@ msgstr "O formato do README é detectado automaticamente a partir da extensão:" #: ../source/guides/writing-pyproject-toml.rst:310 #, fuzzy -#| msgid "``README.md`` → Markdown," msgid "``README.md`` → `GitHub-flavored Markdown `_," msgstr "``README.md`` → Markdown," #: ../source/guides/writing-pyproject-toml.rst:311 #, fuzzy -#| msgid "``README.rst`` → reStructuredText (without Sphinx extensions)." msgid "" "``README.rst`` → `reStructuredText `_ (without Sphinx extensions)." msgstr "``README.rst`` → reStructuredText (sem extensões do Sphinx)." @@ -10539,12 +10535,6 @@ msgstr "ou você pode escrever o nome da licença:" #: ../source/guides/writing-pyproject-toml.rst:341 #, fuzzy -#| msgid "" -#| "The ``license`` argument is more typically used to indicate differences " -#| "from well-known licenses, or to include your own, unique license. As a " -#| "general rule, it's a good idea to use a standard, well-known license, " -#| "both to avoid confusion and because some organizations avoid software " -#| "whose license is unapproved." msgid "" "If you are using a standard, well-known license, it is not necessary to use " "this field. Instead, you should one of the :ref:`classifiers` starting with " @@ -10588,12 +10578,6 @@ msgstr "" #: ../source/guides/writing-pyproject-toml.rst:392 #, fuzzy -#| msgid "" -#| "Although the list of classifiers is often used to declare what Python " -#| "versions a project supports, this information is only used for searching " -#| "& browsing projects on PyPI, not for installing projects. To actually " -#| "restrict what Python versions a project can be installed on, use the :ref:" -#| "`python_requires` argument." msgid "" "Although the list of classifiers is often used to declare what Python " "versions a project supports, this information is only used for searching and " @@ -10609,10 +10593,6 @@ msgstr "" #: ../source/guides/writing-pyproject-toml.rst:397 #, fuzzy -#| msgid "" -#| "To prevent a package from being uploaded to PyPI, use the special " -#| "``'Private :: Do Not Upload'`` classifier. PyPI will always reject " -#| "packages with classifiers beginning with ``\"Private ::'``." msgid "" "To prevent a package from being uploaded to PyPI, use the special " "``Private :: Do Not Upload`` classifier. PyPI will always reject packages " @@ -11169,6 +11149,7 @@ msgstr "" #: ../source/key_projects.rst:184 #: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "pip" msgstr "pip" @@ -13923,6 +13904,7 @@ msgstr "" #: ../source/specifications/binary-distribution-format.rst:22 #: ../source/specifications/platform-compatibility-tags.rst:46 +#: ../source/specifications/platform-compatibility-tags.rst:39 msgid "Details" msgstr "Detalhes" @@ -14173,6 +14155,7 @@ msgstr "p.ex., 'py27', 'py2', 'py3'." #: ../source/specifications/binary-distribution-format.rst:128 #: ../source/specifications/platform-compatibility-tags.rst:27 +#: ../source/specifications/platform-compatibility-tags.rst:20 msgid "abi tag" msgstr "abi tag" @@ -14182,6 +14165,7 @@ msgstr "p.ex., 'cp33m', 'abi3', 'none'." #: ../source/specifications/binary-distribution-format.rst:131 #: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "platform tag" msgstr "platform tag" @@ -14434,6 +14418,7 @@ msgstr "" #: ../source/specifications/binary-distribution-format.rst:226 #: ../source/specifications/recording-installed-packages.rst:39 +#: ../source/specifications/recording-installed-packages.rst:23 msgid "The .dist-info directory" msgstr "O diretório .dist-info" @@ -14563,11 +14548,6 @@ msgstr "" #: ../source/specifications/binary-distribution-format.rst:286 #, fuzzy -#| msgid "" -#| "If JSON web signatures are used, one or more JSON Web Signature JSON " -#| "Serialization (JWS-JS) signatures is stored in a file RECORD.jws adjacent " -#| "to RECORD. JWS is used to sign RECORD by including the SHA-256 hash of " -#| "RECORD as the signature's JSON payload::" msgid "" "If JSON web signatures are used, one or more JSON Web Signature JSON " "Serialization (JWS-JS) signatures is stored in a file RECORD.jws adjacent to " @@ -14632,6 +14612,7 @@ msgstr "" #: ../source/specifications/binary-distribution-format.rst:314 #: ../source/specifications/platform-compatibility-tags.rst:244 +#: ../source/specifications/platform-compatibility-tags.rst:237 msgid "FAQ" msgstr "FAQ" @@ -14840,6 +14821,14 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:442 #: ../source/specifications/source-distribution-format.rst:144 #: ../source/specifications/version-specifiers.rst:1262 +#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/dependency-specifiers.rst:476 +#: ../source/specifications/direct-url-data-structure.rst:267 +#: ../source/specifications/direct-url.rst:67 +#: ../source/specifications/entry-points.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:301 +#: ../source/specifications/recording-installed-packages.rst:252 +#: ../source/specifications/virtual-environments.rst:54 msgid "History" msgstr "Histórico" @@ -14849,9 +14838,6 @@ msgstr "" #: ../source/specifications/binary-distribution-format.rst:423 #, fuzzy -#| msgid "" -#| "The following changes were made based on feedback after its initial " -#| "implementation:" msgid "The following changes were applied since the initial version:" msgstr "" "As seguintes alterações foram feitas com base no feedback após sua " @@ -14867,10 +14853,12 @@ msgstr "" "(fevereiro de 2021)." #: ../source/specifications/binary-distribution-format.rst:430 +#: ../source/specifications/binary-distribution-format.rst:427 msgid "Appendix" msgstr "Apêndice" #: ../source/specifications/binary-distribution-format.rst:432 +#: ../source/specifications/binary-distribution-format.rst:429 msgid "Example urlsafe-base64-nopad implementation::" msgstr "Exemplo de implementação de urlsafe-base64-nopad::" @@ -16074,10 +16062,12 @@ msgstr "" "você instala o Torqued Python, o pacote Gorgon deve ser removido." #: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:873 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "Marcação reStructuredText: https://docutils.sourceforge.io/" #: ../source/specifications/core-metadata.rst:858 +#: ../source/specifications/core-metadata.rst:878 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" @@ -16623,9 +16613,6 @@ msgstr "``test``" #: ../source/specifications/dependency-specifiers.rst:277 #, fuzzy -#| msgid "" -#| "The ``implementation_version`` marker variable is derived from ``sys." -#| "implementation.version``::" msgid "" "The ``implementation_version`` marker variable is derived from ``sys." "implementation.version``:" @@ -16651,7 +16638,6 @@ msgstr "A gramática completa do persley ::" #: ../source/specifications/dependency-specifiers.rst:407 #, fuzzy -#| msgid "A test program - if the grammar is in a string ``grammar``::" msgid "A test program - if the grammar is in a string ``grammar``:" msgstr "" "Um programa de teste -- se a gramática estiver em uma string ``grammar``::" @@ -16681,6 +16667,7 @@ msgstr "" "2 dígitos (por exemplo, 3.10). [#future_versions]_" #: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" @@ -16689,11 +16676,13 @@ msgstr "" "org/en/stable/)" #: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" "A biblioteca de PEG do parsley. (https://pypi.python.org/pypi/parsley/)" #: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -16732,6 +16721,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:21 #: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -16913,9 +16903,6 @@ msgstr "" #: ../source/specifications/direct-url-data-structure.rst:34 #, fuzzy -#| msgid "" -#| "The user:password section of the URL MAY however be composed of " -#| "environment variables, matching the following regular expression::" msgid "" "The user:password section of the URL MAY however be composed of environment " "variables, matching the following regular expression:" @@ -18612,26 +18599,32 @@ msgid ":pep:`600`" msgstr ":pep:`600`" #: ../source/specifications/platform-compatibility-tags.rst:23 +#: ../source/specifications/platform-compatibility-tags.rst:16 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "Oformato da tag é ``{python tag}-{abi tag}-{platform tag}``." #: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "python tag" #: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "'py27', 'cp33'" #: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "'cp32dmu', 'none'" #: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "'linux_x86_64', 'any'" #: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." @@ -18642,10 +18635,13 @@ msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:36 #: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "Uso" #: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" @@ -18657,15 +18653,18 @@ msgstr "" "próprias convenções." #: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" "Quaisquer espaços em potencial em alguma tag deve ser substituído por ``_``." #: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "A tag Python" #: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" @@ -18674,30 +18673,37 @@ msgstr "" "As principais implementações têm códigos abreviados, inicialmente:" #: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "py: Python genérico (não requer recursos específicos de implementação)" #: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "cp: CPython" #: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "ip: IronPython" #: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "pp: PyPy" #: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "jy: Jython" #: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "Outras implementações Python devem usar ``sys.implementation.name``." #: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " @@ -18708,6 +18714,7 @@ msgstr "" "usar suas próprias versões aqui ``pp18``, ``pp19``." #: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." @@ -18716,6 +18723,7 @@ msgstr "" "para muitas distribuições de Python puro." #: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " @@ -18727,6 +18735,7 @@ msgstr "" "compatível com várias versões." #: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." @@ -18735,10 +18744,12 @@ msgstr "" "composta ``py2.py3``. Consulte `Conjuntos de tags compactadas`_, abaixo." #: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "A tag ABI" #: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -18751,12 +18762,14 @@ msgstr "" "CPython 3.3 com depuração." #: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" "A ABI estável do CPython é ``abi3`` como no sufixo da biblioteca " "compartilhada." #: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -18771,10 +18784,12 @@ msgstr "" "cada implementação pode decidir como usar melhor a tag ABI." #: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "A tag Platform" #: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 #, fuzzy msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" @@ -18785,22 +18800,27 @@ msgstr "" "todos os hífens ``-`` e pontos ``.`` substituídos por sublinhados ``_``." #: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "win32" #: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "linux_i386" #: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "linux_x86_64" #: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "``manylinux``" #: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " @@ -18812,6 +18832,7 @@ msgstr "" "elas." #: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -18824,6 +18845,7 @@ msgstr "" "distribuições Linux." #: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" @@ -18833,6 +18855,7 @@ msgstr "" "ponto no tempo:" #: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." @@ -18841,6 +18864,7 @@ msgstr "" "``i686`` e é baseado em uma plataforma Linux compatível de 2007." #: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " @@ -18851,6 +18875,7 @@ msgstr "" "plataforma Linux compatível a partir de 2010." #: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -18862,6 +18887,7 @@ msgstr "" "atualiza a plataforma base para uma plataforma Linux compatível de 2014." #: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -18876,6 +18902,7 @@ msgstr "" "anteriores." #: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -18891,6 +18918,7 @@ msgstr "" "existiam antes de 2010)." #: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -18903,10 +18931,12 @@ msgstr "" "que significa que essas imagens não receberão mais atualizações de segurança." #: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "Suporte a compatibilidade de manylinux" #: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." @@ -18915,6 +18945,7 @@ msgstr "" "amplamente reconhecida pelas ferramentas de instalação." #: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." @@ -18923,6 +18954,7 @@ msgstr "" "reconhecida pelas ferramentas de instalação." #: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" @@ -18931,67 +18963,83 @@ msgstr "" "oferecer suporte aos vários padrões ``manylinux``:" #: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "Ferramenta" #: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "``manylinux1``" #: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "``manylinux2010``" #: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "``manylinux2014``" #: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "``manylinux_x_y``" #: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "``>=8.1.0``" #: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "``>=19.0``" #: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "``>=19.3``" #: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "``>=20.3``" #: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "auditwheel" #: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "``>=1.0.0``" #: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "``>=2.0.0``" #: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "``>=3.0.0``" #: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "``>=3.3.0`` [#]_" #: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" "Suporte somente para ``manylinux_2_24`` foi adicionado em auditwheel 3.3.0" #: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -19000,6 +19048,7 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -19011,6 +19060,7 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " @@ -19018,6 +19068,7 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -19027,68 +19078,84 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -19100,10 +19167,12 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -19114,6 +19183,7 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -19122,10 +19192,12 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -19134,12 +19206,14 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -19151,10 +19225,12 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " @@ -19162,11 +19238,13 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -19175,10 +19253,12 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -19189,10 +19269,12 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " @@ -19200,10 +19282,12 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " @@ -19211,10 +19295,12 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -19223,12 +19309,14 @@ msgid "" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -20172,6 +20260,7 @@ msgstr "" "justificativas e considerações de compatibilidade com versões anteriores." #: ../source/specifications/recording-installed-packages.rst:41 +#: ../source/specifications/recording-installed-packages.rst:25 msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " @@ -20182,6 +20271,7 @@ msgstr "" "importáveis (comumente, o diretório ``site-packages``)." #: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 #, fuzzy msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " @@ -20203,6 +20293,7 @@ msgstr "" "campos ``name`` e ``version``." #: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -20222,6 +20313,7 @@ msgstr "" "são encorajadas a começar a normalizar esses campos." #: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 #, fuzzy msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " @@ -20245,6 +20337,7 @@ msgstr "" "distribuição." #: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 #, fuzzy msgid "" "This ``.dist-info`` directory may contain the following files, described in " @@ -20254,28 +20347,34 @@ msgstr "" "detalhes abaixo:" #: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "``METADATA``: contém metadados do projeto" #: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "``RECORD``: registra a lista de arquivos instalados." #: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" "``INSTALLER``: registra o nome da ferramenta usada para instalar o projeto." #: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" #: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" #: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " @@ -20286,6 +20385,7 @@ msgstr "" "específicos do instalador podem estar presentes." #: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -20298,6 +20398,7 @@ msgstr "" "de um projeto instalado." #: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -20311,10 +20412,12 @@ msgstr "" "original." #: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "O arquivo METADATA" #: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." @@ -20323,6 +20426,7 @@ msgstr "" "ref:`core-metadata`, versão 1.1 ou superior." #: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " @@ -20333,10 +20437,12 @@ msgstr "" "devem relatar um erro e falhar ao instalar o projeto." #: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "O arquivo RECORD" #: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." @@ -20345,6 +20451,7 @@ msgstr "" "contendo um registro (linha) por arquivo instalado." #: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" @@ -20353,18 +20460,22 @@ msgstr "" "Python:" #: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "delimitador de campo: ``,`` (vírgula)," #: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "caractere de aspas: ``\"`` (aspas duplas)," #: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "terminador de linha: ``\\r\\n`` ou ``\\n``." #: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." @@ -20373,6 +20484,7 @@ msgstr "" "**hash** do conteúdo e seu **tamanho**." #: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -20385,6 +20497,7 @@ msgstr "" "(``/`` ou ``\\``)." #: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -20397,6 +20510,7 @@ msgstr "" "(``base64.urlsafe_b64encode(digest)`` com ``=`` ao final removido)." #: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." @@ -20405,6 +20519,7 @@ msgstr "" "inteiro de base 10." #: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -20419,6 +20534,7 @@ msgstr "" "da integridade do projeto instalado." #: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -20433,6 +20549,7 @@ msgstr "" "``RECORD``) deve ser listado. Os diretórios não devem ser listados." #: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " @@ -20444,10 +20561,12 @@ msgstr "" "removidos e quaisquer diretórios esvaziados pela desinstalação." #: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "Aqui está um trecho de exemplo de um possível arquivo ``RECORD``::" #: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 #, fuzzy msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " @@ -20461,6 +20580,7 @@ msgstr "" "gerenciadores de pacotes do sistema em distros Linux.)" #: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -20471,10 +20591,12 @@ msgid "" msgstr "" #: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "O arquivo INSTALLER" #: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -20487,16 +20609,19 @@ msgstr "" "Caso contrário, deve conter uma string ASCII imprimível." #: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" "O arquivo pode ser encerrado com zero ou mais caracteres de espaço em branco " "ASCII." #: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "Aqui estão exemplos de dois possíveis arquivos ``INSTALLER``::" #: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -20509,10 +20634,12 @@ msgstr "" "capaz de fazer a desinstalação." #: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" #: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -20521,15 +20648,18 @@ msgid "" msgstr "" #: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 #, fuzzy msgid "Its detailed specification is at :ref:`entry-points`." msgstr "Sua especificação detalhada está em :ref:`direct-url`." #: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "O arquivo direct_url.json" #: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." @@ -20539,14 +20669,17 @@ msgstr "" "(incluindo uma URL de VCS)." #: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "Sua especificação detalhada está em :ref:`direct-url`." #: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" #: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -20556,10 +20689,12 @@ msgid "" msgstr "" #: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" #: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -20568,6 +20703,7 @@ msgid "" msgstr "" #: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " @@ -20575,6 +20711,7 @@ msgid "" msgstr "" #: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -20584,6 +20721,7 @@ msgid "" msgstr "" #: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" @@ -24407,6 +24545,218 @@ msgid "" "the file is empty)." msgstr "" +#: ../source/specifications/binary-distribution-format.rst:421 +msgid "February 2013: This specification was approved through :pep:`427`." +msgstr "" + +#: ../source/specifications/binary-distribution-format.rst:422 +#, fuzzy +msgid "" +"February 2021: The rules on escaping in wheel filenames were revised, to " +"bring them into line with what popular tools actually do." +msgstr "" +"As regras sobre como escapar em nomes de arquivos wheel foram revisadas, " +"para alinhá-las com o que as ferramentas populares realmente fazem " +"(fevereiro de 2021)." + +#: ../source/specifications/core-metadata.rst:854 +msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:855 +msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" +msgstr "" + +#: ../source/specifications/core-metadata.rst:856 +msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:857 +msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:859 +#, fuzzy +msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." +msgstr "" +"Adicionada documentação para o campo ``Description-Content-Type``. (:pr:" +"`258`)" + +#: ../source/specifications/core-metadata.rst:860 +msgid "Added canonical method for transforming metadata to JSON." +msgstr "" + +#: ../source/specifications/core-metadata.rst:861 +msgid "Restricted the grammar of the ``Name`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:863 +msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:865 +msgid "Added the ``Dynamic`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:867 +msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:869 +msgid "Restricted extra names to be normalized." +msgstr "" + +#: ../source/specifications/dependency-specifiers.rst:478 +msgid "November 2015: This specification was approved through :pep:`508`." +msgstr "" + +#: ../source/specifications/dependency-specifiers.rst:479 +#, fuzzy +msgid "" +"July 2019: The definition of ``python_version`` was `changed `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" +msgstr "" +"A definição de ``python_version`` foi alterada de ``platform.python_version()" +"[:3]`` para ``'.'.join(platform.python_version_tuple()[:2])``, para acomodar " +"potenciais futuras versões do Python com versões principais e secundárias de " +"2 dígitos (por exemplo, 3.10). [#future_versions]_" + +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." +msgstr "" + +#: ../source/specifications/direct-url-data-structure.rst:269 +msgid "" +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." +msgstr "" + +#: ../source/specifications/direct-url-data-structure.rst:271 +#, fuzzy +msgid "" +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." +msgstr "" +"Janeiro de 2023: Adicionada a chave ``archive_info.hashes`` (`discussão " +"`__)." + +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + +#: ../source/specifications/externally-managed-environments.rst:474 +msgid "June 2022: This specification was approved through :pep:`668`." +msgstr "" + +#: ../source/specifications/inline-script-metadata.rst:241 +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." +msgstr "" + +#: ../source/specifications/name-normalization.rst:44 +msgid "" +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." +msgstr "" + +#: ../source/specifications/name-normalization.rst:46 +msgid "" +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:444 +msgid "" +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + +#: ../source/specifications/source-distribution-format.rst:146 +msgid "" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." +msgstr "" + +#: ../source/specifications/source-distribution-format.rst:148 +msgid "July 2021: Defined what a source tree is." +msgstr "" + +#: ../source/specifications/source-distribution-format.rst:149 +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." +msgstr "" + +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." +msgstr "" + +#: ../source/specifications/version-specifiers.rst:1264 +msgid "August 2014: This specification was approved through :pep:`440`." +msgstr "" + +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #~ msgid "" #~ "This is the name of your project, determining how your project is listed " #~ "on :term:`PyPI `. Per :pep:`508`, valid " diff --git a/locales/ro/LC_MESSAGES/messages.po b/locales/ro/LC_MESSAGES/messages.po index e31319c21..be84cf434 100644 --- a/locales/ro/LC_MESSAGES/messages.po +++ b/locales/ro/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2021-08-20 01:32+0000\n" "Last-Translator: GUILHERME FERNANDES NETO \n" "Language-Team: Romanian `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12471,7 +12511,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12555,10 +12595,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12906,17 +12944,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13118,6 +13155,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13717,7 +13760,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13934,7 +13977,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14006,16 +14051,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14029,137 +14072,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14167,11 +14186,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14180,41 +14199,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14222,26 +14241,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14249,7 +14268,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14257,7 +14276,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14266,7 +14285,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14274,89 +14293,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14364,7 +14383,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14375,14 +14394,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14391,69 +14410,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14464,11 +14483,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14478,7 +14497,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14486,11 +14505,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14498,13 +14517,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14515,23 +14534,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14539,11 +14558,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14553,33 +14572,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14587,13 +14606,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14602,6 +14621,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15265,8 +15308,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15290,36 +15340,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15331,7 +15359,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15342,7 +15370,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15354,41 +15382,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15396,7 +15424,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15404,58 +15432,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15463,7 +15491,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15471,13 +15499,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15486,7 +15514,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15495,18 +15523,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15514,7 +15542,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15524,11 +15552,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15536,15 +15564,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15552,11 +15580,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15564,29 +15592,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15595,11 +15623,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15607,14 +15635,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15623,13 +15651,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15908,26 +15956,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17531,10 +17577,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17606,6 +17649,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/ru/LC_MESSAGES/messages.po b/locales/ru/LC_MESSAGES/messages.po index cc3b1e84f..9aadcb24d 100644 --- a/locales/ru/LC_MESSAGES/messages.po +++ b/locales/ru/LC_MESSAGES/messages.po @@ -7,22 +7,23 @@ # Vik , 2022. # Alex , 2023. # gfbdrgng , 2023. +# Andrey Rybakov , 2023. msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" -"PO-Revision-Date: 2023-12-18 06:41+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" +"PO-Revision-Date: 2023-12-24 12:53+0000\n" "Last-Translator: gfbdrgng \n" -"Language-Team: Russian \n" +"Language-Team: Russian \n" "Language: ru\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && " -"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" -"X-Generator: Weblate 5.3\n" +"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && " +"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n" +"X-Generator: Weblate 5.4-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" @@ -105,7 +106,7 @@ msgid "" msgstr "" "Учебники нацелены на обучение читателя новым понятиям путем достижения цели. " "Они представляют собой пошаговые руководства, основанные на мнениях. Они не " -"содержат лишних предупреждений или информации. `Пример документа в стиле " +"содержат лишних предупреждений или информации. `пример документа‐в стиле " "учебника`_." #: ../source/contribute.rst:51 ../source/guides/index.rst:2 @@ -645,7 +646,7 @@ msgstr "2021-8-24" #: ../source/discussions/deploying-python-applications.rst:11 #: ../source/specifications/externally-managed-environments.rst:130 -#: ../source/specifications/platform-compatibility-tags.rst:21 +#: ../source/specifications/platform-compatibility-tags.rst:14 msgid "Overview" msgstr "Обзор" @@ -789,10 +790,8 @@ msgid "Configuration management" msgstr "Управление конфигурацией" #: ../source/discussions/distribution-package-vs-import-package.rst:5 -#, fuzzy -#| msgid "Distribution Package" msgid "Distribution package vs. import package" -msgstr "Пакет дистрибутива" +msgstr "Пакет распределения против пакета импорта" #: ../source/discussions/distribution-package-vs-import-package.rst:7 msgid "" @@ -801,6 +800,9 @@ msgid "" "related meanings in Python packaging, \"distribution package\" and \"import " "package\"." msgstr "" +"Словом \"пакет\" обычно обозначают несколько различных понятий. Эта страница " +"объясняет различия между двумя разными, но связанными значениями в упаковке " +"Python, \"дистрибутивный пакет\" и \"пакет импорта\"." #: ../source/discussions/distribution-package-vs-import-package.rst:13 msgid "What's a distribution package?" @@ -817,6 +819,15 @@ msgid "" "Alternatively, the term \"distribution package\" can be used to refer to a " "specific file that contains a certain version of a project." msgstr "" +"Дистрибутив - это часть программного обеспечения, которую вы можете " +"установить. В большинстве случаев это синоним слова \"проект\". Когда вы " +"набираете ``pip install pkg``, или когда вы пишете ``dependencies = [\"pkg\"" +"]`` в вашем ``pyproject.toml``, ``pkg`` - это имя дистрибутивного пакета. " +"Когда вы ищете или просматриваете PyPI_, наиболее известный централизованный " +"источник для установки библиотек и инструментов Python, вы видите список " +"дистрибутивных пакетов. Кроме того, термин \"дистрибутивный пакет\" может " +"использоваться для обозначения конкретного файла, содержащего определенную " +"версию проекта." #: ../source/discussions/distribution-package-vs-import-package.rst:24 msgid "" @@ -825,6 +836,10 @@ msgid "" "by the system package manager of the `Linux distribution `_, which " "is a different meaning." msgstr "" +"Обратите внимание, что в мире Linux \"дистрибутивный пакет\", чаще всего " +"сокращаемый как \"дистропакет\" или просто \"пакет\", - это нечто, " +"предоставляемое системным менеджером пакетов дистрибутива `_, что " +"имеет другое значение." #: ../source/discussions/distribution-package-vs-import-package.rst:31 msgid "What's an import package?" @@ -840,16 +855,25 @@ msgid "" "is a directory on the file system, containing modules as ``.py`` files and " "subpackages as subdirectories." msgstr "" +"Импортный пакет - это модуль Python. Таким образом, когда вы пишете ``import " +"pkg`` или ``from pkg import func`` в вашем коде Python, ``pkg`` - это имя " +"пакета импорта. Точнее, импортные пакеты - это специальные модули Python, " +"которые могут содержать подмодули. Например, пакет ``numpy`` содержит такие " +"модули, как ``numpy.linalg`` и ``numpy.fft``. Обычно пакет импорта " +"представляет собой каталог в файловой системе, содержащий модули в виде " +"файлов ``.py`` и подпакеты в виде подкаталогов." #: ../source/discussions/distribution-package-vs-import-package.rst:42 msgid "" "You can use an import package as soon as you have installed a distribution " "package that provides it." msgstr "" +"Вы можете использовать пакет импорта, как только установите дистрибутив, " +"который его предоставляет." #: ../source/discussions/distribution-package-vs-import-package.rst:47 msgid "What are the links between distribution packages and import packages?" -msgstr "" +msgstr "Какие связи существуют между дистрибутивными и импортными пакетами?" #: ../source/discussions/distribution-package-vs-import-package.rst:49 msgid "" @@ -857,6 +881,9 @@ msgid "" "(or non-package module), with a matching name. For example, ``pip install " "numpy`` lets you ``import numpy``." msgstr "" +"Чаще всего дистрибутив предоставляет один единственный импортный пакет (или " +"непакетный модуль) с соответствующим именем. Например, ``pip install numpy`` " +"позволяет вам ``импортировать numpy``." #: ../source/discussions/distribution-package-vs-import-package.rst:53 msgid "" @@ -866,6 +893,12 @@ msgid "" "blindly install the PyPI package ``foo`` if you see ``import foo``; this may " "install an unintended, and potentially even malicious package.)" msgstr "" +"Однако это лишь условность. PyPI и другие указатели пакетов *не обеспечивают " +"никакой связи* между именем дистрибутивного пакета и пакетами импорта, " +"которые он предоставляет. (Следствием этого является то, что вы не можете " +"вслепую установить пакет PyPI ``foo``, если вы видите ``import foo``; это " +"может привести к установке непреднамеренного и потенциально даже " +"вредоносного пакета)" #: ../source/discussions/distribution-package-vs-import-package.rst:59 msgid "" @@ -878,6 +911,14 @@ msgid "" "generally, a fork of an existing library is a common reason for differing " "names between the distribution package and the import package." msgstr "" +"Дистрибутив может предоставлять пакет импорта с другим именем. Примером " +"может служить популярная библиотека Pillow_ для обработки изображений. Имя " +"ее дистрибутивного пакета - ``Pillow``, но она предоставляет пакет импорта " +"``PIL``. Это объясняется историческими причинами: Pillow начиналась как форк " +"библиотеки PIL, поэтому она сохранила имя импорта ``PIL``, чтобы " +"существующие пользователи PIL могли перейти на Pillow без особых усилий. В " +"целом, форк существующей библиотеки - это распространенная причина различия " +"имен в дистрибутивном и импортном пакетах." #: ../source/discussions/distribution-package-vs-import-package.rst:69 msgid "" @@ -886,6 +927,11 @@ msgid "" "packages with the same name can be provided by several distribution " "packages. Again, forks are a common reason for this." msgstr "" +"В определенном индексе пакетов (например, в PyPI) имена дистрибутивных " +"пакетов должны быть уникальными. С другой стороны, импортные пакеты не имеют " +"такого требования. Импортные пакеты с одним и тем же именем могут " +"предоставляться несколькими дистрибутивными пакетами. Опять же, частой " +"причиной этого являются форки." #: ../source/discussions/distribution-package-vs-import-package.rst:74 msgid "" @@ -894,10 +940,14 @@ msgid "" "which provides both an ``attrs`` import package with a newer API, and an " "``attr`` import package with an older but supported API." msgstr "" +"И наоборот, дистрибутивный пакет может предоставлять несколько пакетов " +"импорта, хотя это встречается реже. Примером может служить дистрибутивный " +"пакет attrs_, который предоставляет как пакет импорта ``attrs`` с более " +"новым API, так и пакет импорта ``attr`` со старым, но поддерживаемым API." #: ../source/discussions/distribution-package-vs-import-package.rst:81 msgid "How do distribution package names and import package names compare?" -msgstr "" +msgstr "Как соотносятся имена дистрибутивных и импортных пакетов?" #: ../source/discussions/distribution-package-vs-import-package.rst:83 msgid "" @@ -906,6 +956,10 @@ msgid "" "[#non-identifier-mod-name]_. In particular, they use underscores ``_`` as " "word separator and they are case-sensitive." msgstr "" +"Импортируемые пакеты должны иметь в качестве имени корректные идентификаторы " +"Python (точные правила ` можно найти в документации " +"Python) [#non-identifier-mod-name]_. В частности, они используют " +"подчеркивание ``_`` в качестве разделителя слов и чувствительны к регистру." #: ../source/discussions/distribution-package-vs-import-package.rst:88 msgid "" @@ -917,6 +971,14 @@ msgid "" "``pip install awesome-package`` (the precise rules are given in the :ref:" "`name normalization specification `)." msgstr "" +"С другой стороны, распределительные пакеты могут использовать дефисы ``-`` " +"или подчеркивает ``_``. Они также могут содержать точки ``.``, которые " +"иногда используются для упаковки подпаковки :ref:`namespace package " +"`. Для большинства целей они нечувствительны к " +"делу и к ``-`` против ``_`` различий, например, ``pip установить " +"Awesome_Package`` - это то же самое, что ``pip установить потрясающий пакет``" +" (точные правила даны в :ref:`name normalization Спецификация " +"`)." #: ../source/discussions/distribution-package-vs-import-package.rst:101 msgid "" @@ -924,6 +986,10 @@ msgid "" "have a valid Python identifier as their name, using :doc:`importlib `, this is vanishingly rare and strongly discouraged." msgstr "" +"Хотя технически возможно импортировать пакеты/модули, не имеющие в качестве " +"имени действительного идентификатора Python, используя :doc:`importlib " +"`, это происходит крайне редко и настоятельно не " +"рекомендуется." #: ../source/discussions/index.rst:4 msgid "" @@ -2372,15 +2438,6 @@ msgstr "" "что конечный пользователь скачает из интернета и установит." #: ../source/glossary.rst:64 -#, fuzzy -#| msgid "" -#| "A distribution package is more commonly referred to with the single words " -#| "\"package\" or \"distribution\", but this guide may use the expanded term " -#| "when more clarity is needed to prevent confusion with an :term:`Import " -#| "Package` (which is also commonly called a \"package\") or another kind of " -#| "distribution (e.g. a Linux distribution or the Python language " -#| "distribution), which are often referred to with the single term " -#| "\"distribution\"." msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2391,12 +2448,13 @@ msgid "" "\"distribution\". See :ref:`distribution-package-vs-import-package` for a " "breakdown of the differences." msgstr "" -"Дистрибутив чаще всего обозначается одним словом \"пакет\" или " -"\"дистрибутив\", но в данном руководстве может использоваться расширенный " -"термин, когда требуется большая ясность, чтобы избежать путаницы с :термином:" -"`импортный пакет` (который также обычно называется \"пакет\") или другим " -"видом дистрибутива (например, дистрибутив Linux или дистрибутив языка " -"Python), которые часто обозначаются одним термином \"дистрибутив\"." +"Дистрибутив чаще всего обозначается одним словом \"пакет\" или \"дистрибутив" +"\", но в данном руководстве может использоваться расширенный термин, когда " +"требуется большая ясность, чтобы избежать путаницы с :term:`Import Package` (" +"который также обычно называется \"пакет\") или другим видом дистрибутива (" +"например, дистрибутив Linux или дистрибутив языка Python), которые часто " +"обозначаются одним термином \"дистрибутив\". Разбор различий см. в :ref" +":`distribution-package-vs-import-package`." #: ../source/glossary.rst:72 msgid "Egg" @@ -2463,12 +2521,6 @@ msgstr "" "пакеты." #: ../source/glossary.rst:104 -#, fuzzy -#| msgid "" -#| "An import package is more commonly referred to with the single word " -#| "\"package\", but this guide will use the expanded term when more clarity " -#| "is needed to prevent confusion with a :term:`Distribution Package` which " -#| "is also commonly called a \"package\"." msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2476,10 +2528,11 @@ msgid "" "also commonly called a \"package\". See :ref:`distribution-package-vs-import-" "package` for a breakdown of the differences." msgstr "" -"Импортный пакет чаще всего обозначается одним словом \"пакет\", но в данном " +"Импортный пакет чаще всего обозначается одним словом \"пакет\", но в этом " "руководстве будет использоваться расширенный термин, когда требуется большая " -"ясность, чтобы избежать путаницы с :термином:`Дистрибутивный пакет`, который " -"также обычно называется \"пакет\"." +"ясность, чтобы избежать путаницы с :term:`Distribution Package`, который " +"также обычно называется \"пакет\". Различия см. в :ref:`distribution-package-" +"vs-import-package`." #: ../source/glossary.rst:109 msgid "Module" @@ -2691,14 +2744,6 @@ msgid "Requirement Specifier" msgstr "Спецификатор требований" #: ../source/glossary.rst:211 -#, fuzzy -#| msgid "" -#| "A format used by :ref:`pip` to install packages from a :term:`Package " -#| "Index`. For an EBNF diagram of the format, see the `pkg_resources." -#| "Requirement `_ entry in the :ref:`setuptools` docs. For " -#| "example, \"foo>=1.3\" is a requirement specifier, where \"foo\" is the " -#| "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2706,11 +2751,9 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" "Формат, используемый :ref:`pip` для установки пакетов из :term:`Package " -"Index`. Для диаграммы EBNF формата см. в `pkg_resources.Requirement `_ в :ref:`setuptools` docs. Например, \"foo>=1.3\" является " -"спецификатором требований, где \"foo\" является наименованием проекта, а " -"«>=1.3» - это:термин:`Version Specifier `" +"Index`. EBNF диаграмму этого формата смотрите в :ref:`dependency-specifiers`" +". Например, \"foo>=1.3\" - это спецификатор требований, где \"foo\" - это " +"имя проекта, а часть \">=1.3\" - это :term:`Version Specifier`" #: ../source/glossary.rst:216 msgid "Requirements File" @@ -2911,7 +2954,7 @@ msgstr "" #: ../source/guides/analyzing-pypi-package-downloads.rst:26 msgid "Packages not hosted on PyPI (for comparisons sake)" -msgstr "Пакеты, размещённые не на PyPI (для сравнения);" +msgstr "Пакеты, не размещенные на PyPI (для сравнения)" #: ../source/guides/analyzing-pypi-package-downloads.rst:27 msgid "" @@ -2981,7 +3024,7 @@ msgstr "" #: ../source/guides/analyzing-pypi-package-downloads.rst:55 msgid "Navigate to the `BigQuery web UI`_." -msgstr "Перейдите к `BigQuery веб-UI`_." +msgstr "Перейдите к `BigQuery web UI`_." #: ../source/guides/analyzing-pypi-package-downloads.rst:56 msgid "Create a new project." @@ -3441,7 +3484,7 @@ msgstr "" "`Pandas`_." #: ../source/guides/analyzing-pypi-package-downloads.rst:335 -#: ../source/specifications/dependency-specifiers.rst:489 +#: ../source/specifications/dependency-specifiers.rst:487 msgid "References" msgstr "Ссылка" @@ -3991,7 +4034,6 @@ msgstr "" "sampleproject>`_." #: ../source/guides/distributing-packages-using-setuptools.rst:170 -#, fuzzy msgid "" "See :ref:`Choosing a versioning scheme` for more information on ways to use " "versions to convey compatibility information to your users." @@ -4021,7 +4063,6 @@ msgstr "" "пакетов, которые не предназначены для выпуска и установки." #: ../source/guides/distributing-packages-using-setuptools.rst:192 -#, fuzzy msgid "``py_modules``" msgstr "``py_modules``" @@ -4551,6 +4592,8 @@ msgid "" "Minimally, you should create a :term:`Source Distribution `:" msgstr "" +"Минимумом вы должны создать :термин:`Источник распределения <Источник " +"распределения (или \"сдист\")>`:" #: ../source/guides/distributing-packages-using-setuptools.rst:511 msgid "" @@ -4560,6 +4603,11 @@ msgid "" "involves a build step to build out the installation metadata from :file:" "`setup.py` and/or :file:`setup.cfg`." msgstr "" +"Исходный дистрибутив\" является несобранным (т.е. не является :term:`Built " +"Distribution`) и требует шага сборки при установке с помощью pip. Даже если " +"дистрибутив является чистым Python (т.е. не содержит расширений), он все " +"равно требует сборки для создания метаданных установки из :file:`setup.py` и/" +"или :file:`setup.cfg`." #: ../source/guides/distributing-packages-using-setuptools.rst:519 msgid "Wheels" @@ -4572,18 +4620,27 @@ msgid "" "through the \"build\" process. Installing wheels is substantially faster for " "the end user than installing from a source distribution." msgstr "" +"Вы также должны создать колесо для своего проекта. Колесо - это :term:`" +"сборка пакета <Сборка дистрибутива>`, который может быть установлен без " +"необходимости проходить процесс \"сборки\". Установка колес значительно " +"быстрее для конечного пользователя, чем установка из исходного дистрибутива." #: ../source/guides/distributing-packages-using-setuptools.rst:526 msgid "" "If your project is pure Python then you'll be creating a :ref:`\"Pure Python " "Wheel\" (see section below) `." msgstr "" +"Если ваш проект является чистым Python, то вы будете создавать :ref: «Чистый " +"Python Колесо» (см. раздел ниже) <Чистый Python Колеса>`." #: ../source/guides/distributing-packages-using-setuptools.rst:529 msgid "" "If your project contains compiled extensions, then you'll be creating what's " "called a :ref:`*Platform Wheel* (see section below) `." msgstr "" +"Если ваш проект содержит компилированные расширения, то вы будете создавать " +"то, что называется:ref:`*Platform Wheel* (см. раздел ниже) `." #: ../source/guides/distributing-packages-using-setuptools.rst:532 msgid "" @@ -4591,12 +4648,17 @@ msgid "" "you should create what's called a *Universal Wheel* by adding the following " "to your :file:`setup.cfg` file:" msgstr "" +"Если ваш проект также поддерживает Python 2 *и* не содержит расширений C, то " +"вам следует создать так называемое *универсальное колесо*, добавив следующее " +"в файл :file:`setup.cfg`:" #: ../source/guides/distributing-packages-using-setuptools.rst:541 msgid "" "Only use this setting if your project does not have any C extensions *and* " "supports Python 2 and 3." msgstr "" +"Используйте эту настройку только в том случае, если ваш проект не имеет " +"расширений на языке C *и* поддерживает Python 2 и 3." #: ../source/guides/distributing-packages-using-setuptools.rst:548 msgid "Pure Python Wheels" @@ -4607,6 +4669,8 @@ msgid "" "*Pure Python Wheels* contain no compiled extensions, and therefore only " "require a single Python wheel." msgstr "" +"* Чистые Python колеса* не содержат компилированных расширений, и поэтому " +"требуется только одно колесо Python." #: ../source/guides/distributing-packages-using-setuptools.rst:553 #: ../source/guides/distributing-packages-using-setuptools.rst:582 @@ -4619,12 +4683,17 @@ msgid "" "wheel that's named such that it's usable on any Python 3 installation. For " "details on the naming of wheel files, see :pep:`425`." msgstr "" +"Пакет ``wheel`` определит, что код - это чистый Python, и создаст колесо, " +"названное так, чтобы его можно было использовать на любой установке Python " +"3. Подробнее об именовании файлов wheel смотрите в :pep:`425`." #: ../source/guides/distributing-packages-using-setuptools.rst:571 msgid "" "If you run ``build`` without ``--wheel`` or ``--sdist``, it will build both " "files for you; this is useful when you don't need multiple wheels." msgstr "" +"Если вы запустите ``build`` без ``--wheel`` или ``--sdist``, он соберет оба " +"файла за вас; это полезно, когда вам не нужно несколько колес." #: ../source/guides/distributing-packages-using-setuptools.rst:577 msgid "Platform Wheels" @@ -4635,6 +4704,9 @@ msgid "" "*Platform Wheels* are wheels that are specific to a certain platform like " "Linux, macOS, or Windows, usually due to containing compiled extensions." msgstr "" +"*Платформенные колеса* - это колеса, которые специфичны для определенной " +"платформы, например Linux, macOS или Windows, обычно из-за содержания " +"скомпилированных расширений." #: ../source/guides/distributing-packages-using-setuptools.rst:597 msgid "" @@ -4642,6 +4714,10 @@ msgid "" "build a wheel that's named such that it's only usable on the platform that " "it was built on. For details on the naming of wheel files, see :pep:`425`." msgstr "" +"Пакет ``wheel`` определит, что код не является чистым Python, и создаст " +"колесо, названное так, что его можно использовать только на той платформе, " +"на которой оно было создано. Подробнее об именовании файлов wheel смотрите в " +":pep:`425`." #: ../source/guides/distributing-packages-using-setuptools.rst:603 msgid "" @@ -4649,6 +4725,9 @@ msgid "" "platform wheels for Windows, macOS, and the multi-distro ``manylinux*`` ABI. " "Details of the latter are defined in :pep:`513`." msgstr "" +":term:`PyPI ` в настоящее время поддерживает " +"загрузку платформенных колес для Windows, macOS и мульти-дистро " +"``manylinux*`` ABI. Подробности о последнем определены в :pep:`513`." #: ../source/guides/distributing-packages-using-setuptools.rst:611 msgid "Uploading your Project to PyPI" @@ -4660,6 +4739,9 @@ msgid "" "`` was created under your project's root directory. That's where you'll find " "your distribution file(s) to upload." msgstr "" +"Когда вы выполнили команду создания дистрибутива, под корневым каталогом " +"вашего проекта был создан новый каталог ``dist/``. Именно в ней вы найдете " +"файл(ы) дистрибутива для загрузки." #: ../source/guides/distributing-packages-using-setuptools.rst:617 msgid "" @@ -4668,6 +4750,10 @@ msgid "" "or the configuration in your :file:`setup.py` file, you will need to rebuild " "these files again before you can distribute the changes to PyPI." msgstr "" +"Эти файлы создаются только тогда, когда вы выполняете команду создания " +"дистрибутива. Это означает, что при любом изменении исходного кода проекта " +"или конфигурации в файле :file:`setup.py` вам нужно будет заново создать эти " +"файлы, прежде чем вы сможете распространить изменения в PyPI." #: ../source/guides/distributing-packages-using-setuptools.rst:622 msgid "" @@ -4676,6 +4762,10 @@ msgid "" "basis. See :ref:`using-test-pypi` on how to setup your configuration in " "order to use it." msgstr "" +"Перед выпуском на основной PyPI-репо, вы можете предпочесть тренировку на `" +"PyPI test site `_, который чистится на " +"полурегулярной основе. Смотрите :ref:`using-test-pypi` о том, как настроить " +"свою конфигурацию для его использования." #: ../source/guides/distributing-packages-using-setuptools.rst:627 msgid "" @@ -4685,6 +4775,12 @@ msgid "" "HTTP or unverified HTTPS connection on some Python versions, allowing your " "username and password to be intercepted during transmission." msgstr "" +"На других ресурсах вы можете встретить упоминания об использовании ``python " +"setup.py register`` и ``python setup.py upload``. Эти методы регистрации и " +"загрузки пакетов **настоятельно не рекомендуются**, поскольку в некоторых " +"версиях Python они могут использовать HTTP-соединение с открытым текстом или " +"непроверенное HTTPS-соединение, что позволяет перехватить ваши имя " +"пользователя и пароль во время передачи." #: ../source/guides/distributing-packages-using-setuptools.rst:633 msgid "" @@ -4695,6 +4791,13 @@ msgid "" "long descriptions provided in :file:`setup.py` are valid. You can do this " "by running :std:doc:`twine check ` on your package files:" msgstr "" +"Парсер reStructuredText, используемый на PyPI, - это **не** Sphinx! Кроме " +"того, для обеспечения безопасности всех пользователей, некоторые виды URL и " +"директив запрещены или удалены (например, директива ``...raw::``). **Перед " +"тем, как** попытаться загрузить свой дистрибутив, вы должны проверить, " +"действительны ли ваши краткие/длинные описания, указанные в :file:`setup.py`" +". Это можно сделать, выполнив :std:doc:`twine check ` для файлов " +"вашего пакета:" #: ../source/guides/distributing-packages-using-setuptools.rst:646 msgid "Create an account" @@ -4706,12 +4809,17 @@ msgid "" "You can create an account `using the form on the PyPI website `_." msgstr "" +"Во-первых, вам нужна учетная запись пользователя :term:`PyPI `. Вы можете создать учетную запись, используя форму на сайте " +"PyPI `_." #: ../source/guides/distributing-packages-using-setuptools.rst:652 msgid "" "Now you'll create a PyPI `API token`_ so you will be able to securely upload " "your project." msgstr "" +"Теперь вы создадите токен PyPI `API token`_, чтобы иметь возможность " +"безопасно загружать свой проект." #: ../source/guides/distributing-packages-using-setuptools.rst:655 msgid "" @@ -4719,22 +4827,29 @@ msgid "" "token`_; don't limit its scope to a particular project, since you are " "creating a new project." msgstr "" +"Перейдите на https://pypi.org/manage/account/#api-tokens и создайте новый " +"`API-токен`_; не ограничивайте его область действия конкретным проектом, " +"поскольку вы создаете новый проект." #: ../source/guides/distributing-packages-using-setuptools.rst:659 msgid "" "**Don't close the page until you have copied and saved the token — you won't " "see that token again.**" msgstr "" +"**Не закрывайте страницу, пока не скопируете и не сохраните токен - больше " +"вы его не увидите**" #: ../source/guides/distributing-packages-using-setuptools.rst:662 msgid "" "To avoid having to copy and paste the token every time you upload, you can " "create a :file:`$HOME/.pypirc` file:" msgstr "" +"Чтобы не копировать и не вставлять токен при каждой загрузке, вы можете " +"создать файл :file:`$HOME/.pypirc`:" #: ../source/guides/distributing-packages-using-setuptools.rst:671 msgid "**Be aware that this stores your token in plaintext.**" -msgstr "" +msgstr "**Помните, что при этом ваш токен хранится в открытом виде**" #: ../source/guides/distributing-packages-using-setuptools.rst:673 #: ../source/guides/migrating-to-pypi-org.rst:74 @@ -4743,6 +4858,8 @@ msgstr "" msgid "" "For more details, see the :ref:`specification ` for :file:`.pypirc`." msgstr "" +"Более подробную информацию см. в :ref:`спецификации ` для :file:`." +"pypirc`." #: ../source/guides/distributing-packages-using-setuptools.rst:679 msgid "Upload your distributions" @@ -4753,6 +4870,8 @@ msgid "" "Once you have an account you can upload your distributions to :term:`PyPI " "` using :ref:`twine`." msgstr "" +"После создания учетной записи вы можете загружать свои дистрибутивы в :term:`" +"PyPI `, используя :ref:`twine`." #: ../source/guides/distributing-packages-using-setuptools.rst:684 msgid "" @@ -4760,12 +4879,17 @@ msgid "" "the project already exists on PyPI - if it doesn't exist yet, it will be " "automatically created when the first release is uploaded." msgstr "" +"Процесс загрузки релиза одинаков вне зависимости от того, существует ли уже " +"проект на PyPI - если его еще нет, он будет автоматически создан при " +"загрузке первого релиза." #: ../source/guides/distributing-packages-using-setuptools.rst:688 msgid "" "For the second and subsequent releases, PyPI only requires that the version " "number of the new release differ from any previous releases." msgstr "" +"Для второго и последующих релизов PyPI требует только, чтобы номер версии " +"нового релиза отличался от всех предыдущих релизов." #: ../source/guides/distributing-packages-using-setuptools.rst:695 msgid "" @@ -4774,6 +4898,10 @@ msgid "" "the name of your project that you uploaded. It may take a minute or two for " "your project to appear on the site." msgstr "" +"Вы можете убедиться, что ваш пакет успешно загружен, перейдя по URL-адресу " +"``https://pypi.org/project/``, где ``sampleproject`` - это " +"имя загруженного вами проекта. Возможно, потребуется минута или две, чтобы " +"ваш проект появился на сайте." #: ../source/guides/distributing-packages-using-setuptools.rst:702 #: ../source/tutorials/installing-packages.rst:670 @@ -4782,6 +4910,10 @@ msgid "" "ref:`pip` is currently considering changing this by `making user installs " "the default behavior `_." msgstr "" +"В зависимости от вашей платформы, для этого может потребоваться доступ root " +"или администратора. :ref:`pip` в настоящее время рассматривает возможность " +"изменить это, сделав пользовательскую установку поведением по умолчанию " +"`_." #: ../source/guides/dropping-older-python-versions.rst:5 msgid "Dropping support for older Python versions" @@ -4792,6 +4924,9 @@ msgid "" "Dropping support for older Python versions is supported by the standard :ref:" "`core-metadata` 1.2 specification via a \"Requires-Python\" attribute." msgstr "" +"Отказ от поддержки старых версий Python поддерживается стандартной " +"спецификацией :ref:`core-metadata` 1.2 с помощью атрибута \"Requires-Python\"" +"." #: ../source/guides/dropping-older-python-versions.rst:9 msgid "" @@ -4800,12 +4935,19 @@ msgid "" "version in the package metadata. If they do not match, it will attempt to " "install the last package distribution that supported that Python runtime." msgstr "" +"Клиенты с метаданными 1.2+, такие как Pip 9.0+, будут придерживаться этой " +"спецификации, определяя текущую среду выполнения Python и сравнивая ее с " +"требуемой версией в метаданных пакета. Если они не совпадают, то будет " +"предпринята попытка установить последний дистрибутив пакета, который " +"поддерживал данную среду выполнения Python." #: ../source/guides/dropping-older-python-versions.rst:12 msgid "" "This mechanism can be used to drop support for older Python versions, by " "amending the \"Requires-Python\" attribute in the package metadata." msgstr "" +"Этот механизм можно использовать для отказа от поддержки старых версий " +"Python, изменив атрибут \"Requires-Python\" в метаданных пакета." #: ../source/guides/dropping-older-python-versions.rst:14 msgid "" @@ -4813,6 +4955,10 @@ msgid "" "tools such as ``flit`` may offer similar functionality but users will need " "to consult relevant documentation." msgstr "" +"Это руководство предназначено специально для пользователей :ref:`setuptools`" +", другие инструменты упаковки, такие как ``flit``, могут предлагать " +"аналогичную функциональность, но пользователям необходимо обратиться к " +"соответствующей документации." #: ../source/guides/dropping-older-python-versions.rst:17 msgid "Requirements" @@ -4840,7 +4986,7 @@ msgstr "" #: ../source/guides/dropping-older-python-versions.rst:26 msgid "Dealing with the universal wheels" -msgstr "" +msgstr "Работа с универсальными колесами" #: ../source/guides/dropping-older-python-versions.rst:28 msgid "" @@ -4851,12 +4997,20 @@ msgid "" "often configured within :file:`setup.cfg` under the ``[bdist_wheel]`` " "section by setting ``universal = 1`` if they use setuptools." msgstr "" +"Традиционно проекты, предоставляющие Python код, который семантически " +"совместим как с Python 2, так и Python 3, производят :термин: \" колеса " +"`, которые имеют тег ``py2.py3`` в своих именах. При отказе от " +"поддержки Python 2 важно не забывать об изменении этого тега только на " +"``py3``. Он часто настраивается в :file:`setup.cfg` под ``[bdist_wheel]`` " +"раздел путем установки ``universal = 1``, если они используют setuptools." #: ../source/guides/dropping-older-python-versions.rst:36 msgid "" "If you use this method, either remove this option or section, or explicitly " "set ``universal`` to ``0``:" msgstr "" +"Если вы используете этот метод, либо удалите эту опцию или секцию, либо явно " +"установите ``universal`` в ``0``:" #: ../source/guides/dropping-older-python-versions.rst:48 msgid "" @@ -4864,6 +5018,8 @@ msgid "" "flags, make sure that your scripts don't have ``--universal`` in your " "package creation scripts." msgstr "" +"Поскольку настройки :file:`setup.cfg` можно переопределить с помощью флагов " +"CLI, убедитесь, что в ваших скриптах создания пакетов нет ``--universal``." #: ../source/guides/dropping-older-python-versions.rst:53 msgid "Defining the Python version required" @@ -4883,7 +5039,7 @@ msgstr "" #: ../source/guides/dropping-older-python-versions.rst:60 msgid "Steps:" -msgstr "" +msgstr "Шаги:" #: ../source/guides/dropping-older-python-versions.rst:74 msgid "``setuptools`` version should be above 24.0.0." @@ -4898,6 +5054,8 @@ msgid "" "You can specify version ranges and exclusion rules, such as at least Python " "3. Or, Python 2.7, 3.4 and beyond." msgstr "" +"Можно указать диапазоны версий и правила исключения, например, не менее " +"Python 3. Или Python 2.7, 3.4 и далее." #: ../source/guides/dropping-older-python-versions.rst:81 msgid "Examples:" @@ -4909,6 +5067,9 @@ msgid "" "file:`setup.py` script. This will insert the ``Requires-Python`` metadata " "values based on the argument you provide in ``python_requires``." msgstr "" +"Установить эти значения можно с помощью вызова ``setup`` в вашем скрипте " +":file:`setup.py``. Он вставит значения метаданных ``Requires-Python`` на " +"основе аргумента, указанного в ``python_requires``." #: ../source/guides/dropping-older-python-versions.rst:103 msgid "3. Validating the Metadata before publishing" @@ -4919,6 +5080,8 @@ msgid "" "Within a Python source package (the zip or the tar-gz file you download) is " "a text file called PKG-INFO." msgstr "" +"Внутри исходного пакета Python (zip- или tar-gz-файла, который вы скачиваете)" +" находится текстовый файл PKG-INFO." #: ../source/guides/dropping-older-python-versions.rst:107 msgid "" @@ -4926,25 +5089,33 @@ msgid "" "generates the source package. The file contains a set of keys and values, " "the list of keys is part of the PyPa standard metadata format." msgstr "" +"Этот файл генерируется :ref:`distutils` или :ref:`setuptools` при создании " +"исходного пакета. Файл содержит набор ключей и значений, список ключей " +"является частью стандартного формата метаданных PyPa." #: ../source/guides/dropping-older-python-versions.rst:110 msgid "You can see the contents of the generated file like this:" -msgstr "" +msgstr "Вы можете увидеть содержимое сгенерированного файла следующим образом:" #: ../source/guides/dropping-older-python-versions.rst:116 msgid "Validate that the following is in place, before publishing the package:" msgstr "" +"Перед публикацией пакета убедитесь, что все перечисленное ниже на месте:" #: ../source/guides/dropping-older-python-versions.rst:118 msgid "" "If you have upgraded correctly, the Metadata-Version value should be 1.2 or " "higher." msgstr "" +"Если вы выполнили обновление правильно, значение Метаданные-версия должно " +"быть 1.2 или выше." #: ../source/guides/dropping-older-python-versions.rst:119 msgid "" "The Requires-Python field is set and matches your specification in setup.py." msgstr "" +"Поле Requires-Python установлено и соответствует вашей спецификации в файле " +"setup.py." #: ../source/guides/dropping-older-python-versions.rst:122 msgid "4. Using Twine to publish" @@ -4955,10 +5126,13 @@ msgid "" "Twine has a number of advantages, apart from being faster it is now the " "supported method for publishing packages." msgstr "" +"Twine имеет ряд преимуществ, кроме того, что он быстрее, теперь это " +"поддерживаемый метод для публикации пакетов." #: ../source/guides/dropping-older-python-versions.rst:126 msgid "Make sure you are using the newest version of Twine, at least 1.9." msgstr "" +"Убедитесь, что вы используете новейшую версию Twine, по крайней мере, 1,9." #: ../source/guides/dropping-older-python-versions.rst:129 msgid "Dropping a Python release" @@ -4969,16 +5143,22 @@ msgid "" "Once you have published a package with the Requires-Python metadata, you can " "then make a further update removing that Python runtime from support." msgstr "" +"После того, как вы опубликовали пакет с метаданными Needs-Python, вы можете " +"сделать еще одно обновление, удалив время выполнения Python из поддержки." #: ../source/guides/dropping-older-python-versions.rst:133 msgid "It must be done in this order for the automated fallback to work." msgstr "" +"Чтобы автоматический откат сработал, его нужно выполнить именно в таком " +"порядке." #: ../source/guides/dropping-older-python-versions.rst:135 msgid "" "For example, you published the Requires-Python: \">=2.7\" as version 1.0.0 " "of your package." msgstr "" +"Например, вы опубликовали Needs-Python: «>=2.7» в качестве версии 1.0.0 " +"вашего пакета." #: ../source/guides/dropping-older-python-versions.rst:137 msgid "" @@ -4987,10 +5167,14 @@ msgid "" "2.7 will have version 1.0.0 of the package installed, and any >=3.5 users " "will receive version 2.0.0." msgstr "" +"Если вы обновите строку версии до \">=3.5\" и опубликуете новую версию 2.0.0 " +"вашего пакета, у всех пользователей, работающих с Pip 9.0+ с версии 2.7, " +"будет установлена версия 1.0.0 пакета, а все пользователи >=3.5 получат " +"версию 2.0.0." #: ../source/guides/hosting-your-own-index.rst:5 msgid "Hosting your own simple repository" -msgstr "" +msgstr "Создание собственного простого хранилища" #: ../source/guides/hosting-your-own-index.rst:8 msgid "" @@ -4999,6 +5183,11 @@ msgid "" "the proper directory structure and use any web server that can serve static " "files and generate an autoindex." msgstr "" +"Если вы хотите разместить свой собственный простой репозиторий [1]_, вы " +"можете использовать пакет программного обеспечения, например:doc:`devpi " +"` или вы можете просто создать правильную структуру каталога и " +"использовать любой веб-сервер, который может обслуживать статические файлы и " +"генерировать автоиндекс." #: ../source/guides/hosting-your-own-index.rst:13 msgid "" @@ -5006,6 +5195,10 @@ msgid "" "your user's default repositories, you should instruct them in your project's " "description to configure their installer appropriately. For example with pip:" msgstr "" +"В любом случае, поскольку вы будете размещать репозитории, которые, " +"вероятно, не находятся в хранилищах по умолчанию вашего пользователя, вы " +"должны инструктировать их в описании вашего проекта, чтобы настроить их " +"установщик соответствующим образом. Например, с pip:" #: ../source/guides/hosting-your-own-index.rst:29 msgid "" @@ -5013,10 +5206,14 @@ msgid "" "with valid HTTPS. At this time, the security of your user's installations " "depends on all repositories using a valid HTTPS setup." msgstr "" +"Кроме того, **высоко** рекомендуется, чтобы вы служили своему репозиторию с " +"действительным HTTPS. В настоящее время безопасность установок вашего " +"пользователя зависит от всех репозиториев, использующих действительную " +"настройку HTTP." #: ../source/guides/hosting-your-own-index.rst:35 msgid "\"Manual\" repository" -msgstr "" +msgstr "Хранилище \"Руководство\"" #: ../source/guides/hosting-your-own-index.rst:37 msgid "" @@ -5027,6 +5224,12 @@ msgid "" "projects \"Foo\" (with the versions 1.0 and 2.0) and \"bar\" (with the " "version 0.1) You should end up with a structure that looks like::" msgstr "" +"Схема каталогов довольно проста: в корневом каталоге необходимо создать " +"каталог для каждого проекта. Этот каталог должен быть :ref:`нормализованным " +"именем <имя-нормализация>` проекта. Внутри каждой из этих директорий просто " +"разместите все загружаемые файлы. Если у вас есть проекты \"Foo\" (с " +"версиями 1.0 и 2.0) и \"bar\" (с версией 0.1), то в итоге у вас должна " +"получиться структура, которая выглядит следующим образом::" #: ../source/guides/hosting-your-own-index.rst:50 msgid "" @@ -5035,12 +5238,19 @@ msgid "" "server in `Twisted`_, you would simply run ``twistd -n web --path .`` and " "then instruct users to add the URL to their installer's configuration." msgstr "" +"Как только вы получите эту схему, просто настройте свой веб-сервер на " +"обслуживание корневого каталога с включенным автоиндексом. Для примера, " +"используя встроенный веб-сервер в `Twisted`_, вы просто запустите ``twistd -" +"n web --path .``, а затем попросите пользователей добавить URL в " +"конфигурацию их программы установки." #: ../source/guides/hosting-your-own-index.rst:57 msgid "" "For complete documentation of the simple repository protocol, see :ref:" "`simple repository API `." msgstr "" +"Полную документацию по протоколу простого репозитория смотрите в :ref:`" +"simple repository API `." #: ../source/guides/index.rst:4 msgid "" @@ -5048,10 +5258,13 @@ msgid "" "are already familiar with the basics of Python packaging. If you're looking " "for an introduction to packaging, see :doc:`/tutorials/index`." msgstr "" +"**Руководства** направлены на выполнение конкретной задачи и предполагают, " +"что вы уже знакомы с основами упаковки в Python. Если вы ищете введение в " +"упаковку, смотрите :doc:`/tutorials/index`." #: ../source/guides/index-mirrors-and-caches.rst:5 msgid "Package index mirrors and caches" -msgstr "" +msgstr "Зеркала и кэш индексов пакетов" #: ../source/guides/index-mirrors-and-caches.rst:8 #: ../source/guides/supporting-multiple-python-versions.rst:10 @@ -5064,36 +5277,46 @@ msgid "" "installation, allow offline work, handle corporate firewalls or just plain " "Internet flakiness." msgstr "" +"Зеркалирование или кэширование PyPI можно использовать для ускорения " +"локальной установки пакетов, для работы в оффлайне, для работы с " +"корпоративными брандмауэрами или просто для работы в Интернете." #: ../source/guides/index-mirrors-and-caches.rst:14 msgid "Three options are available in this area:" -msgstr "" +msgstr "В этой области доступны три варианта:" #: ../source/guides/index-mirrors-and-caches.rst:16 msgid "pip provides local caching options," -msgstr "" +msgstr "pip предоставляет возможности локального кэширования," #: ../source/guides/index-mirrors-and-caches.rst:17 msgid "" "devpi provides higher-level caching option, potentially shared amongst many " "users or machines, and" msgstr "" +"devpi предоставляет возможность кэширования более высокого уровня, " +"потенциально разделяемого между многими пользователями или машинами, и" #: ../source/guides/index-mirrors-and-caches.rst:19 msgid "" "bandersnatch provides a local complete mirror of all PyPI :term:`packages " "`." msgstr "" +"bandersnatch предоставляет локальное полное зеркало всех PyPI :term:`" +"packages `." #: ../source/guides/index-mirrors-and-caches.rst:24 msgid "Caching with pip" -msgstr "" +msgstr "Кэширование с помощью pip" #: ../source/guides/index-mirrors-and-caches.rst:26 msgid "" "pip provides a number of facilities for speeding up installation by using " "local cached copies of :term:`packages `:" msgstr "" +"pip предоставляет ряд возможностей для ускорения установки за счет " +"использования локальных кэшированных копий :term:`packages `:" #: ../source/guides/index-mirrors-and-caches.rst:29 msgid "" @@ -5101,16 +5324,22 @@ msgid "" "downloading all the requirements for a project and then pointing pip at " "those downloaded files instead of going to PyPI." msgstr "" +":ref:`Быстрая и локальная установка ` за " +"счет загрузки всех требований для проекта и последующего указания pip на эти " +"загруженные файлы вместо обращения к PyPI." #: ../source/guides/index-mirrors-and-caches.rst:32 msgid "" "A variation on the above which pre-builds the installation files for the " "requirements using :ref:`python3 -m pip wheel `:" msgstr "" +"Вариант вышеописанного, который предварительно собирает установочные файлы в " +"соответствии с требованиями, используя :ref:`python3 -m pip wheel `:" #: ../source/guides/index-mirrors-and-caches.rst:42 msgid "Caching with devpi" -msgstr "" +msgstr "Кэширование с помощью devpi" #: ../source/guides/index-mirrors-and-caches.rst:44 msgid "" @@ -5118,10 +5347,13 @@ msgid "" "machine you know will always be available to you. See the `devpi " "documentation for getting started`__." msgstr "" +"devpi - это кэширующий прокси-сервер, который вы запускаете на своем " +"ноутбуке или другой машине, которая, как вы знаете, всегда будет доступна " +"для вас. Для начала работы смотрите документацию `devpi`." #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Complete mirror with bandersnatch" -msgstr "" +msgstr "Зеркало в комплекте с бандерснатчем" #: ../source/guides/index-mirrors-and-caches.rst:54 msgid "" @@ -5129,6 +5361,9 @@ msgid "" "` (externally-hosted packages are not mirrored). See " "the `bandersnatch documentation for getting that going`__." msgstr "" +"bandersnatch создаст полное локальное зеркало всех пакетов PyPI :term:`" +"packages ` (пакеты, размещенные на внешних хостингах, " +"не зеркалируются). См. документацию `bandersnatch о том, как это сделать`__." #: ../source/guides/index-mirrors-and-caches.rst:60 msgid "" @@ -5137,6 +5372,10 @@ msgid "" "bandersnatch which will only cache :term:`packages ` " "hosted on PyPI." msgstr "" +"Преимущество devpi в том, что он создаст зеркало, включающее :term:`пакеты " +"`, которые являются внешними по отношению к PyPI, в " +"отличие от bandersnatch, который будет кэшировать только :term:`пакеты " +"`, размещенные на PyPI." #: ../source/guides/installing-scientific-packages.rst:5 msgid "Installing scientific packages" @@ -5149,6 +5388,10 @@ msgid "" "kinds of hardware, or to interoperate with different pieces of external " "software." msgstr "" +"Научное программное обеспечение, как правило, имеет более сложные " +"зависимости, чем большинство других, и часто имеет несколько вариантов " +"сборки, чтобы использовать преимущества различных видов оборудования или " +"взаимодействовать с различными частями внешнего программного обеспечения." #: ../source/guides/installing-scientific-packages.rst:13 msgid "" @@ -5158,6 +5401,11 @@ msgid "" "libraries, and can take advantage of different levels of vectorised " "instructions available in modern CPUs." msgstr "" +"В частности, `NumPy `__, который является основой для " +"большинства программ в научном стеке Python `" +"_, может быть настроен на взаимодействие с различными библиотеками FORTRAN и " +"может использовать преимущества различных уровней векторизованных " +"инструкций, доступных в современных процессорах." #: ../source/guides/installing-scientific-packages.rst:19 msgid "" @@ -5168,6 +5416,13 @@ msgid "" "netlib.org/atlas/>`__ BLAS/LAPACK library, restricted to SSE2 instructions, " "so they may not provide optimal linear algebra performance." msgstr "" +"Начиная с версии 1.10.4 NumPy и версии 1.0.0 SciPy, на PyPI доступны " +"предварительно собранные 32- и 64-битные двоичные файлы в формате ``колеса'' " +"для всех основных операционных систем (Windows, macOS и Linux). Обратите " +"внимание, однако, что в Windows двоичные файлы NumPy скомпонованы с " +"библиотекой BLAS/LAPACK `ATLAS `__, " +"ограниченной инструкциями SSE2, поэтому они могут не обеспечивать " +"оптимальную производительность линейной алгебры." #: ../source/guides/installing-scientific-packages.rst:26 msgid "" @@ -5176,10 +5431,14 @@ msgid "" "environment to install from source and don't provide pre-built wheel files " "on PyPI)." msgstr "" +"Существует несколько альтернативных вариантов получения научных библиотек " +"Python (или любых других библиотек Python, которые требуют среды компиляции " +"для установки из исходного кода и не предоставляют предварительно собранные " +"файлы wheel на PyPI)." #: ../source/guides/installing-scientific-packages.rst:32 msgid "Building from source" -msgstr "" +msgstr "Создание из исходников" #: ../source/guides/installing-scientific-packages.rst:34 msgid "" @@ -5189,6 +5448,11 @@ msgid "" "to spend the time wrangling compilers and linkers for both C and FORTRAN, " "building from source is always an option." msgstr "" +"Та же сложность, которая затрудняет распространение NumPy (и многих " +"проектов, зависящих от него) в виде файлов на колесах, также затрудняет их " +"самостоятельную сборку из исходных текстов. Однако для смельчаков, готовых " +"потратить время на работу с компиляторами и компоновщиками для C и FORTRAN, " +"сборка из исходных текстов - это всегда вариант." #: ../source/guides/installing-scientific-packages.rst:42 msgid "Linux distribution packages" @@ -5200,6 +5464,9 @@ msgid "" "versions of various pieces of scientific software, including NumPy and other " "parts of the scientific Python stack." msgstr "" +"Для пользователей Linux в системном менеджере пакетов часто есть " +"предварительно скомпилированные версии различных научных программ, включая " +"NumPy и другие части научного стека Python." #: ../source/guides/installing-scientific-packages.rst:48 msgid "" @@ -5208,6 +5475,10 @@ msgid "" "distributions installed into the system Python when using virtual " "environments)." msgstr "" +"Если использование версий, возраст которых может составлять несколько " +"месяцев, допустимо, то это, скорее всего, будет хорошим вариантом (только не " +"забудьте разрешить доступ к дистрибутивам, установленным в системе Python, " +"при использовании виртуальных сред)." #: ../source/guides/installing-scientific-packages.rst:54 msgid "Windows installers" @@ -5220,12 +5491,19 @@ msgid "" "download page. Using these installers allows users to avoid the need to set " "up a suitable environment to build extensions locally." msgstr "" +"Многие Python-проекты, которые в настоящее время не публикуют (или не могут " +"опубликовать) файлы wheel, по крайней мере, публикуют инсталляторы для " +"Windows, либо на PyPI, либо на странице загрузки проекта. Использование этих " +"инсталляторов позволяет пользователям избежать необходимости создавать " +"подходящее окружение для локальной сборки расширений." #: ../source/guides/installing-scientific-packages.rst:61 msgid "" "The extensions provided in these installers are typically compatible with " "the CPython Windows installers published on python.org." msgstr "" +"Расширения, предоставляемые в этих установщиках, обычно совместимы с " +"установщиками CPython для Windows, опубликованными на python.org." #: ../source/guides/installing-scientific-packages.rst:64 msgid "" @@ -5235,6 +5513,11 @@ msgid "" "Python when using virtual environments is a common approach to working " "around this limitation." msgstr "" +"Как и в случае с системными пакетами Linux, программы установки Windows " +"будут устанавливаться только в системную установку Python - они не " +"поддерживают установку в виртуальных средах. Предоставление доступа к " +"дистрибутивам, установленным в системный Python, при использовании " +"виртуальных сред - распространенный подход к обходу этого ограничения." #: ../source/guides/installing-scientific-packages.rst:70 msgid "" @@ -5242,10 +5525,13 @@ msgid "" "subcommand that can convert a Windows :command:`bdist_wininst` installer to " "a wheel." msgstr "" +"Проект :term:`Wheel` также предоставляет подкоманду :command:`wheel convert`" +", которая может преобразовать установщик Windows :command:`bdist_wininst` в " +"wheel." #: ../source/guides/installing-scientific-packages.rst:77 msgid "macOS installers and package managers" -msgstr "" +msgstr "Установщики и менеджеры пакетов macOS" #: ../source/guides/installing-scientific-packages.rst:79 msgid "" @@ -5253,6 +5539,9 @@ msgid "" "macOS installers that are compatible with the macOS CPython binaries " "published on python.org." msgstr "" +"Как и в случае с Windows, многие проекты (включая NumPy) публикуют " +"инсталляторы для macOS, совместимые с двоичными файлами macOS CPython, " +"опубликованными на python.org." #: ../source/guides/installing-scientific-packages.rst:83 msgid "" @@ -5260,6 +5549,10 @@ msgid "" "such as ``Homebrew``. The SciPy site has more details on using Homebrew to " "`install SciPy on macOS `_." msgstr "" +"Пользователи macOS также имеют доступ к пакетным менеджерам в стиле " +"дистрибутива Linux, таким как ``Homebrew``. На сайте SciPy есть более " +"подробная информация об использовании Homebrew для `установки SciPy на macOS " +"`_." #: ../source/guides/installing-scientific-packages.rst:89 msgid "SciPy distributions" @@ -5271,12 +5564,17 @@ msgid "" "#distributions>`_ that provide the full SciPy stack to end users in an easy " "to use and update format." msgstr "" +"На сайте SciPy перечислены `несколько дистрибутивов `_, которые предоставляют полный стек SciPy конечным " +"пользователям в удобном для использования и обновления формате." #: ../source/guides/installing-scientific-packages.rst:96 msgid "" "Some of these distributions may not be compatible with the standard ``pip`` " "and ``virtualenv`` based toolchain." msgstr "" +"Некоторые из этих дистрибутивов могут быть несовместимы со стандартным " +"инструментарием на базе ``pip`` и ``virtualenv``." #: ../source/guides/installing-scientific-packages.rst:100 #: ../source/key_projects.rst:675 @@ -5294,6 +5592,15 @@ msgid "" "destructive; installing a new version of one package does not break existing " "installations, so many configurations can coexist on the same system." msgstr "" +"`Spack `_ - это гибкий менеджер пакетов, " +"разработанный для поддержки множества версий, конфигураций, платформ и " +"компиляторов. Он был создан для удовлетворения потребностей крупных " +"суперкомпьютерных центров и команд разработчиков научных приложений, которым " +"часто приходится собирать программное обеспечение разными способами. Spack " +"не ограничивается Python; он может устанавливать пакеты для ``C``, ``C++``, " +"``Fortran``, ``R`` и других языков. Spack является неразрушающим; установка " +"новой версии одного пакета не нарушает существующие установки, поэтому на " +"одной системе может сосуществовать множество конфигураций." #: ../source/guides/installing-scientific-packages.rst:110 msgid "" @@ -5304,6 +5611,13 @@ msgid "" "single package file. Spack also generates *module* files so that packages " "can be loaded and unloaded from the user's environment." msgstr "" +"Spack предлагает простой, но мощный синтаксис, который позволяет " +"пользователям лаконично указывать версии и параметры конфигурации. Файлы " +"пакетов написаны на чистом Python, и они сконструированы таким образом, " +"чтобы в одном файле пакета можно было легко менять местами компиляторы, " +"реализации зависимостей (например, MPI), версии и параметры сборки. Spack " +"также генерирует файлы *модулей*, чтобы пакеты можно было загружать и " +"выгружать из окружения пользователя." #: ../source/guides/installing-scientific-packages.rst:119 msgid "The conda cross-platform package manager" @@ -5317,6 +5631,12 @@ msgid "" "Anaconda, about 200 packages are installed by default, and a total of " "400-500 can be installed and updated from the Anaconda repository." msgstr "" +"Anaconda `_ - дистрибутив " +"Python, опубликованный компанией Anaconda, Inc. Он представляет собой " +"стабильную коллекцию пакетов с открытым исходным кодом для работы с большими " +"данными и научного использования. В релизе 5.0 Anaconda по умолчанию " +"установлено около 200 пакетов, а всего из репозитория Anaconda можно " +"установить и обновить 400-500 пакетов." #: ../source/guides/installing-scientific-packages.rst:127 msgid "" @@ -5334,10 +5654,24 @@ msgid "" "packages. Conda is available in Anaconda and Miniconda (an easy-to-install " "download with just Python and conda)." msgstr "" +"``conda`` - это система управления пакетами с открытым исходным кодом (" +"лицензия BSD) и система управления окружением, входящая в состав Anaconda, " +"которая позволяет пользователям устанавливать несколько версий бинарных " +"программных пакетов и их зависимостей, а также легко переключаться между " +"ними. Это кроссплатформенный инструмент, работающий в Windows, macOS и " +"Linux. Conda можно использовать для упаковки и распространения всех видов " +"пакетов, она не ограничивается только пакетами Python. Она имеет полную " +"поддержку собственных виртуальных сред. Conda делает окружения " +"первоклассными гражданами, позволяя легко создавать независимые окружения " +"даже для библиотек на Си. Она написана на Python, но является Python-" +"агностичной. Conda управляет самим Python как пакетом, поэтому возможна " +"команда :`conda update python`, в отличие от pip, который управляет только " +"пакетами Python. Conda доступна в версиях Anaconda и Miniconda (простая в " +"установке загрузка, содержащая только Python и conda)." #: ../source/guides/installing-stand-alone-command-line-tools.rst:2 msgid "Installing stand alone command line tools" -msgstr "" +msgstr "Установка отдельных инструментов командной строки" #: ../source/guides/installing-stand-alone-command-line-tools.rst:4 msgid "" @@ -5345,6 +5679,10 @@ msgid "" "are `mypy `_, `flake8 `_, `black `_, and :ref:`pipenv`." msgstr "" +"Многие пакеты предоставляют приложения командной строки. Примерами таких " +"пакетов являются: `mypy `_, `flake8 " +"`_, `black `_ " +"и :ref:`pipenv`." #: ../source/guides/installing-stand-alone-command-line-tools.rst:10 msgid "" @@ -5353,6 +5691,10 @@ msgid "" "global environment can cause version conflicts and break dependencies the " "operating system has on Python packages." msgstr "" +"Обычно вы хотите иметь доступ к этим приложениям из любой точки системы, но " +"установка пакетов и их зависимостей в одно и то же глобальное окружение " +"может привести к конфликту версий и нарушению зависимостей операционной " +"системы от пакетов Python." #: ../source/guides/installing-stand-alone-command-line-tools.rst:15 msgid "" @@ -5362,26 +5704,36 @@ msgid "" "uninstalled without causing conflicts with other packages, and allows you to " "safely run the applications from anywhere." msgstr "" +":ref:`pipx` решает эту проблему, создавая виртуальное окружение для каждого " +"пакета, а также обеспечивая доступ к его приложениям через каталог, который " +"находится в вашем ``$PATH``. Это позволяет обновлять или удалять каждый " +"пакет, не вызывая конфликтов с другими пакетами, и позволяет безопасно " +"запускать приложения из любого места." #: ../source/guides/installing-stand-alone-command-line-tools.rst:21 msgid "pipx only works with Python 3.6+." -msgstr "" +msgstr "pipx работает только с Python 3.6+." #: ../source/guides/installing-stand-alone-command-line-tools.rst:23 msgid "pipx is installed with pip:" -msgstr "" +msgstr "pipx устанавливается вместе с pip:" #: ../source/guides/installing-stand-alone-command-line-tools.rst:41 msgid "" "``ensurepath`` ensures that the application directory is on your ``$PATH``. " "You may need to restart your terminal for this update to take effect." msgstr "" +"``ensurepath`` гарантирует, что каталог приложения находится в вашем " +"``$PATH``. Возможно, вам потребуется перезапустить терминал, чтобы " +"обновление вступило в силу." #: ../source/guides/installing-stand-alone-command-line-tools.rst:44 msgid "" "Now you can install packages with ``pipx install`` and run the package's " "applications(s) from anywhere." msgstr "" +"Теперь вы можете устанавливать пакеты с помощью ``pipx install`` и запускать " +"приложения пакета из любого места." #: ../source/guides/installing-stand-alone-command-line-tools.rst:52 #: ../source/specifications/entry-points.rst:114 @@ -5393,28 +5745,34 @@ msgid "" "To see a list of packages installed with pipx and which applications are " "available, use ``pipx list``:" msgstr "" +"Чтобы посмотреть список пакетов, установленных с помощью pipx, и доступных " +"приложений, используйте ``pipx list``:" #: ../source/guides/installing-stand-alone-command-line-tools.rst:95 msgid "To upgrade or uninstall a package:" -msgstr "" +msgstr "Чтобы обновить или удалить пакет:" #: ../source/guides/installing-stand-alone-command-line-tools.rst:102 msgid "pipx can be upgraded or uninstalled with pip:" -msgstr "" +msgstr "pipx можно обновить или удалить с помощью pip:" #: ../source/guides/installing-stand-alone-command-line-tools.rst:118 msgid "" "pipx also allows you to install and run the latest version of an application " "in a temporary, ephemeral environment. For example:" msgstr "" +"pipx также позволяет установить и запустить последнюю версию приложения во " +"временной, эфемерной среде. Например:" #: ../source/guides/installing-stand-alone-command-line-tools.rst:125 msgid "To see the full list of commands pipx offers, run:" msgstr "" +"Чтобы увидеть полный список команд, которые предлагает pipx, выполните " +"команду:" #: ../source/guides/installing-stand-alone-command-line-tools.rst:131 msgid "You can learn more about pipx at https://pipx.pypa.io/." -msgstr "" +msgstr "Подробнее о pipx можно узнать на сайте https://pipx.pypa.io/." #: ../source/guides/installing-using-linux-tools.rst:5 msgid "Installing pip/setuptools/wheel with Linux Package Managers" @@ -5422,13 +5780,15 @@ msgstr "Установка pip/setuptools/wheel через менеджеры п #: ../source/guides/installing-using-linux-tools.rst:8 msgid "2021-07-26" -msgstr "" +msgstr "2021-07-26" #: ../source/guides/installing-using-linux-tools.rst:10 msgid "" "This section covers how to install :ref:`pip`, :ref:`setuptools`, and :ref:" "`wheel` using Linux package managers." msgstr "" +"В этом разделе рассказывается о том, как установить :ref:`pip`, " +":ref:`setuptools` и :ref:`wheel` с помощью менеджеров пакетов Linux." #: ../source/guides/installing-using-linux-tools.rst:13 msgid "" @@ -5436,6 +5796,9 @@ msgid "" "python.org>`_, then this section does not apply. See the :ref:" "`installing_requirements` section instead." msgstr "" +"Если вы используете Python, загруженный с сайта `python.org `_, то этот раздел не применим. Вместо этого смотрите раздел " +":ref:`installing_requirements`." #: ../source/guides/installing-using-linux-tools.rst:17 msgid "" @@ -5446,6 +5809,13 @@ msgid "" "there are additional repositories that can be enabled to provide newer " "versions. The repositories we know about are explained below." msgstr "" +"Обратите внимание, что обычно версии :ref:`pip`, :ref:`setuptools` и " +":ref:`wheel`, поддерживаемые конкретным дистрибутивом Linux, устаревают к " +"моменту его публичного выпуска, а обновления обычно происходят только по " +"соображениям безопасности, а не для обновления функций. Для некоторых " +"дистрибутивов существуют дополнительные репозитории, которые могут быть " +"включены для получения более новых версий. Репозитории, о которых мы знаем, " +"описаны ниже." #: ../source/guides/installing-using-linux-tools.rst:24 msgid "" @@ -5455,6 +5825,11 @@ msgid "" "original unpatched versions. When this is known, we will make note of it " "below." msgstr "" +"Также обратите внимание, что дистрибутивы нередко применяют исправления в " +"целях безопасности и приведения их в соответствие с собственными " +"стандартами. В некоторых случаях это может привести к ошибкам или " +"неожиданному поведению, отличающемуся от первоначальных непропатченных " +"версий. Когда об этом станет известно, мы сообщим об этом ниже." #: ../source/guides/installing-using-linux-tools.rst:31 msgid "Fedora" @@ -5465,6 +5840,8 @@ msgid "" "To learn more about Python in Fedora, please visit the `official Fedora " "docs`_, `Python Classroom`_ or `Fedora Loves Python`_." msgstr "" +"Чтобы узнать больше о Python в Fedora, посетите `официальную документацию " +"Fedora`_, `Python Classroom`_ или `Fedora Loves Python`_." #: ../source/guides/installing-using-linux-tools.rst:45 msgid "CentOS/RHEL" @@ -5475,10 +5852,12 @@ msgid "" "CentOS and RHEL don't offer :ref:`pip` or :ref:`wheel` in their core " "repositories, although :ref:`setuptools` is installed by default." msgstr "" +"CentOS и RHEL не предлагают :ref:`pip` или :ref:`wheel` в своих основных " +"репозиториях, хотя :ref:`setuptools` установлен по умолчанию." #: ../source/guides/installing-using-linux-tools.rst:50 msgid "To install pip and wheel for the system Python, there are two options:" -msgstr "" +msgstr "Чтобы установить pip и wheel для системы Python, есть два варианта:" #: ../source/guides/installing-using-linux-tools.rst:52 msgid "" @@ -5487,12 +5866,19 @@ msgid "" "#how_can_i_use_these_extra_packages>`__. On EPEL 7, you can install pip and " "wheel like so:" msgstr "" +"Включите репозиторий EPEL `_, используя " +"эти инструкции `__. На EPEL 7 вы можете установить pip " +"и wheel следующим образом:" #: ../source/guides/installing-using-linux-tools.rst:61 msgid "" "Since EPEL only offers extra, non-conflicting packages, EPEL does not offer " "setuptools, since it's in the core repository." msgstr "" +"Поскольку EPEL предлагает только дополнительные, не противоречащие друг " +"другу пакеты, EPEL не предлагает setuptools, поскольку он находится в " +"основном репозитории." #: ../source/guides/installing-using-linux-tools.rst:65 msgid "" @@ -5501,6 +5887,10 @@ msgid "" "Infrastructure/Fedorahosted-retirement>`__ [1]_. You can install pip and " "wheel like so:" msgstr "" +"Включите `PyPA Copr Repo `_, используя `эти инструкции `__ [1]_. Вы можете установить pip и " +"wheel следующим образом:" #: ../source/guides/installing-using-linux-tools.rst:74 msgid "To additionally upgrade setuptools, run:" @@ -5511,26 +5901,32 @@ msgid "" "To install pip, wheel, and setuptools, in a parallel, non-system environment " "(using yum) then there are two options:" msgstr "" +"Чтобы установить pip, wheel и setuptools в параллельном, несистемном " +"окружении (с помощью yum), есть два варианта:" #: ../source/guides/installing-using-linux-tools.rst:85 msgid "" "Use the \"Software Collections\" feature to enable a parallel collection " "that includes pip, setuptools, and wheel." msgstr "" +"Используйте функцию \"Коллекции программ\", чтобы включить параллельную " +"коллекцию, включающую pip, setuptools и wheel." #: ../source/guides/installing-using-linux-tools.rst:88 msgid "" "For Redhat, see here: https://developers.redhat.com/products/" "softwarecollections/overview" msgstr "" +"Для Redhat смотрите здесь: https://developers.redhat.com/products/" +"softwarecollections/overview" #: ../source/guides/installing-using-linux-tools.rst:90 msgid "For CentOS, see here: https://github.com/sclorg" -msgstr "" +msgstr "Для CentOS смотрите здесь: https://github.com/sclorg" #: ../source/guides/installing-using-linux-tools.rst:92 msgid "Be aware that collections may not contain the most recent versions." -msgstr "" +msgstr "Помните, что коллекции могут содержать не самые последние версии." #: ../source/guides/installing-using-linux-tools.rst:94 msgid "" @@ -5539,23 +5935,27 @@ msgid "" "Pythons, along with pip, setuptools, and wheel, which are kept fairly up to " "date." msgstr "" +"Включите `IUS-репозиторий `_ и установите один из `" +"параллельно устанавливаемых `_ Pythons, а также pip, setuptools и wheel, которые поддерживаются " +"в актуальном состоянии." #: ../source/guides/installing-using-linux-tools.rst:100 msgid "For example, for Python 3.4 on CentOS7/RHEL7:" -msgstr "" +msgstr "Например, для Python 3.4 на CentOS7/RHEL7:" #: ../source/guides/installing-using-linux-tools.rst:108 msgid "openSUSE" msgstr "openSUSE" #: ../source/guides/installing-using-linux-tools.rst:118 -#, fuzzy msgid "Debian/Ubuntu and derivatives" -msgstr "Debian/Ubuntu" +msgstr "Debian/Ubuntu и производные" #: ../source/guides/installing-using-linux-tools.rst:120 msgid "Firstly, update and refresh repository lists by running this command:" msgstr "" +"Во-первых, обновите и дополните списки репозиториев, выполнив эту команду:" #: ../source/guides/installing-using-linux-tools.rst:129 msgid "" @@ -5563,6 +5963,10 @@ msgid "" "`_ by default, " "which is a significant behavior change that can be surprising to some users." msgstr "" +"В последних версиях Debian/Ubuntu pip был модифицирован, чтобы по умолчанию " +"использовать `\"Схему пользователя\" `_, что является значительным изменением " +"поведения, которое может быть неожиданным для некоторых пользователей." #: ../source/guides/installing-using-linux-tools.rst:135 msgid "Arch Linux" @@ -5573,6 +5977,9 @@ msgid "" "Currently, there is no \"copr\" yum plugin available for CentOS/RHEL, so the " "only option is to manually place the repo files as described." msgstr "" +"В настоящее время для CentOS/RHEL не существует плагина yum \"copr\", " +"поэтому единственным вариантом является ручное размещение файлов репо, как " +"описано выше." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:2 msgid "Install packages in a virtual environment using pip and venv" @@ -5584,30 +5991,34 @@ msgid "" "the standard library's virtual environment tool :ref:`venv` and install " "packages. The guide covers how to:" msgstr "" +"В этом руководстве рассказывается о том, как создать и активировать " +"виртуальную среду с помощью инструмента виртуальной среды стандартной " +"библиотеки :ref:`venv` и установить пакеты. В руководстве рассказывается о " +"том, как:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:8 -#, fuzzy msgid "Create and activate a virtual environment" -msgstr "Создание виртуальных окружений" +msgstr "Создание и активация виртуальной среды" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:9 #: ../source/guides/installing-using-pip-and-virtual-environments.rst:153 msgid "Prepare pip" -msgstr "" +msgstr "Подготовьте pip" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:10 msgid "Install packages into a virtual environment using the ``pip`` command" -msgstr "" +msgstr "Установка пакетов в виртуальную среду с помощью команды ``pip``" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:11 -#, fuzzy msgid "Use and create a requirements file" -msgstr "Использование файлов требований" +msgstr "Использование и создание файла требований" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:14 msgid "" "This guide applies to supported versions of Python, currently 3.8 and higher." msgstr "" +"Это руководство относится к поддерживаемым версиям Python, в настоящее время " +"3.8 и выше." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:18 msgid "" @@ -5616,6 +6027,10 @@ msgid "" "from the term :term:`Import Package` which refers to import modules in your " "Python source code." msgstr "" +"В этом руководстве используется термин **упаковка** для обозначения термина " +":термин: \" Пакет распределения \" , который обычно устанавливается из " +"внешнего хоста. Это отличается от термина :term:`Import Package', который " +"относится к модулям импорта в исходном коде Python." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:25 msgid "" @@ -5624,16 +6039,19 @@ msgid "" "your operating system's package manager to install Python, please ensure " "that Python is installed before proceeding with these steps." msgstr "" +"Это руководство содержит обязательное условие - использование официальной " +"версии Python, полученной по адресу . " +"Если вы используете менеджер пакетов вашей операционной системы для " +"установки Python, пожалуйста, убедитесь, что Python установлен, прежде чем " +"приступать к выполнению этих шагов." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:32 -#, fuzzy msgid "Create and Use Virtual Environments" -msgstr "Создание виртуальных окружений" +msgstr "Создание и использование виртуальных сред" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:35 -#, fuzzy msgid "Create a new virtual environment" -msgstr "Создание виртуальных окружений" +msgstr "Создайте новую виртуальную среду" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:37 msgid "" @@ -5644,12 +6062,20 @@ msgid "" "from the virtual environment since packages can be installed confidently and " "will not interfere with another project's environment." msgstr "" +":ref:`venv` (для Python 3) позволяет управлять отдельными установками " +"пакетов для разных проектов. Она создает \"виртуальную\" изолированную " +"установку Python. При смене проекта вы можете создать новую виртуальную " +"среду, изолированную от других виртуальных сред. Вы получаете преимущество " +"от виртуальной среды, так как пакеты можно устанавливать уверенно и они не " +"будут мешать среде другого проекта." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:45 msgid "" "It is recommended to use a virtual environment when working with third party " "packages." msgstr "" +"При работе с пакетами сторонних производителей рекомендуется использовать " +"виртуальную среду." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:48 msgid "" @@ -5657,28 +6083,34 @@ msgid "" "following command. This will create a new virtual environment in a local " "folder named ``.venv``:" msgstr "" +"Чтобы создать виртуальную среду, перейдите в каталог вашего проекта и " +"выполните следующую команду. Это создаст новое виртуальное окружение в " +"локальной папке с именем ``.venv``:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:64 msgid "" "The second argument is the location to create the virtual environment. " "Generally, you can just create this in your project and call it ``.venv``." msgstr "" +"Второй аргумент - это место создания виртуального окружения. Как правило, вы " +"можете просто создать его в своем проекте и назвать ``.venv``." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:67 msgid "" "``venv`` will create a virtual Python installation in the ``.venv`` folder." -msgstr "" +msgstr "``venv`` создаст виртуальную установку Python в папке ``.venv``." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:69 msgid "" "You should exclude your virtual environment directory from your version " "control system using ``.gitignore`` or similar." msgstr "" +"Вы должны исключить каталог виртуального окружения из системы контроля " +"версий с помощью ``.gitignore`` или аналогичного инструмента." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:74 -#, fuzzy msgid "Activate a virtual environment" -msgstr "Создание виртуальных окружений" +msgstr "Активация виртуальной среды" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:76 msgid "" @@ -5687,18 +6119,26 @@ msgid "" "will put the virtual environment-specific ``python`` and ``pip`` executables " "into your shell's ``PATH``." msgstr "" +"Прежде чем вы начнете устанавливать или использовать пакеты в виртуальной " +"среде, ее нужно будет ``активировать``. Активация виртуальной среды поместит " +"специфические для виртуальной среды исполняемые файлы ``python`` и ``pip`` в " +"``PATH`` вашей оболочки." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:93 msgid "" "To confirm the virtual environment is activated, check the location of your " "Python interpreter:" msgstr "" +"Чтобы убедиться, что виртуальная среда активирована, проверьте расположение " +"вашего интерпретатора Python:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:108 msgid "" "While the virtual environment is active, the above command will output a " "filepath that includes the ``.venv`` directory, by ending with the following:" msgstr "" +"Пока виртуальная среда активна, приведенная выше команда выведет путь к " +"файлу, включающий каталог ``.venv``, заканчивающийся следующим образом:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:124 msgid "" @@ -5706,28 +6146,34 @@ msgid "" "that specific environment. This enables you to import and use packages in " "your Python application." msgstr "" +"Пока виртуальная среда активирована, pip будет устанавливать пакеты в эту " +"среду. Это позволит вам импортировать и использовать пакеты в вашем " +"приложении Python." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:130 -#, fuzzy msgid "Deactivate a virtual environment" -msgstr "Создание виртуальных окружений" +msgstr "Деактивация виртуальной среды" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:132 msgid "" "If you want to switch projects or leave your virtual environment, " "``deactivate`` the environment:" msgstr "" +"Если вы хотите сменить проект или покинуть виртуальную среду, " +"``деактивируйте`` среду:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:140 msgid "" "Closing your shell will deactivate the virtual environment. If you open a " "new shell window and want to use the virtual environment, reactivate it." msgstr "" +"Закрытие оболочки приведет к деактивации виртуальной среды. Если вы откроете " +"новое окно оболочки и захотите использовать виртуальную среду, активируйте " +"ее снова." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:145 -#, fuzzy msgid "Reactivate a virtual environment" -msgstr "Создание виртуальных окружений" +msgstr "Повторная активация виртуальной среды" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:147 msgid "" @@ -5735,12 +6181,17 @@ msgid "" "instructions about activating a virtual environment. There's no need to " "create a new virtual environment." msgstr "" +"Если вы хотите повторно активировать существующую виртуальную среду, " +"следуйте тем же инструкциям по активации виртуальной среды. Создавать новую " +"виртуальную среду не нужно." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:155 msgid "" ":ref:`pip` is the reference Python package manager. It's used to install and " "update packages into a virtual environment." msgstr "" +":ref:`pip` - эталонный менеджер пакетов Python. Он используется для " +"установки и обновления пакетов в виртуальной среде." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:161 msgid "" @@ -5757,6 +6208,8 @@ msgid "" "Afterwards, you should have the latest version of pip installed in your user " "site:" msgstr "" +"После этого на вашем пользовательском сайте должна быть установлена " +"последняя версия pip:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:179 msgid "" @@ -5768,7 +6221,7 @@ msgstr "" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:187 msgid "Afterwards, you should have the latest version of pip:" -msgstr "" +msgstr "После этого у вас должна быть установлена последняя версия pip:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:195 msgid "Install packages using pip" @@ -5779,27 +6232,29 @@ msgid "" "When your virtual environment is activated, you can install packages. Use " "the ``pip install`` command to install packages." msgstr "" +"Когда ваша виртуальная среда активирована, вы можете устанавливать пакеты. " +"Для установки пакетов используйте команду ``pip install``." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:201 -#, fuzzy msgid "Install a package" -msgstr "Установка пакетов" +msgstr "Установить пакет" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:203 msgid "" "For example,let's install the `Requests`_ library from the :term:`Python " "Package Index (PyPI)`:" msgstr "" +"Например, давайте установим библиотеку `Requests`_ из :term:`Python Package " +"Index (PyPI)`:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:218 msgid "" "pip should download requests and all of its dependencies and install them:" -msgstr "" +msgstr "pip должен загружать запросы и все его зависимости и устанавливать их:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:239 -#, fuzzy msgid "Install a specific package version" -msgstr "Установка определённых версий" +msgstr "Установить конкретную версию пакета" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:241 msgid "" @@ -5807,36 +6262,42 @@ msgid "" "`version specifiers `. For example, to install a specific " "version of ``requests``:" msgstr "" +"pip позволяет указать, какую версию пакета следует установить, используя " +":term:`определители версии <Определитель версии>`. Например, чтобы " +"установить определенную версию пакета ``requests``:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:257 msgid "To install the latest ``2.x`` release of requests:" -msgstr "" +msgstr "Чтобы установить последний ``2.x`` выпуск requests:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:271 msgid "To install pre-release versions of packages, use the ``--pre`` flag:" msgstr "" +"Чтобы установить предварительные версии пакетов, используйте флаг ``--pre``:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:287 -#, fuzzy msgid "Install extras" -msgstr "Установка пакетов" +msgstr "Установка дополнительных" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:289 msgid "" "Some packages have optional `extras`_. You can tell pip to install these by " "specifying the extra in brackets:" msgstr "" +"Некоторые пакеты содержат дополнительные `extras`_. Вы можете указать pip на " +"их установку, указав в скобках дополнительное дополнение:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:309 -#, fuzzy msgid "Install a package from source" -msgstr "Установка из исходных кодов" +msgstr "Установите пакет из исходного кода" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:311 msgid "" "pip can install a package directly from its source code. For example, to " "install the source code in the ``google-auth`` directory:" msgstr "" +"pip может установить пакет непосредственно из его исходного кода. Например, " +"чтобы установить исходный код в каталог ``google-auth``:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:328 msgid "" @@ -5845,34 +6306,43 @@ msgid "" "directory will immediately affect the installed package without needing to " "re-install:" msgstr "" +"Кроме того, pip может устанавливать пакеты из исходного кода в :doc:`режиме " +"разработки `, что означает, что " +"изменения в каталоге исходного кода немедленно повлияют на установленный " +"пакет без необходимости повторной установки:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:347 -#, fuzzy msgid "Install from version control systems" -msgstr "Установка из систем управления версиями" +msgstr "Установка из систем контроля версий" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:349 msgid "" "pip can install packages directly from their version control system. For " "example, you can install directly from a git repository:" msgstr "" +"pip может устанавливать пакеты непосредственно из их системы контроля " +"версий. Например, вы можете установить пакет непосредственно из репозитория " +"git:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:356 msgid "" "For more information on supported version control systems and syntax, see " "pip's documentation on :ref:`VCS Support `." msgstr "" +"Дополнительную информацию о поддерживаемых системах контроля версий и " +"синтаксисе см. в документации pip по :ref:`VCS Support `." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:361 -#, fuzzy msgid "Install from local archives" -msgstr "Установка из локальных архивов" +msgstr "Установка из локального архива" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:363 msgid "" "If you have a local copy of a :term:`Distribution Package`'s archive (a zip, " "wheel, or tar file) you can install it directly with pip:" msgstr "" +"Если у вас есть локальная копия архива :term:`Distribution Package` (файл " +"zip, wheel или tar), вы можете установить его напрямую с помощью pip:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:378 msgid "" @@ -5880,6 +6350,9 @@ msgid "" "tell pip to look for packages there and not to use the :term:`Python Package " "Index (PyPI)` at all:" msgstr "" +"Если у вас есть каталог, содержащий архивы нескольких пакетов, вы можете " +"указать pip искать пакеты там и не использовать :term:`Python Package Index " +"(PyPI)` вообще:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:394 msgid "" @@ -5887,17 +6360,21 @@ msgid "" "connectivity or if you want to strictly control the origin of distribution " "packages." msgstr "" +"Это полезно, если вы устанавливаете пакеты на систему с ограниченными " +"возможностями подключения или хотите строго контролировать происхождение " +"дистрибутивных пакетов." #: ../source/guides/installing-using-pip-and-virtual-environments.rst:400 -#, fuzzy msgid "Install from other package indexes" -msgstr "Установка из других индексов" +msgstr "Установка из других индексов пакетов" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:402 msgid "" "If you want to download packages from a different index than the :term:" "`Python Package Index (PyPI)`, you can use the ``--index-url`` flag:" msgstr "" +"Если вы хотите загрузить пакеты из индекса, отличного от индекса :term:`" +"Python Package Index (PyPI)`, вы можете использовать флаг ``--index-url``:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:417 msgid "" @@ -5905,6 +6382,9 @@ msgid "" "(PyPI)` and a separate index, you can use the ``--extra-index-url`` flag " "instead:" msgstr "" +"Если вы хотите разрешить пакеты как из :term:`Python Package Index (PyPI)`, " +"так и из отдельного индекса, вы можете использовать флаг ``--extra-index-" +"url`` вместо этого:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:434 #: ../source/tutorials/installing-packages.rst:393 @@ -5916,11 +6396,12 @@ msgid "" "pip can upgrade packages in-place using the ``--upgrade`` flag. For example, " "to install the latest version of ``requests`` and all of its dependencies:" msgstr "" +"pip может обновлять пакеты на месте, используя флаг ``--upgrade``. Например, " +"для установки последней версии ``requests`` и всех его зависимостей:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:452 -#, fuzzy msgid "Using a requirements file" -msgstr "Использование файлов требований" +msgstr "Использование файла требований" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:454 msgid "" @@ -5928,12 +6409,16 @@ msgid "" "dependencies in a :ref:`Requirements File `. For " "example you could create a :file:`requirements.txt` file containing:" msgstr "" +"Вместо того чтобы устанавливать пакеты по отдельности, pip позволяет " +"объявить все зависимости в :ref:`Requirements File `" +". Например, вы можете создать файл :file:`requirements.txt`, содержащий:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:463 msgid "" "And tell pip to install all of the packages in this file using the ``-r`` " "flag:" msgstr "" +"И укажите pip установить все пакеты из этого файла, используя флаг ``-r``:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:478 msgid "Freezing dependencies" @@ -5944,10 +6429,12 @@ msgid "" "Pip can export a list of all installed packages and their versions using the " "``freeze`` command:" msgstr "" +"Pip может экспортировать список всех установленных пакетов и их версий с " +"помощью команды ``freeze``:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:495 msgid "Which will output a list of package specifiers such as:" -msgstr "" +msgstr "Что выведет список спецификаторов пакетов, например:" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:511 msgid "" @@ -5955,17 +6442,22 @@ msgid "" "Files` that can re-create the exact versions of all packages installed in an " "environment." msgstr "" +"Команда ``pip freeze`` полезна для создания :ref:`pip:Requirements Files``, " +"которые могут воссоздать точные версии всех пакетов, установленных в " +"окружении." #: ../source/guides/installing-using-virtualenv.rst:2 -#, fuzzy msgid "Installing packages using virtualenv" -msgstr "Установка virtualenv" +msgstr "Установка пакетов с помощью virtualenv" #: ../source/guides/installing-using-virtualenv.rst:4 msgid "" "This guide discusses how to install packages using :ref:`pip` and :ref:" "`virtualenv`, a tool to create isolated Python environments." msgstr "" +"В этом руководстве рассказывается о том, как устанавливать пакеты с помощью " +":ref:`pip` и :ref:`virtualenv`, инструмента для создания изолированных " +"окружений Python." #: ../source/guides/installing-using-virtualenv.rst:8 msgid "" @@ -5973,6 +6465,10 @@ msgid "" "under development. Please refer to the :ref:`virtualenv` documentation for " "details on installation and usage." msgstr "" +"Это руководство по установке пакетов и использованию :ref:`virtualenv` " +"находится в стадии разработки. Пожалуйста, обратитесь к документации по " +":ref:`virtualenv` для получения подробной информации об установке и " +"использовании." #: ../source/guides/installing-using-virtualenv.rst:13 msgid "" @@ -5980,6 +6476,9 @@ msgid "" "Package` which is different from an :term:`Import Package` that which is " "used to import modules in your Python source code." msgstr "" +"В этом документе термин **пакет** используется для обозначения :term:`" +"Distribution Package`, который отличается от :term:`Import Package`, который " +"используется для импорта модулей в исходный код Python." #: ../source/guides/making-a-pypi-friendly-readme.rst:2 msgid "Making a PyPI-friendly README" @@ -5992,6 +6491,10 @@ msgid "" "in a PyPI-friendly format and include your README in your package so it " "appears on PyPI." msgstr "" +"Файлы README могут помочь вашим пользователям понять ваш проект и могут быть " +"использованы для создания описания вашего проекта на PyPI. Это руководство " +"поможет вам создать README в удобном для PyPI формате и включить README в " +"ваш пакет, чтобы он появился на PyPI." #: ../source/guides/making-a-pypi-friendly-readme.rst:9 msgid "Creating a README file" @@ -6002,6 +6505,8 @@ msgid "" "README files for Python projects are often named ``README``, ``README.txt``, " "``README.rst``, or ``README.md``." msgstr "" +"Файлы README для проектов Python часто называются ``README``, ``README.txt``" +", ``README.rst`` или ``README.md``." #: ../source/guides/making-a-pypi-friendly-readme.rst:13 msgid "" @@ -6009,10 +6514,13 @@ msgid "" "supported by PyPI. Formats supported by `PyPI's README renderer `_ are:" msgstr "" +"Чтобы ваш README правильно отображался на PyPI, выберите язык разметки, " +"поддерживаемый PyPI. Форматы, поддерживаемые `PyPI's README renderer " +"`_, следующие:" #: ../source/guides/making-a-pypi-friendly-readme.rst:16 msgid "plain text" -msgstr "простой текст;" +msgstr "простой текст" #: ../source/guides/making-a-pypi-friendly-readme.rst:17 msgid "" @@ -6027,14 +6535,16 @@ msgid "" "Markdown (`GitHub Flavored Markdown `_ by " "default, or `CommonMark `_)" msgstr "" -"Формат текста Markdown (`GitHub Flavored Markdown `_ по умолчанию или `CommonMark `_)." +"текст в формате Markdown (`GitHub Flavored Markdown `_ по умолчанию или `CommonMark `_)" #: ../source/guides/making-a-pypi-friendly-readme.rst:21 msgid "" "It's customary to save your README file in the root of your project, in the " "same directory as your :file:`setup.py` file." msgstr "" +"Обычно файл README сохраняется в корне проекта, в той же директории, что и " +"файл :file:`setup.py`." #: ../source/guides/making-a-pypi-friendly-readme.rst:25 msgid "Including your README in your package's metadata" @@ -6046,6 +6556,9 @@ msgid "" "project's ``Description`` and ``Description-Content-Type`` metadata, " "typically in your project's :file:`setup.py` file." msgstr "" +"Чтобы включить содержимое README в описание пакета, установите метаданные " +"проекта ``Description`` и ``Description-Content-Type``, обычно в файле " +"проекта :file:`setup.py``." #: ../source/guides/making-a-pypi-friendly-readme.rst:33 msgid ":ref:`description-optional`" @@ -6060,6 +6573,9 @@ msgid "" "For example, to set these values in a package's :file:`setup.py` file, use " "``setup()``'s ``long_description`` and ``long_description_content_type``." msgstr "" +"Например, чтобы установить эти значения в файле пакета :file:`setup.py`, " +"используйте ``setup()`` ``long_description`` и " +"``long_description_content_type``." #: ../source/guides/making-a-pypi-friendly-readme.rst:39 msgid "" @@ -6068,16 +6584,22 @@ msgid "" "``Content-Type``-style value for your README file's markup, such as ``text/" "plain``, ``text/x-rst`` (for reStructuredText), or ``text/markdown``." msgstr "" +"Установите значение ``long_description`` в содержимое (не путь) самого файла " +"README. Установите значение ``long_description_content_type`` в принятый " +"стиль ``Content-Type`` для разметки вашего файла README, например ``text/" +"plain``, ``text/x-rst`` (для reStructuredText) или ``text/markdown``." #: ../source/guides/making-a-pypi-friendly-readme.rst:45 msgid "" "If you're using GitHub-flavored Markdown to write a project's description, " "ensure you upgrade the following tools:" msgstr "" +"Если для написания описания проекта вы используете Markdown со вкусом " +"GitHub, убедитесь, что вы обновили следующие инструменты:" #: ../source/guides/making-a-pypi-friendly-readme.rst:60 msgid "The minimum required versions of the respective tools are:" -msgstr "" +msgstr "Минимально необходимыми версиями соответствующих инструментов являются:" #: ../source/guides/making-a-pypi-friendly-readme.rst:62 msgid "``setuptools >= 38.6.0``" @@ -6096,6 +6618,8 @@ msgid "" "It's recommended that you use ``twine`` to upload the project's distribution " "packages:" msgstr "" +"Рекомендуется использовать ``twine`` для загрузки дистрибутивных пакетов " +"проекта:" #: ../source/guides/making-a-pypi-friendly-readme.rst:72 msgid "" @@ -6103,10 +6627,13 @@ msgid "" "file:`README.md` as ``long_description`` and identifies the markup as GitHub-" "flavored Markdown:" msgstr "" +"Например, смотрите этот файл :file:`setup.py`, который считывает содержимое " +":file:`README.md` как ``длинное_описание`` и идентифицирует разметку как " +"GitHub-flavored Markdown:" #: ../source/guides/making-a-pypi-friendly-readme.rst:94 msgid "Validating reStructuredText markup" -msgstr "" +msgstr "Проверка разметки reStructuredText" #: ../source/guides/making-a-pypi-friendly-readme.rst:96 msgid "" @@ -6114,6 +6641,9 @@ msgid "" "prevent it from rendering, causing PyPI to instead just show the README's " "raw source." msgstr "" +"Если ваш README написан на reStructuredText, то любая некорректная разметка " +"не позволит его отобразить, в результате чего PyPI просто покажет исходный " +"текст README." #: ../source/guides/making-a-pypi-friendly-readme.rst:99 msgid "" @@ -6123,27 +6653,39 @@ msgid "" "reference-label```\"), are not allowed here and will result in error " "messages like \"``Error: Unknown interpreted text role \"py:func\".``\"." msgstr "" +"Обратите внимание, что расширения Sphinx, используемые в документах, такие " +"как :doc:`directives ` и :doc:`" +"roles ` (например, \"" +"``:py:func:`getattr``\" или \"``:ref:`my-reference-label``\"), здесь " +"недопустимы и приведут к сообщениям об ошибках типа \"``Ошибка: Неизвестная " +"интерпретируемая текстовая роль \"py:func\".``\"." #: ../source/guides/making-a-pypi-friendly-readme.rst:104 msgid "" "You can check your README for markup errors before uploading as follows:" msgstr "" +"Вы можете проверить свой README на наличие ошибок разметки перед загрузкой " +"следующим образом:" #: ../source/guides/making-a-pypi-friendly-readme.rst:106 msgid "" "Install the latest version of `twine `_; " "version 1.12.0 or higher is required:" msgstr "" +"Установите последнюю версию `twine `_; " +"требуется версия 1.12.0 или выше:" #: ../source/guides/making-a-pypi-friendly-readme.rst:121 msgid "" "Build the sdist and wheel for your project as described under :ref:" "`Packaging Your Project`." msgstr "" +"Соберите sdist и wheel для вашего проекта, как описано в разделе :ref:`" +"Packaging Your Project`." #: ../source/guides/making-a-pypi-friendly-readme.rst:124 msgid "Run ``twine check`` on the sdist and wheel:" -msgstr "" +msgstr "Запустите ``twine check`` на sdist и wheel:" #: ../source/guides/making-a-pypi-friendly-readme.rst:130 msgid "" @@ -6151,6 +6693,9 @@ msgid "" "renders fine, the command will output ``Checking distribution FILENAME: " "Passed``." msgstr "" +"Эта команда сообщит о любых проблемах с рендерингом вашего README. Если " +"разметка отображается нормально, команда выведет ``Проверка дистрибутива " +"FILENAME: Пройдена``." #: ../source/guides/migrating-to-pypi-org.rst:6 msgid "Migrating to PyPI.org" @@ -6161,7 +6706,7 @@ msgstr "Переход на PyPI.org" #: ../source/guides/supporting-multiple-python-versions.rst:9 #: ../source/guides/supporting-windows-using-appveyor.rst:7 msgid "Obsolete" -msgstr "" +msgstr "Устаревшее" #: ../source/guides/migrating-to-pypi-org.rst:10 msgid "" @@ -6170,6 +6715,10 @@ msgid "" "expected to use. These are the tools and processes that people will need to " "interact with ``PyPI.org``." msgstr "" +":term:`pypi.org` - это новая, переработанная версия PyPI, которая заменила " +"устаревшую кодовую базу PyPI. Это версия PyPI по умолчанию, которую люди " +"должны использовать. Это инструменты и процессы, которые понадобятся людям " +"для взаимодействия с ``PyPI.org``." #: ../source/guides/migrating-to-pypi-org.rst:16 msgid "Publishing releases" @@ -6185,18 +6734,25 @@ msgid "" "Uploads through ``pypi.python.org`` were *switched off* on **July 3, 2017**. " "As of April 13th, 2018, ``pypi.org`` is the URL for PyPI." msgstr "" +"Загрузка через ``pypi.python.org`` была *отключена* с **июля 3 июля 2017 " +"года**. По состоянию на 13 апреля 2018 года URL-адресом PyPI является ``pypi." +"org``." #: ../source/guides/migrating-to-pypi-org.rst:23 msgid "" "The recommended way to migrate to PyPI.org for uploading is to ensure that " "you are using a new enough version of your upload tool." msgstr "" +"Рекомендуемый способ перехода на PyPI.org для загрузки - убедиться, что вы " +"используете достаточно новую версию вашего инструмента загрузки." #: ../source/guides/migrating-to-pypi-org.rst:26 msgid "" "The default upload settings switched to ``pypi.org`` in the following " "versions:" msgstr "" +"Настройки загрузки по умолчанию переключились на ``pypi.org`` в следующих " +"версиях:" #: ../source/guides/migrating-to-pypi-org.rst:28 msgid "``twine`` 1.8.0" @@ -6208,19 +6764,19 @@ msgstr "" #: ../source/guides/migrating-to-pypi-org.rst:30 msgid "Python 2.7.13 (``distutils`` update)" -msgstr "" +msgstr "Python 2.7.13 (обновление ``distutils``)" #: ../source/guides/migrating-to-pypi-org.rst:31 msgid "Python 3.4.6 (``distutils`` update)" -msgstr "" +msgstr "Python 3.4.6 (обновление ``distutils``)" #: ../source/guides/migrating-to-pypi-org.rst:32 msgid "Python 3.5.3 (``distutils`` update)" -msgstr "" +msgstr "Python 3.5.3 (обновление ``distutils``)" #: ../source/guides/migrating-to-pypi-org.rst:33 msgid "Python 3.6.0 (``distutils`` update)" -msgstr "" +msgstr "Python 3.6.0 (обновление ``distutils``)" #: ../source/guides/migrating-to-pypi-org.rst:35 msgid "" @@ -6230,12 +6786,19 @@ msgid "" "configured in a file located at :file:`$HOME/.pypirc`. If you see a file " "like:" msgstr "" +"Помимо того, что вы находитесь на достаточно новой версии инструмента, чтобы " +"его значение по умолчанию изменилось, вы также должны убедиться, что не " +"настроили инструмент на переопределение URL-адреса загрузки по умолчанию. " +"Обычно это настраивается в файле, расположенном по адресу :file:`$HOME/." +"pypirc`. Если вы видите файл вида:" #: ../source/guides/migrating-to-pypi-org.rst:52 msgid "" "Then simply delete the line starting with ``repository`` and you will use " "your upload tool's default URL." msgstr "" +"Затем просто удалите строку, начинающуюся с ``repository``, и вы будете " +"использовать URL по умолчанию вашего инструмента загрузки." #: ../source/guides/migrating-to-pypi-org.rst:55 msgid "" @@ -6244,12 +6807,18 @@ msgid "" "pypirc` and include the ``repository:`` line, but use the value ``https://" "upload.pypi.org/legacy/`` instead:" msgstr "" +"Если по каким-то причинам вы не можете обновить версию вашего инструмента до " +"версии, которая по умолчанию использует PyPI.org, то вы можете " +"отредактировать :file:`$HOME/.pypirc` и включить строку ``repository:``, но " +"вместо нее использовать значение ``https://upload.pypi.org/legacy/``:" #: ../source/guides/migrating-to-pypi-org.rst:71 msgid "" "(``legacy`` in this URL refers to the fact that this is the new server " "implementation's emulation of the legacy server implementation's upload API.)" msgstr "" +"(``legacy`` в этом URL означает, что это новая реализация сервера, " +"эмулирующая API загрузки старой реализации сервера)" #: ../source/guides/migrating-to-pypi-org.rst:77 msgid "Registering package names & metadata" @@ -6261,18 +6830,25 @@ msgid "" "command prior to the first upload is no longer required, and is not " "currently supported by the legacy upload API emulation on PyPI.org." msgstr "" +"Явная предварительная регистрация имен пакетов с помощью команды ``setup.py " +"register`` перед первой загрузкой больше не требуется, и в настоящее время " +"не поддерживается эмуляцией устаревшего API загрузки на PyPI.org." #: ../source/guides/migrating-to-pypi-org.rst:83 msgid "" "As a result, attempting explicit registration after switching to using PyPI." "org for uploads will give the following error message::" msgstr "" +"В результате попытка явной регистрации после перехода на использование " +"PyPI.org для загрузки приведет к следующему сообщению об ошибке::" #: ../source/guides/migrating-to-pypi-org.rst:88 msgid "" "The solution is to skip the registration step, and proceed directly to " "uploading artifacts." msgstr "" +"Решение состоит в том, чтобы пропустить шаг регистрации и перейти " +"непосредственно к загрузке артефактов." #: ../source/guides/migrating-to-pypi-org.rst:93 #: ../source/guides/using-testpypi.rst:5 @@ -6287,6 +6863,11 @@ msgid "" "``https://testpypi.python.org/pypi`` with ``https://test.pypi.org/legacy/``, " "for example:" msgstr "" +"Устаревший TestPyPI (testpypi.python.org) больше не доступен; вместо него " +"используйте `test.pypi.org `_. Если вы используете " +"TestPyPI, вы должны обновить свой :file:`$HOME/.pypirc` для соответствия " +"новому местоположению TestPyPI, заменив ``https://testpypi.python.org/pypi`` " +"на ``https://test.pypi.org/legacy/``, например:" #: ../source/guides/migrating-to-pypi-org.rst:117 msgid "Registering new user accounts" @@ -6298,6 +6879,9 @@ msgid "" "through ``pypi.python.org`` was *switched off* on **February 20, 2018**. New " "user registrations at ``pypi.org`` are open." msgstr "" +"Для того, чтобы помочь смягчить спам-атаки на PyPI, регистрация новых " +"пользователей через ``pypi.python.org`` была *отключена* с **февраля 20, " +"2018**. Регистрация новых пользователей на ``pypi.org`` открыта." #: ../source/guides/migrating-to-pypi-org.rst:125 msgid "Browsing packages" @@ -6310,6 +6894,10 @@ msgid "" "org``. The domain pypi.python.org now redirects to pypi.org, and may be " "disabled sometime in the future." msgstr "" +"Хотя ``pypi.python.org`` по-прежнему может использоваться в ссылках из " +"другой документации PyPA и т.д., по умолчанию для просмотра пакетов " +"используется интерфейс ``pypi.org``. Домен pypi.python.org сейчас " +"перенаправляет на pypi.org, и может быть отключен в будущем." #: ../source/guides/migrating-to-pypi-org.rst:134 msgid "Downloading packages" @@ -6317,7 +6905,7 @@ msgstr "Загрузка пакетов" #: ../source/guides/migrating-to-pypi-org.rst:136 msgid "``pypi.org`` is the default host for downloading packages." -msgstr "" +msgstr "``pypi.org`` является хостом по умолчанию для загрузки пакетов." #: ../source/guides/migrating-to-pypi-org.rst:139 msgid "Managing published packages and releases" @@ -6328,14 +6916,16 @@ msgid "" "``pypi.org`` provides a fully functional interface for logged in users to " "manage their published packages and releases." msgstr "" +"``pypi.org`` предоставляет полнофункциональный интерфейс для авторизованных " +"пользователей для управления своими опубликованными пакетами и релизами." #: ../source/guides/modernize-setup-py-project.rst:6 msgid "How to modernize a ``setup.py`` based project?" -msgstr "" +msgstr "Как модернизировать проект, основанный на ``setup.py``?" #: ../source/guides/modernize-setup-py-project.rst:10 msgid "Should ``pyproject.toml`` be added?" -msgstr "" +msgstr "Нужно ли добавить ``pyproject.toml``?" #: ../source/guides/modernize-setup-py-project.rst:12 msgid "" @@ -6344,11 +6934,16 @@ msgid "" "strongly recommended is the ``[build-system]`` table in :file:`pyproject." "toml`." msgstr "" +"Настоятельно рекомендуется наличие файла :term:`pyproject.toml`. Само по " +"себе наличие файла :file:`pyproject.toml` мало что дает. [#]_ Что " +"действительно настоятельно рекомендуется, так это таблица ``[build-system]`` " +"в :file:`pyproject.toml`." #: ../source/guides/modernize-setup-py-project.rst:16 msgid "" "Note that it has influence on the build isolation feature of pip, see below." msgstr "" +"Обратите внимание, что это влияет на функцию изоляции сборки в pip, см. ниже." #: ../source/guides/modernize-setup-py-project.rst:23 msgid "" @@ -6358,9 +6953,14 @@ msgid "" "deprecated and **MUST NOT** be run anymore, and their recommended " "replacement commands should be used instead:" msgstr "" +"Нет, :file:`setup.py` может существовать в современном проекте, основанном " +"на :ref:`setuptools`. Файл :term:`setup.py` является допустимым " +"конфигурационным файлом для setuptools, который, как оказалось, написан на " +"Python. Однако следующие команды устарели и **НЕ ДОЛЖНЫ** больше " +"выполняться, и вместо них следует использовать рекомендуемые " +"команды-заменители:" #: ../source/guides/modernize-setup-py-project.rst:36 -#, fuzzy msgid "``python -m build``" msgstr "``python -m build``" @@ -6370,14 +6970,14 @@ msgstr "``python -m build``" #: ../source/guides/modernize-setup-py-project.rst:129 #: ../source/guides/modernize-setup-py-project.rst:221 msgid "For more details:" -msgstr "" +msgstr "Более подробная информация:" #: ../source/guides/modernize-setup-py-project.rst:44 +#, fuzzy msgid ":ref:`setup-py-deprecated`" -msgstr "" +msgstr ":ref:`setup-py-deprecated`" #: ../source/guides/modernize-setup-py-project.rst:48 -#, fuzzy msgid "Where to start?" msgstr "С чего начать?" @@ -6386,6 +6986,9 @@ msgid "" "The :term:`project` must contain a :file:`pyproject.toml` file at the root " "of its source tree that contains a ``[build-system]`` table like so:" msgstr "" +"Термин :term:`project` должен содержать в корне дерева исходников файл " +":file:`pyproject.toml`, который содержит таблицу ``[build-system]``, как " +"показано ниже:" #: ../source/guides/modernize-setup-py-project.rst:60 msgid "" @@ -6393,32 +6996,39 @@ msgid "" "Frontend>` know that :ref:`setuptools` is the :term:`build backend ` for this project." msgstr "" +"Это стандартный способ сообщить :term:`build frontends ` о " +"том, что :ref:`setuptools` является :term:`build backend ` " +"для этого проекта." #: ../source/guides/modernize-setup-py-project.rst:63 msgid "" "Note that the presence of a :file:`pyproject.toml` file (even if empty) " "triggers :ref:`pip` to change its default behavior to use *build isolation*." msgstr "" +"Обратите внимание, что наличие файла :file:`pyproject.toml` (даже если он " +"пуст) заставляет :ref:`pip` изменить свое поведение по умолчанию на " +"использование *изоляции сборки*." #: ../source/guides/modernize-setup-py-project.rst:68 -#, fuzzy msgid ":ref:`distributing-packages`" msgstr ":ref:`distributing-packages`" #: ../source/guides/modernize-setup-py-project.rst:69 #: ../source/guides/modernize-setup-py-project.rst:113 +#, fuzzy msgid ":ref:`pyproject-build-system-table`" -msgstr "" +msgstr ":ref:`pyproject-build-system-table`" #: ../source/guides/modernize-setup-py-project.rst:70 #: ../source/guides/modernize-setup-py-project.rst:131 #: ../source/guides/modernize-setup-py-project.rst:247 +#, fuzzy msgid ":doc:`pip:reference/build-system/pyproject-toml`" -msgstr "" +msgstr ":doc:`pip:reference/build-system/pyproject-toml`" #: ../source/guides/modernize-setup-py-project.rst:74 msgid "How to handle additional build-time dependencies?" -msgstr "" +msgstr "Как обрабатывать дополнительные зависимости во время сборки?" #: ../source/guides/modernize-setup-py-project.rst:76 msgid "" @@ -6428,22 +7038,29 @@ msgid "" "frontend knows to install them when building the :term:`distributions " "`." msgstr "" +"Помимо самой setuptools, если :file:`setup.py` зависит от других сторонних " +"библиотек (вне стандартной библиотеки Python), они должны быть перечислены в " +"списке ``requires`` таблицы ``[build-system]``, чтобы фронтенд сборки знал, " +"что их нужно установить при сборке :term:`distributions `." #: ../source/guides/modernize-setup-py-project.rst:82 #: ../source/guides/modernize-setup-py-project.rst:139 #: ../source/guides/modernize-setup-py-project.rst:174 msgid "For example, a :file:`setup.py` file such as this:" -msgstr "" +msgstr "Например, файл :file:`setup.py` выглядит следующим образом:" #: ../source/guides/modernize-setup-py-project.rst:99 msgid "" "requires a :file:`pyproject.toml` file like this (:file:`setup.py` stays " "unchanged):" msgstr "" +"требует наличия такого файла :file:`pyproject.toml` (:file:`setup.py` " +"остается неизменным):" #: ../source/guides/modernize-setup-py-project.rst:117 msgid "What is the build isolation feature?" -msgstr "" +msgstr "Что такое изоляция сборки?" #: ../source/guides/modernize-setup-py-project.rst:119 msgid "" @@ -6451,20 +7068,23 @@ msgid "" "install only the build dependencies (and their dependencies) that are listed " "under ``build-system.requires`` and trigger the build in that environment." msgstr "" +"Обычно фронтенды сборки создают эфемерное виртуальное окружение, в котором " +"устанавливают только те зависимости сборки (и их зависимости), которые " +"перечислены в ``build-system.requires``, и запускают сборку в этом окружении." #: ../source/guides/modernize-setup-py-project.rst:124 msgid "" "For some projects this isolation is unwanted and it can be deactivated as " "follows:" msgstr "" +"Для некоторых проектов эта изоляция нежелательна, и ее можно отключить " +"следующим образом:" #: ../source/guides/modernize-setup-py-project.rst:126 -#, fuzzy msgid "``python -m build --no-isolation``" msgstr "``python -m build --no-isolation``" #: ../source/guides/modernize-setup-py-project.rst:127 -#, fuzzy msgid "``python -m install --no-build-isolation``" msgstr "``python -m install --no-build-isolation``" @@ -6477,44 +7097,55 @@ msgid "" "All static metadata can optionally be moved to a ``[project]`` table in :" "file:`pyproject.toml`." msgstr "" +"Все статические метаданные по желанию могут быть перенесены в таблицу " +"``[проект]`` в :file:`pyproject.toml`." #: ../source/guides/modernize-setup-py-project.rst:151 msgid "can be entirely replaced by a :file:`pyproject.toml` file like this:" msgstr "" +"может быть полностью заменен файлом :file:`pyproject.toml`, например, таким:" #: ../source/guides/modernize-setup-py-project.rst:164 msgid "" "Read :ref:`pyproject-project-table` for the full specification of the " "content allowed in the ``[project]`` table." msgstr "" +"Читайте :ref:`pyproject-project-table` для полной спецификации содержимого, " +"допустимого в таблице ``[project]``." #: ../source/guides/modernize-setup-py-project.rst:169 msgid "How to handle dynamic metadata?" -msgstr "" +msgstr "Как обрабатывать динамические метаданные?" #: ../source/guides/modernize-setup-py-project.rst:171 msgid "" "If some packaging metadata fields are not static they need to be listed as " "``dynamic`` in this ``[project]`` table." msgstr "" +"Если некоторые поля метаданных упаковки не являются статическими, их нужно " +"указать как ``динамические`` в этой таблице ``[проект]``." #: ../source/guides/modernize-setup-py-project.rst:191 msgid "can be modernized as follows:" -msgstr "" +msgstr "можно модернизировать следующим образом:" #: ../source/guides/modernize-setup-py-project.rst:223 +#, fuzzy msgid ":ref:`declaring-project-metadata-dynamic`" -msgstr "" +msgstr ":ref:`declaring-project-metadata-dynamic`" #: ../source/guides/modernize-setup-py-project.rst:227 msgid "What if something that can not be changed expects a ``setup.py`` file?" msgstr "" +"Что делать, если что-то, что нельзя изменить, ожидает файл ``setup.py``?" #: ../source/guides/modernize-setup-py-project.rst:229 msgid "" "For example, a process exists that can not be changed easily and it needs to " "execute a command such as ``python setup.py --name``." msgstr "" +"Например, существует процесс, который нельзя легко изменить, и ему нужно " +"выполнить команду типа ``python setup.py --name``." #: ../source/guides/modernize-setup-py-project.rst:232 msgid "" @@ -6522,15 +7153,18 @@ msgid "" "tree even after all its content has been moved to :file:`pyproject.toml`. " "This file can be as minimalistic as this:" msgstr "" +"Совершенно нормально оставлять файл :file:`setup.py` в дереве исходников " +"проекта даже после того, как все его содержимое было перемещено в " +":file:`pyproject.toml`. Этот файл может быть таким минималистичным:" #: ../source/guides/modernize-setup-py-project.rst:246 -#, fuzzy msgid ":ref:`pyproject-toml-spec`" -msgstr "Спецификация точек входа" +msgstr ":ref:`pyproject-toml-spec`" #: ../source/guides/modernize-setup-py-project.rst:248 +#, fuzzy msgid ":doc:`setuptools:build_meta`" -msgstr "" +msgstr ":doc:`setuptools:build_meta`" #: ../source/guides/multi-version-installs.rst:6 msgid "Multi-version installs" @@ -6543,6 +7177,10 @@ msgid "" "must ``require`` the appropriate version of the project at run time (using " "``pkg_resources``)." msgstr "" +"easy_install позволяет одновременно устанавливать различные версии одного и " +"того же проекта в единое окружение, разделяемое несколькими программами, " +"которые должны ``требовать`` соответствующую версию проекта во время " +"выполнения (используя ``pkg_resources``)." #: ../source/guides/multi-version-installs.rst:16 msgid "" @@ -6552,6 +7190,10 @@ msgid "" "environment shared by multiple applications, such as the system Python in a " "Linux distribution." msgstr "" +"Для многих случаев использования виртуальные среды решают эту задачу без " +"усложнения директивы ``require``. Однако преимущество параллельной установки " +"в одной среде заключается в том, что она работает для среды, разделяемой " +"несколькими приложениями, например, для системы Python в дистрибутиве Linux." #: ../source/guides/multi-version-installs.rst:22 msgid "" @@ -6567,6 +7209,18 @@ msgid "" "available by default, so the subsequent ``require`` call in your own code " "fails with a spurious version conflict." msgstr "" +"Основное ограничение параллельной установки на основе ``pkg_resources`` " +"заключается в том, что как только вы импортируете ``pkg_resources``, он " +"фиксирует *default* версию всего, что уже доступно в sys.path. Это может " +"вызвать проблемы, поскольку скрипты командной строки, созданные " +"``setuptools``, используют ``pkg_resources`` для поиска точки входа для " +"выполнения. Это означает, что, например, вы не сможете использовать тесты " +"``require``, вызываемые через ``nose``, или приложения WSGI, вызываемые " +"через ``gunicorn``, если вашему приложению нужна версия, отличная от той, " +"что доступна по умолчанию в стандартном ``sys.path`` - скриптовая обертка " +"для основного приложения заблокирует версию, доступную по умолчанию, и " +"последующий вызов ``require`` в вашем собственном коде завершится с ложным " +"конфликтом версий." #: ../source/guides/multi-version-installs.rst:34 msgid "" @@ -6577,12 +7231,21 @@ msgid "" "script or use ``python3 -c ''`` to invoke the application's main " "entry point directly." msgstr "" +"Это можно обойти, установив все зависимости в ``__main__.__requires__`` " +"перед первым импортом ``pkg_resources``, но такой подход означает, что " +"стандартные вызовы командной строки соответствующих инструментов не могут " +"быть использованы - необходимо написать собственный сценарий-обертку или " +"использовать ``python3 -c ''`` для прямого вызова основной точки " +"входа приложения." #: ../source/guides/multi-version-installs.rst:41 msgid "" "Refer to the `pkg_resources documentation `__ for more details." msgstr "" +"За более подробной информацией обратитесь к документации по `pkg_resources " +"`__." #: ../source/guides/packaging-binary-extensions.rst:5 msgid "Packaging binary extensions" @@ -6600,6 +7263,12 @@ msgid "" "to create importable C extensions that allow things which aren't always easy " "to achieve in pure Python code." msgstr "" +"Одна из особенностей эталонного интерпретатора CPython заключается в том, " +"что, помимо возможности выполнения кода Python, он также предоставляет " +"богатый C API для использования другими программами. Одно из наиболее " +"распространенных применений этого C API - создание импортируемых расширений " +"C, которые позволяют делать вещи, которые не всегда легко реализовать в " +"чистом коде Python." #: ../source/guides/packaging-binary-extensions.rst:18 msgid "An overview of binary extensions" @@ -6607,13 +7276,15 @@ msgstr "Обзор двоичных расширений" #: ../source/guides/packaging-binary-extensions.rst:21 msgid "Use cases" -msgstr "" +msgstr "Варианты использования" #: ../source/guides/packaging-binary-extensions.rst:23 msgid "" "The typical use cases for binary extensions break down into just three " "conventional categories:" msgstr "" +"Типичные случаи использования бинарных расширений делятся всего на три " +"условные категории:" #: ../source/guides/packaging-binary-extensions.rst:26 msgid "" @@ -6628,6 +7299,16 @@ msgid "" "github.com/python/cpython/blob/main/Modules/_datetimemodule.c>`_) is not " "available." msgstr "" +"**Модули ускорителей**: эти модули полностью автономны и создаются " +"исключительно для того, чтобы работать быстрее, чем эквивалентный код на " +"чистом Python в CPython. В идеале, модули-ускорители всегда должны иметь " +"эквивалент на чистом Python, который можно использовать в качестве запасного " +"варианта, если ускоренная версия недоступна на данной системе. В стандартной " +"библиотеке CPython широко используются модули-ускорители. *Пример*: При " +"импорте ``datetime`` Python возвращается к модулю ``datetime.py " +"`_, если " +"реализация на C ( ``_datetimemodule.c `_) недоступна." #: ../source/guides/packaging-binary-extensions.rst:37 msgid "" @@ -6640,6 +7321,14 @@ msgid "" "module wrapper for `_functoolsmodule.c `_." msgstr "" +"**модули-обертки**: эти модули создаются для раскрытия существующих " +"интерфейсов C в коде Python. Они могут либо напрямую раскрывать основной " +"интерфейс C, либо раскрывать более \"питоновский\" API, который использует " +"возможности языка Python, чтобы сделать API проще в использовании. В " +"стандартной библиотеке CPython широко используются модули-обертки. *Пример*: " +"`functools.py `" +"_ - это модуль-обертка Python для `_functoolsmodule.c `_." #: ../source/guides/packaging-binary-extensions.rst:45 msgid "" @@ -6652,6 +7341,14 @@ msgid "" "which comes from `sysmodule.c `_." msgstr "" +"**низкоуровневый доступ к системе**: эти модули создаются для доступа к " +"функциям нижнего уровня среды выполнения CPython, операционной системы или " +"базового оборудования. С помощью специфического для платформы кода модули " +"расширения могут достигать того, что невозможно в чистом коде Python. Ряд " +"модулей стандартной библиотеки CPython написан на языке C, чтобы получить " +"доступ к внутренним функциям интерпретатора, которые не раскрываются на " +"уровне языка. *Пример*: ``Sys``, который берется из `sysmodule.c " +"`_." #: ../source/guides/packaging-binary-extensions.rst:54 msgid "" @@ -6660,6 +7357,10 @@ msgid "" "global interpreter lock around long-running operations (regardless of " "whether those operations are CPU or IO bound)." msgstr "" +"Особенно примечательной особенностью расширений на C является то, что, когда " +"им не нужно возвращаться во время выполнения интерпретатора, они могут " +"освободить глобальную блокировку интерпретатора CPython для длительных " +"операций (независимо от того, связаны ли эти операции с процессором или IO)." #: ../source/guides/packaging-binary-extensions.rst:59 msgid "" @@ -6671,6 +7372,14 @@ msgid "" "concurrent execution of vectorised operations and to tightly control the " "exact memory layout of created objects." msgstr "" +"Не все модули расширения будут четко вписываться в вышеперечисленные " +"категории. Например, модули расширения, входящие в состав NumPy, охватывают " +"все три варианта использования - они переносят внутренние циклы на C по " +"соображениям скорости, оборачивают внешние библиотеки, написанные на C, " +"FORTRAN и других языках, и используют низкоуровневые системные интерфейсы " +"как для CPython, так и для базовой операционной системы, чтобы поддерживать " +"одновременное выполнение векторных операций и жестко контролировать точное " +"расположение в памяти созданных объектов." #: ../source/guides/packaging-binary-extensions.rst:69 msgid "Disadvantages" @@ -6685,28 +7394,42 @@ msgid "" "any language that can bind to the CPython C API) typically require that " "custom binaries be created for different platforms." msgstr "" +"Основным недостатком использования бинарных расширений является то, что это " +"затрудняет последующее распространение программного обеспечения. Одним из " +"преимуществ использования Python является то, что он в значительной степени " +"кроссплатформенный, а языки, используемые для написания модулей расширения (" +"обычно это C или C++, но на самом деле любой язык, который может связываться " +"с CPython C API), обычно требуют создания собственных двоичных файлов для " +"разных платформ." #: ../source/guides/packaging-binary-extensions.rst:78 msgid "This means that binary extensions:" -msgstr "" +msgstr "Это означает, что двоичные расширения:" #: ../source/guides/packaging-binary-extensions.rst:80 msgid "" "require that end users be able to either build them from source, or else " "that someone publish pre-built binaries for common platforms" msgstr "" +"требуют, чтобы конечные пользователи могли либо собрать их из исходных " +"текстов, либо чтобы кто-то опубликовал предварительно собранные двоичные " +"файлы для распространенных платформ" #: ../source/guides/packaging-binary-extensions.rst:83 msgid "" "may not be compatible with different builds of the CPython reference " "interpreter" msgstr "" +"может быть несовместим с различными сборками эталонного интерпретатора " +"CPython" #: ../source/guides/packaging-binary-extensions.rst:86 msgid "" "often will not work correctly with alternative interpreters such as PyPy, " "IronPython or Jython" msgstr "" +"часто не будет корректно работать с альтернативными интерпретаторами, такими " +"как PyPy, IronPython или Jython" #: ../source/guides/packaging-binary-extensions.rst:89 msgid "" @@ -6714,6 +7437,9 @@ msgid "" "be familiar not only with Python, but also with the language used to create " "the binary extension, as well as with the details of the CPython C API." msgstr "" +"при ручном кодировании усложняют сопровождение, требуя, чтобы сопровождающие " +"были знакомы не только с Python, но и с языком, использованным для создания " +"бинарного расширения, а также с деталями CPython C API." #: ../source/guides/packaging-binary-extensions.rst:94 msgid "" @@ -6722,6 +7448,10 @@ msgid "" "introducing additional complexity in the test suite to ensure both versions " "are always executed." msgstr "" +"если предусмотрена обратная реализация на чистом Python, усложняет " +"сопровождение, требуя, чтобы изменения были реализованы в двух местах, и " +"вносит дополнительные сложности в набор тестов, чтобы гарантировать, что обе " +"версии всегда выполняются." #: ../source/guides/packaging-binary-extensions.rst:99 msgid "" @@ -6730,6 +7460,11 @@ msgid "" "zipfiles) often won't work for extension modules (as the dynamic loading " "mechanisms on most platforms can only load libraries from disk)." msgstr "" +"Еще одним недостатком использования бинарных расширений является то, что " +"альтернативные механизмы импорта (например, возможность импортировать модули " +"непосредственно из zip-файлов) часто не работают для модулей расширений (" +"поскольку механизмы динамической загрузки на большинстве платформ могут " +"загружать библиотеки только с диска)." #: ../source/guides/packaging-binary-extensions.rst:106 msgid "Alternatives to handcoded accelerator modules" @@ -6742,6 +7477,10 @@ msgid "" "additional maintenance effort), a number of other alternatives should also " "be considered:" msgstr "" +"Если модули расширения используются только для ускорения работы кода (после " +"того как профилирование выявило код, где увеличение скорости стоит " +"дополнительных усилий по сопровождению), следует рассмотреть и ряд других " +"альтернатив:" #: ../source/guides/packaging-binary-extensions.rst:113 msgid "" @@ -6752,6 +7491,12 @@ msgid "" "appropriate choice of standard library or third party module can avoid the " "need to create your own accelerator module." msgstr "" +"искать существующие оптимизированные альтернативы. Стандартная библиотека " +"CPython содержит ряд оптимизированных структур данных и алгоритмов (особенно " +"во встроенных модулях и модулях ``коллекции`` и ``итертулы``). Индекс " +"пакетов Python также предлагает дополнительные альтернативы. Иногда " +"правильный выбор стандартной библиотеки или стороннего модуля позволяет " +"избежать необходимости создания собственного модуля-ускорителя." #: ../source/guides/packaging-binary-extensions.rst:120 msgid "" @@ -6765,6 +7510,15 @@ msgid "" "having one live reference instead of two often won't break anything, but no " "references instead of one is a major problem)." msgstr "" +"Для долго работающих приложений JIT-компилируемый интерпретатор `PyPy " +"`__ может стать подходящей альтернативой стандартной " +"среде выполнения CPython. Основным препятствием для внедрения PyPy обычно " +"является зависимость от других бинарных модулей расширения - хотя PyPy и " +"эмулирует CPython C API, модули, полагающиеся на него, создают проблемы для " +"PyPy JIT, а слой эмуляции часто может выявить скрытые дефекты в модулях " +"расширения, к которым CPython в настоящее время терпим (часто вокруг ошибок " +"подсчета ссылок - объект с одной живой ссылкой вместо двух часто ничего не " +"нарушает, но отсутствие ссылок вместо одной является большой проблемой)." #: ../source/guides/packaging-binary-extensions.rst:130 msgid "" @@ -6777,6 +7531,15 @@ msgid "" "benefit of having a reduced barrier to entry for Python programmers " "(relative to other languages like C or C++)." msgstr "" +"`Cython `__ - это зрелый статический компилятор, " +"который может компилировать большинство кода Python в модули расширения C. " +"Первоначальная компиляция обеспечивает некоторое увеличение скорости (минуя " +"слой интерпретатора CPython), а дополнительные функции статической типизации " +"Cython могут предложить дополнительные возможности для увеличения скорости. " +"Использование Cython все еще имеет недостатки, связанные с использованием " +"бинарных расширений, но имеет преимущество в виде снижения барьера входа для " +"программистов на Python (по сравнению с другими языками, такими как C или " +"C++)." #: ../source/guides/packaging-binary-extensions.rst:139 msgid "" @@ -6787,6 +7550,12 @@ msgid "" "code is running, but can provide significant speed increases, especially for " "operations that are amenable to vectorisation." msgstr "" +"`Numba `__ - это новый инструмент, созданный " +"членами научного Python-сообщества, цель которого - использовать LLVM для " +"выборочной компиляции частей Python-приложения в нативный машинный код во " +"время выполнения. Он требует, чтобы LLVM был доступен в системе, на которой " +"выполняется код, но может обеспечить значительное увеличение скорости, " +"особенно для операций, которые поддаются векторизации." #: ../source/guides/packaging-binary-extensions.rst:148 msgid "Alternatives to handcoded wrapper modules" @@ -6800,6 +7569,12 @@ msgid "" "to tap into that functionality. However, wrapping modules by hand is quite " "tedious, so a number of other alternative approaches should be considered." msgstr "" +"C ABI (Application Binary Interface) - это общий стандарт для совместного " +"использования функциональности несколькими приложениями. Одной из сильных " +"сторон CPython C API (Application Programming Interface) является " +"возможность использования этой функциональности пользователями Python. " +"Однако создавать модули вручную довольно утомительно, поэтому следует " +"рассмотреть ряд других альтернативных подходов." #: ../source/guides/packaging-binary-extensions.rst:156 msgid "" @@ -6807,6 +7582,9 @@ msgid "" "but they *can* significantly reduce the maintenance burden of keeping " "wrapper modules up to date." msgstr "" +"Описанные ниже подходы не упрощают ситуацию с дистрибутивами, но они *могут* " +"значительно снизить нагрузку на поддержку модулей-оберток в актуальном " +"состоянии." #: ../source/guides/packaging-binary-extensions.rst:160 msgid "" @@ -6819,6 +7597,15 @@ msgid "" "automatic wrapping with Cython. It also supports performance-oriented Python " "implementations that provide a CPython-like C-API, such as PyPy and Pyston." msgstr "" +"Помимо того, что `Cython `__ полезен для создания " +"модулей ускорителей, он также широко используется для создания модулей-" +"оберток для API на C или C++. Это предполагает обертывание интерфейсов " +"вручную, что дает широкую свободу в проектировании и оптимизации кода " +"обертки, но может быть не лучшим выбором для быстрого обертывания очень " +"больших API. См. `список сторонних инструментов `_ для автоматического обертывания с помощью Cython. Он " +"также поддерживает ориентированные на производительность реализации Python, " +"которые предоставляют CPython-подобный C-API, такие как PyPy и Pyston." #: ../source/guides/packaging-binary-extensions.rst:171 msgid "" @@ -6829,6 +7616,12 @@ msgid "" "`__, " "but doesn't require the Boost libraries or BJam." msgstr "" +":doc:`pybind11 ` - это чистая библиотека C++11, которая " +"предоставляет чистый C++ интерфейс к CPython (и PyPy) C API. Она не требует " +"предварительной обработки и написана полностью на шаблонизированном C++. В " +"комплект включены помощники для сборки Setuptools или CMake. Он был основан " +"на `Boost.Python `__, но не требует библиотек Boost или BJam." #: ../source/guides/packaging-binary-extensions.rst:178 msgid "" @@ -6838,6 +7631,11 @@ msgid "" "relatively straightforward to wrap a C module based on its header files, " "even if you don't know C yourself." msgstr "" +":doc:`cffi ` - это проект, созданный некоторыми разработчиками " +"PyPy, чтобы упростить разработчикам, которые уже знают Python и C, " +"возможность использовать свои C-модули в Python-приложениях. Он также " +"позволяет относительно просто обернуть модуль на Си на основе его " +"заголовочных файлов, даже если вы сами не знаете Си." #: ../source/guides/packaging-binary-extensions.rst:184 msgid "" @@ -6845,6 +7643,9 @@ msgid "" "JIT, allowing CFFI wrapper modules to participate fully in PyPy's tracing " "JIT optimisations." msgstr "" +"Одним из ключевых преимуществ ``cffi`` является его совместимость с PyPy " +"JIT, что позволяет модулям-оберткам CFFI полноценно участвовать в JIT-" +"оптимизации трассировки PyPy." #: ../source/guides/packaging-binary-extensions.rst:188 msgid "" @@ -6852,6 +7653,9 @@ msgid "" "a variety of programming languages, including Python, to interface with C " "and C++ code." msgstr "" +"`SWIG `__ - это генератор интерфейсов-оберток, который " +"позволяет различным языкам программирования, включая Python, " +"взаимодействовать с кодом на C и C++." #: ../source/guides/packaging-binary-extensions.rst:192 msgid "" @@ -6866,6 +7670,18 @@ msgid "" "``cffi`` *can* operate directly at the C ABI level, it suffers from the same " "interface inconsistency problems as ``ctypes`` when it is used that way." msgstr "" +"Модуль ``ctypes'' стандартной библиотеки, хотя и полезен для получения " +"доступа к интерфейсам уровня C, когда информация о заголовках недоступна, " +"страдает от того, что он работает исключительно на уровне C ABI, и поэтому " +"не имеет автоматической проверки согласованности между интерфейсом, " +"фактически экспортируемым библиотекой, и интерфейсом, объявленным в коде " +"Python. В отличие от этого, все вышеперечисленные альтернативы способны " +"работать на уровне C *API*, используя заголовочные файлы C для обеспечения " +"согласованности между интерфейсом, экспортируемым обертываемой библиотекой, " +"и интерфейсом, ожидаемым модулем-оберткой Python. Хотя ``cffi`` *может* " +"работать непосредственно на уровне C ABI, он страдает от тех же проблем " +"несогласованности интерфейсов, что и ``ctypes``, когда его используют таким " +"образом." #: ../source/guides/packaging-binary-extensions.rst:206 msgid "Alternatives for low level system access" @@ -6881,6 +7697,14 @@ msgid "" "like ``ctypes`` or ``cffi`` is used to obtain access to the relevant C API " "interfaces." msgstr "" +"Для приложений, которым нужен низкоуровневый доступ к системе (независимо от " +"причины), модуль бинарного расширения часто *является* лучшим способом " +"решения этой проблемы. Это особенно верно для низкоуровневого доступа к " +"самой среде выполнения CPython, поскольку некоторые операции (например, " +"снятие глобальной блокировки интерпретатора) просто недействительны, когда " +"интерпретатор выполняет код, даже если для получения доступа к " +"соответствующим интерфейсам C API используется модуль типа ``ctypes`` или " +"``cffi``." #: ../source/guides/packaging-binary-extensions.rst:216 msgid "" @@ -6891,6 +7715,13 @@ msgid "" "compatible ABI), and then use one of the wrapping techniques described above " "to make the interface available as an importable Python module." msgstr "" +"Для случаев, когда модуль расширения манипулирует базовой операционной " +"системой или аппаратным обеспечением (а не средой выполнения CPython), " +"иногда лучше просто написать обычную библиотеку на C (или библиотеку на " +"другом системном языке программирования, например C++ или Rust, который " +"может экспортировать ABI, совместимый с C), а затем использовать одну из " +"описанных выше техник обертывания, чтобы сделать интерфейс доступным в " +"качестве импортируемого модуля Python." #: ../source/guides/packaging-binary-extensions.rst:225 msgid "Implementing binary extensions" @@ -6902,17 +7733,21 @@ msgid "" "includes an introduction to writing a :doc:`custom extension module in C " "`." msgstr "" +"Руководство CPython :doc:`Extending and Embedding ` " +"включает в себя введение в написание модуля расширения :doc:`custom " +"extension module in C `." #: ../source/guides/packaging-binary-extensions.rst:231 msgid "" "FIXME: Elaborate that all this is one of the reasons why you probably " "*don't* want to handcode your extension modules :)" msgstr "" +"FIXME: Уточните, что все это - одна из причин, почему вы, вероятно, *не* " +"хотите вручную кодировать свои модули расширения :)" #: ../source/guides/packaging-binary-extensions.rst:236 -#, fuzzy msgid "Extension module lifecycle" -msgstr "Модуль расширения" +msgstr "Жизненный цикл модуля расширения" #: ../source/guides/packaging-binary-extensions.rst:238 #: ../source/guides/packaging-binary-extensions.rst:244 @@ -6920,23 +7755,23 @@ msgstr "Модуль расширения" #: ../source/guides/packaging-binary-extensions.rst:256 #: ../source/guides/packaging-binary-extensions.rst:376 msgid "FIXME: This section needs to be fleshed out." -msgstr "" +msgstr "FIXME: Этот раздел нуждается в доработке." #: ../source/guides/packaging-binary-extensions.rst:242 msgid "Implications of shared static state and subinterpreters" -msgstr "" +msgstr "Последствия общего статического состояния и субинтерпретаторов" #: ../source/guides/packaging-binary-extensions.rst:248 msgid "Implications of the GIL" -msgstr "" +msgstr "Последствия GIL" #: ../source/guides/packaging-binary-extensions.rst:254 msgid "Memory allocation APIs" -msgstr "" +msgstr "API для распределения памяти" #: ../source/guides/packaging-binary-extensions.rst:262 msgid "ABI Compatibility" -msgstr "" +msgstr "Совместимость ABI" #: ../source/guides/packaging-binary-extensions.rst:264 msgid "" @@ -6945,6 +7780,10 @@ msgid "" "module against one version of Python, it is only guaranteed to work with the " "same minor version of Python and not with any other minor versions." msgstr "" +"CPython C API не гарантирует стабильность ABI между минорными версиями (3.2, " +"3.3, 3.4 и т.д.). Это означает, что, как правило, если вы собираете модуль " +"расширения для одной версии Python, он гарантированно будет работать только " +"с той же минорной версией Python, но не с любыми другими минорными версиями." #: ../source/guides/packaging-binary-extensions.rst:270 msgid "" @@ -6954,6 +7793,12 @@ msgid "" "Wheels containing extensions built against the stable ABI use the ``abi3`` " "ABI tag, to reflect that they're compatible with all Python 3.x versions." msgstr "" +"В Python 3.2 появился Limited API, который представляет собой четко " +"определенное подмножество API Python на языке C. Символы, необходимые для " +"Limited API, образуют \"Стабильный ABI\", который гарантированно совместим " +"со всеми версиями Python 3.x. Колеса, содержащие расширения, созданные на " +"основе стабильного ABI, используют тег ``abi3`` ABI, чтобы показать, что они " +"совместимы со всеми версиями Python 3.x." #: ../source/guides/packaging-binary-extensions.rst:277 msgid "" @@ -6961,18 +7806,21 @@ msgid "" "information about the API / ABI stability guarantees, how to use the Limited " "API and the exact contents of the \"Limited API\"." msgstr "" +"Страница CPython :doc:`C API stability` содержит " +"подробную информацию о гарантиях стабильности API / ABI, о том, как " +"использовать Limited API и о точном содержании \"Limited API\"." #: ../source/guides/packaging-binary-extensions.rst:283 msgid "Building binary extensions" -msgstr "" +msgstr "Создание бинарных расширений" #: ../source/guides/packaging-binary-extensions.rst:285 msgid "FIXME: Cover the build-backends available for building extensions." -msgstr "" +msgstr "FIXME: Покройте сборки-бэкенды, доступные для сборки расширений." #: ../source/guides/packaging-binary-extensions.rst:288 msgid "Building extensions for multiple platforms" -msgstr "" +msgstr "Создание расширений для нескольких платформ" #: ../source/guides/packaging-binary-extensions.rst:290 msgid "" @@ -6982,6 +7830,12 @@ msgid "" "build highly redistributable binaries from CI; these include :ref:" "`cibuildwheel` and :ref:`multibuild`." msgstr "" +"Если вы планируете распространять свое расширение, вам следует предоставить " +":term:`wheels ` для всех платформ, которые вы собираетесь " +"поддерживать. Обычно они создаются на основе систем непрерывной интеграции " +"(CI). Существуют инструменты, которые помогут вам собрать перераспределяемые " +"двоичные файлы из CI; к ним относятся :ref:`cibuildwheel` и " +":ref:`multibuild`." #: ../source/guides/packaging-binary-extensions.rst:296 msgid "" @@ -6989,6 +7843,9 @@ msgid "" "intend to support. This means that the number of wheels you need to build is " "the product of::" msgstr "" +"Для большинства расширений вам потребуется создать колеса для всех платформ, " +"которые вы собираетесь поддерживать. Это означает, что количество колес, " +"которые вам нужно построить, складывается из::" #: ../source/guides/packaging-binary-extensions.rst:302 msgid "" @@ -6998,6 +7855,12 @@ msgid "" "eliminating one dimension of the matrix. It also removes the need to " "generate new wheels for each new minor version of Python." msgstr "" +"Использование CPython :ref:`Stable ABI ` может " +"значительно сократить количество колес, которые вам нужно предоставить, так " +"как одно колесо на платформе может использоваться со всеми минорными " +"версиями Python, устраняя одно измерение матрицы. Это также избавляет от " +"необходимости генерировать новые колеса для каждой новой минорной версии " +"Python." #: ../source/guides/packaging-binary-extensions.rst:309 msgid "Binary extensions for Windows" @@ -7012,6 +7875,13 @@ msgid "" "extensions, install `Visual Studio Community Edition `__ - any recent version is fine." msgstr "" +"Прежде чем приступить к созданию бинарного расширения, необходимо убедиться, " +"что у вас есть подходящий компилятор. В Windows для сборки официального " +"интерпретатора CPython используется Visual C, который следует использовать " +"для сборки совместимых бинарных расширений. Чтобы создать среду сборки для " +"бинарных расширений, установите `Visual Studio Community Edition " +"`__ - подойдет любая " +"последняя версия." #: ../source/guides/packaging-binary-extensions.rst:318 msgid "" @@ -7022,6 +7892,14 @@ msgid "" "that do not include this extra file. To avoid this, you can add the compile-" "time argument ``/d2FH4-``. Recent versions of Python may include this file." msgstr "" +"Одна оговорка: если вы используете Visual Studio 2019 или более позднюю " +"версию, ваше расширение будет зависеть от \"дополнительного\" файла, " +"``VCRUNTIME140_1.dll``, в дополнение к ``VCRUNTIME140.dll``, от которого " +"зависят все предыдущие версии, начиная с 2015 года. Это добавит " +"дополнительные требования к использованию вашего расширения в версиях " +"CPython, которые не включают этот дополнительный файл. Чтобы избежать этого, " +"вы можете добавить аргумент времени компиляции ``/d2FH4-``. Последние версии " +"Python могут включать этот файл." #: ../source/guides/packaging-binary-extensions.rst:326 msgid "" @@ -7034,6 +7912,14 @@ msgid "" "structures, and so on. Tools for generating extension modules usually avoid " "these things for you." msgstr "" +"Сборка для Python до версии 3.5 не рекомендуется, поскольку старые версии " +"Visual Studio больше не поставляются компанией Microsoft. Если вам все же " +"необходимо собирать для старых версий, вы можете установить " +"``DISTUTILS_USE_SDK=1`` и ``MSSdk=1`` для принудительного поиска текущей " +"активированной версии MSVC, а также проявить осторожность при разработке " +"расширения, чтобы не расшаривать/свобождать память в разных библиотеках, не " +"полагаться на измененные структуры данных и так далее. Инструменты для " +"генерации модулей расширения обычно позволяют избежать этих проблем." #: ../source/guides/packaging-binary-extensions.rst:337 msgid "Binary extensions for Linux" @@ -7046,6 +7932,11 @@ msgid "" "images provide a build environment with a glibc old enough to support most " "current Linux distributions on common architectures." msgstr "" +"Для совместимости с более старыми дистрибутивами Linux двоичные файлы должны " +"использовать достаточно старый glibc. Docker-образы `manylinux " +"`_ предоставляют среду сборки с " +"достаточно старой glibc для поддержки большинства современных дистрибутивов " +"Linux на распространенных архитектурах." #: ../source/guides/packaging-binary-extensions.rst:345 msgid "Binary extensions for macOS" @@ -7062,6 +7953,14 @@ msgid "" "Spinning Wheels wiki `_." msgstr "" +"Совместимость бинарных файлов на macOS определяется целевой минимальной " +"системой развертывания, например *10.9*, которая часто указывается с помощью " +"переменной окружения ``MACOSX_DEPLOYMENT_TARGET`` при сборке бинарных файлов " +"на macOS. При сборке с помощью setuptools / distutils цель развертывания " +"указывается с помощью флага ``--plat-name``, например ``macosx-10.9-x86_64``" +". Об общих целях развертывания для дистрибутивов macOS Python см. в `" +"MacPython Spinning Wheels wiki `_." #: ../source/guides/packaging-binary-extensions.rst:357 msgid "Publishing binary extensions" @@ -7074,10 +7973,14 @@ msgid "" "using the build-backend and upload it to PyPI using :doc:`twine `." msgstr "" +"Публикация бинарных расширений через PyPI использует те же механизмы " +"загрузки, что и публикация пакетов чистого Python. Вы создаете wheel-файл " +"для своего расширения с помощью build-бэкенда и загружаете его в PyPI с " +"помощью :doc:`twine `." #: ../source/guides/packaging-binary-extensions.rst:365 msgid "Avoid binary-only releases" -msgstr "" +msgstr "Избегайте выпуска только бинарных релизов" #: ../source/guides/packaging-binary-extensions.rst:367 msgid "" @@ -7087,10 +7990,16 @@ msgid "" "certain Linux distributions that build from source within their own build " "systems for the distro package repositories." msgstr "" +"Настоятельно рекомендуется публиковать бинарные расширения, а также исходный " +"код, который был использован для их создания. Это позволит пользователям при " +"необходимости собрать расширение из исходного кода. В частности, это " +"требуется для некоторых дистрибутивов Linux, которые собирают расширения из " +"исходного кода в своих собственных системах сборки для репозиториев пакетов " +"дистрибутива." #: ../source/guides/packaging-binary-extensions.rst:374 msgid "Weak linking" -msgstr "" +msgstr "Слабая связь" #: ../source/guides/packaging-binary-extensions.rst:379 msgid "Additional resources" @@ -7105,6 +8014,12 @@ msgid "" "for developers looking to understand more about the underlying binary " "interfaces that those systems rely on at runtime." msgstr "" +"Кросс-платформенная разработка и распространение модулей расширения - " +"сложная тема, поэтому в данном руководстве основное внимание уделено " +"указателям на различные инструменты, автоматизирующие решение основных " +"технических проблем. Дополнительные ресурсы в этом разделе предназначены для " +"разработчиков, желающих больше узнать о базовых бинарных интерфейсах, на " +"которые опираются эти системы во время выполнения." #: ../source/guides/packaging-binary-extensions.rst:388 msgid "Cross-platform wheel generation with scikit-build" @@ -7119,6 +8034,12 @@ msgid "" "system generator `_ for Python binary extension modules." msgstr "" +"Пакет `scikit-build `_ " +"помогает абстрагироваться от кроссплатформенных операций сборки и " +"предоставляет дополнительные возможности при создании пакетов бинарных " +"расширений. Также доступна дополнительная документация по `C runtime, " +"компилятору и генератору системы сборки `_ для бинарных модулей расширения Python." #: ../source/guides/packaging-binary-extensions.rst:398 msgid "Introduction to C/C++ extension modules" @@ -7129,22 +8050,28 @@ msgid "" "For a more in depth explanation of how extension modules are used by CPython " "on a Debian system, see the following articles:" msgstr "" +"Для более подробного объяснения того, как модули расширения используются в " +"CPython на системе Debian, смотрите следующие статьи:" #: ../source/guides/packaging-binary-extensions.rst:403 msgid "" "`What are (c)python extension modules? `_" msgstr "" +"Что такое модули расширения (c)python? `_" #: ../source/guides/packaging-binary-extensions.rst:404 msgid "`Releasing the gil `_" -msgstr "" +msgstr "`Освобождение gil `_" #: ../source/guides/packaging-binary-extensions.rst:405 msgid "" "`Writing cpython extension modules using C++ `_" msgstr "" +"`Написание модулей расширения cpython с использованием C++ " +"`_" #: ../source/guides/packaging-namespace-packages.rst:5 msgid "Packaging namespace packages" @@ -7158,18 +8085,25 @@ msgid "" "**distributions** in this document to avoid ambiguity). For example, if you " "have the following package structure:" msgstr "" +"Пакеты пространства имен позволяют разделить подпакеты и модули одного " +":term:`пакета <Импортный пакет>` на несколько отдельных :term:`" +"дистрибутивных пакетов <Дистрибутивный пакет>` (во избежание двусмысленности " +"в этом документе они называются **дистрибутивами**). Например, если у вас " +"есть следующая структура пакета:" #: ../source/guides/packaging-namespace-packages.rst:26 msgid "And you use this package in your code like so::" -msgstr "" +msgstr "И вы используете этот пакет в своем коде следующим образом::" #: ../source/guides/packaging-namespace-packages.rst:31 msgid "Then you can break these sub-packages into two separate distributions:" -msgstr "" +msgstr "Затем вы можете разбить эти подпакеты на два отдельных дистрибутива:" #: ../source/guides/packaging-namespace-packages.rst:50 msgid "Each sub-package can now be separately installed, used, and versioned." msgstr "" +"Теперь каждый подпакет может быть установлен, использован и версионирован " +"отдельно." #: ../source/guides/packaging-namespace-packages.rst:52 msgid "" @@ -7181,6 +8115,14 @@ msgid "" "mynamespace_subpackage_a`` (you could even use ``import " "mynamespace_subpackage_a as subpackage_a`` to keep the import object short)." msgstr "" +"Пакеты пространства имен могут быть полезны для большой коллекции слабо " +"связанных между собой пакетов (например, большой корпус клиентских библиотек " +"для нескольких продуктов одной компании). Однако пакеты пространства имен " +"имеют несколько оговорок и подходят не во всех случаях. Простая альтернатива " +"- использовать во всех дистрибутивах префикс, например ``import " +"mynamespace_subpackage_a`` (можно даже использовать ``import " +"mynamespace_subpackage_a as subpackage_a``, чтобы сохранить краткость " +"объекта импорта)." #: ../source/guides/packaging-namespace-packages.rst:62 msgid "Creating a namespace package" @@ -7191,6 +8133,8 @@ msgid "" "There are currently two different approaches to creating namespace packages, " "from which the latter is discouraged:" msgstr "" +"В настоящее время существует два различных подхода к созданию пакетов " +"пространства имен, из которых последний не рекомендуется:" #: ../source/guides/packaging-namespace-packages.rst:67 msgid "" @@ -7199,12 +8143,19 @@ msgid "" "if packages in your namespace only ever need to support Python 3 and " "installation via ``pip``." msgstr "" +"Используйте `нативные пакеты пространства имен`_. Этот тип пакетов " +"пространства имен определен в :pep:`420` и доступен в Python 3.3 и более " +"поздних версиях. Это рекомендуется, если пакеты в вашем пространстве имен " +"должны поддерживать только Python 3 и устанавливаться через ``pip``." #: ../source/guides/packaging-namespace-packages.rst:71 msgid "" "Use `legacy namespace packages`_. This comprises `pkgutil-style namespace " "packages`_ and `pkg_resources-style namespace packages`_." msgstr "" +"Используйте пакеты `legacy namespace`_. Это включает в себя пакеты " +"пространства имен в стиле `pkgutil`_ и пакеты пространства имен в стиле " +"`pkg_resources`_." #: ../source/guides/packaging-namespace-packages.rst:75 msgid "Native namespace packages" @@ -7217,6 +8168,11 @@ msgid "" "`__init__.py` from the namespace package directory. An example file " "structure (following :ref:`src-layout `):" msgstr "" +"В Python 3.3 добавлены **имплицитные** пакеты пространства имен из :pep:`420`" +". Все, что требуется для создания нативного пакета пространства имен, это " +"просто опустить :file:`__init__.py` из каталога пакета пространства имен. " +"Пример файловой структуры (в соответствии с :ref:`src-layout `):" #: ../source/guides/packaging-namespace-packages.rst:94 msgid "" @@ -7225,6 +8181,10 @@ msgid "" "`__init__.py`. If any distribution does not, it will cause the namespace " "logic to fail and the other sub-packages will not be importable." msgstr "" +"Очень важно, чтобы каждый дистрибутив, использующий пакет namespace, опускал " +":file:`__init__.py` или использовал :file:`__init__.py` в стиле pkgutil. " +"Если какой-либо дистрибутив этого не сделает, это приведет к сбою логики " +"пространства имен, и другие подпакеты не будут импортированы." #: ../source/guides/packaging-namespace-packages.rst:99 msgid "" @@ -7234,26 +8194,35 @@ msgid "" "exclusions or inclusions of packages yourself, this is possible to be " "configured in the top-level :file:`pyproject.toml`:" msgstr "" +"Структура каталогов ``rc-layout`` позволяет автоматически находить пакеты " +"большинством :term:`build backends `. Более подробную " +"информацию смотрите в :ref:`src-layout-vs-flat-layout. Если же вы хотите " +"самостоятельно управлять исключениями или включениями пакетов, это можно " +"настроить в верхнем уровне :file:`pyproject.toml`:" #: ../source/guides/packaging-namespace-packages.rst:117 msgid "The same can be accomplished with a :file:`setup.cfg`:" -msgstr "" +msgstr "То же самое можно сделать с помощью :file:`setup.cfg`:" #: ../source/guides/packaging-namespace-packages.rst:129 msgid "Or :file:`setup.py`:" -msgstr "" +msgstr "Или :файл:`setup.py`:" #: ../source/guides/packaging-namespace-packages.rst:142 msgid "" ":ref:`setuptools` will search the directory structure for implicit namespace " "packages by default." msgstr "" +":ref:`setuptools` по умолчанию будет искать в структуре каталогов пакеты " +"неявного пространства имен." #: ../source/guides/packaging-namespace-packages.rst:145 msgid "" "A complete working example of two native namespace packages can be found in " "the `native namespace package example project`_." msgstr "" +"Полный рабочий пример двух пакетов нативного пространства имен можно найти в " +"проекте `Пример пакета нативного пространства имен`_." #: ../source/guides/packaging-namespace-packages.rst:151 msgid "" @@ -7262,11 +8231,14 @@ msgid "" "Python 3 and pkgutil-style namespace packages in the distributions that need " "to support Python 2 and 3." msgstr "" +"Поскольку пакеты пространства имен native и pkgutil-style в значительной " +"степени совместимы, вы можете использовать пакеты пространства имен native в " +"дистрибутивах, поддерживающих только Python 3, и пакеты пространства имен " +"pkgutil-style в дистрибутивах, которые должны поддерживать Python 2 и 3." #: ../source/guides/packaging-namespace-packages.rst:158 -#, fuzzy msgid "Legacy namespace packages" -msgstr "Использование пакетов пространства имён" +msgstr "Унаследованные пакеты пространства имен" #: ../source/guides/packaging-namespace-packages.rst:160 msgid "" @@ -7275,12 +8247,19 @@ msgid "" "need compatibility with packages already using this method. Also, :doc:" "`pkg_resources ` has been deprecated." msgstr "" +"Эти два метода, которые использовались для создания пакетов пространства " +"имен до появления :pep:`420`, теперь считаются устаревшими и не должны " +"использоваться, если вам не нужна совместимость с пакетами, уже " +"использующими этот метод. Кроме того, :doc:`pkg_resources " +"` был устаревшим." #: ../source/guides/packaging-namespace-packages.rst:165 msgid "" "To migrate an existing package, all packages sharing the namespace must be " "migrated simultaneously." msgstr "" +"Чтобы перенести существующий пакет, необходимо одновременно перенести все " +"пакеты, разделяющие это пространство имен." #: ../source/guides/packaging-namespace-packages.rst:167 msgid "" @@ -7289,6 +8268,11 @@ msgid "" "compatible with the other methods. It's inadvisable to use different methods " "in different distributions that provide packages to the same namespace." msgstr "" +"В то время как пакеты родного пространства имен и пакеты пространства имен в " +"стиле pkgutil в основном совместимы, пакеты пространства имен в стиле " +"pkg_resources не совместимы с другими методами. Нежелательно использовать " +"разные методы в разных дистрибутивах, предоставляющих пакеты для одного и " +"того же пространства имен." #: ../source/guides/packaging-namespace-packages.rst:174 msgid "pkgutil-style namespace packages" @@ -7302,12 +8286,19 @@ msgid "" "and Python 3. This is the recommended approach for the highest level of " "compatibility." msgstr "" +"В Python 2.3 появился модуль :doc:`pkgutil ` и " +"функция :py:func:`python:pkgutil.extend_path`. Это можно использовать для " +"объявления пакетов пространства имен, которые должны быть совместимы как с " +"Python 2.3+, так и с Python 3. Это рекомендуемый подход для достижения " +"максимального уровня совместимости." #: ../source/guides/packaging-namespace-packages.rst:181 msgid "" "To create a pkgutil-style namespace package, you need to provide an :file:" "`__init__.py` file for the namespace package:" msgstr "" +"Чтобы создать пакет пространства имен в стиле pkgutil, вам нужно " +"предоставить файл :file:`__init__.py` для пакета пространства имен:" #: ../source/guides/packaging-namespace-packages.rst:195 #: ../source/guides/packaging-namespace-packages.rst:242 @@ -7315,6 +8306,7 @@ msgid "" "The :file:`__init__.py` file for the namespace package needs to contain the " "following:" msgstr "" +"Файл :file:`__init__.py` для пакета namespace должен содержать следующее:" #: ../source/guides/packaging-namespace-packages.rst:202 #: ../source/guides/packaging-namespace-packages.rst:249 @@ -7324,12 +8316,18 @@ msgid "" "namespace logic to fail and the other sub-packages will not be importable. " "Any additional code in :file:`__init__.py` will be inaccessible." msgstr "" +"**Каждый** дистрибутив, использующий пакет namespace, должен включать такой " +":файл:`__init__.py`. Если дистрибутив не включит его, это приведет к сбою " +"логики пространства имен, и другие подпакеты будут недоступны для импорта. " +"Любой дополнительный код в :file:`__init__.py` будет недоступен." #: ../source/guides/packaging-namespace-packages.rst:207 msgid "" "A complete working example of two pkgutil-style namespace packages can be " "found in the `pkgutil namespace example project`_." msgstr "" +"Полный рабочий пример двух пакетов пространства имен в стиле pkgutil можно " +"найти в проекте `pkgutil namespace example`_." #: ../source/guides/packaging-namespace-packages.rst:217 msgid "pkg_resources-style namespace packages" @@ -7346,18 +8344,31 @@ msgid "" "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." msgstr "" +":doc:`Setuptools ` предоставляет функцию `pkg_resources." +"declare_namespace`_ и аргумент ``namespace_packages``:func:`~" +"setuptools.setup'. Вместе они могут быть использованы для объявления пакетов " +"пространства имен. Хотя этот подход больше не рекомендуется, он широко " +"присутствует в большинстве существующих пакетов пространства имен. Если вы " +"создаете новое распределение в существующем пакете пространства имен, " +"который использует этот метод, рекомендуется продолжать использовать это, " +"поскольку различные методы не являются взаимосовместимыми, и не " +"рекомендуется пытаться мигрировать существующий пакет." #: ../source/guides/packaging-namespace-packages.rst:228 msgid "" "To create a pkg_resources-style namespace package, you need to provide an :" "file:`__init__.py` file for the namespace package:" msgstr "" +"Чтобы создать пакет пространства имен в стиле pkg_resources, вам нужно " +"предоставить файл :file:`__init__.py` для пакета пространства имен:" #: ../source/guides/packaging-namespace-packages.rst:254 msgid "" "Some older recommendations advise the following in the namespace package :" "file:`__init__.py`:" msgstr "" +"В некоторых старых рекомендациях в пакете пространства имен :file:`__init__." +"py` рекомендуется следующее:" #: ../source/guides/packaging-namespace-packages.rst:264 msgid "" @@ -7367,23 +8378,35 @@ msgid "" "cross-compatible. If the presence of setuptools is a concern then the " "package should just explicitly depend on setuptools via ``install_requires``." msgstr "" +"Идея заключалась в том, что в редких случаях, когда setuptools недоступен, " +"пакеты будут возвращаться к пакетам в стиле pkgutil. Это нежелательно, " +"поскольку пакеты пространства имен в стиле pkgutil и pkg_resources не " +"являются кросс-совместимыми. Если наличие setuptools является проблемой, то " +"пакет должен просто явно зависеть от setuptools через ``install_requires``." #: ../source/guides/packaging-namespace-packages.rst:271 msgid "" "Finally, every distribution must provide the ``namespace_packages`` argument " "to :func:`~setuptools.setup` in :file:`setup.py`. For example:" msgstr "" +"Наконец, каждый дистрибутив должен предоставить аргумент " +"``namespace_packages`` в :func:`~setuptools.setup` в :file:`setup.py`. " +"Например:" #: ../source/guides/packaging-namespace-packages.rst:285 msgid "" "A complete working example of two pkg_resources-style namespace packages can " "be found in the `pkg_resources namespace example project`_." msgstr "" +"Полный рабочий пример двух пакетов пространства имен в стиле pkg_resources " +"можно найти в проекте `pkg_resources namespace example`_." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:3 msgid "" "Publishing package distribution releases using GitHub Actions CI/CD workflows" msgstr "" +"Публикация релизов дистрибутивов пакетов с помощью рабочих процессов GitHub " +"Actions CI/CD" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:5 msgid "" @@ -7395,6 +8418,14 @@ msgid "" "GitHub's `upload-artifact`_ and `download-artifact`_ actions for temporarily " "storing and downloading the source packages." msgstr "" +"`GitHub Actions CI/CD`_ позволяет запускать серию команд каждый раз, когда " +"на платформе GitHub происходит какое-либо событие. Одним из популярных " +"вариантов является рабочий процесс, который запускается по событию ``push``. " +"В этом руководстве показано, как публиковать дистрибутив Python каждый раз, " +"когда выкладывается коммит с меткой. Для публикации будет использован экшен " +"GitHub `pypa/gh-action-pypi-publish`_. Также используются действия GitHub " +"`upload-artifact`_ и `download-artifact`_ для временного хранения и загрузки " +"исходных пакетов." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:17 msgid "" @@ -7403,10 +8434,15 @@ msgid "" "details of building platform specific projects. If you have binary " "components, check out :ref:`cibuildwheel`'s GitHub Action examples." msgstr "" +"Это руководство *предполагает*, что у вас уже есть проект, для которого вы " +"знаете, как собирать дистрибутивы, и *он живет на GitHub*. Это руководство " +"также избегает подробностей сборки проектов для конкретных платформ. Если у " +"вас есть бинарные компоненты, посмотрите примеры GitHub Action от " +":ref:`cibuildwheel`." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:23 msgid "Configuring trusted publishing" -msgstr "" +msgstr "Настройка доверенной публикации" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:25 msgid "" @@ -7418,6 +8454,13 @@ msgid "" "doc:`devpi `, you may need to provide a username/password " "combination." msgstr "" +"В этом руководстве используется реализация PyPI `trusted publishing`_ для " +"подключения к `GitHub Actions CI/CD`_. Это рекомендуется из соображений " +"безопасности, поскольку генерируемые токены создаются для каждого вашего " +"проекта отдельно и автоматически истекают. В противном случае вам придется " +"сгенерировать `API-токен`_ как для PyPI, так и для TestPyPI. В случае " +"публикации в сторонние индексы, такие как :doc:`devpi `, вам " +"может потребоваться указать комбинацию имя пользователя/пароль." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:33 msgid "" @@ -7427,6 +8470,11 @@ msgid "" "`. However it is also possible to add `trusted publishing`_ to any " "pre-existing project, if you are its owner." msgstr "" +"Поскольку в этом руководстве мы продемонстрируем загрузку на PyPI и " +"TestPyPI, нам понадобятся два доверенных издателя. Следующие шаги приведут " +"вас к созданию \"ожидающих\" издателей для вашего нового :term:`PyPI проекта " +"`. Однако можно также добавить `доверенную публикацию`_ в любой уже " +"существующий проект, если вы являетесь его владельцем." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:42 msgid "" @@ -7436,14 +8484,19 @@ msgid "" "repository and revoke them in your PyPI and TestPyPI account settings in " "case you are replacing your old setup with the new one." msgstr "" +"Если вы следовали предыдущим версиям этого руководства, вы создали секреты " +"``PYPI_API_TOKEN`` и ``TEST_PYPI_API_TOKEN`` для прямого доступа к PyPI и " +"TestPyPI. Теперь они устарели, и вам следует удалить их из вашего " +"репозитория GitHub и отозвать их в настройках ваших аккаунтов PyPI и " +"TestPyPI, если вы заменяете старую настройку на новую." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:49 msgid "Let's begin! 🚀" -msgstr "" +msgstr "Давайте начнем! 🚀" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:51 msgid "Go to https://pypi.org/manage/account/publishing/." -msgstr "" +msgstr "Зайдите на сайт https://pypi.org/manage/account/publishing/." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:52 msgid "" @@ -7455,6 +8508,13 @@ msgid "" "(``pypi``) we're going set up under your repository. Register the trusted " "publisher." msgstr "" +"Введите имя, под которым вы хотите опубликовать свой новый :term:`PyPI-" +"проект ` (значение ``name`` в вашем ``setup.cfg`` или ``pyproject." +"toml``), имя владельца репозитория GitHub (org или user), имя репозитория, а " +"также имя файла рабочего процесса релиза в папке ``.github/``, см. :ref" +":`workflow-definition``. Наконец, добавьте имя окружения GitHub (``pypi``), " +"которое мы собираемся установить под вашим репозиторием. Зарегистрируйте " +"доверенного издателя." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:61 msgid "" @@ -7462,18 +8522,25 @@ msgid "" "second step, but this time, enter ``testpypi`` as the name of the GitHub " "Environment." msgstr "" +"Теперь перейдите на https://test.pypi.org/manage/account/publishing/ и " +"повторите второй шаг, но на этот раз введите ``testpypi`` в качестве имени " +"среды GitHub." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:64 msgid "" "Your \"pending\" publishers are now ready for their first use and will " "create your projects automatically once you use them for the first time." msgstr "" +"Ваши \"ожидающие\" издатели теперь готовы к первому использованию и будут " +"создавать ваши проекты автоматически, как только вы впервые их используете." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:70 msgid "" "If you don't have a TestPyPI account, you'll need to create it. It's not the " "same as a regular PyPI account." msgstr "" +"Если у вас нет учетной записи TestPyPI, вам нужно ее создать. Это не то же " +"самое, что обычная учетная запись PyPI." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:76 msgid "" @@ -7482,58 +8549,75 @@ msgid "" "environments-for-deployment#deployment-protection-rules>`_ on each run for " "the ``pypi`` environment." msgstr "" +"По соображениям безопасности вы должны требовать `ручного одобрения " +"`_ при каждом запуске для среды ``pypi``." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:83 msgid "Creating a workflow definition" -msgstr "" +msgstr "Создание определения рабочего процесса" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:85 msgid "" "GitHub CI/CD workflows are declared in YAML files stored in the ``.github/" "workflows/`` directory of your repository." msgstr "" +"Рабочие процессы GitHub CI/CD объявляются в файлах YAML, хранящихся в " +"директории ``.github/workflows/`` вашего репозитория." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:88 msgid "Let's create a ``.github/workflows/publish-to-test-pypi.yml`` file." -msgstr "" +msgstr "Давайте создадим файл ``.github/workflows/publish-to-test-pypi.yml``." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:91 msgid "" "Start it with a meaningful name and define the event that should make GitHub " "run this workflow:" msgstr "" +"Начните его с осмысленного имени и определите событие, которое должно " +"заставить GitHub запустить этот рабочий процесс:" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:99 msgid "Checking out the project and building distributions" -msgstr "" +msgstr "Проверка проекта и сборка дистрибутивов" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:101 msgid "" "We will have to define two jobs to publish to PyPI and TestPyPI " "respectively, and an additional job to build the distribution packages." msgstr "" +"Нам нужно будет определить два задания для публикации в PyPI и TestPyPI " +"соответственно, а также дополнительное задание для сборки дистрибутива." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:105 msgid "" "First, we'll define the job for building the dist packages of your project " "and storing them for later use:" msgstr "" +"Сначала мы определим задание для сборки дист-пакетов вашего проекта и " +"хранения их для последующего использования:" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:113 msgid "" "This will download your repository into the CI runner and then install and " "activate the newest available Python 3 release." msgstr "" +"Это позволит загрузить ваш репозиторий в CI runner, а затем установить и " +"активировать самый новый доступный релиз Python 3." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:116 msgid "" "And now we can build the dists from source and store them. In this example, " "we'll use the ``build`` package. So add this to the steps list:" msgstr "" +"Теперь мы можем собрать дисты из исходного кода и сохранить их. В этом " +"примере мы будем использовать пакет ``build``. Так что добавьте его в список " +"шагов:" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:126 msgid "Defining a workflow job environment" -msgstr "" +msgstr "Определение рабочей среды рабочего процесса" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:128 msgid "" @@ -7545,20 +8629,31 @@ msgid "" "acquiring an OpenID Connect token that the ``pypi-publish`` actions needs to " "implement secretless trusted publishing to PyPI." msgstr "" +"Теперь давайте добавим начальную настройку для нашего задания, которое будет " +"публиковаться в PyPI. Это процесс, который будет выполнять команды, которые " +"мы определим позже. В этом руководстве мы будем использовать последнюю " +"стабильную версию Ubuntu LTS, предоставленную GitHub Actions. Здесь также " +"определяется окружение GitHub для запуска задания в его контексте и URL-" +"адрес, который будет красиво отображаться в пользовательском интерфейсе " +"GitHub. Кроме того, она позволяет получить токен OpenID Connect, который " +"необходим действию ``pypi-publish`` для реализации секретной доверенной " +"публикации в PyPI." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:142 msgid "" "This will also ensure that the PyPI publishing workflow is only triggered if " "the current commit is tagged." msgstr "" +"Это также гарантирует, что рабочий процесс публикации PyPI будет запущен " +"только в том случае, если текущий коммит помечен." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:146 msgid "Publishing the distribution to PyPI" -msgstr "" +msgstr "Публикация дистрибутива в PyPI" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:148 msgid "Finally, add the following steps at the end:" -msgstr "" +msgstr "Наконец, добавьте следующие шаги в конце:" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:155 msgid "" @@ -7567,6 +8662,9 @@ msgid "" "action, it uploads the contents of the ``dist/`` folder into PyPI " "unconditionally." msgstr "" +"Этот шаг использует действие `pypa/gh-action-pypi-publish`_ GitHub: после " +"загрузки сохраненного дистрибутива действием `download-artifact`_, оно " +"безусловно загружает содержимое папки ``dist/`` в PyPI." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:161 msgid "Signing the distribution packages" @@ -7578,6 +8676,9 @@ msgid "" "artifact signing system `used to sign CPython `_." msgstr "" +"Следующее задание подписывает пакеты дистрибутива с помощью `Sigstore`_, той " +"же системы подписи артефактов, которая `использовалась для подписи CPython " +"`_." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:166 msgid "" @@ -7587,10 +8688,15 @@ msgid "" "further customised. See the `gh release documentation `_ as a reference." msgstr "" +"Сначала используется GitHub Action `sigstore/gh-action-sigstore-python`_ для " +"подписи дистрибутивных пакетов. На следующем этапе с помощью ``gh`` CLI " +"создается пустой GitHub Release из текущего тега. Обратите внимание, что " +"этот шаг может быть дополнительно настроен. См. документацию `gh release " +"`_ в качестве ссылки." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:172 msgid "Finally, the signed distributions are uploaded to the GitHub Release." -msgstr "" +msgstr "Наконец, подписанные дистрибутивы загружаются на GitHub Release." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:182 msgid "" @@ -7598,16 +8704,21 @@ msgid "" "`removed from PyPI `_. " "However, this job is not mandatory for uploading to PyPI and can be omitted." msgstr "" +"Это замена для подписей GPG, поддержка которых была `удалена из PyPI " +"`_. Тем не менее, это " +"задание не является обязательным для загрузки в PyPI и может быть пропущено." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:188 msgid "Separate workflow for publishing to TestPyPI" -msgstr "" +msgstr "Отдельный рабочий процесс для публикации в TestPyPI" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:190 msgid "" "Now, repeat these steps and create another job for publishing to the " "TestPyPI package index under the ``jobs`` section:" msgstr "" +"Теперь повторите эти шаги и создайте еще одно задание для публикации в " +"индекс пакета TestPyPI в разделе ``jobs``:" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:200 msgid "" @@ -7615,19 +8726,25 @@ msgid "" "typically unnecessary as it's designed to run on each commit to the main " "branch and is often used to indicate a healthy release publishing pipeline." msgstr "" +"Требование ручного одобрения в среде ``testpypi`` GitHub обычно не " +"требуется, поскольку она предназначена для выполнения каждого коммита в " +"основной ветке и часто используется для обозначения здорового конвейера " +"публикации pipрелизов." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:204 msgid "The whole CI/CD workflow" -msgstr "" +msgstr "Весь рабочий процесс CI/CD" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:206 msgid "" "This paragraph showcases the whole workflow after following the above guide." msgstr "" +"В этом пункте показан весь рабочий процесс после выполнения вышеописанного " +"руководства." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:214 msgid "That's all, folks!" -msgstr "" +msgstr "Вот и все, друзья!" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:216 msgid "" @@ -7636,6 +8753,11 @@ msgid "" "TestPyPI which is useful for providing test builds to your alpha users as " "well as making sure that your release pipeline remains healthy!" msgstr "" +"Теперь, когда бы вы ни отправили помеченный коммит в свой Git-репозиторий на " +"GitHub, этот рабочий процесс будет публиковать его в PyPI. И он будет " +"публиковать любой push в TestPyPI, что полезно для предоставления тестовых " +"сборок вашим альфа-пользователям, а также для того, чтобы убедиться, что ваш " +"конвейер релизовpip остаётся здоровым!" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:224 msgid "" @@ -7645,49 +8767,60 @@ msgid "" "increased, but a better solution may constitute to use a PyPI-compatible " "server like :ref:`pypiserver` in the CI for testing purposes." msgstr "" +"Если в вашем репозитории часто происходят коммиты и каждый push загружается " +"в TestPyPI, как описано выше, проект может превысить ограничение на размер " +"проекта `_. Лимит может быть " +"увеличен, но лучшим решением может быть использование PyPI-совместимого " +"сервера, например :ref:`pypiserver`, в CI для тестирования." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:232 msgid "" "It is recommended to keep the integrated GitHub Actions at their latest " "versions, updating them frequently." msgstr "" +"Рекомендуется поддерживать интегрированные GitHub Actions в последних " +"версиях и часто их обновлять." #: ../source/guides/section-build-and-publish.rst:3 msgid "Building and Publishing" -msgstr "" +msgstr "Строительство и публикации" #: ../source/guides/section-hosting.rst:3 msgid "Hosting" -msgstr "" +msgstr "Хостинг" #: ../source/guides/section-install.rst:3 -#, fuzzy msgid "Installation" -msgstr "Формат установки" +msgstr "Установка" #: ../source/guides/single-sourcing-package-version.rst:5 msgid "Single-sourcing the package version" -msgstr "" +msgstr "Однопользовательская версия пакета" #: ../source/guides/single-sourcing-package-version.rst:7 +#, fuzzy msgid "Todo" -msgstr "" +msgstr "Todo" #: ../source/guides/single-sourcing-package-version.rst:7 msgid "Update this page for build backends other than setuptools." -msgstr "" +msgstr "Обновите эту страницу для бэкендов сборки, отличных от setuptools." #: ../source/guides/single-sourcing-package-version.rst:9 msgid "" "There are many techniques to maintain a single source of truth for the " "version number of your project:" msgstr "" +"Существует множество методов поддержания единого источника истины для номера " +"версии вашего проекта:" #: ../source/guides/single-sourcing-package-version.rst:12 msgid "" "Read the file in :file:`setup.py` and get the version. Example (from `pip " "setup.py `_)::" msgstr "" +"Прочитайте файл в :file:`setup.py` и получите версию. Пример (из `pip " +"setup.py `_)::" #: ../source/guides/single-sourcing-package-version.rst:39 msgid "" @@ -7695,24 +8828,33 @@ msgid "" "instead placing the following in the project's :file:`setup.cfg` file " "(replacing \"package\" with the import name of the package):" msgstr "" +"Начиная с версии setuptools 46.4.0, можно сделать то же самое, поместив в " +"файл проекта :file:`setup.cfg` следующее (заменив \"package\" на импортное " +"имя пакета):" #: ../source/guides/single-sourcing-package-version.rst:49 msgid "" "As of the release of setuptools 61.0.0, one can specify the version " "dynamically in the project's :file:`pyproject.toml` file." msgstr "" +"Начиная с версии setuptools 61.0.0, можно динамически указывать версию в " +"файле проекта :file:`pyproject.toml`." #: ../source/guides/single-sourcing-package-version.rst:61 msgid "" "Please be aware that declarative config indicators, including the ``attr:`` " "directive, are not supported in parameters to :file:`setup.py`." msgstr "" +"Обратите внимание, что декларативные показатели конфигурации, включая " +"директиву ``attr:``, не поддерживаются в параметрах к :file:`setup.py``." #: ../source/guides/single-sourcing-package-version.rst:65 msgid "" "Use an external build tool that either manages updating both locations, or " "offers an API that both locations can use." msgstr "" +"Используйте внешний инструмент сборки, который либо управляет обновлением в " +"обоих местах, либо предлагает API, который могут использовать оба места." #: ../source/guides/single-sourcing-package-version.rst:68 msgid "" @@ -7721,6 +8863,11 @@ msgid "" "`_, `commitizen `_, `zest.releaser `_." msgstr "" +"Несколько инструментов, которые могут вам пригодиться, без особого порядка и " +"не обязательно полные: `bump2version `" +"_, `changes `_, `commitizen `_, `zest.releaser `_." #: ../source/guides/single-sourcing-package-version.rst:75 msgid "" @@ -7728,24 +8875,34 @@ msgid "" "your project (e.g. :file:`version.py`), then have :file:`setup.py` read and " "``exec`` the value into a variable." msgstr "" +"Задайте значение глобальной переменной ``__version__`` в специальном модуле " +"вашего проекта (например, :file:`version.py`), а затем пусть :file:`setup.py`" +" прочитает и ``исполнит`` значение в переменной." #: ../source/guides/single-sourcing-package-version.rst:86 msgid "" "Example using this technique: `warehouse `_." msgstr "" +"Пример использования этой техники: `warehouse `_." #: ../source/guides/single-sourcing-package-version.rst:88 msgid "" "Place the value in a simple ``VERSION`` text file and have both :file:`setup." "py` and the project code read it." msgstr "" +"Поместите это значение в простой текстовый файл ``VERSION`` и пусть его " +"читают как :file:`setup.py``, так и код проекта." #: ../source/guides/single-sourcing-package-version.rst:96 msgid "" "An advantage with this technique is that it's not specific to Python. Any " "tool can read the version." msgstr "" +"Преимущество этой техники в том, что она не привязана к Python. Любой " +"инструмент может прочитать версию." #: ../source/guides/single-sourcing-package-version.rst:101 msgid "" @@ -7753,6 +8910,9 @@ msgid "" "in all your source and binary distributions (e.g. add ``include VERSION`` to " "your :file:`MANIFEST.in`)." msgstr "" +"При таком подходе вы должны убедиться, что файл ``VERSION`` включен во все " +"ваши исходные и бинарные дистрибутивы (например, добавьте ``include VERSION``" +" в ваш :file:`MANIFEST.in``)." #: ../source/guides/single-sourcing-package-version.rst:105 msgid "" @@ -7762,6 +8922,11 @@ msgid "" "as the ``importlib-metadata`` project.) An installed project's version can " "be fetched with the API as follows::" msgstr "" +"Задайте значение в :file:`setup.py`, а код проекта пусть использует API " +"``importlib.metadata`` для получения значения во время выполнения. " +"(``importlib.metadata`` был представлен в Python 3.8 и доступен для более " +"старых версий в виде проекта ``importlib-metadata``). Версия установленного " +"проекта может быть получена с помощью API следующим образом::" #: ../source/guides/single-sourcing-package-version.rst:120 msgid "" @@ -7769,6 +8934,9 @@ msgid "" "installation metadata, which is not necessarily the code that's currently " "imported." msgstr "" +"Имейте в виду, что API ``importlib.metadata`` знает только о том, что " +"находится в метаданных установки, а это не обязательно код, который " +"импортируется в данный момент." #: ../source/guides/single-sourcing-package-version.rst:124 msgid "" @@ -7776,30 +8944,43 @@ msgid "" "``install_requires`` value needs to be edited to install ``importlib-" "metadata`` on pre-3.8 versions of Python like so::" msgstr "" +"Если проект использует этот метод для получения своей версии во время " +"выполнения, то его значение ``install_requires`` должно быть отредактировано " +"для установки ``importlib-metadata`` на версии Python до 3.8 следующим " +"образом::" #: ../source/guides/single-sourcing-package-version.rst:138 msgid "" "An older (and less efficient) alternative to ``importlib.metadata`` is the " "``pkg_resources`` API provided by ``setuptools``::" msgstr "" +"Более старой (и менее эффективной) альтернативой ``importlib.metadata`` " +"является API ``pkg_resources``, предоставляемый ``setuptools``::" #: ../source/guides/single-sourcing-package-version.rst:144 msgid "" "If a project uses ``pkg_resources`` to fetch its own version at runtime, " "then ``setuptools`` must be added to the project's ``install_requires`` list." msgstr "" +"Если проект использует ``pkg_resources`` для получения собственной версии во " +"время выполнения, то ``setuptools`` должен быть добавлен в список " +"``install_requires`` проекта." #: ../source/guides/single-sourcing-package-version.rst:148 msgid "" "Example using this technique: `setuptools `_." msgstr "" +"Пример использования этой техники: `setuptools `_." #: ../source/guides/single-sourcing-package-version.rst:151 msgid "" "Set the value to ``__version__`` in ``sample/__init__.py`` and import " "``sample`` in :file:`setup.py`." msgstr "" +"Установите значение ``__version__`` в файле ``sample/__init__.py`` и " +"импортируйте ``sample`` в :file:`setup.py``." #: ../source/guides/single-sourcing-package-version.rst:165 msgid "" @@ -7807,6 +8988,10 @@ msgid "" "__init__.py`` imports packages from ``install_requires`` dependencies, which " "will very likely not be installed yet when :file:`setup.py` is run." msgstr "" +"Хотя эта техника широко распространена, помните, что она не сработает, если " +"``sample/__init__.py`` импортирует пакеты из зависимостей " +"``install_requires``, которые, скорее всего, еще не будут установлены на " +"момент запуска :file:`setup.py``." #: ../source/guides/single-sourcing-package-version.rst:171 msgid "" @@ -7814,6 +8999,9 @@ msgid "" "Mercurial, etc) instead of in the code, and automatically extract it from " "there using `setuptools_scm `_." msgstr "" +"Храните номер версии в тегах системы контроля версий (Git, Mercurial и т.д.)" +", а не в коде, и автоматически извлекайте его оттуда с помощью `" +"setuptools_scm `_." #: ../source/guides/supporting-multiple-python-versions.rst:7 msgid "Supporting multiple Python versions" @@ -7827,6 +9015,11 @@ msgid "" "standard library packages, and the changes between Python versions 2.x and 3." "x include changes in the language syntax." msgstr "" +"Помимо работы, необходимой для создания пакета Python, часто возникает " +"необходимость сделать его доступным для разных версий Python. Разные версии " +"Python могут содержать разные (или переименованные) пакеты стандартной " +"библиотеки, а изменения между версиями Python 2.x и 3.x включают изменения в " +"синтаксисе языка." #: ../source/guides/supporting-multiple-python-versions.rst:42 msgid "" @@ -7835,6 +9028,10 @@ msgid "" "time-consuming. Fortunately, several tools are available for dealing with " "this, and these will briefly be discussed here." msgstr "" +"Если выполнять тестирование вручную, то все проверки, необходимые для " +"обеспечения корректной работы пакета на всех целевых версиях Python (и ОС!), " +"могут занять очень много времени. К счастью, существует несколько " +"инструментов для решения этой проблемы, о которых мы вкратце расскажем здесь." #: ../source/guides/supporting-multiple-python-versions.rst:48 msgid "Automated testing and continuous integration" @@ -7847,6 +9044,11 @@ msgid "" "github.com>`_ or `Bitbucket `_) and run your " "project's test suite every time a new commit is made." msgstr "" +"Существует несколько хостинговых сервисов для автоматизированного " +"тестирования. Эти сервисы обычно следят за вашим репозиторием исходного кода " +"(например, на `GitHub `_ или `Bitbucket " +"`_) и запускают набор тестов вашего проекта каждый " +"раз, когда делается новый коммит." #: ../source/guides/supporting-multiple-python-versions.rst:55 msgid "" @@ -7854,6 +9056,10 @@ msgid "" "*multiple versions of Python*, giving rapid feedback about whether the code " "will work, without the developer having to perform such tests themselves." msgstr "" +"Эти сервисы также предлагают возможности для запуска тестового набора вашего " +"проекта на *многих версиях Python*, что позволяет быстро получить информацию " +"о том, будет ли работать код, без необходимости разработчику самому " +"выполнять такие тесты." #: ../source/guides/supporting-multiple-python-versions.rst:59 msgid "" @@ -7862,6 +9068,11 @@ msgid "" "integration systems. There are two hosted services which when used in " "conjunction provide automated testing across Linux, Mac and Windows:" msgstr "" +"В Википедии есть обширное \"сравнение `_ многих систем непрерывной " +"интеграции\". Существует два хостинговых сервиса, которые при совместном " +"использовании обеспечивают автоматизированное тестирование в Linux, Mac и " +"Windows:" #: ../source/guides/supporting-multiple-python-versions.rst:65 msgid "" @@ -7869,12 +9080,18 @@ msgid "" "environment. The Linux environment is Ubuntu 12.04 LTS Server Edition 64 bit " "while the macOS is 10.9.2 at the time of writing." msgstr "" +"В системе Travis CI `_ есть как Linux, так и macOS. " +"Среда Linux - это Ubuntu 12.04 LTS Server Edition 64 bit, а macOS на момент " +"написания статьи - 10.9.2." #: ../source/guides/supporting-multiple-python-versions.rst:68 +#, fuzzy msgid "" "`Appveyor `_ provides a Windows environment " "(Windows Server 2012)." msgstr "" +"`Appveyor `_ предоставляет среду Windows (Windows " +"Server 2012)." #: ../source/guides/supporting-multiple-python-versions.rst:79 msgid "" @@ -7882,16 +9099,23 @@ msgid "" "formatted file as specification for the instructions for testing. If any " "tests fail, the output log for that specific configuration can be inspected." msgstr "" +"И `Travis CI`_, и Appveyor_ требуют файл формата `YAML `_ " +"в качестве спецификации инструкций для тестирования. Если какие-либо тесты " +"провалены, можно просмотреть журнал вывода для данной конкретной " +"конфигурации." #: ../source/guides/supporting-multiple-python-versions.rst:84 msgid "" "For Python projects that are intended to be deployed on both Python 2 and 3 " "with a single-source strategy, there are a number of options." msgstr "" +"Для проектов на Python, которые предполагается развернуть как на Python 2, " +"так и на Python 3 с использованием стратегии единого источника, есть " +"несколько вариантов." #: ../source/guides/supporting-multiple-python-versions.rst:88 msgid "Tools for single-source Python packages" -msgstr "" +msgstr "Инструменты для создания пакетов Python с одним источником" #: ../source/guides/supporting-multiple-python-versions.rst:90 msgid "" @@ -7904,6 +9128,15 @@ msgid "" "Armin Ronacher, can be used to automatically apply the code modifications " "provided by six_." msgstr "" +"`six `_ - это инструмент, разработанный " +"Бенджамином Петерсоном для преодоления различий между Python 2 и Python 3. " +"Пакет six_ получил широкое распространение и может рассматриваться как " +"надежный способ написать модуль Python с одним исходным кодом, который можно " +"использовать как в Python 2, так и в Python 3. Модуль six_ можно " +"использовать уже в Python 2.5. Инструмент под названием `modernize " +"`_, разработанный Армином Ронахером, " +"может быть использован для автоматического применения модификаций кода, " +"предоставляемых six_." #: ../source/guides/supporting-multiple-python-versions.rst:99 msgid "" @@ -7913,14 +9146,19 @@ msgid "" "interoperability between Python 2 and Python 3 with a language syntax that " "matches one of the two Python versions: one may use" msgstr "" +"Как и six_, `python-future `_ - это " +"пакет, обеспечивающий слой совместимости между исходным кодом Python 2 и " +"Python 3; однако, в отличие от six_, этот пакет направлен на обеспечение " +"совместимости между Python 2 и Python 3 с синтаксисом языка, соответствующим " +"одной из двух версий Python: можно использовать" #: ../source/guides/supporting-multiple-python-versions.rst:106 msgid "a Python 2 (by syntax) module in a Python 3 project." -msgstr "" +msgstr "модуль Python 2 (по синтаксису) в проекте Python 3." #: ../source/guides/supporting-multiple-python-versions.rst:107 msgid "a Python 3 (by syntax) module in a *Python 2* project." -msgstr "" +msgstr "модуль Python 3 (по синтаксису) в проекте *Python 2*." #: ../source/guides/supporting-multiple-python-versions.rst:109 msgid "" @@ -7931,6 +9169,12 @@ msgid "" "``futurize`` and ``pasteurize`` that can be applied to either a Python 2 " "module or a Python 3 module respectively." msgstr "" +"Благодаря двунаправленности, python-future_ предлагает путь к преобразованию " +"пакета Python 2 в синтаксис Python 3 модуль за модулем. Однако, в отличие от " +"six_, python-future_ поддерживается только начиная с Python 2.6. Подобно " +"modernize_ для six_, python-future_ поставляется с двумя скриптами " +"``futurize`` и ``pasteurize``, которые могут быть применены как к модулю " +"Python 2, так и к модулю Python 3 соответственно." #: ../source/guides/supporting-multiple-python-versions.rst:116 msgid "" @@ -7940,10 +9184,15 @@ msgid "" "provides for forward-compatibility to Python 3. Any remaining compatibility " "problems would require manual changes." msgstr "" +"Использование six_ или python-future_ добавляет дополнительную зависимость " +"от времени выполнения: при использовании python-future_ скрипт ``futurize`` " +"может быть вызван с опцией ``--stage1`` для применения только тех изменений, " +"которые Python 2.6+ уже обеспечивает для прямой совместимости с Python 3. " +"Любые оставшиеся проблемы совместимости потребуют внесения изменений вручную." #: ../source/guides/supporting-multiple-python-versions.rst:123 msgid "What's in which Python?" -msgstr "" +msgstr "Что находится в каком Python?" #: ../source/guides/supporting-multiple-python-versions.rst:125 msgid "" @@ -7954,6 +9203,13 @@ msgid "" "com/blog/201803/whats_in_which_python_3436.html>`__. These lists may be used " "to check whether any changes between Python versions may affect your package." msgstr "" +"Нед Батчелдер приводит список изменений в каждом выпуске Python для `Python " +"2 `__, `" +"Python 3.0-3.3 `__ и `Python 3.4-3.6 `__. Эти списки можно использовать для " +"проверки того, могут ли какие-либо изменения между версиями Python повлиять " +"на ваш пакет." #: ../source/guides/supporting-windows-using-appveyor.rst:5 msgid "Supporting Windows using Appveyor" @@ -7970,6 +9226,10 @@ msgid "" "the code on Windows, and building Windows-targeted binaries for projects " "that use C extensions." msgstr "" +"В этом разделе рассказывается о том, как использовать бесплатную службу " +"непрерывной интеграции `Appveyor`_ для обеспечения поддержки Windows в вашем " +"проекте. Сюда входит тестирование кода под Windows и сборка двоичных файлов, " +"ориентированных на Windows, для проектов, использующих расширения C." #: ../source/guides/supporting-windows-using-appveyor.rst:19 msgid "" @@ -7977,6 +9237,10 @@ msgid "" "support can be a challenge, because setting up a suitable Windows test " "environment is non-trivial, and may require buying software licenses." msgstr "" +"Многие проекты по умолчанию разрабатываются на Unix, и обеспечение поддержки " +"Windows может быть сложной задачей, поскольку создание подходящей тестовой " +"среды Windows нетривиально и может потребовать покупки лицензий на " +"программное обеспечение." #: ../source/guides/supporting-windows-using-appveyor.rst:23 msgid "" @@ -7986,6 +9250,11 @@ msgid "" "are Windows hosts and have the necessary compilers installed to build Python " "extensions." msgstr "" +"Сервис Appveyor - это сервис непрерывной интеграции, подобный более " +"известному сервису `Travis`_, который обычно используется для тестирования " +"проектов, размещенных на `GitHub`_. Однако, в отличие от Travis, рабочие " +"сборщики Appveyor являются хостами Windows и имеют необходимые компиляторы " +"для сборки расширений Python." #: ../source/guides/supporting-windows-using-appveyor.rst:29 msgid "" @@ -7996,6 +9265,13 @@ msgid "" "for testing) it is possible for projects without a dedicated Windows " "environment to provide Windows-targeted binaries." msgstr "" +"Пользователи Windows, как правило, не имеют доступа к компилятору языка C, " +"поэтому проекты, использующие расширения C, должны распространять бинарные " +"колеса на PyPI, чтобы дистрибутив можно было установить с помощью ``python -" +"m pip install ``. Использование Appveyor в качестве сервиса сборки (" +"даже если он не используется для тестирования) позволяет проектам, не " +"имеющим выделенной среды Windows, предоставлять двоичные файлы, " +"ориентированные на Windows." #: ../source/guides/supporting-windows-using-appveyor.rst:37 msgid "Setting up" @@ -8008,6 +9284,11 @@ msgid "" "given in `the Appveyor documentation `__. " "The free tier of account is perfectly adequate for open source projects." msgstr "" +"Чтобы использовать Appveyor для сборки Windows-колес для вашего проекта, вы " +"должны иметь учетную запись на этом сервисе. Инструкции по настройке учетной " +"записи приведены в документации Appveyor `" +"__. Бесплатный уровень учетной записи вполне подходит для проектов с " +"открытым исходным кодом." #: ../source/guides/supporting-windows-using-appveyor.rst:44 msgid "" @@ -8015,6 +9296,9 @@ msgid "" "your project is hosted on one of those two services, setting up Appveyor " "integration is straightforward." msgstr "" +"Appveyor обеспечивает интеграцию с `GitHub`_ и `Bitbucket`_, поэтому, если " +"ваш проект размещен на одном из этих двух сервисов, настройка интеграции с " +"Appveyor не составит труда." #: ../source/guides/supporting-windows-using-appveyor.rst:48 msgid "" @@ -8022,6 +9306,9 @@ msgid "" "will automatically build your project each time a commit occurs. This " "behaviour will be familiar to users of Travis." msgstr "" +"После того, как вы настроили свой аккаунт Appveyor и добавили проект, " +"Appveyor будет автоматически собирать ваш проект каждый раз, когда " +"происходит коммит. Такое поведение будет знакомо пользователям Travis." #: ../source/guides/supporting-windows-using-appveyor.rst:53 msgid "Adding Appveyor support to your project" @@ -8034,6 +9321,10 @@ msgid "" "be included in the file are covered in the Appveyor documentation. This " "guide will provide the details necessary to set up wheel builds." msgstr "" +"Для того чтобы определить, как Appveyor должен собирать ваш проект, вам " +"необходимо добавить в проект файл :file:`appveyor.yml`. Все подробности о " +"том, что может быть включено в этот файл, описаны в документации Appveyor. В " +"этом руководстве мы расскажем о том, как настроить сборку колес." #: ../source/guides/supporting-windows-using-appveyor.rst:60 msgid "" @@ -8045,6 +9336,13 @@ msgid "" "version of Visual Studio used includes 64-bit compilers with no additional " "setup)." msgstr "" +"Appveyor по умолчанию включает в себя все цепочки инструментов компилятора, " +"необходимые для создания расширений для Python. Для Python 2.7, 3.5+ и 32-" +"битных версий 3.3 и 3.4 инструменты работают из коробки. Но для 64-битных " +"версий Python 3.3 и 3.4 требуется небольшая дополнительная настройка, чтобы " +"distutils знал, где найти 64-битные компиляторы. (Начиная с версии 3.5, " +"используемая версия Visual Studio включает 64-битные компиляторы без " +"дополнительных настроек)." #: ../source/guides/supporting-windows-using-appveyor.rst:68 msgid "appveyor.yml" @@ -8056,12 +9354,17 @@ msgid "" "pypa/python-packaging-user-guide/master/source/guides/appveyor-sample/" "appveyor.yml>`__." msgstr "" +"Этот файл можно скачать отсюда `__." #: ../source/guides/supporting-windows-using-appveyor.rst:76 msgid "" "The :file:`appveyor.yml` file must be located in the root directory of your " "project. It is in ``YAML`` format, and consists of a number of sections." msgstr "" +"Файл :file:`appveyor.yml` должен находиться в корневом каталоге вашего " +"проекта. Он имеет формат ``YAML`` и состоит из нескольких секций." #: ../source/guides/supporting-windows-using-appveyor.rst:79 msgid "" @@ -8073,6 +9376,14 @@ msgid "" "support 2.6 in this document (as Windows users still using Python 2 are " "generally able to move to Python 2.7 without too much difficulty)." msgstr "" +"Раздел ``окружение`` - это ключ к определению версий Python, для которых " +"будут создаваться ваши колеса. Appveyor поставляется с установленным Python " +"2.6, 2.7, 3.3, 3.4 и 3.5, как в 32-битных, так и в 64-битных сборках. Файл " +"примера собирается для всех этих сред, кроме Python 2.6. Установка для " +"Python 2.6 более сложна, так как в комплект поставки не входит pip. Мы не " +"поддерживаем 2.6 в этом документе (поскольку пользователи Windows, все еще " +"использующие Python 2, обычно могут перейти на Python 2.7 без особых " +"проблем)." #: ../source/guides/supporting-windows-using-appveyor.rst:87 msgid "" @@ -8082,18 +9393,28 @@ msgid "" "circumstances (for example, to install additional build packages such as " "``Cython``, or test tools such as ``tox``)." msgstr "" +"В разделе ``install`` используется pip для установки любого дополнительного " +"программного обеспечения, которое может потребоваться проекту. Единственным " +"требованием для сборки колес является проект ``wheel``, но проекты могут " +"захотеть изменить этот код в определенных обстоятельствах (например, для " +"установки дополнительных пакетов сборки, таких как ``Cython``, или " +"инструментов тестирования, таких как ``tox``)." #: ../source/guides/supporting-windows-using-appveyor.rst:93 msgid "" "The ``build`` section simply switches off builds - there is no build step " "needed for Python, unlike languages like ``C#``." msgstr "" +"Секция ``build`` просто отключает сборку - в отличие от таких языков, как " +"``C#``, для Python не требуется никаких действий по сборке." #: ../source/guides/supporting-windows-using-appveyor.rst:96 msgid "" "The main sections that will need to be tailored to your project are " "``test_script`` and ``after_test``." msgstr "" +"Основные секции, которые необходимо адаптировать под ваш проект, - это " +"``тестовый_скрипт`` и ``после_теста``." #: ../source/guides/supporting-windows-using-appveyor.rst:99 msgid "" @@ -8106,6 +9427,15 @@ msgid "" "you are using ``tox`` there are some additional configuration changes you " "will need to consider, which are described below." msgstr "" +"Раздел ``тест_скрипт`` - это место, где вы будете запускать тесты вашего " +"проекта. В прилагаемом файле набор тестов запускается с помощью команды ``" +"setup.py test``. Если вас интересует только сборка колес, а не запуск тестов " +"под Windows, вы можете заменить этот раздел фиктивной командой, например ``" +"echo Skipped Tests``. Возможно, вы захотите использовать другой инструмент " +"тестирования, например ``nose`` или :file:`py.test``. Или вы можете " +"использовать тестовый драйвер, например ``tox`` - однако если вы используете " +"``tox``, вам придется внести некоторые дополнительные изменения в " +"конфигурацию, которые описаны ниже." #: ../source/guides/supporting-windows-using-appveyor.rst:108 msgid "" @@ -8114,12 +9444,19 @@ msgid "" "(specifically, ``setuptools``) then the ``setup.py bdist_wheel`` command " "will build your wheels." msgstr "" +"Команда ``after_test`` запускается после завершения тестов, и именно в ней " +"должны быть собраны колеса. Если ваш проект использует рекомендуемые " +"инструменты (в частности, ``setuptools``), то команда ``setup.py " +"bdist_wheel'' соберет ваши колеса." #: ../source/guides/supporting-windows-using-appveyor.rst:113 msgid "" "Note that wheels will only be built if your tests succeed. If you expect " "your tests to fail on Windows, you can skip them as described above." msgstr "" +"Обратите внимание, что колеса будут собраны только в том случае, если ваши " +"тесты пройдут успешно. Если вы ожидаете, что ваши тесты не пройдут под " +"Windows, вы можете пропустить их, как описано выше." #: ../source/guides/supporting-windows-using-appveyor.rst:118 msgid "Support script" @@ -8132,6 +9469,11 @@ msgid "" "and 3.4. For projects which do not need a compiler, or which don't support " "3.3 or 3.4 on 64-bit Windows, only the :file:`appveyor.yml` file is needed." msgstr "" +"Файл :file:`appveyor.yml` опирается на единственный скрипт поддержки, " +"который настраивает среду для использования компилятора SDK для 64-битных " +"сборок на Python 3.3 и 3.4. Для проектов, которым не нужен компилятор или " +"которые не поддерживают 3.3 или 3.4 на 64-битной Windows, необходим только " +"файл :file:`appveyor.yml`." #: ../source/guides/supporting-windows-using-appveyor.rst:125 msgid "" @@ -8144,12 +9486,22 @@ msgid "" "Python 3.3 or 3.4, so don't set the environment variable for any other " "builds." msgstr "" +"``build.cmd ``" +"__ - это пакетный скрипт для Windows, который запускает единственную команду " +"в среде с компилятором, соответствующим выбранной версии Python. Все, что " +"вам нужно сделать, это установить единственную переменную окружения " +"``DISTUTILS_USE_SDK`` в ``1``, а все остальное сделает скрипт. Он " +"устанавливает SDK, необходимый для 64-битных сборок Python 3.3.3 или 3.4, " +"поэтому не устанавливайте переменную окружения для других сборок." #: ../source/guides/supporting-windows-using-appveyor.rst:132 msgid "" "You can simply download the batch file and include it in your project " "unchanged." msgstr "" +"Вы можете просто загрузить пакетный файл и включить его в свой проект без " +"изменений." #: ../source/guides/supporting-windows-using-appveyor.rst:136 msgid "Access to the built wheels" @@ -8165,6 +9517,13 @@ msgid "" "architecture. You can download those wheels and upload them to PyPI as part " "of your release process." msgstr "" +"Когда сборка завершится, построенные колеса будут доступны в панели " +"управления Appveyor для вашего проекта. Их можно найти, перейдя на страницу " +"состояния сборки для каждой сборки по очереди. В верхней части результатов " +"сборки есть ряд ссылок, одна из которых - \"Артефакты\". На этой странице " +"будет список ссылок на колеса для данной версии/архитектуры Python. Вы " +"можете скачать эти колеса и загрузить их в PyPI как часть вашего процесса " +"выпуска." #: ../source/guides/supporting-windows-using-appveyor.rst:146 msgid "Additional notes" @@ -8180,6 +9539,9 @@ msgid "" "ensures that tests are run in an isolated environment using the exact files " "that will be distributed by the project." msgstr "" +"Многие проекты используют инструмент :doc:`Tox ` для запуска " +"своих тестов. Он обеспечивает запуск тестов в изолированном окружении с " +"использованием именно тех файлов, которые будут распространяться проектом." #: ../source/guides/supporting-windows-using-appveyor.rst:155 msgid "" @@ -8187,6 +9549,9 @@ msgid "" "considerations (in actual fact, these issues are not specific to Appveyor, " "and may well affect other CI systems)." msgstr "" +"Для использования ``tox`` в Appveyor есть пара дополнительных соображений (" +"на самом деле, эти вопросы не относятся к Appveyor и вполне могут " +"затрагивать другие CI-системы)." #: ../source/guides/supporting-windows-using-appveyor.rst:159 msgid "" @@ -8195,6 +9560,11 @@ msgid "" "control the compiler, this \"test isolation\" feature will cause the tests " "to use the wrong compiler by default." msgstr "" +"По умолчанию ``tox`` передает тестовым процессам только выбранное " +"подмножество переменных окружения. Поскольку ``distutils`` использует " +"переменные окружения для управления компилятором, эта функция \"изоляции " +"тестов\" приведет к тому, что тесты по умолчанию будут использовать " +"неправильный компилятор." #: ../source/guides/supporting-windows-using-appveyor.rst:164 msgid "" @@ -8203,6 +9573,10 @@ msgid "" "list the additional environment variables to be passed to the subprocess. " "For the SDK compilers, you need" msgstr "" +"Чтобы заставить ``tox`` передавать подпроцессу необходимые переменные " +"окружения, нужно установить в конфигурационной опции ``tox`` ``passenv`` " +"список дополнительных переменных окружения, которые нужно передать " +"подпроцессу. Для компиляторов SDK необходимо" #: ../source/guides/supporting-windows-using-appveyor.rst:169 msgid "``DISTUTILS_USE_SDK``" @@ -8228,6 +9602,11 @@ msgid "" "supplied :file:`build.cmd` script does this by default whenever " "``DISTUTILS_USE_SDK`` is set." msgstr "" +"Опция ``passenv`` может быть задана в вашем :file:`tox.ini`, или, если вы " +"предпочитаете не добавлять специфические для Windows настройки в общие файлы " +"проекта, ее можно задать, установив переменную окружения " +"``TOX_TESTENV_PASSENV``. Поставляемый в комплекте скрипт :file:`build.cmd` " +"делает это по умолчанию, когда установлено значение ``DISTUTILS_USE_SDK``." #: ../source/guides/supporting-windows-using-appveyor.rst:180 msgid "" @@ -8239,6 +9618,13 @@ msgid "" "specify which environment to use (there are default environments for most " "versions of Python)." msgstr "" +"При интерактивном использовании ``tox`` позволяет запускать тесты в " +"нескольких окружениях (часто это означает несколько версий Python). Эта " +"возможность не так полезна в среде CI, такой как Travis или Appveyor, где " +"все тесты запускаются в изолированных окружениях для каждой конфигурации. В " +"результате проекты часто передают аргумент ``-e ENVNAME`` в ``tox``, чтобы " +"указать, какое окружение использовать (есть окружения по умолчанию для " +"большинства версий Python)." #: ../source/guides/supporting-windows-using-appveyor.rst:187 msgid "" @@ -8246,6 +9632,9 @@ msgid "" "where there are (for example) two installations of Python 3.4 (32-bit and 64-" "bit) available, but only one ``py34`` environment in ``tox``." msgstr "" +"Однако это *не* хорошо работает с системой Windows CI, такой как Appveyor, " +"где (например) доступны две установки Python 3.4 (32-битная и 64-битная), но " +"только одно окружение ``py34`` в ``tox``." #: ../source/guides/supporting-windows-using-appveyor.rst:191 msgid "" @@ -8254,6 +9643,11 @@ msgid "" "that was used to run ``tox``. This will ensure that when Appveyor runs the " "tests, they will be run with the configured interpreter." msgstr "" +"Поэтому для запуска тестов с помощью ``tox`` проектам, вероятно, следует " +"использовать стандартное окружение ``py`` в ``tox``, которое использует " +"интерпретатор Python, использовавшийся для запуска ``tox``. Это гарантирует, " +"что когда Appveyor запустит тесты, они будут запущены с настроенным " +"интерпретатором." #: ../source/guides/supporting-windows-using-appveyor.rst:196 msgid "" @@ -8262,6 +9656,9 @@ msgid "" "their :file:`tox.ini` file. Doing so is, however, outside the scope of this " "document." msgstr "" +"Для поддержки работы в среде ``py``, возможно, проектам со сложной " +"конфигурацией ``tox`` потребуется изменить свой файл :file:`tox.ini`. Однако " +"это выходит за рамки данного документа." #: ../source/guides/supporting-windows-using-appveyor.rst:202 msgid "Automatically uploading wheels" @@ -8274,6 +9671,10 @@ msgid "" "(for example) copy the built artifacts to a FTP site, or an Amazon S3 " "instance. Documentation on how to do this is included in the Appveyor guides." msgstr "" +"Можно попросить Appveyor автоматически загружать колеса. В :file:`appveyor." +"yml` есть шаг ``развертывания``, который можно использовать, чтобы (например)" +" скопировать собранные артефакты на FTP-сайт или в экземпляр Amazon S3. " +"Документация о том, как это сделать, включена в руководства по Appveyor." #: ../source/guides/supporting-windows-using-appveyor.rst:209 msgid "" @@ -8282,6 +9683,10 @@ msgid "" "clear that uploading new wheels after every commit is desirable (although " "some projects may wish to do this)." msgstr "" +"В качестве альтернативы можно было бы добавить в сборку шаг ``twine upload``" +". Поставляемый :file:`appveyor.yml` этого не делает, поскольку неясно, " +"насколько желательна загрузка новых колес после каждого коммита (хотя " +"некоторые проекты могут захотеть это сделать)." #: ../source/guides/supporting-windows-using-appveyor.rst:215 msgid "External dependencies" @@ -8292,6 +9697,8 @@ msgid "" "The supplied scripts will successfully build any distribution that does not " "rely on 3rd party external libraries for the build." msgstr "" +"Прилагаемые скрипты успешно соберут любой дистрибутив, который не зависит от " +"сторонних внешних библиотек для сборки." #: ../source/guides/supporting-windows-using-appveyor.rst:220 msgid "" @@ -8302,6 +9709,11 @@ msgid "" "to the compiler. However, this level of configuration is beyond the scope of " "this document." msgstr "" +"В конфигурацию :file:`appveyor.yml` можно добавить шаги (обычно в разделе " +"\"install\") для загрузки и/или сборки внешних библиотек, необходимых " +"дистрибутиву. При необходимости можно добавить дополнительную конфигурацию " +"для сборки, чтобы указать компилятору местоположение этих библиотек. Однако " +"такой уровень конфигурации выходит за рамки данного документа." #: ../source/guides/supporting-windows-using-appveyor.rst:229 msgid "Support scripts" @@ -8309,7 +9721,7 @@ msgstr "Скрипты поддержки" #: ../source/guides/supporting-windows-using-appveyor.rst:231 msgid "For reference, the SDK setup support script is listed here:" -msgstr "" +msgstr "Для справки, сценарий поддержки установки SDK приведен здесь:" #: ../source/guides/supporting-windows-using-appveyor.rst:233 msgid "``appveyor-sample/build.cmd``" @@ -8324,6 +9736,8 @@ msgid "" "If you're familiar with Python packaging and installation, and just want to " "know what tools are currently recommended, then here it is." msgstr "" +"Если вы знакомы с упаковкой и установкой Python и просто хотите узнать, " +"какие инструменты сейчас рекомендуются, то вам сюда." #: ../source/guides/tool-recommendations.rst:12 msgid "Application dependency management" @@ -8334,12 +9748,17 @@ msgid "" "Use :ref:`pip` in a `secure manner`_ to install a Python application and its " "dependencies during deployment." msgstr "" +"Используйте :ref:`pip` `безопасным способом`_ для установки приложения " +"Python и его зависимостей во время развертывания." #: ../source/guides/tool-recommendations.rst:17 msgid "" "Use :ref:`virtualenv` or :doc:`venv ` to isolate " "application-specific dependencies from a shared Python installation. [4]_" msgstr "" +"Используйте :ref:`virtualenv` или :doc:`venv ` для " +"изоляции специфических для приложения зависимостей от общей установки " +"Python. [4]_" #: ../source/guides/tool-recommendations.rst:20 msgid "" @@ -8347,6 +9766,9 @@ msgid "" "specified application-specific dependencies, when developing Python " "applications." msgstr "" +"Используйте `pip-tools`_, :ref:`pipenv` или `poetry`_ для генерации " +"полностью определенных зависимостей, специфичных для приложения, при " +"разработке приложений на Python." #: ../source/guides/tool-recommendations.rst:28 msgid "Installation tool recommendations" @@ -8359,28 +9781,42 @@ msgid "" "ref:`pip` is installed, you may need to also install :ref:`wheel` to get the " "benefit of wheel caching. [3]_" msgstr "" +"Используйте :ref:`pip` для установки Python :term:`packages <Дистрибутивный " +"пакет>` из :term:`PyPI <Индекс пакетов Python (PyPI)>`. [1]_ [2]_ В " +"зависимости от того, как установлен :ref:`pip`, вам может потребоваться " +"также установить :ref:`wheel`, чтобы получить преимущества кэширования " +"колес. [3]_" #: ../source/guides/tool-recommendations.rst:35 msgid "" "Use :ref:`virtualenv` or :doc:`venv ` to isolate " "project-specific dependencies from a shared Python installation. [4]_" msgstr "" +"Используйте :ref:`virtualenv` или :doc:`venv `, чтобы " +"изолировать специфические для проекта зависимости от общей установки Python. " +"[4]_" #: ../source/guides/tool-recommendations.rst:38 msgid "" "If you're looking for management of fully integrated cross-platform software " "stacks, consider:" msgstr "" +"Если вам требуется управление полностью интегрированными кроссплатформенными " +"программными стеками, рассмотрите этот вариант:" #: ../source/guides/tool-recommendations.rst:41 msgid ":ref:`buildout`: primarily focused on the web development community" msgstr "" +":ref:`buildout`: в первую очередь ориентирован на сообщество " +"веб-разработчиков" #: ../source/guides/tool-recommendations.rst:43 msgid "" ":ref:`spack`, :ref:`hashdist`, or :ref:`conda`: primarily focused on the " "scientific community." msgstr "" +":ref:`spack`, :ref:`hashdist` или :ref:`conda`: в первую очередь " +"ориентированы на научное сообщество." #: ../source/guides/tool-recommendations.rst:48 msgid "Packaging tool recommendations" @@ -8388,13 +9824,15 @@ msgstr "Рекомендации по инструментам упаковки" #: ../source/guides/tool-recommendations.rst:50 msgid "Use :ref:`setuptools` to define projects. [5]_ [6]_" -msgstr "" +msgstr "Используйте :ref:`setuptools` для определения проектов. [5]_ [6]_" #: ../source/guides/tool-recommendations.rst:52 msgid "" "Use :ref:`build` to create :term:`Source Distributions ` and :term:`wheels `." msgstr "" +"Используйте :ref:`build` для создания :term:`Source Distributions ` и :term:`wheels `." #: ../source/guides/tool-recommendations.rst:55 msgid "" @@ -8402,16 +9840,21 @@ msgid "" "platforms, use :ref:`cibuildwheel` as part of your CI setup to build " "distributable wheels." msgstr "" +"Если у вас есть бинарные расширения и вы хотите распространять колеса для " +"нескольких платформ, используйте :ref:`cibuildwheel` как часть вашей " +"настройки CI для сборки распространяемых колес." #: ../source/guides/tool-recommendations.rst:59 msgid "" "Use `twine `_ for uploading distributions " "to :term:`PyPI `." msgstr "" +"Используйте `twine `_ для загрузки " +"дистрибутивов в :term:`PyPI `." #: ../source/guides/tool-recommendations.rst:64 msgid "Publishing platform migration" -msgstr "" +msgstr "Миграция издательской платформы" #: ../source/guides/tool-recommendations.rst:66 msgid "" @@ -8419,12 +9862,19 @@ msgid "" "python.org `_) has been phased out in favour of an " "updated implementation hosted at `pypi.org `_." msgstr "" +"Оригинальная реализация Python Package Index (ранее размещавшаяся по адресу `" +"pypi.python.org `_) была постепенно отменена в " +"пользу обновленной реализации, размещенной по адресу `pypi.org `_." #: ../source/guides/tool-recommendations.rst:70 msgid "" "See :ref:`Migrating to PyPI.org` for more information on the status of the " "migration, and what settings to change in your clients." msgstr "" +"Смотрите :ref:`Миграция на PyPI.org` для получения дополнительной информации " +"о статусе миграции и о том, какие настройки следует изменить в ваших " +"клиентах." #: ../source/guides/tool-recommendations.rst:75 msgid "" @@ -8433,6 +9883,10 @@ msgid "" "(which pip doesn't support). For a detailed breakdown, see :ref:`pip vs " "easy_install`." msgstr "" +"В некоторых случаях вы можете использовать ``easy_install`` (из " +":ref:`setuptools``), например, если вам нужно установить из :term:`Eggs " +"` (что pip не поддерживает). Подробное описание смотрите в :ref:`pip " +"vs easy_install`." #: ../source/guides/tool-recommendations.rst:80 msgid "" @@ -8441,6 +9895,9 @@ msgid "" "`rationale section <453#rationale>` from :pep:`453` as for why pip was " "chosen." msgstr "" +"Принятие :pep:`453` означает, что :ref:`pip` будет доступен по умолчанию в " +"большинстве установок Python 3.4 или более поздних версий. О том, почему " +"был выбран pip, читайте в разделе <453#rationale> из :pep:`453`." #: ../source/guides/tool-recommendations.rst:85 msgid "" @@ -8450,6 +9907,11 @@ msgid "" "found in various linux distros, does not depend on \"python-wheel\" " "currently." msgstr "" +"`get-pip.py `_ и :ref:`virtualenv` " +"устанавливают :ref:`wheel`, тогда как :ref:`ensurepip` и :ref:`venv ` " +"в настоящее время не устанавливают. Кроме того, распространенный пакет " +"\"python-pip\", который можно найти в различных дистрибутивах linux, в " +"настоящее время не зависит от \"python-wheel\"." #: ../source/guides/tool-recommendations.rst:91 msgid "" @@ -8458,6 +9920,11 @@ msgid "" "`virtualenv`. However, using :ref:`virtualenv` will still be recommended for " "users that need cross-version consistency." msgstr "" +"Начиная с Python 3.4, ``venv`` будет создавать среды virtualenv с " +"установленным ``pip``, тем самым делая его равноправной альтернативой " +":ref:`virtualenv``. Тем не менее, использование :ref:`virtualenv` по-" +"прежнему рекомендуется для пользователей, которым необходима кросс-" +"версионная согласованность." #: ../source/guides/tool-recommendations.rst:96 msgid "" @@ -8470,6 +9937,14 @@ msgid "" "``setuptools`` support all of the modern metadata fields described in :ref:" "`core-metadata`." msgstr "" +"Хотя вы можете использовать чистый :ref:`distutils` для многих проектов, он " +"не поддерживает определение зависимостей от других проектов и лишен " +"нескольких удобных утилит для автоматического заполнения метаданных " +"дистрибутива, которые предоставляются ``setuptools``. Находясь вне " +"стандартной библиотеки, ``setuptools`` также предлагает более согласованный " +"набор функций в разных версиях Python, и (в отличие от ``distutils``) " +"последние версии ``setuptools`` поддерживают все современные поля " +"метаданных, описанные в :ref:`core-metadata``." #: ../source/guides/tool-recommendations.rst:105 msgid "" @@ -8478,22 +9953,31 @@ msgid "" "prebuilt :term:`wheel ` file), it will actually build your project " "using :ref:`setuptools` instead." msgstr "" +"Даже для проектов, которые решили использовать ``distutils``, когда " +":ref:`pip` устанавливает такие проекты непосредственно из исходного кода (а " +"не устанавливает из предварительно собранного файла :term:`wheel `), " +"он фактически соберет ваш проект, используя вместо этого :ref:`setuptools``." #: ../source/guides/tool-recommendations.rst:110 msgid "" "`distribute`_ (a fork of setuptools) was merged back into :ref:`setuptools` " "in June 2013, thereby making setuptools the default choice for packaging." msgstr "" +"`distribute`_ (форк setuptools) был объединен обратно в :ref:`setuptools` в " +"июне 2013 года, тем самым сделав setuptools выбором по умолчанию для " +"упаковки." #: ../source/guides/using-manifest-in.rst:5 msgid "Including files in source distributions with ``MANIFEST.in``" -msgstr "" +msgstr "Включение файлов в исходные дистрибутивы с помощью ``MANIFEST.in``" #: ../source/guides/using-manifest-in.rst:7 msgid "" "The information on this page has moved to :doc:`setuptools:userguide/" "miscellaneous` in the setuptools documentation." msgstr "" +"Информация на этой странице была перемещена в :doc:`setuptools:userguide/" +"miscellaneous` в документации по setuptools." #: ../source/guides/using-testpypi.rst:7 msgid "" @@ -8502,6 +9986,10 @@ msgid "" "without worrying about affecting the real index. TestPyPI is hosted at `test." "pypi.org `_" msgstr "" +"``TestPyPI`` - это отдельный экземпляр :term:``Python Package Index (PyPI)``" +", который позволяет вам опробовать инструменты и процесс распространения, не " +"беспокоясь о том, что это повлияет на настоящий индекс. TestPyPI размещен по " +"адресу `test.pypi.org `_" #: ../source/guides/using-testpypi.rst:13 msgid "Registering your account" @@ -8513,12 +10001,18 @@ msgid "" "separate user account specifically for TestPyPI. Go to https://test.pypi.org/" "account/register/ to register your account." msgstr "" +"Поскольку TestPyPI имеет отдельную базу данных от живого PyPI, вам " +"понадобится отдельная учетная запись пользователя специально для TestPyPI. " +"Перейдите на https://test.pypi.org/account/register/, чтобы зарегистрировать " +"свою учетную запись." #: ../source/guides/using-testpypi.rst:19 msgid "" "The database for TestPyPI may be periodically pruned, so it is not unusual " "for user accounts to be deleted." msgstr "" +"База данных TestPyPI может периодически подвергаться обрезке, поэтому " +"нередко учетные записи пользователей удаляются." #: ../source/guides/using-testpypi.rst:24 msgid "Using TestPyPI with Twine" @@ -8529,6 +10023,8 @@ msgid "" "You can upload your distributions to TestPyPI using :ref:`twine` by " "specifying the ``--repository`` flag:" msgstr "" +"Вы можете загрузить свои дистрибутивы в TestPyPI с помощью :ref:`twine`, " +"указав флаг ``--repository``:" #: ../source/guides/using-testpypi.rst:33 msgid "" @@ -8537,6 +10033,10 @@ msgid "" "``sampleproject`` is the name of your project that you uploaded. It may take " "a minute or two for your project to appear on the site." msgstr "" +"Вы можете убедиться, что ваш пакет успешно загружен, перейдя по URL-адресу " +"``https://test.pypi.org/project/``, где ``sampleproject`` - " +"это имя загруженного вами проекта. Возможно, потребуется минута или две, " +"чтобы ваш проект появился на сайте." #: ../source/guides/using-testpypi.rst:39 msgid "Using TestPyPI with pip" @@ -8566,9 +10066,8 @@ msgid "" msgstr "" #: ../source/guides/writing-pyproject-toml.rst:5 -#, fuzzy msgid "Writing your ``pyproject.toml``" -msgstr "Настройка вашего проекта" +msgstr "Написание вашего ``pyproject.toml``" #: ../source/guides/writing-pyproject-toml.rst:7 msgid "" @@ -8626,9 +10125,8 @@ msgid "" msgstr "" #: ../source/guides/writing-pyproject-toml.rst:45 -#, fuzzy msgid "Declaring the build backend" -msgstr "Объявление зависимостей системы сборки" +msgstr "Объявление бэкенда сборки" #: ../source/guides/writing-pyproject-toml.rst:47 msgid "" @@ -8823,9 +10321,8 @@ msgid "" msgstr "" #: ../source/guides/writing-pyproject-toml.rst:259 -#, fuzzy msgid "About your project" -msgstr "Настройка вашего проекта" +msgstr "О вашем проекте" #: ../source/guides/writing-pyproject-toml.rst:262 #: ../source/specifications/pyproject-toml.rst:251 @@ -9020,9 +10517,8 @@ msgid "" msgstr "" #: ../source/index.rst:36 -#, fuzzy msgid "Overview and Flow" -msgstr "Обзор" +msgstr "Обзор и поток" #: ../source/index.rst:40 msgid "" @@ -9346,7 +10842,7 @@ msgid "" msgstr "" #: ../source/key_projects.rst:184 -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "pip" msgstr "pip" @@ -9546,9 +11042,10 @@ msgid "" "`__ | `GitHub `__ | `PyPI `__" msgstr "" -"`Docs `__ | `Issues " -"`__ | `GitHub `__ | `PyPI `__" +"`Документация `__ | `" +"Замечания `__ | `GitHub " +"`__ | `PyPI `__" #: ../source/key_projects.rst:336 msgid "" @@ -9749,7 +11246,7 @@ msgstr "" #: ../source/key_projects.rst:494 #, fuzzy msgid "meson-python" -msgstr "python" +msgstr "meson-python" #: ../source/key_projects.rst:496 #, fuzzy @@ -9940,7 +11437,7 @@ msgstr "" #: ../source/key_projects.rst:645 #, fuzzy msgid "scikit-build-core" -msgstr "scikit-build" +msgstr "scikit-build-core" #: ../source/key_projects.rst:647 #, fuzzy @@ -10034,13 +11531,12 @@ msgid "ensurepip" msgstr "ensurepip" #: ../source/key_projects.rst:716 -#, fuzzy msgid "" "`Docs `__ | `Issues " "`__" msgstr "" -"`Документация `__ | " -"`Замечания `__" +"`Документация `__ | `" +"Замечания `__" #: ../source/key_projects.rst:719 msgid "" @@ -10059,8 +11555,8 @@ msgid "" "`Docs `__ | `Issues `__" msgstr "" -"`Docs `__ | `Issues `__" +"`Документация `__ | `Замечания " +"`__" #: ../source/key_projects.rst:733 msgid "" @@ -10287,11 +11783,11 @@ msgstr "Июль 2018" #: ../source/news.rst:88 msgid "Improved binary extension docs. (:pr:`531`)" -msgstr "Улучшена документация по двоичным расширениям (:pr:`531`)." +msgstr "Улучшена документация по бинарным расширениям. (:pr:`531`)" #: ../source/news.rst:89 msgid "Added scikit-build to key projects. (:pr:`530`)" -msgstr "Для ключевых проектов добавлен scikit-build (:pr:`530`)." +msgstr "Добавлена scikit-build в ключевые проекты. (:pr:`530`)" #: ../source/news.rst:92 msgid "June 2018" @@ -10344,7 +11840,7 @@ msgstr "Апрель 2018" #: ../source/news.rst:111 msgid "Added README guide. (:pr:`461`)" -msgstr "Добавлено руководство по написанию README (:pr:`461`)." +msgstr "Добавлено руководство README. (:pr:`461`)" #: ../source/news.rst:112 msgid "Updated instructions and status for PyPI launch. (:pr:`475`)" @@ -10449,7 +11945,7 @@ msgstr "" #: ../source/news.rst:148 msgid "Added news page. (:pr:`404`)" -msgstr "Добавлена страница новостей (:pr:`404`)." +msgstr "Добавлена страница новостей (:pr:`404`)" #: ../source/news.rst:151 msgid "November 2017" @@ -10593,11 +12089,11 @@ msgstr "" #: ../source/news.rst:199 msgid "Updated to Sphinx 1.6.2. (:pr:`323`)" -msgstr "Обновление до Sphinx 1.6.2 (:pr:`323`)." +msgstr "Обновление до Sphinx 1.6.2 (:pr:`323`)" #: ../source/news.rst:200 msgid "Switched to the PyPA theme. (:pr:`305`)" -msgstr "Переключение на тему PyPA (:pr:`305`)." +msgstr "Переключение на тему PyPA (:pr:`305`)" #: ../source/news.rst:201 msgid "Re-organized the documentation into the new structure. (:pr:`318`)" @@ -10694,12 +12190,11 @@ msgstr "Февраль 2017" #: ../source/news.rst:234 msgid "Added :pep:`518`. (:pr:`281`)" -msgstr "Добавлен :pep:`518` (:pr:`281`)." +msgstr "Добавлен :pep:`518` (:pr:`281`)" #: ../source/overview.rst:3 -#, fuzzy msgid "Overview of Python Packaging" -msgstr "Обзор создания Python'ьих пакетов" +msgstr "Обзор упаковки Python" #: ../source/overview.rst:7 msgid "" @@ -11091,20 +12586,16 @@ msgid "Technologies which support this model:" msgstr "Технологии, поддерживающие эту модель:" #: ../source/overview.rst:248 -#, fuzzy msgid ":gh:`PEX ` (Python EXecutable)" -msgstr "" -"`PEX `_ (Python EXecutable --- " -"исполняемый файл Python'а)" +msgstr ":gh:`PEX ` (исполняемый файл Python)" #: ../source/overview.rst:249 -#, fuzzy msgid "" ":doc:`zipapp ` (does not help manage dependencies, " "requires Python 3.5+)" msgstr "" -"`zipapp `_ (не помогает " -"управлять зависимостями, требует Python 3.5+)" +":doc:`zipapp ` (не помогает управлять зависимостями, " +"требует Python 3.5+)" #: ../source/overview.rst:250 msgid ":gh:`shiv ` (requires Python 3)" @@ -11175,10 +12666,10 @@ msgid "" msgstr "" #: ../source/overview.rst:290 -#, fuzzy msgid "" "`ActiveState ActivePython `_" -msgstr "`ActiveState ActivePython `_" +msgstr "" +"`ActiveState ActivePython `_" #: ../source/overview.rst:291 msgid "`WinPython `_" @@ -11231,25 +12722,24 @@ msgid "" "`constructor `_ - For command-line " "installers" msgstr "" -"`constructor `_ --- для установщиков " -"командной строки;" +"`constructor `_ - Для инсталляторов " +"командной строки" #: ../source/overview.rst:316 msgid "`py2exe `_ - Windows only" -msgstr "`py2exe `_ --- только для Windows;" +msgstr "`py2exe `_ - только для Windows" #: ../source/overview.rst:317 msgid "`py2app `_ - Mac only" -msgstr "" -"`py2app `_ --- только для Mac;" +msgstr "`py2app `_ - только для Mac" #: ../source/overview.rst:318 msgid "`osnap `_ - Windows and Mac" -msgstr "`osnap `_ --- Windows и Mac;" +msgstr "`osnap `_ - Windows и Mac" #: ../source/overview.rst:319 msgid "`pynsist `_ - Windows only" -msgstr "`pynsist `_ --- Только для Windows." +msgstr "`pynsist `_ - только для Windows" #: ../source/overview.rst:321 msgid "" @@ -11475,7 +12965,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:22 -#: ../source/specifications/platform-compatibility-tags.rst:46 +#: ../source/specifications/platform-compatibility-tags.rst:39 msgid "Details" msgstr "Подробности" @@ -11673,7 +13163,7 @@ msgid "E.g. 'py27', 'py2', 'py3'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:128 -#: ../source/specifications/platform-compatibility-tags.rst:27 +#: ../source/specifications/platform-compatibility-tags.rst:20 msgid "abi tag" msgstr "" @@ -11682,7 +13172,7 @@ msgid "E.g. 'cp33m', 'abi3', 'none'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:131 -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "platform tag" msgstr "" @@ -11864,7 +13354,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:226 -#: ../source/specifications/recording-installed-packages.rst:39 +#: ../source/specifications/recording-installed-packages.rst:23 msgid "The .dist-info directory" msgstr "" @@ -12006,7 +13496,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:314 -#: ../source/specifications/platform-compatibility-tags.rst:244 +#: ../source/specifications/platform-compatibility-tags.rst:237 msgid "FAQ" msgstr "ЧаВо" @@ -12143,36 +13633,38 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:419 -#: ../source/specifications/direct-url-data-structure.rst:266 -#: ../source/specifications/direct-url.rst:66 +#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/dependency-specifiers.rst:476 +#: ../source/specifications/direct-url-data-structure.rst:267 +#: ../source/specifications/direct-url.rst:67 +#: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 #: ../source/specifications/inline-script-metadata.rst:239 #: ../source/specifications/name-normalization.rst:42 +#: ../source/specifications/platform-compatibility-tags.rst:301 #: ../source/specifications/pyproject-toml.rst:442 +#: ../source/specifications/recording-installed-packages.rst:252 #: ../source/specifications/source-distribution-format.rst:144 #: ../source/specifications/version-specifiers.rst:1262 +#: ../source/specifications/virtual-environments.rst:54 msgid "History" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -msgid "This specification was originally approved as :pep:`427`." +msgid "February 2013: This specification was approved through :pep:`427`." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:423 -msgid "The following changes were applied since the initial version:" -msgstr "" - -#: ../source/specifications/binary-distribution-format.rst:425 +#: ../source/specifications/binary-distribution-format.rst:422 msgid "" -"The rules on escaping in wheel filenames were revised, to bring them into " -"line with what popular tools actually do (February 2021)." +"February 2021: The rules on escaping in wheel filenames were revised, to " +"bring them into line with what popular tools actually do." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:430 +#: ../source/specifications/binary-distribution-format.rst:427 msgid "Appendix" msgstr "" -#: ../source/specifications/binary-distribution-format.rst:432 +#: ../source/specifications/binary-distribution-format.rst:429 msgid "Example urlsafe-base64-nopad implementation::" msgstr "" @@ -12565,7 +14057,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:330 msgid "Keywords" -msgstr "Keywords" +msgstr "Ключевые слова" #: ../source/specifications/core-metadata.rst:334 msgid "" @@ -13072,12 +14564,56 @@ msgid "" "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:854 +msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:855 +msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" +msgstr "" + +#: ../source/specifications/core-metadata.rst:856 +msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:857 +msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:859 +msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:860 +msgid "Added canonical method for transforming metadata to JSON." +msgstr "" + +#: ../source/specifications/core-metadata.rst:861 +msgid "Restricted the grammar of the ``Name`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:863 +msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:865 +msgid "Added the ``Dynamic`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:867 +msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:869 +msgid "Restricted extra names to be normalized." +msgstr "" + +#: ../source/specifications/core-metadata.rst:873 #, fuzzy msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "Разметка reStructuredText: http://docutils.sourceforge.net/" -#: ../source/specifications/core-metadata.rst:858 +#: ../source/specifications/core-metadata.rst:878 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" @@ -13541,35 +15077,29 @@ msgstr "" msgid "A test program - if the grammar is in a string ``grammar``:" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:476 -msgid "Summary of changes to PEP 508" -msgstr "" - #: ../source/specifications/dependency-specifiers.rst:478 -msgid "" -"The following changes were made based on feedback after its initial " -"implementation:" +msgid "November 2015: This specification was approved through :pep:`508`." msgstr "" -#: ../source/specifications/dependency-specifiers.rst:481 +#: ../source/specifications/dependency-specifiers.rst:479 msgid "" -"The definition of ``python_version`` was changed from ``platform." -"python_version()[:3]`` to ``'.'.join(platform.python_version_tuple()[:2])``, " -"to accommodate potential future versions of Python with 2-digit major and " -"minor versions (e.g. 3.10). [#future_versions]_" +"July 2019: The definition of ``python_version`` was `changed `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -13596,7 +15126,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -13681,10 +15211,8 @@ msgstr "Используйте ``pip`` для установки Pipenv:" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -14034,17 +15562,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -14246,6 +15773,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -14853,7 +16386,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -15074,7 +16607,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -15148,16 +16683,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -15171,141 +16704,117 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 #, fuzzy msgid "python tag" msgstr "python" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 #, fuzzy msgid "Python Tag" msgstr "Python Tag" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 #, fuzzy msgid "cp: CPython" msgstr "cp: CPython" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "ip: IronPython" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 #, fuzzy msgid "jy: Jython" msgstr "python" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -15313,11 +16822,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -15326,43 +16835,43 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 #, fuzzy msgid "Platform Tag" msgstr "Платформо-зависимые колёса" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 #, fuzzy msgid "``manylinux``" msgstr "Сопровождающий" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -15370,26 +16879,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -15397,7 +16906,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -15405,7 +16914,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -15414,7 +16923,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -15422,89 +16931,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "Инструмент" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -15512,7 +17021,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -15523,14 +17032,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -15539,69 +17048,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -15612,11 +17121,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -15626,7 +17135,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -15634,11 +17143,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -15646,13 +17155,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -15663,23 +17172,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -15687,11 +17196,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -15701,33 +17210,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -15735,13 +17244,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -15750,6 +17259,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -16421,8 +17954,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -16446,36 +17986,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -16487,7 +18005,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -16498,7 +18016,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -16510,41 +18028,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -16552,7 +18070,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -16560,58 +18078,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -16619,7 +18137,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -16627,13 +18145,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -16642,7 +18160,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -16651,18 +18169,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -16670,7 +18188,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -16680,11 +18198,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -16692,15 +18210,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -16708,11 +18226,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -16720,29 +18238,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -16751,11 +18269,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -16763,14 +18281,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -16779,13 +18297,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -17067,26 +18605,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -18709,10 +20245,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -18785,6 +20318,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "Как получить поддержку" diff --git a/locales/sai/LC_MESSAGES/messages.po b/locales/sai/LC_MESSAGES/messages.po index 88dafe55c..bf17d2523 100644 --- a/locales/sai/LC_MESSAGES/messages.po +++ b/locales/sai/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -513,7 +513,7 @@ msgstr "" #: ../source/discussions/deploying-python-applications.rst:11 #: ../source/specifications/externally-managed-environments.rst:130 -#: ../source/specifications/platform-compatibility-tags.rst:21 +#: ../source/specifications/platform-compatibility-tags.rst:14 msgid "Overview" msgstr "" @@ -2725,7 +2725,7 @@ msgid "" msgstr "" #: ../source/guides/analyzing-pypi-package-downloads.rst:335 -#: ../source/specifications/dependency-specifiers.rst:489 +#: ../source/specifications/dependency-specifiers.rst:487 msgid "References" msgstr "" @@ -8274,7 +8274,7 @@ msgid "" msgstr "" #: ../source/key_projects.rst:184 -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "pip" msgstr "" @@ -10359,7 +10359,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:22 -#: ../source/specifications/platform-compatibility-tags.rst:46 +#: ../source/specifications/platform-compatibility-tags.rst:39 msgid "Details" msgstr "" @@ -10557,7 +10557,7 @@ msgid "E.g. 'py27', 'py2', 'py3'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:128 -#: ../source/specifications/platform-compatibility-tags.rst:27 +#: ../source/specifications/platform-compatibility-tags.rst:20 msgid "abi tag" msgstr "" @@ -10566,7 +10566,7 @@ msgid "E.g. 'cp33m', 'abi3', 'none'." msgstr "" #: ../source/specifications/binary-distribution-format.rst:131 -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "platform tag" msgstr "" @@ -10748,7 +10748,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:226 -#: ../source/specifications/recording-installed-packages.rst:39 +#: ../source/specifications/recording-installed-packages.rst:23 msgid "The .dist-info directory" msgstr "" @@ -10890,7 +10890,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:314 -#: ../source/specifications/platform-compatibility-tags.rst:244 +#: ../source/specifications/platform-compatibility-tags.rst:237 msgid "FAQ" msgstr "" @@ -11027,36 +11027,38 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:419 -#: ../source/specifications/direct-url-data-structure.rst:266 -#: ../source/specifications/direct-url.rst:66 +#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/dependency-specifiers.rst:476 +#: ../source/specifications/direct-url-data-structure.rst:267 +#: ../source/specifications/direct-url.rst:67 +#: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 #: ../source/specifications/inline-script-metadata.rst:239 #: ../source/specifications/name-normalization.rst:42 +#: ../source/specifications/platform-compatibility-tags.rst:301 #: ../source/specifications/pyproject-toml.rst:442 +#: ../source/specifications/recording-installed-packages.rst:252 #: ../source/specifications/source-distribution-format.rst:144 #: ../source/specifications/version-specifiers.rst:1262 +#: ../source/specifications/virtual-environments.rst:54 msgid "History" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -msgid "This specification was originally approved as :pep:`427`." -msgstr "" - -#: ../source/specifications/binary-distribution-format.rst:423 -msgid "The following changes were applied since the initial version:" +msgid "February 2013: This specification was approved through :pep:`427`." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:425 +#: ../source/specifications/binary-distribution-format.rst:422 msgid "" -"The rules on escaping in wheel filenames were revised, to bring them into " -"line with what popular tools actually do (February 2021)." +"February 2021: The rules on escaping in wheel filenames were revised, to " +"bring them into line with what popular tools actually do." msgstr "" -#: ../source/specifications/binary-distribution-format.rst:430 +#: ../source/specifications/binary-distribution-format.rst:427 msgid "Appendix" msgstr "" -#: ../source/specifications/binary-distribution-format.rst:432 +#: ../source/specifications/binary-distribution-format.rst:429 msgid "Example urlsafe-base64-nopad implementation::" msgstr "" @@ -11954,11 +11956,55 @@ msgid "" "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:854 +msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:855 +msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" +msgstr "" + +#: ../source/specifications/core-metadata.rst:856 +msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:857 +msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:859 +msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:860 +msgid "Added canonical method for transforming metadata to JSON." +msgstr "" + +#: ../source/specifications/core-metadata.rst:861 +msgid "Restricted the grammar of the ``Name`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:863 +msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:865 +msgid "Added the ``Dynamic`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:867 +msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:869 +msgid "Restricted extra names to be normalized." +msgstr "" + +#: ../source/specifications/core-metadata.rst:873 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:858 +#: ../source/specifications/core-metadata.rst:878 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" @@ -12410,35 +12456,29 @@ msgstr "" msgid "A test program - if the grammar is in a string ``grammar``:" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:476 -msgid "Summary of changes to PEP 508" -msgstr "" - #: ../source/specifications/dependency-specifiers.rst:478 -msgid "" -"The following changes were made based on feedback after its initial " -"implementation:" +msgid "November 2015: This specification was approved through :pep:`508`." msgstr "" -#: ../source/specifications/dependency-specifiers.rst:481 +#: ../source/specifications/dependency-specifiers.rst:479 msgid "" -"The definition of ``python_version`` was changed from ``platform." -"python_version()[:3]`` to ``'.'.join(platform.python_version_tuple()[:2])``, " -"to accommodate potential future versions of Python with 2-digit major and " -"minor versions (e.g. 3.10). [#future_versions]_" +"July 2019: The definition of ``python_version`` was `changed `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12465,7 +12505,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12549,10 +12589,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12900,17 +12938,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13112,6 +13149,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13711,7 +13754,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13928,7 +13971,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14000,16 +14045,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14023,137 +14066,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14161,11 +14180,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14174,41 +14193,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14216,26 +14235,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14243,7 +14262,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14251,7 +14270,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14260,7 +14279,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14268,89 +14287,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14358,7 +14377,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14369,14 +14388,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14385,69 +14404,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14458,11 +14477,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14472,7 +14491,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14480,11 +14499,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14492,13 +14511,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14509,23 +14528,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14533,11 +14552,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14547,33 +14566,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14581,13 +14600,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14596,6 +14615,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15259,8 +15302,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15284,36 +15334,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15325,7 +15353,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15336,7 +15364,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15348,41 +15376,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15390,7 +15418,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15398,58 +15426,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15457,7 +15485,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15465,13 +15493,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15480,7 +15508,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15489,18 +15517,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15508,7 +15536,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15518,11 +15546,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15530,15 +15558,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15546,11 +15574,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15558,29 +15586,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15589,11 +15617,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15601,14 +15629,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15617,13 +15645,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15902,26 +15950,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17525,10 +17571,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17600,6 +17643,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/si/LC_MESSAGES/messages.po b/locales/si/LC_MESSAGES/messages.po index 7568ab397..6c038c176 100644 --- a/locales/si/LC_MESSAGES/messages.po +++ b/locales/si/LC_MESSAGES/messages.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2022-06-11 08:19+0000\n" "Last-Translator: Kushan Gunasekera \n" "Language-Team: Sinhala `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12469,7 +12509,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12553,10 +12593,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12904,17 +12942,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13116,6 +13153,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13715,7 +13758,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -13932,7 +13975,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14004,16 +14049,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14027,137 +14070,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14165,11 +14184,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14178,41 +14197,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14220,26 +14239,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14247,7 +14266,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14255,7 +14274,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14264,7 +14283,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14272,89 +14291,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14362,7 +14381,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14373,14 +14392,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14389,69 +14408,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14462,11 +14481,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14476,7 +14495,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14484,11 +14503,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14496,13 +14515,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14513,23 +14532,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14537,11 +14556,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14551,33 +14570,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14585,13 +14604,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14600,6 +14619,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15263,8 +15306,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15288,36 +15338,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15329,7 +15357,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15340,7 +15368,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15352,41 +15380,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15394,7 +15422,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15402,58 +15430,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15461,7 +15489,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15469,13 +15497,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15484,7 +15512,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15493,18 +15521,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15512,7 +15540,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15522,11 +15550,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15534,15 +15562,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15550,11 +15578,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15562,29 +15590,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15593,11 +15621,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15605,14 +15633,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15621,13 +15649,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15906,26 +15954,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17529,10 +17575,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17604,6 +17647,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/sk/LC_MESSAGES/messages.po b/locales/sk/LC_MESSAGES/messages.po index 7b6160d1b..4bc457376 100644 --- a/locales/sk/LC_MESSAGES/messages.po +++ b/locales/sk/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2023-09-21 05:16+0000\n" "Last-Translator: Milan Šalka \n" "Language-Team: Slovak `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12596,7 +12636,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12680,10 +12720,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -13031,17 +13069,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13243,6 +13280,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13846,7 +13889,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -14067,7 +14110,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14139,16 +14184,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14162,137 +14205,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14300,11 +14319,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14313,41 +14332,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14355,26 +14374,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14382,7 +14401,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14390,7 +14409,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14399,7 +14418,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14407,89 +14426,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14497,7 +14516,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14508,14 +14527,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14524,69 +14543,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14597,11 +14616,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14611,7 +14630,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14619,11 +14638,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14631,13 +14650,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14648,23 +14667,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14672,11 +14691,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14686,33 +14705,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14720,13 +14739,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14735,6 +14754,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15398,8 +15441,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15423,36 +15473,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15464,7 +15492,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15475,7 +15503,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15487,41 +15515,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15529,7 +15557,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15537,58 +15565,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15596,7 +15624,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15604,13 +15632,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15619,7 +15647,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15628,18 +15656,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15647,7 +15675,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15657,11 +15685,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15669,15 +15697,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15685,11 +15713,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15697,29 +15725,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15728,11 +15756,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15740,14 +15768,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15756,13 +15784,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -16041,26 +16089,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17666,10 +17712,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17741,6 +17784,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/uk/LC_MESSAGES/messages.po b/locales/uk/LC_MESSAGES/messages.po index 3b5e4f1f0..7c99586e3 100644 --- a/locales/uk/LC_MESSAGES/messages.po +++ b/locales/uk/LC_MESSAGES/messages.po @@ -15,7 +15,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2023-11-29 05:05+0000\n" "Last-Translator: Sviatoslav Sydorenko \n" "Language-Team: Ukrainian `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12895,7 +12935,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12982,10 +13022,8 @@ msgstr "``pip install app``" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "``pip install app --no-index --find-links https://example.com/``" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -13335,17 +13373,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13547,6 +13584,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -14162,7 +14205,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -14386,7 +14429,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14460,16 +14505,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14483,141 +14526,117 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 #, fuzzy msgid "'py27', 'cp33'" msgstr "Наприклад, 'py27', 'py2', 'py3'." -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 #, fuzzy msgid "'cp32dmu', 'none'" msgstr "Наприклад, 'cp33m', 'abi3', 'none'." -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 #, fuzzy msgid "'linux_x86_64', 'any'" msgstr "Наприклад, 'linux_x86_64', 'any'." -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 #, fuzzy msgid "cp: CPython" msgstr "``description``" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14625,11 +14644,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14638,43 +14657,43 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 #, fuzzy msgid "linux_x86_64" msgstr "Наприклад, 'linux_x86_64', 'any'." -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 #, fuzzy msgid "``manylinux``" msgstr "``manylinux1``" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14682,26 +14701,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14709,7 +14728,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14717,7 +14736,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14726,7 +14745,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14734,89 +14753,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "Інструмент" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "``manylinux1``" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "``manylinux2010``" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "``manylinux2014``" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "``manylinux_x_y``" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "``>=8.1.0``" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "``>=19.0``" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "``>=19.3``" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "``>=20.3``" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "auditwheel" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "``>=1.0.0``" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "``>=2.0.0``" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "``>=3.0.0``" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "``>=3.3.0`` [#]_" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14824,7 +14843,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14835,14 +14854,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14851,69 +14870,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14924,11 +14943,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14938,7 +14957,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14946,11 +14965,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14958,13 +14977,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14975,23 +14994,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14999,11 +15018,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -15013,33 +15032,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -15047,13 +15066,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -15062,6 +15081,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "Файл :file:`.pypirc`" @@ -15732,8 +15775,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15757,36 +15807,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15798,7 +15826,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15809,7 +15837,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15821,41 +15849,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15863,7 +15891,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15871,58 +15899,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "Файл METADATA" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "Файл RECORD" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15930,7 +15958,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15938,13 +15966,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15953,7 +15981,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15962,18 +15990,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15981,7 +16009,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15991,11 +16019,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "Файл INSTALLER" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -16003,15 +16031,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -16019,11 +16047,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -16031,29 +16059,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -16062,11 +16090,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -16074,14 +16102,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -16090,13 +16118,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -16377,26 +16425,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -18035,10 +18081,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -18110,6 +18153,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "" diff --git a/locales/zh_Hans/LC_MESSAGES/messages.po b/locales/zh_Hans/LC_MESSAGES/messages.po index 36bf7af0c..d24788704 100644 --- a/locales/zh_Hans/LC_MESSAGES/messages.po +++ b/locales/zh_Hans/LC_MESSAGES/messages.po @@ -28,7 +28,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2023-12-18 06:41+0000\n" "Last-Translator: Eric \n" "Language-Team: Chinese (Simplified) `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -13163,7 +13203,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -13250,10 +13290,8 @@ msgstr "``pipx`` 是用 ``pip`` 安装的：" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -13601,17 +13639,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13813,6 +13850,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "外部管理的环境" @@ -14417,7 +14460,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -14637,7 +14680,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14709,16 +14754,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14732,137 +14775,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "python 标签" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "使用方法" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "Python 标签" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "cp: CPython" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "ip: IronPython" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "jy: Jython" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14870,11 +14889,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14883,41 +14902,41 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 msgid "``manylinux``" msgstr "``manylinux``" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14925,26 +14944,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14952,7 +14971,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14960,7 +14979,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14969,7 +14988,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14977,89 +14996,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "``>=8.1.0``" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "``>=3.0.0``" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "``>=3.3.0`` [#]_" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -15067,7 +15086,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -15078,14 +15097,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -15094,69 +15113,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -15167,11 +15186,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -15181,7 +15200,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -15189,11 +15208,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -15201,13 +15220,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -15218,23 +15237,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -15242,11 +15261,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -15256,33 +15275,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -15290,13 +15309,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -15305,6 +15324,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15968,8 +16011,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15993,36 +16043,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -16034,7 +16062,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -16045,7 +16073,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -16057,41 +16085,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -16099,7 +16127,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -16107,58 +16135,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -16166,7 +16194,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -16174,13 +16202,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -16189,7 +16217,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -16198,18 +16226,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -16217,7 +16245,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -16227,11 +16255,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -16239,15 +16267,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -16255,11 +16283,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -16267,29 +16295,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -16298,11 +16326,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -16310,14 +16338,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -16326,13 +16354,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -16613,26 +16661,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -18248,10 +18294,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -18323,6 +18366,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr "如何获得支持" diff --git a/locales/zh_Hant/LC_MESSAGES/messages.po b/locales/zh_Hant/LC_MESSAGES/messages.po index ed0161f39..a04206654 100644 --- a/locales/zh_Hant/LC_MESSAGES/messages.po +++ b/locales/zh_Hant/LC_MESSAGES/messages.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-21 17:40+0000\n" +"POT-Creation-Date: 2023-12-22 21:48+0000\n" "PO-Revision-Date: 2022-07-30 20:04+0000\n" "Last-Translator: meowmeowmeowcat \n" "Language-Team: Chinese (Traditional) `_ from ``platform.python_version()[:3]`` to ``'.'.join(platform." +"python_version_tuple()[:2])``, to accommodate potential future versions of " +"Python with 2-digit major and minor versions (e.g. 3.10). [#future_versions]_" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:491 +#: ../source/specifications/dependency-specifiers.rst:489 msgid "" "pip, the recommended installer for Python packages (http://pip.readthedocs." "org/en/stable/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:494 +#: ../source/specifications/dependency-specifiers.rst:492 msgid "The parsley PEG library. (https://pypi.python.org/pypi/parsley/)" msgstr "" -#: ../source/specifications/dependency-specifiers.rst:497 +#: ../source/specifications/dependency-specifiers.rst:495 msgid "" "Future Python versions might be problematic with the definition of " "Environment Marker Variable ``python_version`` (https://github.com/python/" @@ -12535,7 +12575,7 @@ msgid "" msgstr "" #: ../source/specifications/direct-url.rst:21 -#: ../source/specifications/recording-installed-packages.rst:232 +#: ../source/specifications/recording-installed-packages.rst:216 msgid "" "This file MUST NOT be created when installing a distribution from an other " "type of requirement (i.e. name plus version specifier)." @@ -12619,10 +12659,8 @@ msgstr "" msgid "``pip install app --no-index --find-links https://example.com/``" msgstr "" -#: ../source/specifications/direct-url.rst:68 -msgid "" -"March 2020: the ``direct_url.json`` metadata file was originally specified " -"in :pep:`610` and is formally documented here." +#: ../source/specifications/direct-url.rst:69 +msgid "March 2020: This specification was approved through :pep:`610`." msgstr "" #: ../source/specifications/direct-url-data-structure.rst:7 @@ -12970,17 +13008,16 @@ msgstr "" msgid "Local directory in editable mode:" msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:268 +#: ../source/specifications/direct-url-data-structure.rst:269 msgid "" -"March 2020: this data structure was originally specified as part of the " -"``direct_url.json`` metadata file in :pep:`610` and is formally documented " -"here." +"March 2020: This specification was approved through :pep:`610`, defining the " +"``direct_url.json`` metadata file." msgstr "" -#: ../source/specifications/direct-url-data-structure.rst:270 +#: ../source/specifications/direct-url-data-structure.rst:271 msgid "" -"January 2023: Added the ``archive_info.hashes`` key ([discussion](https://" -"discuss.python.org/t/22299))." +"January 2023: Added the ``archive_info.hashes`` key (`discussion `_)." msgstr "" #: ../source/specifications/entry-points.rst:5 @@ -13182,6 +13219,12 @@ msgid "" "is undefined." msgstr "" +#: ../source/specifications/entry-points.rst:166 +msgid "" +"October 2017: This specification was written to formalize the existing entry " +"points feature of setuptools (discussion_)." +msgstr "" + #: ../source/specifications/externally-managed-environments.rst:6 msgid "Externally Managed Environments" msgstr "" @@ -13787,7 +13830,7 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:474 -msgid "This specification was originally approved as :pep:`668`." +msgid "June 2022: This specification was approved through :pep:`668`." msgstr "" #: ../source/specifications/index.rst:4 @@ -14008,7 +14051,9 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:241 -msgid "This specification was originally defined as :pep:`723`." +msgid "" +"October 2023: This specification was conditionally approved through :pep:" +"`723`." msgstr "" #: ../source/specifications/name-normalization.rst:5 @@ -14081,16 +14126,14 @@ msgstr "" #: ../source/specifications/name-normalization.rst:44 msgid "" -"`September 2015 `_: normalized name was originally specified in :pep:" -"`503#normalized-names`." +"September 2015: The specification of name normalized was approved through :" +"pep:`503 <503#normalized-names>`." msgstr "" -#: ../source/specifications/name-normalization.rst:45 +#: ../source/specifications/name-normalization.rst:46 msgid "" -"`November 2015 `_: valid non-normalized name was originally specified " -"in :pep:`508#names`." +"November 2015: The specification of valid names was approved through :pep:" +"`508 <508#names>`." msgstr "" #: ../source/specifications/platform-compatibility-tags.rst:6 @@ -14104,137 +14147,113 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:12 -msgid "The following PEPs contributed to this spec:" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:14 -msgid ":pep:`425`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:15 -msgid ":pep:`513`" -msgstr "" - #: ../source/specifications/platform-compatibility-tags.rst:16 -msgid ":pep:`571`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:17 -msgid ":pep:`599`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:18 -msgid ":pep:`600`" -msgstr "" - -#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:25 +#: ../source/specifications/platform-compatibility-tags.rst:18 msgid "python tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:26 +#: ../source/specifications/platform-compatibility-tags.rst:19 msgid "'py27', 'cp33'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:28 +#: ../source/specifications/platform-compatibility-tags.rst:21 msgid "'cp32dmu', 'none'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:30 +#: ../source/specifications/platform-compatibility-tags.rst:23 msgid "'linux_x86_64', 'any'" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:32 +#: ../source/specifications/platform-compatibility-tags.rst:25 msgid "" "For example, the tag ``py27-none-any`` indicates compatibility with Python " "2.7 (any Python 2.7 implementation) with no abi requirement, on any platform." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:36 -#: ../source/specifications/platform-compatibility-tags.rst:170 +#: ../source/specifications/platform-compatibility-tags.rst:29 +#: ../source/specifications/platform-compatibility-tags.rst:163 msgid "Use" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:38 +#: ../source/specifications/platform-compatibility-tags.rst:31 msgid "" "The ``wheel`` built package format includes these tags in its filenames, of " "the form ``{distribution}-{version}(-{build tag})?-{python tag}-{abitag}-" "{platform tag}.whl``. Other package formats may have their own conventions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:43 +#: ../source/specifications/platform-compatibility-tags.rst:36 msgid "Any potential spaces in any tag should be replaced with ``_``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:49 +#: ../source/specifications/platform-compatibility-tags.rst:42 msgid "Python Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:51 +#: ../source/specifications/platform-compatibility-tags.rst:44 msgid "" "The Python tag indicates the implementation and version required by a " "distribution. Major implementations have abbreviated codes, initially:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:54 +#: ../source/specifications/platform-compatibility-tags.rst:47 msgid "py: Generic Python (does not require implementation-specific features)" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:55 +#: ../source/specifications/platform-compatibility-tags.rst:48 msgid "cp: CPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:56 +#: ../source/specifications/platform-compatibility-tags.rst:49 msgid "ip: IronPython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:57 +#: ../source/specifications/platform-compatibility-tags.rst:50 msgid "pp: PyPy" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:58 +#: ../source/specifications/platform-compatibility-tags.rst:51 msgid "jy: Jython" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:60 +#: ../source/specifications/platform-compatibility-tags.rst:53 msgid "Other Python implementations should use ``sys.implementation.name``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:62 +#: ../source/specifications/platform-compatibility-tags.rst:55 msgid "" "The version is ``py_version_nodot``. CPython gets away with no dot, but if " "one is needed the underscore ``_`` is used instead. PyPy should probably " "use its own versions here ``pp18``, ``pp19``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:66 +#: ../source/specifications/platform-compatibility-tags.rst:59 msgid "" "The version can be just the major version ``2`` or ``3`` ``py2``, ``py3`` " "for many pure-Python distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:69 +#: ../source/specifications/platform-compatibility-tags.rst:62 msgid "" "Importantly, major-version-only tags like ``py2`` and ``py3`` are not " "shorthand for ``py20`` and ``py30``. Instead, these tags mean the packager " "intentionally released a cross-version-compatible distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:73 +#: ../source/specifications/platform-compatibility-tags.rst:66 msgid "" "A single-source Python 2/3 compatible distribution can use the compound tag " "``py2.py3``. See `Compressed Tag Sets`_, below." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:77 +#: ../source/specifications/platform-compatibility-tags.rst:70 msgid "ABI Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:79 +#: ../source/specifications/platform-compatibility-tags.rst:72 msgid "" "The ABI tag indicates which Python ABI is required by any included extension " "modules. For implementation-specific ABIs, the implementation is " @@ -14242,11 +14261,11 @@ msgid "" "CPython 3.3 ABI with debugging." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:84 +#: ../source/specifications/platform-compatibility-tags.rst:77 msgid "The CPython stable ABI is ``abi3`` as in the shared library suffix." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:86 +#: ../source/specifications/platform-compatibility-tags.rst:79 msgid "" "Implementations with a very unstable ABI may use the first 6 bytes (as 8 " "base64-encoded characters) of the SHA-256 hash of their source code revision " @@ -14255,42 +14274,42 @@ msgid "" "how to best use the ABI tag." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:93 +#: ../source/specifications/platform-compatibility-tags.rst:86 msgid "Platform Tag" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:95 +#: ../source/specifications/platform-compatibility-tags.rst:88 msgid "" "The platform tag is simply ``sysconfig.get_platform()`` with all hyphens ``-" "`` and periods ``.`` replaced with underscore ``_``. Until the removal of :" "ref:`distutils` in Python 3.12, this was ``distutils.util.get_platform()``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:100 +#: ../source/specifications/platform-compatibility-tags.rst:93 msgid "win32" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:101 +#: ../source/specifications/platform-compatibility-tags.rst:94 msgid "linux_i386" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:102 +#: ../source/specifications/platform-compatibility-tags.rst:95 msgid "linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:107 +#: ../source/specifications/platform-compatibility-tags.rst:100 #, fuzzy msgid "``manylinux``" msgstr "維護者" -#: ../source/specifications/platform-compatibility-tags.rst:110 +#: ../source/specifications/platform-compatibility-tags.rst:103 msgid "" "The scheme defined in :pep:`425` was insufficient for public distribution of " "wheel files (and \\*nix wheel files in general) to Linux platforms, due to " "the large ecosystem of Linux platforms and subtle differences between them." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:114 +#: ../source/specifications/platform-compatibility-tags.rst:107 msgid "" "Instead, :pep:`600` defines the ``manylinux`` standard, which represents a " "common subset of Linux platforms, and allows building wheels tagged with the " @@ -14298,26 +14317,26 @@ msgid "" "distributions." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:119 +#: ../source/specifications/platform-compatibility-tags.rst:112 msgid "" "There were multiple iterations of the ``manylinux`` specification, each " "representing the common subset of Linux platforms at a given point in time:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:122 +#: ../source/specifications/platform-compatibility-tags.rst:115 msgid "" "``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686`` architectures, " "and is based on a compatible Linux platform from 2007." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:124 +#: ../source/specifications/platform-compatibility-tags.rst:117 msgid "" "``manylinux2010`` (:pep:`571`) supports ``x86_64`` and ``i686`` " "architectures. and updates the previous specification to be based on a " "compatible Linux platform from 2010 instead." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:127 +#: ../source/specifications/platform-compatibility-tags.rst:120 msgid "" "``manylinux2014`` (:pep:`599`) adds support for a number of additional " "architectures (``aarch64``, ``armv7l``, ``ppc64``, ``ppc64le``, and " @@ -14325,7 +14344,7 @@ msgid "" "2014." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:132 +#: ../source/specifications/platform-compatibility-tags.rst:125 msgid "" "``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a " "future-proof standard. It defines ``x`` and ``y`` as glibc major an minor " @@ -14333,7 +14352,7 @@ msgid "" "glibc 2.24+). Previous tags are still supported for backward compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:137 +#: ../source/specifications/platform-compatibility-tags.rst:130 msgid "" "In general, distributions built for older versions of the specification are " "forwards-compatible (meaning that ``manylinux1`` distributions should " @@ -14342,7 +14361,7 @@ msgid "" "that existed before 2010)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:143 +#: ../source/specifications/platform-compatibility-tags.rst:136 msgid "" "Package maintainers should attempt to target the most compatible " "specification possible, with the caveat that the provided build environment " @@ -14350,89 +14369,89 @@ msgid "" "that these images will no longer receive security updates." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:149 +#: ../source/specifications/platform-compatibility-tags.rst:142 msgid "Manylinux compatibility support" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:152 +#: ../source/specifications/platform-compatibility-tags.rst:145 msgid "" "The ``manylinux2014`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:154 +#: ../source/specifications/platform-compatibility-tags.rst:147 msgid "" "The ``manylinux_x_y`` specification is relatively new and is not yet widely " "recognised by install tools." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:157 +#: ../source/specifications/platform-compatibility-tags.rst:150 msgid "" "The following table shows the minimum versions of relevant projects to " "support the various ``manylinux`` standards:" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "Tool" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux1``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2010``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux2014``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:161 +#: ../source/specifications/platform-compatibility-tags.rst:154 msgid "``manylinux_x_y``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=8.1.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=19.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:163 +#: ../source/specifications/platform-compatibility-tags.rst:156 msgid "``>=20.3``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "auditwheel" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=1.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=2.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.0.0``" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:164 +#: ../source/specifications/platform-compatibility-tags.rst:157 msgid "``>=3.3.0`` [#]_" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:167 +#: ../source/specifications/platform-compatibility-tags.rst:160 msgid "Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:172 +#: ../source/specifications/platform-compatibility-tags.rst:165 msgid "" "The tags are used by installers to decide which built distribution (if any) " "to download from a list of potential built distributions. The installer " @@ -14440,7 +14459,7 @@ msgid "" "built distribution's tag is ``in`` the list, then it can be installed." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:178 +#: ../source/specifications/platform-compatibility-tags.rst:171 msgid "" "It is recommended that installers try to choose the most feature complete " "built distribution available (the one most specific to the installation " @@ -14451,14 +14470,14 @@ msgid "" "download built packages that advertise themselves as being pure Python." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:186 +#: ../source/specifications/platform-compatibility-tags.rst:179 msgid "" "Another desirable installer feature might be to include \"re-compile from " "source if possible\" as more preferable than some of the compatible but " "legacy pre-built options." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:190 +#: ../source/specifications/platform-compatibility-tags.rst:183 msgid "" "This example list is for an installer running under CPython 3.3 on a " "linux_x86_64 system. It is in order from most-preferred (a distribution with " @@ -14467,69 +14486,69 @@ msgid "" "Python):" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:196 +#: ../source/specifications/platform-compatibility-tags.rst:189 msgid "cp33-cp33m-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:197 +#: ../source/specifications/platform-compatibility-tags.rst:190 msgid "cp33-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:198 +#: ../source/specifications/platform-compatibility-tags.rst:191 msgid "cp3-abi3-linux_x86_64" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:199 +#: ../source/specifications/platform-compatibility-tags.rst:192 msgid "cp33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:200 +#: ../source/specifications/platform-compatibility-tags.rst:193 msgid "cp3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:201 +#: ../source/specifications/platform-compatibility-tags.rst:194 msgid "py33-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:202 +#: ../source/specifications/platform-compatibility-tags.rst:195 msgid "py3-none-linux_x86_64*" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:203 +#: ../source/specifications/platform-compatibility-tags.rst:196 msgid "cp33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:204 +#: ../source/specifications/platform-compatibility-tags.rst:197 msgid "cp3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:205 +#: ../source/specifications/platform-compatibility-tags.rst:198 msgid "py33-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:206 +#: ../source/specifications/platform-compatibility-tags.rst:199 msgid "py3-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:207 +#: ../source/specifications/platform-compatibility-tags.rst:200 msgid "py32-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:208 +#: ../source/specifications/platform-compatibility-tags.rst:201 msgid "py31-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:209 +#: ../source/specifications/platform-compatibility-tags.rst:202 msgid "py30-none-any" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:211 +#: ../source/specifications/platform-compatibility-tags.rst:204 msgid "" "Built distributions may be platform specific for reasons other than C " "extensions, such as by including a native executable invoked as a subprocess." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:215 +#: ../source/specifications/platform-compatibility-tags.rst:208 msgid "" "Sometimes there will be more than one supported built distribution for a " "particular version of a package. For example, a packager could release a " @@ -14540,11 +14559,11 @@ msgid "" "without because that tag appears first in the list." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:224 +#: ../source/specifications/platform-compatibility-tags.rst:217 msgid "Compressed Tag Sets" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:226 +#: ../source/specifications/platform-compatibility-tags.rst:219 msgid "" "To allow for compact filenames of bdists that work with more than one " "compatibility tag triple, each tag in a filename can instead be a '.'-" @@ -14554,7 +14573,7 @@ msgid "" "simple tags is::" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:238 +#: ../source/specifications/platform-compatibility-tags.rst:231 msgid "" "A bdist format that implements this scheme should include the expanded tags " "in bdist-specific metadata. This compression scheme can generate large " @@ -14562,11 +14581,11 @@ msgid "" "Python implementation e.g. \"cp33-cp31u-win64\", so use it sparingly." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:251 +#: ../source/specifications/platform-compatibility-tags.rst:244 msgid "What tags are used by default?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:247 +#: ../source/specifications/platform-compatibility-tags.rst:240 msgid "" "Tools should use the most-preferred architecture dependent tag e.g. ``cp33-" "cp33m-win32`` or the most-preferred pure python tag e.g. ``py33-none-any`` " @@ -14574,13 +14593,13 @@ msgid "" "intended to provide cross-Python compatibility." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:261 +#: ../source/specifications/platform-compatibility-tags.rst:254 msgid "" "What tag do I use if my distribution uses a feature exclusive to the newest " "version of Python?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:254 +#: ../source/specifications/platform-compatibility-tags.rst:247 msgid "" "Compatibility tags aid installers in selecting the *most compatible* build " "of a *single version* of a distribution. For example, when there is no " @@ -14591,23 +14610,23 @@ msgid "" "use the new feature, to get a compatible build." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:266 +#: ../source/specifications/platform-compatibility-tags.rst:259 msgid "Why isn't there a ``.`` in the Python version number?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:264 +#: ../source/specifications/platform-compatibility-tags.rst:257 msgid "" "CPython has lasted 20+ years without a 3-digit major release. This should " "continue for some time. Other implementations may use _ as a delimiter, " "since both - and . delimit the surrounding filename." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:272 +#: ../source/specifications/platform-compatibility-tags.rst:265 msgid "" "Why normalise hyphens and other non-alphanumeric characters to underscores?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:269 +#: ../source/specifications/platform-compatibility-tags.rst:262 msgid "" "To avoid conflicting with the ``.`` and ``-`` characters that separate " "components of the filename, and for better compatibility with the widest " @@ -14615,11 +14634,11 @@ msgid "" "paths without quoting)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:281 +#: ../source/specifications/platform-compatibility-tags.rst:274 msgid "Why not use special character rather than ``.`` or ``-``?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:275 +#: ../source/specifications/platform-compatibility-tags.rst:268 msgid "" "Either because that character is inconvenient or potentially confusing in " "some contexts (for example, ``+`` must be quoted in URLs, ``~`` is used to " @@ -14629,33 +14648,33 @@ msgid "" "using ``,`` rather than ``.`` to separate components in a compressed tag)." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:286 +#: ../source/specifications/platform-compatibility-tags.rst:279 msgid "Who will maintain the registry of abbreviated implementations?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:284 +#: ../source/specifications/platform-compatibility-tags.rst:277 msgid "" "New two-letter abbreviations can be requested on the python-dev mailing " "list. As a rule of thumb, abbreviations are reserved for the current 4 most " "prominent implementations." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:291 +#: ../source/specifications/platform-compatibility-tags.rst:284 msgid "Does the compatibility tag go into METADATA or PKG-INFO?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:289 +#: ../source/specifications/platform-compatibility-tags.rst:282 msgid "" "No. The compatibility tag is part of the built distribution's metadata. " "METADATA / PKG-INFO should be valid for an entire distribution, not a single " "build of that distribution." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:297 +#: ../source/specifications/platform-compatibility-tags.rst:290 msgid "Why didn't you mention my favorite Python implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:294 +#: ../source/specifications/platform-compatibility-tags.rst:287 msgid "" "The abbreviated tags facilitate sharing compiled Python code in a public " "index. Your Python implementation can use this specification too, but with " @@ -14663,13 +14682,13 @@ msgid "" "``py``." msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:303 +#: ../source/specifications/platform-compatibility-tags.rst:298 msgid "" "Why is the ABI tag (the second tag) sometimes \"none\" in the reference " "implementation?" msgstr "" -#: ../source/specifications/platform-compatibility-tags.rst:300 +#: ../source/specifications/platform-compatibility-tags.rst:293 msgid "" "Since Python 2 does not have an easy way to get to the SOABI (the concept " "comes from newer versions of Python 3) the reference implementation at the " @@ -14678,6 +14697,30 @@ msgid "" "good enough way to say \"don't know\"." msgstr "" +#: ../source/specifications/platform-compatibility-tags.rst:303 +msgid "" +"February 2013: The original version of this specification was approved " +"through :pep:`425`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:305 +msgid "January 2016: The ``manylinux1`` tag was approved through :pep:`513`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:306 +msgid "April 2018: The ``manylinux2010`` tag was approved through :pep:`571`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:307 +msgid "July 2019: The ``manylinux2014`` tag was approved through :pep:`599`." +msgstr "" + +#: ../source/specifications/platform-compatibility-tags.rst:308 +msgid "" +"November 2019: The ``manylinux_x_y`` perennial tag was approved through :pep:" +"`600`." +msgstr "" + #: ../source/specifications/pypirc.rst:6 msgid "The :file:`.pypirc` file" msgstr "" @@ -15342,8 +15385,15 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:444 msgid "" -"This specification was originally defined in :pep:`518` (``[build-system]`` " -"and ``[tool]`` tables) and :pep:`621` (``[project]`` table)." +"May 2016: The initial specification of the ``pyproject.toml`` file, with " +"just a ``[build-system]`` containing a ``requires`` key and a ``[tool]`` " +"table, was approved through :pep:`518`." +msgstr "" + +#: ../source/specifications/pyproject-toml.rst:448 +msgid "" +"November 2020: The specification of the ``[project]`` table was approved " +"through :pep:`621`." msgstr "" #: ../source/specifications/recording-installed-packages.rst:7 @@ -15367,36 +15417,14 @@ msgid "" "still record the name and version of the installed project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:23 -msgid "History and change workflow" -msgstr "" - #: ../source/specifications/recording-installed-packages.rst:25 msgid "" -"The metadata described here was first specified in :pep:`376`, and later " -"amended in :pep:`627` (and other PEPs). It was formerly known as *Database " -"of Installed Python Distributions*. As with other PyPA specifications, " -"editorial amendments with no functional impact may be made through the " -"GitHub pull request workflow. Proposals for functional changes that would " -"require amendments to package building and/or installation tools must be " -"made through the PEP process (see :pep:`1`)." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:33 -msgid "" -"While this document is the normative specification, the PEPs that introduce " -"changes to it may include additional information such as rationales and " -"backwards compatibility considerations." -msgstr "" - -#: ../source/specifications/recording-installed-packages.rst:41 -msgid "" "Each project installed from a distribution must, in addition to files, " "install a \"``.dist-info``\" directory located alongside importable modules " "and packages (commonly, the ``site-packages`` directory)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:45 +#: ../source/specifications/recording-installed-packages.rst:29 msgid "" "This directory is named as ``{name}-{version}.dist-info``, with ``name`` and " "``version`` fields corresponding to :ref:`core-metadata`. Both fields must " @@ -15408,7 +15436,7 @@ msgid "" "``version`` fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:53 +#: ../source/specifications/recording-installed-packages.rst:37 msgid "" "Historically, tools have failed to replace dot characters or normalize case " "in the ``name`` field, or not perform normalization in the ``version`` " @@ -15419,7 +15447,7 @@ msgid "" "existing tools are encouraged to start normalizing those fields." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:63 +#: ../source/specifications/recording-installed-packages.rst:47 msgid "" "The ``.dist-info`` directory's name is formatted to unambiguously represent " "a distribution as a filesystem path. Tools presenting a distribution name to " @@ -15431,41 +15459,41 @@ msgid "" "name when displaying distribution information." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:72 +#: ../source/specifications/recording-installed-packages.rst:56 msgid "" "This ``.dist-info`` directory may contain the following files, described in " "detail below:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:75 +#: ../source/specifications/recording-installed-packages.rst:59 msgid "``METADATA``: contains project metadata" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:76 +#: ../source/specifications/recording-installed-packages.rst:60 msgid "``RECORD``: records the list of installed files." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:77 +#: ../source/specifications/recording-installed-packages.rst:61 msgid "" "``INSTALLER``: records the name of the tool used to install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:78 +#: ../source/specifications/recording-installed-packages.rst:62 msgid "``entry_points.txt``: see :ref:`entry-points` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:79 +#: ../source/specifications/recording-installed-packages.rst:63 msgid "``direct_url.json``: see :ref:`direct-url` for details" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:81 +#: ../source/specifications/recording-installed-packages.rst:65 msgid "" "The ``METADATA`` file is mandatory. All other files may be omitted at the " "installing tool's discretion. Additional installer-specific files may be " "present." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:87 +#: ../source/specifications/recording-installed-packages.rst:71 msgid "" "The :ref:`binary-distribution-format` specification describes additional " "files that may appear in the ``.dist-info`` directory of a :term:`Wheel`. " @@ -15473,7 +15501,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:92 +#: ../source/specifications/recording-installed-packages.rst:76 msgid "" "The previous versions of this specification also specified a ``REQUESTED`` " "file. This file is now considered a tool-specific extension, but may be " @@ -15481,58 +15509,58 @@ msgid "" "peps/pep-0376/#requested>`_ for its original meaning." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:99 +#: ../source/specifications/recording-installed-packages.rst:83 msgid "The METADATA file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:101 +#: ../source/specifications/recording-installed-packages.rst:85 msgid "" "The ``METADATA`` file contains metadata as described in the :ref:`core-" "metadata` specification, version 1.1 or greater." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:104 +#: ../source/specifications/recording-installed-packages.rst:88 msgid "" "The ``METADATA`` file is mandatory. If it cannot be created, or if required " "core metadata is not available, installers must report an error and fail to " "install the project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:110 +#: ../source/specifications/recording-installed-packages.rst:94 msgid "The RECORD file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:112 +#: ../source/specifications/recording-installed-packages.rst:96 msgid "" "The ``RECORD`` file holds the list of installed files. It is a CSV file " "containing one record (line) per installed file." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:115 +#: ../source/specifications/recording-installed-packages.rst:99 msgid "" "The CSV dialect must be readable with the default ``reader`` of Python's " "``csv`` module:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:118 +#: ../source/specifications/recording-installed-packages.rst:102 msgid "field delimiter: ``,`` (comma)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:119 +#: ../source/specifications/recording-installed-packages.rst:103 msgid "quoting char: ``\"`` (straight double quote)," msgstr "" -#: ../source/specifications/recording-installed-packages.rst:120 +#: ../source/specifications/recording-installed-packages.rst:104 msgid "line terminator: either ``\\r\\n`` or ``\\n``." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:122 +#: ../source/specifications/recording-installed-packages.rst:106 msgid "" "Each record is composed of three elements: the file's **path**, the **hash** " "of the contents, and its **size**." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:125 +#: ../source/specifications/recording-installed-packages.rst:109 msgid "" "The *path* may be either absolute, or relative to the directory containing " "the ``.dist-info`` directory (commonly, the ``site-packages`` directory). On " @@ -15540,7 +15568,7 @@ msgid "" "`` or ``\\``)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:130 +#: ../source/specifications/recording-installed-packages.rst:114 msgid "" "The *hash* is either an empty string or the name of a hash algorithm from " "``hashlib.algorithms_guaranteed``, followed by the equals character ``=`` " @@ -15548,13 +15576,13 @@ msgid "" "encoding (``base64.urlsafe_b64encode(digest)`` with trailing ``=`` removed)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:135 +#: ../source/specifications/recording-installed-packages.rst:119 msgid "" "The *size* is either the empty string, or file's size in bytes, as a base 10 " "integer." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:138 +#: ../source/specifications/recording-installed-packages.rst:122 msgid "" "For any file, either or both of the *hash* and *size* fields may be left " "empty. Commonly, entries for ``.pyc`` files and the ``RECORD`` file itself " @@ -15563,7 +15591,7 @@ msgid "" "project." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:144 +#: ../source/specifications/recording-installed-packages.rst:128 msgid "" "If the ``RECORD`` file is present, it must list all installed files of the " "project, except ``.pyc`` files corresponding to ``.py`` files listed in " @@ -15572,18 +15600,18 @@ msgid "" "should not be listed." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:151 +#: ../source/specifications/recording-installed-packages.rst:135 msgid "" "To completely uninstall a package, a tool needs to remove all files listed " "in ``RECORD``, all ``.pyc`` files (of all optimization levels) corresponding " "to removed ``.py`` files, and any directories emptied by the uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:156 +#: ../source/specifications/recording-installed-packages.rst:140 msgid "Here is an example snippet of a possible ``RECORD`` file::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:175 +#: ../source/specifications/recording-installed-packages.rst:159 msgid "" "If the ``RECORD`` file is missing, tools that rely on ``.dist-info`` must " "not attempt to uninstall or upgrade the package. (This restriction does not " @@ -15591,7 +15619,7 @@ msgid "" "package managers in Linux distros.)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:182 +#: ../source/specifications/recording-installed-packages.rst:166 msgid "" "It is *strongly discouraged* for an installed package to modify itself (e." "g., store cache files under its namespace in ``site-packages``). Changes " @@ -15601,11 +15629,11 @@ msgid "" "unlisted files in place (possibly resulting in a zombie namespace package)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:191 +#: ../source/specifications/recording-installed-packages.rst:175 msgid "The INSTALLER file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:193 +#: ../source/specifications/recording-installed-packages.rst:177 msgid "" "If present, ``INSTALLER`` is a single-line text file naming the tool used to " "install the project. If the installer is executable from the command line, " @@ -15613,15 +15641,15 @@ msgid "" "a printable ASCII string." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:199 +#: ../source/specifications/recording-installed-packages.rst:183 msgid "The file can be terminated by zero or more ASCII whitespace characters." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:201 +#: ../source/specifications/recording-installed-packages.rst:185 msgid "Here are examples of two possible ``INSTALLER`` files::" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:209 +#: ../source/specifications/recording-installed-packages.rst:193 msgid "" "This value should be used for informational purposes only. For example, if a " "tool is asked to uninstall a project but finds no ``RECORD`` file, it may " @@ -15629,11 +15657,11 @@ msgid "" "uninstallation." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:216 +#: ../source/specifications/recording-installed-packages.rst:200 msgid "The entry_points.txt file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:218 +#: ../source/specifications/recording-installed-packages.rst:202 msgid "" "This file MAY be created by installers to indicate when packages contain " "components intended for discovery and use by other code, including console " @@ -15641,29 +15669,29 @@ msgid "" "execution." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:223 +#: ../source/specifications/recording-installed-packages.rst:207 msgid "Its detailed specification is at :ref:`entry-points`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:227 +#: ../source/specifications/recording-installed-packages.rst:211 msgid "The direct_url.json file" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:229 +#: ../source/specifications/recording-installed-packages.rst:213 msgid "" "This file MUST be created by installers when installing a distribution from " "a requirement specifying a direct URL reference (including a VCS URL)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:235 +#: ../source/specifications/recording-installed-packages.rst:219 msgid "Its detailed specification is at :ref:`direct-url`." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:239 +#: ../source/specifications/recording-installed-packages.rst:223 msgid "Intentionally preventing changes to installed packages" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:241 +#: ../source/specifications/recording-installed-packages.rst:225 msgid "" "In some cases (such as when needing to manage external dependencies in " "addition to Python ecosystem dependencies), it is desirable for a tool that " @@ -15672,11 +15700,11 @@ msgid "" "so may cause compatibility problems with the wider environment." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:247 +#: ../source/specifications/recording-installed-packages.rst:231 msgid "To achieve this, affected tools should take the following steps:" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:249 +#: ../source/specifications/recording-installed-packages.rst:233 msgid "" "Rename or remove the ``RECORD`` file to prevent changes via other tools (e." "g. appending a suffix to create a non-standard ``RECORD.tool`` file if the " @@ -15684,14 +15712,14 @@ msgid "" "package contents are tracked and managed via other means)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:253 +#: ../source/specifications/recording-installed-packages.rst:237 msgid "" "Write an ``INSTALLER`` file indicating the name of the tool that should be " "used to manage the package (this allows ``RECORD``-aware tools to provide " "better error notices when asked to modify affected packages)" msgstr "" -#: ../source/specifications/recording-installed-packages.rst:257 +#: ../source/specifications/recording-installed-packages.rst:241 msgid "" "Python runtime providers may also prevent inadvertent modification of " "platform provided packages by modifying the default Python package " @@ -15700,13 +15728,33 @@ msgid "" "Python import path)." msgstr "" -#: ../source/specifications/recording-installed-packages.rst:262 +#: ../source/specifications/recording-installed-packages.rst:246 msgid "" "In some circumstances, it may be desirable to block even installation of " "additional packages via Python-specific tools. For these cases refer to :ref:" "`externally-managed-environments`" msgstr "" +#: ../source/specifications/recording-installed-packages.rst:254 +msgid "" +"June 2009: The original version of this specification was approved through :" +"pep:`376`. At the time, it was known as the *Database of Installed Python " +"Distributions*." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:257 +msgid "" +"March 2020: The specification of the ``direct_url.json`` file was approved " +"through :pep:`610`. It is only mentioned on this page; see :ref:`direct-url` " +"for the full definition." +msgstr "" + +#: ../source/specifications/recording-installed-packages.rst:260 +msgid "" +"September 2020: Various amendments and clarifications were approved through :" +"pep:`627`." +msgstr "" + #: ../source/specifications/section-distribution-formats.rst:3 msgid "Package Distribution File Formats" msgstr "" @@ -15985,26 +16033,24 @@ msgstr "" #: ../source/specifications/source-distribution-format.rst:146 msgid "" -"August 2023: Standardized the source distribution archive features (:pep:" -"`721`)" -msgstr "" - -#: ../source/specifications/source-distribution-format.rst:147 -msgid "" -"September 2022: Standardized the filename of a source distribution (:pep:" -"`625`)" +"November 2020: The original version of this specification was approved " +"through :pep:`643`." msgstr "" #: ../source/specifications/source-distribution-format.rst:148 -msgid "July 2021: Defined what a source tree is" +msgid "July 2021: Defined what a source tree is." msgstr "" #: ../source/specifications/source-distribution-format.rst:149 -msgid "November 2020: :pep:`643` converted to this specification" +msgid "" +"September 2022: The filename of a source distribution was standardized " +"through :pep:`625`." msgstr "" -#: ../source/specifications/source-distribution-format.rst:150 -msgid "December 2000: Source distributions standardized in :pep:`643`" +#: ../source/specifications/source-distribution-format.rst:151 +msgid "" +"August 2023: Source distribution archive features were standardized through :" +"pep:`721`." msgstr "" #: ../source/specifications/version-specifiers.rst:7 @@ -17614,10 +17660,7 @@ msgid "" msgstr "" #: ../source/specifications/version-specifiers.rst:1264 -msgid "" -"This specification was originally approved as :pep:`440`, addressing several " -"limitations of the previous attempt at standardized versioning, as described " -"in :pep:`345` and :pep:`386`." +msgid "August 2014: This specification was approved through :pep:`440`." msgstr "" #: ../source/specifications/virtual-environments.rst:6 @@ -17689,6 +17732,10 @@ msgid "" "will be detected and behave as a Python virtual environment." msgstr "" +#: ../source/specifications/virtual-environments.rst:56 +msgid "May 2012: This specification was approved through :pep:`405`." +msgstr "" + #: ../source/support.rst:3 msgid "How to Get Support" msgstr ""