Skip to content

Commit 4d50a2e

Browse files
Update messages.pot as of version 400582c
1 parent 9baef6c commit 4d50a2e

File tree

1 file changed

+59
-55
lines changed

1 file changed

+59
-55
lines changed

locales/messages.pot

Lines changed: 59 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Python Packaging User Guide \n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2025-11-24 00:10+0000\n"
11+
"POT-Creation-Date: 2025-11-25 23:26+0000\n"
1212
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1313
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1414
"Language-Team: LANGUAGE <[email protected]>\n"
@@ -2640,7 +2640,7 @@ msgstr ""
26402640
#: ../source/specifications/dependency-groups.rst:23
26412641
#: ../source/specifications/dependency-specifiers.rst:29
26422642
#: ../source/specifications/direct-url-data-structure.rst:242
2643-
#: ../source/specifications/version-specifiers.rst:1072
2643+
#: ../source/specifications/version-specifiers.rst:1073
26442644
msgid "Examples"
26452645
msgstr ""
26462646

@@ -9219,7 +9219,7 @@ msgstr ""
92199219
#: ../source/specifications/recording-installed-packages.rst:278
92209220
#: ../source/specifications/simple-repository-api.rst:972
92219221
#: ../source/specifications/source-distribution-format.rst:153
9222-
#: ../source/specifications/version-specifiers.rst:1269
9222+
#: ../source/specifications/version-specifiers.rst:1270
92239223
#: ../source/specifications/virtual-environments.rst:54
92249224
msgid "History"
92259225
msgstr ""
@@ -16975,213 +16975,217 @@ msgid "Arbitrary equality"
1697516975
msgstr ""
1697616976

1697716977
#: ../source/specifications/version-specifiers.rst:1017
16978-
msgid "Arbitrary equality comparisons are simple string equality operations which do not take into account any of the semantic information such as zero padding or local versions. This operator also does not support prefix matching as the ``==`` operator does."
16978+
msgid "Arbitrary equality comparisons are simple string equality operations which do not take into account any of the semantic information such as zero padding or local versions. The comparison MUST treat ASCII letters case-insensitively, e.g. by lowercasing, and is unspecified for non-ASCII text. This operator also does not support prefix matching as the ``==`` operator does."
1697916979
msgstr ""
1698016980

16981-
#: ../source/specifications/version-specifiers.rst:1022
16981+
#: ../source/specifications/version-specifiers.rst:1023
1698216982
msgid "The primary use case for arbitrary equality is to allow for specifying a version which cannot otherwise be represented by this specification. This operator is special and acts as an escape hatch to allow someone using a tool which implements this specification to still install a legacy version which is otherwise incompatible with this specification."
1698316983
msgstr ""
1698416984

16985-
#: ../source/specifications/version-specifiers.rst:1028
16985+
#: ../source/specifications/version-specifiers.rst:1029
1698616986
msgid "An example would be ``===foobar`` which would match a version of ``foobar``."
1698716987
msgstr ""
1698816988

16989-
#: ../source/specifications/version-specifiers.rst:1030
16989+
#: ../source/specifications/version-specifiers.rst:1031
1699016990
msgid "This operator may also be used to explicitly require an unpatched version of a project such as ``===1.0`` which would not match for a version ``1.0+downstream1``."
1699116991
msgstr ""
1699216992

16993-
#: ../source/specifications/version-specifiers.rst:1034
16993+
#: ../source/specifications/version-specifiers.rst:1035
1699416994
msgid "Use of this operator is heavily discouraged and tooling MAY display a warning when it is used."
1699516995
msgstr ""
1699616996

16997-
#: ../source/specifications/version-specifiers.rst:1039
16997+
#: ../source/specifications/version-specifiers.rst:1040
1699816998
msgid "Handling of pre-releases"
1699916999
msgstr ""
1700017000

