88msgstr ""
99"Project-Id-Version: Python Packaging User Guide\n"
1010"Report-Msgid-Bugs-To: \n"
11- "POT-Creation-Date: 2025-05-18 19:05 +0000\n"
11+ "POT-Creation-Date: 2025-05-20 00:17 +0000\n"
1212"PO-Revision-Date: 2025-01-19 01:44+0000\n"
1313"Last-Translator: Mohamed Brahimi <
[email protected] >\n"
1414"Language-Team: Arabic <https://hosted.weblate.org/projects/pypa/packaging-"
@@ -13529,7 +13529,7 @@ msgstr ""
1352913529
1353013530#: ../source/specifications/binary-distribution-format.rst:455
1353113531#: ../source/specifications/core-metadata.rst:922
13532- #: ../source/specifications/dependency-groups.rst:248
13532+ #: ../source/specifications/dependency-groups.rst:250
1353313533#: ../source/specifications/dependency-specifiers.rst:516
1353413534#: ../source/specifications/direct-url-data-structure.rst:407
1353513535#: ../source/specifications/direct-url.rst:67
@@ -15304,65 +15304,67 @@ msgid ""
1530415304msgstr ""
1530515305
1530615306#: ../source/specifications/dependency-groups.rst:25
15307- msgid "This is a simple table which shows a ``test`` group ::"
15307+ msgid "This is a simple table which shows ``docs`` and ``test`` groups ::"
1530815308msgstr ""
1530915309
15310- #: ../source/specifications/dependency-groups.rst:30
15311- msgid "and a similar table which defines ``test`` and ``coverage`` groups::"
15310+ #: ../source/specifications/dependency-groups.rst:31
15311+ msgid ""
15312+ "and a similar table which defines ``docs``, ``test``, and ``coverage`` "
15313+ "groups::"
1531215314msgstr ""
1531315315
15314- #: ../source/specifications/dependency-groups.rst:37
15316+ #: ../source/specifications/dependency-groups.rst:39
1531515317msgid "The ``[dependency-groups]`` Table"
1531615318msgstr ""
1531715319
15318- #: ../source/specifications/dependency-groups.rst:39
15320+ #: ../source/specifications/dependency-groups.rst:41
1531915321msgid ""
1532015322"Dependency Groups are defined as a table in ``pyproject.toml`` named "
1532115323"``dependency-groups``. The ``dependency-groups`` table contains an arbitrary "
1532215324"number of user-defined keys, each of which has, as its value, a list of "
1532315325"requirements."
1532415326msgstr ""
1532515327
15326- #: ../source/specifications/dependency-groups.rst:44
15328+ #: ../source/specifications/dependency-groups.rst:46
1532715329msgid ""
1532815330"``[dependency-groups]`` keys, sometimes also called \"group names\", must "
1532915331"be :ref:`valid non-normalized names <name-format>`. Tools which handle "
1533015332"Dependency Groups MUST :ref:`normalize <name-normalization>` these names "
1533115333"before comparisons."
1533215334msgstr ""
1533315335
15334- #: ../source/specifications/dependency-groups.rst:49
15336+ #: ../source/specifications/dependency-groups.rst:51
1533515337msgid ""
1533615338"Tools SHOULD prefer to present the original, non-normalized name to users, "
1533715339"and if duplicate names are detected after normalization, tools SHOULD emit "
1533815340"an error."
1533915341msgstr ""
1534015342
15341- #: ../source/specifications/dependency-groups.rst:53
15343+ #: ../source/specifications/dependency-groups.rst:55
1534215344msgid ""
1534315345"Requirement lists, the values in ``[dependency-groups]``, may contain "
1534415346"strings, tables (``dict`` in Python), or a mix of strings and tables. "
1534515347"Strings must be valid :ref:`dependency specifiers <dependency-specifiers>`, "
1534615348"and tables must be valid Dependency Group Includes."
1534715349msgstr ""
1534815350
15349- #: ../source/specifications/dependency-groups.rst:59
15351+ #: ../source/specifications/dependency-groups.rst:61
1535015352msgid "Dependency Group Include"
1535115353msgstr ""
1535215354
15353- #: ../source/specifications/dependency-groups.rst:61
15355+ #: ../source/specifications/dependency-groups.rst:63
1535415356msgid ""
1535515357"A Dependency Group Include includes another Dependency Group in the current "
1535615358"group."
1535715359msgstr ""
1535815360
15359- #: ../source/specifications/dependency-groups.rst:64
15361+ #: ../source/specifications/dependency-groups.rst:66
1536015362msgid ""
1536115363"An include is a table with exactly one key, ``\"include-group\"``, whose "
1536215364"value is a string, the name of another Dependency Group."
1536315365msgstr ""
1536415366
15365- #: ../source/specifications/dependency-groups.rst:67
15367+ #: ../source/specifications/dependency-groups.rst:69
1536615368msgid ""
1536715369"Includes are defined to be exactly equivalent to the contents of the named "
1536815370"Dependency Group, inserted into the current group at the location of the "
@@ -15372,61 +15374,61 @@ msgid ""
1537215374"are expanded."
1537315375msgstr ""
1537415376
15375- #: ../source/specifications/dependency-groups.rst:73
15377+ #: ../source/specifications/dependency-groups.rst:75
1537615378msgid ""
1537715379"Dependency Group Includes may specify the same package multiple times. Tools "
1537815380"SHOULD NOT deduplicate or otherwise alter the list contents produced by the "
1537915381"include. For example, given the following table:"
1538015382msgstr ""
1538115383
15382- #: ../source/specifications/dependency-groups.rst:90
15384+ #: ../source/specifications/dependency-groups.rst:92
1538315385msgid ""
1538415386"The resolved value of ``all`` SHOULD be ``[\"foo\", \"foo\", \"foo>1.0\", "
1538515387"\"foo<1.0\"]``. Tools should handle such a list exactly as they would handle "
1538615388"any other case in which they are asked to process the same requirement "
1538715389"multiple times with different version constraints."
1538815390msgstr ""
1538915391
15390- #: ../source/specifications/dependency-groups.rst:95
15392+ #: ../source/specifications/dependency-groups.rst:97
1539115393msgid ""
1539215394"Dependency Group Includes may include groups containing Dependency Group "
1539315395"Includes, in which case those includes should be expanded as well. "
1539415396"Dependency Group Includes MUST NOT include cycles, and tools SHOULD report "
1539515397"an error if they detect a cycle."
1539615398msgstr ""
1539715399
15398- #: ../source/specifications/dependency-groups.rst:100
15400+ #: ../source/specifications/dependency-groups.rst:102
1539915401msgid "Package Building"
1540015402msgstr ""
1540115403
15402- #: ../source/specifications/dependency-groups.rst:102
15404+ #: ../source/specifications/dependency-groups.rst:104
1540315405msgid ""
1540415406"Build backends MUST NOT include Dependency Group data in built distributions "
1540515407"as package metadata. This means that sdist ``PKG-INFO`` and wheel "
1540615408"``METADATA`` files should not include referenceable fields containing "
1540715409"Dependency Groups."
1540815410msgstr ""
1540915411
15410- #: ../source/specifications/dependency-groups.rst:106
15412+ #: ../source/specifications/dependency-groups.rst:108
1541115413msgid ""
1541215414"It is, however, valid to use Dependency Groups in the evaluation of dynamic "
1541315415"metadata, and ``pyproject.toml`` files included in sdists will still contain "
1541415416"``[dependency-groups]``. However, the table's contents are not part of a "
1541515417"built package's interfaces."
1541615418msgstr ""
1541715419
15418- #: ../source/specifications/dependency-groups.rst:112
15420+ #: ../source/specifications/dependency-groups.rst:114
1541915421msgid "Installing Dependency Groups & Extras"
1542015422msgstr ""
1542115423
15422- #: ../source/specifications/dependency-groups.rst:114
15424+ #: ../source/specifications/dependency-groups.rst:116
1542315425msgid ""
1542415426"There is no syntax or specification-defined interface for installing or "
1542515427"referring to Dependency Groups. Tools are expected to provide dedicated "
1542615428"interfaces for this purpose."
1542715429msgstr ""
1542815430
15429- #: ../source/specifications/dependency-groups.rst:118
15431+ #: ../source/specifications/dependency-groups.rst:120
1543015432msgid ""
1543115433"Tools MAY choose to provide the same or similar interfaces for interacting "
1543215434"with Dependency Groups as they do for managing extras. Tools authors are "
@@ -15436,57 +15438,57 @@ msgid ""
1543615438"matching as an error."
1543715439msgstr ""
1543815440
15439- #: ../source/specifications/dependency-groups.rst:126
15441+ #: ../source/specifications/dependency-groups.rst:128
1544015442msgid "Validation and Compatibility"
1544115443msgstr ""
1544215444
15443- #: ../source/specifications/dependency-groups.rst:128
15445+ #: ../source/specifications/dependency-groups.rst:130
1544415446msgid ""
1544515447"Tools supporting Dependency Groups may want to validate data before using "
1544615448"it. When implementing such validation, authors should be aware of the "
1544715449"possibility of future extensions to the specification, so that they do not "
1544815450"unnecessarily emit errors or warnings."
1544915451msgstr ""
1545015452
15451- #: ../source/specifications/dependency-groups.rst:133
15453+ #: ../source/specifications/dependency-groups.rst:135
1545215454msgid ""
1545315455"Tools SHOULD error when evaluating or processing unrecognized data in "
1545415456"Dependency Groups."
1545515457msgstr ""
1545615458
15457- #: ../source/specifications/dependency-groups.rst:136
15459+ #: ../source/specifications/dependency-groups.rst:138
1545815460msgid ""
1545915461"Tools SHOULD NOT eagerly validate the contents of *all* Dependency Groups "
1546015462"unless they have a need to do so."
1546115463msgstr ""
1546215464
15463- #: ../source/specifications/dependency-groups.rst:139
15465+ #: ../source/specifications/dependency-groups.rst:141
1546415466msgid ""
1546515467"This means that in the presence of the following data, most tools should "
1546615468"allow the ``foo`` group to be used and only error if the ``bar`` group is "
1546715469"used:"
1546815470msgstr ""
1546915471
15470- #: ../source/specifications/dependency-groups.rst:150
15472+ #: ../source/specifications/dependency-groups.rst:152
1547115473msgid ""
1547215474"There are several known cases of tools which have good cause to be stricter. "
1547315475"Linters and validators are an example, as their purpose is to validate the "
1547415476"contents of all Dependency Groups."
1547515477msgstr ""
1547615478
15477- #: ../source/specifications/dependency-groups.rst:155
15479+ #: ../source/specifications/dependency-groups.rst:157
1547815480#: ../source/specifications/inline-script-metadata.rst:123
1547915481msgid "Reference Implementation"
1548015482msgstr ""
1548115483
15482- #: ../source/specifications/dependency-groups.rst:157
15484+ #: ../source/specifications/dependency-groups.rst:159
1548315485msgid ""
1548415486"The following Reference Implementation prints the contents of a Dependency "
1548515487"Group to stdout, newline delimited. The output is therefore valid "
1548615488"``requirements.txt`` data."
1548715489msgstr ""
1548815490
15489- #: ../source/specifications/dependency-groups.rst:250
15491+ #: ../source/specifications/dependency-groups.rst:252
1549015492msgid "October 2024: This specification was approved through :pep:`735`."
1549115493msgstr ""
1549215494
0 commit comments