Skip to content

Commit 2669554

Browse files
Update messages.pot as of version 5d82417
1 parent 58d08e7 commit 2669554

File tree

1 file changed

+34
-34
lines changed

1 file changed

+34
-34
lines changed

locales/messages.pot

Lines changed: 34 additions & 34 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: 2024-05-07 08:04+0000\n"
11+
"POT-Creation-Date: 2024-05-08 15:02+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"
@@ -8228,7 +8228,7 @@ msgstr ""
82288228
#: ../source/specifications/direct-url.rst:67
82298229
#: ../source/specifications/entry-points.rst:164
82308230
#: ../source/specifications/externally-managed-environments.rst:472
8231-
#: ../source/specifications/inline-script-metadata.rst:211
8231+
#: ../source/specifications/inline-script-metadata.rst:213
82328232
#: ../source/specifications/name-normalization.rst:50
82338233
#: ../source/specifications/platform-compatibility-tags.rst:332
82348234
#: ../source/specifications/pyproject-toml.rst:443
@@ -8933,7 +8933,7 @@ msgstr ""
89338933
#: ../source/specifications/dependency-specifiers.rst:26
89348934
#: ../source/specifications/direct-url-data-structure.rst:19
89358935
#: ../source/specifications/direct-url.rst:15
8936-
#: ../source/specifications/inline-script-metadata.rst:11
8936+
#: ../source/specifications/inline-script-metadata.rst:13
89378937
msgid "Specification"
89388938
msgstr ""
89398939

@@ -10067,128 +10067,128 @@ msgstr ""
1006710067
msgid "This is a list of currently active interoperability specifications maintained by the Python Packaging Authority. The process for updating these standards, and for proposing new ones, is documented on `pypa.io <https://www.pypa.io/en/latest/specifications/>`__."
1006810068
msgstr ""
1006910069

10070-
#: ../source/specifications/inline-script-metadata.rst:3
10070+
#: ../source/specifications/inline-script-metadata.rst:5
1007110071
msgid "Inline script metadata"
1007210072
msgstr ""
1007310073

10074-
#: ../source/specifications/inline-script-metadata.rst:5
10074+
#: ../source/specifications/inline-script-metadata.rst:7
1007510075
msgid "This specification defines a metadata format that can be embedded in single-file Python scripts to assist launchers, IDEs and other external tools which may need to interact with such scripts."
1007610076
msgstr ""
1007710077

10078-
#: ../source/specifications/inline-script-metadata.rst:13
10078+
#: ../source/specifications/inline-script-metadata.rst:15
1007910079
msgid "This specification defines a metadata comment block format (loosely inspired by `reStructuredText Directives`__)."
1008010080
msgstr ""
1008110081

10082-
#: ../source/specifications/inline-script-metadata.rst:18
10082+
#: ../source/specifications/inline-script-metadata.rst:20
1008310083
msgid "Any Python script may have top-level comment blocks that MUST start with the line ``# /// TYPE`` where ``TYPE`` determines how to process the content. That is: a single ``#``, followed by a single space, followed by three forward slashes, followed by a single space, followed by the type of metadata. Block MUST end with the line ``# ///``. That is: a single ``#``, followed by a single space, followed by three forward slashes. The ``TYPE`` MUST only consist of ASCII letters, numbers and hyphens."
1008410084
msgstr ""
1008510085

10086-
#: ../source/specifications/inline-script-metadata.rst:26
10086+
#: ../source/specifications/inline-script-metadata.rst:28
1008710087
msgid "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a comment starting with ``#``. If there are characters after the ``#`` then the first character MUST be a space. The embedded content is formed by taking away the first two characters of each line if the second character is a space, otherwise just the first character (which means the line consists of only a single ``#``)."
1008810088
msgstr ""
1008910089

