From 4788569119c0c8476650b98c21d08075722ff963 Mon Sep 17 00:00:00 2001 From: Hosted Weblate Date: Fri, 10 May 2024 08:58:28 +0200 Subject: [PATCH] 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 Translate-URL: https://hosted.weblate.org/projects/pypa/packaging-python-org/ Translation: pypa/packaging.python.org --- locales/ar/LC_MESSAGES/messages.po | 330 ++++++++++----- locales/ars/LC_MESSAGES/messages.po | 330 ++++++++++----- locales/de/LC_MESSAGES/messages.po | 342 +++++++++++----- locales/eo/LC_MESSAGES/messages.po | 349 +++++++++++----- locales/es/LC_MESSAGES/messages.po | 351 +++++++++++----- locales/fa/LC_MESSAGES/messages.po | 332 ++++++++++----- locales/fil/LC_MESSAGES/messages.po | 330 ++++++++++----- locales/fr/LC_MESSAGES/messages.po | 351 +++++++++++----- locales/frc/LC_MESSAGES/messages.po | 330 ++++++++++----- locales/gl/LC_MESSAGES/messages.po | 330 ++++++++++----- locales/hi/LC_MESSAGES/messages.po | 343 +++++++++++----- locales/id/LC_MESSAGES/messages.po | 332 ++++++++++----- locales/ko/LC_MESSAGES/messages.po | 340 +++++++++++----- locales/lzh/LC_MESSAGES/messages.po | 330 ++++++++++----- locales/mk/LC_MESSAGES/messages.po | 332 ++++++++++----- locales/pl/LC_MESSAGES/messages.po | 330 ++++++++++----- locales/pt_BR/LC_MESSAGES/messages.po | 518 ++++++++++++++++-------- locales/ro/LC_MESSAGES/messages.po | 332 ++++++++++----- locales/ru/LC_MESSAGES/messages.po | 369 ++++++++++++----- locales/sai/LC_MESSAGES/messages.po | 330 ++++++++++----- locales/si/LC_MESSAGES/messages.po | 330 ++++++++++----- locales/sk/LC_MESSAGES/messages.po | 349 +++++++++++----- locales/uk/LC_MESSAGES/messages.po | 349 +++++++++++----- locales/zh_Hans/LC_MESSAGES/messages.po | 349 +++++++++++----- locales/zh_Hant/LC_MESSAGES/messages.po | 342 +++++++++++----- 25 files changed, 6144 insertions(+), 2506 deletions(-) diff --git a/locales/ar/LC_MESSAGES/messages.po b/locales/ar/LC_MESSAGES/messages.po index c71213e52..332e6534c 100644 --- a/locales/ar/LC_MESSAGES/messages.po +++ b/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-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2024-01-18 07:31+0000\n" "Last-Translator: Youcef Guenaoua \n" "Language-Team: Arabic ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2380,21 +2425,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2403,11 +2448,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2416,17 +2461,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2435,50 +2480,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2487,7 +2543,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2495,7 +2551,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2503,21 +2559,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2527,48 +2651,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2576,11 +2700,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2589,11 +2713,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2601,72 +2725,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2675,11 +2799,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2687,21 +2811,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11802,7 +11942,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12808,7 +12948,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14557,24 +14697,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14585,7 +14725,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14595,156 +14735,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/ars/LC_MESSAGES/messages.po b/locales/ars/LC_MESSAGES/messages.po index 71ad8243b..2bd4ffdd3 100644 --- a/locales/ars/LC_MESSAGES/messages.po +++ b/locales/ars/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -2352,18 +2352,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2375,21 +2420,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2398,11 +2443,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2411,17 +2456,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2430,50 +2475,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2482,7 +2538,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2490,7 +2546,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2498,21 +2554,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2522,48 +2646,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2571,11 +2695,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2584,11 +2708,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2596,72 +2720,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2670,11 +2794,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2682,21 +2806,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11797,7 +11937,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12803,7 +12943,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14552,24 +14692,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14580,7 +14720,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14590,156 +14730,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/de/LC_MESSAGES/messages.po b/locales/de/LC_MESSAGES/messages.po index 6f5d6a300..60144483a 100644 --- a/locales/de/LC_MESSAGES/messages.po +++ b/locales/de/LC_MESSAGES/messages.po @@ -11,11 +11,11 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2024-04-22 14:28+0000\n" "Last-Translator: Pixel-Master \n" -"Language-Team: German \n" +"Language-Team: German \n" "Language: de\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -129,8 +129,8 @@ msgstr "" "können ein gewisses Vorwissen annehmen. Sie sind ähnlich wie Tutorials, " "haben aber einen engen und klaren Fokus. Leitfäden können zusätzliche " "weiterführende Informationen bereitstellen, sofern diese benötigt werden. " -"Sie können auch mehrere Ansätze erläutern, um das gleiche Problem zu lösen. " -":doc:`example guide-style document `." +"Sie können auch mehrere Ansätze erläutern, um das gleiche Problem zu lösen. :" +"doc:`example guide-style document `." #: ../source/contribute.rst:60 ../source/discussions/index.rst:2 msgid "Discussions" @@ -2396,11 +2396,57 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 +msgid "Built Metadata" +msgstr "" + +#: ../source/glossary.rst:59 +msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +msgid "Distribution Archive" +msgstr "Distributionspaket" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 #, fuzzy msgid "Distribution Package" msgstr "Distributionspaket" -#: ../source/glossary.rst:59 +#: ../source/glossary.rst:92 msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " @@ -2408,7 +2454,7 @@ msgid "" "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2420,21 +2466,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Ei" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "Erweiterungsmodul" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2443,11 +2489,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2456,17 +2502,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "Paket importieren" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2475,50 +2521,62 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +msgid "Installed Project" +msgstr "Betreuer" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Modul" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "Paketindex" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "Pro Projekt Index" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2527,7 +2585,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2535,7 +2593,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2543,21 +2601,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Pures Modul" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2567,48 +2693,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2616,11 +2742,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2629,11 +2755,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2641,72 +2767,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "Quellenarchiv" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2715,11 +2841,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2727,22 +2853,40 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 #, fuzzy msgid "Wheel" msgstr "Wheel" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Per Project Index" +msgid "Wheel Project" +msgstr "Pro Projekt Index" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11853,7 +11997,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12859,7 +13003,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14612,24 +14756,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14640,7 +14784,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14650,158 +14794,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "Dokumentationstypen" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/eo/LC_MESSAGES/messages.po b/locales/eo/LC_MESSAGES/messages.po index 16396e41f..dfc2f3884 100644 --- a/locales/eo/LC_MESSAGES/messages.po +++ b/locales/eo/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-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2021-08-06 05:45+0000\n" "Last-Translator: meowmeowmeowcat \n" "Language-Team: Esperanto ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +#, fuzzy +#| msgid "Configuring metadata" +msgid "Core Metadata" +msgstr "Agordi metadatenojn" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Source Distributions vs Wheels" +msgid "Distribution Archive" +msgstr "Fonto-Distribuoj kontraste kun Wheel-oj" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2449,21 +2498,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Egg" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2472,11 +2521,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2485,17 +2534,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2504,50 +2553,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "Instalilo" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Modulo" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Projekto" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2556,7 +2618,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2564,7 +2626,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2572,21 +2634,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "Nomo de projekto" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Pura Modulo" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "Nomo de projekto" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "pyproject.toml" +msgid "Pyproject Metadata Key" +msgstr "pyproject.toml" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2596,48 +2732,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "pypi.org" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "pyproject.toml" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2645,11 +2781,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2658,11 +2794,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2670,72 +2806,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "setup.py" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "setup.cfg" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "Versio-Specifilo" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2744,11 +2880,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2756,21 +2892,39 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "Wheel" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Projekto" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -12141,7 +12295,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -13152,7 +13306,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Specifado" @@ -14928,26 +15082,26 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 #, fuzzy #| msgid "Configuring metadata" msgid "Inline script metadata" msgstr "Agordi metadatenojn" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14958,7 +15112,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14968,161 +15122,161 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 #, fuzzy msgid "Example" msgstr "Ekzemploj" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "Tipoj de dokumentaro" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 #, fuzzy #| msgid "Creating pyproject.toml" msgid "Recommendations" msgstr "Krei la dosieron pyproject.toml" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21514,11 +21668,6 @@ msgstr "" #~ msgid "Wheel vs Egg" #~ msgstr "Wheel kontraste kun Egg" -#, fuzzy -#~| msgid "pyproject.toml" -#~ msgid "pyproject type" -#~ msgstr "pyproject.toml" - #, fuzzy #~ msgid "``url``" #~ msgstr "``urls``" diff --git a/locales/es/LC_MESSAGES/messages.po b/locales/es/LC_MESSAGES/messages.po index 9c20ae02f..010a4da54 100644 --- a/locales/es/LC_MESSAGES/messages.po +++ b/locales/es/LC_MESSAGES/messages.po @@ -15,11 +15,11 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2024-04-21 15:31+0000\n" "Last-Translator: Diego Ramirez \n" -"Language-Team: Spanish \n" +"Language-Team: Spanish \n" "Language: es\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -2571,10 +2571,59 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 +msgid "Built Metadata" +msgstr "" + +#: ../source/glossary.rst:59 +msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +#, fuzzy +#| msgid "Configuring metadata" +msgid "Core Metadata" +msgstr "Configuración de los metadatos" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Distribution Package" +msgid "Distribution Archive" +msgstr "Paquete de Distribución" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 msgid "Distribution Package" msgstr "Paquete de Distribución" -#: ../source/glossary.rst:59 +#: ../source/glossary.rst:92 msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " @@ -2582,7 +2631,7 @@ msgid "" "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2594,21 +2643,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2617,11 +2666,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2630,17 +2679,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2649,50 +2698,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "Instalador" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Módulo" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "Índice de paquetes" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "Índice por proyecto" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Proyecto" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2701,7 +2763,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2709,7 +2771,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2717,21 +2779,92 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +msgid "Project Root Directory" +msgstr "Nombre de proyecto" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +msgid "Pyproject Metadata" +msgstr "Nombre de proyecto" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +msgid "Pyproject Metadata Key" +msgstr "Nombre de proyecto" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2741,48 +2874,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2790,11 +2923,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2803,11 +2936,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2815,62 +2948,62 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "Archivo de requisitos" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "Archivo Fuente" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "Paquete de sistema" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." @@ -2878,11 +3011,11 @@ msgstr "" "Un paquete provisto en un formato nativo del sistema operativo, por ejemplo, " "un archivo de RPM o de APT." -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2891,11 +3024,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "Entorno virtual" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2903,21 +3036,41 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +#, fuzzy +#| msgid "File format" +msgid "Wheel Format" +msgstr "Formato de archivo" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Proyecto" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -12087,7 +12240,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -13094,7 +13247,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Especificación" @@ -14858,25 +15011,25 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 #, fuzzy msgid "Inline script metadata" msgstr "Configuración de los metadatos" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14887,7 +15040,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14897,159 +15050,159 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 #, fuzzy msgid "Example" msgstr "Ejemplos" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy msgid "Reference Implementation" msgstr "Tipos de documentación" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 #, fuzzy msgid "Recommendations" msgstr "Recomendaciones de herramientas" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21432,10 +21585,6 @@ msgid "" "the file is empty)." msgstr "" -#, fuzzy -#~ msgid "pyproject type" -#~ msgstr "Nombre de proyecto" - #~ msgid "Give a short and long description for your project." #~ msgstr "Brinde una descripción breve y una larga del proyecto." diff --git a/locales/fa/LC_MESSAGES/messages.po b/locales/fa/LC_MESSAGES/messages.po index 77aec48f8..433b01715 100644 --- a/locales/fa/LC_MESSAGES/messages.po +++ b/locales/fa/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-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2023-02-15 07:52+0000\n" "Last-Translator: Arsalan Dehghani \n" "Language-Team: Persian ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2382,21 +2427,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2405,11 +2450,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2418,17 +2463,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2437,50 +2482,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Translations" +msgid "Installed Project" +msgstr "ترجمه‌ها" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2489,7 +2547,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2497,7 +2555,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2505,21 +2563,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "ماژول خالص" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2529,48 +2655,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2578,11 +2704,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2591,11 +2717,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2603,72 +2729,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2677,11 +2803,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2689,21 +2815,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11812,7 +11954,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12818,7 +12960,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14568,24 +14710,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14596,7 +14738,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14606,156 +14748,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/fil/LC_MESSAGES/messages.po b/locales/fil/LC_MESSAGES/messages.po index dfd6beb8a..3fdbff50b 100644 --- a/locales/fil/LC_MESSAGES/messages.po +++ b/locales/fil/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-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2022-11-19 08:28+0000\n" "Last-Translator: RedFurrFox \n" "Language-Team: Filipino ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2381,21 +2426,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2404,11 +2449,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2417,17 +2462,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2436,50 +2481,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2488,7 +2544,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2496,7 +2552,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2504,21 +2560,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2528,48 +2652,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2577,11 +2701,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2590,11 +2714,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2602,72 +2726,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2676,11 +2800,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2688,21 +2812,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11803,7 +11943,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12809,7 +12949,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14558,24 +14698,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14586,7 +14726,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14596,156 +14736,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/fr/LC_MESSAGES/messages.po b/locales/fr/LC_MESSAGES/messages.po index 010e6bd5b..12caa7bf2 100644 --- a/locales/fr/LC_MESSAGES/messages.po +++ b/locales/fr/LC_MESSAGES/messages.po @@ -9,11 +9,11 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2024-04-25 06:07+0000\n" "Last-Translator: Rafael Fontenelle \n" -"Language-Team: French \n" +"Language-Team: French \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -2541,18 +2541,65 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Built Distribution" +msgid "Distribution Archive" +msgstr "Distribution compilée" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2564,21 +2611,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Egg" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "Module d'extension" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2587,11 +2634,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2600,17 +2647,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2619,50 +2666,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "Installateur" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Module" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Projet" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2671,7 +2731,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2679,7 +2739,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2687,21 +2747,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "Nom du projet" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Module pur" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "Nom du projet" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "pyproject.toml" +msgid "Pyproject Metadata Key" +msgstr "pyproject.toml" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2711,11 +2845,11 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "Index des Paquets Python (PyPI)" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " @@ -2725,31 +2859,31 @@ msgstr "" "par défaut pour la communauté Python. Il est ouvert à tous les développeurs " "Python pour qu'ils utilisent et distribuent leurs paquets." -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "pypi.org" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "pyproject.toml" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "Version" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." @@ -2757,7 +2891,7 @@ msgstr "" "Une image d'un :term:`Projet` à un certain moment dans le temps, défini par " "un numéro de version." -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2765,11 +2899,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2778,11 +2912,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2790,62 +2924,62 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "setup.py" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "setup.cfg" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "Paquet système" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." @@ -2853,11 +2987,11 @@ msgstr "" "Un paquet fourni dans un format natif au système d'exploitation, par ex. un " "fichier rpm ou dpkg." -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2866,11 +3000,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "Environnement virtuel" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2878,21 +3012,39 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "Wheel" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Projet" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -12074,7 +12226,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -13080,7 +13232,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Spécification" @@ -14845,24 +14997,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14873,7 +15025,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14883,159 +15035,159 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 #, fuzzy msgid "Example" msgstr "Exemples" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "Types de documentation" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21415,11 +21567,6 @@ msgstr "" #~ msgid "Wheel vs Egg" #~ msgstr "Wheel vs Egg" -#, fuzzy -#~| msgid "pyproject.toml" -#~ msgid "pyproject type" -#~ msgstr "pyproject.toml" - #~ msgid "Give a short and long description for your project." #~ msgstr "Renseignez une description courte et longue pour votre projet." diff --git a/locales/frc/LC_MESSAGES/messages.po b/locales/frc/LC_MESSAGES/messages.po index 61d7558dc..3111a3570 100644 --- a/locales/frc/LC_MESSAGES/messages.po +++ b/locales/frc/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -2352,18 +2352,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2375,21 +2420,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2398,11 +2443,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2411,17 +2456,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2430,50 +2475,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2482,7 +2538,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2490,7 +2546,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2498,21 +2554,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2522,48 +2646,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2571,11 +2695,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2584,11 +2708,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2596,72 +2720,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2670,11 +2794,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2682,21 +2806,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11797,7 +11937,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12803,7 +12943,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14552,24 +14692,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14580,7 +14720,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14590,156 +14730,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/gl/LC_MESSAGES/messages.po b/locales/gl/LC_MESSAGES/messages.po index a86169162..674e75f8e 100644 --- a/locales/gl/LC_MESSAGES/messages.po +++ b/locales/gl/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -2352,18 +2352,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2375,21 +2420,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2398,11 +2443,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2411,17 +2456,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2430,50 +2475,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2482,7 +2538,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2490,7 +2546,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2498,21 +2554,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2522,48 +2646,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2571,11 +2695,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2584,11 +2708,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2596,72 +2720,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2670,11 +2794,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2682,21 +2806,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11797,7 +11937,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12803,7 +12943,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14552,24 +14692,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14580,7 +14720,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14590,156 +14730,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/hi/LC_MESSAGES/messages.po b/locales/hi/LC_MESSAGES/messages.po index 912e2ab7a..beb27b879 100644 --- a/locales/hi/LC_MESSAGES/messages.po +++ b/locales/hi/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2022-09-29 05:18+0000\n" "Last-Translator: Aryan 'Ba3a' Kumar \n" "Language-Team: Hindi ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2385,21 +2430,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2408,11 +2453,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2421,17 +2466,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2440,50 +2485,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installing packages" +msgid "Installed Project" +msgstr "पैकेज प्रतिष्ठापन" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2492,7 +2550,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2500,7 +2558,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2508,21 +2566,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "परियोजना" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "परियोजना" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata Key" +msgstr "परियोजना" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2532,48 +2664,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2581,11 +2713,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2594,11 +2726,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2606,72 +2738,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2680,11 +2812,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2692,21 +2824,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11827,7 +11975,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12833,7 +12981,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14587,24 +14735,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14615,7 +14763,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14625,156 +14773,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21112,8 +21260,3 @@ msgid "" "recommended to stick with *regular packages* and ``__init__.py`` (even if " "the file is empty)." msgstr "" - -#, fuzzy -#~| msgid "Project name" -#~ msgid "pyproject type" -#~ msgstr "परियोजना" diff --git a/locales/id/LC_MESSAGES/messages.po b/locales/id/LC_MESSAGES/messages.po index 7ada5e371..1584d4be4 100644 --- a/locales/id/LC_MESSAGES/messages.po +++ b/locales/id/LC_MESSAGES/messages.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2024-01-27 05:01+0000\n" "Last-Translator: Rafael Fontenelle \n" "Language-Team: Indonesian ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2415,21 +2460,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2438,11 +2483,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2451,17 +2496,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2470,50 +2515,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Translations" +msgid "Installed Project" +msgstr "Penerjemahan" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2522,7 +2580,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2530,7 +2588,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2538,21 +2596,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2562,48 +2688,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2611,11 +2737,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2624,11 +2750,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2636,72 +2762,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2710,11 +2836,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2722,21 +2848,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11845,7 +11987,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12851,7 +12993,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Spesifikasi" @@ -14603,24 +14745,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14631,7 +14773,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14641,158 +14783,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "Jenis-jenis dokumentasi" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/ko/LC_MESSAGES/messages.po b/locales/ko/LC_MESSAGES/messages.po index a9e46f17b..61fdbd4ff 100644 --- a/locales/ko/LC_MESSAGES/messages.po +++ b/locales/ko/LC_MESSAGES/messages.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2024-03-21 03:01+0000\n" "Last-Translator: emscb \n" "Language-Team: Korean ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2433,21 +2478,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2456,11 +2501,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2469,18 +2514,18 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 #, fuzzy msgid "Import Package" msgstr "패키지 가져오기" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2489,52 +2534,65 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Translations" +msgid "Installed Project" +msgstr "번역" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "모듈" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 #, fuzzy msgid "Package Index" msgstr "패키지 인덱스" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 #, fuzzy msgid "Per Project Index" msgstr "프로젝트별 인덱스" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "프로젝트" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2543,7 +2601,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2551,7 +2609,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2559,21 +2617,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "프로젝트 이름" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "프로젝트 이름" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata Key" +msgstr "프로젝트 이름" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2583,48 +2715,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2632,11 +2764,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2645,12 +2777,12 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 #, fuzzy msgid "Requirement Specifier" msgstr "요구 사항 지정자" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2658,72 +2790,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2732,11 +2864,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2744,21 +2876,39 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "프로젝트" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11871,7 +12021,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12877,7 +13027,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14630,24 +14780,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14658,7 +14808,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14668,158 +14818,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "문서 유형" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/lzh/LC_MESSAGES/messages.po b/locales/lzh/LC_MESSAGES/messages.po index 312300bd8..84a069ad4 100644 --- a/locales/lzh/LC_MESSAGES/messages.po +++ b/locales/lzh/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-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2024-01-31 06:01+0000\n" "Last-Translator: maker \n" "Language-Team: Chinese (Literary) ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2379,21 +2424,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2402,11 +2447,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2415,17 +2460,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2434,50 +2479,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2486,7 +2542,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2494,7 +2550,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2502,21 +2558,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2526,48 +2650,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2575,11 +2699,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2588,11 +2712,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2600,72 +2724,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "源码" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "版本指定器" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2674,11 +2798,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2686,21 +2810,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11801,7 +11941,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12807,7 +12947,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14556,24 +14696,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14584,7 +14724,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14594,156 +14734,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/mk/LC_MESSAGES/messages.po b/locales/mk/LC_MESSAGES/messages.po index 49b7e45e5..ee2a34783 100644 --- a/locales/mk/LC_MESSAGES/messages.po +++ b/locales/mk/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-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2023-10-21 04:04+0000\n" "Last-Translator: \"Kristijan \\\"Fremen\\\" Velkovski\" \n" "Language-Team: Macedonian ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Binary Distribution" +msgid "Distribution Archive" +msgstr "Бинарна Дистрибуција" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2381,21 +2428,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Jajce(Egg)" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2404,11 +2451,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2417,17 +2464,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2436,50 +2483,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2488,7 +2546,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2496,7 +2554,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2504,21 +2562,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2528,48 +2654,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2577,11 +2703,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2590,11 +2716,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2602,72 +2728,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2676,11 +2802,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2688,21 +2814,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11805,7 +11947,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12811,7 +12953,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14560,24 +14702,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14588,7 +14730,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14598,156 +14740,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/pl/LC_MESSAGES/messages.po b/locales/pl/LC_MESSAGES/messages.po index 8eab61d9f..a1496b900 100644 --- a/locales/pl/LC_MESSAGES/messages.po +++ b/locales/pl/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -2352,18 +2352,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2375,21 +2420,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2398,11 +2443,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2411,17 +2456,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2430,50 +2475,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2482,7 +2538,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2490,7 +2546,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2498,21 +2554,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2522,48 +2646,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2571,11 +2695,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2584,11 +2708,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2596,72 +2720,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2670,11 +2794,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2682,21 +2806,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11797,7 +11937,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12803,7 +12943,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14552,24 +14692,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14580,7 +14720,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14590,156 +14730,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/pt_BR/LC_MESSAGES/messages.po b/locales/pt_BR/LC_MESSAGES/messages.po index 33c3454f4..6cdc473a1 100644 --- a/locales/pt_BR/LC_MESSAGES/messages.po +++ b/locales/pt_BR/LC_MESSAGES/messages.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2024-04-25 06:07+0000\n" "Last-Translator: Rafael Fontenelle \n" "Language-Team: Portuguese (Brazil) `." msgstr "" -"Se você quiser detalhes técnicos sobre o formato sdist, leia a :ref:`" -"especificação de sdist `." +"Se você quiser detalhes técnicos sobre o formato sdist, leia a :ref:" +"`especificação de sdist `." #: ../source/discussions/package-formats.rst:55 msgid "What is a wheel?" @@ -1278,11 +1278,11 @@ msgid "" "files) but compiled, executable code (like ``.so`` files on Linux or DLLs on " "Windows)." msgstr "" -"Há uma grande diferença entre sdists e wheels para pacotes com :term:`" -"módulos de extensão `, escritos em linguagens compiladas " -"como C, C++ e Rust, que precisam ser compilados em código de máquina " -"dependente de plataforma. Com esses pacotes, as rodas não contêm código " -"fonte (como arquivos fonte C), mas código executável compilado (como " +"Há uma grande diferença entre sdists e wheels para pacotes com :term:" +"`módulos de extensão `, escritos em linguagens " +"compiladas como C, C++ e Rust, que precisam ser compilados em código de " +"máquina dependente de plataforma. Com esses pacotes, as rodas não contêm " +"código fonte (como arquivos fonte C), mas código executável compilado (como " "arquivos ``.so`` no Linux ou DLLs no Windows)." #: ../source/discussions/package-formats.rst:66 @@ -1364,8 +1364,8 @@ msgstr "" "para projetos \"simples e básicos\" de Python puro. Tenha em mente que " "devido à flexibilidade dos sdists, instaladores como o pip não podem " "instalar diretamente a partir dos sdists -- eles precisam primeiro construir " -"um wheel, invocando o :term:`backend de construção` que o sdist especifica (" -"o backend de construção pode fazer todo tipo de transformações durante a " +"um wheel, invocando o :term:`backend de construção` que o sdist especifica " +"(o backend de construção pode fazer todo tipo de transformações durante a " "construção do wheel, como compilar extensões C). Por esse motivo, mesmo para " "um projeto Python puro, você deve sempre enviar *ambos* sdist e wheel para o " "PyPI ou outros índices de pacotes. Isso torna a instalação muito mais rápida " @@ -1413,11 +1413,10 @@ msgid "" "any.whl`` means that:" msgstr "" "O nome do arquivo de um wheel (ignorando alguns recursos raramente usados) é " -"assim: " -":samp:`{nome_do_pacote}-{versão}-{tag_python}-{tag_abi}-{tag_plataforma}.whl`" -". Esta convenção de nomenclatura identifica com quais plataformas e versões " -"do Python a roda é compatível. Por exemplo, o nome ``pip-23.3.1-py3-none-any." -"whl`` significa que:" +"assim: :samp:`{nome_do_pacote}-{versão}-{tag_python}-{tag_abi}-" +"{tag_plataforma}.whl`. Esta convenção de nomenclatura identifica com quais " +"plataformas e versões do Python a roda é compatível. Por exemplo, o nome " +"``pip-23.3.1-py3-none-any.whl`` significa que:" #: ../source/discussions/package-formats.rst:121 msgid "" @@ -1450,8 +1449,8 @@ msgid "" "All technical details on the wheel format can be found in the :ref:`wheel " "specification `." msgstr "" -"Todos os detalhes técnicos sobre o formato do wheel podem ser encontrados na " -":ref:`especificação de wheels `." +"Todos os detalhes técnicos sobre o formato do wheel podem ser encontrados " +"na :ref:`especificação de wheels `." #: ../source/discussions/package-formats.rst:138 msgid "What about eggs?" @@ -1510,8 +1509,8 @@ msgstr "" "Os arquivos wheel não incluem arquivos ``.pyc``. Portanto, quando a " "distribuição contém apenas arquivos Python (ou seja, sem extensões " "compiladas) e é compatível com Python 2 e 3, é possível que um wheel seja " -"\"universal\", semelhante a um :term:`sdist `." +"\"universal\", semelhante a um :term:`sdist `." #: ../source/discussions/package-formats.rst:161 msgid "" @@ -1546,8 +1545,8 @@ msgid "" "org/2/library/sysconfig.html#installation-paths>`_, therefore making it " "easier to convert to other formats." msgstr "" -"Wheel é internamente organizado pelo `tipo de caminho sysconfig `_, portanto " +"Wheel é internamente organizado pelo `tipo de caminho sysconfig `_, portanto " "tornando mais fácil converter para outros formatos." #: ../source/discussions/package-formats.rst:177 @@ -2366,8 +2365,8 @@ msgid "" "A post-release of an alpha release (possible, but discouraged): ``1.2.0a1." "post1``" msgstr "" -"Um pós-lançamento de uma versão alfa (possível, mas desencorajado): ``1.2.0a1" -".post1``" +"Um pós-lançamento de uma versão alfa (possível, mas desencorajado): " +"``1.2.0a1.post1``" #: ../source/discussions/versioning.rst:28 msgid "A simple version with only two components: ``23.12``" @@ -2395,8 +2394,8 @@ msgstr "" "versões alfa, versões beta, candidatos a lançamento, versão final. Pip e " "outros instaladores modernos de pacotes Python ignoram pré-lançamentos por " "padrão ao decidir quais versões de dependências instalar, a menos que " -"solicitado explicitamente (por exemplo, com ```pip install pkg==1.1a3`` ou ``" -"pip install --pre pkg``)." +"solicitado explicitamente (por exemplo, com ```pip install pkg==1.1a3`` ou " +"``pip install --pre pkg``)." #: ../source/discussions/versioning.rst:39 msgid "" @@ -2552,8 +2551,8 @@ msgstr "" "abordagem permite que os usuários façam uso de :ref:`especificadores de " "versão de lançamento compatíveis `, " "com o operador ``~=``. Por exemplo, ``name ~= X.Y`` é aproximadamente " -"equivalente a ``name >= X.Y, == X.*``, ou seja, requer pelo menos a versão " -"X.Y, e permite qualquer versão posterior com Y maior, desde que X é o mesmo. " +"equivalente a ``name >= X.Y, == X.*``, ou seja, requer pelo menos a versão X." +"Y, e permite qualquer versão posterior com Y maior, desde que X é o mesmo. " "Da mesma forma, ``name ~= X.Y.Z`` é aproximadamente equivalente a ``name >= " "X.Y.Z, == X.Y.*``, ou seja, requer pelo menos X.Y.Z e permite uma versão " "posterior com o mesmo X e Y, mas Z superior." @@ -2563,8 +2562,8 @@ msgid "" "Python projects adopting semantic versioning should abide by clauses 1-8 of " "the `Semantic Versioning 2.0.0 specification `_." msgstr "" -"Projetos Python que adotam versões semânticas devem obedecer às cláusulas 1-" -"8 da `especificação de Versionamento Semântico 2.0.0 `_." +"Projetos Python que adotam versões semânticas devem obedecer às cláusulas " +"1-8 da `especificação de Versionamento Semântico 2.0.0 `_." #: ../source/discussions/versioning.rst:115 msgid "" @@ -2577,8 +2576,8 @@ msgid "" "`)." msgstr "" "O popular gerador de documentação :doc:`Sphinx ` é um exemplo " -"de projeto que usa controle de versionamento semântico estrito (:doc:`" -"Política de versionamento do Sphinx `). O " +"de projeto que usa controle de versionamento semântico estrito (:doc:" +"`Política de versionamento do Sphinx `). O " "famoso pacote de computação científica :doc:`NumPy ` usa " "explicitamente versionamento semântico \"folgado\", onde lançamentos " "incrementando a versão menor podem conter alterações de API incompatíveis " @@ -2616,8 +2615,8 @@ msgid "" "Calendar version numbers typically take the form *year.month* (for example, " "23.12 for December 2023)." msgstr "" -"Os números de versão do calendário normalmente assumem o formato *ano.mês* (" -"por exemplo, 23.12 para dezembro de 2023)." +"Os números de versão do calendário normalmente assumem o formato *ano.mês* " +"(por exemplo, 23.12 para dezembro de 2023)." #: ../source/discussions/versioning.rst:137 msgid "" @@ -2675,8 +2674,8 @@ msgid "" msgstr "" "Identificadores de versão pública são projetados para suportar distribuição " "via :term:`PyPI `. As ferramentas de " -"empacotamento do Python também oferecem suporte à noção de um :ref:`" -"identificador de versão local `, que pode ser " +"empacotamento do Python também oferecem suporte à noção de um :ref:" +"`identificador de versão local `, que pode ser " "usado para identificar compilações de desenvolvimento local não destinadas à " "publicação, ou variantes modificadas de uma versão mantida por um " "redistribuidor." @@ -2706,8 +2705,8 @@ msgid "" "Some more examples of unusual version numbers are given in a `blog post " "`_ by Seth Larson." msgstr "" -"Mais alguns exemplos de números de versão incomuns são fornecidos em uma `" -"postagem no blog `_ de Seth Larson." +"Mais alguns exemplos de números de versão incomuns são fornecidos em uma " +"`postagem no blog `_ de Seth Larson." #: ../source/discussions/versioning.rst:181 msgid "" @@ -3140,18 +3139,67 @@ msgid "" msgstr "" "Um formato de :term:`Distribuição ` contendo arquivos " "e metadados que só precisam ser movidos para o local correto no sistema de " -"destino, para serem instalados. :term:`Wheel` é esse formato, enquanto o " -":term:`Distribuição Fonte ` não é, pois " +"destino, para serem instalados. :term:`Wheel` é esse formato, enquanto o :" +"term:`Distribuição Fonte ` não é, pois " "requer uma etapa de construção antes de poder ser instalado. Este formato " -"não implica que os arquivos Python tenham que ser pré-compilados " -"(:term:`Wheel` intencionalmente não inclui arquivos Python compilados). Veja " -":ref:`package-formats` para mais informações." +"não implica que os arquivos Python tenham que ser pré-compilados (:term:" +"`Wheel` intencionalmente não inclui arquivos Python compilados). Veja :ref:" +"`package-formats` para mais informações." #: ../source/glossary.rst:56 +msgid "Built Metadata" +msgstr "" + +#: ../source/glossary.rst:59 +msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +#, fuzzy +#| msgid "Configuring metadata" +msgid "Core Metadata" +msgstr "Configurando metadados" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Distribution Package" +msgid "Distribution Archive" +msgstr "Pacote de Distribuição" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 msgid "Distribution Package" msgstr "Pacote de Distribuição" -#: ../source/glossary.rst:59 +#: ../source/glossary.rst:92 msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " @@ -3163,7 +3211,7 @@ msgstr "" "distribuir um :term:`Release` (lançamento). O arquivo é o que um usuário " "final irá baixar da Internet e instalar." -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -3183,24 +3231,24 @@ msgstr "" "\"distribuição\". Veja :ref:`distribution-package-vs-import-package` para " "uma explicação das diferenças." -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Egg" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -"Um formato de :term:`Distribuição Construída` introduzido pelo " -":ref:`setuptools`, que foi substituído pelo :term:`Wheel`. Para detalhes, " -"veja :ref:`egg-format`." +"Um formato de :term:`Distribuição Construída` introduzido pelo :ref:" +"`setuptools`, que foi substituído pelo :term:`Wheel`. Para detalhes, veja :" +"ref:`egg-format`." -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "Módulo de Extensão" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -3215,11 +3263,11 @@ msgstr "" "extensão .pyd) para extensões Python no Windows ou um arquivo de classe Java " "para extensões Jython." -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "Known Good Set (KGS)" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -3234,11 +3282,11 @@ msgstr "" "usado por frameworks e kits de ferramentas que são compostos de várias " "distribuições individuais." -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "Pacote de Importação" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." @@ -3246,7 +3294,7 @@ msgstr "" "Um módulo Python que pode conter outros módulos ou recursivamente, outros " "pacotes." -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -3260,11 +3308,24 @@ msgstr "" "comumente chamado de \"pacote\" . Veja :ref:`distribution-package-vs-import-" "package` para uma explicação das diferenças." -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "Instalador" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Módulo" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." @@ -3272,11 +3333,11 @@ msgstr "" "A unidade básica de reutilização de código em Python, existindo em um dos " "dois tipos: :term:`Módulo Puro` ou :term:`Módulo de Extensão`." -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "Índice de Pacotes" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." @@ -3284,11 +3345,11 @@ msgstr "" "Um repositório de distribuições com uma interface web para automatizar " "descoberta e consumo de :term:`pacotes `." -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "Índice Por Projeto" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " @@ -3298,12 +3359,12 @@ msgstr "" "term:`Projeto` específico como o índice preferido ou necessário para " "resolver dependências desse projeto." -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Projeto" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " @@ -3313,7 +3374,7 @@ msgstr "" "outros recursos, ou alguma combinação dos mesmos que se destina a ser " "empacotado em uma :term:`Distribuição `." -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -3327,7 +3388,7 @@ msgstr "" "que contém um arquivo :term:`pyproject.toml`, :term:`setup.py` ou :term:" "`setup.cfg` na raiz do diretório fonte do projeto." -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -3339,7 +3400,7 @@ msgstr "" "`Lançamentos `, e cada lançamento pode incluir uma ou mais :term:" "`distribuições `." -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -3351,11 +3412,61 @@ msgstr "" "É possível instalar uma distribuição do projeto \"foo\" e fazer com que ele " "forneça um pacote importável apenas como \"bar\"." -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Projects in subdirectories" +msgid "Project Root Directory" +msgstr "Projetos em subdiretórios" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +#, fuzzy +#| msgid "Project Summaries" +msgid "Project Source Tree" +msgstr "Resumos de projetos" + +#: ../source/glossary.rst:201 +#, fuzzy +#| msgid "" +#| "An archive containing the raw source code for a :term:`Release`, prior to " +#| "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" +"Um arquivo contendo o código-fonte bruto para um :term:`Lançamento " +"`, antes da criação de uma :term:`Distribuição Fonte ` ou :term:`Distribuição Construída `." + +#: ../source/glossary.rst:207 +#, fuzzy +#| msgid "Project Summaries" +msgid "Project Source Metadata" +msgstr "Resumos de projetos" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Módulo Puro" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." @@ -3363,11 +3474,48 @@ msgstr "" "Um :term:`Módulo` escrito em Python e contido em um único arquivo ``.py`` (e " "possivelmente arquivos ``.pyc`` e/ou ``.pyo`` associados)." -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "Nome do projeto" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "Declaring project metadata" +msgid "Pyproject Metadata Key" +msgstr "Declarando os metadados do projeto" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "Python Packaging Authority (PyPA)" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -3383,11 +3531,11 @@ msgstr "" "sig `_ e " "`o fórum Discourse do Python `__." -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "Python Package Index (PyPI)" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " @@ -3397,11 +3545,11 @@ msgstr "" "comunidade Python. Está aberto a todos os desenvolvedores Python para " "consumir e distribuir suas distribuições." -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "pypi.org" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." @@ -3411,22 +3559,22 @@ msgstr "" "Index (PyPI)`. Ele substituiu o nome de domínio do índice legado, ``pypi." "python.org``, em 2017. Ele é tornado possível pelo :ref:`warehouse`." -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "pyproject.toml" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" "O arquivo de especificação agnóstica de ferramenta para :term:`Projetos " "`. Definido na :pep:`518`." -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "Lançamento" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." @@ -3434,7 +3582,7 @@ msgstr "" "Um snapshot de um :term:`Projeto` em um determinado ponto no tempo, denotado " "por um identificador de versão." -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -3446,11 +3594,11 @@ msgstr "" "projeto foi lançada, ele pode estar disponível em um formato de distribuição " "fonte e um formato de distribuição de instalador do Windows." -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "Requisito" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -3464,11 +3612,11 @@ msgstr "" "podem ser consideradas um \"requisito\". Para obter mais informações, " "consulte a referência de :ref:`pip:pip install`." -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "Especificador de Requisitos" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -3481,11 +3629,11 @@ msgstr "" "onde \"foo\" é o nome do projeto e a parte \">=1.3\" é o :term:" "`Especificador de Versão`" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "Arquivo de Requisitos" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " @@ -3495,17 +3643,17 @@ msgstr "" "ser instalados usando :ref:`pip`. Para mais informações, veja a " "documentação :ref:`pip` em :ref:`pip:Requirements Files`." -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "setup.py" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "setup.cfg" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." @@ -3513,11 +3661,11 @@ msgstr "" "Os arquivos de especificação do projeto para :ref:`distutils` e :ref:" "`setuptools`. Veja também :term:`pyproject.toml`." -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "Arquivo Fonte" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` ou :term:`Distribuição Construída `." -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "Distribuição Fonte (ou \"sdist\")" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 +#, fuzzy +#| msgid "" +#| "A :term:`distribution ` format (usually generated " +#| "using ``python -m build --sdist``) that provides metadata and the " +#| "essential source files needed for installing by a tool like :ref:`pip`, " +#| "or for generating a :term:`Built Distribution`. See :ref:`package-" +#| "formats` for more information." msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " @@ -3543,14 +3698,14 @@ msgstr "" "Um formato de :term:`distribuição ` (geralmente gerado " "usando ``python -m build sdist``) que fornece metadados e os arquivos-fonte " "essenciais necessários para a instalação por uma ferramenta como :ref:`pip`, " -"ou para gerar uma :term:`Distribuição Construída `. Veja " -":ref:`package-formats` para mais informações." +"ou para gerar uma :term:`Distribuição Construída `. " +"Veja :ref:`package-formats` para mais informações." -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "Pacote de Sistemas" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." @@ -3558,11 +3713,11 @@ msgstr "" "Um pacote fornecido em um formato nativo para o sistema operacional, por " "exemplo, um arquivo rpm ou dpkg." -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "Especificador de Versão" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -3577,11 +3732,11 @@ msgstr "" "oferece suporte atualmente. O suporte para esta especificação foi " "implementado no :ref:`setuptools` v8.0 e no :ref:`pip` v6.0." -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "Ambiente Virtual" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -3593,23 +3748,41 @@ msgstr "" "sistema. Para obter mais informações, consulte a seção sobre :ref:`Creating " "and using Virtual Environments`." -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +#, fuzzy +#| msgid "File Format" +msgid "Wheel Format" +msgstr "Formato de arquivos" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "Wheel" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -"O formato padrão de :term:`Distribuição Construída`. Veja :ref:`package-" -"formats` para mais informações." -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Projeto" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "Conjunto de Trabalho" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -5883,9 +6056,9 @@ msgid "" "Apache server" msgstr "" "usando `mod_rewrite `_ e " -"`mod_cache_disk `_, você pode armazenar em cache as solicitações para " -"índices de pacotes por meio de um servidor Apache" +"`mod_cache_disk `_, você pode armazenar em cache as solicitações para índices de " +"pacotes por meio de um servidor Apache" #: ../source/guides/hosting-your-own-index.rst:131 msgid "" @@ -9389,12 +9562,11 @@ msgid "" msgstr "" "Pode ser necessário gerenciar suas permissões do ``GITHUB_TOKEN`` para " "permitir a criação da versão do GitHub. Consulte a `documentação do GitHub " -"`_ para " -"obter instruções. Especificamente, o token precisa da permissão ``contents: " -"write``." +"`_ para obter instruções. Especificamente, o token precisa da " +"permissão ``contents: write``." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:182 msgid "Finally, the signed distributions are uploaded to the GitHub Release." @@ -10467,8 +10639,8 @@ msgid "" "`virtualenv` (PyPA project) and :doc:`venv ` (part of " "the Python standard library, though missing some features of virtualenv)." msgstr "" -"As ferramentas padrão para criar e usar ambientes virtuais manualmente são " -":ref:`virtualenv` (projeto PyPA) e :doc:`venv ` (parte " +"As ferramentas padrão para criar e usar ambientes virtuais manualmente são :" +"ref:`virtualenv` (projeto PyPA) e :doc:`venv ` (parte " "da biblioteca padrão Python, embora falte alguns recursos do virtualenv) ." #: ../source/guides/tool-recommendations.rst:28 @@ -10504,15 +10676,15 @@ msgstr "" "executados a partir da linha de comando. Pipx é um wrapper em torno de pip e " "venv que instala cada aplicativo em um ambiente virtual dedicado. Isso evita " "conflitos entre as dependências de diferentes aplicações, e também com " -"aplicações de todo o sistema que utilizam o mesmo interpretador Python (" -"especialmente no Linux)." +"aplicações de todo o sistema que utilizam o mesmo interpretador Python " +"(especialmente no Linux)." #: ../source/guides/tool-recommendations.rst:43 msgid "" "For scientific software specifically, consider :ref:`Conda` or :ref:`Spack`." msgstr "" -"Especificamente para software científico, considere :ref:`Conda` ou " -":ref:`Spack`." +"Especificamente para software científico, considere :ref:`Conda` ou :ref:" +"`Spack`." #: ../source/guides/tool-recommendations.rst:45 msgid "Write a \"pip vs. Conda\" comparison, here or in a new discussion." @@ -10528,11 +10700,11 @@ msgid "" "background and :ref:`modernize-setup-py-project` for migration advice)." msgstr "" "**Não** use ``easy_install`` (parte de :ref:`setuptools`), que foi " -"descontinuado em favor do pip (veja :ref:`pip vs easy_install` para detalhes)" -". Da mesma forma, **não** use ``python setup.py install`` ou ``python " -"setup.py development``, que também foram descontinuados (veja :ref:`setup-py-" -"deprecated` para aprofundamento e :ref :`modernize-setup-py-project` para " -"aconselhamento sobre migração)." +"descontinuado em favor do pip (veja :ref:`pip vs easy_install` para " +"detalhes). Da mesma forma, **não** use ``python setup.py install`` ou " +"``python setup.py development``, que também foram descontinuados (veja :ref:" +"`setup-py-deprecated` para aprofundamento e :ref :`modernize-setup-py-" +"project` para aconselhamento sobre migração)." #: ../source/guides/tool-recommendations.rst:55 msgid "Lock files" @@ -15852,7 +16024,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -17182,7 +17354,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Especificação" @@ -19392,25 +19564,25 @@ msgstr "" "padrões e de proposição de novos está documentado em `pypa.io `__." -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 #, fuzzy msgid "Inline script metadata" msgstr "Declarando os metadados do projeto" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -19421,7 +19593,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -19431,158 +19603,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "Exemplo" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy msgid "Reference Implementation" msgstr "Tipos de documentação" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 #, fuzzy msgid "Recommendations" msgstr "Recomendações de ferramentas" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -26964,6 +27136,13 @@ msgid "" "the file is empty)." msgstr "" +#~ msgid "" +#~ "The standard :term:`Built Distribution` format. See :ref:`package-" +#~ "formats` for more information." +#~ msgstr "" +#~ "O formato padrão de :term:`Distribuição Construída`. Veja :ref:`package-" +#~ "formats` para mais informações." + #~ msgid "The summary description of the project." #~ msgstr "A descrição resumida do projeto." @@ -28157,9 +28336,6 @@ msgstr "" #~ "declarar quaisquer dependências de nível Python que devem ser instaladas " #~ "para executar o sistema de construção do projeto com sucesso." -#~ msgid "Declaring project metadata" -#~ msgstr "Declarando os metadados do projeto" - #~ msgid "" #~ ":pep:`621` specifies how to write a project's :ref:`core metadata ` in a ``pyproject.toml`` file for packaging-related tools to " diff --git a/locales/ro/LC_MESSAGES/messages.po b/locales/ro/LC_MESSAGES/messages.po index 8afa06960..40dbcc7a6 100644 --- a/locales/ro/LC_MESSAGES/messages.po +++ b/locales/ro/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2021-08-20 01:32+0000\n" "Last-Translator: GUILHERME FERNANDES NETO \n" "Language-Team: Romanian ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2379,21 +2424,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2402,11 +2447,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2415,17 +2460,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2434,50 +2479,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "Pe Indexul Proiectului" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2486,7 +2542,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2494,7 +2550,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2502,21 +2558,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Modul Pur" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2526,48 +2650,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2575,11 +2699,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2588,11 +2712,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "Specificator Cerință" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2600,72 +2724,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2674,11 +2798,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2686,21 +2810,39 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Per Project Index" +msgid "Wheel Project" +msgstr "Pe Indexul Proiectului" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11803,7 +11945,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12809,7 +12951,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14558,24 +14700,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14586,7 +14728,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14596,156 +14738,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/ru/LC_MESSAGES/messages.po b/locales/ru/LC_MESSAGES/messages.po index 8db3b5072..c830ee7f3 100644 --- a/locales/ru/LC_MESSAGES/messages.po +++ b/locales/ru/LC_MESSAGES/messages.po @@ -13,11 +13,11 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2024-04-28 16:07+0000\n" "Last-Translator: gfbdrgng \n" -"Language-Team: Russian \n" +"Language-Team: Russian \n" "Language: ru\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -2268,8 +2268,8 @@ msgstr "" "Различные Python-проекты могут использовать различные схемы версионирования " "в зависимости от потребностей конкретного проекта, но для совместимости с " "такими инструментами, как :ref:`pip`, все они должны соответствовать гибкому " -"формату идентификаторов версий, для которого авторитетной ссылкой является " -":ref:`specification of version specifiers `. Вот " +"формату идентификаторов версий, для которого авторитетной ссылкой является :" +"ref:`specification of version specifiers `. Вот " "несколько примеров номеров версий [#version-examples]_:" #: ../source/discussions/versioning.rst:21 @@ -3048,10 +3048,59 @@ msgstr "" "Python)." #: ../source/glossary.rst:56 +msgid "Built Metadata" +msgstr "" + +#: ../source/glossary.rst:59 +msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +#, fuzzy +#| msgid "Configuring metadata" +msgid "Core Metadata" +msgstr "Конфигурирование метаданных" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Distribution Package" +msgid "Distribution Archive" +msgstr "Пакет дистрибутива" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 msgid "Distribution Package" msgstr "Пакет дистрибутива" -#: ../source/glossary.rst:59 +#: ../source/glossary.rst:92 msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " @@ -3063,7 +3112,7 @@ msgstr "" "используются для распространения :term:`Release`. Архивный файл - это то, " "что конечный пользователь скачает из интернета и установит." -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -3082,11 +3131,11 @@ msgstr "" "Python), которые часто обозначаются одним термином \"дистрибутив\". Разбор " "различий см. в :ref:`distribution-package-vs-import-package`." -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Яйцо" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." @@ -3094,11 +3143,11 @@ msgstr "" "Формат :term:`Built Distribution`, введенный :ref:`setuptools`, который был " "заменен :term:`Wheel`. Подробности см. в :ref:`egg-format`." -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "Модуль расширения" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -3112,11 +3161,11 @@ msgstr "" "объектов (.so) для расширений Python на Unix, DLL (с расширением .pyd) для " "расширений Python на Windows, или в файле классов Java для расширений Jython." -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "Known Good Set (KGS, Известный хороший набор)" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -3130,11 +3179,11 @@ msgstr "" "используется во фреймворках и наборах инструментов, которые состоят из " "нескольких отдельных дистрибутивов." -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "Import Package (Импортируемый пакет)" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." @@ -3142,7 +3191,7 @@ msgstr "" "Модуль Python, который может содержать другие модули или, рекурсивно, другие " "пакеты." -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -3156,11 +3205,24 @@ msgstr "" "также обычно называется \"пакет\". Различия см. в :ref:`distribution-package-" "vs-import-package`." -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "Установщик" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Модуль" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." @@ -3169,11 +3231,11 @@ msgstr "" "одном из двух типов: :термин: «чистый модуль» или :термин: «модуль " "расширения»." -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "Индекс пакета" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." @@ -3181,11 +3243,11 @@ msgstr "" "Репозиторий дистрибутивов с веб-интерфейсом для автоматизации :term:`package " "` обнаружения и потребления." -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "Индекс на проект" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " @@ -3195,12 +3257,12 @@ msgstr "" "конкретным:термин: «проект» как индекс, предпочтительный или необходимый для " "решения зависимостей этого проекта." -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Проект" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " @@ -3210,7 +3272,7 @@ msgstr "" "других ресурсов, или определенная их комбинация, которая должна быть " "упакована в :term:`Distribution `." -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -3224,7 +3286,7 @@ msgstr "" "время является то, что содержит :term:`pyproject.toml`, :term:`setup.py` " "или :term:`setup.cfg` файл в корне исходного каталога проекта." -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -3236,7 +3298,7 @@ msgstr "" "несколько :term:`Releases `, а каждый релиз может состоять из " "одного или нескольких :term:`distributions `." -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -3248,11 +3310,60 @@ msgstr "" "обязательно так. Можно установить дистрибутив из проекта 'foo' и получить от " "него пакет, импортируемый только как 'bar'." -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Projects in subdirectories" +msgid "Project Root Directory" +msgstr "Проекты в подкаталогах" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +#, fuzzy +#| msgid "Project Summaries" +msgid "Project Source Tree" +msgstr "Обзор проектов" + +#: ../source/glossary.rst:201 +#, fuzzy +#| msgid "" +#| "An archive containing the raw source code for a :term:`Release`, prior to " +#| "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" +"Архив, содержащий исходный код для :term:`Release`, до создания :term:" +"`Source Distribution ` или :term:`Built " +"Distribution`." + +#: ../source/glossary.rst:207 +#, fuzzy +#| msgid "Project Summaries" +msgid "Project Source Metadata" +msgstr "Обзор проектов" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Чистый модуль" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." @@ -3260,11 +3371,48 @@ msgstr "" "Модуль, написанный на языке Python и содержащийся в одном файле ``.py`` (и, " "возможно, связанных с ним файлах ``.pyc`` и/или ``.pyo``)." -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "Название проекта" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "pyproject type" +msgid "Pyproject Metadata Key" +msgstr "тип проекта" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "Python Управление по упаковке (PyPA)" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -3281,11 +3429,11 @@ msgstr "" "distutils-sig.python.org/>`_ и на форуме Python Discourse `__." -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "Индекс пакетов Python (PyPI)" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " @@ -3295,11 +3443,11 @@ msgstr "" "сообщества Python. Он открыт для всех разработчиков Python для потребления и " "распространения их дистрибутивов." -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "pypi.org" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." @@ -3309,22 +3457,22 @@ msgstr "" "Index (PyPI)`. Он заменил устаревшее доменное имя индекса, ``pypi.python." "org``, в 2017 году. Он работает на базе :ref:`warehouse`." -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "pyproject.toml" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" "Инструмент-агностик:термин: файл спецификации \"Проект\". Определен в :pep:" "`518'." -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "Выпуск" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." @@ -3332,7 +3480,7 @@ msgstr "" "Снимок :term:`Project` в определенный момент времени, обозначаемый " "идентификатором версии." -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -3344,11 +3492,11 @@ msgstr "" "была выпущена, она может быть доступна как в формате распределения " "источника, так и в формате Windows." -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "Требование" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -3362,11 +3510,11 @@ msgstr "" "считаться \"требованием\". Для получения дополнительной информации смотрите " "ссылку :ref:`pip:pip install`." -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "Спецификатор требований" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -3378,11 +3526,11 @@ msgstr "" "specifiers`. Например, \"foo>=1.3\" - это спецификатор требований, где " "\"foo\" - это имя проекта, а часть \">=1.3\" - это :term:`Version Specifier`" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "Требования к файлам" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " @@ -3392,17 +3540,17 @@ msgstr "" "быть установлен с помощью :ref:`pip'. Дополнительные сведения см. в :ref:" "`pip'''' docs on :ref:`pip:Requirements Files`." -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "setup.py" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "setup.cfg" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." @@ -3410,11 +3558,11 @@ msgstr "" "Файлы спецификаций проекта для:ref:`distutils' и :ref:`setuptools'. См. " "также :term:`pyproject.toml'." -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "Источник Архив" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` или :term:`Built " "Distribution`." -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "Распространение исходных текстов (или \"sdist\")" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 #, fuzzy #| msgid "" #| "A :term:`distribution ` format (usually generated " @@ -3436,7 +3584,7 @@ msgstr "Распространение исходных текстов (или \ #| "essential source files needed for installing by a tool like :ref:`pip`, " #| "or for generating a :term:`Built Distribution`." msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " @@ -3448,11 +3596,11 @@ msgstr "" "такого инструмента, как:ref:`pip', или для создания:term:`Built " "Distribution'." -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "Системный пакет" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." @@ -3460,11 +3608,11 @@ msgstr "" "Пакет, предоставляемый в формате, имеющем отношение к операционной системе, " "например, файл rpm или dpkg." -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "Спецификатор версии" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -3478,11 +3626,11 @@ msgstr "" "настоящее время поддерживаются. Поддержка этой спецификации была реализована " "в :ref:`setuptools` v8.0 и :ref:`pip` v6.0." -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "Виртуальная среда" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -3494,21 +3642,41 @@ msgstr "" "системы. Для получения дополнительной информации см. раздел :ref:`Создание и " "использование виртуальных сред`." -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +#, fuzzy +#| msgid "File Format" +msgid "Wheel Format" +msgstr "Формат файла" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "Колесо" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Проект" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "Рабочая группа" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -15664,7 +15832,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -16986,7 +17154,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Спецификация" @@ -19453,11 +19621,11 @@ msgstr "" "стандартов и предложения новых задокументирован на сайте `pypa.io `__." -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "Встроенные метаданные сценария" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " @@ -19468,7 +19636,7 @@ msgstr "" "внешним инструментам, которым может понадобиться взаимодействовать с такими " "скриптами." -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." @@ -19476,7 +19644,7 @@ msgstr "" "Эта спецификация определяет формат блока комментариев метаданных (в " "значительной степени вдохновленный `reStructuredText Directives`__)." -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -19494,7 +19662,7 @@ msgstr "" "один пробел, а затем три прямые косые черты. ``TYPE`` ДОЛЖЕН состоять только " "из букв ASCII, цифр и дефисов." -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -19510,7 +19678,7 @@ msgstr "" "противном случае - только первого символа (что означает, что строка состоит " "только из одного ``#``)." -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " @@ -19520,7 +19688,7 @@ msgstr "" "следующая строка не является допустимой строкой встроенного содержимого, как " "описано выше. Например, ниже приведен один полностью допустимый блок:" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " @@ -19530,7 +19698,7 @@ msgstr "" "линиями. В таких случаях инструменты МОГУТ выдать ошибку. Незакрытые блоки " "ДОЛЖНЫ игнорироваться." -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." @@ -19538,7 +19706,7 @@ msgstr "" "Если определено несколько блоков комментариев одного и того же ``типа``, " "инструменты ДОЛЖНЫ выдать ошибку." -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " @@ -19548,7 +19716,7 @@ msgstr "" "кодировки Python. Если они этого не делают, они ДОЛЖНЫ обрабатывать файл в " "кодировке UTF-8." -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" @@ -19556,7 +19724,7 @@ msgstr "" "Это каноническое регулярное выражение, которое МОЖЕТ быть использовано для " "разбора метаданных:" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." @@ -19564,7 +19732,7 @@ msgstr "" "В случае расхождения между текстовой спецификацией и регулярным выражением " "приоритет отдается текстовой спецификации." -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." @@ -19572,11 +19740,11 @@ msgstr "" "Инструменты НЕ ДОЛЖНЫ читать из блоков метаданных с типами, которые не были " "стандартизированы данной спецификацией." -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "тип скрипта" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." @@ -19584,7 +19752,7 @@ msgstr "" "Первый тип блока метаданных называется ``script`, он содержит метаданные " "сценария (данные о зависимостях и конфигурации инструментов)." -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." @@ -19592,18 +19760,18 @@ msgstr "" "Этот документ МОЖЕТ включать поля верхнего уровня ``зависимости`` и " "``требования-python``, и МОЖЕТ опционально включать таблицу ``[инструмент]``." -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " @@ -19613,7 +19781,7 @@ msgstr "" "выполнения. Каждая запись ДОЛЖНА быть действительным :ref:`спецификатором " "зависимости `." -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" @@ -19623,7 +19791,7 @@ msgstr "" "совместим(ы) скрипт. Значение этого поля ДОЛЖНО быть действительным :ref:" "`спецификатором версии `." -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " @@ -19634,11 +19802,11 @@ msgstr "" "если не может быть предоставлена версия Python, удовлетворяющая указанному " "``требованию-python``." -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "Пример" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 #, fuzzy #| msgid "" #| "The following is an example of a script with an embedded ``pyproject." @@ -19646,18 +19814,18 @@ msgstr "Пример" msgid "The following is an example of a script with embedded metadata:" msgstr "Ниже приведен пример сценария со встроенным ``pyproject.toml``:" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "Справочное осуществление" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" "Ниже приведен пример того, как читать метаданные на Python 3.11 и выше." -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " @@ -19667,7 +19835,7 @@ msgstr "" "менеджеры пакетов или автоматизация обновления зависимостей в CI. Ниже " "приведен пример изменения содержимого с помощью библиотеки ``tomlkit``." -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " @@ -19677,18 +19845,18 @@ msgstr "" "форматирование TOML. Это ни в коем случае не является обязательным условием " "редактирования, а скорее \"приятная возможность\"." -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "Ниже приведен пример чтения потока произвольных блоков метаданных." -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "Рекомендации" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " @@ -19698,14 +19866,14 @@ msgstr "" "пытаться использовать самую высокую доступную версию Python, совместимую с " "метаданными скрипта ``requires-python``, если они определены." -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" "Октябрь 2023 года: Эта спецификация была условно утверждена через :pep:`723`." -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -28444,9 +28612,6 @@ msgstr "" #~ "отменена. Подробности см. в ветке `PEP 723 условное принятие `_." -#~ msgid "pyproject type" -#~ msgstr "тип проекта" - #~ msgid "This document MAY include the ``[run]`` and ``[tool]`` tables." #~ msgstr "Этот документ МОЖЕТ включать таблицы ``[run]`` и ``[tool]``." diff --git a/locales/sai/LC_MESSAGES/messages.po b/locales/sai/LC_MESSAGES/messages.po index f884f20a4..f6130e4d5 100644 --- a/locales/sai/LC_MESSAGES/messages.po +++ b/locales/sai/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -2352,18 +2352,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2375,21 +2420,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2398,11 +2443,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2411,17 +2456,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2430,50 +2475,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2482,7 +2538,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2490,7 +2546,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2498,21 +2554,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2522,48 +2646,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2571,11 +2695,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2584,11 +2708,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2596,72 +2720,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2670,11 +2794,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2682,21 +2806,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11797,7 +11937,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12803,7 +12943,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14552,24 +14692,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14580,7 +14720,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14590,156 +14730,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/si/LC_MESSAGES/messages.po b/locales/si/LC_MESSAGES/messages.po index 20641a470..87c41f462 100644 --- a/locales/si/LC_MESSAGES/messages.po +++ b/locales/si/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-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2022-06-11 08:19+0000\n" "Last-Translator: Kushan Gunasekera \n" "Language-Team: Sinhala ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2379,21 +2424,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2402,11 +2447,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2415,17 +2460,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2434,50 +2479,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2486,7 +2542,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2494,7 +2550,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2502,21 +2558,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2526,48 +2650,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2575,11 +2699,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2588,11 +2712,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2600,72 +2724,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2674,11 +2798,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2686,21 +2810,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11801,7 +11941,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12807,7 +12947,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14556,24 +14696,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14584,7 +14724,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14594,156 +14734,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/sk/LC_MESSAGES/messages.po b/locales/sk/LC_MESSAGES/messages.po index 2b3f56ca9..906b4ebd1 100644 --- a/locales/sk/LC_MESSAGES/messages.po +++ b/locales/sk/LC_MESSAGES/messages.po @@ -7,11 +7,11 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2024-04-25 06:07+0000\n" "Last-Translator: Rafael Fontenelle \n" -"Language-Team: Slovak \n" +"Language-Team: Slovak \n" "Language: sk\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -2464,18 +2464,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2487,21 +2532,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2510,11 +2555,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2523,17 +2568,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2542,50 +2587,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Translations" +msgid "Installed Project" +msgstr "Preklady" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Projekt" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2594,7 +2652,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2602,7 +2660,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2610,21 +2668,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "Meno projektu" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "Meno projektu" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata Key" +msgstr "Meno projektu" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2634,48 +2766,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2683,11 +2815,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2696,11 +2828,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2708,72 +2840,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2782,11 +2914,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2794,21 +2926,39 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Projekt" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11935,7 +12085,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12941,7 +13091,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14694,24 +14844,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14722,7 +14872,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14732,158 +14882,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "Typy dokumentov" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21223,8 +21373,3 @@ msgid "" "recommended to stick with *regular packages* and ``__init__.py`` (even if " "the file is empty)." msgstr "" - -#, fuzzy -#~| msgid "Project name" -#~ msgid "pyproject type" -#~ msgstr "Meno projektu" diff --git a/locales/uk/LC_MESSAGES/messages.po b/locales/uk/LC_MESSAGES/messages.po index 9c3d352e3..12aaba8c9 100644 --- a/locales/uk/LC_MESSAGES/messages.po +++ b/locales/uk/LC_MESSAGES/messages.po @@ -15,7 +15,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2024-03-01 20:00+0000\n" "Last-Translator: Sviatoslav Sydorenko \n" "Language-Team: Ukrainian ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Distribution Package" +msgid "Distribution Archive" +msgstr "Дистриб'юторський пакет" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 msgid "Distribution Package" msgstr "Дистриб'юторський пакет" -#: ../source/glossary.rst:59 +#: ../source/glossary.rst:92 msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " @@ -2716,7 +2763,7 @@ msgid "" "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2728,11 +2775,11 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Яйце" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 #, fuzzy #| msgid "" #| "The :term:`Egg` format was introduced by :ref:`setuptools` in 2004, " @@ -2744,11 +2791,11 @@ msgstr "" "Формат :term:`Egg` був представлений :ref:`setuptools` у 2004 році, тоді як " "формат :term:`Wheel` був представлений :pep:`427` у 2012 році." -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "Модуль розширення" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2757,11 +2804,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2770,17 +2817,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "Імпорт пакету" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2789,50 +2836,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "Встановлювач" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Модуль" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "Реєстр Пакунків" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "Індекс за проєктом" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Проєкт" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2841,7 +2901,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2849,7 +2909,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2857,21 +2917,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "Назва проєкту" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Чистий модуль" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "Назва проєкту" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "pyproject.toml" +msgid "Pyproject Metadata Key" +msgstr "pyproject.toml" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "Управління з пакування Python (PyPA)" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2881,48 +3015,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "Реєстр Python-пакунків (PyPI)" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "pypi.org" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "pyproject.toml" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "Випуск" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2930,11 +3064,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2943,11 +3077,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "Специфікатор вимоги" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2955,72 +3089,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "setup.py" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "setup.cfg" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "Вихідний архів" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "Специфікатор версії" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -3029,11 +3163,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -3041,21 +3175,41 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +#, fuzzy +#| msgid "Format::" +msgid "Wheel Format" +msgstr "Формат::" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "Колесо" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Проєкт" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -12286,7 +12440,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -13294,7 +13448,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Специфікація" @@ -15077,24 +15231,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -15105,7 +15259,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -15115,161 +15269,161 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 #, fuzzy msgid "Example" msgstr "Приклади" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "Типи документації" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 #, fuzzy #| msgid "Packaging tool recommendations" msgid "Recommendations" msgstr "Поради щодо засобу пакування" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21732,11 +21886,6 @@ msgstr "" #~ msgid "Pre-release versioning" #~ msgstr "Версіонування попередніх випусків" -#, fuzzy -#~| msgid "pyproject.toml" -#~ msgid "pyproject type" -#~ msgstr "pyproject.toml" - #~ msgid "" #~ "`Heroku `_" diff --git a/locales/zh_Hans/LC_MESSAGES/messages.po b/locales/zh_Hans/LC_MESSAGES/messages.po index f4e59e575..0d02bd433 100644 --- a/locales/zh_Hans/LC_MESSAGES/messages.po +++ b/locales/zh_Hans/LC_MESSAGES/messages.po @@ -29,7 +29,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2024-04-04 03:43+0000\n" "Last-Translator: 大王叫我来巡山 \n" @@ -2628,10 +2628,57 @@ msgstr "" "编译 Python 文件（:term:` Wheel ` 故意不包括编译的 Python 文件）。" #: ../source/glossary.rst:56 +msgid "Built Metadata" +msgstr "" + +#: ../source/glossary.rst:59 +msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Distribution Package" +msgid "Distribution Archive" +msgstr "发行版" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 msgid "Distribution Package" msgstr "发行版" -#: ../source/glossary.rst:59 +#: ../source/glossary.rst:92 msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " @@ -2642,7 +2689,7 @@ msgstr "" "`modules ` 和其他用于分发:term:`Release` 的资源文件的版本化存档文件。" "存档文件是最终用户将从 Internet 下载并安装的文件。" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 #, fuzzy #| msgid "" #| "A distribution package is more commonly referred to with the single words " @@ -2666,11 +2713,11 @@ msgstr "" "Package` 混淆时，本指南可能会使用扩展术语（通常也称为“包”）或另一种发行版（例" "如 Linux 发行版或 Python 语言发行版），通常用单个术语“发行版”来指代。" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Egg" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." @@ -2678,11 +2725,11 @@ msgstr "" "一种 :term:`构建分发` 格式，由 :ref:`setuptools` 引入，已被 :term:`Wheel` 替" "代。详见： :ref:`egg-format`." -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "扩展模块" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2695,11 +2742,11 @@ msgstr "" "享对象 (.so) 文件、Windows 上 Python 扩展的 DLL（给定 .pyd 扩展）或 Jython 扩" "展的 Java 类文件。" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "已知良好集 (KGS)" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2711,17 +2758,17 @@ msgstr "" "包被声明为已知良好集之前通过所有测试。 该术语通常用于由多个单独发行版组成的框" "架和工具包。" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "导入包" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "一个Python模块，可以包含其他模块或递归地包含其他包。" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 #, fuzzy #| msgid "" #| "An import package is more commonly referred to with the single word " @@ -2738,11 +2785,24 @@ msgstr "" "导入包通常用单个词“包”来指代，但本指南将在需要更清楚地说明时使用扩展术语，以" "防止与通常也称为“包”的 :term:`分发包` 混淆." -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "安装程序" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "模块" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." @@ -2750,11 +2810,11 @@ msgstr "" "Python 中代码可重用性的基本单元，存在于以下两种类型之一：:term:`Pure Module` " "或 :term:`Extension Module`。" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "包索引" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." @@ -2762,11 +2822,11 @@ msgstr "" "一个带有 Web 界面的发行版存储库，用于自动化 :term:`package ` 发现和消费。" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "每个项目索引（Per Project Index）" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " @@ -2775,12 +2835,12 @@ msgstr "" "专用或其他非规范的：term:`Package Index`由特定的：term:`Project`表示，作为首" "选索引或解决该项目依赖关系所需的索引。" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "项目" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " @@ -2789,7 +2849,7 @@ msgstr "" "数据或其他资源的库、框架、脚本、插件、应用程序或集合，或其组合，旨在打包成:" "term:`Distribution `。" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2802,7 +2862,7 @@ msgstr "" "另一个实际方式是在项目源目录下包含 :term:`pyproject.toml`、 :term:`setup.py`" "或 :term:`setup.cfg` 文件的东西。" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2814,7 +2874,7 @@ msgstr "" "` ，每个版本可能包括一个或多个 :term:`套件 ` 。" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2825,11 +2885,52 @@ msgstr "" "这并不一定是真的。可以从项目“foo”安装一个发行版，并让它提供一个只能作" "为“bar”导入的包。" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Projects in subdirectories" +msgid "Project Root Directory" +msgstr "子目录中的项目" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +#, fuzzy +#| msgid "Project Summaries" +msgid "Project Source Tree" +msgstr "项目摘要" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +#, fuzzy +#| msgid "Project Summaries" +msgid "Project Source Metadata" +msgstr "项目摘要" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "纯模块 (Pure Module)" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." @@ -2837,11 +2938,47 @@ msgstr "" "一个 :term:`Module`，使用 Python 编写并包含在单个 ``.py`` 文件 中（可能还有相" "关的 ``.pyc`` 和/或者 ``.pyo`` 文件）。" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "项目名称" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +msgid "Pyproject Metadata Key" +msgstr "pyproject.toml" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "Python 包装管理局 （PyPA）" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2857,11 +2994,11 @@ msgstr "" "和 `Python Discourse 论坛 `__ 上讨论" "问题。" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "Python 包索引 (PyPI)" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " @@ -2870,11 +3007,11 @@ msgstr "" "`PyPI `_ 是 Python 社区的默认 :term:`包索引 (Package " "Index) ` 。所有 Python 开发人员都可以使用和分发他们的发行版。" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "pypi.org" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." @@ -2884,26 +3021,26 @@ msgstr "" "名。它在2017年取代了旧的索引域名， ``pypi.python.org`` ，并由 :ref:" "`warehouse` 提供支持。" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "pyproject.toml" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "发行版 （Release）" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2911,11 +3048,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "要求 (Requirement)" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2924,11 +3061,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "需求说明符" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2936,11 +3073,11 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "需求文件" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " @@ -2950,17 +3087,17 @@ msgstr "" "使用 :ref:`pip` 来安装。更多信息，请参阅 :ref:`pip` 文档的 :ref:`pip:" "Requirements Files` 。" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "setup.py" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "setup.cfg" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." @@ -2968,45 +3105,45 @@ msgstr "" ":ref:`distutils` 和 :ref:`setuptools` 的项目规范文件。另见 :term:`pyproject." "toml`。" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "源代码归档" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "源代码分发（或“sdist”）" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "系统包 (System Package)" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "以操作系统本地格式提供的软件包，例如 rpm 或 dpkg 文件。" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "版本说明符 (Version Specifier)" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -3015,11 +3152,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "虚拟环境 (Virtual Environment)" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -3029,21 +3166,39 @@ msgstr "" "一个隔离的 Python 环境，允许安装软件包以供特定的应用程序使用，而不是在系统中" "安装。更多信息，请参见章节 :ref:`Creating and using Virtual Environments`." -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "Wheel" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "项目" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "工作集 (Working Set)" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -12541,7 +12696,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -13548,7 +13703,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "技术参数" @@ -15310,24 +15465,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -15338,7 +15493,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -15348,158 +15503,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "例子" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy msgid "Reference Implementation" msgstr "文档类型" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 #, fuzzy msgid "Recommendations" msgstr "创建文档" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21938,10 +22093,6 @@ msgstr "" #~ msgid "Caching with devpi" #~ msgstr "使用 devpi 进行缓存" -#, fuzzy -#~ msgid "pyproject type" -#~ msgstr "pyproject.toml" - #~ msgid "`OpenShift `_" #~ msgstr "`OpenShift `_" diff --git a/locales/zh_Hant/LC_MESSAGES/messages.po b/locales/zh_Hant/LC_MESSAGES/messages.po index 8e2b382f4..23ed0e708 100644 --- a/locales/zh_Hant/LC_MESSAGES/messages.po +++ b/locales/zh_Hant/LC_MESSAGES/messages.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-08 15:02+0000\n" "PO-Revision-Date: 2022-07-30 20:04+0000\n" "Last-Translator: meowmeowmeowcat \n" "Language-Team: Chinese (Traditional) ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2420,21 +2465,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2443,11 +2488,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2456,17 +2501,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2475,50 +2520,62 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +msgid "Installed Project" +msgstr "安裝軟體套件" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "套件索引" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2527,7 +2584,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2535,7 +2592,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2543,21 +2600,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "專案名稱" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "專案名稱" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata Key" +msgstr "專案名稱" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2567,48 +2698,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2616,11 +2747,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2629,11 +2760,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2641,72 +2772,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2715,11 +2846,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2727,21 +2858,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11912,7 +12059,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12918,7 +13065,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14677,24 +14824,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14705,7 +14852,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14715,158 +14862,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "文件類型" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21228,11 +21375,6 @@ msgid "" "the file is empty)." msgstr "" -#, fuzzy -#~| msgid "Project name" -#~ msgid "pyproject type" -#~ msgstr "專案名稱" - #~ msgid "List keywords that describe your project." #~ msgstr "列出描述您的項目的關鍵字。"