From ffc5efd95711f841005cee73fe327f3b71f58577 Mon Sep 17 00:00:00 2001 From: Weblate Date: Mar 03 2024 22:32:23 +0000 Subject: Update translation files Updated by "Update PO files to match POT (msgmerge)" hook in Weblate. Co-authored-by: Weblate Translate-URL: https://translate.fedoraproject.org/projects/fedora-docs-l10n-packaging-guidelines/masterpagespython/ Translation: fedora-docs-l10n/packaging-guidelines/master/pages/Python --- diff --git a/po/es/master/pages/Python.po b/po/es/master/pages/Python.po index 84ce1fe..9c71953 100644 --- a/po/es/master/pages/Python.po +++ b/po/es/master/pages/Python.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2024-02-16 22:16+0000\n" +"POT-Creation-Date: 2024-03-03 22:31+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1840,8 +1840,9 @@ msgstr "" msgid "" "A popular testing tool, and one which is well integrated in Fedora, is " "`+tox+`. Upstream, it is commonly used to test against multiple Python " -"versions. In a Fedora package, BuildRequire test dependencies (see _Test " -"dependencies_ below) and run `+tox+` with:" +"versions. In a Fedora package, BuildRequire test dependencies via `+" +"%pyproject_buildrequires -t+` or `+-e+` (see _Test dependencies_ below) and " +"run `+tox+` with:" msgstr "" #. type: delimited block - @@ -2796,12 +2797,19 @@ msgid "Run tests using `+tox+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1555 +#: pages/Python.adoc:1556 +msgid "" +"This macro needs BuildRequires generated by the `+-t+` or `+-e+` option of " +"<>." +msgstr "" + +#. type: Plain text +#: pages/Python.adoc:1558 msgid "Different environments may be specified with `+-e+`, for example:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1560 +#: pages/Python.adoc:1563 #, no-wrap msgid "" "%check\n" @@ -2809,36 +2817,36 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1563 +#: pages/Python.adoc:1566 msgid "Flags for the `+tox+` command can be specified after `+--+`:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1567 +#: pages/Python.adoc:1570 #, no-wrap msgid " %tox -- --parallel 0\n" msgstr "" #. type: Plain text -#: pages/Python.adoc:1570 +#: pages/Python.adoc:1573 msgid "" "Additional arguments for the test runner may be specified after another `+--" "+`:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1574 +#: pages/Python.adoc:1577 #, no-wrap msgid " %tox -- --parallel 0 -- --verbose tests/*\n" msgstr "" #. type: Plain text -#: pages/Python.adoc:1578 +#: pages/Python.adoc:1581 msgid "`+%{toxenv}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1582 +#: pages/Python.adoc:1585 msgid "" "The _tox_ environment(s) used by the `+%tox+` macro. Multiple environments " "are separated by commas. Can be overridden manually or with `+" @@ -2846,46 +2854,46 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1585 +#: pages/Python.adoc:1588 msgid "`+%{default_toxenv}+` (e.g. `+py39+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1587 +#: pages/Python.adoc:1590 msgid "The system-wide default value of `+%{toxenv}+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1590 +#: pages/Python.adoc:1593 msgid "`+%pytest+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1593 +#: pages/Python.adoc:1596 msgid "" "Run `+%__pytest+` with environment variables appropriate for tests in " "`%check`. See <> for details." msgstr "" #. type: Plain text -#: pages/Python.adoc:1596 +#: pages/Python.adoc:1599 msgid "`+%__pytest+` (`+/usr/bin/pytest+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1598 +#: pages/Python.adoc:1601 msgid "The command that `+%pytest+` uses. May be redefined." msgstr "" #. type: Plain text -#: pages/Python.adoc:1601 +#: pages/Python.adoc:1604 msgid "" "`+%py3_test_envvars+` (`+PATH=... PYTHONPATH=... " "PYTHONDONTWRITEBYTECODE=1 ...+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1606 +#: pages/Python.adoc:1609 msgid "" "The environment variables used by `+%pytest+` and `+%tox+`. It may be used " "to invoke custom test runners in `+%check+`. See <> for " @@ -2893,12 +2901,12 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1609 +#: pages/Python.adoc:1612 msgid "`+%py3_check_import+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1613 +#: pages/Python.adoc:1616 msgid "" "Imports all provided modules. If running an upstream test suite is not " "feasible, use this macro in `+%check+` to test that public Python modules " @@ -2906,50 +2914,50 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1615 +#: pages/Python.adoc:1618 msgid "Takes these arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1620 +#: pages/Python.adoc:1623 msgid "" "`+-f+`: path to file containing qualified module names (separated by " "newlines). Optional, can be used multiple times." msgstr "" #. type: Plain text -#: pages/Python.adoc:1622 +#: pages/Python.adoc:1625 msgid "" "`+-e+`: glob to exclude the matching module names. Optional, can be used " "multiple times." msgstr "" #. type: Plain text -#: pages/Python.adoc:1623 +#: pages/Python.adoc:1626 msgid "`+-t+`: if set, import only top-level module names" msgstr "" #. type: Plain text -#: pages/Python.adoc:1625 +#: pages/Python.adoc:1628 msgid "" "Positional arguments (separated by spaces or commas) specify the module " "name(s) to check." msgstr "" #. type: Plain text -#: pages/Python.adoc:1630 +#: pages/Python.adoc:1633 msgid "" "The macro sets various environment variables such as `+PATH+` and " "`+PYTHONPATH+` to ensure the packaged versions of modules are imported." msgstr "" #. type: Plain text -#: pages/Python.adoc:1633 +#: pages/Python.adoc:1636 msgid "`+%pyproject_check_import+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1637 +#: pages/Python.adoc:1640 msgid "" "Imports all public modules found by <> whose names match any of the provided " @@ -2957,63 +2965,63 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1640 +#: pages/Python.adoc:1643 msgid "" "This macro needs to be used with `+%pyproject_save_files+` (use `+" "%py3_check_import+` in other cases)." msgstr "" #. type: Plain text -#: pages/Python.adoc:1643 +#: pages/Python.adoc:1646 msgid "" "The macro takes `+-e+`/`+-t+` as well as positional arguments for `+" "%py3_check_import+` above." msgstr "" #. type: Title === -#: pages/Python.adoc:1644 +#: pages/Python.adoc:1647 #, no-wrap msgid "Extras macros" msgstr "" #. type: Plain text -#: pages/Python.adoc:1648 +#: pages/Python.adoc:1651 msgid "`+%pyproject_extras_subpkg+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1651 +#: pages/Python.adoc:1654 msgid "" "Generates a simple subpackage for a Python extra. See <> for more " "information." msgstr "" #. type: Plain text -#: pages/Python.adoc:1654 +#: pages/Python.adoc:1657 msgid "" "This macro needs to be used with `+%pyproject_install+` (use `+" "%python_extras_subpkg+` in other cases)." msgstr "" #. type: Plain text -#: pages/Python.adoc:1656 +#: pages/Python.adoc:1659 msgid "Required arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1659 pages/Python.adoc:1705 +#: pages/Python.adoc:1662 pages/Python.adoc:1708 msgid "`+-n+`: name of the “base” package (e.g. `+python3-requests+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1661 +#: pages/Python.adoc:1664 msgid "" "Positional arguments (separated by spaces or commas): the extra name(s). " "Multiple metapackages are generated when multiple names are provided." msgstr "" #. type: Plain text -#: pages/Python.adoc:1666 +#: pages/Python.adoc:1669 msgid "" "The macro also takes `+-i+`/`+-f+`/`+-F+` arguments for `+" "%python_extras_subpkg+` below, but if they are not given, a filelist written " @@ -3021,7 +3029,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1674 +#: pages/Python.adoc:1677 msgid "" "This macro generates all the subpackage definition sections (`+%package+` " "including the `+Summary+` and `+Requires+` on the base package, `+" @@ -3032,7 +3040,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1681 +#: pages/Python.adoc:1684 msgid "" "The `+%files+` section is last. It can be continued to add files that only " "make sense with the extra and the base package does not fail without them. " @@ -3041,7 +3049,7 @@ msgid "" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1686 +#: pages/Python.adoc:1689 #, no-wrap msgid "" "%pyproject_extras_subpkg -n a-cool-tool cli\n" @@ -3049,7 +3057,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1695 +#: pages/Python.adoc:1698 msgid "" "Due to technical limitations, the macro never generates requirements on the " "arched `+BASE_PACKAGE%{?_isa} = %{?epoch:%{epoch}:}%{version}-%{release}+`. " @@ -3059,25 +3067,25 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1698 +#: pages/Python.adoc:1701 msgid "`+%python_extras_subpkg+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1702 +#: pages/Python.adoc:1705 msgid "" "Generates a simple subpackage for a Python extra. See <> for more " "information. Takes these arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1706 +#: pages/Python.adoc:1709 msgid "" "`+-i+`: the `+%files %ghost+` path (glob) to the `+.dist-info+` directory" msgstr "" #. type: Plain text -#: pages/Python.adoc:1709 +#: pages/Python.adoc:1712 msgid "" "Positional arguments (separated by spaces or commas) specify the extra " "name(s) — multiple metapackages are generated when multiple names are " @@ -3085,7 +3093,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1713 +#: pages/Python.adoc:1716 msgid "" "`+-f+`: Relative path to the filelist for this metapackage (which should " "contain the `+%files %ghost+` path (glob) to the the metadata directory). " @@ -3093,19 +3101,19 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1716 +#: pages/Python.adoc:1719 msgid "" "`+-F+`: Skip the %files section entirely (if the packager wants to construct " "it manually). Conflicts with `+-i+` and `+-f+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1719 +#: pages/Python.adoc:1722 msgid "As with `+%pyproject_extras_subpkg+`:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1724 +#: pages/Python.adoc:1727 msgid "" "This macro generates all the subpackage definition sections, with only `+" "%files+` being customizable. For more complicated uses, construct the " @@ -3113,20 +3121,20 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1726 +#: pages/Python.adoc:1729 msgid "" "It never generates requirements on the arched `+BASE_PACKAGE%{?_isa} = %{?" "epoch:%{epoch}:}%{version}-%{release}+`." msgstr "" #. type: Title === -#: pages/Python.adoc:1727 +#: pages/Python.adoc:1730 #, no-wrap msgid "Manual generation" msgstr "" #. type: Plain text -#: pages/Python.adoc:1733 +#: pages/Python.adoc:1736 msgid "" "The following macros are available for cases where automatic generation is " "turned off. They can also be useful for handling files in non-standard " @@ -3134,41 +3142,41 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1736 +#: pages/Python.adoc:1739 msgid "`+%pycached MODNAME.py+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1739 +#: pages/Python.adoc:1742 msgid "" "Given a Python file, lists the file and the files with its bytecode cache. " "See _Source files and bytecode cache_ for more information." msgstr "" #. type: Plain text -#: pages/Python.adoc:1742 +#: pages/Python.adoc:1745 msgid "`+%py_provides python3-MODNAME+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1746 +#: pages/Python.adoc:1749 msgid "" "Generates `+Provides+` for `+python3-MODNAME+`, `+python3.X-MODNAME+` and " "`+python-MODNAME+`. See <> for more details." msgstr "" #. type: Plain text -#: pages/Python.adoc:1749 +#: pages/Python.adoc:1752 msgid "`+%py_byte_compile INTERPRETER PATH+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1751 +#: pages/Python.adoc:1754 msgid "Byte-compile a Python file into a `+__pycache__/*.pyc+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1756 +#: pages/Python.adoc:1759 msgid "" "If the `+PATH+` argument is a directory, the macro will recursively byte " "compile all `+*.py+` files in the directory. (So, if you need to compile " @@ -3176,7 +3184,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1763 +#: pages/Python.adoc:1766 msgid "" "The `+INTERPRETER+` determines the compiled file name’s suffix and the magic " "number embedded in the file. These muct match the interpreter that will " @@ -3186,17 +3194,17 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1765 +#: pages/Python.adoc:1768 msgid "[#py_dist_name]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1766 +#: pages/Python.adoc:1769 msgid "`+%{py_dist_name PROJECTNAME}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1770 +#: pages/Python.adoc:1773 msgid "" "Given a _project name_ (e.g. `+PyYAML+`) it will convert it to the canonical " "format (e.g. `+pyyaml+`). See <> for more " @@ -3204,17 +3212,17 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1772 +#: pages/Python.adoc:1775 msgid "[#py3_dist]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1773 +#: pages/Python.adoc:1776 msgid "`+%{py3_dist PROJECTNAME …}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1779 +#: pages/Python.adoc:1782 msgid "" "Given one or more _project names_, it will convert them to the canonical " "format and evaluate to `+python3dist(DISTNAME)+`, which is useful when " @@ -3223,28 +3231,28 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1780 +#: pages/Python.adoc:1783 #, no-wrap msgid "System Settings" msgstr "" #. type: Plain text -#: pages/Python.adoc:1783 +#: pages/Python.adoc:1786 msgid "The following macros can be redefined for special use cases." msgstr "" #. type: Plain text -#: pages/Python.adoc:1785 +#: pages/Python.adoc:1788 msgid "[#__python]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1786 +#: pages/Python.adoc:1789 msgid "`+%{__python}+` (errors by default if not redefined)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1790 +#: pages/Python.adoc:1793 msgid "" "Defining this macro sets the meaning of all “unversioned” Python macros such " "as `+%{python}+` or `+%{python_sitelib}+`. Don’t use these macros without " @@ -3252,24 +3260,24 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1793 +#: pages/Python.adoc:1796 msgid "`+%{__python3}+` (`+/usr/bin/python3+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1797 +#: pages/Python.adoc:1800 msgid "" "The python 3 interpreter. Redefining this macro changes all the `+" "%{python3...}+` macros, e.g. `+%{python3}+` or `+%{python3_sitelib}+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1800 +#: pages/Python.adoc:1803 msgid "`+%{python3_pkgversion}+` (`+3+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1807 +#: pages/Python.adoc:1810 msgid "" "Distro-wide Python version, i.e. the `+3+` in `+python3+`. Projects that " "build on top of Fedora might define it to e.g. `+3.9+` to try allowing " @@ -3279,13 +3287,13 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1808 +#: pages/Python.adoc:1811 #, no-wrap msgid "Comparing Python versions" msgstr "" #. type: Plain text -#: pages/Python.adoc:1816 +#: pages/Python.adoc:1819 msgid "" "When comparing Python versions (e.g. to ask: is `+%{python3_version}+` " "greater than 3.8?), using naïve `+%if %{python3_version} > 3.8+` or `+%if " @@ -3295,14 +3303,14 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1819 +#: pages/Python.adoc:1822 msgid "" "It is possible to explicitly compare version literals by using the `+v+` " "prefix, similar to the Python string prefixes:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1825 +#: pages/Python.adoc:1828 #, no-wrap msgid "" "%if v\"0%{?python3_version}\" > v\"3.8\"\n" @@ -3311,14 +3319,14 @@ msgid "" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1831 +#: pages/Python.adoc:1834 msgid "" "As a workaround for compatibility with RPM releases before 4.16 (Fedora 33), " "`+%{python3_version_nodots}+` can be compared as an integers:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1837 +#: pages/Python.adoc:1840 #, no-wrap msgid "" "%if %{python3_version_nodots} > 38\n" @@ -3327,47 +3335,47 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1841 +#: pages/Python.adoc:1844 msgid "" "This will work with Python 3.10 (310 > 39), but eventually break with Python " "4.0 (40 < 310)." msgstr "" #. type: Title === -#: pages/Python.adoc:1843 +#: pages/Python.adoc:1846 #, no-wrap msgid "Disabling automation" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1846 +#: pages/Python.adoc:1849 msgid "The following macros can turn off Python-specific automation." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1848 +#: pages/Python.adoc:1851 msgid "Consider contacting the Python SIG if you need to do this." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1851 +#: pages/Python.adoc:1854 msgid "`+%{?python_disable_dependency_generator}+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1854 +#: pages/Python.adoc:1857 msgid "" "Disables the automatic dependency generator. See <> for details." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1857 +#: pages/Python.adoc:1860 msgid "`+%undefine __pythonname_provides+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1861 +#: pages/Python.adoc:1864 msgid "" "Disables automatic generation of unversioned/versioned provides for package " "names, e.g. `+python-FOO+` and `+python3.9-FOO+` for `+python3-foo+`. See " @@ -3375,34 +3383,34 @@ msgid "" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1864 +#: pages/Python.adoc:1867 msgid "`+%undefine __pythondist_provides+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1868 +#: pages/Python.adoc:1871 msgid "" "Disables automatic generation of machine-readable Provides, e." "g. `+python3dist(foo)+`. See <> for more details." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1871 +#: pages/Python.adoc:1874 msgid "`+%global _python_no_extras_requires 1+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1873 +#: pages/Python.adoc:1876 msgid "If defined, <> will not be generated." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1876 +#: pages/Python.adoc:1879 msgid "`+%global _python_dist_allow_version_zero 1+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1880 +#: pages/Python.adoc:1883 msgid "" "From Fedora Linux 38 on, it is no longer possible to build a Python package " "with version 0 to prevent <<_version_warning,an accidental loss of the " @@ -3411,64 +3419,64 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1881 +#: pages/Python.adoc:1884 #, no-wrap msgid "Deprecated Macros" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1886 +#: pages/Python.adoc:1889 msgid "" "The following macros are deprecated. See the xref:Python_201x.adoc[201x-era " "Python Packaging guidelines] for how some of them were used." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1888 +#: pages/Python.adoc:1891 msgid "[[py3_build]] `+%py3_build+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1889 +#: pages/Python.adoc:1892 msgid "[[py3_build_wheel]] `+%py3_build_wheel+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1890 +#: pages/Python.adoc:1893 msgid "[[py3_build_egg]] `+%py3_build_egg+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1891 +#: pages/Python.adoc:1894 msgid "[[py3_install]] `+%py3_install+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1892 +#: pages/Python.adoc:1895 msgid "[[py3_install_wheel]] `+%py3_install_wheel+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1893 +#: pages/Python.adoc:1896 msgid "[[py3_install_egg]] `+%py3_install_egg+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1894 +#: pages/Python.adoc:1897 msgid "[[py3dir]] `+%py3dir+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1895 +#: pages/Python.adoc:1898 msgid "[[py3_other_build]] `+%py3_other_build+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1896 +#: pages/Python.adoc:1899 msgid "[[py3_other_install]] `+%py3_other_install+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1896 +#: pages/Python.adoc:1899 msgid "[[python_provide]] `+%python_provide+`" msgstr "" diff --git a/po/fi/master/pages/Python.po b/po/fi/master/pages/Python.po index db426c3..65191d5 100644 --- a/po/fi/master/pages/Python.po +++ b/po/fi/master/pages/Python.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2024-02-16 22:16+0000\n" +"POT-Creation-Date: 2024-03-03 22:31+0000\n" "PO-Revision-Date: 2021-12-03 18:16+0000\n" "Last-Translator: Jan Kuparinen \n" "Language-Team: Finnish >." +msgstr "" + +#. type: Plain text +#: pages/Python.adoc:1558 msgid "Different environments may be specified with `+-e+`, for example:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1560 +#: pages/Python.adoc:1563 #, no-wrap msgid "" "%check\n" @@ -2812,36 +2820,36 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1563 +#: pages/Python.adoc:1566 msgid "Flags for the `+tox+` command can be specified after `+--+`:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1567 +#: pages/Python.adoc:1570 #, no-wrap msgid " %tox -- --parallel 0\n" msgstr "" #. type: Plain text -#: pages/Python.adoc:1570 +#: pages/Python.adoc:1573 msgid "" "Additional arguments for the test runner may be specified after another `+--" "+`:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1574 +#: pages/Python.adoc:1577 #, no-wrap msgid " %tox -- --parallel 0 -- --verbose tests/*\n" msgstr "" #. type: Plain text -#: pages/Python.adoc:1578 +#: pages/Python.adoc:1581 msgid "`+%{toxenv}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1582 +#: pages/Python.adoc:1585 msgid "" "The _tox_ environment(s) used by the `+%tox+` macro. Multiple environments " "are separated by commas. Can be overridden manually or with `+" @@ -2849,46 +2857,46 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1585 +#: pages/Python.adoc:1588 msgid "`+%{default_toxenv}+` (e.g. `+py39+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1587 +#: pages/Python.adoc:1590 msgid "The system-wide default value of `+%{toxenv}+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1590 +#: pages/Python.adoc:1593 msgid "`+%pytest+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1593 +#: pages/Python.adoc:1596 msgid "" "Run `+%__pytest+` with environment variables appropriate for tests in " "`%check`. See <> for details." msgstr "" #. type: Plain text -#: pages/Python.adoc:1596 +#: pages/Python.adoc:1599 msgid "`+%__pytest+` (`+/usr/bin/pytest+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1598 +#: pages/Python.adoc:1601 msgid "The command that `+%pytest+` uses. May be redefined." msgstr "" #. type: Plain text -#: pages/Python.adoc:1601 +#: pages/Python.adoc:1604 msgid "" "`+%py3_test_envvars+` (`+PATH=... PYTHONPATH=... " "PYTHONDONTWRITEBYTECODE=1 ...+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1606 +#: pages/Python.adoc:1609 msgid "" "The environment variables used by `+%pytest+` and `+%tox+`. It may be used " "to invoke custom test runners in `+%check+`. See <> for " @@ -2896,12 +2904,12 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1609 +#: pages/Python.adoc:1612 msgid "`+%py3_check_import+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1613 +#: pages/Python.adoc:1616 msgid "" "Imports all provided modules. If running an upstream test suite is not " "feasible, use this macro in `+%check+` to test that public Python modules " @@ -2909,50 +2917,50 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1615 +#: pages/Python.adoc:1618 msgid "Takes these arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1620 +#: pages/Python.adoc:1623 msgid "" "`+-f+`: path to file containing qualified module names (separated by " "newlines). Optional, can be used multiple times." msgstr "" #. type: Plain text -#: pages/Python.adoc:1622 +#: pages/Python.adoc:1625 msgid "" "`+-e+`: glob to exclude the matching module names. Optional, can be used " "multiple times." msgstr "" #. type: Plain text -#: pages/Python.adoc:1623 +#: pages/Python.adoc:1626 msgid "`+-t+`: if set, import only top-level module names" msgstr "" #. type: Plain text -#: pages/Python.adoc:1625 +#: pages/Python.adoc:1628 msgid "" "Positional arguments (separated by spaces or commas) specify the module " "name(s) to check." msgstr "" #. type: Plain text -#: pages/Python.adoc:1630 +#: pages/Python.adoc:1633 msgid "" "The macro sets various environment variables such as `+PATH+` and " "`+PYTHONPATH+` to ensure the packaged versions of modules are imported." msgstr "" #. type: Plain text -#: pages/Python.adoc:1633 +#: pages/Python.adoc:1636 msgid "`+%pyproject_check_import+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1637 +#: pages/Python.adoc:1640 msgid "" "Imports all public modules found by <> whose names match any of the provided " @@ -2960,63 +2968,63 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1640 +#: pages/Python.adoc:1643 msgid "" "This macro needs to be used with `+%pyproject_save_files+` (use `+" "%py3_check_import+` in other cases)." msgstr "" #. type: Plain text -#: pages/Python.adoc:1643 +#: pages/Python.adoc:1646 msgid "" "The macro takes `+-e+`/`+-t+` as well as positional arguments for `+" "%py3_check_import+` above." msgstr "" #. type: Title === -#: pages/Python.adoc:1644 +#: pages/Python.adoc:1647 #, no-wrap msgid "Extras macros" msgstr "" #. type: Plain text -#: pages/Python.adoc:1648 +#: pages/Python.adoc:1651 msgid "`+%pyproject_extras_subpkg+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1651 +#: pages/Python.adoc:1654 msgid "" "Generates a simple subpackage for a Python extra. See <> for more " "information." msgstr "" #. type: Plain text -#: pages/Python.adoc:1654 +#: pages/Python.adoc:1657 msgid "" "This macro needs to be used with `+%pyproject_install+` (use `+" "%python_extras_subpkg+` in other cases)." msgstr "" #. type: Plain text -#: pages/Python.adoc:1656 +#: pages/Python.adoc:1659 msgid "Required arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1659 pages/Python.adoc:1705 +#: pages/Python.adoc:1662 pages/Python.adoc:1708 msgid "`+-n+`: name of the “base” package (e.g. `+python3-requests+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1661 +#: pages/Python.adoc:1664 msgid "" "Positional arguments (separated by spaces or commas): the extra name(s). " "Multiple metapackages are generated when multiple names are provided." msgstr "" #. type: Plain text -#: pages/Python.adoc:1666 +#: pages/Python.adoc:1669 msgid "" "The macro also takes `+-i+`/`+-f+`/`+-F+` arguments for `+" "%python_extras_subpkg+` below, but if they are not given, a filelist written " @@ -3024,7 +3032,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1674 +#: pages/Python.adoc:1677 msgid "" "This macro generates all the subpackage definition sections (`+%package+` " "including the `+Summary+` and `+Requires+` on the base package, `+" @@ -3035,7 +3043,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1681 +#: pages/Python.adoc:1684 msgid "" "The `+%files+` section is last. It can be continued to add files that only " "make sense with the extra and the base package does not fail without them. " @@ -3044,7 +3052,7 @@ msgid "" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1686 +#: pages/Python.adoc:1689 #, no-wrap msgid "" "%pyproject_extras_subpkg -n a-cool-tool cli\n" @@ -3052,7 +3060,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1695 +#: pages/Python.adoc:1698 msgid "" "Due to technical limitations, the macro never generates requirements on the " "arched `+BASE_PACKAGE%{?_isa} = %{?epoch:%{epoch}:}%{version}-%{release}+`. " @@ -3062,25 +3070,25 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1698 +#: pages/Python.adoc:1701 msgid "`+%python_extras_subpkg+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1702 +#: pages/Python.adoc:1705 msgid "" "Generates a simple subpackage for a Python extra. See <> for more " "information. Takes these arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1706 +#: pages/Python.adoc:1709 msgid "" "`+-i+`: the `+%files %ghost+` path (glob) to the `+.dist-info+` directory" msgstr "" #. type: Plain text -#: pages/Python.adoc:1709 +#: pages/Python.adoc:1712 msgid "" "Positional arguments (separated by spaces or commas) specify the extra " "name(s) — multiple metapackages are generated when multiple names are " @@ -3088,7 +3096,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1713 +#: pages/Python.adoc:1716 msgid "" "`+-f+`: Relative path to the filelist for this metapackage (which should " "contain the `+%files %ghost+` path (glob) to the the metadata directory). " @@ -3096,19 +3104,19 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1716 +#: pages/Python.adoc:1719 msgid "" "`+-F+`: Skip the %files section entirely (if the packager wants to construct " "it manually). Conflicts with `+-i+` and `+-f+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1719 +#: pages/Python.adoc:1722 msgid "As with `+%pyproject_extras_subpkg+`:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1724 +#: pages/Python.adoc:1727 msgid "" "This macro generates all the subpackage definition sections, with only `+" "%files+` being customizable. For more complicated uses, construct the " @@ -3116,20 +3124,20 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1726 +#: pages/Python.adoc:1729 msgid "" "It never generates requirements on the arched `+BASE_PACKAGE%{?_isa} = %{?" "epoch:%{epoch}:}%{version}-%{release}+`." msgstr "" #. type: Title === -#: pages/Python.adoc:1727 +#: pages/Python.adoc:1730 #, no-wrap msgid "Manual generation" msgstr "" #. type: Plain text -#: pages/Python.adoc:1733 +#: pages/Python.adoc:1736 msgid "" "The following macros are available for cases where automatic generation is " "turned off. They can also be useful for handling files in non-standard " @@ -3137,41 +3145,41 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1736 +#: pages/Python.adoc:1739 msgid "`+%pycached MODNAME.py+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1739 +#: pages/Python.adoc:1742 msgid "" "Given a Python file, lists the file and the files with its bytecode cache. " "See _Source files and bytecode cache_ for more information." msgstr "" #. type: Plain text -#: pages/Python.adoc:1742 +#: pages/Python.adoc:1745 msgid "`+%py_provides python3-MODNAME+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1746 +#: pages/Python.adoc:1749 msgid "" "Generates `+Provides+` for `+python3-MODNAME+`, `+python3.X-MODNAME+` and " "`+python-MODNAME+`. See <> for more details." msgstr "" #. type: Plain text -#: pages/Python.adoc:1749 +#: pages/Python.adoc:1752 msgid "`+%py_byte_compile INTERPRETER PATH+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1751 +#: pages/Python.adoc:1754 msgid "Byte-compile a Python file into a `+__pycache__/*.pyc+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1756 +#: pages/Python.adoc:1759 msgid "" "If the `+PATH+` argument is a directory, the macro will recursively byte " "compile all `+*.py+` files in the directory. (So, if you need to compile " @@ -3179,7 +3187,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1763 +#: pages/Python.adoc:1766 msgid "" "The `+INTERPRETER+` determines the compiled file name’s suffix and the magic " "number embedded in the file. These muct match the interpreter that will " @@ -3189,17 +3197,17 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1765 +#: pages/Python.adoc:1768 msgid "[#py_dist_name]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1766 +#: pages/Python.adoc:1769 msgid "`+%{py_dist_name PROJECTNAME}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1770 +#: pages/Python.adoc:1773 msgid "" "Given a _project name_ (e.g. `+PyYAML+`) it will convert it to the canonical " "format (e.g. `+pyyaml+`). See <> for more " @@ -3207,17 +3215,17 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1772 +#: pages/Python.adoc:1775 msgid "[#py3_dist]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1773 +#: pages/Python.adoc:1776 msgid "`+%{py3_dist PROJECTNAME …}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1779 +#: pages/Python.adoc:1782 msgid "" "Given one or more _project names_, it will convert them to the canonical " "format and evaluate to `+python3dist(DISTNAME)+`, which is useful when " @@ -3226,28 +3234,28 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1780 +#: pages/Python.adoc:1783 #, no-wrap msgid "System Settings" msgstr "Järjestelmän asetukset" #. type: Plain text -#: pages/Python.adoc:1783 +#: pages/Python.adoc:1786 msgid "The following macros can be redefined for special use cases." msgstr "" #. type: Plain text -#: pages/Python.adoc:1785 +#: pages/Python.adoc:1788 msgid "[#__python]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1786 +#: pages/Python.adoc:1789 msgid "`+%{__python}+` (errors by default if not redefined)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1790 +#: pages/Python.adoc:1793 msgid "" "Defining this macro sets the meaning of all “unversioned” Python macros such " "as `+%{python}+` or `+%{python_sitelib}+`. Don’t use these macros without " @@ -3255,24 +3263,24 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1793 +#: pages/Python.adoc:1796 msgid "`+%{__python3}+` (`+/usr/bin/python3+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1797 +#: pages/Python.adoc:1800 msgid "" "The python 3 interpreter. Redefining this macro changes all the `+" "%{python3...}+` macros, e.g. `+%{python3}+` or `+%{python3_sitelib}+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1800 +#: pages/Python.adoc:1803 msgid "`+%{python3_pkgversion}+` (`+3+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1807 +#: pages/Python.adoc:1810 msgid "" "Distro-wide Python version, i.e. the `+3+` in `+python3+`. Projects that " "build on top of Fedora might define it to e.g. `+3.9+` to try allowing " @@ -3282,13 +3290,13 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1808 +#: pages/Python.adoc:1811 #, no-wrap msgid "Comparing Python versions" msgstr "" #. type: Plain text -#: pages/Python.adoc:1816 +#: pages/Python.adoc:1819 msgid "" "When comparing Python versions (e.g. to ask: is `+%{python3_version}+` " "greater than 3.8?), using naïve `+%if %{python3_version} > 3.8+` or `+%if " @@ -3298,14 +3306,14 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1819 +#: pages/Python.adoc:1822 msgid "" "It is possible to explicitly compare version literals by using the `+v+` " "prefix, similar to the Python string prefixes:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1825 +#: pages/Python.adoc:1828 #, no-wrap msgid "" "%if v\"0%{?python3_version}\" > v\"3.8\"\n" @@ -3314,14 +3322,14 @@ msgid "" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1831 +#: pages/Python.adoc:1834 msgid "" "As a workaround for compatibility with RPM releases before 4.16 (Fedora 33), " "`+%{python3_version_nodots}+` can be compared as an integers:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1837 +#: pages/Python.adoc:1840 #, no-wrap msgid "" "%if %{python3_version_nodots} > 38\n" @@ -3330,47 +3338,47 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1841 +#: pages/Python.adoc:1844 msgid "" "This will work with Python 3.10 (310 > 39), but eventually break with Python " "4.0 (40 < 310)." msgstr "" #. type: Title === -#: pages/Python.adoc:1843 +#: pages/Python.adoc:1846 #, no-wrap msgid "Disabling automation" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1846 +#: pages/Python.adoc:1849 msgid "The following macros can turn off Python-specific automation." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1848 +#: pages/Python.adoc:1851 msgid "Consider contacting the Python SIG if you need to do this." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1851 +#: pages/Python.adoc:1854 msgid "`+%{?python_disable_dependency_generator}+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1854 +#: pages/Python.adoc:1857 msgid "" "Disables the automatic dependency generator. See <> for details." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1857 +#: pages/Python.adoc:1860 msgid "`+%undefine __pythonname_provides+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1861 +#: pages/Python.adoc:1864 msgid "" "Disables automatic generation of unversioned/versioned provides for package " "names, e.g. `+python-FOO+` and `+python3.9-FOO+` for `+python3-foo+`. See " @@ -3378,34 +3386,34 @@ msgid "" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1864 +#: pages/Python.adoc:1867 msgid "`+%undefine __pythondist_provides+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1868 +#: pages/Python.adoc:1871 msgid "" "Disables automatic generation of machine-readable Provides, e." "g. `+python3dist(foo)+`. See <> for more details." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1871 +#: pages/Python.adoc:1874 msgid "`+%global _python_no_extras_requires 1+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1873 +#: pages/Python.adoc:1876 msgid "If defined, <> will not be generated." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1876 +#: pages/Python.adoc:1879 msgid "`+%global _python_dist_allow_version_zero 1+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1880 +#: pages/Python.adoc:1883 msgid "" "From Fedora Linux 38 on, it is no longer possible to build a Python package " "with version 0 to prevent <<_version_warning,an accidental loss of the " @@ -3414,65 +3422,65 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1881 +#: pages/Python.adoc:1884 #, no-wrap msgid "Deprecated Macros" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1886 +#: pages/Python.adoc:1889 msgid "" "The following macros are deprecated. See the xref:Python_201x.adoc[201x-era " "Python Packaging guidelines] for how some of them were used." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1888 +#: pages/Python.adoc:1891 msgid "[[py3_build]] `+%py3_build+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1889 +#: pages/Python.adoc:1892 msgid "[[py3_build_wheel]] `+%py3_build_wheel+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1890 +#: pages/Python.adoc:1893 msgid "[[py3_build_egg]] `+%py3_build_egg+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1891 +#: pages/Python.adoc:1894 msgid "[[py3_install]] `+%py3_install+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1892 +#: pages/Python.adoc:1895 msgid "[[py3_install_wheel]] `+%py3_install_wheel+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1893 +#: pages/Python.adoc:1896 msgid "[[py3_install_egg]] `+%py3_install_egg+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1894 +#: pages/Python.adoc:1897 msgid "[[py3dir]] `+%py3dir+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1895 +#: pages/Python.adoc:1898 msgid "[[py3_other_build]] `+%py3_other_build+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1896 +#: pages/Python.adoc:1899 msgid "[[py3_other_install]] `+%py3_other_install+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1896 +#: pages/Python.adoc:1899 msgid "[[python_provide]] `+%python_provide+`" msgstr "" diff --git a/po/fr/master/pages/Python.po b/po/fr/master/pages/Python.po index 5b2992c..5f070df 100644 --- a/po/fr/master/pages/Python.po +++ b/po/fr/master/pages/Python.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2024-02-16 22:16+0000\n" +"POT-Creation-Date: 2024-03-03 22:31+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -1841,8 +1841,9 @@ msgstr "" msgid "" "A popular testing tool, and one which is well integrated in Fedora, is " "`+tox+`. Upstream, it is commonly used to test against multiple Python " -"versions. In a Fedora package, BuildRequire test dependencies (see _Test " -"dependencies_ below) and run `+tox+` with:" +"versions. In a Fedora package, BuildRequire test dependencies via `+" +"%pyproject_buildrequires -t+` or `+-e+` (see _Test dependencies_ below) and " +"run `+tox+` with:" msgstr "" #. type: delimited block - @@ -2797,12 +2798,19 @@ msgid "Run tests using `+tox+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1555 +#: pages/Python.adoc:1556 +msgid "" +"This macro needs BuildRequires generated by the `+-t+` or `+-e+` option of " +"<>." +msgstr "" + +#. type: Plain text +#: pages/Python.adoc:1558 msgid "Different environments may be specified with `+-e+`, for example:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1560 +#: pages/Python.adoc:1563 #, no-wrap msgid "" "%check\n" @@ -2810,36 +2818,36 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1563 +#: pages/Python.adoc:1566 msgid "Flags for the `+tox+` command can be specified after `+--+`:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1567 +#: pages/Python.adoc:1570 #, no-wrap msgid " %tox -- --parallel 0\n" msgstr "" #. type: Plain text -#: pages/Python.adoc:1570 +#: pages/Python.adoc:1573 msgid "" "Additional arguments for the test runner may be specified after another `+--" "+`:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1574 +#: pages/Python.adoc:1577 #, no-wrap msgid " %tox -- --parallel 0 -- --verbose tests/*\n" msgstr "" #. type: Plain text -#: pages/Python.adoc:1578 +#: pages/Python.adoc:1581 msgid "`+%{toxenv}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1582 +#: pages/Python.adoc:1585 msgid "" "The _tox_ environment(s) used by the `+%tox+` macro. Multiple environments " "are separated by commas. Can be overridden manually or with `+" @@ -2847,46 +2855,46 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1585 +#: pages/Python.adoc:1588 msgid "`+%{default_toxenv}+` (e.g. `+py39+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1587 +#: pages/Python.adoc:1590 msgid "The system-wide default value of `+%{toxenv}+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1590 +#: pages/Python.adoc:1593 msgid "`+%pytest+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1593 +#: pages/Python.adoc:1596 msgid "" "Run `+%__pytest+` with environment variables appropriate for tests in " "`%check`. See <> for details." msgstr "" #. type: Plain text -#: pages/Python.adoc:1596 +#: pages/Python.adoc:1599 msgid "`+%__pytest+` (`+/usr/bin/pytest+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1598 +#: pages/Python.adoc:1601 msgid "The command that `+%pytest+` uses. May be redefined." msgstr "" #. type: Plain text -#: pages/Python.adoc:1601 +#: pages/Python.adoc:1604 msgid "" "`+%py3_test_envvars+` (`+PATH=... PYTHONPATH=... " "PYTHONDONTWRITEBYTECODE=1 ...+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1606 +#: pages/Python.adoc:1609 msgid "" "The environment variables used by `+%pytest+` and `+%tox+`. It may be used " "to invoke custom test runners in `+%check+`. See <> for " @@ -2894,12 +2902,12 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1609 +#: pages/Python.adoc:1612 msgid "`+%py3_check_import+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1613 +#: pages/Python.adoc:1616 msgid "" "Imports all provided modules. If running an upstream test suite is not " "feasible, use this macro in `+%check+` to test that public Python modules " @@ -2907,50 +2915,50 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1615 +#: pages/Python.adoc:1618 msgid "Takes these arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1620 +#: pages/Python.adoc:1623 msgid "" "`+-f+`: path to file containing qualified module names (separated by " "newlines). Optional, can be used multiple times." msgstr "" #. type: Plain text -#: pages/Python.adoc:1622 +#: pages/Python.adoc:1625 msgid "" "`+-e+`: glob to exclude the matching module names. Optional, can be used " "multiple times." msgstr "" #. type: Plain text -#: pages/Python.adoc:1623 +#: pages/Python.adoc:1626 msgid "`+-t+`: if set, import only top-level module names" msgstr "" #. type: Plain text -#: pages/Python.adoc:1625 +#: pages/Python.adoc:1628 msgid "" "Positional arguments (separated by spaces or commas) specify the module " "name(s) to check." msgstr "" #. type: Plain text -#: pages/Python.adoc:1630 +#: pages/Python.adoc:1633 msgid "" "The macro sets various environment variables such as `+PATH+` and " "`+PYTHONPATH+` to ensure the packaged versions of modules are imported." msgstr "" #. type: Plain text -#: pages/Python.adoc:1633 +#: pages/Python.adoc:1636 msgid "`+%pyproject_check_import+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1637 +#: pages/Python.adoc:1640 msgid "" "Imports all public modules found by <> whose names match any of the provided " @@ -2958,63 +2966,63 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1640 +#: pages/Python.adoc:1643 msgid "" "This macro needs to be used with `+%pyproject_save_files+` (use `+" "%py3_check_import+` in other cases)." msgstr "" #. type: Plain text -#: pages/Python.adoc:1643 +#: pages/Python.adoc:1646 msgid "" "The macro takes `+-e+`/`+-t+` as well as positional arguments for `+" "%py3_check_import+` above." msgstr "" #. type: Title === -#: pages/Python.adoc:1644 +#: pages/Python.adoc:1647 #, no-wrap msgid "Extras macros" msgstr "" #. type: Plain text -#: pages/Python.adoc:1648 +#: pages/Python.adoc:1651 msgid "`+%pyproject_extras_subpkg+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1651 +#: pages/Python.adoc:1654 msgid "" "Generates a simple subpackage for a Python extra. See <> for more " "information." msgstr "" #. type: Plain text -#: pages/Python.adoc:1654 +#: pages/Python.adoc:1657 msgid "" "This macro needs to be used with `+%pyproject_install+` (use `+" "%python_extras_subpkg+` in other cases)." msgstr "" #. type: Plain text -#: pages/Python.adoc:1656 +#: pages/Python.adoc:1659 msgid "Required arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1659 pages/Python.adoc:1705 +#: pages/Python.adoc:1662 pages/Python.adoc:1708 msgid "`+-n+`: name of the “base” package (e.g. `+python3-requests+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1661 +#: pages/Python.adoc:1664 msgid "" "Positional arguments (separated by spaces or commas): the extra name(s). " "Multiple metapackages are generated when multiple names are provided." msgstr "" #. type: Plain text -#: pages/Python.adoc:1666 +#: pages/Python.adoc:1669 msgid "" "The macro also takes `+-i+`/`+-f+`/`+-F+` arguments for `+" "%python_extras_subpkg+` below, but if they are not given, a filelist written " @@ -3022,7 +3030,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1674 +#: pages/Python.adoc:1677 msgid "" "This macro generates all the subpackage definition sections (`+%package+` " "including the `+Summary+` and `+Requires+` on the base package, `+" @@ -3033,7 +3041,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1681 +#: pages/Python.adoc:1684 msgid "" "The `+%files+` section is last. It can be continued to add files that only " "make sense with the extra and the base package does not fail without them. " @@ -3042,7 +3050,7 @@ msgid "" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1686 +#: pages/Python.adoc:1689 #, no-wrap msgid "" "%pyproject_extras_subpkg -n a-cool-tool cli\n" @@ -3050,7 +3058,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1695 +#: pages/Python.adoc:1698 msgid "" "Due to technical limitations, the macro never generates requirements on the " "arched `+BASE_PACKAGE%{?_isa} = %{?epoch:%{epoch}:}%{version}-%{release}+`. " @@ -3060,25 +3068,25 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1698 +#: pages/Python.adoc:1701 msgid "`+%python_extras_subpkg+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1702 +#: pages/Python.adoc:1705 msgid "" "Generates a simple subpackage for a Python extra. See <> for more " "information. Takes these arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1706 +#: pages/Python.adoc:1709 msgid "" "`+-i+`: the `+%files %ghost+` path (glob) to the `+.dist-info+` directory" msgstr "" #. type: Plain text -#: pages/Python.adoc:1709 +#: pages/Python.adoc:1712 msgid "" "Positional arguments (separated by spaces or commas) specify the extra " "name(s) — multiple metapackages are generated when multiple names are " @@ -3086,7 +3094,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1713 +#: pages/Python.adoc:1716 msgid "" "`+-f+`: Relative path to the filelist for this metapackage (which should " "contain the `+%files %ghost+` path (glob) to the the metadata directory). " @@ -3094,19 +3102,19 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1716 +#: pages/Python.adoc:1719 msgid "" "`+-F+`: Skip the %files section entirely (if the packager wants to construct " "it manually). Conflicts with `+-i+` and `+-f+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1719 +#: pages/Python.adoc:1722 msgid "As with `+%pyproject_extras_subpkg+`:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1724 +#: pages/Python.adoc:1727 msgid "" "This macro generates all the subpackage definition sections, with only `+" "%files+` being customizable. For more complicated uses, construct the " @@ -3114,20 +3122,20 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1726 +#: pages/Python.adoc:1729 msgid "" "It never generates requirements on the arched `+BASE_PACKAGE%{?_isa} = %{?" "epoch:%{epoch}:}%{version}-%{release}+`." msgstr "" #. type: Title === -#: pages/Python.adoc:1727 +#: pages/Python.adoc:1730 #, no-wrap msgid "Manual generation" msgstr "" #. type: Plain text -#: pages/Python.adoc:1733 +#: pages/Python.adoc:1736 msgid "" "The following macros are available for cases where automatic generation is " "turned off. They can also be useful for handling files in non-standard " @@ -3135,41 +3143,41 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1736 +#: pages/Python.adoc:1739 msgid "`+%pycached MODNAME.py+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1739 +#: pages/Python.adoc:1742 msgid "" "Given a Python file, lists the file and the files with its bytecode cache. " "See _Source files and bytecode cache_ for more information." msgstr "" #. type: Plain text -#: pages/Python.adoc:1742 +#: pages/Python.adoc:1745 msgid "`+%py_provides python3-MODNAME+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1746 +#: pages/Python.adoc:1749 msgid "" "Generates `+Provides+` for `+python3-MODNAME+`, `+python3.X-MODNAME+` and " "`+python-MODNAME+`. See <> for more details." msgstr "" #. type: Plain text -#: pages/Python.adoc:1749 +#: pages/Python.adoc:1752 msgid "`+%py_byte_compile INTERPRETER PATH+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1751 +#: pages/Python.adoc:1754 msgid "Byte-compile a Python file into a `+__pycache__/*.pyc+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1756 +#: pages/Python.adoc:1759 msgid "" "If the `+PATH+` argument is a directory, the macro will recursively byte " "compile all `+*.py+` files in the directory. (So, if you need to compile " @@ -3177,7 +3185,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1763 +#: pages/Python.adoc:1766 msgid "" "The `+INTERPRETER+` determines the compiled file name’s suffix and the magic " "number embedded in the file. These muct match the interpreter that will " @@ -3187,17 +3195,17 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1765 +#: pages/Python.adoc:1768 msgid "[#py_dist_name]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1766 +#: pages/Python.adoc:1769 msgid "`+%{py_dist_name PROJECTNAME}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1770 +#: pages/Python.adoc:1773 msgid "" "Given a _project name_ (e.g. `+PyYAML+`) it will convert it to the canonical " "format (e.g. `+pyyaml+`). See <> for more " @@ -3205,17 +3213,17 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1772 +#: pages/Python.adoc:1775 msgid "[#py3_dist]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1773 +#: pages/Python.adoc:1776 msgid "`+%{py3_dist PROJECTNAME …}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1779 +#: pages/Python.adoc:1782 msgid "" "Given one or more _project names_, it will convert them to the canonical " "format and evaluate to `+python3dist(DISTNAME)+`, which is useful when " @@ -3224,28 +3232,28 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1780 +#: pages/Python.adoc:1783 #, no-wrap msgid "System Settings" msgstr "" #. type: Plain text -#: pages/Python.adoc:1783 +#: pages/Python.adoc:1786 msgid "The following macros can be redefined for special use cases." msgstr "" #. type: Plain text -#: pages/Python.adoc:1785 +#: pages/Python.adoc:1788 msgid "[#__python]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1786 +#: pages/Python.adoc:1789 msgid "`+%{__python}+` (errors by default if not redefined)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1790 +#: pages/Python.adoc:1793 msgid "" "Defining this macro sets the meaning of all “unversioned” Python macros such " "as `+%{python}+` or `+%{python_sitelib}+`. Don’t use these macros without " @@ -3253,24 +3261,24 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1793 +#: pages/Python.adoc:1796 msgid "`+%{__python3}+` (`+/usr/bin/python3+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1797 +#: pages/Python.adoc:1800 msgid "" "The python 3 interpreter. Redefining this macro changes all the `+" "%{python3...}+` macros, e.g. `+%{python3}+` or `+%{python3_sitelib}+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1800 +#: pages/Python.adoc:1803 msgid "`+%{python3_pkgversion}+` (`+3+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1807 +#: pages/Python.adoc:1810 msgid "" "Distro-wide Python version, i.e. the `+3+` in `+python3+`. Projects that " "build on top of Fedora might define it to e.g. `+3.9+` to try allowing " @@ -3280,13 +3288,13 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1808 +#: pages/Python.adoc:1811 #, no-wrap msgid "Comparing Python versions" msgstr "" #. type: Plain text -#: pages/Python.adoc:1816 +#: pages/Python.adoc:1819 msgid "" "When comparing Python versions (e.g. to ask: is `+%{python3_version}+` " "greater than 3.8?), using naïve `+%if %{python3_version} > 3.8+` or `+%if " @@ -3296,14 +3304,14 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1819 +#: pages/Python.adoc:1822 msgid "" "It is possible to explicitly compare version literals by using the `+v+` " "prefix, similar to the Python string prefixes:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1825 +#: pages/Python.adoc:1828 #, no-wrap msgid "" "%if v\"0%{?python3_version}\" > v\"3.8\"\n" @@ -3312,14 +3320,14 @@ msgid "" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1831 +#: pages/Python.adoc:1834 msgid "" "As a workaround for compatibility with RPM releases before 4.16 (Fedora 33), " "`+%{python3_version_nodots}+` can be compared as an integers:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1837 +#: pages/Python.adoc:1840 #, no-wrap msgid "" "%if %{python3_version_nodots} > 38\n" @@ -3328,47 +3336,47 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1841 +#: pages/Python.adoc:1844 msgid "" "This will work with Python 3.10 (310 > 39), but eventually break with Python " "4.0 (40 < 310)." msgstr "" #. type: Title === -#: pages/Python.adoc:1843 +#: pages/Python.adoc:1846 #, no-wrap msgid "Disabling automation" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1846 +#: pages/Python.adoc:1849 msgid "The following macros can turn off Python-specific automation." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1848 +#: pages/Python.adoc:1851 msgid "Consider contacting the Python SIG if you need to do this." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1851 +#: pages/Python.adoc:1854 msgid "`+%{?python_disable_dependency_generator}+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1854 +#: pages/Python.adoc:1857 msgid "" "Disables the automatic dependency generator. See <> for details." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1857 +#: pages/Python.adoc:1860 msgid "`+%undefine __pythonname_provides+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1861 +#: pages/Python.adoc:1864 msgid "" "Disables automatic generation of unversioned/versioned provides for package " "names, e.g. `+python-FOO+` and `+python3.9-FOO+` for `+python3-foo+`. See " @@ -3376,34 +3384,34 @@ msgid "" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1864 +#: pages/Python.adoc:1867 msgid "`+%undefine __pythondist_provides+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1868 +#: pages/Python.adoc:1871 msgid "" "Disables automatic generation of machine-readable Provides, e." "g. `+python3dist(foo)+`. See <> for more details." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1871 +#: pages/Python.adoc:1874 msgid "`+%global _python_no_extras_requires 1+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1873 +#: pages/Python.adoc:1876 msgid "If defined, <> will not be generated." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1876 +#: pages/Python.adoc:1879 msgid "`+%global _python_dist_allow_version_zero 1+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1880 +#: pages/Python.adoc:1883 msgid "" "From Fedora Linux 38 on, it is no longer possible to build a Python package " "with version 0 to prevent <<_version_warning,an accidental loss of the " @@ -3412,64 +3420,64 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1881 +#: pages/Python.adoc:1884 #, no-wrap msgid "Deprecated Macros" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1886 +#: pages/Python.adoc:1889 msgid "" "The following macros are deprecated. See the xref:Python_201x.adoc[201x-era " "Python Packaging guidelines] for how some of them were used." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1888 +#: pages/Python.adoc:1891 msgid "[[py3_build]] `+%py3_build+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1889 +#: pages/Python.adoc:1892 msgid "[[py3_build_wheel]] `+%py3_build_wheel+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1890 +#: pages/Python.adoc:1893 msgid "[[py3_build_egg]] `+%py3_build_egg+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1891 +#: pages/Python.adoc:1894 msgid "[[py3_install]] `+%py3_install+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1892 +#: pages/Python.adoc:1895 msgid "[[py3_install_wheel]] `+%py3_install_wheel+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1893 +#: pages/Python.adoc:1896 msgid "[[py3_install_egg]] `+%py3_install_egg+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1894 +#: pages/Python.adoc:1897 msgid "[[py3dir]] `+%py3dir+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1895 +#: pages/Python.adoc:1898 msgid "[[py3_other_build]] `+%py3_other_build+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1896 +#: pages/Python.adoc:1899 msgid "[[py3_other_install]] `+%py3_other_install+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1896 +#: pages/Python.adoc:1899 msgid "[[python_provide]] `+%python_provide+`" msgstr "" diff --git a/po/ja/master/pages/Python.po b/po/ja/master/pages/Python.po index efd0d88..6cbb4e7 100644 --- a/po/ja/master/pages/Python.po +++ b/po/ja/master/pages/Python.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2024-02-16 22:16+0000\n" +"POT-Creation-Date: 2024-03-03 22:31+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -1840,8 +1840,9 @@ msgstr "" msgid "" "A popular testing tool, and one which is well integrated in Fedora, is " "`+tox+`. Upstream, it is commonly used to test against multiple Python " -"versions. In a Fedora package, BuildRequire test dependencies (see _Test " -"dependencies_ below) and run `+tox+` with:" +"versions. In a Fedora package, BuildRequire test dependencies via `+" +"%pyproject_buildrequires -t+` or `+-e+` (see _Test dependencies_ below) and " +"run `+tox+` with:" msgstr "" #. type: delimited block - @@ -2796,12 +2797,19 @@ msgid "Run tests using `+tox+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1555 +#: pages/Python.adoc:1556 +msgid "" +"This macro needs BuildRequires generated by the `+-t+` or `+-e+` option of " +"<>." +msgstr "" + +#. type: Plain text +#: pages/Python.adoc:1558 msgid "Different environments may be specified with `+-e+`, for example:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1560 +#: pages/Python.adoc:1563 #, no-wrap msgid "" "%check\n" @@ -2809,36 +2817,36 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1563 +#: pages/Python.adoc:1566 msgid "Flags for the `+tox+` command can be specified after `+--+`:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1567 +#: pages/Python.adoc:1570 #, no-wrap msgid " %tox -- --parallel 0\n" msgstr "" #. type: Plain text -#: pages/Python.adoc:1570 +#: pages/Python.adoc:1573 msgid "" "Additional arguments for the test runner may be specified after another `+--" "+`:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1574 +#: pages/Python.adoc:1577 #, no-wrap msgid " %tox -- --parallel 0 -- --verbose tests/*\n" msgstr "" #. type: Plain text -#: pages/Python.adoc:1578 +#: pages/Python.adoc:1581 msgid "`+%{toxenv}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1582 +#: pages/Python.adoc:1585 msgid "" "The _tox_ environment(s) used by the `+%tox+` macro. Multiple environments " "are separated by commas. Can be overridden manually or with `+" @@ -2846,46 +2854,46 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1585 +#: pages/Python.adoc:1588 msgid "`+%{default_toxenv}+` (e.g. `+py39+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1587 +#: pages/Python.adoc:1590 msgid "The system-wide default value of `+%{toxenv}+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1590 +#: pages/Python.adoc:1593 msgid "`+%pytest+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1593 +#: pages/Python.adoc:1596 msgid "" "Run `+%__pytest+` with environment variables appropriate for tests in " "`%check`. See <> for details." msgstr "" #. type: Plain text -#: pages/Python.adoc:1596 +#: pages/Python.adoc:1599 msgid "`+%__pytest+` (`+/usr/bin/pytest+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1598 +#: pages/Python.adoc:1601 msgid "The command that `+%pytest+` uses. May be redefined." msgstr "" #. type: Plain text -#: pages/Python.adoc:1601 +#: pages/Python.adoc:1604 msgid "" "`+%py3_test_envvars+` (`+PATH=... PYTHONPATH=... " "PYTHONDONTWRITEBYTECODE=1 ...+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1606 +#: pages/Python.adoc:1609 msgid "" "The environment variables used by `+%pytest+` and `+%tox+`. It may be used " "to invoke custom test runners in `+%check+`. See <> for " @@ -2893,12 +2901,12 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1609 +#: pages/Python.adoc:1612 msgid "`+%py3_check_import+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1613 +#: pages/Python.adoc:1616 msgid "" "Imports all provided modules. If running an upstream test suite is not " "feasible, use this macro in `+%check+` to test that public Python modules " @@ -2906,50 +2914,50 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1615 +#: pages/Python.adoc:1618 msgid "Takes these arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1620 +#: pages/Python.adoc:1623 msgid "" "`+-f+`: path to file containing qualified module names (separated by " "newlines). Optional, can be used multiple times." msgstr "" #. type: Plain text -#: pages/Python.adoc:1622 +#: pages/Python.adoc:1625 msgid "" "`+-e+`: glob to exclude the matching module names. Optional, can be used " "multiple times." msgstr "" #. type: Plain text -#: pages/Python.adoc:1623 +#: pages/Python.adoc:1626 msgid "`+-t+`: if set, import only top-level module names" msgstr "" #. type: Plain text -#: pages/Python.adoc:1625 +#: pages/Python.adoc:1628 msgid "" "Positional arguments (separated by spaces or commas) specify the module " "name(s) to check." msgstr "" #. type: Plain text -#: pages/Python.adoc:1630 +#: pages/Python.adoc:1633 msgid "" "The macro sets various environment variables such as `+PATH+` and " "`+PYTHONPATH+` to ensure the packaged versions of modules are imported." msgstr "" #. type: Plain text -#: pages/Python.adoc:1633 +#: pages/Python.adoc:1636 msgid "`+%pyproject_check_import+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1637 +#: pages/Python.adoc:1640 msgid "" "Imports all public modules found by <> whose names match any of the provided " @@ -2957,63 +2965,63 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1640 +#: pages/Python.adoc:1643 msgid "" "This macro needs to be used with `+%pyproject_save_files+` (use `+" "%py3_check_import+` in other cases)." msgstr "" #. type: Plain text -#: pages/Python.adoc:1643 +#: pages/Python.adoc:1646 msgid "" "The macro takes `+-e+`/`+-t+` as well as positional arguments for `+" "%py3_check_import+` above." msgstr "" #. type: Title === -#: pages/Python.adoc:1644 +#: pages/Python.adoc:1647 #, no-wrap msgid "Extras macros" msgstr "" #. type: Plain text -#: pages/Python.adoc:1648 +#: pages/Python.adoc:1651 msgid "`+%pyproject_extras_subpkg+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1651 +#: pages/Python.adoc:1654 msgid "" "Generates a simple subpackage for a Python extra. See <> for more " "information." msgstr "" #. type: Plain text -#: pages/Python.adoc:1654 +#: pages/Python.adoc:1657 msgid "" "This macro needs to be used with `+%pyproject_install+` (use `+" "%python_extras_subpkg+` in other cases)." msgstr "" #. type: Plain text -#: pages/Python.adoc:1656 +#: pages/Python.adoc:1659 msgid "Required arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1659 pages/Python.adoc:1705 +#: pages/Python.adoc:1662 pages/Python.adoc:1708 msgid "`+-n+`: name of the “base” package (e.g. `+python3-requests+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1661 +#: pages/Python.adoc:1664 msgid "" "Positional arguments (separated by spaces or commas): the extra name(s). " "Multiple metapackages are generated when multiple names are provided." msgstr "" #. type: Plain text -#: pages/Python.adoc:1666 +#: pages/Python.adoc:1669 msgid "" "The macro also takes `+-i+`/`+-f+`/`+-F+` arguments for `+" "%python_extras_subpkg+` below, but if they are not given, a filelist written " @@ -3021,7 +3029,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1674 +#: pages/Python.adoc:1677 msgid "" "This macro generates all the subpackage definition sections (`+%package+` " "including the `+Summary+` and `+Requires+` on the base package, `+" @@ -3032,7 +3040,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1681 +#: pages/Python.adoc:1684 msgid "" "The `+%files+` section is last. It can be continued to add files that only " "make sense with the extra and the base package does not fail without them. " @@ -3041,7 +3049,7 @@ msgid "" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1686 +#: pages/Python.adoc:1689 #, no-wrap msgid "" "%pyproject_extras_subpkg -n a-cool-tool cli\n" @@ -3049,7 +3057,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1695 +#: pages/Python.adoc:1698 msgid "" "Due to technical limitations, the macro never generates requirements on the " "arched `+BASE_PACKAGE%{?_isa} = %{?epoch:%{epoch}:}%{version}-%{release}+`. " @@ -3059,25 +3067,25 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1698 +#: pages/Python.adoc:1701 msgid "`+%python_extras_subpkg+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1702 +#: pages/Python.adoc:1705 msgid "" "Generates a simple subpackage for a Python extra. See <> for more " "information. Takes these arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1706 +#: pages/Python.adoc:1709 msgid "" "`+-i+`: the `+%files %ghost+` path (glob) to the `+.dist-info+` directory" msgstr "" #. type: Plain text -#: pages/Python.adoc:1709 +#: pages/Python.adoc:1712 msgid "" "Positional arguments (separated by spaces or commas) specify the extra " "name(s) — multiple metapackages are generated when multiple names are " @@ -3085,7 +3093,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1713 +#: pages/Python.adoc:1716 msgid "" "`+-f+`: Relative path to the filelist for this metapackage (which should " "contain the `+%files %ghost+` path (glob) to the the metadata directory). " @@ -3093,19 +3101,19 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1716 +#: pages/Python.adoc:1719 msgid "" "`+-F+`: Skip the %files section entirely (if the packager wants to construct " "it manually). Conflicts with `+-i+` and `+-f+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1719 +#: pages/Python.adoc:1722 msgid "As with `+%pyproject_extras_subpkg+`:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1724 +#: pages/Python.adoc:1727 msgid "" "This macro generates all the subpackage definition sections, with only `+" "%files+` being customizable. For more complicated uses, construct the " @@ -3113,20 +3121,20 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1726 +#: pages/Python.adoc:1729 msgid "" "It never generates requirements on the arched `+BASE_PACKAGE%{?_isa} = %{?" "epoch:%{epoch}:}%{version}-%{release}+`." msgstr "" #. type: Title === -#: pages/Python.adoc:1727 +#: pages/Python.adoc:1730 #, no-wrap msgid "Manual generation" msgstr "" #. type: Plain text -#: pages/Python.adoc:1733 +#: pages/Python.adoc:1736 msgid "" "The following macros are available for cases where automatic generation is " "turned off. They can also be useful for handling files in non-standard " @@ -3134,41 +3142,41 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1736 +#: pages/Python.adoc:1739 msgid "`+%pycached MODNAME.py+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1739 +#: pages/Python.adoc:1742 msgid "" "Given a Python file, lists the file and the files with its bytecode cache. " "See _Source files and bytecode cache_ for more information." msgstr "" #. type: Plain text -#: pages/Python.adoc:1742 +#: pages/Python.adoc:1745 msgid "`+%py_provides python3-MODNAME+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1746 +#: pages/Python.adoc:1749 msgid "" "Generates `+Provides+` for `+python3-MODNAME+`, `+python3.X-MODNAME+` and " "`+python-MODNAME+`. See <> for more details." msgstr "" #. type: Plain text -#: pages/Python.adoc:1749 +#: pages/Python.adoc:1752 msgid "`+%py_byte_compile INTERPRETER PATH+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1751 +#: pages/Python.adoc:1754 msgid "Byte-compile a Python file into a `+__pycache__/*.pyc+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1756 +#: pages/Python.adoc:1759 msgid "" "If the `+PATH+` argument is a directory, the macro will recursively byte " "compile all `+*.py+` files in the directory. (So, if you need to compile " @@ -3176,7 +3184,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1763 +#: pages/Python.adoc:1766 msgid "" "The `+INTERPRETER+` determines the compiled file name’s suffix and the magic " "number embedded in the file. These muct match the interpreter that will " @@ -3186,17 +3194,17 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1765 +#: pages/Python.adoc:1768 msgid "[#py_dist_name]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1766 +#: pages/Python.adoc:1769 msgid "`+%{py_dist_name PROJECTNAME}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1770 +#: pages/Python.adoc:1773 msgid "" "Given a _project name_ (e.g. `+PyYAML+`) it will convert it to the canonical " "format (e.g. `+pyyaml+`). See <> for more " @@ -3204,17 +3212,17 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1772 +#: pages/Python.adoc:1775 msgid "[#py3_dist]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1773 +#: pages/Python.adoc:1776 msgid "`+%{py3_dist PROJECTNAME …}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1779 +#: pages/Python.adoc:1782 msgid "" "Given one or more _project names_, it will convert them to the canonical " "format and evaluate to `+python3dist(DISTNAME)+`, which is useful when " @@ -3223,28 +3231,28 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1780 +#: pages/Python.adoc:1783 #, no-wrap msgid "System Settings" msgstr "" #. type: Plain text -#: pages/Python.adoc:1783 +#: pages/Python.adoc:1786 msgid "The following macros can be redefined for special use cases." msgstr "" #. type: Plain text -#: pages/Python.adoc:1785 +#: pages/Python.adoc:1788 msgid "[#__python]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1786 +#: pages/Python.adoc:1789 msgid "`+%{__python}+` (errors by default if not redefined)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1790 +#: pages/Python.adoc:1793 msgid "" "Defining this macro sets the meaning of all “unversioned” Python macros such " "as `+%{python}+` or `+%{python_sitelib}+`. Don’t use these macros without " @@ -3252,24 +3260,24 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1793 +#: pages/Python.adoc:1796 msgid "`+%{__python3}+` (`+/usr/bin/python3+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1797 +#: pages/Python.adoc:1800 msgid "" "The python 3 interpreter. Redefining this macro changes all the `+" "%{python3...}+` macros, e.g. `+%{python3}+` or `+%{python3_sitelib}+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1800 +#: pages/Python.adoc:1803 msgid "`+%{python3_pkgversion}+` (`+3+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1807 +#: pages/Python.adoc:1810 msgid "" "Distro-wide Python version, i.e. the `+3+` in `+python3+`. Projects that " "build on top of Fedora might define it to e.g. `+3.9+` to try allowing " @@ -3279,13 +3287,13 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1808 +#: pages/Python.adoc:1811 #, no-wrap msgid "Comparing Python versions" msgstr "" #. type: Plain text -#: pages/Python.adoc:1816 +#: pages/Python.adoc:1819 msgid "" "When comparing Python versions (e.g. to ask: is `+%{python3_version}+` " "greater than 3.8?), using naïve `+%if %{python3_version} > 3.8+` or `+%if " @@ -3295,14 +3303,14 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1819 +#: pages/Python.adoc:1822 msgid "" "It is possible to explicitly compare version literals by using the `+v+` " "prefix, similar to the Python string prefixes:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1825 +#: pages/Python.adoc:1828 #, no-wrap msgid "" "%if v\"0%{?python3_version}\" > v\"3.8\"\n" @@ -3311,14 +3319,14 @@ msgid "" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1831 +#: pages/Python.adoc:1834 msgid "" "As a workaround for compatibility with RPM releases before 4.16 (Fedora 33), " "`+%{python3_version_nodots}+` can be compared as an integers:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1837 +#: pages/Python.adoc:1840 #, no-wrap msgid "" "%if %{python3_version_nodots} > 38\n" @@ -3327,47 +3335,47 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1841 +#: pages/Python.adoc:1844 msgid "" "This will work with Python 3.10 (310 > 39), but eventually break with Python " "4.0 (40 < 310)." msgstr "" #. type: Title === -#: pages/Python.adoc:1843 +#: pages/Python.adoc:1846 #, no-wrap msgid "Disabling automation" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1846 +#: pages/Python.adoc:1849 msgid "The following macros can turn off Python-specific automation." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1848 +#: pages/Python.adoc:1851 msgid "Consider contacting the Python SIG if you need to do this." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1851 +#: pages/Python.adoc:1854 msgid "`+%{?python_disable_dependency_generator}+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1854 +#: pages/Python.adoc:1857 msgid "" "Disables the automatic dependency generator. See <> for details." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1857 +#: pages/Python.adoc:1860 msgid "`+%undefine __pythonname_provides+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1861 +#: pages/Python.adoc:1864 msgid "" "Disables automatic generation of unversioned/versioned provides for package " "names, e.g. `+python-FOO+` and `+python3.9-FOO+` for `+python3-foo+`. See " @@ -3375,34 +3383,34 @@ msgid "" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1864 +#: pages/Python.adoc:1867 msgid "`+%undefine __pythondist_provides+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1868 +#: pages/Python.adoc:1871 msgid "" "Disables automatic generation of machine-readable Provides, e." "g. `+python3dist(foo)+`. See <> for more details." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1871 +#: pages/Python.adoc:1874 msgid "`+%global _python_no_extras_requires 1+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1873 +#: pages/Python.adoc:1876 msgid "If defined, <> will not be generated." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1876 +#: pages/Python.adoc:1879 msgid "`+%global _python_dist_allow_version_zero 1+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1880 +#: pages/Python.adoc:1883 msgid "" "From Fedora Linux 38 on, it is no longer possible to build a Python package " "with version 0 to prevent <<_version_warning,an accidental loss of the " @@ -3411,64 +3419,64 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1881 +#: pages/Python.adoc:1884 #, no-wrap msgid "Deprecated Macros" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1886 +#: pages/Python.adoc:1889 msgid "" "The following macros are deprecated. See the xref:Python_201x.adoc[201x-era " "Python Packaging guidelines] for how some of them were used." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1888 +#: pages/Python.adoc:1891 msgid "[[py3_build]] `+%py3_build+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1889 +#: pages/Python.adoc:1892 msgid "[[py3_build_wheel]] `+%py3_build_wheel+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1890 +#: pages/Python.adoc:1893 msgid "[[py3_build_egg]] `+%py3_build_egg+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1891 +#: pages/Python.adoc:1894 msgid "[[py3_install]] `+%py3_install+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1892 +#: pages/Python.adoc:1895 msgid "[[py3_install_wheel]] `+%py3_install_wheel+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1893 +#: pages/Python.adoc:1896 msgid "[[py3_install_egg]] `+%py3_install_egg+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1894 +#: pages/Python.adoc:1897 msgid "[[py3dir]] `+%py3dir+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1895 +#: pages/Python.adoc:1898 msgid "[[py3_other_build]] `+%py3_other_build+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1896 +#: pages/Python.adoc:1899 msgid "[[py3_other_install]] `+%py3_other_install+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1896 +#: pages/Python.adoc:1899 msgid "[[python_provide]] `+%python_provide+`" msgstr "" diff --git a/po/pt_BR/master/pages/Python.po b/po/pt_BR/master/pages/Python.po index bf60192..3303cc5 100644 --- a/po/pt_BR/master/pages/Python.po +++ b/po/pt_BR/master/pages/Python.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2024-02-16 22:16+0000\n" +"POT-Creation-Date: 2024-03-03 22:31+0000\n" "PO-Revision-Date: 2024-01-18 10:36+0000\n" "Last-Translator: Rafael Fontenelle \n" "Language-Team: Portuguese (Brazil) >." +msgstr "" + +#. type: Plain text +#: pages/Python.adoc:1558 msgid "Different environments may be specified with `+-e+`, for example:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1560 +#: pages/Python.adoc:1563 #, no-wrap msgid "" "%check\n" @@ -3182,36 +3190,36 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1563 +#: pages/Python.adoc:1566 msgid "Flags for the `+tox+` command can be specified after `+--+`:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1567 +#: pages/Python.adoc:1570 #, no-wrap msgid " %tox -- --parallel 0\n" msgstr "" #. type: Plain text -#: pages/Python.adoc:1570 +#: pages/Python.adoc:1573 msgid "" "Additional arguments for the test runner may be specified after another `+--" "+`:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1574 +#: pages/Python.adoc:1577 #, no-wrap msgid " %tox -- --parallel 0 -- --verbose tests/*\n" msgstr "" #. type: Plain text -#: pages/Python.adoc:1578 +#: pages/Python.adoc:1581 msgid "`+%{toxenv}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1582 +#: pages/Python.adoc:1585 msgid "" "The _tox_ environment(s) used by the `+%tox+` macro. Multiple environments " "are separated by commas. Can be overridden manually or with `+" @@ -3219,46 +3227,46 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1585 +#: pages/Python.adoc:1588 msgid "`+%{default_toxenv}+` (e.g. `+py39+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1587 +#: pages/Python.adoc:1590 msgid "The system-wide default value of `+%{toxenv}+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1590 +#: pages/Python.adoc:1593 msgid "`+%pytest+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1593 +#: pages/Python.adoc:1596 msgid "" "Run `+%__pytest+` with environment variables appropriate for tests in " "`%check`. See <> for details." msgstr "" #. type: Plain text -#: pages/Python.adoc:1596 +#: pages/Python.adoc:1599 msgid "`+%__pytest+` (`+/usr/bin/pytest+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1598 +#: pages/Python.adoc:1601 msgid "The command that `+%pytest+` uses. May be redefined." msgstr "" #. type: Plain text -#: pages/Python.adoc:1601 +#: pages/Python.adoc:1604 msgid "" "`+%py3_test_envvars+` (`+PATH=... PYTHONPATH=... " "PYTHONDONTWRITEBYTECODE=1 ...+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1606 +#: pages/Python.adoc:1609 msgid "" "The environment variables used by `+%pytest+` and `+%tox+`. It may be used " "to invoke custom test runners in `+%check+`. See <> for " @@ -3266,12 +3274,12 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1609 +#: pages/Python.adoc:1612 msgid "`+%py3_check_import+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1613 +#: pages/Python.adoc:1616 msgid "" "Imports all provided modules. If running an upstream test suite is not " "feasible, use this macro in `+%check+` to test that public Python modules " @@ -3279,50 +3287,50 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1615 +#: pages/Python.adoc:1618 msgid "Takes these arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1620 +#: pages/Python.adoc:1623 msgid "" "`+-f+`: path to file containing qualified module names (separated by " "newlines). Optional, can be used multiple times." msgstr "" #. type: Plain text -#: pages/Python.adoc:1622 +#: pages/Python.adoc:1625 msgid "" "`+-e+`: glob to exclude the matching module names. Optional, can be used " "multiple times." msgstr "" #. type: Plain text -#: pages/Python.adoc:1623 +#: pages/Python.adoc:1626 msgid "`+-t+`: if set, import only top-level module names" msgstr "" #. type: Plain text -#: pages/Python.adoc:1625 +#: pages/Python.adoc:1628 msgid "" "Positional arguments (separated by spaces or commas) specify the module " "name(s) to check." msgstr "" #. type: Plain text -#: pages/Python.adoc:1630 +#: pages/Python.adoc:1633 msgid "" "The macro sets various environment variables such as `+PATH+` and " "`+PYTHONPATH+` to ensure the packaged versions of modules are imported." msgstr "" #. type: Plain text -#: pages/Python.adoc:1633 +#: pages/Python.adoc:1636 msgid "`+%pyproject_check_import+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1637 +#: pages/Python.adoc:1640 msgid "" "Imports all public modules found by <> whose names match any of the provided " @@ -3330,63 +3338,63 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1640 +#: pages/Python.adoc:1643 msgid "" "This macro needs to be used with `+%pyproject_save_files+` (use `+" "%py3_check_import+` in other cases)." msgstr "" #. type: Plain text -#: pages/Python.adoc:1643 +#: pages/Python.adoc:1646 msgid "" "The macro takes `+-e+`/`+-t+` as well as positional arguments for `+" "%py3_check_import+` above." msgstr "" #. type: Title === -#: pages/Python.adoc:1644 +#: pages/Python.adoc:1647 #, no-wrap msgid "Extras macros" msgstr "" #. type: Plain text -#: pages/Python.adoc:1648 +#: pages/Python.adoc:1651 msgid "`+%pyproject_extras_subpkg+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1651 +#: pages/Python.adoc:1654 msgid "" "Generates a simple subpackage for a Python extra. See <> for more " "information." msgstr "" #. type: Plain text -#: pages/Python.adoc:1654 +#: pages/Python.adoc:1657 msgid "" "This macro needs to be used with `+%pyproject_install+` (use `+" "%python_extras_subpkg+` in other cases)." msgstr "" #. type: Plain text -#: pages/Python.adoc:1656 +#: pages/Python.adoc:1659 msgid "Required arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1659 pages/Python.adoc:1705 +#: pages/Python.adoc:1662 pages/Python.adoc:1708 msgid "`+-n+`: name of the “base” package (e.g. `+python3-requests+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1661 +#: pages/Python.adoc:1664 msgid "" "Positional arguments (separated by spaces or commas): the extra name(s). " "Multiple metapackages are generated when multiple names are provided." msgstr "" #. type: Plain text -#: pages/Python.adoc:1666 +#: pages/Python.adoc:1669 msgid "" "The macro also takes `+-i+`/`+-f+`/`+-F+` arguments for `+" "%python_extras_subpkg+` below, but if they are not given, a filelist written " @@ -3394,7 +3402,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1674 +#: pages/Python.adoc:1677 msgid "" "This macro generates all the subpackage definition sections (`+%package+` " "including the `+Summary+` and `+Requires+` on the base package, `+" @@ -3405,7 +3413,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1681 +#: pages/Python.adoc:1684 msgid "" "The `+%files+` section is last. It can be continued to add files that only " "make sense with the extra and the base package does not fail without them. " @@ -3414,7 +3422,7 @@ msgid "" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1686 +#: pages/Python.adoc:1689 #, no-wrap msgid "" "%pyproject_extras_subpkg -n a-cool-tool cli\n" @@ -3422,7 +3430,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1695 +#: pages/Python.adoc:1698 msgid "" "Due to technical limitations, the macro never generates requirements on the " "arched `+BASE_PACKAGE%{?_isa} = %{?epoch:%{epoch}:}%{version}-%{release}+`. " @@ -3432,25 +3440,25 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1698 +#: pages/Python.adoc:1701 msgid "`+%python_extras_subpkg+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1702 +#: pages/Python.adoc:1705 msgid "" "Generates a simple subpackage for a Python extra. See <> for more " "information. Takes these arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1706 +#: pages/Python.adoc:1709 msgid "" "`+-i+`: the `+%files %ghost+` path (glob) to the `+.dist-info+` directory" msgstr "" #. type: Plain text -#: pages/Python.adoc:1709 +#: pages/Python.adoc:1712 msgid "" "Positional arguments (separated by spaces or commas) specify the extra " "name(s) — multiple metapackages are generated when multiple names are " @@ -3458,7 +3466,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1713 +#: pages/Python.adoc:1716 msgid "" "`+-f+`: Relative path to the filelist for this metapackage (which should " "contain the `+%files %ghost+` path (glob) to the the metadata directory). " @@ -3466,19 +3474,19 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1716 +#: pages/Python.adoc:1719 msgid "" "`+-F+`: Skip the %files section entirely (if the packager wants to construct " "it manually). Conflicts with `+-i+` and `+-f+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1719 +#: pages/Python.adoc:1722 msgid "As with `+%pyproject_extras_subpkg+`:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1724 +#: pages/Python.adoc:1727 msgid "" "This macro generates all the subpackage definition sections, with only `+" "%files+` being customizable. For more complicated uses, construct the " @@ -3486,20 +3494,20 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1726 +#: pages/Python.adoc:1729 msgid "" "It never generates requirements on the arched `+BASE_PACKAGE%{?_isa} = %{?" "epoch:%{epoch}:}%{version}-%{release}+`." msgstr "" #. type: Title === -#: pages/Python.adoc:1727 +#: pages/Python.adoc:1730 #, no-wrap msgid "Manual generation" msgstr "" #. type: Plain text -#: pages/Python.adoc:1733 +#: pages/Python.adoc:1736 msgid "" "The following macros are available for cases where automatic generation is " "turned off. They can also be useful for handling files in non-standard " @@ -3507,41 +3515,41 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1736 +#: pages/Python.adoc:1739 msgid "`+%pycached MODNAME.py+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1739 +#: pages/Python.adoc:1742 msgid "" "Given a Python file, lists the file and the files with its bytecode cache. " "See _Source files and bytecode cache_ for more information." msgstr "" #. type: Plain text -#: pages/Python.adoc:1742 +#: pages/Python.adoc:1745 msgid "`+%py_provides python3-MODNAME+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1746 +#: pages/Python.adoc:1749 msgid "" "Generates `+Provides+` for `+python3-MODNAME+`, `+python3.X-MODNAME+` and " "`+python-MODNAME+`. See <> for more details." msgstr "" #. type: Plain text -#: pages/Python.adoc:1749 +#: pages/Python.adoc:1752 msgid "`+%py_byte_compile INTERPRETER PATH+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1751 +#: pages/Python.adoc:1754 msgid "Byte-compile a Python file into a `+__pycache__/*.pyc+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1756 +#: pages/Python.adoc:1759 msgid "" "If the `+PATH+` argument is a directory, the macro will recursively byte " "compile all `+*.py+` files in the directory. (So, if you need to compile " @@ -3549,7 +3557,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1763 +#: pages/Python.adoc:1766 msgid "" "The `+INTERPRETER+` determines the compiled file name’s suffix and the magic " "number embedded in the file. These muct match the interpreter that will " @@ -3559,17 +3567,17 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1765 +#: pages/Python.adoc:1768 msgid "[#py_dist_name]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1766 +#: pages/Python.adoc:1769 msgid "`+%{py_dist_name PROJECTNAME}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1770 +#: pages/Python.adoc:1773 msgid "" "Given a _project name_ (e.g. `+PyYAML+`) it will convert it to the canonical " "format (e.g. `+pyyaml+`). See <> for more " @@ -3577,17 +3585,17 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1772 +#: pages/Python.adoc:1775 msgid "[#py3_dist]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1773 +#: pages/Python.adoc:1776 msgid "`+%{py3_dist PROJECTNAME …}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1779 +#: pages/Python.adoc:1782 msgid "" "Given one or more _project names_, it will convert them to the canonical " "format and evaluate to `+python3dist(DISTNAME)+`, which is useful when " @@ -3596,28 +3604,28 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1780 +#: pages/Python.adoc:1783 #, no-wrap msgid "System Settings" msgstr "Configurações do sistema" #. type: Plain text -#: pages/Python.adoc:1783 +#: pages/Python.adoc:1786 msgid "The following macros can be redefined for special use cases." msgstr "" #. type: Plain text -#: pages/Python.adoc:1785 +#: pages/Python.adoc:1788 msgid "[#__python]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1786 +#: pages/Python.adoc:1789 msgid "`+%{__python}+` (errors by default if not redefined)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1790 +#: pages/Python.adoc:1793 msgid "" "Defining this macro sets the meaning of all “unversioned” Python macros such " "as `+%{python}+` or `+%{python_sitelib}+`. Don’t use these macros without " @@ -3625,24 +3633,24 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1793 +#: pages/Python.adoc:1796 msgid "`+%{__python3}+` (`+/usr/bin/python3+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1797 +#: pages/Python.adoc:1800 msgid "" "The python 3 interpreter. Redefining this macro changes all the `+" "%{python3...}+` macros, e.g. `+%{python3}+` or `+%{python3_sitelib}+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1800 +#: pages/Python.adoc:1803 msgid "`+%{python3_pkgversion}+` (`+3+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1807 +#: pages/Python.adoc:1810 msgid "" "Distro-wide Python version, i.e. the `+3+` in `+python3+`. Projects that " "build on top of Fedora might define it to e.g. `+3.9+` to try allowing " @@ -3652,13 +3660,13 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1808 +#: pages/Python.adoc:1811 #, no-wrap msgid "Comparing Python versions" msgstr "" #. type: Plain text -#: pages/Python.adoc:1816 +#: pages/Python.adoc:1819 msgid "" "When comparing Python versions (e.g. to ask: is `+%{python3_version}+` " "greater than 3.8?), using naïve `+%if %{python3_version} > 3.8+` or `+%if " @@ -3668,14 +3676,14 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1819 +#: pages/Python.adoc:1822 msgid "" "It is possible to explicitly compare version literals by using the `+v+` " "prefix, similar to the Python string prefixes:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1825 +#: pages/Python.adoc:1828 #, no-wrap msgid "" "%if v\"0%{?python3_version}\" > v\"3.8\"\n" @@ -3684,14 +3692,14 @@ msgid "" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1831 +#: pages/Python.adoc:1834 msgid "" "As a workaround for compatibility with RPM releases before 4.16 (Fedora 33), " "`+%{python3_version_nodots}+` can be compared as an integers:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1837 +#: pages/Python.adoc:1840 #, no-wrap msgid "" "%if %{python3_version_nodots} > 38\n" @@ -3700,47 +3708,47 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1841 +#: pages/Python.adoc:1844 msgid "" "This will work with Python 3.10 (310 > 39), but eventually break with Python " "4.0 (40 < 310)." msgstr "" #. type: Title === -#: pages/Python.adoc:1843 +#: pages/Python.adoc:1846 #, no-wrap msgid "Disabling automation" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1846 +#: pages/Python.adoc:1849 msgid "The following macros can turn off Python-specific automation." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1848 +#: pages/Python.adoc:1851 msgid "Consider contacting the Python SIG if you need to do this." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1851 +#: pages/Python.adoc:1854 msgid "`+%{?python_disable_dependency_generator}+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1854 +#: pages/Python.adoc:1857 msgid "" "Disables the automatic dependency generator. See <> for details." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1857 +#: pages/Python.adoc:1860 msgid "`+%undefine __pythonname_provides+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1861 +#: pages/Python.adoc:1864 msgid "" "Disables automatic generation of unversioned/versioned provides for package " "names, e.g. `+python-FOO+` and `+python3.9-FOO+` for `+python3-foo+`. See " @@ -3748,34 +3756,34 @@ msgid "" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1864 +#: pages/Python.adoc:1867 msgid "`+%undefine __pythondist_provides+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1868 +#: pages/Python.adoc:1871 msgid "" "Disables automatic generation of machine-readable Provides, e." "g. `+python3dist(foo)+`. See <> for more details." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1871 +#: pages/Python.adoc:1874 msgid "`+%global _python_no_extras_requires 1+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1873 +#: pages/Python.adoc:1876 msgid "If defined, <> will not be generated." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1876 +#: pages/Python.adoc:1879 msgid "`+%global _python_dist_allow_version_zero 1+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1880 +#: pages/Python.adoc:1883 msgid "" "From Fedora Linux 38 on, it is no longer possible to build a Python package " "with version 0 to prevent <<_version_warning,an accidental loss of the " @@ -3784,64 +3792,64 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1881 +#: pages/Python.adoc:1884 #, no-wrap msgid "Deprecated Macros" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1886 +#: pages/Python.adoc:1889 msgid "" "The following macros are deprecated. See the xref:Python_201x.adoc[201x-era " "Python Packaging guidelines] for how some of them were used." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1888 +#: pages/Python.adoc:1891 msgid "[[py3_build]] `+%py3_build+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1889 +#: pages/Python.adoc:1892 msgid "[[py3_build_wheel]] `+%py3_build_wheel+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1890 +#: pages/Python.adoc:1893 msgid "[[py3_build_egg]] `+%py3_build_egg+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1891 +#: pages/Python.adoc:1894 msgid "[[py3_install]] `+%py3_install+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1892 +#: pages/Python.adoc:1895 msgid "[[py3_install_wheel]] `+%py3_install_wheel+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1893 +#: pages/Python.adoc:1896 msgid "[[py3_install_egg]] `+%py3_install_egg+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1894 +#: pages/Python.adoc:1897 msgid "[[py3dir]] `+%py3dir+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1895 +#: pages/Python.adoc:1898 msgid "[[py3_other_build]] `+%py3_other_build+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1896 +#: pages/Python.adoc:1899 msgid "[[py3_other_install]] `+%py3_other_install+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1896 +#: pages/Python.adoc:1899 msgid "[[python_provide]] `+%python_provide+`" msgstr "" diff --git a/po/zh_Hans/master/pages/Python.po b/po/zh_Hans/master/pages/Python.po index c1de8a6..25a7860 100644 --- a/po/zh_Hans/master/pages/Python.po +++ b/po/zh_Hans/master/pages/Python.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2024-02-16 22:16+0000\n" +"POT-Creation-Date: 2024-03-03 22:31+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -1840,8 +1840,9 @@ msgstr "" msgid "" "A popular testing tool, and one which is well integrated in Fedora, is " "`+tox+`. Upstream, it is commonly used to test against multiple Python " -"versions. In a Fedora package, BuildRequire test dependencies (see _Test " -"dependencies_ below) and run `+tox+` with:" +"versions. In a Fedora package, BuildRequire test dependencies via `+" +"%pyproject_buildrequires -t+` or `+-e+` (see _Test dependencies_ below) and " +"run `+tox+` with:" msgstr "" #. type: delimited block - @@ -2796,12 +2797,19 @@ msgid "Run tests using `+tox+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1555 +#: pages/Python.adoc:1556 +msgid "" +"This macro needs BuildRequires generated by the `+-t+` or `+-e+` option of " +"<>." +msgstr "" + +#. type: Plain text +#: pages/Python.adoc:1558 msgid "Different environments may be specified with `+-e+`, for example:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1560 +#: pages/Python.adoc:1563 #, no-wrap msgid "" "%check\n" @@ -2809,36 +2817,36 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1563 +#: pages/Python.adoc:1566 msgid "Flags for the `+tox+` command can be specified after `+--+`:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1567 +#: pages/Python.adoc:1570 #, no-wrap msgid " %tox -- --parallel 0\n" msgstr "" #. type: Plain text -#: pages/Python.adoc:1570 +#: pages/Python.adoc:1573 msgid "" "Additional arguments for the test runner may be specified after another `+--" "+`:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1574 +#: pages/Python.adoc:1577 #, no-wrap msgid " %tox -- --parallel 0 -- --verbose tests/*\n" msgstr "" #. type: Plain text -#: pages/Python.adoc:1578 +#: pages/Python.adoc:1581 msgid "`+%{toxenv}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1582 +#: pages/Python.adoc:1585 msgid "" "The _tox_ environment(s) used by the `+%tox+` macro. Multiple environments " "are separated by commas. Can be overridden manually or with `+" @@ -2846,46 +2854,46 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1585 +#: pages/Python.adoc:1588 msgid "`+%{default_toxenv}+` (e.g. `+py39+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1587 +#: pages/Python.adoc:1590 msgid "The system-wide default value of `+%{toxenv}+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1590 +#: pages/Python.adoc:1593 msgid "`+%pytest+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1593 +#: pages/Python.adoc:1596 msgid "" "Run `+%__pytest+` with environment variables appropriate for tests in " "`%check`. See <> for details." msgstr "" #. type: Plain text -#: pages/Python.adoc:1596 +#: pages/Python.adoc:1599 msgid "`+%__pytest+` (`+/usr/bin/pytest+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1598 +#: pages/Python.adoc:1601 msgid "The command that `+%pytest+` uses. May be redefined." msgstr "" #. type: Plain text -#: pages/Python.adoc:1601 +#: pages/Python.adoc:1604 msgid "" "`+%py3_test_envvars+` (`+PATH=... PYTHONPATH=... " "PYTHONDONTWRITEBYTECODE=1 ...+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1606 +#: pages/Python.adoc:1609 msgid "" "The environment variables used by `+%pytest+` and `+%tox+`. It may be used " "to invoke custom test runners in `+%check+`. See <> for " @@ -2893,12 +2901,12 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1609 +#: pages/Python.adoc:1612 msgid "`+%py3_check_import+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1613 +#: pages/Python.adoc:1616 msgid "" "Imports all provided modules. If running an upstream test suite is not " "feasible, use this macro in `+%check+` to test that public Python modules " @@ -2906,50 +2914,50 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1615 +#: pages/Python.adoc:1618 msgid "Takes these arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1620 +#: pages/Python.adoc:1623 msgid "" "`+-f+`: path to file containing qualified module names (separated by " "newlines). Optional, can be used multiple times." msgstr "" #. type: Plain text -#: pages/Python.adoc:1622 +#: pages/Python.adoc:1625 msgid "" "`+-e+`: glob to exclude the matching module names. Optional, can be used " "multiple times." msgstr "" #. type: Plain text -#: pages/Python.adoc:1623 +#: pages/Python.adoc:1626 msgid "`+-t+`: if set, import only top-level module names" msgstr "" #. type: Plain text -#: pages/Python.adoc:1625 +#: pages/Python.adoc:1628 msgid "" "Positional arguments (separated by spaces or commas) specify the module " "name(s) to check." msgstr "" #. type: Plain text -#: pages/Python.adoc:1630 +#: pages/Python.adoc:1633 msgid "" "The macro sets various environment variables such as `+PATH+` and " "`+PYTHONPATH+` to ensure the packaged versions of modules are imported." msgstr "" #. type: Plain text -#: pages/Python.adoc:1633 +#: pages/Python.adoc:1636 msgid "`+%pyproject_check_import+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1637 +#: pages/Python.adoc:1640 msgid "" "Imports all public modules found by <> whose names match any of the provided " @@ -2957,63 +2965,63 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1640 +#: pages/Python.adoc:1643 msgid "" "This macro needs to be used with `+%pyproject_save_files+` (use `+" "%py3_check_import+` in other cases)." msgstr "" #. type: Plain text -#: pages/Python.adoc:1643 +#: pages/Python.adoc:1646 msgid "" "The macro takes `+-e+`/`+-t+` as well as positional arguments for `+" "%py3_check_import+` above." msgstr "" #. type: Title === -#: pages/Python.adoc:1644 +#: pages/Python.adoc:1647 #, no-wrap msgid "Extras macros" msgstr "" #. type: Plain text -#: pages/Python.adoc:1648 +#: pages/Python.adoc:1651 msgid "`+%pyproject_extras_subpkg+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1651 +#: pages/Python.adoc:1654 msgid "" "Generates a simple subpackage for a Python extra. See <> for more " "information." msgstr "" #. type: Plain text -#: pages/Python.adoc:1654 +#: pages/Python.adoc:1657 msgid "" "This macro needs to be used with `+%pyproject_install+` (use `+" "%python_extras_subpkg+` in other cases)." msgstr "" #. type: Plain text -#: pages/Python.adoc:1656 +#: pages/Python.adoc:1659 msgid "Required arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1659 pages/Python.adoc:1705 +#: pages/Python.adoc:1662 pages/Python.adoc:1708 msgid "`+-n+`: name of the “base” package (e.g. `+python3-requests+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1661 +#: pages/Python.adoc:1664 msgid "" "Positional arguments (separated by spaces or commas): the extra name(s). " "Multiple metapackages are generated when multiple names are provided." msgstr "" #. type: Plain text -#: pages/Python.adoc:1666 +#: pages/Python.adoc:1669 msgid "" "The macro also takes `+-i+`/`+-f+`/`+-F+` arguments for `+" "%python_extras_subpkg+` below, but if they are not given, a filelist written " @@ -3021,7 +3029,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1674 +#: pages/Python.adoc:1677 msgid "" "This macro generates all the subpackage definition sections (`+%package+` " "including the `+Summary+` and `+Requires+` on the base package, `+" @@ -3032,7 +3040,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1681 +#: pages/Python.adoc:1684 msgid "" "The `+%files+` section is last. It can be continued to add files that only " "make sense with the extra and the base package does not fail without them. " @@ -3041,7 +3049,7 @@ msgid "" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1686 +#: pages/Python.adoc:1689 #, no-wrap msgid "" "%pyproject_extras_subpkg -n a-cool-tool cli\n" @@ -3049,7 +3057,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1695 +#: pages/Python.adoc:1698 msgid "" "Due to technical limitations, the macro never generates requirements on the " "arched `+BASE_PACKAGE%{?_isa} = %{?epoch:%{epoch}:}%{version}-%{release}+`. " @@ -3059,25 +3067,25 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1698 +#: pages/Python.adoc:1701 msgid "`+%python_extras_subpkg+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1702 +#: pages/Python.adoc:1705 msgid "" "Generates a simple subpackage for a Python extra. See <> for more " "information. Takes these arguments:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1706 +#: pages/Python.adoc:1709 msgid "" "`+-i+`: the `+%files %ghost+` path (glob) to the `+.dist-info+` directory" msgstr "" #. type: Plain text -#: pages/Python.adoc:1709 +#: pages/Python.adoc:1712 msgid "" "Positional arguments (separated by spaces or commas) specify the extra " "name(s) — multiple metapackages are generated when multiple names are " @@ -3085,7 +3093,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1713 +#: pages/Python.adoc:1716 msgid "" "`+-f+`: Relative path to the filelist for this metapackage (which should " "contain the `+%files %ghost+` path (glob) to the the metadata directory). " @@ -3093,19 +3101,19 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1716 +#: pages/Python.adoc:1719 msgid "" "`+-F+`: Skip the %files section entirely (if the packager wants to construct " "it manually). Conflicts with `+-i+` and `+-f+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1719 +#: pages/Python.adoc:1722 msgid "As with `+%pyproject_extras_subpkg+`:" msgstr "" #. type: Plain text -#: pages/Python.adoc:1724 +#: pages/Python.adoc:1727 msgid "" "This macro generates all the subpackage definition sections, with only `+" "%files+` being customizable. For more complicated uses, construct the " @@ -3113,20 +3121,20 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1726 +#: pages/Python.adoc:1729 msgid "" "It never generates requirements on the arched `+BASE_PACKAGE%{?_isa} = %{?" "epoch:%{epoch}:}%{version}-%{release}+`." msgstr "" #. type: Title === -#: pages/Python.adoc:1727 +#: pages/Python.adoc:1730 #, no-wrap msgid "Manual generation" msgstr "" #. type: Plain text -#: pages/Python.adoc:1733 +#: pages/Python.adoc:1736 msgid "" "The following macros are available for cases where automatic generation is " "turned off. They can also be useful for handling files in non-standard " @@ -3134,41 +3142,41 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1736 +#: pages/Python.adoc:1739 msgid "`+%pycached MODNAME.py+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1739 +#: pages/Python.adoc:1742 msgid "" "Given a Python file, lists the file and the files with its bytecode cache. " "See _Source files and bytecode cache_ for more information." msgstr "" #. type: Plain text -#: pages/Python.adoc:1742 +#: pages/Python.adoc:1745 msgid "`+%py_provides python3-MODNAME+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1746 +#: pages/Python.adoc:1749 msgid "" "Generates `+Provides+` for `+python3-MODNAME+`, `+python3.X-MODNAME+` and " "`+python-MODNAME+`. See <> for more details." msgstr "" #. type: Plain text -#: pages/Python.adoc:1749 +#: pages/Python.adoc:1752 msgid "`+%py_byte_compile INTERPRETER PATH+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1751 +#: pages/Python.adoc:1754 msgid "Byte-compile a Python file into a `+__pycache__/*.pyc+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1756 +#: pages/Python.adoc:1759 msgid "" "If the `+PATH+` argument is a directory, the macro will recursively byte " "compile all `+*.py+` files in the directory. (So, if you need to compile " @@ -3176,7 +3184,7 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1763 +#: pages/Python.adoc:1766 msgid "" "The `+INTERPRETER+` determines the compiled file name’s suffix and the magic " "number embedded in the file. These muct match the interpreter that will " @@ -3186,17 +3194,17 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1765 +#: pages/Python.adoc:1768 msgid "[#py_dist_name]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1766 +#: pages/Python.adoc:1769 msgid "`+%{py_dist_name PROJECTNAME}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1770 +#: pages/Python.adoc:1773 msgid "" "Given a _project name_ (e.g. `+PyYAML+`) it will convert it to the canonical " "format (e.g. `+pyyaml+`). See <> for more " @@ -3204,17 +3212,17 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1772 +#: pages/Python.adoc:1775 msgid "[#py3_dist]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1773 +#: pages/Python.adoc:1776 msgid "`+%{py3_dist PROJECTNAME …}+`" msgstr "" #. type: Plain text -#: pages/Python.adoc:1779 +#: pages/Python.adoc:1782 msgid "" "Given one or more _project names_, it will convert them to the canonical " "format and evaluate to `+python3dist(DISTNAME)+`, which is useful when " @@ -3223,28 +3231,28 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1780 +#: pages/Python.adoc:1783 #, no-wrap msgid "System Settings" msgstr "" #. type: Plain text -#: pages/Python.adoc:1783 +#: pages/Python.adoc:1786 msgid "The following macros can be redefined for special use cases." msgstr "" #. type: Plain text -#: pages/Python.adoc:1785 +#: pages/Python.adoc:1788 msgid "[#__python]" msgstr "" #. type: Plain text -#: pages/Python.adoc:1786 +#: pages/Python.adoc:1789 msgid "`+%{__python}+` (errors by default if not redefined)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1790 +#: pages/Python.adoc:1793 msgid "" "Defining this macro sets the meaning of all “unversioned” Python macros such " "as `+%{python}+` or `+%{python_sitelib}+`. Don’t use these macros without " @@ -3252,24 +3260,24 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1793 +#: pages/Python.adoc:1796 msgid "`+%{__python3}+` (`+/usr/bin/python3+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1797 +#: pages/Python.adoc:1800 msgid "" "The python 3 interpreter. Redefining this macro changes all the `+" "%{python3...}+` macros, e.g. `+%{python3}+` or `+%{python3_sitelib}+`." msgstr "" #. type: Plain text -#: pages/Python.adoc:1800 +#: pages/Python.adoc:1803 msgid "`+%{python3_pkgversion}+` (`+3+`)" msgstr "" #. type: Plain text -#: pages/Python.adoc:1807 +#: pages/Python.adoc:1810 msgid "" "Distro-wide Python version, i.e. the `+3+` in `+python3+`. Projects that " "build on top of Fedora might define it to e.g. `+3.9+` to try allowing " @@ -3279,13 +3287,13 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1808 +#: pages/Python.adoc:1811 #, no-wrap msgid "Comparing Python versions" msgstr "" #. type: Plain text -#: pages/Python.adoc:1816 +#: pages/Python.adoc:1819 msgid "" "When comparing Python versions (e.g. to ask: is `+%{python3_version}+` " "greater than 3.8?), using naïve `+%if %{python3_version} > 3.8+` or `+%if " @@ -3295,14 +3303,14 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1819 +#: pages/Python.adoc:1822 msgid "" "It is possible to explicitly compare version literals by using the `+v+` " "prefix, similar to the Python string prefixes:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1825 +#: pages/Python.adoc:1828 #, no-wrap msgid "" "%if v\"0%{?python3_version}\" > v\"3.8\"\n" @@ -3311,14 +3319,14 @@ msgid "" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1831 +#: pages/Python.adoc:1834 msgid "" "As a workaround for compatibility with RPM releases before 4.16 (Fedora 33), " "`+%{python3_version_nodots}+` can be compared as an integers:" msgstr "" #. type: delimited block - -#: pages/Python.adoc:1837 +#: pages/Python.adoc:1840 #, no-wrap msgid "" "%if %{python3_version_nodots} > 38\n" @@ -3327,47 +3335,47 @@ msgid "" msgstr "" #. type: Plain text -#: pages/Python.adoc:1841 +#: pages/Python.adoc:1844 msgid "" "This will work with Python 3.10 (310 > 39), but eventually break with Python " "4.0 (40 < 310)." msgstr "" #. type: Title === -#: pages/Python.adoc:1843 +#: pages/Python.adoc:1846 #, no-wrap msgid "Disabling automation" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1846 +#: pages/Python.adoc:1849 msgid "The following macros can turn off Python-specific automation." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1848 +#: pages/Python.adoc:1851 msgid "Consider contacting the Python SIG if you need to do this." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1851 +#: pages/Python.adoc:1854 msgid "`+%{?python_disable_dependency_generator}+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1854 +#: pages/Python.adoc:1857 msgid "" "Disables the automatic dependency generator. See <> for details." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1857 +#: pages/Python.adoc:1860 msgid "`+%undefine __pythonname_provides+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1861 +#: pages/Python.adoc:1864 msgid "" "Disables automatic generation of unversioned/versioned provides for package " "names, e.g. `+python-FOO+` and `+python3.9-FOO+` for `+python3-foo+`. See " @@ -3375,34 +3383,34 @@ msgid "" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1864 +#: pages/Python.adoc:1867 msgid "`+%undefine __pythondist_provides+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1868 +#: pages/Python.adoc:1871 msgid "" "Disables automatic generation of machine-readable Provides, e." "g. `+python3dist(foo)+`. See <> for more details." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1871 +#: pages/Python.adoc:1874 msgid "`+%global _python_no_extras_requires 1+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1873 +#: pages/Python.adoc:1876 msgid "If defined, <> will not be generated." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1876 +#: pages/Python.adoc:1879 msgid "`+%global _python_dist_allow_version_zero 1+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1880 +#: pages/Python.adoc:1883 msgid "" "From Fedora Linux 38 on, it is no longer possible to build a Python package " "with version 0 to prevent <<_version_warning,an accidental loss of the " @@ -3411,64 +3419,64 @@ msgid "" msgstr "" #. type: Title === -#: pages/Python.adoc:1881 +#: pages/Python.adoc:1884 #, no-wrap msgid "Deprecated Macros" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1886 +#: pages/Python.adoc:1889 msgid "" "The following macros are deprecated. See the xref:Python_201x.adoc[201x-era " "Python Packaging guidelines] for how some of them were used." msgstr "" #. type: delimited block = -#: pages/Python.adoc:1888 +#: pages/Python.adoc:1891 msgid "[[py3_build]] `+%py3_build+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1889 +#: pages/Python.adoc:1892 msgid "[[py3_build_wheel]] `+%py3_build_wheel+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1890 +#: pages/Python.adoc:1893 msgid "[[py3_build_egg]] `+%py3_build_egg+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1891 +#: pages/Python.adoc:1894 msgid "[[py3_install]] `+%py3_install+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1892 +#: pages/Python.adoc:1895 msgid "[[py3_install_wheel]] `+%py3_install_wheel+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1893 +#: pages/Python.adoc:1896 msgid "[[py3_install_egg]] `+%py3_install_egg+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1894 +#: pages/Python.adoc:1897 msgid "[[py3dir]] `+%py3dir+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1895 +#: pages/Python.adoc:1898 msgid "[[py3_other_build]] `+%py3_other_build+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1896 +#: pages/Python.adoc:1899 msgid "[[py3_other_install]] `+%py3_other_install+`" msgstr "" #. type: delimited block = -#: pages/Python.adoc:1896 +#: pages/Python.adoc:1899 msgid "[[python_provide]] `+%python_provide+`" msgstr ""