10090-
#: ../source/specifications/inline-script-metadata.rst:33
10090+
#: ../source/specifications/inline-script-metadata.rst:35
1009110091
msgid "Precedence for an ending line ``# ///`` is given when the next line is not a valid embedded content line as described above. For example, the following is a single fully valid block:"
1009210092
msgstr ""
1009310093

10094-
#: ../source/specifications/inline-script-metadata.rst:49
10094+
#: ../source/specifications/inline-script-metadata.rst:51
1009510095
msgid "A starting line MUST NOT be placed between another starting line and its ending line. In such cases tools MAY produce an error. Unclosed blocks MUST be ignored."
1009610096
msgstr ""
1009710097

10098-
#: ../source/specifications/inline-script-metadata.rst:52
10098+
#: ../source/specifications/inline-script-metadata.rst:54
1009910099
msgid "When there are multiple comment blocks of the same ``TYPE`` defined, tools MUST produce an error."
1010010100
msgstr ""
1010110101

10102-
#: ../source/specifications/inline-script-metadata.rst:55
10102+
#: ../source/specifications/inline-script-metadata.rst:57
1010310103
msgid "Tools reading embedded metadata MAY respect the standard Python encoding declaration. If they choose not to do so, they MUST process the file as UTF-8."
1010410104
msgstr ""
1010510105

10106-
#: ../source/specifications/inline-script-metadata.rst:58
10106+
#: ../source/specifications/inline-script-metadata.rst:60
1010710107
msgid "This is the canonical regular expression that MAY be used to parse the metadata:"
1010810108
msgstr ""
1010910109

10110-
#: ../source/specifications/inline-script-metadata.rst:65
10110+
#: ../source/specifications/inline-script-metadata.rst:67
1011110111
msgid "In circumstances where there is a discrepancy between the text specification and the regular expression, the text specification takes precedence."
1011210112
msgstr ""
1011310113

10114-
#: ../source/specifications/inline-script-metadata.rst:68
10114+
#: ../source/specifications/inline-script-metadata.rst:70
1011510115
msgid "Tools MUST NOT read from metadata blocks with types that have not been standardized by this specification."
1011610116
msgstr ""
1011710117

10118-
#: ../source/specifications/inline-script-metadata.rst:72
10118+
#: ../source/specifications/inline-script-metadata.rst:74
1011910119
msgid "script type"
1012010120
msgstr ""
1012110121

10122-
#: ../source/specifications/inline-script-metadata.rst:74
10122+
#: ../source/specifications/inline-script-metadata.rst:76
1012310123
msgid "The first type of metadata block is named ``script``, which contains script metadata (dependency data and tool configuration)."
1012410124
msgstr ""
1012510125

10126-
#: ../source/specifications/inline-script-metadata.rst:77
10126+
#: ../source/specifications/inline-script-metadata.rst:79
1012710127
msgid "This document MAY include the top-level fields ``dependencies`` and ``requires-python``, and MAY optionally include a ``[tool]`` table."
1012810128
msgstr ""
1012910129

10130-
#: ../source/specifications/inline-script-metadata.rst:80
10130+
#: ../source/specifications/inline-script-metadata.rst:82
1013110131
msgid "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to configure behavior. It has the same semantics as the :ref:`[tool] table in pyproject.toml <pyproject-tool-table>`."
1013210132
msgstr ""
1013310133

10134-
#: ../source/specifications/inline-script-metadata.rst:84
10134+
#: ../source/specifications/inline-script-metadata.rst:86
1013510135
msgid "The top-level fields are:"
1013610136
msgstr ""
1013710137

10138-
#: ../source/specifications/inline-script-metadata.rst:86
10138+
#: ../source/specifications/inline-script-metadata.rst:88
1013910139
msgid "``dependencies``: A list of strings that specifies the runtime dependencies of the script. Each entry MUST be a valid :ref:`dependency specifier <dependency-specifiers>`."
1014010140
msgstr ""
1014110141