17001-
#: ../source/specifications/version-specifiers.rst:1041
17001+
#: ../source/specifications/version-specifiers.rst:1042
1700217002
msgid "Pre-releases of any kind, including developmental releases, are implicitly excluded from all version specifiers, *unless* they are already present on the system, explicitly requested by the user, or if the only available version that satisfies the version specifier is a pre-release."
1700317003
msgstr ""
1700417004

17005-
#: ../source/specifications/version-specifiers.rst:1046
17005+
#: ../source/specifications/version-specifiers.rst:1047
1700617006
msgid "By default, dependency resolution tools SHOULD:"
1700717007
msgstr ""
1700817008

17009-
#: ../source/specifications/version-specifiers.rst:1048
17009+
#: ../source/specifications/version-specifiers.rst:1049
1701017010
msgid "accept already installed pre-releases for all version specifiers"
1701117011
msgstr ""
1701217012

17013-
#: ../source/specifications/version-specifiers.rst:1049
17013+
#: ../source/specifications/version-specifiers.rst:1050
1701417014
msgid "accept remotely available pre-releases for version specifiers where there is no final or post release that satisfies the version specifier"
1701517015
msgstr ""
1701617016

17017-
#: ../source/specifications/version-specifiers.rst:1051
17017+
#: ../source/specifications/version-specifiers.rst:1052
1701817018
msgid "exclude all other pre-releases from consideration"
1701917019
msgstr ""
1702017020

17021-
#: ../source/specifications/version-specifiers.rst:1053
17021+
#: ../source/specifications/version-specifiers.rst:1054
1702217022
msgid "Dependency resolution tools MAY issue a warning if a pre-release is needed to satisfy a version specifier."
1702317023
msgstr ""
1702417024

17025-
#: ../source/specifications/version-specifiers.rst:1056
17025+
#: ../source/specifications/version-specifiers.rst:1057
1702617026
msgid "Dependency resolution tools SHOULD also allow users to request the following alternative behaviours:"
1702717027
msgstr ""
1702817028

17029-
#: ../source/specifications/version-specifiers.rst:1059
17029+
#: ../source/specifications/version-specifiers.rst:1060
1703017030
msgid "accepting pre-releases for all version specifiers"
1703117031
msgstr ""
1703217032

17033-
#: ../source/specifications/version-specifiers.rst:1060
17033+
#: ../source/specifications/version-specifiers.rst:1061
1703417034
msgid "excluding pre-releases for all version specifiers (reporting an error or warning if a pre-release is already installed locally, or if a pre-release is the only way to satisfy a particular specifier)"
1703517035
msgstr ""
1703617036

17037-
#: ../source/specifications/version-specifiers.rst:1064
17037+
#: ../source/specifications/version-specifiers.rst:1065
1703817038
msgid "Dependency resolution tools MAY also allow the above behaviour to be controlled on a per-distribution basis."
1703917039
msgstr ""
1704017040

17041-
#: ../source/specifications/version-specifiers.rst:1067
17041+
#: ../source/specifications/version-specifiers.rst:1068
1704217042
msgid "Post-releases and final releases receive no special treatment in version specifiers - they are always included unless explicitly excluded."
1704317043
msgstr ""
1704417044

17045-
#: ../source/specifications/version-specifiers.rst:1074
17045+
#: ../source/specifications/version-specifiers.rst:1075
1704617046
msgid "``~=3.1``: version 3.1 or later, but not version 4.0 or later."
1704717047
msgstr ""
1704817048

17049-
#: ../source/specifications/version-specifiers.rst:1075
17049+
#: ../source/specifications/version-specifiers.rst:1076
1705017050
msgid "``~=3.1.2``: version 3.1.2 or later, but not version 3.2.0 or later."
1705117051
msgstr ""
1705217052

17053-
#: ../source/specifications/version-specifiers.rst:1076
17053+
#: ../source/specifications/version-specifiers.rst:1077
1705417054
msgid "``~=3.1a1``: version 3.1a1 or later, but not version 4.0 or later."
1705517055
msgstr ""
1705617056

