Skip to content

Commit 4dbcdcf

Browse files
Update messages.pot as of version 2747eae
1 parent f6dd132 commit 4dbcdcf

File tree

1 file changed

+28
-60
lines changed

1 file changed

+28
-60
lines changed

locales/messages.pot

Lines changed: 28 additions & 60 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-10-16 23:52+0000\n"
11+
"POT-Creation-Date: 2025-10-17 01:14+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"
@@ -9217,7 +9217,7 @@ msgstr ""
92179217
#: ../source/specifications/pylock-toml.rst:826
92189218
#: ../source/specifications/pyproject-toml.rst:630
92199219
#: ../source/specifications/recording-installed-packages.rst:278
9220-
#: ../source/specifications/simple-repository-api.rst:1012
9220+
#: ../source/specifications/simple-repository-api.rst:972
92219221
#: ../source/specifications/source-distribution-format.rst:153
92229222
#: ../source/specifications/version-specifiers.rst:1269
92239223
#: ../source/specifications/virtual-environments.rst:54
@@ -12441,7 +12441,7 @@ msgid "The following is an example of how to read a stream of arbitrary metadata
1244112441
msgstr ""
1244212442

1244312443
#: ../source/specifications/inline-script-metadata.rst:205
12444-
#: ../source/specifications/simple-repository-api.rst:954
12444+
#: ../source/specifications/simple-repository-api.rst:914
1244512445
msgid "Recommendations"
1244612446
msgstr ""
1244712447

@@ -15874,135 +15874,103 @@ msgstr ""
1587415874
msgid "For clients that wish to require specific configuration, they can keep track of which version+format a specific repository URL was configured for, and when making a request to that server, emit an ``Accept`` header that *only* includes the correct content type."
1587515875
msgstr ""
1587615876

15877-
#: ../source/specifications/simple-repository-api.rst:915
15878-
msgid "TUF Support - PEP 458"
15879-
msgstr ""
15880-
15881-
#: ../source/specifications/simple-repository-api.rst:917
15882-
msgid ":pep:`458` requires that all API responses are hashable and that they can be uniquely identified by a path relative to the repository root. For a Simple API repository, the target path is the Root of our API (e.g. ``/simple/`` on PyPI). This creates challenges when accessing the API using a TUF client instead of directly using a standard HTTP client, as the TUF client cannot handle the fact that a target could have multiple different representations that all hash differently."
15883-
msgstr ""
15884-
15885-
#: ../source/specifications/simple-repository-api.rst:924
15886-
msgid ":pep:`458` does not specify what the target path should be for the Simple API, but TUF requires that the target paths be \"file-like\", in other words, a path like ``simple/PROJECT/`` is not acceptable, because it technically points to a directory."
15887-
msgstr ""
15888-
15889-
#: ../source/specifications/simple-repository-api.rst:929
15890-
msgid "The saving grace is that the target path does not *have* to actually match the URL being fetched from the Simple API, and it can just be a sigil that the fetching code knows how to transform into the actual URL that needs to be fetched. This same thing can hold true for other aspects of the actual HTTP request, such as the ``Accept`` header."
15891-
msgstr ""
15892-
15893-
#: ../source/specifications/simple-repository-api.rst:935
15894-
msgid "Ultimately figuring out how to map a directory to a filename is out of scope for this spec (but it would be in scope for :pep:`458`), and this spec defers making a decision about how exactly to represent this inside of :pep:`458` metadata."
15895-
msgstr ""
15896-
15897-
#: ../source/specifications/simple-repository-api.rst:939
15898-
msgid "However, it appears that the current WIP branch against pip that attempts to implement :pep:`458` is using a target path like ``simple/PROJECT/index.html``. This could be modified to include the API version and serialization format using something like ``simple/PROJECT/vnd.pypi.simple.vN.FORMAT``. So the v1 HTML format would be ``simple/PROJECT/vnd.pypi.simple.v1.html`` and the v1 JSON format would be ``simple/PROJECT/vnd.pypi.simple.v1.json``."
15899-
msgstr ""
15900-
15901-
#: ../source/specifications/simple-repository-api.rst:946
15902-
msgid "In this case, since ``text/html`` is an alias to ``application/vnd.pypi.simple.v1+html`` when interacting through TUF, it likely will make the most sense to normalize to the more explicit name."
15903-
msgstr ""
15904-
15905-
#: ../source/specifications/simple-repository-api.rst:950
15906-
msgid "Likewise the ``latest`` metaversion should not be included in the targets, only explicitly declared versions should be supported."
15907-
msgstr ""
15908-
15909-
#: ../source/specifications/simple-repository-api.rst:956
15877+
#: ../source/specifications/simple-repository-api.rst:916
1591015878
msgid "This section is non-normative, and represents what the spec authors believe to be the best default implementation decisions for something implementing this spec, but it does **not** represent any sort of requirement to match these decisions."
1591115879
msgstr ""
1591215880