10142-
#: ../source/specifications/inline-script-metadata.rst:89
10142+
#: ../source/specifications/inline-script-metadata.rst:91
1014310143
msgid "``requires-python``: A string that specifies the Python version(s) with which the script is compatible. The value of this field MUST be a valid :ref:`version specifier <version-specifiers>`."
1014410144
msgstr ""
1014510145

10146-
#: ../source/specifications/inline-script-metadata.rst:93
10146+
#: ../source/specifications/inline-script-metadata.rst:95
1014710147
msgid "Script runners MUST error if the specified ``dependencies`` cannot be provided. Script runners SHOULD error if no version of Python that satisfies the specified ``requires-python`` can be provided."
1014810148
msgstr ""
1014910149

10150-
#: ../source/specifications/inline-script-metadata.rst:98
10150+
#: ../source/specifications/inline-script-metadata.rst:100
1015110151
msgid "Example"
1015210152
msgstr ""
1015310153

10154-
#: ../source/specifications/inline-script-metadata.rst:100
10154+
#: ../source/specifications/inline-script-metadata.rst:102
1015510155
msgid "The following is an example of a script with embedded metadata:"
1015610156
msgstr ""
1015710157

10158-
#: ../source/specifications/inline-script-metadata.rst:121
10158+
#: ../source/specifications/inline-script-metadata.rst:123
1015910159
msgid "Reference Implementation"
1016010160
msgstr ""
1016110161

10162-
#: ../source/specifications/inline-script-metadata.rst:123
10162+
#: ../source/specifications/inline-script-metadata.rst:125
1016310163
msgid "The following is an example of how to read the metadata on Python 3.11 or higher."
1016410164
msgstr ""
1016510165

10166-
#: ../source/specifications/inline-script-metadata.rst:149
10166+
#: ../source/specifications/inline-script-metadata.rst:151
1016710167
msgid "Often tools will edit dependencies like package managers or dependency update automation in CI. The following is a crude example of modifying the content using the ``tomlkit`` library__."
1016810168
msgstr ""
1016910169

10170-
#: ../source/specifications/inline-script-metadata.rst:180
10170+
#: ../source/specifications/inline-script-metadata.rst:182
1017110171
msgid "Note that this example used a library that preserves TOML formatting. This is not a requirement for editing by any means but rather is a \"nice to have\" feature."
1017210172
msgstr ""
1017310173

10174-
#: ../source/specifications/inline-script-metadata.rst:184
10174+
#: ../source/specifications/inline-script-metadata.rst:186
1017510175
msgid "The following is an example of how to read a stream of arbitrary metadata blocks."
1017610176
msgstr ""
1017710177

10178-
#: ../source/specifications/inline-script-metadata.rst:203
10178+
#: ../source/specifications/inline-script-metadata.rst:205
1017910179
#: ../source/specifications/simple-repository-api.rst:815
1018010180
msgid "Recommendations"
1018110181
msgstr ""
1018210182

10183-
#: ../source/specifications/inline-script-metadata.rst:205
10183+
#: ../source/specifications/inline-script-metadata.rst:207
1018410184
msgid "Tools that support managing different versions of Python should attempt to use the highest available version of Python that is compatible with the script's ``requires-python`` metadata, if defined."
1018510185
msgstr ""
1018610186

10187-
#: ../source/specifications/inline-script-metadata.rst:213
10187+
#: ../source/specifications/inline-script-metadata.rst:215
1018810188
msgid "October 2023: This specification was conditionally approved through :pep:`723`."
1018910189
msgstr ""
1019010190

10191-
#: ../source/specifications/inline-script-metadata.rst:214
10191+
#: ../source/specifications/inline-script-metadata.rst:216
1019210192
msgid "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata block type was renamed to ``script``, and the ``[run]`` table was dropped, making the ``dependencies`` and ``requires-python`` keys top-level. Additionally, the specification is no longer provisional."
1019310193
msgstr ""
1019410194

0 commit comments

Comments
 (0)