17057-
#: ../source/specifications/version-specifiers.rst:1077
17057+
#: ../source/specifications/version-specifiers.rst:1078
1705817058
msgid "``== 3.1``: specifically version 3.1 (or 3.1.0), excludes all pre-releases, post releases, developmental releases and any 3.1.x maintenance releases."
1705917059
msgstr ""
1706017060

17061-
#: ../source/specifications/version-specifiers.rst:1079
17061+
#: ../source/specifications/version-specifiers.rst:1080
1706217062
msgid "``== 3.1.*``: any version that starts with 3.1. Equivalent to the ``~=3.1.0`` compatible release clause."
1706317063
msgstr ""
1706417064

17065-
#: ../source/specifications/version-specifiers.rst:1081
17065+
#: ../source/specifications/version-specifiers.rst:1082
1706617066
msgid "``~=3.1.0, != 3.1.3``: version 3.1.0 or later, but not version 3.1.3 and not version 3.2.0 or later."
1706717067
msgstr ""
1706817068

17069-
#: ../source/specifications/version-specifiers.rst:1086
17069+
#: ../source/specifications/version-specifiers.rst:1087
1707017070
msgid "Direct references"
1707117071
msgstr ""
1707217072

17073-
#: ../source/specifications/version-specifiers.rst:1088
17073+
#: ../source/specifications/version-specifiers.rst:1089
1707417074
msgid "Some automated tools may permit the use of a direct reference as an alternative to a normal version specifier. A direct reference consists of the specifier ``@`` and an explicit URL."
1707517075
msgstr ""
1707617076

17077-
#: ../source/specifications/version-specifiers.rst:1092
17077+
#: ../source/specifications/version-specifiers.rst:1093
1707817078
msgid "Whether or not direct references are appropriate depends on the specific use case for the version specifier. Automated tools SHOULD at least issue warnings and MAY reject them entirely when direct references are used inappropriately."
1707917079
msgstr ""
1708017080

17081-
#: ../source/specifications/version-specifiers.rst:1097
17081+
#: ../source/specifications/version-specifiers.rst:1098
1708217082
msgid "Public index servers SHOULD NOT allow the use of direct references in uploaded distributions. Direct references are intended as a tool for software integrators rather than publishers."
1708317083
msgstr ""
1708417084

17085-
#: ../source/specifications/version-specifiers.rst:1101
17085+
#: ../source/specifications/version-specifiers.rst:1102
1708617086
msgid "Depending on the use case, some appropriate targets for a direct URL reference may be an sdist or a wheel binary archive. The exact URLs and targets supported will be tool dependent."
1708717087
msgstr ""
1708817088

17089-
#: ../source/specifications/version-specifiers.rst:1105
17089+
#: ../source/specifications/version-specifiers.rst:1106
1709017090
msgid "For example, a local source archive may be referenced directly::"
1709117091
msgstr ""
1709217092

17093-
#: ../source/specifications/version-specifiers.rst:1109
17093+
#: ../source/specifications/version-specifiers.rst:1110
1709417094
msgid "Alternatively, a prebuilt archive may also be referenced::"
1709517095
msgstr ""
1709617096

17097-
#: ../source/specifications/version-specifiers.rst:1113
17097+
#: ../source/specifications/version-specifiers.rst:1114
1709817098
msgid "All direct references that do not refer to a local file URL SHOULD specify a secure transport mechanism (such as ``https``) AND include an expected hash value in the URL for verification purposes. If a direct reference is specified without any hash information, with hash information that the tool doesn't understand, or with a selected hash algorithm that the tool considers too weak to trust, automated tools SHOULD at least emit a warning and MAY refuse to rely on the URL. If such a direct reference also uses an insecure transport, automated tools SHOULD NOT rely on the URL."
1709917099
msgstr ""
1710017100

17101-
#: ../source/specifications/version-specifiers.rst:1122
17101+
#: ../source/specifications/version-specifiers.rst:1123
1710217102
msgid "It is RECOMMENDED that only hashes which are unconditionally provided by the latest version of the standard library's :py:mod:`hashlib` module be used for source archive hashes. At time of writing, that list consists of ``'md5'``, ``'sha1'``, ``'sha224'``, ``'sha256'``, ``'sha384'``, and ``'sha512'``."
1710317103
msgstr ""
1710417104

