diff --git a/locales/ar/LC_MESSAGES/messages.po b/locales/ar/LC_MESSAGES/messages.po index b56cfcf5e..e1ef63d71 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2024-01-18 07:31+0000\n" "Last-Translator: Youcef Guenaoua \n" "Language-Team: Arabic ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1656,26 +1652,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12244,7 +12240,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12349,7 +12345,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12384,10 +12380,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12486,14 +12482,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12767,7 +12765,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12777,11 +12787,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12789,43 +12821,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12833,64 +12872,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12898,13 +12937,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12912,36 +12951,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12950,13 +12989,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12964,20 +13003,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -12985,7 +13024,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -12995,11 +13034,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13007,7 +13046,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13017,18 +13056,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13037,7 +13076,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13048,63 +13087,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13115,33 +13154,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13150,77 +13189,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/ars/LC_MESSAGES/messages.po b/locales/ars/LC_MESSAGES/messages.po index 53c414c18..bb1f6f57f 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1553,50 +1553,46 @@ msgid "``egg_info``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:144 -msgid "``install``" -msgstr "" - -#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_data``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:146 +#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_egg_info``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:147 +#: ../source/discussions/setup-py-deprecated.rst:146 msgid "``install_headers``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:148 +#: ../source/discussions/setup-py-deprecated.rst:147 msgid "``install_lib``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:149 +#: ../source/discussions/setup-py-deprecated.rst:148 msgid "``install_scripts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:150 +#: ../source/discussions/setup-py-deprecated.rst:149 msgid "``rotate``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:151 +#: ../source/discussions/setup-py-deprecated.rst:150 msgid "``saveopts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:152 +#: ../source/discussions/setup-py-deprecated.rst:151 msgid "``setopt``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:153 +#: ../source/discussions/setup-py-deprecated.rst:152 msgid "``upload_docs``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:157 +#: ../source/discussions/setup-py-deprecated.rst:156 msgid "What about custom commands?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:159 +#: ../source/discussions/setup-py-deprecated.rst:158 msgid "" "Likewise, custom :file:`setup.py` commands are deprecated. The " "recommendation is to migrate those custom commands to a task runner tool or " @@ -1604,46 +1600,46 @@ msgid "" "tox, pydoit, pyinvoke, taskipy, and thx." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:167 +#: ../source/discussions/setup-py-deprecated.rst:166 msgid "What about custom build steps?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:169 +#: ../source/discussions/setup-py-deprecated.rst:168 msgid "" "Custom build steps that for example either overwrite existing steps such as " "``build_py``, ``build_ext``, and ``bdist_wheel`` or add new build steps are " "not deprecated. Those will be automatically called as expected." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:176 +#: ../source/discussions/setup-py-deprecated.rst:175 #: ../source/guides/modernize-setup-py-project.rst:21 msgid "Should ``setup.py`` be deleted?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:178 +#: ../source/discussions/setup-py-deprecated.rst:177 msgid "" "Although the usage of :file:`setup.py` as an executable script is " "deprecated, its usage as a configuration file for setuptools is absolutely " "fine. There is likely no modification needed in :file:`setup.py`." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:184 +#: ../source/discussions/setup-py-deprecated.rst:183 msgid "Is ``pyproject.toml`` mandatory?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:186 +#: ../source/discussions/setup-py-deprecated.rst:185 msgid "" "While it is not technically necessary yet, it is **STRONGLY RECOMMENDED** " "for a project to have a :file:`pyproject.toml` file at the root of its " "source tree with a content like this:" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:197 +#: ../source/discussions/setup-py-deprecated.rst:196 msgid "" "The guide :ref:`modernize-setup-py-project` has more details about this." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:199 +#: ../source/discussions/setup-py-deprecated.rst:198 msgid "" "The standard fallback behavior for a :term:`build frontend ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1651,26 +1647,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12239,7 +12235,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12344,7 +12340,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12379,10 +12375,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12481,14 +12477,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12762,7 +12760,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12772,11 +12782,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12784,43 +12816,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12828,64 +12867,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12893,13 +12932,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12907,36 +12946,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12945,13 +12984,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12959,20 +12998,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -12980,7 +13019,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -12990,11 +13029,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13002,7 +13041,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13012,18 +13051,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13032,7 +13071,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13043,63 +13082,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13110,33 +13149,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13145,77 +13184,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/de/LC_MESSAGES/messages.po b/locales/de/LC_MESSAGES/messages.po index 6b94005d2..2fe937246 100644 --- a/locales/de/LC_MESSAGES/messages.po +++ b/locales/de/LC_MESSAGES/messages.po @@ -7,25 +7,26 @@ # Justin Nogossek , 2022. # Jean-Luc Tibaux , 2023. # TheescapedShadow , 2024. +# Hartmut Goebel , 2024. msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-08-24 00:21+0000\n" -"PO-Revision-Date: 2024-04-22 14:28+0000\n" -"Last-Translator: Pixel-Master \n" -"Language-Team: German \n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" +"PO-Revision-Date: 2024-10-03 02:15+0000\n" +"Last-Translator: Hartmut Goebel \n" +"Language-Team: German \n" "Language: de\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n != 1;\n" -"X-Generator: Weblate 5.5-dev\n" +"X-Generator: Weblate 5.8-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" -msgstr "Zu diesem Leitfaden beitragen" +msgstr "Zu diesem Handbuch beitragen" #: ../source/contribute.rst:7 msgid "" @@ -1596,51 +1597,47 @@ msgid "``egg_info``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:144 -msgid "``install``" -msgstr "" - -#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_data``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:146 +#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_egg_info``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:147 +#: ../source/discussions/setup-py-deprecated.rst:146 #, fuzzy msgid "``install_headers``" msgstr "Betreuer" -#: ../source/discussions/setup-py-deprecated.rst:148 +#: ../source/discussions/setup-py-deprecated.rst:147 msgid "``install_lib``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:149 +#: ../source/discussions/setup-py-deprecated.rst:148 msgid "``install_scripts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:150 +#: ../source/discussions/setup-py-deprecated.rst:149 msgid "``rotate``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:151 +#: ../source/discussions/setup-py-deprecated.rst:150 msgid "``saveopts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:152 +#: ../source/discussions/setup-py-deprecated.rst:151 msgid "``setopt``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:153 +#: ../source/discussions/setup-py-deprecated.rst:152 msgid "``upload_docs``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:157 +#: ../source/discussions/setup-py-deprecated.rst:156 msgid "What about custom commands?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:159 +#: ../source/discussions/setup-py-deprecated.rst:158 msgid "" "Likewise, custom :file:`setup.py` commands are deprecated. The " "recommendation is to migrate those custom commands to a task runner tool or " @@ -1648,46 +1645,46 @@ msgid "" "tox, pydoit, pyinvoke, taskipy, and thx." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:167 +#: ../source/discussions/setup-py-deprecated.rst:166 msgid "What about custom build steps?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:169 +#: ../source/discussions/setup-py-deprecated.rst:168 msgid "" "Custom build steps that for example either overwrite existing steps such as " "``build_py``, ``build_ext``, and ``bdist_wheel`` or add new build steps are " "not deprecated. Those will be automatically called as expected." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:176 +#: ../source/discussions/setup-py-deprecated.rst:175 #: ../source/guides/modernize-setup-py-project.rst:21 msgid "Should ``setup.py`` be deleted?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:178 +#: ../source/discussions/setup-py-deprecated.rst:177 msgid "" "Although the usage of :file:`setup.py` as an executable script is " "deprecated, its usage as a configuration file for setuptools is absolutely " "fine. There is likely no modification needed in :file:`setup.py`." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:184 +#: ../source/discussions/setup-py-deprecated.rst:183 msgid "Is ``pyproject.toml`` mandatory?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:186 +#: ../source/discussions/setup-py-deprecated.rst:185 msgid "" "While it is not technically necessary yet, it is **STRONGLY RECOMMENDED** " "for a project to have a :file:`pyproject.toml` file at the root of its " "source tree with a content like this:" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:197 +#: ../source/discussions/setup-py-deprecated.rst:196 msgid "" "The guide :ref:`modernize-setup-py-project` has more details about this." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:199 +#: ../source/discussions/setup-py-deprecated.rst:198 msgid "" "The standard fallback behavior for a :term:`build frontend ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1695,26 +1692,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -2467,7 +2464,7 @@ msgstr "" #: ../source/glossary.rst:8 msgid "Binary Distribution" -msgstr "" +msgstr "Binärdistribution" #: ../source/glossary.rst:11 msgid "" @@ -2513,7 +2510,7 @@ msgstr "" #: ../source/glossary.rst:44 msgid "Built Distribution" -msgstr "" +msgstr "Gebaute Distribution" #: ../source/glossary.rst:47 msgid "" @@ -2574,7 +2571,6 @@ msgid "" msgstr "" #: ../source/glossary.rst:89 -#, fuzzy msgid "Distribution Package" msgstr "Distributionspaket" @@ -2962,7 +2958,7 @@ msgstr "" #: ../source/glossary.rst:344 msgid "Version Specifier" -msgstr "" +msgstr "Spezifikation der Version" #: ../source/glossary.rst:347 msgid "" @@ -12304,7 +12300,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12409,7 +12405,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12444,10 +12440,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12546,14 +12542,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12827,7 +12825,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12837,11 +12847,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12849,43 +12881,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12893,64 +12932,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12958,13 +12997,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12972,36 +13011,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -13010,13 +13049,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -13024,20 +13063,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -13045,7 +13084,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13055,11 +13094,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13067,7 +13106,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13077,18 +13116,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13097,7 +13136,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13108,63 +13147,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13175,33 +13214,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13210,77 +13249,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/eo/LC_MESSAGES/messages.po b/locales/eo/LC_MESSAGES/messages.po index 07dbac72d..ba3df51a7 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2021-08-06 05:45+0000\n" "Last-Translator: meowmeowmeowcat \n" "Language-Team: Esperanto ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1715,26 +1710,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12613,7 +12608,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12718,7 +12713,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12753,10 +12748,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12855,14 +12850,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -13136,7 +13133,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -13146,11 +13155,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -13158,43 +13189,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -13202,64 +13240,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -13267,13 +13305,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -13281,36 +13319,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -13319,13 +13357,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -13333,20 +13371,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -13354,7 +13392,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13364,11 +13402,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "Malofte uzataj kampoj" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13376,7 +13414,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13386,18 +13424,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13406,7 +13444,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13417,67 +13455,67 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 #, fuzzy #| msgid "Rarely Used Fields" msgid "Deprecated Fields" msgstr "Malofte uzataj kampoj" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 #, fuzzy #| msgid "Requirements files" msgid "Requires" msgstr "Dosiero requirements.txt" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13488,33 +13526,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13523,78 +13561,90 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 #, fuzzy msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "Marklingvo reStructuredText: http://docutils.sourceforge.net/" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" @@ -21998,6 +22048,10 @@ msgid "" "the file is empty)." msgstr "" +#, fuzzy +#~ msgid "``install``" +#~ msgstr "Uzi ``pip`` por instali Pipenv:" + #, fuzzy #~| msgid "Examples" #~ msgid "Examples:" diff --git a/locales/es/LC_MESSAGES/messages.po b/locales/es/LC_MESSAGES/messages.po index 7d20c88ad..2e23c18c8 100644 --- a/locales/es/LC_MESSAGES/messages.po +++ b/locales/es/LC_MESSAGES/messages.po @@ -15,8 +15,8 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-08-24 00:21+0000\n" -"PO-Revision-Date: 2024-07-29 09:35+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" +"PO-Revision-Date: 2024-09-17 19:22+0000\n" "Last-Translator: gallegonovato \n" "Language-Team: Spanish \n" @@ -25,7 +25,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n != 1;\n" -"X-Generator: Weblate 5.7-dev\n" +"X-Generator: Weblate 5.8-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" @@ -110,7 +110,7 @@ msgstr "" "Los tutoriales se centran en enseñar al lector nuevos conceptos mediante la " "consecución de un objetivo. Son guías paso a paso basadas en opiniones. No " "incluyen advertencias ni información superflua. `ejemplo de documento estilo " -"tutorial `_." +"tutorial`_." #: ../source/contribute.rst:51 ../source/guides/index.rst:2 #: ../source/index.rst:69 @@ -1085,9 +1085,8 @@ msgid "" msgstr "" #: ../source/discussions/package-formats.rst:21 -#, fuzzy msgid "What is a source distribution?" -msgstr "Paquete de Distribución" +msgstr "¿Qué es una distribución de origen?" #: ../source/discussions/package-formats.rst:23 msgid "" @@ -1647,19 +1646,16 @@ msgid "A trusted replacement is :ref:`twine`:" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:103 -#, fuzzy msgid "``python -m twine check --strict dist/*``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``python -m twine check --strict dist/*``" #: ../source/discussions/setup-py-deprecated.rst:104 -#, fuzzy msgid "``python -m twine register dist/*.whl`` [#not-pypi]_" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``python -m twine register dist/*.whl`` [#not-pypi]_" #: ../source/discussions/setup-py-deprecated.rst:105 -#, fuzzy msgid "``python -m twine upload dist/*``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``python -m twine upload dist/*``" #: ../source/discussions/setup-py-deprecated.rst:107 msgid "" @@ -1679,9 +1675,8 @@ msgid "" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:116 -#, fuzzy msgid "``python -m setuptools_scm``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``python -m setuptools_scm``" #: ../source/discussions/setup-py-deprecated.rst:122 msgid "Remaining commands" @@ -1714,9 +1709,8 @@ msgid "``bdist_rpm``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:134 -#, fuzzy msgid "``build``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``build``" #: ../source/discussions/setup-py-deprecated.rst:135 msgid "``build_clib``" @@ -1743,9 +1737,8 @@ msgid "``dist_info``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:141 -#, fuzzy msgid "``easy_install``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``easy_install``" #: ../source/discussions/setup-py-deprecated.rst:142 msgid "``editable_wheel``" @@ -1756,55 +1749,46 @@ msgid "``egg_info``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:144 -#, fuzzy -msgid "``install``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" - -#: ../source/discussions/setup-py-deprecated.rst:145 -#, fuzzy msgid "``install_data``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``install_data``" -#: ../source/discussions/setup-py-deprecated.rst:146 -#, fuzzy +#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_egg_info``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``install_egg_info``" -#: ../source/discussions/setup-py-deprecated.rst:147 -#, fuzzy +#: ../source/discussions/setup-py-deprecated.rst:146 msgid "``install_headers``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``install_headers``" -#: ../source/discussions/setup-py-deprecated.rst:148 -#, fuzzy +#: ../source/discussions/setup-py-deprecated.rst:147 msgid "``install_lib``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``install_lib``" -#: ../source/discussions/setup-py-deprecated.rst:149 +#: ../source/discussions/setup-py-deprecated.rst:148 msgid "``install_scripts``" msgstr "``install_scripts``" -#: ../source/discussions/setup-py-deprecated.rst:150 +#: ../source/discussions/setup-py-deprecated.rst:149 msgid "``rotate``" msgstr "``rotate``" -#: ../source/discussions/setup-py-deprecated.rst:151 +#: ../source/discussions/setup-py-deprecated.rst:150 msgid "``saveopts``" msgstr "``saveopts``" -#: ../source/discussions/setup-py-deprecated.rst:152 +#: ../source/discussions/setup-py-deprecated.rst:151 msgid "``setopt``" msgstr "``setopt``" -#: ../source/discussions/setup-py-deprecated.rst:153 +#: ../source/discussions/setup-py-deprecated.rst:152 msgid "``upload_docs``" msgstr "``upload_docs``" -#: ../source/discussions/setup-py-deprecated.rst:157 +#: ../source/discussions/setup-py-deprecated.rst:156 msgid "What about custom commands?" msgstr "¿Qué pasa con los comandos personalizados?" -#: ../source/discussions/setup-py-deprecated.rst:159 +#: ../source/discussions/setup-py-deprecated.rst:158 msgid "" "Likewise, custom :file:`setup.py` commands are deprecated. The " "recommendation is to migrate those custom commands to a task runner tool or " @@ -1817,46 +1801,46 @@ msgstr "" "Algunos ejemplos de estas herramientas son: chuy, make, nox o tox, pydoit, " "pyinvoke, taskipy, y thx." -#: ../source/discussions/setup-py-deprecated.rst:167 +#: ../source/discussions/setup-py-deprecated.rst:166 msgid "What about custom build steps?" msgstr "¿Qué pasa con los pasos de construcción personalizados?" -#: ../source/discussions/setup-py-deprecated.rst:169 +#: ../source/discussions/setup-py-deprecated.rst:168 msgid "" "Custom build steps that for example either overwrite existing steps such as " "``build_py``, ``build_ext``, and ``bdist_wheel`` or add new build steps are " "not deprecated. Those will be automatically called as expected." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:176 +#: ../source/discussions/setup-py-deprecated.rst:175 #: ../source/guides/modernize-setup-py-project.rst:21 msgid "Should ``setup.py`` be deleted?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:178 +#: ../source/discussions/setup-py-deprecated.rst:177 msgid "" "Although the usage of :file:`setup.py` as an executable script is " "deprecated, its usage as a configuration file for setuptools is absolutely " "fine. There is likely no modification needed in :file:`setup.py`." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:184 +#: ../source/discussions/setup-py-deprecated.rst:183 msgid "Is ``pyproject.toml`` mandatory?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:186 +#: ../source/discussions/setup-py-deprecated.rst:185 msgid "" "While it is not technically necessary yet, it is **STRONGLY RECOMMENDED** " "for a project to have a :file:`pyproject.toml` file at the root of its " "source tree with a content like this:" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:197 +#: ../source/discussions/setup-py-deprecated.rst:196 msgid "" "The guide :ref:`modernize-setup-py-project` has more details about this." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:199 +#: ../source/discussions/setup-py-deprecated.rst:198 msgid "" "The standard fallback behavior for a :term:`build frontend ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1864,26 +1848,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -5922,9 +5906,8 @@ msgid "" msgstr "" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:239 -#, fuzzy msgid "Install a specific package version" -msgstr "Para instalar una versión específica:" +msgstr "Instalar una versión específica del paquete" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:241 msgid "" @@ -6581,9 +6564,8 @@ msgid "``python -m build --no-isolation``" msgstr "``python -m build --no-isolation``" #: ../source/guides/modernize-setup-py-project.rst:127 -#, fuzzy msgid "``python -m pip install --no-build-isolation``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``python -m pip install --no-build-isolation``" #: ../source/guides/modernize-setup-py-project.rst:135 msgid "How to handle packaging metadata?" @@ -9253,9 +9235,8 @@ msgid "See the :ref:`Plugin guide ` for more information." msgstr "" #: ../source/guides/writing-pyproject-toml.rst:441 -#, fuzzy msgid "A full example" -msgstr "Por ejemplo:" +msgstr "Ejemplo completo" #: ../source/guides/writing-pyproject-toml.rst:503 msgid "" @@ -12547,7 +12528,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12652,7 +12633,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12687,10 +12668,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12789,14 +12770,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -13070,7 +13053,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -13080,11 +13075,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -13092,43 +13109,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -13136,64 +13160,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -13201,13 +13225,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -13215,36 +13239,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -13253,13 +13277,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -13267,20 +13291,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -13288,7 +13312,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13298,11 +13322,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13310,7 +13334,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13320,18 +13344,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13340,7 +13364,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13351,64 +13375,64 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 #, fuzzy msgid "Requires" msgstr "Archivo de requisitos" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13419,33 +13443,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13454,77 +13478,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" @@ -14829,9 +14865,8 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:102 -#, fuzzy msgid "Python-specific package manager" -msgstr "Para instalar una versión específica:" +msgstr "Gestor de paquetes específico de Python" #: ../source/specifications/externally-managed-environments.rst:82 msgid "" @@ -14896,9 +14931,8 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:132 -#, fuzzy msgid "This specification is twofold." -msgstr "Especificaciones de PyPA" +msgstr "Esta especificación tiene dos partes." #: ../source/specifications/externally-managed-environments.rst:134 msgid "" @@ -15244,9 +15278,8 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:422 -#, fuzzy msgid "``pip install``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``pip install``" #: ../source/specifications/externally-managed-environments.rst:420 msgid "" @@ -15256,18 +15289,16 @@ msgid "" msgstr "" #: ../source/specifications/externally-managed-environments.rst:425 -#, fuzzy msgid "``pip install --prefix=/some/path``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``pip install --prefix=/some/path``" #: ../source/specifications/externally-managed-environments.rst:425 msgid "Calls ``sysconfig.get_preferred_scheme('prefix')``." msgstr "" #: ../source/specifications/externally-managed-environments.rst:428 -#, fuzzy msgid "``pip install --user``" -msgstr "Sírvase de ``pip`` para instalar Sphinx:" +msgstr "``pip install --user``" #: ../source/specifications/externally-managed-environments.rst:428 msgid "Calls ``sysconfig.get_preferred_scheme('user')``." @@ -21910,6 +21941,9 @@ msgid "" "the file is empty)." msgstr "" +#~ msgid "``install``" +#~ msgstr "``install``" + #, fuzzy #~ msgid "Examples:" #~ msgstr "Ejemplos" diff --git a/locales/fa/LC_MESSAGES/messages.po b/locales/fa/LC_MESSAGES/messages.po index 14f8e9b17..3b9db396f 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2023-02-15 07:52+0000\n" "Last-Translator: Arsalan Dehghani \n" "Language-Team: Persian ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1655,26 +1651,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12265,7 +12261,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12370,7 +12366,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12405,10 +12401,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12507,14 +12503,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12788,7 +12786,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12798,11 +12808,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12810,43 +12842,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12854,64 +12893,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12919,13 +12958,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12933,36 +12972,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12971,13 +13010,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12985,20 +13024,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -13006,7 +13045,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13016,11 +13055,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13028,7 +13067,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13038,18 +13077,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13058,7 +13097,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13069,63 +13108,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13136,33 +13175,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13171,77 +13210,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/fil/LC_MESSAGES/messages.po b/locales/fil/LC_MESSAGES/messages.po index f9df9f9c4..09abff879 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2022-11-19 08:28+0000\n" "Last-Translator: RedFurrFox \n" "Language-Team: Filipino ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1657,26 +1653,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12245,7 +12241,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12350,7 +12346,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12385,10 +12381,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12487,14 +12483,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12768,7 +12766,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12778,11 +12788,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12790,43 +12822,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12834,64 +12873,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12899,13 +12938,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12913,36 +12952,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12951,13 +12990,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12965,20 +13004,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -12986,7 +13025,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -12996,11 +13035,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13008,7 +13047,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13018,18 +13057,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13038,7 +13077,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13049,63 +13088,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13116,33 +13155,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13151,77 +13190,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/fr/LC_MESSAGES/messages.po b/locales/fr/LC_MESSAGES/messages.po index acfa194fd..dc2bdbdef 100644 --- a/locales/fr/LC_MESSAGES/messages.po +++ b/locales/fr/LC_MESSAGES/messages.po @@ -5,21 +5,22 @@ # Abdur-Rahmaan Janhangeer , 2021. # Matthieu Darbois , 2022. # Rafael Fontenelle , 2024. +# Pierre PETAT , 2024. msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-08-24 00:21+0000\n" -"PO-Revision-Date: 2024-04-25 06:07+0000\n" -"Last-Translator: Rafael Fontenelle \n" -"Language-Team: French \n" +"POT-Creation-Date: 2024-09-19 12:53+0000\n" +"PO-Revision-Date: 2024-09-21 00:40+0000\n" +"Last-Translator: Pierre PETAT \n" +"Language-Team: French \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n > 1;\n" -"X-Generator: Weblate 5.5.1-dev\n" +"X-Generator: Weblate 5.8-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" @@ -79,10 +80,6 @@ msgstr "Types de documentation" #: ../source/contribute.rst:34 #, fuzzy -#| msgid "" -#| "This project consists of four distinct documentation types with specific " -#| "purposes. When proposing new additions to the project please pick the " -#| "appropriate documentation type." msgid "" "This project consists of four distinct documentation types with specific " "purposes. The project aspires to follow the `Diátaxis process`_ for creating " @@ -161,11 +158,15 @@ msgid "" "If you are experiencing issues while you are working on translations, please " "open an issue on `GitHub`_." msgstr "" +"Si vous faites face a des problèmes lors de vos travaux de traductions, " +"veuillez ouvrir un ticket sur `GitHub`_." #: ../source/contribute.rst:85 msgid "" "Any translations of this project should follow `reStructuredText syntax`_." msgstr "" +"Chaque traduction sur ce projet doit suivre la syntax`reStructuredText " +"syntax`_." #: ../source/contribute.rst:93 msgid "Adding a language" @@ -230,11 +231,6 @@ msgstr "" #: ../source/contribute.rst:137 #, fuzzy -#| msgid "" -#| "Python 3.8. Our build scripts are usually tested with Python 3.8 only. " -#| "See the :doc:`Hitchhiker's Guide to Python installation instructions " -#| "` to install Python 3.8 on your " -#| "operating system." msgid "" "Python 3.11. Our build scripts are usually tested with Python 3.11 only. See " "the :doc:`Hitchhiker's Guide to Python installation instructions `. The tool is " -#| "released under the MIT-licence." msgid "" "A big advantage of Pynsist is that the Windows packages can be built on " "Linux. There are several examples for different kinds of programs (console, " @@ -757,7 +748,6 @@ msgstr "" #: ../source/discussions/distribution-package-vs-import-package.rst:13 #, fuzzy -#| msgid "Packaging and distributing projects" msgid "What's a distribution package?" msgstr "Paqueter et distribuer des projets" @@ -1012,7 +1002,6 @@ msgstr "" #: ../source/discussions/package-formats.rst:5 #, fuzzy -#| msgid "Package version" msgid "Package Formats" msgstr "Version du paquet" @@ -1036,7 +1025,6 @@ msgstr "" #: ../source/discussions/package-formats.rst:21 #, fuzzy -#| msgid "Packaging and distributing projects" msgid "What is a source distribution?" msgstr "Paqueter et distribuer des projets" @@ -1475,7 +1463,6 @@ msgstr "" #: ../source/discussions/setup-py-deprecated.rst:35 #: ../source/guides/modernize-setup-py-project.rst:32 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``python setup.py install``" msgstr "Oui (``python -m pip uninstall``)" @@ -1510,21 +1497,18 @@ msgstr "" #: ../source/discussions/setup-py-deprecated.rst:33 #: ../source/guides/modernize-setup-py-project.rst:30 #, fuzzy -#| msgid "Documentation types" msgid "Recommendation" msgstr "Types de documentation" #: ../source/discussions/setup-py-deprecated.rst:35 #: ../source/guides/modernize-setup-py-project.rst:32 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``python -m pip install .``" msgstr "Oui (``python -m pip uninstall``)" #: ../source/discussions/setup-py-deprecated.rst:37 #: ../source/guides/modernize-setup-py-project.rst:34 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``python -m pip install --editable .``" msgstr "Oui (``python -m pip uninstall``)" @@ -1605,19 +1589,16 @@ msgstr "" #: ../source/discussions/setup-py-deprecated.rst:103 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``python -m twine check --strict dist/*``" msgstr "Oui (``python -m pip uninstall``)" #: ../source/discussions/setup-py-deprecated.rst:104 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``python -m twine register dist/*.whl`` [#not-pypi]_" msgstr "Oui (``python -m pip uninstall``)" #: ../source/discussions/setup-py-deprecated.rst:105 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``python -m twine upload dist/*``" msgstr "Oui (``python -m pip uninstall``)" @@ -1640,7 +1621,6 @@ msgstr "" #: ../source/discussions/setup-py-deprecated.rst:116 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``python -m setuptools_scm``" msgstr "Oui (``python -m pip uninstall``)" @@ -1676,7 +1656,6 @@ msgstr "" #: ../source/discussions/setup-py-deprecated.rst:134 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``build``" msgstr "Oui (``python -m pip uninstall``)" @@ -1702,13 +1681,11 @@ msgstr "" #: ../source/discussions/setup-py-deprecated.rst:140 #, fuzzy -#| msgid "``pypinfo``" msgid "``dist_info``" msgstr "``pypinfo``" #: ../source/discussions/setup-py-deprecated.rst:141 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``easy_install``" msgstr "Oui (``python -m pip uninstall``)" @@ -1718,67 +1695,71 @@ msgstr "" #: ../source/discussions/setup-py-deprecated.rst:143 #, fuzzy -#| msgid "``pypinfo``" msgid "``egg_info``" msgstr "``pypinfo``" #: ../source/discussions/setup-py-deprecated.rst:144 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``install``" msgstr "Oui (``python -m pip uninstall``)" #: ../source/discussions/setup-py-deprecated.rst:145 +#: ../source/discussions/setup-py-deprecated.rst:144 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``install_data``" msgstr "Oui (``python -m pip uninstall``)" #: ../source/discussions/setup-py-deprecated.rst:146 +#: ../source/discussions/setup-py-deprecated.rst:145 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``install_egg_info``" msgstr "Oui (``python -m pip uninstall``)" #: ../source/discussions/setup-py-deprecated.rst:147 +#: ../source/discussions/setup-py-deprecated.rst:146 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``install_headers``" msgstr "Oui (``python -m pip uninstall``)" #: ../source/discussions/setup-py-deprecated.rst:148 +#: ../source/discussions/setup-py-deprecated.rst:147 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``install_lib``" msgstr "Oui (``python -m pip uninstall``)" #: ../source/discussions/setup-py-deprecated.rst:149 +#: ../source/discussions/setup-py-deprecated.rst:148 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``install_scripts``" msgstr "Oui (``python -m pip uninstall``)" #: ../source/discussions/setup-py-deprecated.rst:150 +#: ../source/discussions/setup-py-deprecated.rst:149 msgid "``rotate``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:151 +#: ../source/discussions/setup-py-deprecated.rst:150 msgid "``saveopts``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:152 +#: ../source/discussions/setup-py-deprecated.rst:151 msgid "``setopt``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:153 +#: ../source/discussions/setup-py-deprecated.rst:152 msgid "``upload_docs``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:157 +#: ../source/discussions/setup-py-deprecated.rst:156 msgid "What about custom commands?" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:159 +#: ../source/discussions/setup-py-deprecated.rst:158 msgid "" "Likewise, custom :file:`setup.py` commands are deprecated. The " "recommendation is to migrate those custom commands to a task runner tool or " @@ -1787,10 +1768,12 @@ msgid "" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:167 +#: ../source/discussions/setup-py-deprecated.rst:166 msgid "What about custom build steps?" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:169 +#: ../source/discussions/setup-py-deprecated.rst:168 msgid "" "Custom build steps that for example either overwrite existing steps such as " "``build_py``, ``build_ext``, and ``bdist_wheel`` or add new build steps are " @@ -1799,10 +1782,12 @@ msgstr "" #: ../source/discussions/setup-py-deprecated.rst:176 #: ../source/guides/modernize-setup-py-project.rst:21 +#: ../source/discussions/setup-py-deprecated.rst:175 msgid "Should ``setup.py`` be deleted?" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:178 +#: ../source/discussions/setup-py-deprecated.rst:177 msgid "" "Although the usage of :file:`setup.py` as an executable script is " "deprecated, its usage as a configuration file for setuptools is absolutely " @@ -1810,12 +1795,13 @@ msgid "" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:184 +#: ../source/discussions/setup-py-deprecated.rst:183 #, fuzzy -#| msgid "pyproject.toml" msgid "Is ``pyproject.toml`` mandatory?" msgstr "pyproject.toml" #: ../source/discussions/setup-py-deprecated.rst:186 +#: ../source/discussions/setup-py-deprecated.rst:185 msgid "" "While it is not technically necessary yet, it is **STRONGLY RECOMMENDED** " "for a project to have a :file:`pyproject.toml` file at the root of its " @@ -1823,11 +1809,13 @@ msgid "" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:197 +#: ../source/discussions/setup-py-deprecated.rst:196 msgid "" "The guide :ref:`modernize-setup-py-project` has more details about this." msgstr "" #: ../source/discussions/setup-py-deprecated.rst:199 +#: ../source/discussions/setup-py-deprecated.rst:198 msgid "" "The standard fallback behavior for a :term:`build frontend ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1836,10 +1824,12 @@ msgid "" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." @@ -1847,14 +1837,17 @@ msgstr "" #: ../source/discussions/setup-py-deprecated.rst:212 #: ../source/guides/modernize-setup-py-project.rst:244 +#: ../source/discussions/setup-py-deprecated.rst:211 msgid "Where to read more about this?" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -1864,13 +1857,11 @@ msgstr "" #: ../source/discussions/single-source-version.rst:7 #, fuzzy -#| msgid "Incomplete" msgid "Complete" msgstr "Incomplet" #: ../source/discussions/single-source-version.rst:8 #, fuzzy -#| msgid "2017-08-01" msgid "2024-08-24" msgstr "2017-08-01" @@ -2711,7 +2702,6 @@ msgstr "" #: ../source/glossary.rst:83 #, fuzzy -#| msgid "Built Distribution" msgid "Distribution Archive" msgstr "Distribution compilée" @@ -2802,7 +2792,6 @@ msgstr "" #: ../source/glossary.rst:142 #, fuzzy -#| msgid "Installer" msgid "Installed Project" msgstr "Installateur" @@ -2883,7 +2872,6 @@ msgstr "" #: ../source/glossary.rst:192 #, fuzzy -#| msgid "Project name" msgid "Project Root Directory" msgstr "Nom du projet" @@ -2930,7 +2918,6 @@ msgstr "" #: ../source/glossary.rst:226 #, fuzzy -#| msgid "Project name" msgid "Pyproject Metadata" msgstr "Nom du projet" @@ -2945,7 +2932,6 @@ msgstr "" #: ../source/glossary.rst:237 #, fuzzy -#| msgid "pyproject.toml" msgid "Pyproject Metadata Key" msgstr "pyproject.toml" @@ -3164,7 +3150,6 @@ msgstr "" #: ../source/glossary.rst:371 #, fuzzy -#| msgid "Project" msgid "Wheel Project" msgstr "Projet" @@ -3862,7 +3847,6 @@ msgstr "" #: ../source/guides/creating-command-line-tools.rst:5 #, fuzzy -#| msgid "Creating and discovering plugins" msgid "Creating and packaging command-line tools" msgstr "Créer et découvrir des extensions" @@ -3877,7 +3861,6 @@ msgstr "" #: ../source/guides/creating-command-line-tools.rst:12 #, fuzzy -#| msgid "Uninstall Packages" msgid "Creating the package" msgstr "Désinstaller des paquets" @@ -3956,7 +3939,6 @@ msgstr "" #: ../source/guides/creating-command-line-tools.rst:117 #, fuzzy -#| msgid "pyproject.toml" msgid "``pyproject.toml``" msgstr "pyproject.toml" @@ -3985,7 +3967,6 @@ msgstr "" #: ../source/guides/creating-command-line-tools.rst:134 #, fuzzy -#| msgid "Install `pypinfo`_ using pip." msgid "Installing the package with ``pipx``" msgstr "Installez `pypinfo`_ à l'aide de pip." @@ -4061,7 +4042,6 @@ msgstr "" #: ../source/guides/distributing-packages-using-setuptools.rst:8 #, fuzzy -#| msgid "2017-12-01" msgid "2023-12-14" msgstr "2017-12-01" @@ -4810,7 +4790,6 @@ msgstr "" #: ../source/guides/dropping-older-python-versions.rst:48 #, fuzzy -#| msgid "Installation format" msgid "1. Install twine" msgstr "Format d'installation" @@ -4897,7 +4876,6 @@ msgstr "" #: ../source/guides/dropping-older-python-versions.rst:120 #, fuzzy -#| msgid "Python version" msgid "Dropping a Python version" msgstr "Version de Python" @@ -4983,7 +4961,6 @@ msgstr "" #: ../source/guides/hosting-your-own-index.rst:63 #, fuzzy -#| msgid "Package version" msgid "Package upload" msgstr "Version du paquet" @@ -5136,7 +5113,6 @@ msgstr "" #: ../source/guides/index-mirrors-and-caches.rst:8 #, fuzzy -#| msgid "2017-12-01" msgid "2023-11-08" msgstr "2017-12-01" @@ -5706,7 +5682,6 @@ msgstr "" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:11 #, fuzzy -#| msgid "install_requires vs requirements files" msgid "Use and create a requirements file" msgstr "Fichiers requirements vs install_requires" @@ -5783,7 +5758,6 @@ msgstr "" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:74 #, fuzzy -#| msgid "Virtual Environment" msgid "Activate a virtual environment" msgstr "Environnement virtuel" @@ -5816,7 +5790,6 @@ msgstr "" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:130 #, fuzzy -#| msgid "Virtual Environment" msgid "Deactivate a virtual environment" msgstr "Environnement virtuel" @@ -5834,7 +5807,6 @@ msgstr "" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:145 #, fuzzy -#| msgid "Virtual Environment" msgid "Reactivate a virtual environment" msgstr "Environnement virtuel" @@ -5876,7 +5848,6 @@ msgstr "" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:195 #, fuzzy -#| msgid "Install `pypinfo`_ using pip." msgid "Install packages using pip" msgstr "Installez `pypinfo`_ à l'aide de pip." @@ -5888,7 +5859,6 @@ msgstr "" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:201 #, fuzzy -#| msgid "Uninstall Packages" msgid "Install a package" msgstr "Désinstaller des paquets" @@ -6021,7 +5991,6 @@ msgstr "" #: ../source/guides/installing-using-pip-and-virtual-environments.rst:452 #, fuzzy -#| msgid "install_requires vs requirements files" msgid "Using a requirements file" msgstr "Fichiers requirements vs install_requires" @@ -6432,7 +6401,6 @@ msgstr "" #: ../source/guides/modernize-setup-py-project.rst:10 #, fuzzy -#| msgid "pyproject.toml" msgid "Should ``pyproject.toml`` be added?" msgstr "pyproject.toml" @@ -6460,7 +6428,6 @@ msgstr "" #: ../source/guides/modernize-setup-py-project.rst:36 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``python -m build``" msgstr "Oui (``python -m pip uninstall``)" @@ -6501,7 +6468,6 @@ msgstr "" #: ../source/guides/modernize-setup-py-project.rst:68 #, fuzzy -#| msgid "Packaging and distributing projects" msgid ":ref:`distributing-packages`" msgstr "Paqueter et distribuer des projets" @@ -6560,19 +6526,16 @@ msgstr "" #: ../source/guides/modernize-setup-py-project.rst:126 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``python -m build --no-isolation``" msgstr "Oui (``python -m pip uninstall``)" #: ../source/guides/modernize-setup-py-project.rst:127 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``python -m pip install --no-build-isolation``" msgstr "Oui (``python -m pip uninstall``)" #: ../source/guides/modernize-setup-py-project.rst:135 #, fuzzy -#| msgid "Using package metadata" msgid "How to handle packaging metadata?" msgstr "En utilisant les métadonnées du paquet" @@ -6629,7 +6592,6 @@ msgstr "" #: ../source/guides/modernize-setup-py-project.rst:246 #, fuzzy -#| msgid "pyproject.toml" msgid ":ref:`pyproject-toml-spec`" msgstr "pyproject.toml" @@ -7016,7 +6978,6 @@ msgstr "" #: ../source/guides/packaging-binary-extensions.rst:236 #, fuzzy -#| msgid "Extension Module" msgid "Extension module lifecycle" msgstr "Module d'extension" @@ -7694,7 +7655,6 @@ msgstr "" #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:163 #, fuzzy -#| msgid "Packaging and distributing projects" msgid "Signing the distribution packages" msgstr "Paqueter et distribuer des projets" @@ -7799,7 +7759,6 @@ msgstr "" #: ../source/guides/section-install.rst:3 #, fuzzy -#| msgid "Installation format" msgid "Installation" msgstr "Format d'installation" @@ -8469,7 +8428,6 @@ msgstr "" #: ../source/guides/tool-recommendations.rst:20 #, fuzzy -#| msgid "Virtual Environment" msgid "Virtual environments" msgstr "Environnement virtuel" @@ -8482,7 +8440,6 @@ msgstr "" #: ../source/guides/tool-recommendations.rst:28 #, fuzzy -#| msgid "Uninstall Packages" msgid "Installing packages" msgstr "Désinstaller des paquets" @@ -8652,7 +8609,6 @@ msgstr "" #: ../source/guides/tool-recommendations.rst:123 #, fuzzy -#| msgid "Built Distribution" msgid "Building distributions" msgstr "Distribution compilée" @@ -8827,7 +8783,6 @@ msgstr "" #: ../source/guides/writing-pyproject-toml.rst:5 #, fuzzy -#| msgid "pyproject.toml" msgid "Writing your ``pyproject.toml``" msgstr "pyproject.toml" @@ -8980,7 +8935,6 @@ msgstr "" #: ../source/guides/writing-pyproject-toml.rst:147 #, fuzzy -#| msgid "Configuring your project" msgid "Put the version of your project." msgstr "Configurer votre projet" @@ -9004,7 +8958,6 @@ msgstr "" #: ../source/guides/writing-pyproject-toml.rst:171 #, fuzzy -#| msgid "install_requires vs requirements files" msgid "Dependencies and requirements" msgstr "Fichiers requirements vs install_requires" @@ -9088,7 +9041,6 @@ msgstr "" #: ../source/guides/writing-pyproject-toml.rst:260 #, fuzzy -#| msgid "Configuring your project" msgid "About your project" msgstr "Configurer votre projet" @@ -9191,9 +9143,6 @@ msgstr "" #: ../source/guides/writing-pyproject-toml.rst:366 #, fuzzy -#| msgid "" -#| "Provide a list of classifiers that categorize your project. For a full " -#| "listing, see https://pypi.org/classifiers/." msgid "" "A list of PyPI classifiers that apply to your project. Check the `full list " "of possibilities `_." @@ -9293,7 +9242,6 @@ msgstr "" #: ../source/index.rst:36 #, fuzzy -#| msgid "Overview" msgid "Overview and Flow" msgstr "Aperçu" @@ -9369,7 +9317,6 @@ msgstr "" #: ../source/index.rst:85 #, fuzzy -#| msgid "Deploying Python applications" msgid ":doc:`discussions/deploying-python-applications`" msgstr "Déployer des applications Python" @@ -9379,7 +9326,6 @@ msgstr "" #: ../source/index.rst:89 #, fuzzy -#| msgid "References" msgid "Reference" msgstr "Références" @@ -10227,7 +10173,6 @@ msgstr "" #: ../source/key_projects.rst:661 #, fuzzy -#| msgid "python" msgid "Pulp-python" msgstr "python" @@ -11877,7 +11822,7 @@ msgstr "" #: ../source/specifications/binary-distribution-format.rst:22 msgid "Details" -msgstr "" +msgstr "Détails" #: ../source/specifications/binary-distribution-format.rst:25 msgid "Installing a wheel 'distribution-1.0-py32-none-any.whl'" @@ -12543,7 +12488,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12648,7 +12593,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12683,10 +12628,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12785,14 +12730,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -13066,7 +13013,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -13076,11 +13035,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -13088,43 +13069,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -13132,64 +13120,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -13197,13 +13185,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -13211,36 +13199,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -13249,13 +13237,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -13263,20 +13251,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -13284,7 +13272,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13294,11 +13282,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13306,7 +13294,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13316,18 +13304,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13336,7 +13324,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13347,63 +13335,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13414,33 +13402,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13449,77 +13437,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" @@ -14795,7 +14795,6 @@ msgstr "" #: ../source/specifications/externally-managed-environments.rst:79 #, fuzzy -#| msgid "``packages``" msgid "package" msgstr "``packages``" @@ -15068,7 +15067,6 @@ msgstr "" #: ../source/specifications/externally-managed-environments.rst:283 #, fuzzy -#| msgid "Virtual Environment" msgid "Guide users towards virtual environments" msgstr "Environnement virtuel" @@ -15221,7 +15219,6 @@ msgstr "" #: ../source/specifications/externally-managed-environments.rst:410 #, fuzzy -#| msgid "Documentation types" msgid "Implementation Notes" msgstr "Types de documentation" @@ -15240,7 +15237,6 @@ msgstr "" #: ../source/specifications/externally-managed-environments.rst:422 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``pip install``" msgstr "Oui (``python -m pip uninstall``)" @@ -15261,7 +15257,6 @@ msgstr "" #: ../source/specifications/externally-managed-environments.rst:428 #, fuzzy -#| msgid "Yes (``python -m pip uninstall``)" msgid "``pip install --user``" msgstr "Oui (``python -m pip uninstall``)" @@ -15473,7 +15468,6 @@ msgstr "" #: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy -#| msgid "Documentation types" msgid "Reference Implementation" msgstr "Types de documentation" @@ -16325,7 +16319,6 @@ msgstr "" #: ../source/specifications/pyproject-toml.rst:6 #, fuzzy -#| msgid "pyproject.toml" msgid "``pyproject.toml`` specification" msgstr "pyproject.toml" @@ -17264,7 +17257,6 @@ msgstr "" #: ../source/specifications/section-installation-metadata.rst:3 #, fuzzy -#| msgid "Installation format" msgid "Package Installation Metadata" msgstr "Format d'installation" @@ -17450,7 +17442,6 @@ msgstr "" #: ../source/specifications/simple-repository-api.rst:138 #, fuzzy -#| msgid "Installer" msgid "Installers" msgstr "Installateur" @@ -17601,7 +17592,6 @@ msgstr "" #: ../source/specifications/simple-repository-api.rst:237 #: ../source/specifications/simple-repository-api.rst:957 #, fuzzy -#| msgid "Contents" msgid "Clients" msgstr "Contenu" @@ -17822,7 +17812,6 @@ msgstr "" #: ../source/specifications/simple-repository-api.rst:385 #, fuzzy -#| msgid "Project" msgid "Project List" msgstr "Projet" @@ -17873,7 +17862,6 @@ msgstr "" #: ../source/specifications/simple-repository-api.rst:429 #, fuzzy -#| msgid "Project name" msgid "Project Detail" msgstr "Nom du projet" @@ -18014,7 +18002,6 @@ msgstr "" #: ../source/specifications/simple-repository-api.rst:538 #, fuzzy -#| msgid "Contents" msgid "Content-Types" msgstr "Contenu" @@ -18559,7 +18546,6 @@ msgstr "" #: ../source/specifications/simple-repository-api.rst:911 #, fuzzy -#| msgid "Additional tools" msgid "Additional file information" msgstr "Outils supplémentaires" @@ -18954,7 +18940,6 @@ msgstr "" #: ../source/specifications/version-specifiers.rst:15 #, fuzzy -#| msgid "Specifications" msgid "Definitions" msgstr "Spécifications" @@ -19280,7 +19265,6 @@ msgstr "" #: ../source/specifications/version-specifiers.rst:241 #, fuzzy -#| msgid "Release" msgid "Pre-releases" msgstr "Version" @@ -19330,7 +19314,6 @@ msgstr "" #: ../source/specifications/version-specifiers.rst:273 #, fuzzy -#| msgid "Release" msgid "Post-releases" msgstr "Version" @@ -20364,7 +20347,6 @@ msgstr "" #: ../source/specifications/version-specifiers.rst:1081 #, fuzzy -#| msgid "References" msgid "Direct references" msgstr "Références" @@ -21900,7 +21882,6 @@ msgid "" msgstr "" #, fuzzy -#~| msgid "Examples" #~ msgid "Examples:" #~ msgstr "Exemples" diff --git a/locales/frc/LC_MESSAGES/messages.po b/locales/frc/LC_MESSAGES/messages.po index cc5a3494d..8dc6bbb97 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1553,50 +1553,46 @@ msgid "``egg_info``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:144 -msgid "``install``" -msgstr "" - -#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_data``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:146 +#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_egg_info``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:147 +#: ../source/discussions/setup-py-deprecated.rst:146 msgid "``install_headers``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:148 +#: ../source/discussions/setup-py-deprecated.rst:147 msgid "``install_lib``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:149 +#: ../source/discussions/setup-py-deprecated.rst:148 msgid "``install_scripts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:150 +#: ../source/discussions/setup-py-deprecated.rst:149 msgid "``rotate``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:151 +#: ../source/discussions/setup-py-deprecated.rst:150 msgid "``saveopts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:152 +#: ../source/discussions/setup-py-deprecated.rst:151 msgid "``setopt``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:153 +#: ../source/discussions/setup-py-deprecated.rst:152 msgid "``upload_docs``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:157 +#: ../source/discussions/setup-py-deprecated.rst:156 msgid "What about custom commands?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:159 +#: ../source/discussions/setup-py-deprecated.rst:158 msgid "" "Likewise, custom :file:`setup.py` commands are deprecated. The " "recommendation is to migrate those custom commands to a task runner tool or " @@ -1604,46 +1600,46 @@ msgid "" "tox, pydoit, pyinvoke, taskipy, and thx." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:167 +#: ../source/discussions/setup-py-deprecated.rst:166 msgid "What about custom build steps?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:169 +#: ../source/discussions/setup-py-deprecated.rst:168 msgid "" "Custom build steps that for example either overwrite existing steps such as " "``build_py``, ``build_ext``, and ``bdist_wheel`` or add new build steps are " "not deprecated. Those will be automatically called as expected." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:176 +#: ../source/discussions/setup-py-deprecated.rst:175 #: ../source/guides/modernize-setup-py-project.rst:21 msgid "Should ``setup.py`` be deleted?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:178 +#: ../source/discussions/setup-py-deprecated.rst:177 msgid "" "Although the usage of :file:`setup.py` as an executable script is " "deprecated, its usage as a configuration file for setuptools is absolutely " "fine. There is likely no modification needed in :file:`setup.py`." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:184 +#: ../source/discussions/setup-py-deprecated.rst:183 msgid "Is ``pyproject.toml`` mandatory?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:186 +#: ../source/discussions/setup-py-deprecated.rst:185 msgid "" "While it is not technically necessary yet, it is **STRONGLY RECOMMENDED** " "for a project to have a :file:`pyproject.toml` file at the root of its " "source tree with a content like this:" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:197 +#: ../source/discussions/setup-py-deprecated.rst:196 msgid "" "The guide :ref:`modernize-setup-py-project` has more details about this." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:199 +#: ../source/discussions/setup-py-deprecated.rst:198 msgid "" "The standard fallback behavior for a :term:`build frontend ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1651,26 +1647,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12239,7 +12235,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12344,7 +12340,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12379,10 +12375,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12481,14 +12477,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12762,7 +12760,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12772,11 +12782,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12784,43 +12816,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12828,64 +12867,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12893,13 +12932,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12907,36 +12946,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12945,13 +12984,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12959,20 +12998,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -12980,7 +13019,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -12990,11 +13029,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13002,7 +13041,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13012,18 +13051,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13032,7 +13071,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13043,63 +13082,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13110,33 +13149,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13145,77 +13184,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/gl/LC_MESSAGES/messages.po b/locales/gl/LC_MESSAGES/messages.po index bbfe3699d..bdd6c1af2 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1553,50 +1553,46 @@ msgid "``egg_info``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:144 -msgid "``install``" -msgstr "" - -#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_data``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:146 +#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_egg_info``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:147 +#: ../source/discussions/setup-py-deprecated.rst:146 msgid "``install_headers``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:148 +#: ../source/discussions/setup-py-deprecated.rst:147 msgid "``install_lib``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:149 +#: ../source/discussions/setup-py-deprecated.rst:148 msgid "``install_scripts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:150 +#: ../source/discussions/setup-py-deprecated.rst:149 msgid "``rotate``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:151 +#: ../source/discussions/setup-py-deprecated.rst:150 msgid "``saveopts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:152 +#: ../source/discussions/setup-py-deprecated.rst:151 msgid "``setopt``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:153 +#: ../source/discussions/setup-py-deprecated.rst:152 msgid "``upload_docs``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:157 +#: ../source/discussions/setup-py-deprecated.rst:156 msgid "What about custom commands?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:159 +#: ../source/discussions/setup-py-deprecated.rst:158 msgid "" "Likewise, custom :file:`setup.py` commands are deprecated. The " "recommendation is to migrate those custom commands to a task runner tool or " @@ -1604,46 +1600,46 @@ msgid "" "tox, pydoit, pyinvoke, taskipy, and thx." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:167 +#: ../source/discussions/setup-py-deprecated.rst:166 msgid "What about custom build steps?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:169 +#: ../source/discussions/setup-py-deprecated.rst:168 msgid "" "Custom build steps that for example either overwrite existing steps such as " "``build_py``, ``build_ext``, and ``bdist_wheel`` or add new build steps are " "not deprecated. Those will be automatically called as expected." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:176 +#: ../source/discussions/setup-py-deprecated.rst:175 #: ../source/guides/modernize-setup-py-project.rst:21 msgid "Should ``setup.py`` be deleted?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:178 +#: ../source/discussions/setup-py-deprecated.rst:177 msgid "" "Although the usage of :file:`setup.py` as an executable script is " "deprecated, its usage as a configuration file for setuptools is absolutely " "fine. There is likely no modification needed in :file:`setup.py`." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:184 +#: ../source/discussions/setup-py-deprecated.rst:183 msgid "Is ``pyproject.toml`` mandatory?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:186 +#: ../source/discussions/setup-py-deprecated.rst:185 msgid "" "While it is not technically necessary yet, it is **STRONGLY RECOMMENDED** " "for a project to have a :file:`pyproject.toml` file at the root of its " "source tree with a content like this:" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:197 +#: ../source/discussions/setup-py-deprecated.rst:196 msgid "" "The guide :ref:`modernize-setup-py-project` has more details about this." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:199 +#: ../source/discussions/setup-py-deprecated.rst:198 msgid "" "The standard fallback behavior for a :term:`build frontend ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1651,26 +1647,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12239,7 +12235,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12344,7 +12340,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12379,10 +12375,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12481,14 +12477,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12762,7 +12760,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12772,11 +12782,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12784,43 +12816,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12828,64 +12867,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12893,13 +12932,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12907,36 +12946,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12945,13 +12984,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12959,20 +12998,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -12980,7 +13019,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -12990,11 +13029,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13002,7 +13041,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13012,18 +13051,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13032,7 +13071,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13043,63 +13082,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13110,33 +13149,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13145,77 +13184,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/hi/LC_MESSAGES/messages.po b/locales/hi/LC_MESSAGES/messages.po index c2d650e28..95b9bd9d6 100644 --- a/locales/hi/LC_MESSAGES/messages.po +++ b/locales/hi/LC_MESSAGES/messages.po @@ -2,13 +2,14 @@ # Copyright (C) 2013–2020, PyPA # This file is distributed under the same license as the Python Packaging User Guide package. # Aryan 'Ba3a' Kumar , 2022. +# kumar Shivam , 2024. msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-08-24 00:21+0000\n" -"PO-Revision-Date: 2022-09-29 05:18+0000\n" -"Last-Translator: Aryan 'Ba3a' Kumar \n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" +"PO-Revision-Date: 2024-09-16 10:09+0000\n" +"Last-Translator: kumar Shivam \n" "Language-Team: Hindi \n" "Language: hi\n" @@ -16,37 +17,37 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n > 1;\n" -"X-Generator: Weblate 4.14.1\n" +"X-Generator: Weblate 5.8-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" -msgstr "" +msgstr "इस गाइड में योगदान करें" #: ../source/contribute.rst:7 msgid "" "The |PyPUG| welcomes contributors! There are lots of ways to help out, " "including:" -msgstr "" +msgstr "|पाइपयूजी| योगदानकर्ताओं का स्वागत है! मदद करने के कई तरीके हैं, जिनमें शामिल हैं:" #: ../source/contribute.rst:10 msgid "Reading the guide and giving feedback" -msgstr "" +msgstr "गाइड पढ़ना और प्रतिक्रिया देना" #: ../source/contribute.rst:11 msgid "Reviewing new contributions" -msgstr "" +msgstr "नए योगदानों की समीक्षा करना" #: ../source/contribute.rst:12 msgid "Revising existing content" -msgstr "" +msgstr "मौजूदा सामग्री को संशोधित करना" #: ../source/contribute.rst:13 msgid "Writing new content" -msgstr "" +msgstr "नई सामग्री लिखना" #: ../source/contribute.rst:14 msgid "Translate the guide" -msgstr "" +msgstr "मार्गदर्शक" #: ../source/contribute.rst:16 msgid "" @@ -55,16 +56,21 @@ msgid "" "`pull requests`__. If you're planning to write or edit the guide, please " "read the :ref:`style guide `." msgstr "" +"अधिकांश कार्य |PyPUG| पर `प्रोजेक्ट के GitHub रिपॉजिटरी`__ पर होता है। आरंभ करने के " +"लिए, `खुले मुद्दे`__ और `पुल अनुरोध`__ की सूची देखें। यदि आप गाइड लिखने या संपादित करने की " +"योजना बना रहे हैं, तो कृपया :ref:`स्टाइल गाइड ` पढ़ें।" #: ../source/contribute.rst:25 msgid "" "By contributing to the |PyPUG|, you're expected to follow the PSF's `Code of " "Conduct`__." msgstr "" +"|PyPUG| में योगदान देकर, आपसे PSF की `आचार संहिता`__ का पालन करने की अपेक्षा की जाती " +"है।" #: ../source/contribute.rst:32 msgid "Documentation types" -msgstr "" +msgstr "दस्तावेज़ीकरण प्रकार" #: ../source/contribute.rst:34 msgid "" @@ -1563,50 +1569,46 @@ msgid "``egg_info``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:144 -msgid "``install``" -msgstr "" - -#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_data``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:146 +#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_egg_info``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:147 +#: ../source/discussions/setup-py-deprecated.rst:146 msgid "``install_headers``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:148 +#: ../source/discussions/setup-py-deprecated.rst:147 msgid "``install_lib``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:149 +#: ../source/discussions/setup-py-deprecated.rst:148 msgid "``install_scripts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:150 +#: ../source/discussions/setup-py-deprecated.rst:149 msgid "``rotate``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:151 +#: ../source/discussions/setup-py-deprecated.rst:150 msgid "``saveopts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:152 +#: ../source/discussions/setup-py-deprecated.rst:151 msgid "``setopt``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:153 +#: ../source/discussions/setup-py-deprecated.rst:152 msgid "``upload_docs``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:157 +#: ../source/discussions/setup-py-deprecated.rst:156 msgid "What about custom commands?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:159 +#: ../source/discussions/setup-py-deprecated.rst:158 msgid "" "Likewise, custom :file:`setup.py` commands are deprecated. The " "recommendation is to migrate those custom commands to a task runner tool or " @@ -1614,46 +1616,46 @@ msgid "" "tox, pydoit, pyinvoke, taskipy, and thx." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:167 +#: ../source/discussions/setup-py-deprecated.rst:166 msgid "What about custom build steps?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:169 +#: ../source/discussions/setup-py-deprecated.rst:168 msgid "" "Custom build steps that for example either overwrite existing steps such as " "``build_py``, ``build_ext``, and ``bdist_wheel`` or add new build steps are " "not deprecated. Those will be automatically called as expected." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:176 +#: ../source/discussions/setup-py-deprecated.rst:175 #: ../source/guides/modernize-setup-py-project.rst:21 msgid "Should ``setup.py`` be deleted?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:178 +#: ../source/discussions/setup-py-deprecated.rst:177 msgid "" "Although the usage of :file:`setup.py` as an executable script is " "deprecated, its usage as a configuration file for setuptools is absolutely " "fine. There is likely no modification needed in :file:`setup.py`." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:184 +#: ../source/discussions/setup-py-deprecated.rst:183 msgid "Is ``pyproject.toml`` mandatory?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:186 +#: ../source/discussions/setup-py-deprecated.rst:185 msgid "" "While it is not technically necessary yet, it is **STRONGLY RECOMMENDED** " "for a project to have a :file:`pyproject.toml` file at the root of its " "source tree with a content like this:" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:197 +#: ../source/discussions/setup-py-deprecated.rst:196 msgid "" "The guide :ref:`modernize-setup-py-project` has more details about this." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:199 +#: ../source/discussions/setup-py-deprecated.rst:198 msgid "" "The standard fallback behavior for a :term:`build frontend ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1661,26 +1663,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12287,7 +12289,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12392,7 +12394,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12427,10 +12429,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12529,14 +12531,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12810,7 +12814,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12820,11 +12836,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12832,43 +12870,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12876,64 +12921,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12941,13 +12986,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12955,36 +13000,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12993,13 +13038,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -13007,20 +13052,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -13028,7 +13073,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13038,11 +13083,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13050,7 +13095,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13060,18 +13105,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13080,7 +13125,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13091,63 +13136,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13158,33 +13203,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13193,77 +13238,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/id/LC_MESSAGES/messages.po b/locales/id/LC_MESSAGES/messages.po index 40f2dbe97..b0f0a0d6d 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2024-01-27 05:01+0000\n" "Last-Translator: Rafael Fontenelle \n" "Language-Team: Indonesian ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1688,26 +1684,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12296,7 +12292,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12401,7 +12397,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12436,10 +12432,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12538,14 +12534,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12819,7 +12817,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12829,11 +12839,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12841,43 +12873,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12885,64 +12924,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12950,13 +12989,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12964,36 +13003,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -13002,13 +13041,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -13016,20 +13055,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -13037,7 +13076,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13047,11 +13086,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13059,7 +13098,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13069,18 +13108,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13089,7 +13128,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13100,63 +13139,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13167,33 +13206,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13202,77 +13241,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/ja/LC_MESSAGES/messages.po b/locales/ja/LC_MESSAGES/messages.po index aff34fecd..dfdbfde4f 100644 --- a/locales/ja/LC_MESSAGES/messages.po +++ b/locales/ja/LC_MESSAGES/messages.po @@ -10,7 +10,7 @@ msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-06-19 16:34+0000\n" -"PO-Revision-Date: 2024-09-05 02:09+0000\n" +"PO-Revision-Date: 2024-10-10 08:34+0000\n" "Last-Translator: moto kawasaki \n" "Language-Team: Japanese \n" @@ -19,7 +19,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=1; plural=0;\n" -"X-Generator: Weblate 5.7.2-rc\n" +"X-Generator: Weblate 5.8-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" @@ -2644,7 +2644,7 @@ msgstr "" #: ../source/discussions/versioning.rst:158 #: ../source/specifications/version-specifiers.rst:114 msgid "Local version identifiers" -msgstr "ローカルのバージョン指定子" +msgstr "ローカルバージョン指定子" #: ../source/discussions/versioning.rst:160 msgid "" @@ -23934,12 +23934,15 @@ msgid "" "Support all 3 content types described in this spec, using server-driven " "content negotiation, for as long as they reasonably can." msgstr "" +"それが合理的に実行可能である限り、サーバ側が駆動するコンテンツネゴシエーショ" +"ンを使ってこの仕様に記述された３個のコンテント型の全てをサポートすること。" #: ../source/specifications/simple-repository-api.rst:851 msgid "" "When constructing an ``Accept`` header, include all of the content types " "that you support." -msgstr "" +msgstr "``Accept`` " +"ヘッダを構築する時、サポートしているコンテント型の全てを含めること。" #: ../source/specifications/simple-repository-api.rst:854 msgid "" @@ -23949,6 +23952,11 @@ msgid "" "library HTML parser and you're worried that there may be some kinds of HTML " "responses that you're unable to parse in some edge cases)." msgstr "" +"サーバ側で考慮に入れてもらいたい特定の理由 (例えば、標準ライブラリの HTML " +"パーサを使っていて、何らかのエッジケースにおいてパースできない何らかの種類の " +"HTML 応答があるかもしれないと心配している場合) のある実装でない限り、" +"一般的にコンテント型にはクオリティ優先度 " +"を含めるべきではありません。" #: ../source/specifications/simple-repository-api.rst:860 msgid "" @@ -23956,22 +23964,27 @@ msgid "" "*should* include a ``;q=0.01`` value on the legacy ``text/html`` content " "type, unless it is the only content type that you are requesting." msgstr "" +"この推奨事項に対する例外のひとつは、それがリクエストしている唯一のコンテント" +"型であるという場合を除けば、伝統的な ``text/html`` コンテント型には ``;q=0." +"01`` を含めることが推奨されるということです。" #: ../source/specifications/simple-repository-api.rst:864 msgid "" "Explicitly select what versions they are looking for, rather than using the " "``latest`` meta version during normal operation." -msgstr "" +msgstr "通常操作では ``latest`` メタバージョンを使うのではなくて、希求しているバージ" +"ョンがどれであるかを明示的に選択すること。" #: ../source/specifications/simple-repository-api.rst:867 msgid "" "Check the ``Content-Type`` of the response and ensure it matches something " "that you were expecting." -msgstr "" +msgstr "応答の ``Content-Type`` " +"を調べて、こちらが期待しているものに合致していることを確認すること。" #: ../source/specifications/simple-repository-api.rst:871 msgid "Additional Fields for the Simple API for Package Indexes" -msgstr "" +msgstr "パッケージインデックス用のシンプル API 向けの追加的なフィールド" #: ../source/specifications/simple-repository-api.rst:873 msgid "" @@ -23979,32 +23992,41 @@ msgid "" "HTML version of the API, there is no change from version 1.0. For the JSON " "version of the API, the following changes are made:" msgstr "" +"この仕様では、シンプルなリポジトリ API のバージョン 1.1 を定義します。API の " +"HTML バージョンについては、バージョン 1.0 から何ら変わるところがありません。" +"API の JSON バージョンについては、以下のような変更が行われました:" #: ../source/specifications/simple-repository-api.rst:877 msgid "The ``api-version`` must specify version 1.1 or later." -msgstr "" +msgstr "``api-version`` に 1.1 またはそれ以降のバージョンを指定しなければなりません。" #: ../source/specifications/simple-repository-api.rst:878 msgid "A new ``versions`` key is added at the top level." -msgstr "" +msgstr "トップレベルに ``version`` キーが新規に追加されました。" #: ../source/specifications/simple-repository-api.rst:879 msgid "" "Two new \"file information\" keys, ``size`` and ``upload-time``, are added " "to the ``files`` data." msgstr "" +"\"ファイル情報\" のキー群のふたつのキー、 つまり ``size`` と ``upload-time`` " +"、が ``files`` データに追加されました。" #: ../source/specifications/simple-repository-api.rst:881 msgid "" "Keys (at any level) with a leading underscore are reserved as private for " "index server use. No future standard will assign a meaning to any such key." msgstr "" +"(どのレベルでも) 先頭にアンダースコアを伴うキーは、インデックスサーバが使うプ" +"ライベートなものとして予約されています。将来の標準において、このようなキーに" +"意味を付与することはありません。" #: ../source/specifications/simple-repository-api.rst:884 msgid "" "The ``versions`` and ``size`` keys are mandatory. The ``upload-time`` key is " "optional." -msgstr "" +msgstr "``versions`` キーと ``size`` キーは必須のものです。 ``upload-time`` " +"キーはオプションです。" #: ../source/specifications/simple-repository-api.rst:890 msgid "" @@ -24015,6 +24037,12 @@ msgid "" "for this project. The value is logically a set, and as such may not contain " "duplicates, and the order of the values is not significant." msgstr "" +"追加のキーである ``versions`` は、 :ref:`JSON API 仕様 ` で定義された ``name`` キー・ ``files`` キーや ``meta`` キーに加え" +"て、トップレベルに存在しなければなりません。このキーは、このプロジェクトよう" +"にアップロードされたプロジェクトのバージョンの全てを指定するバージョン文字列" +"を列挙したものを含んでいなければなりません。その値は論理的に言って集合であり" +"、したがって重複を許さず、値の順序は大きな意味を持ちません。" #: ../source/specifications/simple-repository-api.rst:897 msgid "" @@ -24023,6 +24051,11 @@ msgid "" "versions with no associated files (to represent versions with no files " "uploaded, if the server has such a concept)." msgstr "" +"``files`` キーに列挙されたファイルは、すべて、 ``versions`` " +"キー内のバージョンのひとつに対応していなければなりません。 ``versions`` " +"キーは、 (サーバ側がそのような概念を持っているならば、ファイルなしのバージョ" +"ンというものを表現するために) " +"対応するファイルがないバージョンを含んでいても構いません。" #: ../source/specifications/simple-repository-api.rst:902 msgid "" @@ -24032,21 +24065,27 @@ msgid "" "therefore cannot be assumed to be orderable using the VSS rules. However, " "servers SHOULD use normalised VSS versions where possible." msgstr "" +":ref:`バージョン指定子仕様 (VSS) ` の採用前からの " +"\"レガシー\" データをサーバが保持しているかもしれないので、" +"バージョン文字列について VSS " +"に則ったバージョンであることを要求することはできませんし、したがって、 VSS の" +"ルールを使って並べることができると仮定することもできません。しかしながら、サ" +"ーバ側は、可能であれば正規化された VSS バージョンを使うべきです。" #: ../source/specifications/simple-repository-api.rst:911 -#, fuzzy msgid "Additional file information" -msgstr "補遺" +msgstr "補足的なファイル情報" #: ../source/specifications/simple-repository-api.rst:913 msgid "Two new keys are added to the ``files`` key." -msgstr "" +msgstr "``files`` キーにふたつの新しいキーが追加されました。" #: ../source/specifications/simple-repository-api.rst:915 msgid "" "``size``: This field is mandatory. It MUST contain an integer which is the " "file size in bytes." -msgstr "" +msgstr "``size``: このフィールドは必須のものです。ファイルサイズをバイト単位で表した" +"整数が含まれていなければなりません。" #: ../source/specifications/simple-repository-api.rst:917 msgid "" @@ -24059,10 +24098,19 @@ msgid "" "record upload time information for a file, it MAY omit the ``upload-time`` " "key." msgstr "" +"``upload-time`` このフィールドはオプションです。もし存在するなら、正当な ISO " +"8601 形式の年月日・時刻が含まれていなければならず、そのフォーマットは ``yyyy-" +"mm-ddThh:mm:ss.ffffffZ`` " +"で、当該ファイルがインデックスにアップロードされた時点を表します。後置された " +"``Z`` が示すように、アップロード日時は必ず UTC " +"タイムゾーンを使わなければなりません。タイムスタンプの秒に満たない部分 (``." +"ffffff`` の部分) はオプションで、もし存在するなら６桁までの精度を含めて構いま" +"せん。サーバ側がファイルのアップロード日時を記録していない場合は、 ``upload-" +"time`` キーを省略しても構いません。" #: ../source/specifications/simple-repository-api.rst:926 msgid "Rename dist-info-metadata in the Simple API" -msgstr "" +msgstr "シンプル API の dist-info-metadata の名称変更" #: ../source/specifications/simple-repository-api.rst:929 msgid "" @@ -24071,10 +24119,14 @@ msgid "" "\"**RECOMMENDED**\", \"**MAY**\", and \"**OPTIONAL**\"\" in this document " "are to be interpreted as described in :rfc:`RFC 2119 <2119>`." msgstr "" +"この説明文書では、 \"**MUST**\" ・ \"**MUST NOT**\" ・ \"**REQUIRED**\" ・ \"" +"**SHALL**\" ・ \"**SHALL NOT**\", ・ **SHOULD**\" ・ \"**SHOULD NOT**\" ・ \"" +"**RECOMMENDED**\" ・ \"**MAY**\" ・ \"**OPTIONAL**\"\" を :rfc:`RFC 2119 " +"<2119>` で記述された意味に解釈します。" #: ../source/specifications/simple-repository-api.rst:936 msgid "Servers" -msgstr "" +msgstr "サーバ" #: ../source/specifications/simple-repository-api.rst:938 msgid "" @@ -24083,6 +24135,10 @@ msgid "" "API, **MUST** be emitted using the attribute name ``data-core-metadata``, " "with the supported values remaining the same." msgstr "" +"シンプル APIの HTML 表現の中で用いられる時は、 :ref:`API " +"メタデータファイルの仕様 ` " +"のメタデータは ``data-core-metadata`` という名称のアトリビュートを使ってサポ" +"ートされている値が同一のまま発信されなければなりません。" #: ../source/specifications/simple-repository-api.rst:944 msgid "" @@ -24092,6 +24148,11 @@ msgid "" "**MUST** be emitted using the key ``core-metadata``, with the supported " "values remaining the same." msgstr "" +":ref:`API メタデータファイルの仕様 ` " +"のメタデータは、シンプル API の :ref:`JSON API 仕様 ` による JSON 表現で使われる場合、" +"サポートされている値は同一に保ったままで ``core-metadata`` キーを使って " +"**送信されなければなりません** 。" #: ../source/specifications/simple-repository-api.rst:950 msgid "" @@ -24099,6 +24160,10 @@ msgid "" "**MAY** also be emitted using the ``data-dist-info-metadata``, and if it " "does so it **MUST** match the value of ``data-core-metadata``." msgstr "" +"以前のキーの名称を使っているクライアントをサポートするためには、 HTML " +"表現では ``data-dist-info-metadata`` を使って送信しても **構いません** し、" +"その場合には ``data-core-metadata`` の値と **合致していなければなりません** " +"。" #: ../source/specifications/simple-repository-api.rst:959 msgid "" @@ -24108,6 +24173,12 @@ msgid "" "present. They **MAY** optionally use the legacy ``data-dist-info-metadata`` " "if it is present but ``data-core-metadata`` is not." msgstr "" +"シンプル API の HTML 表現を消費するクライアントは、もしそれが存在するならば、" +" :ref:`API メタデータファイルの仕様 ` " +"のメタデータを ``data-core-metadata`` キーから **読み込まなければなりません**" +" 。従来の ``data-dist-info-metadata`` キーは存在しているが ``data-core-" +"metadata`` は存在していないという場合には、オプションとして前者を " +"**使っても構いません** 。" #: ../source/specifications/simple-repository-api.rst:966 msgid "" @@ -24117,48 +24188,59 @@ msgid "" "They **MAY** optionally use the legacy ``dist-info-metadata`` key if it is " "present but ``core-metadata`` is not." msgstr "" +"シンプル API の JSON 表現を消費するクライアントは、もしそれが存在するならば、" +" :ref:`API メタデータファイルの仕様 ` " +"のメタデータを ``core-metadata`` キーから **読み込まなければなりません** 。" +"従来の ``dist-info-metadata`` キーは存在しているが ``core-metadata`` " +"は存在していないという場合には、オプションとして前者を **使っても構いません**" +" 。" #: ../source/specifications/simple-repository-api.rst:976 msgid "September 2015: initial form of the HTML format, in :pep:`503`" -msgstr "" +msgstr "2015年9月: :pep:`503` で HTML フォーマットの初期フォーム" #: ../source/specifications/simple-repository-api.rst:977 msgid "July 2016: Requires-Python metadata, in an update to :pep:`503`" -msgstr "" +msgstr "2016年7月: :pep:`503` で Requires-Python メタデータ" #: ../source/specifications/simple-repository-api.rst:978 msgid "May 2019: \"yank\" support, in :pep:`592`" -msgstr "" +msgstr "2019年5月: :pep:`592` で \"ヤンク \" サポート" #: ../source/specifications/simple-repository-api.rst:979 msgid "" "July 2020: API versioning convention and metadata, and declaring the HTML " "format as API v1, in :pep:`629`" -msgstr "" +msgstr "2020年7月: :pep:`629` で、 API バージョン付け慣行とメタデータ、 HTML " +"フォーマットを API v1.として宣言" #: ../source/specifications/simple-repository-api.rst:981 msgid "" "May 2021: providing package metadata independently from a package, in :pep:" "`658`" -msgstr "" +msgstr "2021年5月: :pep:`658` で、パッケージとは独立にパッケージのメタデータを提供" #: ../source/specifications/simple-repository-api.rst:983 msgid "" "May 2022: initial form of the JSON format, with a mechanism for clients to " "choose between them, and declaring both formats as API v1, in :pep:`691`" msgstr "" +"2022年5月: :pep:`691` により、クライアント側が選択する機構とともに JSON " +"フォーマットの初期の形、両フォーマットを API v1 として宣言" #: ../source/specifications/simple-repository-api.rst:985 msgid "" "October 2022: project versions and file size and upload-time in the JSON " "format, in :pep:`700`" -msgstr "" +msgstr "2022年10月: :pep:`700` により、 JSON " +"フォーマットにおけるプロジェクトバージョン・ファイルサイズ・アップロード日時" #: ../source/specifications/simple-repository-api.rst:987 msgid "" "June 2023: renaming the field which provides package metadata independently " "from a package, in :pep:`714`" -msgstr "" +msgstr "2023年6月: :pep:`714` により、パッケージから独立したパッケージメタデータを提" +"供するフィールドを名称変更" #: ../source/specifications/source-distribution-format.rst:6 msgid "Source distribution format" @@ -24248,15 +24330,14 @@ msgstr "" "値に合致しなければなりません。" #: ../source/specifications/source-distribution-format.rst:45 -#, fuzzy msgid "" "Code that produces a source distribution file MUST give the file a name that " "matches this specification. This includes the ``build_sdist`` hook of a :" "term:`build backend `." msgstr "" -"ソースコード配布物を生成するソースコードは、この仕様に合致した名前をファイル" -"に与えなければなりません。これは、ビルドバックエンドの ``build_sdist`` フック" -"にも当てはまります。" +"ソースコード配布物のファイルを生成するコードは、この仕様に適合する名前をファ" +"イルに与えなければなりません。これは、 :term:`ビルドバックエンド ` の ``build_sdist`` フックにも当てはまります。" #: ../source/specifications/source-distribution-format.rst:49 msgid "" @@ -24276,7 +24357,6 @@ msgid "Source distribution file format" msgstr "ソースコード配布物のファイルフォーマット" #: ../source/specifications/source-distribution-format.rst:57 -#, fuzzy msgid "" "A ``.tar.gz`` source distribution (sdist) contains a single top-level " "directory called ``{name}-{version}`` (e.g. ``foo-1.0``), containing the " @@ -24287,15 +24367,15 @@ msgid "" "metadata` specification. The metadata MUST conform to at least version 2.2 " "of the metadata specification." msgstr "" -"``.tar.gz`` ソースコード配布物 (sdist) には、 ``{name}-{version}`` (例えば " -"``foo-1.0``) と言う名前の単一のトップレベルディレクトリがあって、そこにパッ" -"ケージのソールファイル群を含んでいます。 name と version は、ファイル内のメタ" -"データと合致していなければなりません。このディレクトリは、 :ref:`declaring-" -"build-dependencies` の中で定義されたフォーマットで書かれた :file:`pyproject." -"toml` ファイルや、 :ref:`core-metadata` 仕様内に記述されたフォーマットで書か" -"れたメタデータを含んだ ``PKG-INFO`` ファイルも含んでいなければなりません。メ" -"タデータは、少なくともバージョン 2.2 のメタデータ仕様を満足するものでなければ" -"なりません。" +"``.tar.gz`` ソースコード配布物 (sdist) には、トップレベルに " +"``{name}-{version}`` (例えば ``foo-1.0``) と言う名前の単一のディレクトリがあ" +"って、そこにパッケージのソールファイル群を含んでいます。 name と version は、" +"ファイル内のメタデータと合致していなければなりません。このディレクトリは、 " +":ref:`pyproject-toml-spec` で定義されたフォーマットで書かれた " +":file:`pyproject.toml` ファイルや、 :ref:`core-metadata` " +"仕様内に記述されたフォーマットで書かれたメタデータを含んだ ``PKG-INFO`` " +"ファイルも含んでいなければなりません。このようなメタデータは、" +"少なくともバージョン 2.2 のメタデータ仕様を満足するものでなければなりません。" #: ../source/specifications/source-distribution-format.rst:65 msgid "" @@ -24494,27 +24574,24 @@ msgstr "" msgid "" "November 2020: The original version of this specification was approved " "through :pep:`643`." -msgstr "" +msgstr "2020年11月: :pep:`643` を通じてこの仕様の当初のバージョンが承認された。" #: ../source/specifications/source-distribution-format.rst:148 -#, fuzzy msgid "July 2021: Defined what a source tree is." -msgstr "2021-07: ソースコードツリーとは何であるかを定義" +msgstr "2021年7月: ソースコードツリーとは何であるかを定義。" #: ../source/specifications/source-distribution-format.rst:149 -#, fuzzy msgid "" "September 2022: The filename of a source distribution was standardized " "through :pep:`625`." -msgstr "2022-09: ソースコード配布物のファイル名について標準化 (:pep:`625`)" +msgstr "2022年9月: :pep:`625` を通じて、ソースコード配布物のファイル名を標準化した。" #: ../source/specifications/source-distribution-format.rst:151 -#, fuzzy msgid "" "August 2023: Source distribution archive features were standardized through :" "pep:`721`." -msgstr "" -"2023-08: ソースコード配布物のアーカイブの機能について標準化 (: pep:`721`)" +msgstr "2023年8月: : pep:`721` " +"を通じて、ソースコード配布物のアーカイブの機能について標準化された。" #: ../source/specifications/version-specifiers.rst:7 #: ../source/specifications/version-specifiers.rst:780 @@ -24525,12 +24602,12 @@ msgstr "バージョン指定子" msgid "" "This specification describes a scheme for identifying versions of Python " "software distributions, and declaring dependencies on particular versions." -msgstr "" +msgstr "この仕様では、 Python ソフトウェア配布物のバージョンを識別したり、特定のバー" +"ジョンにおける依存関係を宣言したりする枠組みを記述します。" #: ../source/specifications/version-specifiers.rst:15 -#, fuzzy msgid "Definitions" -msgstr "仕様型文書" +msgstr "用語定義" #: ../source/specifications/version-specifiers.rst:17 msgid "" @@ -24539,6 +24616,9 @@ msgid "" "\"OPTIONAL\" in this document are to be interpreted as described in :rfc:" "`2119`." msgstr "" +"この説明文書におけるキーワード \"MUST\", \"MUST NOT\", \"REQUIRED\", \"SHALL" +"\", \"SHALL NOT\", \"SHOULD\", \"SHOULD NOT\", \"RECOMMENDED\", \"MAY\", " +"および \"OPTIONAL\" は、 :rfc:`2119` に記述されているように解釈されます。" #: ../source/specifications/version-specifiers.rst:21 msgid "" @@ -24547,18 +24627,29 @@ msgid "" "invoked by integration tools in order to build software distributed as " "sdists rather than prebuilt binary archives." msgstr "" +"\"ビルドツール \" とは、開発システムを走らせてソースコード配布物" +"やバイナリ配布物のアーカイブを生成することを意図した自動化ツールのことです。" +"ビルドツールは、また、ビルド済みのバイナリのアーカイブではなくて sdist として" +"配布されるソフトウェアをビルドする目的で統合ツールから起動されることもありま" +"す。" #: ../source/specifications/version-specifiers.rst:26 msgid "" "\"Index servers\" are active distribution registries which publish version " "and dependency metadata and place constraints on the permitted metadata." msgstr "" +"\"インデックスサーバ \" とは、バージョンと依存関係のメタデータ" +"を広報し、許されるメタデータに制限を加えるような、正規の配布物の登記所にあた" +"るものです。" #: ../source/specifications/version-specifiers.rst:29 msgid "" "\"Publication tools\" are automated tools intended to run on development " "systems and upload source and binary distribution archives to index servers." msgstr "" +"\"出版ツール \" とは、開発システムを走らせ、ソースコード配" +"布物やバイナリ配布物のアーカイブをインデックスサーバへアップロードすることを" +"意図した自動化ツールのことです。" #: ../source/specifications/version-specifiers.rst:32 msgid "" @@ -24567,6 +24658,10 @@ msgid "" "an index server or other designated location and deploying them to the " "target system." msgstr "" +"\"インストールツール \" とは、デプロイメントターゲット上" +"で走らせ、インデックスサーバもしくは別途指定された場所から得たソースコード配" +"布物やバイナリ配布物のアーカイブを入力として、ターゲットとなるシステムに配置" +"することを意図した統合ツールです。" #: ../source/specifications/version-specifiers.rst:37 msgid "" @@ -24574,17 +24669,20 @@ msgid "" "servers, publication tools, integration tools and any other software that " "produces or consumes distribution version and dependency metadata." msgstr "" +"\"自動化ツール \" とは、ビルドツール・インデックスサーバ・出" +"版ツール・統合ツールや、配布物のバージョン・依存関係メタデータを作り出したり" +"入力として扱うその他のソフトウェアを集合的に包含する用語です。" #: ../source/specifications/version-specifiers.rst:43 -#, fuzzy msgid "Version scheme" -msgstr "バージョン指定子" +msgstr "バージョン枠組み" #: ../source/specifications/version-specifiers.rst:45 msgid "" "Distributions are identified by a public version identifier which supports " "all defined version comparison operations" -msgstr "" +msgstr "配布物は、すべての定義されたバージョン比較操作をサポートしている公的バージョ" +"ン識別子によって識別されます。" #: ../source/specifications/version-specifiers.rst:48 msgid "" @@ -24593,26 +24691,29 @@ msgid "" "constraints on the version of dependencies needed in order to build or run " "the software." msgstr "" +"バージョン枠組みは、特定の配布物アーカイブによって提供される配布物のバージョ" +"ンを記述するためにも使われますし、同様に、当該ソフトウェアをビルドしたり走ら" +"せたりするために必要な依存関係にあるバージョンに対して制約を加えるためにも使" +"われます。" #: ../source/specifications/version-specifiers.rst:57 -#, fuzzy msgid "Public version identifiers" -msgstr "ローカルのバージョン指定子" +msgstr "公的バージョン識別子" #: ../source/specifications/version-specifiers.rst:59 msgid "" "The canonical public version identifiers MUST comply with the following " "scheme::" -msgstr "" +msgstr "正統な公的バージョン識別子は、以下の枠組みに合致していなければなりません::" #: ../source/specifications/version-specifiers.rst:64 msgid "" "Public version identifiers MUST NOT include leading or trailing whitespace." -msgstr "" +msgstr "公的バージョン識別子は、先頭もしくは末尾に空白文字を含んではなりません。" #: ../source/specifications/version-specifiers.rst:66 msgid "Public version identifiers MUST be unique within a given distribution." -msgstr "" +msgstr "公的バージョン識別子は、その配布物の中で一意でなければなりません。" #: ../source/specifications/version-specifiers.rst:68 msgid "" @@ -24621,6 +24722,10 @@ msgid "" "Installation tools MAY warn the user when non-compliant or ambiguous " "versions are detected." msgstr "" +"インストールツール は、この枠組みに合致しない公的バージ" +"ョンのすべてを無視するべきですが、以下に指定される標準化も含んでいなければな" +"りません。インストールツールは、バージョンが非適合であったり曖昧であったりし" +"た時には、ユーザに対して警告を行なっても構いません。" #: ../source/specifications/version-specifiers.rst:73 msgid "" @@ -24629,48 +24734,57 @@ msgid "" "permissive regular expression accepting inputs that may require subsequent " "normalization." msgstr "" +"正統なフォーマットに厳密に適合していることを確認するための正規表現についても" +"、さらに標準化する必要があるかもしれない入力を受け入れるためのより緩やかな正" +"規表現についても、これらを提供する :ref:`version-specifiers-regex` " +"を見てください。" #: ../source/specifications/version-specifiers.rst:78 msgid "Public version identifiers are separated into up to five segments:" -msgstr "" +msgstr "公的バージョン識別子は５個の部分に分割されます:" #: ../source/specifications/version-specifiers.rst:80 msgid "Epoch segment: ``N!``" -msgstr "" +msgstr "エポック部分: ``N!``" #: ../source/specifications/version-specifiers.rst:81 msgid "Release segment: ``N(.N)*``" -msgstr "" +msgstr "リリース部分: ``N(.N)*``" #: ../source/specifications/version-specifiers.rst:82 msgid "Pre-release segment: ``{a|b|rc}N``" -msgstr "" +msgstr "プレリリース部分: ``{a|b|rc}N``" #: ../source/specifications/version-specifiers.rst:83 msgid "Post-release segment: ``.postN``" -msgstr "" +msgstr "ポストリリース部分: ``.postN``" #: ../source/specifications/version-specifiers.rst:84 msgid "Development release segment: ``.devN``" -msgstr "" +msgstr "開発リリース部分: ``.devN``" #: ../source/specifications/version-specifiers.rst:86 msgid "" "Any given release will be a \"final release\", \"pre-release\", \"post-" "release\" or \"developmental release\" as defined in the following sections." msgstr "" +"どのリリースであっても、この後の節で定義する \"最終リリース \"" +"・\"プレリリース \"・\"ポストリリース \"・" +"\"開発リリース \" になることでしょう。" #: ../source/specifications/version-specifiers.rst:89 msgid "" "All numeric components MUST be non-negative integers represented as " "sequences of ASCII digits." -msgstr "" +msgstr "数字で構成される部分は、すべて、 ASCII " +"の数字の並びとして表現される非負の整数でなければなりません。" #: ../source/specifications/version-specifiers.rst:92 msgid "" "All numeric components MUST be interpreted and ordered according to their " "numeric value, not as text strings." -msgstr "" +msgstr "数字で構成される部分は、すべて、テキスト文字列としてではなく、数としての値に" +"従って解釈され整列されなければなりません。" #: ../source/specifications/version-specifiers.rst:95 msgid "" @@ -24678,6 +24792,10 @@ msgid "" "release segment, a numeric component of zero has no special significance " "aside from always being the lowest possible value in the version ordering." msgstr "" +"数字で構成される部分は、すべて、ゼロであっても構いません。リリースを表す部分" +"について後で記述する場合を除いて、数字の部分がゼロであることは、常にバージョ" +"ンの整列で取り得る最小の値であること以外には、なんら特別な重要性を持ちません" +"。" #: ../source/specifications/version-specifiers.rst:101 msgid "" @@ -24685,6 +24803,9 @@ msgid "" "to better accommodate the wide range of versioning practices across existing " "public and private Python projects." msgstr "" +"読解困難なバージョン識別子のいくつかは、既存の公開または非公開の Python プロ" +"ジェクトにおける幅広いバージョン付与方法をよりうまく収容するために、この枠組" +"みによって許容されています。" #: ../source/specifications/version-specifiers.rst:105 msgid "" @@ -24693,10 +24814,13 @@ msgid "" "Where this is the case, the relevant details are noted in the following " "sections." msgstr "" +"従って、当該仕様で技術的に許容されているバージョン付与方法のいくつかは、新規" +"プロジェクトにおいては強い非推奨になっています。これが問題になるケースでは、" +"引き続く節に関連する詳細事項をまとめてあります。" #: ../source/specifications/version-specifiers.rst:116 msgid "Local version identifiers MUST comply with the following scheme::" -msgstr "" +msgstr "ローカルのバージョン指定子は、以下に述べる枠組みに適合しなければなりません::" #: ../source/specifications/version-specifiers.rst:120 msgid "" @@ -24706,6 +24830,10 @@ msgid "" "have no specific semantics assigned, but some syntactic restrictions are " "imposed." msgstr "" +"プラスの文字によって公的バージョン識別子と区分されている任意の " +"\"ローカルバージョンラベル\" を伴った、 (前の節で定義した) 通常の公的バージョ" +"ン識別子で構成されています。ローカルバージョンラベルは、その意味の点では特に" +"指定はありませんが、文法の上ではいくらかの制約が課されています。" #: ../source/specifications/version-specifiers.rst:125 msgid "" @@ -24716,6 +24844,13 @@ msgid "" "be too disruptive to the application or other integrated system (such as a " "Linux distribution)." msgstr "" +"ローカルのバージョン指定子は、" +"上流のプロジェクトのパッチ適用済バージョンに互換性のある API (" +"もし適用可能なら ZBI も) を示すために用いられます。例えば、" +"上流の新しいリリースに更新することが当該アプリケーションや (Linux " +"ディストロのような) 他の統合されたシステムにとって破壊的に過ぎるであろうとい" +"う場合に、特定のバグ修正をバックポートして適用することでアプリケーション開発" +"者やシステム統合者によって作成されるかもしれません。" #: ../source/specifications/version-specifiers.rst:132 msgid "" @@ -24725,6 +24860,11 @@ msgid "" "of a release but, when applied to a source distribution, does indicate that " "it may not contain the exact same code as the corresponding upstream release." msgstr "" +"ローカルバージョンラベルを包含することで、上流側のリリースを下流側のインテグ" +"レータによる潜在的に修正されたリビルドから区別することが可能になります。ロー" +"カルバージョン識別子の使用はこの種のリリースには影響を与えませんが、ソースコ" +"ード配布物に適用した場合には、対応する上流のリリースと正確に同じコードを含ん" +"でいないかもしれないということを示します。" #: ../source/specifications/version-specifiers.rst:138 msgid "" @@ -24733,23 +24873,27 @@ msgid "" "hash representations, local version labels MUST be limited to the following " "set of permitted characters:" msgstr "" +"ローカルのバージョン指定子を確かなものにすることは、ファイル名や URL の一部と" +"して難なく統合することができ、16進数のハッシュ値での表現でフォーマットが不統" +"一になることを避けるには、ローカルバージョンラベルは、以下に示す許容される一" +"連の文字群に限定されなければなりません。" #: ../source/specifications/version-specifiers.rst:143 msgid "ASCII letters (``[a-zA-Z]``)" -msgstr "" +msgstr "ASCII 文字 (``[a-zA-Z]``)" #: ../source/specifications/version-specifiers.rst:144 msgid "ASCII digits (``[0-9]``)" -msgstr "" +msgstr "ASCII 数字 (``[0-9]``)" #: ../source/specifications/version-specifiers.rst:145 msgid "periods (``.``)" -msgstr "" +msgstr "ピリオド (``.``)" #: ../source/specifications/version-specifiers.rst:147 -#, fuzzy msgid "Local version labels MUST start and end with an ASCII letter or digit." -msgstr "先頭と最後の文字がASCII文字ないし数字であること。" +msgstr "ローカルバージョンラベルは、 ASCII 文字ないし ASCII " +"数字で始まり、かつ、終わらなければなりません。" #: ../source/specifications/version-specifiers.rst:149 msgid "" @@ -24764,6 +24908,15 @@ msgid "" "a local version with fewer segments, as long as the shorter local version's " "segments match the beginning of the longer local version's segments exactly." msgstr "" +"ローカルバージョンの比較や順序付けでは、ローカルバージョンの (``.`` " +"で分割される)各部分を別々に考えます。ある部分がすべて ASCII " +"数字でできているなら比較の目的においてはその部分は整数だと見做すべきであり、" +"ある部分が一つでも ASCII 文字を含むのであれば大文字小文字を無視して辞書学的に" +"比較されます。数字だけの部分と辞書学的な部分を比較する時には、常に、数字だけ" +"の部分が辞書学的な部分よりも大きいものとして比較されます。さらに、多数の部分" +"を持つローカルバージョンは、短い方のローカルバージョンの部分部分が長い方のロ" +"ーカルバージョンの先頭の対応する部分と正確に一致する限り、常に、それより少な" +"い数の部分を持つローカルバージョンよりも大きいものとして比較されます。" #: ../source/specifications/version-specifiers.rst:160 msgid "" @@ -24772,6 +24925,11 @@ msgid "" "project, potentially backporting security and bug fixes from later versions " "of the upstream project." msgstr "" +"\"上流プロジェクト\" " +"とは、それ自身のパブリックバージョンを定義するプロジェクトです。" +"\"下流プロジェクト\" とは、上流プロジェクトに追随し再配布するプロジェクトで、" +"潜在的には、上流プロジェクトのその後のバージョンからセキュリティ上の修正やバ" +"グ修正をバックポートします。" #: ../source/specifications/version-specifiers.rst:165 msgid "" @@ -24784,29 +24942,42 @@ msgid "" "the Python Package Index is intended solely for indexing and hosting " "upstream projects, it MUST NOT allow the use of local version identifiers." msgstr "" +"ローカルバージョン指定子は、上流プロジェクトを公開のインデックスサーバで公開" +"する際に使用するべきではありませんが、プロジェクトのソースコードから直接に作" +"成されたプライベートのビルド群を識別するために使っても構いません。ローカルバ" +"ージョン指定子は、" +"公開バージョン識別子で識別される上流プロジェクトのあるバージョンと API " +"レベルで互換性を保つような、しかし、 (バグ修正などの) 追加の変更を含む下流プ" +"ロジェクトのバージョンをリリースする時に用いられるべきです。Python パッケージ" +"インデックスは上流プロジェクトを列挙しホストすることだけを意図していますので" +"、ローカルバージョン指定子の使用を許してはなりません。" #: ../source/specifications/version-specifiers.rst:175 msgid "" "Source distributions using a local version identifier SHOULD provide the " "``python.integrator`` extension metadata (as defined in :pep:`459`)." msgstr "" +"ローカルバージョン識別子を使うソースコード配布物は、 (:pep:`459` " +"で定義される通り) ``python.integrator`` 拡張メタデータを提供するべきです。" #: ../source/specifications/version-specifiers.rst:180 -#, fuzzy msgid "Final releases" -msgstr "リリースを公開する" +msgstr "最終リリース" #: ../source/specifications/version-specifiers.rst:182 msgid "" "A version identifier that consists solely of a release segment and " "optionally an epoch identifier is termed a \"final release\"." msgstr "" +"リリース部分だけか、オプションとしてエポック識別子を加えたものから構成されて" +"いるバージョン識別子は、 \"最終リリース \" " +"という用語で呼ばれます。" #: ../source/specifications/version-specifiers.rst:185 msgid "" "The release segment consists of one or more non-negative integer values, " "separated by dots::" -msgstr "" +msgstr "ひとつかそれ以上の非負整数をピリオドで区切って構成されるリリース部分::" #: ../source/specifications/version-specifiers.rst:190 msgid "" @@ -24814,6 +24985,9 @@ msgid "" "increasing fashion, otherwise automated tools will not be able to upgrade " "them correctly." msgstr "" +"あるプロジェクトの最終リリースは、首尾一貫して増加する形で番号付けされなけれ" +"ばならず、そうでなければ自動化ツール " +"がそれらを正しくアップグレードすることができないでしょう。" #: ../source/specifications/version-specifiers.rst:194 msgid "" @@ -24822,6 +24996,9 @@ msgid "" "segments with different numbers of components, the shorter segment is padded " "out with additional zeros as necessary." msgstr "" +"リリース部分の比較と整序は、リリース部分の各部分の数としての値を順に比較しま" +"す。リリース部分の構成要素の数が異なるものを比較するときは、必要に応じて短い" +"方にゼロの部分を追加する形で補足します。" #: ../source/specifications/version-specifiers.rst:199 msgid "" @@ -24829,6 +25006,9 @@ msgid "" "under this scheme, the most common variants are to use two components " "(\"major.minor\") or three components (\"major.minor.micro\")." msgstr "" +"この枠組みの下では、最初の構成部分の後にいくつの追加部分があっても構いません" +"が、最も一般的な変種は、構成部分２個 (\"メジャー.マイナー\") " +"のものか、または、構成部分３個 (\"メジャー.マイナー.マイクロ\") のものです。" #: ../source/specifications/version-specifiers.rst:203 msgid "For example::" @@ -24840,6 +25020,9 @@ msgid "" "common prefix. For example, ``3.3.1``, ``3.3.5`` and ``3.3.9.45`` are all " "part of the ``3.3`` release series." msgstr "" +"リリースシリーズとは、共通の前置部分で始まる任意の最終リリース番号の集合です" +"。例えば、 ``3.3.1`` ・ ``3.3.5`` ・ ``3.3.9.45`` は、すべて、 ``3.3`` " +"リリースシリーズの一部です。" #: ../source/specifications/version-specifiers.rst:224 msgid "" @@ -24848,35 +25031,44 @@ msgid "" "``X.Y.0`` when comparing it to any release segment that includes three " "components." msgstr "" +"３個の構成部分を持つリリース番号\n" +"``X.Y`` と ``X.Y.0`` は、相異なるリリース番号とは見做されません。" #: ../source/specifications/version-specifiers.rst:229 msgid "" "Date based release segments are also permitted. An example of a date based " "release scheme using the year and month of the release::" -msgstr "" +msgstr "日付ベースのリリース構成部分もまた許容されます。リリースの年と月を使用した日" +"付ベースのリリース枠組みの例::" #: ../source/specifications/version-specifiers.rst:241 -#, fuzzy msgid "Pre-releases" -msgstr "リリース前のバージョン付与方式" +msgstr "プレリリース" #: ../source/specifications/version-specifiers.rst:243 msgid "" "Some projects use an \"alpha, beta, release candidate\" pre-release cycle to " "support testing by their users prior to a final release." msgstr "" +"プロジェクトの中には、最終リリースに先立ってユーザによるテストを行えるように" +"、 \"alpha, beta, release candidate\" " +"のプレリリースサイクルを使うものがあります。" #: ../source/specifications/version-specifiers.rst:246 msgid "" "If used as part of a project's development cycle, these pre-releases are " "indicated by including a pre-release segment in the version identifier::" msgstr "" +"プロジェクトの開発サイクルの一部として使用されるなら、これらのプレリリースは" +"、バージョン識別子のプレリリース構成部分を含めることによって表示されます::" #: ../source/specifications/version-specifiers.rst:254 msgid "" "A version identifier that consists solely of a release segment and a pre-" "release segment is termed a \"pre-release\"." msgstr "" +"リリース構成部分とプレリリース構成部分だけから構成されるバージョン識別子は、 " +"\"プレリリース \" という用語で呼ばれます。" #: ../source/specifications/version-specifiers.rst:257 msgid "" @@ -24885,29 +25077,41 @@ msgid "" "given release are ordered first by phase (alpha, beta, release candidate) " "and then by the numerical component within that phase." msgstr "" +"プレリリース構成部分は、非負整数を伴ったプレリリースの局面を示すアルファベッ" +"ト文字の識別子から構成されます。あるリリースにおけるプレリリース群は、" +"まず局面 (alpha, beta, release candidate) " +"で順序付けられ、次いでその局面内の数字の部分で順序づけられます。" #: ../source/specifications/version-specifiers.rst:262 msgid "" "Installation tools MAY accept both ``c`` and ``rc`` releases for a common " "release segment in order to handle some existing legacy distributions." msgstr "" +"インストールツール " +"は、既存のレガシーなディストリビューションのいくつかを取り扱うために、" +"よくあるリリース構成部分に ``c`` と ``rc`` の両方を受け入れても構いません。" #: ../source/specifications/version-specifiers.rst:265 msgid "" "Installation tools SHOULD interpret ``c`` versions as being equivalent to " "``rc`` versions (that is, ``c1`` indicates the same version as ``rc1``)." msgstr "" +"インストールツール は、``c`` バージョンを ``rc`` " +"バージョンと同じである (つまり、 ``c1`` が ``rc1`` と同じバージョンである) " +"と解釈するべきです。" #: ../source/specifications/version-specifiers.rst:268 msgid "" "Build tools, publication tools and index servers SHOULD disallow the " "creation of both ``rc`` and ``c`` releases for a common release segment." msgstr "" +"ビルドツール ・出版ツール 、そして " +"インデックスサーバ は、共通のリリース構成部分に ``rc`` と " +"``c`` の両方のリリースを作ることを禁止するべきです。" #: ../source/specifications/version-specifiers.rst:273 -#, fuzzy msgid "Post-releases" -msgstr "zest.releaser" +msgstr "ポストリリース" #: ../source/specifications/version-specifiers.rst:275 msgid "" diff --git a/locales/ko/LC_MESSAGES/messages.po b/locales/ko/LC_MESSAGES/messages.po index 32c7ab69e..9bc722e3a 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2024-03-21 03:01+0000\n" "Last-Translator: emscb \n" "Language-Team: Korean ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1706,26 +1702,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12334,7 +12330,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12439,7 +12435,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12474,10 +12470,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12576,14 +12572,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12857,7 +12855,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12867,11 +12877,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12879,43 +12911,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12923,64 +12962,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12988,13 +13027,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -13002,36 +13041,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -13040,13 +13079,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -13054,20 +13093,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -13075,7 +13114,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13085,11 +13124,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13097,7 +13136,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13107,18 +13146,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13127,7 +13166,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13138,63 +13177,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13205,33 +13244,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13240,77 +13279,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/lzh/LC_MESSAGES/messages.po b/locales/lzh/LC_MESSAGES/messages.po index ddf2d1118..ebf262fdd 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2024-01-31 06:01+0000\n" "Last-Translator: maker \n" "Language-Team: Chinese (Literary) ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1655,26 +1651,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12245,7 +12241,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12350,7 +12346,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12385,10 +12381,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12487,14 +12483,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12768,7 +12766,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12778,11 +12788,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12790,43 +12822,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12834,64 +12873,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12899,13 +12938,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12913,36 +12952,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12951,13 +12990,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12965,20 +13004,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -12986,7 +13025,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -12996,11 +13035,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13008,7 +13047,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13018,18 +13057,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13038,7 +13077,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13049,63 +13088,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13116,33 +13155,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13151,77 +13190,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/mk/LC_MESSAGES/messages.po b/locales/mk/LC_MESSAGES/messages.po index 89a634143..2bd8be9b3 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2023-10-21 04:04+0000\n" "Last-Translator: \"Kristijan \\\"Fremen\\\" Velkovski\" \n" "Language-Team: Macedonian ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1657,26 +1653,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12249,7 +12245,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12354,7 +12350,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12389,10 +12385,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12491,14 +12487,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12772,7 +12770,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12782,11 +12792,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12794,43 +12826,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12838,64 +12877,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12903,13 +12942,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12917,36 +12956,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12955,13 +12994,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12969,20 +13008,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -12990,7 +13029,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13000,11 +13039,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13012,7 +13051,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13022,18 +13061,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13042,7 +13081,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13053,63 +13092,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13120,33 +13159,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13155,77 +13194,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/pl/LC_MESSAGES/messages.po b/locales/pl/LC_MESSAGES/messages.po index 55fd6af0d..c33c4790c 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1553,50 +1553,46 @@ msgid "``egg_info``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:144 -msgid "``install``" -msgstr "" - -#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_data``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:146 +#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_egg_info``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:147 +#: ../source/discussions/setup-py-deprecated.rst:146 msgid "``install_headers``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:148 +#: ../source/discussions/setup-py-deprecated.rst:147 msgid "``install_lib``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:149 +#: ../source/discussions/setup-py-deprecated.rst:148 msgid "``install_scripts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:150 +#: ../source/discussions/setup-py-deprecated.rst:149 msgid "``rotate``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:151 +#: ../source/discussions/setup-py-deprecated.rst:150 msgid "``saveopts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:152 +#: ../source/discussions/setup-py-deprecated.rst:151 msgid "``setopt``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:153 +#: ../source/discussions/setup-py-deprecated.rst:152 msgid "``upload_docs``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:157 +#: ../source/discussions/setup-py-deprecated.rst:156 msgid "What about custom commands?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:159 +#: ../source/discussions/setup-py-deprecated.rst:158 msgid "" "Likewise, custom :file:`setup.py` commands are deprecated. The " "recommendation is to migrate those custom commands to a task runner tool or " @@ -1604,46 +1600,46 @@ msgid "" "tox, pydoit, pyinvoke, taskipy, and thx." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:167 +#: ../source/discussions/setup-py-deprecated.rst:166 msgid "What about custom build steps?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:169 +#: ../source/discussions/setup-py-deprecated.rst:168 msgid "" "Custom build steps that for example either overwrite existing steps such as " "``build_py``, ``build_ext``, and ``bdist_wheel`` or add new build steps are " "not deprecated. Those will be automatically called as expected." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:176 +#: ../source/discussions/setup-py-deprecated.rst:175 #: ../source/guides/modernize-setup-py-project.rst:21 msgid "Should ``setup.py`` be deleted?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:178 +#: ../source/discussions/setup-py-deprecated.rst:177 msgid "" "Although the usage of :file:`setup.py` as an executable script is " "deprecated, its usage as a configuration file for setuptools is absolutely " "fine. There is likely no modification needed in :file:`setup.py`." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:184 +#: ../source/discussions/setup-py-deprecated.rst:183 msgid "Is ``pyproject.toml`` mandatory?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:186 +#: ../source/discussions/setup-py-deprecated.rst:185 msgid "" "While it is not technically necessary yet, it is **STRONGLY RECOMMENDED** " "for a project to have a :file:`pyproject.toml` file at the root of its " "source tree with a content like this:" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:197 +#: ../source/discussions/setup-py-deprecated.rst:196 msgid "" "The guide :ref:`modernize-setup-py-project` has more details about this." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:199 +#: ../source/discussions/setup-py-deprecated.rst:198 msgid "" "The standard fallback behavior for a :term:`build frontend ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1651,26 +1647,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12239,7 +12235,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12344,7 +12340,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12379,10 +12375,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12481,14 +12477,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12762,7 +12760,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12772,11 +12782,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12784,43 +12816,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12828,64 +12867,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12893,13 +12932,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12907,36 +12946,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12945,13 +12984,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12959,20 +12998,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -12980,7 +13019,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -12990,11 +13029,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13002,7 +13041,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13012,18 +13051,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13032,7 +13071,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13043,63 +13082,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13110,33 +13149,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13145,77 +13184,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/pt_BR/LC_MESSAGES/messages.po b/locales/pt_BR/LC_MESSAGES/messages.po index 5702b8548..076258670 100644 --- a/locales/pt_BR/LC_MESSAGES/messages.po +++ b/locales/pt_BR/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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2024-07-30 13:48+0000\n" "Last-Translator: Alefsander Ribeiro Nascimento \n" "Language-Team: Portuguese (Brazil) ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -2157,11 +2153,11 @@ msgstr "" "tabela ``[build-system]`` é assumir que o :term:`backend de construção " "` é o setuptools." -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "Por que? O que isso tudo quer dizer?" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." @@ -2169,16 +2165,16 @@ msgstr "" "Uma maneira de ver isso é que o escopo do setuptools agora foi reduzido à " "função de um backend de construção." -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "Onde posso ler mais sobre isso?" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr ":doc:`setuptools:deprecated/commands`" @@ -16256,7 +16252,7 @@ msgstr "" "com um pacote totalmente instalado antes de aceitá-lo como um bug genuíno." #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -16387,9 +16383,13 @@ msgid "Metadata-Version" msgstr "Metadata-Version" #: ../source/specifications/core-metadata.rst:50 +#, fuzzy +#| msgid "" +#| "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " +#| "\"2.1\", \"2.2\", and \"2.3\"." msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" "Versão do formato de arquivo; valores válidos são \"1.0\", \"1.1\", \"1.2\", " "\"2.1\", \"2.2\" e \"2.3\"." @@ -16435,10 +16435,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "Exemplo::" @@ -16567,14 +16567,16 @@ msgstr "" "de \"Operating System\". Veja \"Classifier\" abaixo." #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "Exemplos::" @@ -16936,7 +16938,21 @@ msgstr "" msgid "License" msgstr "License" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +#, fuzzy +#| msgid "in favour of ``Requires-Dist``" +msgid "in favour of ``License-Expression``." +msgstr "em favor de ``Requires-Dist``" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -16951,11 +16967,35 @@ msgstr "" "especificar uma versão particular de uma licença que é nomeada através do " "campo ``Classifier``, ou para indicar uma variação ou exceção a tal licença." -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +#, fuzzy +#| msgid "Requires-Dist (multiple use)" +msgid "License-File (multiple use)" +msgstr "Requires-Dist (vários usos)" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "Classifier (vários usos)" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -16967,23 +17007,30 @@ msgstr "" "Package Index publica uma lista dinâmica de `classificadores atualmente " "definidos `__." -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" "Este campo pode ser seguido por um marcador de ambiente após um ponto e " "vírgula." -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "Requires-Dist (vários usos)" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." @@ -16991,7 +17038,7 @@ msgstr "" "A especificação do formato de campo foi relaxada para aceitar a sintaxe " "usada por ferramentas de publicação populares." -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." @@ -16999,11 +17046,11 @@ msgstr "" "Cada entrada contém uma string nomeando algum outro projeto distutils " "requerido por esta distribuição." -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "O formato de uma string de requisito contém de uma a quatro partes:" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." @@ -17011,7 +17058,7 @@ msgstr "" "Um nome de projeto, no mesmo formato do campo ``Name:``. A única parte " "obrigatória." -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -17023,7 +17070,7 @@ msgstr "" "precisar de dependências extras. Os nomes DEVEM estar em conformidade com as " "restrições especificadas pelo campo ``Provides-Extra:``." -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." @@ -17032,7 +17079,7 @@ msgstr "" "aceitar parênteses opcionais em torno disso, mas as ferramentas que o geram " "não devem usar parênteses." -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." @@ -17040,11 +17087,11 @@ msgstr "" "Um marcador de ambiente após um ponto e vírgula. Isso significa que o " "requisito só é necessário nas condições especificadas." -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "Veja a :pep:`508` para detalhes completos do formato permitido." -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." @@ -17052,7 +17099,7 @@ msgstr "" "Os nomes dos projetos devem corresponder aos nomes encontrados no `Python " "Package Index`_." -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." @@ -17060,11 +17107,11 @@ msgstr "" "Os especificadores de versão devem seguir as regras descritas em :doc:" "`version-specifiers`." -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "Requires-Python" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " @@ -17074,12 +17121,12 @@ msgstr "" "é compatível. As ferramentas de instalação podem observar isso ao escolher " "qual versão de um projeto instalar." -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" "O valor deve estar no formato especificado em :doc:`version-specifiers`." -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 #, fuzzy msgid "" "For example, if a distribution uses :ref:`f-strings ` " @@ -17088,15 +17135,15 @@ msgstr "" "Por exemplo, se uma distribuição usa :ref:`f-strings ` " "então pode impedir a instalação em Python < 3.6 especificando::" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "Este campo não pode ser seguido por um marcador de ambiente." -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "Requires-External (vários usos)" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -17108,7 +17155,7 @@ msgstr "" "uma dica para os mantenedores do projeto downstream, e não tem semântica que " "seja significativa para a distribuição ``distutils``." -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." @@ -17116,7 +17163,7 @@ msgstr "" "O formato de uma string de requisito é o nome de uma dependência externa, " "opcionalmente seguido por uma declaração de versão entre parênteses." -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -17129,16 +17176,16 @@ msgstr "" "`: eles devem corresponder ao esquema de versão usado " "pela dependência externa." -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" "Observe que não há uma regra específica sobre as strings a serem usadas." -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "Project-URL (vários usos)" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." @@ -17146,15 +17193,15 @@ msgstr "" "Uma string contendo uma URL navegável para o projeto e um rótulo para ele, " "separados por uma vírgula." -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "O rótulo é um texto livre limitado a 32 caracteres." -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "Provides-Extra (vários usos)" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " @@ -17165,7 +17212,7 @@ msgstr "" "restrições de valor foram alinhadas com ``Name:`` e as regras de " "normalização foram introduzidas." -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -17179,7 +17226,7 @@ msgstr "" "hífen. Os nomes são limitados àqueles que correspondem ao seguinte regex " "(que elimina ambiguidade)::" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." @@ -17187,7 +17234,7 @@ msgstr "" "O nome especificado pode ser usado para tornar uma dependência condicional " "ao fato de o recurso opcional ter sido solicitado." -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -17199,7 +17246,7 @@ msgstr "" "(,). Os requisitos são avaliados para cada recurso solicitado e adicionados " "ao conjunto de requisitos para a distribuição." -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " @@ -17209,7 +17256,7 @@ msgstr "" "dependências que são necessárias para executar testes automatizados e gerar " "documentação, respectivamente." -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." @@ -17217,7 +17264,7 @@ msgstr "" "É válido especificar ``Provides-Extra:`` sem referenciá-lo em qualquer " "``Requer-Dist:``." -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -17229,7 +17276,7 @@ msgstr "" "realizar comparações. Ferramentas que escrevem metadados DEVEM gerar um erro " "se duas entradas ``Provides-Extra:`` colidirem após serem normalizadas." -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -17246,11 +17293,11 @@ msgstr "" "optar por gerar um erro ao ler um nome inválido para versões de metadados " "mais antigas." -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "Campos raramente usados" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -17262,7 +17309,7 @@ msgstr "" "Linux, e não está claro como as ferramentas devem interpretá-los no contexto " "de um servidor de indexação aberto, como `PyPI `__." -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -17278,11 +17325,11 @@ msgstr "" "informativos e também podem ser usados para o propósito originalmente " "pretendido em combinação com um repositório de pacotes com curadoria." -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "Provides-Dist (vários usos)" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " @@ -17292,7 +17339,7 @@ msgstr "" "contido nesta distribuição. Este campo *deve* incluir o projeto identificado " "no campo ``Name``, seguido da versão: Nome (Versão)." -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -17307,7 +17354,7 @@ msgstr "" "Instalar tal distribuição de código-fonte satisfaz os requisitos para " "``ZODB`` e ``transaction``." -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -17325,7 +17372,7 @@ msgstr "" "declarar que fornece ``ORM-bindings``, permitindo que outros projetos " "dependam apenas de ter no máximo um deles instalado." -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " @@ -17335,11 +17382,11 @@ msgstr "" "descritas em :doc:`version-specifiers`. O número da versão da distribuição " "estará implícito se nenhum for especificado." -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "Obsoletes-Dist (vários usos)" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " @@ -17349,7 +17396,7 @@ msgstr "" "distutils que esta distribuição torna obsoleta, o que significa que os dois " "projetos não devem ser instalados ao mesmo tempo." -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." @@ -17357,7 +17404,7 @@ msgstr "" "Declarações de versão podem ser fornecidas. Os números de versão devem estar " "no formato especificado em :doc:`version-specifiers`." -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " @@ -17367,19 +17414,19 @@ msgstr "" "projeto, por exemplo, Gorgon 2.3 é incluído no Torqued Python 1.0. Quando " "você instala o Torqued Python, a distribuição Gorgon deve ser removida." -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "Campos descontinuados" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "Requires" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "em favor de ``Requires-Dist``" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." @@ -17387,7 +17434,7 @@ msgstr "" "Cada entrada contém uma string descrevendo algum outro módulo ou pacote " "requerido por este pacote." -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " @@ -17397,7 +17444,7 @@ msgstr "" "pacote utilizável com a instrução ``import``, opcionalmente seguida por uma " "declaração de versão dentro de parênteses." -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -17415,7 +17462,7 @@ msgstr "" "release\" opcional no final que consiste na letra 'a' ou 'b' seguida de um " "número. Os números da versão do exemplo são \"1.0\", \"2.3a2\", \"1.3.99\"." -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." @@ -17423,7 +17470,7 @@ msgstr "" "Qualquer número de operadores condicionais pode ser especificado, por " "exemplo, a string \">1.0, !=1.3.4, <2.0\" é uma declaração de versão válida." -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." @@ -17431,7 +17478,7 @@ msgstr "" "Todos os seguintes são possíveis strings de requisito: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." @@ -17439,15 +17486,15 @@ msgstr "" "Não há nenhuma lista canônica de quais strings devem ser usadas; a " "comunidade Python é livre para escolher seus próprios padrões." -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "Provides" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "em favor de ``Provides-Dist``" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -17461,15 +17508,15 @@ msgstr "" "pode ser fornecida (sem um operador de comparação); o número de versão do " "pacote será implícito se nenhum for especificado." -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "Obsoletes" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "em favor de ``Obsoletes-Dist``" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " @@ -17479,7 +17526,7 @@ msgstr "" "pacote torna obsoleta, o que significa que os dois projetos não devem ser " "instalados ao mesmo tempo. Declarações de versão pode ser fornecidas." -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " @@ -17489,58 +17536,74 @@ msgstr "" "projeto, por exemplo, Gorgon 2.3 é incluído no Torqued Python 1.0. Quando " "você instala o Torqued Python, o pacote Gorgon deve ser removido." -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 #, fuzzy msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" "Adicionada documentação para o campo ``Description-Content-Type``. (:pr:" "`258`)" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "Adicionado o campo ``Dinâmico``." -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +#, fuzzy +#| msgid "Added the ``Dynamic`` field." +msgid "Added the ``License-Expression`` field." +msgstr "Adicionado o campo ``Dinâmico``." + +#: ../source/specifications/core-metadata.rst:927 +#, fuzzy +#| msgid "Added the ``Dynamic`` field." +msgid "Added the ``License-File`` field." +msgstr "Adicionado o campo ``Dinâmico``." + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "Marcação reStructuredText: https://docutils.sourceforge.io/" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" @@ -27282,6 +27345,9 @@ msgid "" "the file is empty)." msgstr "" +#~ msgid "``install``" +#~ msgstr "``install``" + #~ msgid "" #~ "There is a significant difference between the ``[build-system]`` and " #~ "``[project]`` tables. The former should always be present, regardless of " diff --git a/locales/ro/LC_MESSAGES/messages.po b/locales/ro/LC_MESSAGES/messages.po index 6f507cce0..54c4c6daa 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2021-08-20 01:32+0000\n" "Last-Translator: GUILHERME FERNANDES NETO \n" "Language-Team: Romanian ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1655,26 +1651,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12247,7 +12243,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12352,7 +12348,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12387,10 +12383,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12489,14 +12485,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12770,7 +12768,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12780,11 +12790,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12792,43 +12824,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12836,64 +12875,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12901,13 +12940,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12915,36 +12954,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12953,13 +12992,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12967,20 +13006,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -12988,7 +13027,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -12998,11 +13037,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13010,7 +13049,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13020,18 +13059,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13040,7 +13079,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13051,63 +13090,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13118,33 +13157,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13153,77 +13192,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/ru/LC_MESSAGES/messages.po b/locales/ru/LC_MESSAGES/messages.po index 2b5ece8bd..c93d868f4 100644 --- a/locales/ru/LC_MESSAGES/messages.po +++ b/locales/ru/LC_MESSAGES/messages.po @@ -13,7 +13,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2024-07-15 14:09+0000\n" "Last-Translator: gfbdrgng \n" "Language-Team: Russian ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -2148,11 +2144,11 @@ msgstr "" "отсутствие :file:`pyproject.toml' файла и его ``[build-system]`` таблица " "предполагает, что :term:`build backend ` является setuptools." -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "Почему? Что все это значит?" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." @@ -2160,16 +2156,16 @@ msgstr "" "Один из способов взглянуть на это заключается в том, что сфера setuptools " "теперь была сведена к роли опоры." -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "Где почитать об этом?" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr ":doc:`setuptools:deprecated/commands`" @@ -16341,7 +16337,7 @@ msgstr "" "установленным пакетом, прежде чем принять его за настоящую ошибку." #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -16470,9 +16466,13 @@ msgid "Metadata-Version" msgstr "Metadata-Version" #: ../source/specifications/core-metadata.rst:50 +#, fuzzy +#| msgid "" +#| "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " +#| "\"2.1\", \"2.2\", and \"2.3\"." msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" "Версия формата файла; допустимые значения: \"1.0\", \"1.1\", \"1.2\", " "\"2.1\", \"2.2\" и \"2.3\"." @@ -16518,10 +16518,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "Пример::" @@ -16648,14 +16648,16 @@ msgstr "" "система\". См. раздел \"Классификатор\" ниже." #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "Примеры::" @@ -17018,7 +17020,21 @@ msgstr "" msgid "License" msgstr "Лицензия" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +#, fuzzy +#| msgid "in favour of ``Requires-Dist``" +msgid "in favour of ``License-Expression``." +msgstr "в пользу ``Requires-Dist``" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -17034,11 +17050,35 @@ msgstr "" "``Классификатор'', или для указания разновидности или исключения из такой " "лицензии." -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +#, fuzzy +#| msgid "Requires-Dist (multiple use)" +msgid "License-File (multiple use)" +msgstr "Requires-Dist (можно использовать несколько раз)" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "Classifier (можно использовать несколько раз)" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -17050,21 +17090,28 @@ msgstr "" "Index публикует динамический список `определенных в данный момент " "классификаторов` `__." -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "За этим полем может следовать маркер окружения после точки с запятой." -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "Requires-Dist (можно использовать несколько раз)" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." @@ -17072,7 +17119,7 @@ msgstr "" "Спецификация формата полей была смягчена, чтобы принять синтаксис, " "используемый популярными издательскими инструментами." -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." @@ -17080,11 +17127,11 @@ msgstr "" "Каждая запись содержит строку с названием другого проекта distutils, " "необходимого для данного дистрибутива." -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "Формат строки требований содержит от одной до четырех частей:" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." @@ -17092,7 +17139,7 @@ msgstr "" "Название проекта в том же формате, что и поле ``Имя:``. Единственная " "обязательная часть." -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -17104,7 +17151,7 @@ msgstr "" "потребоваться дополнительные зависимости. Имена ДОЛЖНЫ соответствовать " "ограничениям, указанным в поле ``Provides-Extra:``." -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." @@ -17113,7 +17160,7 @@ msgstr "" "необязательные круглые скобки вокруг него, но инструменты, генерирующие его, " "не должны использовать круглые скобки." -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." @@ -17121,11 +17168,11 @@ msgstr "" "Маркер окружения после точки с запятой. Это означает, что требование " "необходимо только в указанных условиях." -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "Подробную информацию о допустимом формате см. в :pep:`508`." -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." @@ -17133,7 +17180,7 @@ msgstr "" "Имена проектов должны соответствовать именам, найденным в `Python Package " "Index`_." -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." @@ -17141,11 +17188,11 @@ msgstr "" "Спецификаторы версий должны следовать правилам, описанным в :doc:`version-" "specifiers`." -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "Requires-Python" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " @@ -17155,11 +17202,11 @@ msgstr "" "дистрибутив. Утилиты установки могут учитывать это поле при выборе версии " "проекта для установки." -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "Значение должно быть в формате, указанном в :doc:`version-specifiers`." -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" @@ -17167,15 +17214,15 @@ msgstr "" "Например, если дистрибутив использует :ref:`f-strings `, " "то он может предотвратить установку на Python < 3.6, указав::" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "За этим полем не может следовать маркер окружения." -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "Requires-External (можно использовать несколько раз)" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -17187,7 +17234,7 @@ msgstr "" "сопровождающих проектов и не имеет семантики, значимой для дистрибутива " "``distutils``." -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." @@ -17195,7 +17242,7 @@ msgstr "" "Формат строки требований - это имя внешней зависимости, за которым в круглых " "скобках по желанию следует объявление версии." -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -17207,17 +17254,17 @@ msgstr "" "указанному в :ref:`Спецификация спецификатора версии `: " "они должны соответствовать схеме версий, используемой внешней зависимостью." -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" "Обратите внимание, что нет никаких особых правил относительно используемых " "строк." -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "Project-URL (можно использовать несколько раз)" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." @@ -17225,16 +17272,16 @@ msgstr "" "Строка, содержащая просматриваемый URL-адрес проекта и его метку, " "разделенные запятой." -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" "Этикетка представляет собой свободный текст, ограниченный 32 символами." -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "Provides-Extra (можно использовать несколько раз)" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " @@ -17245,7 +17292,7 @@ msgstr "" "ограничения на значения были приведены в соответствие с ``Name:`` и были " "введены правила нормализации." -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -17259,7 +17306,7 @@ msgstr "" "Имена ограничиваются теми, которые соответствуют следующему регексу (который " "гарантирует однозначность)::" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." @@ -17267,7 +17314,7 @@ msgstr "" "Указанное имя можно использовать, чтобы сделать зависимость зависимой от " "того, была ли запрошена необязательная функция." -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -17279,7 +17326,7 @@ msgstr "" "(,). Требования оцениваются для каждой запрошенной функции и добавляются к " "набору требований для дистрибутива." -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " @@ -17289,7 +17336,7 @@ msgstr "" "зависимостей, необходимых для выполнения автоматизированных тестов и " "создания документации, соответственно." -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." @@ -17297,7 +17344,7 @@ msgstr "" "Разрешается указывать ``Provides-Extra:`` без ссылки на него в каком-либо " "``Requires-Dist:``." -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -17309,7 +17356,7 @@ msgstr "" "при выполнении сравнений. Средства записи метаданных ДОЛЖНЫ выдавать ошибку, " "если две записи ``Provides-Extra:`` будут конфликтовать после нормализации." -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -17326,11 +17373,11 @@ msgstr "" "Инструментальные средства МОГУТ выдавать ошибку при чтении недопустимого " "имени для старых версий метаданных." -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "Редко используемые поля" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -17343,7 +17390,7 @@ msgstr "" "интерпретировать их в контексте открытого индексного сервера, такого как " "`PyPI `__." -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -17359,11 +17406,11 @@ msgstr "" "использованы по своему первоначальному назначению в сочетании с курируемым " "репозиторием пакетов." -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "Provides-Dist (можно использовать несколько раз)" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " @@ -17373,7 +17420,7 @@ msgstr "" "содержится в этом дистрибутиве. Это поле *должно* включать проект, " "указанный в поле ``Имя``, за которым следует версия : Имя (Версия)." -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -17388,7 +17435,7 @@ msgstr "" "исходного дистрибутива удовлетворяет требованиям как для ``ZODB``, так и для " "``transaction``." -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -17407,7 +17454,7 @@ msgstr "" "позволяя другим проектам зависеть только от наличия хотя бы одной из этих " "привязок." -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " @@ -17417,11 +17464,11 @@ msgstr "" "правилам, описанным в :doc:`version-specifiers`. Номер версии дистрибутива " "будет подразумеваться, если он не указан." -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "Obsoletes-Dist (можно использовать несколько раз)" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " @@ -17431,7 +17478,7 @@ msgstr "" "который этот дистрибутив делает устаревшим, что означает, что эти два " "проекта не должны быть установлены одновременно." -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." @@ -17439,7 +17486,7 @@ msgstr "" "Декларации версий могут быть предоставлены. Номера версий должны быть в " "формате, указанном в :doc:`version-specifiers`." -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " @@ -17449,19 +17496,19 @@ msgstr "" "например, когда Gorgon 2.3 переходит в Torqued Python 1.0. При установке " "Torqued Python дистрибутив Gorgon должен быть удален." -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "Утраченные поля" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "Требуется" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "в пользу ``Requires-Dist``" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." @@ -17469,7 +17516,7 @@ msgstr "" "Каждая запись содержит строку, описывающую другой модуль или пакет, " "необходимый для данного пакета." -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " @@ -17479,7 +17526,7 @@ msgstr "" "используемого с помощью оператора ``импорта``, за которым в круглых скобках " "по желанию следует объявление версии." -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -17497,7 +17544,7 @@ msgstr "" "конце, состоящим из буквы 'a' или 'b', за которой следует число. Примеры " "номеров версий: \"1.0\", \"2.3a2\", \"1.3.99\"," -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." @@ -17505,7 +17552,7 @@ msgstr "" "Можно указать любое количество условных операторов, например, строка " "\">1.0, !=1.3.4, <2.0\" является законным объявлением версии." -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." @@ -17513,7 +17560,7 @@ msgstr "" "Возможными строками требований являются все следующие: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." @@ -17521,15 +17568,15 @@ msgstr "" "Не существует канонического списка того, какие строки должны использоваться; " "сообщество Python оставляет за собой право выбирать собственные стандарты." -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "Предоставляет" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "в пользу ``Provides-Dist``" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -17543,15 +17590,15 @@ msgstr "" "версии (без оператора сравнения); номер версии пакета будет подразумеваться, " "если он не указан." -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "Обзоры" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "в пользу ``Obsoletes-Dist``" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " @@ -17561,7 +17608,7 @@ msgstr "" "пакет делает устаревшим, что означает, что эти два пакета не должны быть " "установлены одновременно. Могут быть предоставлены объявления версий." -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " @@ -17571,55 +17618,73 @@ msgstr "" "например, Gorgon 2.3 переходит в Torqued Python 1.0. При установке Torqued " "Python пакет Gorgon должен быть удален." -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "Март 2001: Core metadata 1.0 был одобрен через :pep:`241`." -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "Апрель 2003 года: Core metadata 1.1 был одобрен через :pep:`314`:" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "Февраль 2010 г: Core metadata 1.2 был одобрен через :pep:`345`." -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "Февраль 2018 г: Core metadata 2.1 был одобрен через :pep:`566`." -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "Добавлены ``Description-Content-Type`` и ``Provides-Extra``." -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "Добавлен метод canonical для преобразования метаданных в JSON." -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "Ограничение грамматики поля ``Имя``." -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "Октябрь 2020 года: Core metadata 2.2 был одобрен через :pep:`643`." -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "Добавлено поле ``Динамика``." -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "Март 2022: Core metadata 2.3 был одобрен через :pep:`685`." -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "Ограниченные дополнительные имена, подлежащие нормализации." -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +#, fuzzy +#| msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "Октябрь 2020 года: Core metadata 2.2 был одобрен через :pep:`643`." + +#: ../source/specifications/core-metadata.rst:926 +#, fuzzy +#| msgid "Added the ``Dynamic`` field." +msgid "Added the ``License-Expression`` field." +msgstr "Добавлено поле ``Динамика``." + +#: ../source/specifications/core-metadata.rst:927 +#, fuzzy +#| msgid "Added the ``Dynamic`` field." +msgid "Added the ``License-File`` field." +msgstr "Добавлено поле ``Динамика``." + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "Разметка reStructuredText: https://docutils.sourceforge.io/" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "Длинные поля заголовка RFC 822: :rfc:`822#section-3.1.1`" @@ -29200,6 +29265,9 @@ msgstr "" "Если вы только начинаете с Python упаковки, рекомендуется придерживаться " "*регулярных пакетов* и ``__init__.py`` (даже если файл пуст)." +#~ msgid "``install``" +#~ msgstr "``install``" + #~ msgid "" #~ "There is a significant difference between the ``[build-system]`` and " #~ "``[project]`` tables. The former should always be present, regardless of " diff --git a/locales/sai/LC_MESSAGES/messages.po b/locales/sai/LC_MESSAGES/messages.po index 62f53bcd2..93efa0e6f 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1553,50 +1553,46 @@ msgid "``egg_info``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:144 -msgid "``install``" -msgstr "" - -#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_data``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:146 +#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_egg_info``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:147 +#: ../source/discussions/setup-py-deprecated.rst:146 msgid "``install_headers``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:148 +#: ../source/discussions/setup-py-deprecated.rst:147 msgid "``install_lib``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:149 +#: ../source/discussions/setup-py-deprecated.rst:148 msgid "``install_scripts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:150 +#: ../source/discussions/setup-py-deprecated.rst:149 msgid "``rotate``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:151 +#: ../source/discussions/setup-py-deprecated.rst:150 msgid "``saveopts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:152 +#: ../source/discussions/setup-py-deprecated.rst:151 msgid "``setopt``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:153 +#: ../source/discussions/setup-py-deprecated.rst:152 msgid "``upload_docs``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:157 +#: ../source/discussions/setup-py-deprecated.rst:156 msgid "What about custom commands?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:159 +#: ../source/discussions/setup-py-deprecated.rst:158 msgid "" "Likewise, custom :file:`setup.py` commands are deprecated. The " "recommendation is to migrate those custom commands to a task runner tool or " @@ -1604,46 +1600,46 @@ msgid "" "tox, pydoit, pyinvoke, taskipy, and thx." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:167 +#: ../source/discussions/setup-py-deprecated.rst:166 msgid "What about custom build steps?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:169 +#: ../source/discussions/setup-py-deprecated.rst:168 msgid "" "Custom build steps that for example either overwrite existing steps such as " "``build_py``, ``build_ext``, and ``bdist_wheel`` or add new build steps are " "not deprecated. Those will be automatically called as expected." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:176 +#: ../source/discussions/setup-py-deprecated.rst:175 #: ../source/guides/modernize-setup-py-project.rst:21 msgid "Should ``setup.py`` be deleted?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:178 +#: ../source/discussions/setup-py-deprecated.rst:177 msgid "" "Although the usage of :file:`setup.py` as an executable script is " "deprecated, its usage as a configuration file for setuptools is absolutely " "fine. There is likely no modification needed in :file:`setup.py`." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:184 +#: ../source/discussions/setup-py-deprecated.rst:183 msgid "Is ``pyproject.toml`` mandatory?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:186 +#: ../source/discussions/setup-py-deprecated.rst:185 msgid "" "While it is not technically necessary yet, it is **STRONGLY RECOMMENDED** " "for a project to have a :file:`pyproject.toml` file at the root of its " "source tree with a content like this:" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:197 +#: ../source/discussions/setup-py-deprecated.rst:196 msgid "" "The guide :ref:`modernize-setup-py-project` has more details about this." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:199 +#: ../source/discussions/setup-py-deprecated.rst:198 msgid "" "The standard fallback behavior for a :term:`build frontend ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1651,26 +1647,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12239,7 +12235,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12344,7 +12340,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12379,10 +12375,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12481,14 +12477,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12762,7 +12760,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12772,11 +12782,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12784,43 +12816,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12828,64 +12867,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12893,13 +12932,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12907,36 +12946,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12945,13 +12984,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12959,20 +12998,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -12980,7 +13019,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -12990,11 +13029,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13002,7 +13041,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13012,18 +13051,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13032,7 +13071,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13043,63 +13082,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13110,33 +13149,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13145,77 +13184,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/si/LC_MESSAGES/messages.po b/locales/si/LC_MESSAGES/messages.po index 4b1f04f0d..12b706cab 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2022-06-11 08:19+0000\n" "Last-Translator: Kushan Gunasekera \n" "Language-Team: Sinhala ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1655,26 +1651,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12243,7 +12239,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12348,7 +12344,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12383,10 +12379,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12485,14 +12481,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12766,7 +12764,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12776,11 +12786,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12788,43 +12820,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12832,64 +12871,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12897,13 +12936,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12911,36 +12950,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12949,13 +12988,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12963,20 +13002,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -12984,7 +13023,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -12994,11 +13033,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13006,7 +13045,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13016,18 +13055,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13036,7 +13075,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13047,63 +13086,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13114,33 +13153,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13149,77 +13188,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/sk/LC_MESSAGES/messages.po b/locales/sk/LC_MESSAGES/messages.po index 1a18c988d..b42bdf24d 100644 --- a/locales/sk/LC_MESSAGES/messages.po +++ b/locales/sk/LC_MESSAGES/messages.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2024-04-25 06:07+0000\n" "Last-Translator: Rafael Fontenelle \n" "Language-Team: Slovak ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1763,26 +1759,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12399,7 +12395,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12504,7 +12500,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12539,10 +12535,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12641,14 +12637,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12922,7 +12920,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12932,11 +12942,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12944,43 +12976,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12988,64 +13027,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -13053,13 +13092,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -13067,36 +13106,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -13105,13 +13144,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -13119,20 +13158,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -13140,7 +13179,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13150,11 +13189,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13162,7 +13201,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13172,18 +13211,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13192,7 +13231,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13203,63 +13242,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13270,33 +13309,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13305,77 +13344,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/ta/LC_MESSAGES/messages.po b/locales/ta/LC_MESSAGES/messages.po index 76e14ef79..9f387eee3 100644 --- a/locales/ta/LC_MESSAGES/messages.po +++ b/locales/ta/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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1553,50 +1553,46 @@ msgid "``egg_info``" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:144 -msgid "``install``" -msgstr "" - -#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_data``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:146 +#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_egg_info``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:147 +#: ../source/discussions/setup-py-deprecated.rst:146 msgid "``install_headers``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:148 +#: ../source/discussions/setup-py-deprecated.rst:147 msgid "``install_lib``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:149 +#: ../source/discussions/setup-py-deprecated.rst:148 msgid "``install_scripts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:150 +#: ../source/discussions/setup-py-deprecated.rst:149 msgid "``rotate``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:151 +#: ../source/discussions/setup-py-deprecated.rst:150 msgid "``saveopts``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:152 +#: ../source/discussions/setup-py-deprecated.rst:151 msgid "``setopt``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:153 +#: ../source/discussions/setup-py-deprecated.rst:152 msgid "``upload_docs``" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:157 +#: ../source/discussions/setup-py-deprecated.rst:156 msgid "What about custom commands?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:159 +#: ../source/discussions/setup-py-deprecated.rst:158 msgid "" "Likewise, custom :file:`setup.py` commands are deprecated. The " "recommendation is to migrate those custom commands to a task runner tool or " @@ -1604,46 +1600,46 @@ msgid "" "tox, pydoit, pyinvoke, taskipy, and thx." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:167 +#: ../source/discussions/setup-py-deprecated.rst:166 msgid "What about custom build steps?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:169 +#: ../source/discussions/setup-py-deprecated.rst:168 msgid "" "Custom build steps that for example either overwrite existing steps such as " "``build_py``, ``build_ext``, and ``bdist_wheel`` or add new build steps are " "not deprecated. Those will be automatically called as expected." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:176 +#: ../source/discussions/setup-py-deprecated.rst:175 #: ../source/guides/modernize-setup-py-project.rst:21 msgid "Should ``setup.py`` be deleted?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:178 +#: ../source/discussions/setup-py-deprecated.rst:177 msgid "" "Although the usage of :file:`setup.py` as an executable script is " "deprecated, its usage as a configuration file for setuptools is absolutely " "fine. There is likely no modification needed in :file:`setup.py`." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:184 +#: ../source/discussions/setup-py-deprecated.rst:183 msgid "Is ``pyproject.toml`` mandatory?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:186 +#: ../source/discussions/setup-py-deprecated.rst:185 msgid "" "While it is not technically necessary yet, it is **STRONGLY RECOMMENDED** " "for a project to have a :file:`pyproject.toml` file at the root of its " "source tree with a content like this:" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:197 +#: ../source/discussions/setup-py-deprecated.rst:196 msgid "" "The guide :ref:`modernize-setup-py-project` has more details about this." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:199 +#: ../source/discussions/setup-py-deprecated.rst:198 msgid "" "The standard fallback behavior for a :term:`build frontend ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1651,26 +1647,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12239,7 +12235,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12344,7 +12340,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12379,10 +12375,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12481,14 +12477,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12762,7 +12760,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12772,11 +12782,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12784,43 +12816,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12828,64 +12867,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12893,13 +12932,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12907,36 +12946,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12945,13 +12984,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12959,20 +12998,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -12980,7 +13019,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -12990,11 +13029,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13002,7 +13041,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13012,18 +13051,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13032,7 +13071,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13043,63 +13082,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13110,33 +13149,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13145,77 +13184,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/uk/LC_MESSAGES/messages.po b/locales/uk/LC_MESSAGES/messages.po index d93cb0524..979591561 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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2024-03-01 20:00+0000\n" "Last-Translator: Sviatoslav Sydorenko \n" "Language-Team: Ukrainian ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1976,26 +1970,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12762,7 +12756,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12867,7 +12861,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12902,10 +12896,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "Приклад::" @@ -13004,14 +12998,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "Приклади::" @@ -13285,7 +13281,19 @@ msgstr "" msgid "License" msgstr "License" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -13295,11 +13303,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -13307,43 +13337,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -13351,64 +13388,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -13416,13 +13453,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -13430,36 +13467,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -13468,13 +13505,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -13482,20 +13519,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -13503,7 +13540,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13513,11 +13550,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13525,7 +13562,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13535,18 +13572,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13555,7 +13592,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13566,65 +13603,65 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 #, fuzzy #| msgid "Requirements files" msgid "Requires" msgstr "Файли requirements" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13635,33 +13672,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13670,77 +13707,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" @@ -22189,6 +22238,11 @@ msgid "" "the file is empty)." msgstr "" +#, fuzzy +#~| msgid "``pip install app``" +#~ msgid "``install``" +#~ msgstr "``pip install app``" + #, fuzzy #~| msgid "Examples::" #~ msgid "Examples:" diff --git a/locales/vi/LC_MESSAGES/messages.po b/locales/vi/LC_MESSAGES/messages.po index b79590b89..db90ef79d 100644 --- a/locales/vi/LC_MESSAGES/messages.po +++ b/locales/vi/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-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2024-07-25 13:10+0000\n" "Last-Translator: Lenny Tran \n" "Language-Team: Vietnamese ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1679,26 +1675,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12267,7 +12263,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12372,7 +12368,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12407,10 +12403,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -12509,14 +12505,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "" @@ -12790,7 +12788,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12800,11 +12810,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12812,43 +12844,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12856,64 +12895,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12921,13 +12960,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -12935,36 +12974,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -12973,13 +13012,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -12987,20 +13026,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -13008,7 +13047,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13018,11 +13057,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13030,7 +13069,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13040,18 +13079,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13060,7 +13099,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13071,63 +13110,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13138,33 +13177,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13173,77 +13212,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/zh_Hans/LC_MESSAGES/messages.po b/locales/zh_Hans/LC_MESSAGES/messages.po index 1b2057e4e..126f96595 100644 --- a/locales/zh_Hans/LC_MESSAGES/messages.po +++ b/locales/zh_Hans/LC_MESSAGES/messages.po @@ -25,22 +25,23 @@ # Autuamn End , 2023. # Thomas , 2023, 2024. # 大王叫我来巡山 , 2024. +# Peter Shen , 2024. msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-08-24 00:21+0000\n" -"PO-Revision-Date: 2024-07-30 13:48+0000\n" +"POT-Creation-Date: 2024-09-19 12:53+0000\n" +"PO-Revision-Date: 2024-09-21 00:40+0000\n" "Last-Translator: 大王叫我来巡山 \n" -"Language-Team: Chinese (Simplified) \n" +"Language-Team: Chinese (Simplified Han script) \n" "Language: zh_Hans\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=1; plural=0;\n" -"X-Generator: Weblate 5.7-dev\n" +"X-Generator: Weblate 5.8-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" @@ -800,11 +801,11 @@ msgstr "" msgid "" "You can use an import package as soon as you have installed a distribution " "package that provides it." -msgstr "" +msgstr "一旦你安装了提供该包的分发包，你就可以使用导入包。" #: ../source/discussions/distribution-package-vs-import-package.rst:47 msgid "What are the links between distribution packages and import packages?" -msgstr "" +msgstr "分发包和导入包之间有什么联系？" #: ../source/discussions/distribution-package-vs-import-package.rst:49 msgid "" @@ -812,6 +813,8 @@ msgid "" "(or non-package module), with a matching name. For example, ``pip install " "numpy`` lets you ``import numpy``." msgstr "" +"大多数情况下，分发包会提供一个具有匹配名称的导入包（或非包模块）。例如，" +"``pip install numpy``允许你``import numpy``。" #: ../source/discussions/distribution-package-vs-import-package.rst:53 msgid "" @@ -1755,46 +1758,57 @@ msgid "``install``" msgstr "``install``" #: ../source/discussions/setup-py-deprecated.rst:145 +#: ../source/discussions/setup-py-deprecated.rst:144 msgid "``install_data``" msgstr "``install_data``" #: ../source/discussions/setup-py-deprecated.rst:146 +#: ../source/discussions/setup-py-deprecated.rst:145 msgid "``install_egg_info``" msgstr "``install_egg_info``" #: ../source/discussions/setup-py-deprecated.rst:147 +#: ../source/discussions/setup-py-deprecated.rst:146 msgid "``install_headers``" msgstr "``install_headers``" #: ../source/discussions/setup-py-deprecated.rst:148 +#: ../source/discussions/setup-py-deprecated.rst:147 msgid "``install_lib``" msgstr "``install_lib``" #: ../source/discussions/setup-py-deprecated.rst:149 +#: ../source/discussions/setup-py-deprecated.rst:148 msgid "``install_scripts``" msgstr "``install_scripts``" #: ../source/discussions/setup-py-deprecated.rst:150 +#: ../source/discussions/setup-py-deprecated.rst:149 msgid "``rotate``" msgstr "``rotate``" #: ../source/discussions/setup-py-deprecated.rst:151 +#: ../source/discussions/setup-py-deprecated.rst:150 msgid "``saveopts``" msgstr "``saveopts``" #: ../source/discussions/setup-py-deprecated.rst:152 +#: ../source/discussions/setup-py-deprecated.rst:151 msgid "``setopt``" msgstr "``setopt``" #: ../source/discussions/setup-py-deprecated.rst:153 +#: ../source/discussions/setup-py-deprecated.rst:152 msgid "``upload_docs``" msgstr "``upload_docs``" #: ../source/discussions/setup-py-deprecated.rst:157 +#: ../source/discussions/setup-py-deprecated.rst:156 msgid "What about custom commands?" msgstr "那自定义命令又如何？" #: ../source/discussions/setup-py-deprecated.rst:159 +#: ../source/discussions/setup-py-deprecated.rst:158 msgid "" "Likewise, custom :file:`setup.py` commands are deprecated. The " "recommendation is to migrate those custom commands to a task runner tool or " @@ -1806,10 +1820,12 @@ msgstr "" "pyinvoke、taskipy 和 thx。" #: ../source/discussions/setup-py-deprecated.rst:167 +#: ../source/discussions/setup-py-deprecated.rst:166 msgid "What about custom build steps?" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:169 +#: ../source/discussions/setup-py-deprecated.rst:168 msgid "" "Custom build steps that for example either overwrite existing steps such as " "``build_py``, ``build_ext``, and ``bdist_wheel`` or add new build steps are " @@ -1818,10 +1834,12 @@ msgstr "" #: ../source/discussions/setup-py-deprecated.rst:176 #: ../source/guides/modernize-setup-py-project.rst:21 +#: ../source/discussions/setup-py-deprecated.rst:175 msgid "Should ``setup.py`` be deleted?" msgstr "是否应该删除 ``setup.py``？" #: ../source/discussions/setup-py-deprecated.rst:178 +#: ../source/discussions/setup-py-deprecated.rst:177 msgid "" "Although the usage of :file:`setup.py` as an executable script is " "deprecated, its usage as a configuration file for setuptools is absolutely " @@ -1831,10 +1849,12 @@ msgstr "" "文件完全没有问题，甚至可能不需要修改 :file:`setup.py`。" #: ../source/discussions/setup-py-deprecated.rst:184 +#: ../source/discussions/setup-py-deprecated.rst:183 msgid "Is ``pyproject.toml`` mandatory?" msgstr "``pyproject.toml`` 是强制性的吗？" #: ../source/discussions/setup-py-deprecated.rst:186 +#: ../source/discussions/setup-py-deprecated.rst:185 msgid "" "While it is not technically necessary yet, it is **STRONGLY RECOMMENDED** " "for a project to have a :file:`pyproject.toml` file at the root of its " @@ -1844,11 +1864,13 @@ msgstr "" "个 :file:`pyproject.toml` 文件，并拥有以下内容：" #: ../source/discussions/setup-py-deprecated.rst:197 +#: ../source/discussions/setup-py-deprecated.rst:196 msgid "" "The guide :ref:`modernize-setup-py-project` has more details about this." msgstr "指南 :ref:`modernize-setup-py-project` 有更多相关细节。" #: ../source/discussions/setup-py-deprecated.rst:199 +#: ../source/discussions/setup-py-deprecated.rst:198 msgid "" "The standard fallback behavior for a :term:`build frontend ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1857,10 +1879,12 @@ msgid "" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" #: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." @@ -1868,14 +1892,17 @@ msgstr "" #: ../source/discussions/setup-py-deprecated.rst:212 #: ../source/guides/modernize-setup-py-project.rst:244 +#: ../source/discussions/setup-py-deprecated.rst:211 msgid "Where to read more about this?" msgstr "从哪里可以了解更多相关信息？" #: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" #: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr ":doc:`setuptools:deprecated/commands`" @@ -1885,13 +1912,11 @@ msgstr "" #: ../source/discussions/single-source-version.rst:7 #, fuzzy -#| msgid "Incomplete" msgid "Complete" msgstr "不完全" #: ../source/discussions/single-source-version.rst:8 #, fuzzy -#| msgid "2021-8-24" msgid "2024-08-24" msgstr "2021-8-24" @@ -1979,7 +2004,6 @@ msgstr "" #: ../source/discussions/single-source-version.rst:41 #, fuzzy -#| msgid "`Apache `_" msgid "`Hatchling `_" msgstr "`Apache `_" @@ -9182,10 +9206,6 @@ msgstr "" #: ../source/guides/writing-pyproject-toml.rst:133 #, fuzzy -#| msgid "" -#| "The project name must consists of ASCII letters, digits, underscores " -#| "\"``_``\", hyphens \"``-``\" and periods \"``.``\". It must not start or " -#| "end with an underscore, hyphen or period." msgid "" "The project name must consist of ASCII letters, digits, underscores " "\"``_``\", hyphens \"``-``\" and periods \"``.``\". It must not start or end " @@ -12916,7 +12936,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -13021,7 +13041,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -13056,10 +13076,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "" @@ -13158,14 +13178,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "例子::" @@ -13439,7 +13461,19 @@ msgstr "" msgid "License" msgstr "" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -13449,11 +13483,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -13461,43 +13517,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -13505,64 +13568,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -13570,13 +13633,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -13584,36 +13647,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -13622,13 +13685,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -13636,20 +13699,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -13657,7 +13720,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13667,11 +13730,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13679,7 +13742,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13689,18 +13752,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13709,7 +13772,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13720,64 +13783,64 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 #, fuzzy msgid "Requires" msgstr "要求" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13788,33 +13851,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13823,77 +13886,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "reStructuredText 标记：https://docutils.sourceforge.io/" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr "" diff --git a/locales/zh_Hant/LC_MESSAGES/messages.po b/locales/zh_Hant/LC_MESSAGES/messages.po index 074e92dff..bd2ec383d 100644 --- a/locales/zh_Hant/LC_MESSAGES/messages.po +++ b/locales/zh_Hant/LC_MESSAGES/messages.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-08-24 00:21+0000\n" +"POT-Creation-Date: 2024-09-24 16:09+0000\n" "PO-Revision-Date: 2024-07-03 11:26+0000\n" "Last-Translator: Ricky From Hong Kong \n" "Language-Team: Chinese (Traditional) ` " "in the absence of a :file:`pyproject.toml` file and its ``[build-system]`` " @@ -1687,26 +1683,26 @@ msgid "" "setuptools." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:205 +#: ../source/discussions/setup-py-deprecated.rst:204 msgid "Why? What does it all mean?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:207 +#: ../source/discussions/setup-py-deprecated.rst:206 msgid "" "One way to look at it is that the scope of setuptools has now been reduced " "to the role of a build backend." msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:212 +#: ../source/discussions/setup-py-deprecated.rst:211 #: ../source/guides/modernize-setup-py-project.rst:244 msgid "Where to read more about this?" msgstr "" -#: ../source/discussions/setup-py-deprecated.rst:214 +#: ../source/discussions/setup-py-deprecated.rst:213 msgid "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" msgstr "https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html" -#: ../source/discussions/setup-py-deprecated.rst:216 +#: ../source/discussions/setup-py-deprecated.rst:215 msgid ":doc:`setuptools:deprecated/commands`" msgstr "" @@ -12340,7 +12336,7 @@ msgid "" msgstr "" #: ../source/specifications/binary-distribution-format.rst:421 -#: ../source/specifications/core-metadata.rst:848 +#: ../source/specifications/core-metadata.rst:905 #: ../source/specifications/dependency-specifiers.rst:477 #: ../source/specifications/direct-url-data-structure.rst:397 #: ../source/specifications/direct-url.rst:67 @@ -12445,7 +12441,7 @@ msgstr "" #: ../source/specifications/core-metadata.rst:50 msgid "" "Version of the file format; legal values are \"1.0\", \"1.1\", \"1.2\", " -"\"2.1\", \"2.2\", and \"2.3\"." +"\"2.1\", \"2.2\", \"2.3\", and \"2.4\"." msgstr "" #: ../source/specifications/core-metadata.rst:53 @@ -12480,10 +12476,10 @@ msgstr "" #: ../source/specifications/core-metadata.rst:399 #: ../source/specifications/core-metadata.rst:424 #: ../source/specifications/core-metadata.rst:446 -#: ../source/specifications/core-metadata.rst:609 -#: ../source/specifications/core-metadata.rst:640 -#: ../source/specifications/core-metadata.rst:650 -#: ../source/specifications/core-metadata.rst:842 +#: ../source/specifications/core-metadata.rst:666 +#: ../source/specifications/core-metadata.rst:697 +#: ../source/specifications/core-metadata.rst:707 +#: ../source/specifications/core-metadata.rst:899 msgid "Example::" msgstr "例子::" @@ -12582,14 +12578,16 @@ msgid "" msgstr "" #: ../source/specifications/core-metadata.rst:147 -#: ../source/specifications/core-metadata.rst:471 -#: ../source/specifications/core-metadata.rst:495 -#: ../source/specifications/core-metadata.rst:536 -#: ../source/specifications/core-metadata.rst:592 -#: ../source/specifications/core-metadata.rst:725 -#: ../source/specifications/core-metadata.rst:755 -#: ../source/specifications/core-metadata.rst:796 -#: ../source/specifications/core-metadata.rst:818 +#: ../source/specifications/core-metadata.rst:479 +#: ../source/specifications/core-metadata.rst:500 +#: ../source/specifications/core-metadata.rst:523 +#: ../source/specifications/core-metadata.rst:552 +#: ../source/specifications/core-metadata.rst:593 +#: ../source/specifications/core-metadata.rst:649 +#: ../source/specifications/core-metadata.rst:782 +#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:875 msgid "Examples::" msgstr "例子::" @@ -12863,7 +12861,19 @@ msgstr "" msgid "License" msgstr "許可證" -#: ../source/specifications/core-metadata.rst:464 +#: ../source/specifications/core-metadata.rst:463 +msgid "in favour of ``License-Expression``." +msgstr "" + +#: ../source/specifications/core-metadata.rst:467 +msgid "" +"As of Metadata 2.4, ``License`` and ``License-Expression`` are mutually " +"exclusive. If both are specified, tools which parse metadata will disregard " +"``License`` and PyPI will reject uploads. See `PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:472 msgid "" "Text indicating the license covering the distribution where the license is " "not a selection from the \"License\" Trove classifiers. See :ref:" @@ -12873,11 +12883,33 @@ msgid "" "license." msgstr "" -#: ../source/specifications/core-metadata.rst:484 +#: ../source/specifications/core-metadata.rst:492 +msgid "License-Expression" +msgstr "" + +#: ../source/specifications/core-metadata.rst:496 +msgid "" +"Text string that is a valid SPDX `license expression `__ as `defined in PEP 639 `__." +msgstr "" + +#: ../source/specifications/core-metadata.rst:515 +msgid "License-File (multiple use)" +msgstr "" + +#: ../source/specifications/core-metadata.rst:519 +msgid "" +"Each entry is a string representation of the path of a license-related file. " +"The path is located within the project source tree, relative to the project " +"root directory. For details see :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:536 msgid "Classifier (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:488 +#: ../source/specifications/core-metadata.rst:540 msgid "" "Each entry is a string giving a single classification value for the " "distribution. Classifiers are described in :pep:`301`, and the Python " @@ -12885,43 +12917,50 @@ msgid "" "`__." msgstr "" -#: ../source/specifications/core-metadata.rst:493 -#: ../source/specifications/core-metadata.rst:583 -#: ../source/specifications/core-metadata.rst:723 -#: ../source/specifications/core-metadata.rst:748 +#: ../source/specifications/core-metadata.rst:546 +msgid "" +"The use of ``License ::`` classifiers is deprecated as of Metadata 2.4, use " +"``License-Expression`` instead. See `PEP 639 `_." +msgstr "" + +#: ../source/specifications/core-metadata.rst:550 +#: ../source/specifications/core-metadata.rst:640 +#: ../source/specifications/core-metadata.rst:780 +#: ../source/specifications/core-metadata.rst:805 msgid "This field may be followed by an environment marker after a semicolon." msgstr "" -#: ../source/specifications/core-metadata.rst:504 +#: ../source/specifications/core-metadata.rst:561 msgid "Requires-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:507 -#: ../source/specifications/core-metadata.rst:570 -#: ../source/specifications/core-metadata.rst:695 -#: ../source/specifications/core-metadata.rst:737 +#: ../source/specifications/core-metadata.rst:564 +#: ../source/specifications/core-metadata.rst:627 +#: ../source/specifications/core-metadata.rst:752 +#: ../source/specifications/core-metadata.rst:794 msgid "" "The field format specification was relaxed to accept the syntax used by " "popular publishing tools." msgstr "" -#: ../source/specifications/core-metadata.rst:511 +#: ../source/specifications/core-metadata.rst:568 msgid "" "Each entry contains a string naming some other distutils project required by " "this distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:514 +#: ../source/specifications/core-metadata.rst:571 msgid "The format of a requirement string contains from one to four parts:" msgstr "" -#: ../source/specifications/core-metadata.rst:516 +#: ../source/specifications/core-metadata.rst:573 msgid "" "A project name, in the same format as the ``Name:`` field. The only " "mandatory part." msgstr "" -#: ../source/specifications/core-metadata.rst:518 +#: ../source/specifications/core-metadata.rst:575 msgid "" "A comma-separated list of 'extra' names. These are defined by the required " "project, referring to specific features which may need extra dependencies. " @@ -12929,64 +12968,64 @@ msgid "" "`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:522 +#: ../source/specifications/core-metadata.rst:579 msgid "" "A version specifier. Tools parsing the format should accept optional " "parentheses around this, but tools generating it should not use parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:525 +#: ../source/specifications/core-metadata.rst:582 msgid "" "An environment marker after a semicolon. This means that the requirement is " "only needed in the specified conditions." msgstr "" -#: ../source/specifications/core-metadata.rst:528 +#: ../source/specifications/core-metadata.rst:585 msgid "See :pep:`508` for full details of the allowed format." msgstr "" -#: ../source/specifications/core-metadata.rst:530 +#: ../source/specifications/core-metadata.rst:587 msgid "" "The project names should correspond to names as found on the `Python Package " "Index`_." msgstr "" -#: ../source/specifications/core-metadata.rst:533 +#: ../source/specifications/core-metadata.rst:590 msgid "" "Version specifiers must follow the rules described in :doc:`version-" "specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:547 +#: ../source/specifications/core-metadata.rst:604 msgid "Requires-Python" msgstr "" -#: ../source/specifications/core-metadata.rst:551 +#: ../source/specifications/core-metadata.rst:608 msgid "" "This field specifies the Python version(s) that the distribution is " "compatible with. Installation tools may look at this when picking which " "version of a project to install." msgstr "" -#: ../source/specifications/core-metadata.rst:555 +#: ../source/specifications/core-metadata.rst:612 msgid "The value must be in the format specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:557 +#: ../source/specifications/core-metadata.rst:614 msgid "" "For example, if a distribution uses :ref:`f-strings ` " "then it may prevent installation on Python < 3.6 by specifying::" msgstr "" -#: ../source/specifications/core-metadata.rst:562 +#: ../source/specifications/core-metadata.rst:619 msgid "This field cannot be followed by an environment marker." msgstr "" -#: ../source/specifications/core-metadata.rst:567 +#: ../source/specifications/core-metadata.rst:624 msgid "Requires-External (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:574 +#: ../source/specifications/core-metadata.rst:631 msgid "" "Each entry contains a string describing some dependency in the system that " "the distribution is to be used. This field is intended to serve as a hint " @@ -12994,13 +13033,13 @@ msgid "" "to the ``distutils`` distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:579 +#: ../source/specifications/core-metadata.rst:636 msgid "" "The format of a requirement string is a name of an external dependency, " "optionally followed by a version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:585 +#: ../source/specifications/core-metadata.rst:642 msgid "" "Because they refer to non-Python software releases, version numbers for this " "field are **not** required to conform to the format specified in the :ref:" @@ -13008,36 +13047,36 @@ msgid "" "correspond to the version scheme used by the external dependency." msgstr "" -#: ../source/specifications/core-metadata.rst:590 +#: ../source/specifications/core-metadata.rst:647 msgid "Notice that there is no particular rule on the strings to be used." msgstr "" -#: ../source/specifications/core-metadata.rst:602 +#: ../source/specifications/core-metadata.rst:659 msgid "Project-URL (multiple-use)" msgstr "" -#: ../source/specifications/core-metadata.rst:606 +#: ../source/specifications/core-metadata.rst:663 msgid "" "A string containing a browsable URL for the project and a label for it, " "separated by a comma." msgstr "" -#: ../source/specifications/core-metadata.rst:613 +#: ../source/specifications/core-metadata.rst:670 msgid "The label is free text limited to 32 characters." msgstr "" -#: ../source/specifications/core-metadata.rst:621 +#: ../source/specifications/core-metadata.rst:678 msgid "Provides-Extra (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:624 +#: ../source/specifications/core-metadata.rst:681 msgid "" ":pep:`685` restricted valid values to be unambiguous (i.e. no normalization " "required). For older metadata versions, value restrictions were brought into " "line with ``Name:`` and normalization rules were introduced." msgstr "" -#: ../source/specifications/core-metadata.rst:629 +#: ../source/specifications/core-metadata.rst:686 msgid "" "A string containing the name of an optional feature. A valid name consists " "only of lowercase ASCII letters, ASCII numbers, and hyphen. It must start " @@ -13046,13 +13085,13 @@ msgid "" "guarantees unambiguity)::" msgstr "" -#: ../source/specifications/core-metadata.rst:637 +#: ../source/specifications/core-metadata.rst:694 msgid "" "The specified name may be used to make a dependency conditional on whether " "the optional feature has been requested." msgstr "" -#: ../source/specifications/core-metadata.rst:645 +#: ../source/specifications/core-metadata.rst:702 msgid "" "A second distribution requires an optional dependency by placing it inside " "square brackets, and can request multiple features by separating them with a " @@ -13060,20 +13099,20 @@ msgid "" "added to the set of requirements for the distribution." msgstr "" -#: ../source/specifications/core-metadata.rst:655 +#: ../source/specifications/core-metadata.rst:712 msgid "" "Two feature names ``test`` and ``doc`` are reserved to mark dependencies " "that are needed for running automated tests and generating documentation, " "respectively." msgstr "" -#: ../source/specifications/core-metadata.rst:659 +#: ../source/specifications/core-metadata.rst:716 msgid "" "It is legal to specify ``Provides-Extra:`` without referencing it in any " "``Requires-Dist:``." msgstr "" -#: ../source/specifications/core-metadata.rst:662 +#: ../source/specifications/core-metadata.rst:719 msgid "" "When writing data for older metadata versions, names MUST be normalized " "following the same rules used for the ``Name:`` field when performing " @@ -13081,7 +13120,7 @@ msgid "" "Extra:`` entries would clash after being normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:667 +#: ../source/specifications/core-metadata.rst:724 msgid "" "When reading data for older metadata versions, tools SHOULD warn when values " "for this field would be invalid under newer metadata versions. If a value " @@ -13091,11 +13130,11 @@ msgid "" "metadata versions." msgstr "" -#: ../source/specifications/core-metadata.rst:675 +#: ../source/specifications/core-metadata.rst:732 msgid "Rarely Used Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:677 +#: ../source/specifications/core-metadata.rst:734 msgid "" "The fields in this section are currently rarely used, as their design was " "inspired by comparable mechanisms in Linux package management systems, and " @@ -13103,7 +13142,7 @@ msgid "" "open index server such as `PyPI `__." msgstr "" -#: ../source/specifications/core-metadata.rst:682 +#: ../source/specifications/core-metadata.rst:739 msgid "" "As a result, popular installation tools ignore them completely, which in " "turn means there is little incentive for package publishers to set them " @@ -13113,18 +13152,18 @@ msgid "" "package repository." msgstr "" -#: ../source/specifications/core-metadata.rst:692 +#: ../source/specifications/core-metadata.rst:749 msgid "Provides-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:699 +#: ../source/specifications/core-metadata.rst:756 msgid "" "Each entry contains a string naming a Distutils project which is contained " "within this distribution. This field *must* include the project identified " "in the ``Name`` field, followed by the version : Name (Version)." msgstr "" -#: ../source/specifications/core-metadata.rst:704 +#: ../source/specifications/core-metadata.rst:761 msgid "" "A distribution may provide additional names, e.g. to indicate that multiple " "projects have been bundled together. For instance, source distributions of " @@ -13133,7 +13172,7 @@ msgid "" "distribution satisfies requirements for both ``ZODB`` and ``transaction``." msgstr "" -#: ../source/specifications/core-metadata.rst:711 +#: ../source/specifications/core-metadata.rst:768 msgid "" "A distribution may also provide a \"virtual\" project name, which does not " "correspond to any separately-distributed project: such a name might be used " @@ -13144,63 +13183,63 @@ msgid "" "them installed." msgstr "" -#: ../source/specifications/core-metadata.rst:719 +#: ../source/specifications/core-metadata.rst:776 msgid "" "A version declaration may be supplied and must follow the rules described " "in :doc:`version-specifiers`. The distribution's version number will be " "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:734 +#: ../source/specifications/core-metadata.rst:791 msgid "Obsoletes-Dist (multiple use)" msgstr "" -#: ../source/specifications/core-metadata.rst:741 +#: ../source/specifications/core-metadata.rst:798 msgid "" "Each entry contains a string describing a distutils project's distribution " "which this distribution renders obsolete, meaning that the two projects " "should not be installed at the same time." msgstr "" -#: ../source/specifications/core-metadata.rst:745 +#: ../source/specifications/core-metadata.rst:802 msgid "" "Version declarations can be supplied. Version numbers must be in the format " "specified in :doc:`version-specifiers`." msgstr "" -#: ../source/specifications/core-metadata.rst:750 +#: ../source/specifications/core-metadata.rst:807 msgid "" "The most common use of this field will be in case a project name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon distribution should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:763 +#: ../source/specifications/core-metadata.rst:820 msgid "Deprecated Fields" msgstr "" -#: ../source/specifications/core-metadata.rst:766 +#: ../source/specifications/core-metadata.rst:823 msgid "Requires" msgstr "需要" -#: ../source/specifications/core-metadata.rst:769 +#: ../source/specifications/core-metadata.rst:826 msgid "in favour of ``Requires-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:772 +#: ../source/specifications/core-metadata.rst:829 msgid "" "Each entry contains a string describing some other module or package " "required by this package." msgstr "" -#: ../source/specifications/core-metadata.rst:775 +#: ../source/specifications/core-metadata.rst:832 msgid "" "The format of a requirement string is identical to that of a module or " "package name usable with the ``import`` statement, optionally followed by a " "version declaration within parentheses." msgstr "" -#: ../source/specifications/core-metadata.rst:779 +#: ../source/specifications/core-metadata.rst:836 msgid "" "A version declaration is a series of conditional operators and version " "numbers, separated by commas. Conditional operators must be one of \"<\", " @@ -13211,33 +13250,33 @@ msgid "" "version numbers are \"1.0\", \"2.3a2\", \"1.3.99\"," msgstr "" -#: ../source/specifications/core-metadata.rst:787 +#: ../source/specifications/core-metadata.rst:844 msgid "" "Any number of conditional operators can be specified, e.g. the string " "\">1.0, !=1.3.4, <2.0\" is a legal version declaration." msgstr "" -#: ../source/specifications/core-metadata.rst:790 +#: ../source/specifications/core-metadata.rst:847 msgid "" "All of the following are possible requirement strings: \"rfc822\", \"zlib " "(>=1.1.4)\", \"zope\"." msgstr "" -#: ../source/specifications/core-metadata.rst:793 +#: ../source/specifications/core-metadata.rst:850 msgid "" "There’s no canonical list of what strings should be used; the Python " "community is left to choose its own standards." msgstr "" -#: ../source/specifications/core-metadata.rst:806 +#: ../source/specifications/core-metadata.rst:863 msgid "Provides" msgstr "提供" -#: ../source/specifications/core-metadata.rst:809 +#: ../source/specifications/core-metadata.rst:866 msgid "in favour of ``Provides-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:812 +#: ../source/specifications/core-metadata.rst:869 msgid "" "Each entry contains a string describing a package or module that will be " "provided by this package once it is installed. These strings should match " @@ -13246,77 +13285,89 @@ msgid "" "implied if none is specified." msgstr "" -#: ../source/specifications/core-metadata.rst:828 +#: ../source/specifications/core-metadata.rst:885 msgid "Obsoletes" msgstr "" -#: ../source/specifications/core-metadata.rst:831 +#: ../source/specifications/core-metadata.rst:888 msgid "in favour of ``Obsoletes-Dist``" msgstr "" -#: ../source/specifications/core-metadata.rst:834 +#: ../source/specifications/core-metadata.rst:891 msgid "" "Each entry contains a string describing a package or module that this " "package renders obsolete, meaning that the two packages should not be " "installed at the same time. Version declarations can be supplied." msgstr "" -#: ../source/specifications/core-metadata.rst:838 +#: ../source/specifications/core-metadata.rst:895 msgid "" "The most common use of this field will be in case a package name changes, e." "g. Gorgon 2.3 gets subsumed into Torqued Python 1.0. When you install " "Torqued Python, the Gorgon package should be removed." msgstr "" -#: ../source/specifications/core-metadata.rst:850 +#: ../source/specifications/core-metadata.rst:907 msgid "March 2001: Core metadata 1.0 was approved through :pep:`241`." msgstr "" -#: ../source/specifications/core-metadata.rst:851 +#: ../source/specifications/core-metadata.rst:908 msgid "April 2003: Core metadata 1.1 was approved through :pep:`314`:" msgstr "" -#: ../source/specifications/core-metadata.rst:852 +#: ../source/specifications/core-metadata.rst:909 msgid "February 2010: Core metadata 1.2 was approved through :pep:`345`." msgstr "" -#: ../source/specifications/core-metadata.rst:853 +#: ../source/specifications/core-metadata.rst:910 msgid "February 2018: Core metadata 2.1 was approved through :pep:`566`." msgstr "" -#: ../source/specifications/core-metadata.rst:855 +#: ../source/specifications/core-metadata.rst:912 msgid "Added ``Description-Content-Type`` and ``Provides-Extra``." msgstr "" -#: ../source/specifications/core-metadata.rst:856 +#: ../source/specifications/core-metadata.rst:913 msgid "Added canonical method for transforming metadata to JSON." msgstr "" -#: ../source/specifications/core-metadata.rst:857 +#: ../source/specifications/core-metadata.rst:914 msgid "Restricted the grammar of the ``Name`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:859 +#: ../source/specifications/core-metadata.rst:916 msgid "October 2020: Core metadata 2.2 was approved through :pep:`643`." msgstr "" -#: ../source/specifications/core-metadata.rst:861 +#: ../source/specifications/core-metadata.rst:918 msgid "Added the ``Dynamic`` field." msgstr "" -#: ../source/specifications/core-metadata.rst:863 +#: ../source/specifications/core-metadata.rst:920 msgid "March 2022: Core metadata 2.3 was approved through :pep:`685`." msgstr "" -#: ../source/specifications/core-metadata.rst:865 +#: ../source/specifications/core-metadata.rst:922 msgid "Restricted extra names to be normalized." msgstr "" -#: ../source/specifications/core-metadata.rst:869 +#: ../source/specifications/core-metadata.rst:924 +msgid "August 2024: Core metadata 2.4 was approved through :pep:`639`." +msgstr "" + +#: ../source/specifications/core-metadata.rst:926 +msgid "Added the ``License-Expression`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:927 +msgid "Added the ``License-File`` field." +msgstr "" + +#: ../source/specifications/core-metadata.rst:931 msgid "reStructuredText markup: https://docutils.sourceforge.io/" msgstr "" -#: ../source/specifications/core-metadata.rst:874 +#: ../source/specifications/core-metadata.rst:936 msgid "RFC 822 Long Header Fields: :rfc:`822#section-3.1.1`" msgstr ""