Merge pull request #1669 from weblate/weblate-pypa-packaging-python-org

Author: webknjaz

locales/ar/LC_MESSAGES/messages.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python Packaging User Guide\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-11-25 21:53+0000\n"
+"POT-Creation-Date: 2025-01-07 04:23+0000\n"
 "PO-Revision-Date: 2024-01-18 07:31+0000\n"
 "Last-Translator: Youcef Guenaoua <[email protected]>\n"
 "Language-Team: Arabic <https://hosted.weblate.org/projects/pypa/packaging-"
@@ -1668,7 +1668,9 @@ msgid "Where to read more about this?"
 msgstr ""
 
 #: ../source/discussions/setup-py-deprecated.rst:213
-msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html"
+msgid ""
+"`Why you shouldn't invoke setup.py directly <https://blog.ganssle.io/"
+"articles/2021/10/setup-py-deprecated.html>`__ by Paul Ganssle"
 msgstr ""
 
 #: ../source/discussions/setup-py-deprecated.rst:215
@@ -3180,6 +3182,7 @@ msgid "Description"
 msgstr ""
 
 #: ../source/guides/analyzing-pypi-package-downloads.rst:77
+#: ../source/specifications/dependency-groups.rst:23
 #: ../source/specifications/dependency-specifiers.rst:29
 #: ../source/specifications/direct-url-data-structure.rst:347
 #: ../source/specifications/version-specifiers.rst:1069
@@ -5202,9 +5205,9 @@ msgstr ""
 
 #: ../source/guides/installing-scientific-packages.rst:91
 msgid ""
-"The SciPy site lists `several distributions <https://scipy.org/install/"
-"#distributions>`_ that provide the full SciPy stack to end users in an easy "
-"to use and update format."
+"The SciPy site lists `several distributions <https://scipy.org/install/>`_ "
+"that provide the full SciPy stack to end users in an easy to use and update "
+"format."
 msgstr ""
 
 #: ../source/guides/installing-scientific-packages.rst:96
@@ -11901,7 +11904,8 @@ msgstr ""
 msgid ""
 "Python scripts must appear in ``scripts`` and begin with exactly ``b'#!"
 "python'`` in order to enjoy script wrapper generation and ``#!python`` "
-"rewriting at install time.  They may have any or no extension."
+"rewriting at install time.  They may have any or no extension.  The "
+"``scripts`` directory may only contain regular files."
 msgstr ""
 
 #: ../source/specifications/binary-distribution-format.rst:193
@@ -12250,6 +12254,7 @@ msgstr ""
 
 #: ../source/specifications/binary-distribution-format.rst:421
 #: ../source/specifications/core-metadata.rst:917
+#: ../source/specifications/dependency-groups.rst:248
 #: ../source/specifications/dependency-specifiers.rst:477
 #: ../source/specifications/direct-url-data-structure.rst:397
 #: ../source/specifications/direct-url.rst:67
@@ -12277,11 +12282,19 @@ msgid ""
 "bring them into line with what popular tools actually do."
 msgstr ""
 
-#: ../source/specifications/binary-distribution-format.rst:429
+#: ../source/specifications/binary-distribution-format.rst:426
+msgid ""
+"December 2024: Clarified that the ``scripts`` folder should only contain "
+"regular files (the expected behaviour of consuming tools when encountering "
+"symlinks or subdirectories in this folder is not formally defined, and hence "
+"may vary between tools)."
+msgstr ""
+
+#: ../source/specifications/binary-distribution-format.rst:433
 msgid "Appendix"
 msgstr ""
 
-#: ../source/specifications/binary-distribution-format.rst:431
+#: ../source/specifications/binary-distribution-format.rst:435
 msgid "Example urlsafe-base64-nopad implementation::"
 msgstr ""
 
