8
8
msgstr ""
9
9
"Project-Id-Version: Python Packaging User Guide\n"
10
10
"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"
12
12
"PO-Revision-Date: 2025-01-19 01:44+0000\n"
13
13
"Last-Translator: Mohamed Brahimi <
[email protected] >\n"
14
14
"Language-Team: Arabic <https://hosted.weblate.org/projects/pypa/packaging-"
@@ -13529,7 +13529,7 @@ msgstr ""
13529
13529
13530
13530
#: ../source/specifications/binary-distribution-format.rst:455
13531
13531
#: ../source/specifications/core-metadata.rst:922
13532
- #: ../source/specifications/dependency-groups.rst:248
13532
+ #: ../source/specifications/dependency-groups.rst:250
13533
13533
#: ../source/specifications/dependency-specifiers.rst:516
13534
13534
#: ../source/specifications/direct-url-data-structure.rst:407
13535
13535
#: ../source/specifications/direct-url.rst:67
@@ -15304,65 +15304,67 @@ msgid ""
15304
15304
msgstr ""
15305
15305
15306
15306
#: ../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 ::"
15308
15308
msgstr ""
15309
15309
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::"
15312
15314
msgstr ""
15313
15315
15314
- #: ../source/specifications/dependency-groups.rst:37
15316
+ #: ../source/specifications/dependency-groups.rst:39
15315
15317
msgid "The ``[dependency-groups]`` Table"
15316
15318
msgstr ""
15317
15319
15318
- #: ../source/specifications/dependency-groups.rst:39
15320
+ #: ../source/specifications/dependency-groups.rst:41
15319
15321
msgid ""
15320
15322
"Dependency Groups are defined as a table in ``pyproject.toml`` named "
15321
15323
"``dependency-groups``. The ``dependency-groups`` table contains an arbitrary "
15322
15324
"number of user-defined keys, each of which has, as its value, a list of "
15323
15325
"requirements."
15324
15326
msgstr ""
15325
15327
15326
- #: ../source/specifications/dependency-groups.rst:44
15328
+ #: ../source/specifications/dependency-groups.rst:46
15327
15329
msgid ""
15328
15330
"``[dependency-groups]`` keys, sometimes also called \"group names\", must "
15329
15331
"be :ref:`valid non-normalized names <name-format>`. Tools which handle "
15330
15332
"Dependency Groups MUST :ref:`normalize <name-normalization>` these names "
15331
15333
"before comparisons."
15332
15334
msgstr ""
15333
15335
15334
- #: ../source/specifications/dependency-groups.rst:49
15336
+ #: ../source/specifications/dependency-groups.rst:51
15335
15337
msgid ""
15336
15338
"Tools SHOULD prefer to present the original, non-normalized name to users, "
15337
15339
"and if duplicate names are detected after normalization, tools SHOULD emit "
15338
15340
"an error."
15339
15341
msgstr ""
15340
15342
15341
- #: ../source/specifications/dependency-groups.rst:53
15343
+ #: ../source/specifications/dependency-groups.rst:55
15342
15344
msgid ""
15343
15345
"Requirement lists, the values in ``[dependency-groups]``, may contain "
15344
15346
"strings, tables (``dict`` in Python), or a mix of strings and tables. "
15345
15347
"Strings must be valid :ref:`dependency specifiers <dependency-specifiers>`, "
15346
15348
"and tables must be valid Dependency Group Includes."
15347
15349
msgstr ""
15348
15350
15349
- #: ../source/specifications/dependency-groups.rst:59
15351
+ #: ../source/specifications/dependency-groups.rst:61
15350
15352
msgid "Dependency Group Include"
15351
15353
msgstr ""
15352
15354
15353
- #: ../source/specifications/dependency-groups.rst:61
15355
+ #: ../source/specifications/dependency-groups.rst:63
15354
15356
msgid ""
15355
15357
"A Dependency Group Include includes another Dependency Group in the current "
15356
15358
"group."
15357
15359
msgstr ""
15358
15360
15359
- #: ../source/specifications/dependency-groups.rst:64
15361
+ #: ../source/specifications/dependency-groups.rst:66
15360
15362
msgid ""
15361
15363
"An include is a table with exactly one key, ``\"include-group\"``, whose "
15362
15364
"value is a string, the name of another Dependency Group."
15363
15365
msgstr ""
15364
15366
15365
- #: ../source/specifications/dependency-groups.rst:67
15367
+ #: ../source/specifications/dependency-groups.rst:69
15366
15368
msgid ""
15367
15369
"Includes are defined to be exactly equivalent to the contents of the named "
15368
15370
"Dependency Group, inserted into the current group at the location of the "
@@ -15372,61 +15374,61 @@ msgid ""
15372
15374
"are expanded."
15373
15375
msgstr ""
15374
15376
15375
- #: ../source/specifications/dependency-groups.rst:73
15377
+ #: ../source/specifications/dependency-groups.rst:75
15376
15378
msgid ""
15377
15379
"Dependency Group Includes may specify the same package multiple times. Tools "
15378
15380
"SHOULD NOT deduplicate or otherwise alter the list contents produced by the "
15379
15381
"include. For example, given the following table:"
15380
15382
msgstr ""
15381
15383
15382
- #: ../source/specifications/dependency-groups.rst:90
15384
+ #: ../source/specifications/dependency-groups.rst:92
15383
15385
msgid ""
15384
15386
"The resolved value of ``all`` SHOULD be ``[\"foo\", \"foo\", \"foo>1.0\", "
15385
15387
"\"foo<1.0\"]``. Tools should handle such a list exactly as they would handle "
15386
15388
"any other case in which they are asked to process the same requirement "
15387
15389
"multiple times with different version constraints."
15388
15390
msgstr ""
15389
15391
15390
- #: ../source/specifications/dependency-groups.rst:95
15392
+ #: ../source/specifications/dependency-groups.rst:97
15391
15393
msgid ""
15392
15394
"Dependency Group Includes may include groups containing Dependency Group "
15393
15395
"Includes, in which case those includes should be expanded as well. "
15394
15396
"Dependency Group Includes MUST NOT include cycles, and tools SHOULD report "
15395
15397
"an error if they detect a cycle."
15396
15398
msgstr ""
15397
15399
15398
- #: ../source/specifications/dependency-groups.rst:100
15400
+ #: ../source/specifications/dependency-groups.rst:102
15399
15401
msgid "Package Building"
15400
15402
msgstr ""
15401
15403
15402
- #: ../source/specifications/dependency-groups.rst:102
15404
+ #: ../source/specifications/dependency-groups.rst:104
15403
15405
msgid ""
15404
15406
"Build backends MUST NOT include Dependency Group data in built distributions "
15405
15407
"as package metadata. This means that sdist ``PKG-INFO`` and wheel "
15406
15408
"``METADATA`` files should not include referenceable fields containing "
15407
15409
"Dependency Groups."
15408
15410
msgstr ""
15409
15411
15410
- #: ../source/specifications/dependency-groups.rst:106
15412
+ #: ../source/specifications/dependency-groups.rst:108
15411
15413
msgid ""
15412
15414
"It is, however, valid to use Dependency Groups in the evaluation of dynamic "
15413
15415
"metadata, and ``pyproject.toml`` files included in sdists will still contain "
15414
15416
"``[dependency-groups]``. However, the table's contents are not part of a "
15415
15417
"built package's interfaces."
15416
15418
msgstr ""
15417
15419
15418
- #: ../source/specifications/dependency-groups.rst:112
15420
+ #: ../source/specifications/dependency-groups.rst:114
15419
15421
msgid "Installing Dependency Groups & Extras"
15420
15422
msgstr ""
15421
15423
15422
- #: ../source/specifications/dependency-groups.rst:114
15424
+ #: ../source/specifications/dependency-groups.rst:116
15423
15425
msgid ""
15424
15426
"There is no syntax or specification-defined interface for installing or "
15425
15427
"referring to Dependency Groups. Tools are expected to provide dedicated "
15426
15428
"interfaces for this purpose."
15427
15429
msgstr ""
15428
15430
15429
- #: ../source/specifications/dependency-groups.rst:118
15431
+ #: ../source/specifications/dependency-groups.rst:120
15430
15432
msgid ""
15431
15433
"Tools MAY choose to provide the same or similar interfaces for interacting "
15432
15434
"with Dependency Groups as they do for managing extras. Tools authors are "
@@ -15436,57 +15438,57 @@ msgid ""
15436
15438
"matching as an error."
15437
15439
msgstr ""
15438
15440
15439
- #: ../source/specifications/dependency-groups.rst:126
15441
+ #: ../source/specifications/dependency-groups.rst:128
15440
15442
msgid "Validation and Compatibility"
15441
15443
msgstr ""
15442
15444
15443
- #: ../source/specifications/dependency-groups.rst:128
15445
+ #: ../source/specifications/dependency-groups.rst:130
15444
15446
msgid ""
15445
15447
"Tools supporting Dependency Groups may want to validate data before using "
15446
15448
"it. When implementing such validation, authors should be aware of the "
15447
15449
"possibility of future extensions to the specification, so that they do not "
15448
15450
"unnecessarily emit errors or warnings."
15449
15451
msgstr ""
15450
15452
15451
- #: ../source/specifications/dependency-groups.rst:133
15453
+ #: ../source/specifications/dependency-groups.rst:135
15452
15454
msgid ""
15453
15455
"Tools SHOULD error when evaluating or processing unrecognized data in "
15454
15456
"Dependency Groups."
15455
15457
msgstr ""
15456
15458
15457
- #: ../source/specifications/dependency-groups.rst:136
15459
+ #: ../source/specifications/dependency-groups.rst:138
15458
15460
msgid ""
15459
15461
"Tools SHOULD NOT eagerly validate the contents of *all* Dependency Groups "
15460
15462
"unless they have a need to do so."
15461
15463
msgstr ""
15462
15464
15463
- #: ../source/specifications/dependency-groups.rst:139
15465
+ #: ../source/specifications/dependency-groups.rst:141
15464
15466
msgid ""
15465
15467
"This means that in the presence of the following data, most tools should "
15466
15468
"allow the ``foo`` group to be used and only error if the ``bar`` group is "
15467
15469
"used:"
15468
15470
msgstr ""
15469
15471
15470
- #: ../source/specifications/dependency-groups.rst:150
15472
+ #: ../source/specifications/dependency-groups.rst:152
15471
15473
msgid ""
15472
15474
"There are several known cases of tools which have good cause to be stricter. "
15473
15475
"Linters and validators are an example, as their purpose is to validate the "
15474
15476
"contents of all Dependency Groups."
15475
15477
msgstr ""
15476
15478
15477
- #: ../source/specifications/dependency-groups.rst:155
15479
+ #: ../source/specifications/dependency-groups.rst:157
15478
15480
#: ../source/specifications/inline-script-metadata.rst:123
15479
15481
msgid "Reference Implementation"
15480
15482
msgstr ""
15481
15483
15482
- #: ../source/specifications/dependency-groups.rst:157
15484
+ #: ../source/specifications/dependency-groups.rst:159
15483
15485
msgid ""
15484
15486
"The following Reference Implementation prints the contents of a Dependency "
15485
15487
"Group to stdout, newline delimited. The output is therefore valid "
15486
15488
"``requirements.txt`` data."
15487
15489
msgstr ""
15488
15490
15489
- #: ../source/specifications/dependency-groups.rst:250
15491
+ #: ../source/specifications/dependency-groups.rst:252
15490
15492
msgid "October 2024: This specification was approved through :pep:`735`."
15491
15493
msgstr ""
15492
15494
0 commit comments