15913-
#: ../source/specifications/simple-repository-api.rst:960
15881+
#: ../source/specifications/simple-repository-api.rst:920
1591415882
msgid "These decisions have been chosen to maximize the number of requests that can be moved onto the newest version of an API, while maintaining the greatest amount of compatibility. In addition, they've also tried to make using the API provide guardrails that attempt to push clients into making the best choices it can."
1591515883
msgstr ""
1591615884

15917-
#: ../source/specifications/simple-repository-api.rst:965
15885+
#: ../source/specifications/simple-repository-api.rst:925
1591815886
msgid "It is recommended that servers:"
1591915887
msgstr ""
1592015888

15921-
#: ../source/specifications/simple-repository-api.rst:967
15889+
#: ../source/specifications/simple-repository-api.rst:927
1592215890
msgid "Support all 3 content types described in this spec, using server-driven content negotiation, for as long as they reasonably can, or at least as long as they're receiving non trivial traffic that uses the HTML responses."
1592315891
msgstr ""
1592415892

15925-
#: ../source/specifications/simple-repository-api.rst:971
15893+
#: ../source/specifications/simple-repository-api.rst:931
1592615894
msgid "When encountering an ``Accept`` header that does not contain any content types that it knows how to work with, the server should not ever return a ``300 Multiple Choice`` response, and instead return a ``406 Not Acceptable`` response."
1592715895
msgstr ""
1592815896

15929-
#: ../source/specifications/simple-repository-api.rst:976
15897+
#: ../source/specifications/simple-repository-api.rst:936
1593015898
msgid "However, if choosing to use the endpoint configuration, you should prefer to return a ``200 OK`` response in the expected content type for that endpoint."
1593115899
msgstr ""
1593215900

15933-
#: ../source/specifications/simple-repository-api.rst:979
15901+
#: ../source/specifications/simple-repository-api.rst:939
1593415902
msgid "When selecting an acceptable version, the server should choose the highest version that the client supports, with the most expressive/featureful serialization format, taking into account the specificity of the client requests as well as any quality priority values they have expressed, and it should only use the ``text/html`` content type as a last resort."
1593515903
msgstr ""
1593615904

15937-
#: ../source/specifications/simple-repository-api.rst:985
15905+
#: ../source/specifications/simple-repository-api.rst:945
1593815906
msgid "It is recommended that clients:"
1593915907
msgstr ""
1594015908

15941-
#: ../source/specifications/simple-repository-api.rst:987
15909+
#: ../source/specifications/simple-repository-api.rst:947
1594215910
msgid "Support all 3 content types described in this spec, using server-driven content negotiation, for as long as they reasonably can."
1594315911
msgstr ""
1594415912

15945-
#: ../source/specifications/simple-repository-api.rst:990
15913+
#: ../source/specifications/simple-repository-api.rst:950
1594615914
msgid "When constructing an ``Accept`` header, include all of the content types that you support."
1594715915
msgstr ""
1594815916

15949-
#: ../source/specifications/simple-repository-api.rst:993
15917+
#: ../source/specifications/simple-repository-api.rst:953
1595015918
msgid "You should generally *not* include a quality priority value for your content types, unless you have implementation specific reasons that you want the server to take into account (for example, if you're using the standard library HTML parser and you're worried that there may be some kinds of HTML responses that you're unable to parse in some edge cases)."
1595115919
msgstr ""
1595215920

