Update translation files

Updated by "Update PO files to match POT (msgmerge)" hook in Weblate.

Update translation files

Updated by "Update PO files to match POT (msgmerge)" hook in Weblate.

Update translation files

Updated by "Update PO files to match POT (msgmerge)" hook in Weblate.

Co-authored-by: Hosted Weblate <[email protected]>
Translate-URL: https://hosted.weblate.org/projects/pypa/packaging-python-org/
Translation: pypa/packaging.python.org

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-08-15 14:12+0000\n"
+"POT-Creation-Date: 2024-08-24 00:21+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-"
@@ -484,6 +484,7 @@ msgid "Deploying Python applications"
 msgstr ""
 
 #: ../source/discussions/deploying-python-applications.rst:0
+#: ../source/discussions/single-source-version.rst:0
 #: ../source/guides/distributing-packages-using-setuptools.rst:0
 #: ../source/guides/index-mirrors-and-caches.rst:0
 #: ../source/guides/installing-using-linux-tools.rst:0
@@ -503,6 +504,7 @@ msgid "Incomplete"
 msgstr ""
 
 #: ../source/discussions/deploying-python-applications.rst:0
+#: ../source/discussions/single-source-version.rst:0
 #: ../source/guides/distributing-packages-using-setuptools.rst:0
 #: ../source/guides/index-mirrors-and-caches.rst:0
 #: ../source/guides/installing-using-linux-tools.rst:0
@@ -1677,6 +1679,119 @@ msgstr ""
 msgid ":doc:`setuptools:deprecated/commands`"
 msgstr ""
 
+#: ../source/discussions/single-source-version.rst:5
+msgid "Single-sourcing the Project Version"
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:7
+msgid "Complete"
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:8
+msgid "2024-08-24"
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:10
+msgid ""
+"One of the challenges in building packages is that the version string can be "
+"required in multiple places."
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:13
+msgid ""
+"It needs to be specified when building the package (e.g. in :file:`pyproject."
+"toml`)"
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:13
+msgid ""
+"This will make it available in the installed package’s metadata, from where "
+"it will be accessible at runtime using ``importlib.metadata."
+"version(\"distribution_name\")``."
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:15
+msgid ""
+"A package may set a module attribute (e.g., ``__version__``) to provide an "
+"alternative means of runtime access to the version of the imported package. "
+"If this is done, the value of the attribute and that used by the build "
+"system to set the distribution's version should be kept in sync in :ref:`the "
+"build systems's recommended way <Build system version handling>`."
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:17
+msgid ""
+"If the code is in in a version control system (VCS), e.g. Git, the version "
+"may appear in a *tag* such as ``v1.2.3``."
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:19
+msgid ""
+"To ensure that version numbers do not get out of sync, it is recommended "
+"that there is a single source of truth for the version number."
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:21
+msgid "In general, the options are:"
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:23
+msgid ""
+"If the code is in a version control system (VCS), e.g. Git, then the version "
+"can be extracted from the VCS."
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:25
+msgid ""
+"The version can be hard-coded into the :file:`pyproject.toml` file -- and "
+"the build system can copy it into other locations it may be required."
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:27
+msgid ""
+"The version string can be hard-coded into the source code -- either in a "
+"special purpose file, such as :file:`_version.txt`, or as a attribute in a "
+"module, such as :file:`__init__.py`, and the build system can extract it at "
+"build time."
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:30
+msgid "Consult your build system's documentation for their recommended method."
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:35
+msgid "Build System Version Handling"
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:37
+msgid ""
+"The following are links to some build system's documentation for handling "
+"version strings."
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:39
+msgid "`Flit <https://flit.pypa.io/en/stable/>`_"
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:41
+msgid "`Hatchling <https://hatch.pypa.io/1.9/version/>`_"
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:43
+msgid ""
+"`PDM <https://pdm-project.org/en/latest/reference/pep621/#__tabbed_1_2>`_"
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:45
+msgid ""
+"`Setuptools <https://setuptools.pypa.io/en/latest/userguide/pyproject_config."
+"html#dynamic-metadata>`_"
+msgstr ""
+
+#: ../source/discussions/single-source-version.rst:47
+msgid "`setuptools_scm <https://setuptools-scm.readthedocs.io/en/latest/>`_"
+msgstr ""
+
 #: ../source/discussions/src-layout-vs-flat-layout.rst:5
 msgid "src layout vs flat layout"
 msgstr ""