17105-
#: ../source/specifications/version-specifiers.rst:1128
17105+
#: ../source/specifications/version-specifiers.rst:1129
1710617106
msgid "For source archive and wheel references, an expected hash value may be specified by including a ``<hash-algorithm>=<expected-hash>`` entry as part of the URL fragment."
1710717107
msgstr ""
1710817108

17109-
#: ../source/specifications/version-specifiers.rst:1132
17109+
#: ../source/specifications/version-specifiers.rst:1133
1711017110
msgid "For version control references, the ``VCS+protocol`` scheme SHOULD be used to identify both the version control system and the secure transport, and a version control system with hash based commit identifiers SHOULD be used. Automated tools MAY omit warnings about missing hashes for version control systems that do not provide hash based commit identifiers."
1711117111
msgstr ""
1711217112

17113-
#: ../source/specifications/version-specifiers.rst:1138
17113+
#: ../source/specifications/version-specifiers.rst:1139
1711417114
msgid "To handle version control systems that do not support including commit or tag references directly in the URL, that information may be appended to the end of the URL using the ``@<commit-hash>`` or the ``@<tag>#<commit-hash>`` notation."
1711517115
msgstr ""
1711617116

17117-
#: ../source/specifications/version-specifiers.rst:1145
17117+
#: ../source/specifications/version-specifiers.rst:1146
1711817118
msgid "This isn't *quite* the same as the existing VCS reference notation supported by pip. Firstly, the distribution name is moved in front rather than embedded as part of the URL. Secondly, the commit hash is included even when retrieving based on a tag, in order to meet the requirement above that *every* link should include a hash to make things harder to forge (creating a malicious repo with a particular tag is easy, creating one with a specific *hash*, less so)."
1711917119
msgstr ""
1712017120

17121-
#: ../source/specifications/version-specifiers.rst:1153
17121+
#: ../source/specifications/version-specifiers.rst:1154
1712217122
msgid "Remote URL examples::"
1712317123
msgstr ""
1712417124

17125-
#: ../source/specifications/version-specifiers.rst:1161
17125+
#: ../source/specifications/version-specifiers.rst:1162
1712617126
msgid "File URLs"
1712717127
msgstr ""
1712817128

17129-
#: ../source/specifications/version-specifiers.rst:1163
17129+
#: ../source/specifications/version-specifiers.rst:1164
1713017130
msgid "File URLs take the form of ``file://<host>/<path>``. If the ``<host>`` is omitted it is assumed to be ``localhost`` and even if the ``<host>`` is omitted the third slash MUST still exist. The ``<path>`` defines what the file path on the filesystem that is to be accessed."
1713117131
msgstr ""
1713217132

17133-
#: ../source/specifications/version-specifiers.rst:1168
17133+
#: ../source/specifications/version-specifiers.rst:1169
1713417134
msgid "On the various \\*nix operating systems the only allowed values for ``<host>`` is for it to be omitted, ``localhost``, or another FQDN that the current machine believes matches its own host. In other words, on \\*nix the ``file://`` scheme can only be used to access paths on the local machine."
1713517135
msgstr ""
1713617136

17137-
#: ../source/specifications/version-specifiers.rst:1173
17137+
#: ../source/specifications/version-specifiers.rst:1174
1713817138
msgid "On Windows the file format should include the drive letter if applicable as part of the ``<path>`` (e.g. ``file:///c:/path/to/a/file``). Unlike \\*nix on Windows the ``<host>`` parameter may be used to specify a file residing on a network share. In other words, in order to translate ``\\\\machine\\volume\\file`` to a ``file://`` url, it would end up as ``file://machine/volume/file``. For more information on ``file://`` URLs on Windows see `MSDN <https://web.archive.org/web/20130321051043/http://blogs.msdn.com/b/ie/archive/2006/12/06/file-uris-in-windows.aspx>`_."
1713917139
msgstr ""
1714017140