15953-
#: ../source/specifications/simple-repository-api.rst:999
15921+
#: ../source/specifications/simple-repository-api.rst:959
1595415922
msgid "The one exception to this recommendation is that it is recommended that you *should* include a ``;q=0.01`` value on the legacy ``text/html`` content type, unless it is the only content type that you are requesting."
1595515923
msgstr ""
1595615924

15957-
#: ../source/specifications/simple-repository-api.rst:1003
15925+
#: ../source/specifications/simple-repository-api.rst:963
1595815926
msgid "Explicitly select what versions they are looking for, rather than using the ``latest`` meta version during normal operation."
1595915927
msgstr ""
1596015928

15961-
#: ../source/specifications/simple-repository-api.rst:1006
15929+
#: ../source/specifications/simple-repository-api.rst:966
1596215930
msgid "Check the ``Content-Type`` of the response and ensure it matches something that you were expecting."
1596315931
msgstr ""
1596415932

15965-
#: ../source/specifications/simple-repository-api.rst:1014
15933+
#: ../source/specifications/simple-repository-api.rst:974
1596615934
msgid "September 2015: initial form of the HTML format, in :pep:`503`"
1596715935
msgstr ""
1596815936

15969-
#: ../source/specifications/simple-repository-api.rst:1015
15937+
#: ../source/specifications/simple-repository-api.rst:975
1597015938
msgid "July 2016: Requires-Python metadata, in an update to :pep:`503`"
1597115939
msgstr ""
1597215940

15973-
#: ../source/specifications/simple-repository-api.rst:1016
15941+
#: ../source/specifications/simple-repository-api.rst:976
1597415942
msgid "May 2019: \"yank\" support, in :pep:`592`"
1597515943
msgstr ""
1597615944

15977-
#: ../source/specifications/simple-repository-api.rst:1017
15945+
#: ../source/specifications/simple-repository-api.rst:977
1597815946
msgid "July 2020: API versioning convention and metadata, and declaring the HTML format as API v1, in :pep:`629`"
1597915947
msgstr ""
1598015948

15981-
#: ../source/specifications/simple-repository-api.rst:1019
15949+
#: ../source/specifications/simple-repository-api.rst:979
1598215950
msgid "May 2021: providing package metadata independently from a package, in :pep:`658`"
1598315951
msgstr ""
1598415952

15985-
#: ../source/specifications/simple-repository-api.rst:1021
15953+
#: ../source/specifications/simple-repository-api.rst:981
1598615954
msgid "May 2022: initial form of the JSON format, with a mechanism for clients to choose between them, and declaring both formats as API v1, in :pep:`691`"
1598715955
msgstr ""
1598815956

15989-
#: ../source/specifications/simple-repository-api.rst:1023
15957+
#: ../source/specifications/simple-repository-api.rst:983
1599015958
msgid "October 2022: project versions and file size and upload-time in the JSON format, in :pep:`700`"
1599115959
msgstr ""
1599215960

15993-
#: ../source/specifications/simple-repository-api.rst:1025
15961+
#: ../source/specifications/simple-repository-api.rst:985
1599415962
msgid "June 2023: renaming the field which provides package metadata independently from a package, in :pep:`714`"
1599515963
msgstr ""
1599615964

15997-
#: ../source/specifications/simple-repository-api.rst:1027
15965+
#: ../source/specifications/simple-repository-api.rst:987
1599815966
msgid "November 2024: provenance metadata in the HTML and JSON formats, in :pep:`740`"
1599915967
msgstr ""
1600015968

16001-
#: ../source/specifications/simple-repository-api.rst:1028
15969+
#: ../source/specifications/simple-repository-api.rst:988
1600215970
msgid "July 2025: project status markers in the HTML and JSON formats, in :pep:`792`"
1600315971
msgstr ""
1600415972

16005-
#: ../source/specifications/simple-repository-api.rst:1029
15973+
#: ../source/specifications/simple-repository-api.rst:989
1600615974
msgid "July 2025: layout changes (dedicated page for file yanking, introduce concepts before API details)"
1600715975
msgstr ""
1600815976

0 commit comments

Comments
 (0)