@@ -6872,6 +6987,25 @@ msgid ""
 "cpp_extension_modules.html>`_"
 msgstr ""
 
+#: ../source/guides/packaging-binary-extensions.rst:408
+msgid "Additional considerations for binary wheels"
+msgstr ""
+
+#: ../source/guides/packaging-binary-extensions.rst:410
+msgid ""
+"The `pypackaging-native <https://pypackaging-native.github.io/>`_ website "
+"has additional coverage of packaging Python packages with native code. It "
+"aims to provide an overview of the most important packaging issues for such "
+"projects, with in-depth explanations and references."
+msgstr ""
+
+#: ../source/guides/packaging-binary-extensions.rst:415
+msgid ""
+"Examples of topics covered are non-Python compiled dependencies (\"native "
+"dependencies\"), the importance of the ABI (Application Binary Interface) of "
+"native code, dependency on SIMD code and cross compilation."
+msgstr ""
+
 #: ../source/guides/packaging-namespace-packages.rst:5
 msgid "Packaging namespace packages"
 msgstr ""
@@ -8451,25 +8585,27 @@ msgstr ""
 
 #: ../source/guides/writing-pyproject-toml.rst:25
 msgid ""
-"There is a significant difference between the ``[build-system]`` and "
-"``[project]`` tables. The former should always be present, regardless of "
-"which build backend you use (since it *defines* the tool you use). The "
-"latter is understood by *most* build backends, but some build backends use a "
-"different format."
+"The ``[build-system]`` table should always be present, regardless of which "
+"build backend you use (``[build-system]`` *defines* the build tool you use)."
+msgstr ""
+
+#: ../source/guides/writing-pyproject-toml.rst:29
+msgid ""
+"On the other hand, the ``[project]`` table is understood by *most* build "
+"backends, but some build backends use a different format."
 msgstr ""
 
-#: ../source/guides/writing-pyproject-toml.rst:31
+#: ../source/guides/writing-pyproject-toml.rst:32
 msgid ""
-"At the time of writing this (November 2023), Poetry_ is a notable build "
-"backend that does not use the ``[project]`` table (it uses the ``[tool."
-"poetry]`` table instead)."
+"As of August 2024, Poetry_ is a notable build backend that does not use the "
+"``[project]`` table, it uses the ``[tool.poetry]`` table instead. Also, the "
+"setuptools_ build backend supports both the ``[project]`` table, and the "
+"older format in ``setup.cfg`` or ``setup.py``."
 msgstr ""
 
-#: ../source/guides/writing-pyproject-toml.rst:35
+#: ../source/guides/writing-pyproject-toml.rst:37
 msgid ""
-"Also, the setuptools_ build backend supports both the ``[project]`` table, "
-"and the older format in ``setup.cfg`` or ``setup.py``. For new projects, it "
-"is recommended to use the ``[project]`` table, and keep ``setup.py`` only if "
+"For new projects, use the ``[project]`` table, and keep ``setup.py`` only if "
 "some programmatic configuration is needed (such as building C extensions), "
 "but the ``setup.cfg`` and ``setup.py`` formats are still valid. See :ref:"
 "`setup-py-deprecated`."
@@ -8544,7 +8680,7 @@ msgstr ""
 
 #: ../source/guides/writing-pyproject-toml.rst:133
 msgid ""
-"The project name must consists of ASCII letters, digits, underscores "
+"The project name must consist of ASCII letters, digits, underscores "
 "\"``_``\", hyphens \"``-``\" and periods \"``.``\". It must not start or end "
 "with an underscore, hyphen or period."
 msgstr ""