@@ -13298,6 +13311,227 @@ msgstr ""
 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`"
 msgstr ""
 
+#: ../source/specifications/dependency-groups.rst:5
+msgid "Dependency Groups"
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:7
+msgid ""
+"This specification defines Dependency Groups, a mechanism for storing "
+"package requirements in ``pyproject.toml`` files such that they are not "
+"included in project metadata when it is built."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:11
+msgid ""
+"Dependency Groups are suitable for internal development use-cases like "
+"linting and testing, as well as for projects which are not built for "
+"distribution, like collections of related scripts."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:15
+msgid ""
+"Fundamentally, Dependency Groups should be thought of as being a "
+"standardized subset of the capabilities of ``requirements.txt`` files (which "
+"are ``pip``-specific)."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:20
+#: ../source/specifications/dependency-specifiers.rst:26
+#: ../source/specifications/direct-url-data-structure.rst:19
+#: ../source/specifications/direct-url.rst:15
+#: ../source/specifications/index-hosted-attestations.rst:17
+#: ../source/specifications/inline-script-metadata.rst:13
+msgid "Specification"
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:25
+msgid "This is a simple table which shows a ``test`` group::"
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:30
+msgid "and a similar table which defines ``test`` and ``coverage`` groups::"
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:37
+msgid "The ``[dependency-groups]`` Table"
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:39
+msgid ""
+"Dependency Groups are defined as a table in ``pyproject.toml`` named "
+"``dependency-groups``. The ``dependency-groups`` table contains an arbitrary "
+"number of user-defined keys, each of which has, as its value, a list of "
+"requirements."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:44
+msgid ""
+"``[dependency-groups]`` keys, sometimes also called \"group names\", must "
+"be :ref:`valid non-normalized names <name-format>`. Tools which handle "
+"Dependency Groups MUST :ref:`normalize <name-normalization>` these names "
+"before comparisons."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:49
+msgid ""
+"Tools SHOULD prefer to present the original, non-normalized name to users, "
+"and if duplicate names are detected after normalization, tools SHOULD emit "
+"an error."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:53
+msgid ""
+"Requirement lists, the values in ``[dependency-groups]``, may contain "
+"strings, tables (``dict`` in Python), or a mix of strings and tables. "
+"Strings must be valid :ref:`dependency specifiers <dependency-specifiers>`, "
+"and tables must be valid Dependency Group Includes."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:59
+msgid "Dependency Group Include"
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:61
+msgid ""
+"A Dependency Group Include includes another Dependency Group in the current "
+"group."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:64
+msgid ""
+"An include is a table with exactly one key, ``\"include-group\"``, whose "
+"value is a string, the name of another Dependency Group."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:67
+msgid ""
+"Includes are defined to be exactly equivalent to the contents of the named "
+"Dependency Group, inserted into the current group at the location of the "
+"include. For example, if ``foo = [\"a\", \"b\"]`` is one group, and ``bar = "
+"[\"c\", {include-group = \"foo\"}, \"d\"]`` is another, then ``bar`` should "
+"evaluate to ``[\"c\", \"a\", \"b\", \"d\"]`` when Dependency Group Includes "
+"are expanded."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:73
+msgid ""
+"Dependency Group Includes may specify the same package multiple times. Tools "
+"SHOULD NOT deduplicate or otherwise alter the list contents produced by the "
+"include. For example, given the following table:"
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:90
+msgid ""
+"The resolved value of ``all`` SHOULD be ``[\"foo\", \"foo\", \"foo>1.0\", "
+"\"foo<1.0\"]``. Tools should handle such a list exactly as they would handle "
+"any other case in which they are asked to process the same requirement "
+"multiple times with different version constraints."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:95
+msgid ""
+"Dependency Group Includes may include groups containing Dependency Group "
+"Includes, in which case those includes should be expanded as well. "
+"Dependency Group Includes MUST NOT include cycles, and tools SHOULD report "
+"an error if they detect a cycle."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:100
+msgid "Package Building"
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:102
+msgid ""
+"Build backends MUST NOT include Dependency Group data in built distributions "
+"as package metadata. This means that sdist ``PKG-INFO`` and wheel "
+"``METADATA`` files should not include referenceable fields containing "
+"Dependency Groups."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:106
+msgid ""
+"It is, however, valid to use Dependency Groups in the evaluation of dynamic "
+"metadata, and ``pyproject.toml`` files included in sdists will still contain "
+"``[dependency-groups]``. However, the table's contents are not part of a "
+"built package's interfaces."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:112
+msgid "Installing Dependency Groups & Extras"
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:114
+msgid ""
+"There is no syntax or specification-defined interface for installing or "
+"referring to Dependency Groups. Tools are expected to provide dedicated "
+"interfaces for this purpose."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:118
+msgid ""
+"Tools MAY choose to provide the same or similar interfaces for interacting "
+"with Dependency Groups as they do for managing extras. Tools authors are "
+"advised that the specification does not forbid having an extra whose name "
+"matches a Dependency Group. Separately, users are advised to avoid creating "
+"Dependency Groups whose names match extras, and tools MAY treat such "
+"matching as an error."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:126
+msgid "Validation and Compatibility"
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:128
+msgid ""
+"Tools supporting Dependency Groups may want to validate data before using "
+"it. When implementing such validation, authors should be aware of the "
+"possibility of future extensions to the specification, so that they do not "
+"unnecessarily emit errors or warnings."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:133
+msgid ""
+"Tools SHOULD error when evaluating or processing unrecognized data in "
+"Dependency Groups."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:136
+msgid ""
+"Tools SHOULD NOT eagerly validate the contents of *all* Dependency Groups "
+"unless they have a need to do so."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:139
+msgid ""
+"This means that in the presence of the following data, most tools should "
+"allow the ``foo`` group to be used and only error if the ``bar`` group is "
+"used:"
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:150
+msgid ""
+"There are several known cases of tools which have good cause to be stricter. "
+"Linters and validators are an example, as their purpose is to validate the "
+"contents of all Dependency Groups."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:155
+#: ../source/specifications/inline-script-metadata.rst:123
+msgid "Reference Implementation"
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:157
+msgid ""
+"The following Reference Implementation prints the contents of a Dependency "
+"Group to stdout, newline delimited. The output is therefore valid "
+"``requirements.txt`` data."
+msgstr ""
+
+#: ../source/specifications/dependency-groups.rst:250
+msgid "October 2024: This specification was approved through :pep:`735`."
+msgstr ""
+
 #: ../source/specifications/dependency-specifiers.rst:7
 msgid "Dependency specifiers"
 msgstr ""
@@ -13327,14 +13561,6 @@ msgid ""
 "we use that format rather than pip's current native format."
 msgstr ""
 
-#: ../source/specifications/dependency-specifiers.rst:26
-#: ../source/specifications/direct-url-data-structure.rst:19
-#: ../source/specifications/direct-url.rst:15
-#: ../source/specifications/index-hosted-attestations.rst:17
-#: ../source/specifications/inline-script-metadata.rst:13
-msgid "Specification"
-msgstr ""
-
 #: ../source/specifications/dependency-specifiers.rst:31
 msgid "All features of the language shown with a name based lookup::"
 msgstr ""
@@ -15526,10 +15752,6 @@ msgstr ""
 msgid "The following is an example of a script with embedded metadata:"
 msgstr ""
 
-#: ../source/specifications/inline-script-metadata.rst:123
-msgid "Reference Implementation"
-msgstr ""
-
 #: ../source/specifications/inline-script-metadata.rst:125
 msgid ""
 "The following is an example of how to read the metadata on Python 3.11 or "