17141-
#: ../source/specifications/version-specifiers.rst:1184
17141+
#: ../source/specifications/version-specifiers.rst:1185
1714217142
msgid "Summary of differences from pkg_resources.parse_version"
1714317143
msgstr ""
1714417144

17145-
#: ../source/specifications/version-specifiers.rst:1186
17145+
#: ../source/specifications/version-specifiers.rst:1187
1714617146
msgid "Note: this comparison is to ``pkg_resources.parse_version`` as it existed at the time :pep:`440` was written. After the PEP was accepted, setuptools 6.0 and later versions adopted the behaviour described here."
1714717147
msgstr ""
1714817148

17149-
#: ../source/specifications/version-specifiers.rst:1190
17149+
#: ../source/specifications/version-specifiers.rst:1191
1715017150
msgid "Local versions sort differently, this specification requires that they sort as greater than the same version without a local version, whereas ``pkg_resources.parse_version`` considers it a pre-release marker."
1715117151
msgstr ""
1715217152

17153-
#: ../source/specifications/version-specifiers.rst:1194
17153+
#: ../source/specifications/version-specifiers.rst:1195
1715417154
msgid "This specification purposely restricts the syntax which constitutes a valid version while ``pkg_resources.parse_version`` attempts to provide some meaning from *any* arbitrary string."
1715517155
msgstr ""
1715617156

17157-
#: ../source/specifications/version-specifiers.rst:1198
17157+
#: ../source/specifications/version-specifiers.rst:1199
1715817158
msgid "``pkg_resources.parse_version`` allows arbitrarily deeply nested version signifiers like ``1.0.dev1.post1.dev5``. This specification however allows only a single use of each type and they must exist in a certain order."
1715917159
msgstr ""
1716017160

17161-
#: ../source/specifications/version-specifiers.rst:1207
17161+
#: ../source/specifications/version-specifiers.rst:1208
1716217162
msgid "Appendix: Parsing version strings with regular expressions"
1716317163
msgstr ""
1716417164

17165-
#: ../source/specifications/version-specifiers.rst:1209
17165+
#: ../source/specifications/version-specifiers.rst:1210
1716617166
msgid "As noted earlier in the :ref:`public-version-identifiers` section, published version identifiers SHOULD use the canonical format. This section provides regular expressions that can be used to test whether a version is already in that form, and if it's not, extract the various components for subsequent normalization."
1716717167
msgstr ""
1716817168

17169-
#: ../source/specifications/version-specifiers.rst:1215
17169+
#: ../source/specifications/version-specifiers.rst:1216
1717017170
msgid "To test whether a version identifier is in the canonical format, you can use the following function:"
1717117171
msgstr ""
1717217172

17173-
#: ../source/specifications/version-specifiers.rst:1224
17173+
#: ../source/specifications/version-specifiers.rst:1225
1717417174
msgid "To extract the components of a version identifier, use the following regular expression (as defined by the `packaging <https://github.com/pypa/packaging>`_ project):"
1717517175
msgstr ""
1717617176

17177-
#: ../source/specifications/version-specifiers.rst:1271
17177+
#: ../source/specifications/version-specifiers.rst:1272
1717817178
msgid "August 2014: This specification was approved through :pep:`440`."
1717917179
msgstr ""
1718017180

17181-
#: ../source/specifications/version-specifiers.rst:1272
17181+
#: ../source/specifications/version-specifiers.rst:1273
1718217182
msgid "May 2025: Clarify that development releases are a form of pre-release when they are handled."
1718317183
msgstr ""
1718417184

17185+
#: ../source/specifications/version-specifiers.rst:1275
17186+
msgid "Nov 2025: Make arbitrary equality case insensitivity explicit."
17187+
msgstr ""
17188+
1718517189
#: ../source/specifications/virtual-environments.rst:6
1718617190
msgid "Python Virtual Environments"
1718717191
msgstr ""

0 commit comments

Comments
 (0)