diff --git a/3.11/locale/pot/LC_MESSAGES/library/pyexpat.pot b/3.11/locale/pot/LC_MESSAGES/library/pyexpat.pot index a515b93ef29..4f85eb8657c 100644 --- a/3.11/locale/pot/LC_MESSAGES/library/pyexpat.pot +++ b/3.11/locale/pot/LC_MESSAGES/library/pyexpat.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-03-04 08:38+0000\n" +"POT-Creation-Date: 2026-09-02 12:28+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -259,57 +259,71 @@ msgstr "" #: ../../../library/pyexpat.rst:242 msgid "" -":class:`!xmlparser` objects have the following methods to mitigate some " -"common XML vulnerabilities." +":class:`!xmlparser` objects have the following methods to tune protections " +"against some common XML vulnerabilities." msgstr "" #: ../../../library/pyexpat.rst:247 msgid "" -"Sets the number of allocated bytes of dynamic memory needed to activate " -"protection against disproportionate use of RAM." +"Sets the number of output bytes needed to activate protection against " +"`billion laughs`_ attacks." msgstr "" #: ../../../library/pyexpat.rst:250 msgid "" -"By default, parser objects have an allocation activation threshold of 64 " -"MiB, or equivalently 67,108,864 bytes." +"The number of output bytes includes amplification from entity expansion and " +"reading DTD files." msgstr "" #: ../../../library/pyexpat.rst:253 msgid "" +"Parser objects usually have a protection activation threshold of 8 MiB, but " +"the actual default value depends on the underlying Expat library." +msgstr "" + +#: ../../../library/pyexpat.rst:256 ../../../library/pyexpat.rst:308 +msgid "" "An :exc:`ExpatError` is raised if this method is called on a |xml-non-root-" "parser| parser. The corresponding :attr:`~ExpatError.lineno` and :attr:" "`~ExpatError.offset` should not be used as they may have no special meaning." msgstr "" -#: ../../../library/pyexpat.rst:262 +#: ../../../library/pyexpat.rst:263 msgid "" -"Sets the maximum amplification factor between direct input and bytes of " -"dynamic memory allocated." +"Activation thresholds below 4 MiB are known to break support for DITA 1.3 " +"payload and are hence not recommended." msgstr "" -#: ../../../library/pyexpat.rst:265 +#: ../../../library/pyexpat.rst:270 msgid "" -"The amplification factor is calculated as ``allocated / direct`` while " -"parsing, where ``direct`` is the number of bytes read from the primary " -"document in parsing and ``allocated`` is the number of bytes of dynamic " -"memory allocated in the parser hierarchy." +"Sets the maximum tolerated amplification factor for protection against " +"`billion laughs`_ attacks." msgstr "" -#: ../../../library/pyexpat.rst:270 +#: ../../../library/pyexpat.rst:273 +msgid "" +"The amplification factor is calculated as ``(direct + indirect) / direct`` " +"while parsing, where ``direct`` is the number of bytes read from the primary " +"document in parsing and ``indirect`` is the number of bytes added by " +"expanding entities and reading of external DTD files." +msgstr "" + +#: ../../../library/pyexpat.rst:278 msgid "" "The *max_factor* value must be a non-NaN :class:`float` value greater than " -"or equal to 1.0. Amplification factors greater than 100.0 can be observed " -"near the start of parsing even with benign files in practice. In particular, " -"the activation threshold should be carefully chosen to avoid false positives." +"or equal to 1.0. Peak amplifications of factor 15,000 for the entire payload " +"and of factor 30,000 in the middle of parsing have been observed with small " +"benign files in practice. In particular, the activation threshold should be " +"carefully chosen to avoid false positives." msgstr "" -#: ../../../library/pyexpat.rst:275 +#: ../../../library/pyexpat.rst:284 ../../../library/pyexpat.rst:330 msgid "" -"By default, parser objects have a maximum amplification factor of 100.0." +"Parser objects usually have a maximum amplification factor of 100, but the " +"actual default value depends on the underlying Expat library." msgstr "" -#: ../../../library/pyexpat.rst:277 +#: ../../../library/pyexpat.rst:287 ../../../library/pyexpat.rst:333 msgid "" "An :exc:`ExpatError` is raised if this method is called on a |xml-non-root-" "parser| parser or if *max_factor* is outside the valid range. The " @@ -317,24 +331,65 @@ msgid "" "should not be used as they may have no special meaning." msgstr "" -#: ../../../library/pyexpat.rst:284 +#: ../../../library/pyexpat.rst:294 +msgid "" +"The maximum amplification factor is only considered if the threshold that " +"can be adjusted by :meth:`." +"SetBillionLaughsAttackProtectionActivationThreshold` is exceeded." +msgstr "" + +#: ../../../library/pyexpat.rst:302 +msgid "" +"Sets the number of allocated bytes of dynamic memory needed to activate " +"protection against disproportionate use of RAM." +msgstr "" + +#: ../../../library/pyexpat.rst:305 +msgid "" +"Parser objects usually have an allocation activation threshold of 64 MiB, " +"but the actual default value depends on the underlying Expat library." +msgstr "" + +#: ../../../library/pyexpat.rst:317 +msgid "" +"Sets the maximum amplification factor between direct input and bytes of " +"dynamic memory allocated." +msgstr "" + +#: ../../../library/pyexpat.rst:320 +msgid "" +"The amplification factor is calculated as ``allocated / direct`` while " +"parsing, where ``direct`` is the number of bytes read from the primary " +"document in parsing and ``allocated`` is the number of bytes of dynamic " +"memory allocated in the parser hierarchy." +msgstr "" + +#: ../../../library/pyexpat.rst:325 +msgid "" +"The *max_factor* value must be a non-NaN :class:`float` value greater than " +"or equal to 1.0. Amplification factors greater than 100.0 can be observed " +"near the start of parsing even with benign files in practice. In particular, " +"the activation threshold should be carefully chosen to avoid false positives." +msgstr "" + +#: ../../../library/pyexpat.rst:340 msgid "" "The maximum amplification factor is only considered if the threshold that " "can be adjusted by :meth:`.SetAllocTrackerActivationThreshold` is exceeded." msgstr "" -#: ../../../library/pyexpat.rst:291 +#: ../../../library/pyexpat.rst:347 msgid ":class:`xmlparser` objects have the following attributes:" msgstr "" -#: ../../../library/pyexpat.rst:296 +#: ../../../library/pyexpat.rst:352 msgid "" "The size of the buffer used when :attr:`buffer_text` is true. A new buffer " "size can be set by assigning a new integer value to this attribute. When the " "size is changed, the buffer will be flushed." msgstr "" -#: ../../../library/pyexpat.rst:304 +#: ../../../library/pyexpat.rst:360 msgid "" "Setting this to true causes the :class:`xmlparser` object to buffer textual " "content returned by Expat to avoid multiple calls to the :meth:" @@ -345,14 +400,14 @@ msgid "" "newlines may be chunked too." msgstr "" -#: ../../../library/pyexpat.rst:315 +#: ../../../library/pyexpat.rst:371 msgid "" "If :attr:`buffer_text` is enabled, the number of bytes stored in the buffer. " "These bytes represent UTF-8 encoded text. This attribute has no meaningful " "interpretation when :attr:`buffer_text` is false." msgstr "" -#: ../../../library/pyexpat.rst:322 +#: ../../../library/pyexpat.rst:378 msgid "" "Setting this attribute to a non-zero integer causes the attributes to be " "reported as a list rather than a dictionary. The attributes are presented " @@ -362,7 +417,7 @@ msgid "" "is false; it may be changed at any time." msgstr "" -#: ../../../library/pyexpat.rst:332 +#: ../../../library/pyexpat.rst:388 msgid "" "If set to a non-zero integer, the parser will report only those attributes " "which were specified in the document instance and not those which were " @@ -373,7 +428,7 @@ msgid "" "time." msgstr "" -#: ../../../library/pyexpat.rst:340 +#: ../../../library/pyexpat.rst:396 msgid "" "The following attributes contain values relating to the most recent error " "encountered by an :class:`xmlparser` object, and will only have correct " @@ -381,26 +436,26 @@ msgid "" "`xml.parsers.expat.ExpatError` exception." msgstr "" -#: ../../../library/pyexpat.rst:348 +#: ../../../library/pyexpat.rst:404 msgid "Byte index at which an error occurred." msgstr "" -#: ../../../library/pyexpat.rst:353 +#: ../../../library/pyexpat.rst:409 msgid "" "Numeric code specifying the problem. This value can be passed to the :func:" "`ErrorString` function, or compared to one of the constants defined in the " "``errors`` object." msgstr "" -#: ../../../library/pyexpat.rst:360 +#: ../../../library/pyexpat.rst:416 msgid "Column number at which an error occurred." msgstr "" -#: ../../../library/pyexpat.rst:365 +#: ../../../library/pyexpat.rst:421 msgid "Line number at which an error occurred." msgstr "" -#: ../../../library/pyexpat.rst:367 +#: ../../../library/pyexpat.rst:423 msgid "" "The following attributes contain values relating to the current parse " "location in an :class:`xmlparser` object. During a callback reporting a " @@ -410,19 +465,19 @@ msgid "" "whether there was an associated callback)." msgstr "" -#: ../../../library/pyexpat.rst:377 +#: ../../../library/pyexpat.rst:433 msgid "Current byte index in the parser input." msgstr "" -#: ../../../library/pyexpat.rst:382 +#: ../../../library/pyexpat.rst:438 msgid "Current column number in the parser input." msgstr "" -#: ../../../library/pyexpat.rst:387 +#: ../../../library/pyexpat.rst:443 msgid "Current line number in the parser input." msgstr "" -#: ../../../library/pyexpat.rst:389 +#: ../../../library/pyexpat.rst:445 msgid "" "Here is the list of handlers that can be set. To set a handler on an :class:" "`xmlparser` object *o*, use ``o.handlername = func``. *handlername* must be " @@ -431,7 +486,7 @@ msgid "" "unless otherwise stated." msgstr "" -#: ../../../library/pyexpat.rst:398 +#: ../../../library/pyexpat.rst:454 msgid "" "Called when the XML declaration is parsed. The XML declaration is the " "(optional) declaration of the applicable version of the XML recommendation, " @@ -442,7 +497,7 @@ msgid "" "only available with Expat version 1.95.0 or newer." msgstr "" -#: ../../../library/pyexpat.rst:409 +#: ../../../library/pyexpat.rst:465 msgid "" "Called when Expat begins parsing the document type declaration (``'``." msgstr "" -#: ../../../library/pyexpat.rst:526 +#: ../../../library/pyexpat.rst:582 msgid "" "Called at the start of a CDATA section. This and :attr:" "`EndCdataSectionHandler` are needed to be able to identify the syntactical " "start and end for CDATA sections." msgstr "" -#: ../../../library/pyexpat.rst:533 +#: ../../../library/pyexpat.rst:589 msgid "Called at the end of a CDATA section." msgstr "" -#: ../../../library/pyexpat.rst:538 +#: ../../../library/pyexpat.rst:594 msgid "" "Called for any characters in the XML document for which no applicable " "handler has been specified. This means characters that are part of a " @@ -576,14 +631,14 @@ msgid "" "supplied." msgstr "" -#: ../../../library/pyexpat.rst:545 +#: ../../../library/pyexpat.rst:601 msgid "" "This is the same as the :func:`DefaultHandler`, but doesn't inhibit " "expansion of internal entities. The entity reference will not be passed to " "the default handler." msgstr "" -#: ../../../library/pyexpat.rst:552 +#: ../../../library/pyexpat.rst:608 msgid "" "Called if the XML document hasn't been declared as being a standalone " "document. This happens when there is an external subset or a reference to a " @@ -593,7 +648,7 @@ msgid "" "set, no exception is raised by the parser for this condition." msgstr "" -#: ../../../library/pyexpat.rst:562 +#: ../../../library/pyexpat.rst:618 msgid "" "Called for references to external entities. *base* is the current base, as " "set by a previous call to :meth:`SetBase`. The public and system " @@ -602,7 +657,7 @@ msgid "" "is opaque and should only be used as described below." msgstr "" -#: ../../../library/pyexpat.rst:568 +#: ../../../library/pyexpat.rst:624 msgid "" "For external entities to be parsed, this handler must be implemented. It is " "responsible for creating the sub-parser using " @@ -612,130 +667,130 @@ msgid "" "`XML_ERROR_EXTERNAL_ENTITY_HANDLING` error, otherwise parsing will continue." msgstr "" -#: ../../../library/pyexpat.rst:576 +#: ../../../library/pyexpat.rst:632 msgid "" "If this handler is not provided, external entities are reported by the :attr:" "`DefaultHandler` callback, if provided." msgstr "" -#: ../../../library/pyexpat.rst:583 +#: ../../../library/pyexpat.rst:639 msgid "ExpatError Exceptions" msgstr "" -#: ../../../library/pyexpat.rst:588 +#: ../../../library/pyexpat.rst:644 msgid ":exc:`ExpatError` exceptions have a number of interesting attributes:" msgstr "" -#: ../../../library/pyexpat.rst:593 +#: ../../../library/pyexpat.rst:649 msgid "" "Expat's internal error number for the specific error. The :data:`errors." "messages ` dictionary maps these error " "numbers to Expat's error messages. For example::" msgstr "" -#: ../../../library/pyexpat.rst:605 +#: ../../../library/pyexpat.rst:661 msgid "" "The :mod:`~xml.parsers.expat.errors` module also provides error message " "constants and a dictionary :data:`~xml.parsers.expat.errors.codes` mapping " "these messages back to the error codes, see below." msgstr "" -#: ../../../library/pyexpat.rst:612 +#: ../../../library/pyexpat.rst:668 msgid "" "Line number on which the error was detected. The first line is numbered " "``1``." msgstr "" -#: ../../../library/pyexpat.rst:617 +#: ../../../library/pyexpat.rst:673 msgid "" "Character offset into the line where the error occurred. The first column " "is numbered ``0``." msgstr "" -#: ../../../library/pyexpat.rst:624 +#: ../../../library/pyexpat.rst:680 msgid "Example" msgstr "" -#: ../../../library/pyexpat.rst:626 +#: ../../../library/pyexpat.rst:682 msgid "" "The following program defines three handlers that just print out their " "arguments. ::" msgstr "" -#: ../../../library/pyexpat.rst:650 +#: ../../../library/pyexpat.rst:706 msgid "The output from this program is::" msgstr "" -#: ../../../library/pyexpat.rst:667 +#: ../../../library/pyexpat.rst:723 msgid "Content Model Descriptions" msgstr "" -#: ../../../library/pyexpat.rst:673 +#: ../../../library/pyexpat.rst:729 msgid "" "Content models are described using nested tuples. Each tuple contains four " "values: the type, the quantifier, the name, and a tuple of children. " "Children are simply additional content model descriptions." msgstr "" -#: ../../../library/pyexpat.rst:677 +#: ../../../library/pyexpat.rst:733 msgid "" "The values of the first two fields are constants defined in the :mod:`xml." "parsers.expat.model` module. These constants can be collected in two " "groups: the model type group and the quantifier group." msgstr "" -#: ../../../library/pyexpat.rst:681 +#: ../../../library/pyexpat.rst:737 msgid "The constants in the model type group are:" msgstr "" -#: ../../../library/pyexpat.rst:687 +#: ../../../library/pyexpat.rst:743 msgid "" "The element named by the model name was declared to have a content model of " "``ANY``." msgstr "" -#: ../../../library/pyexpat.rst:694 +#: ../../../library/pyexpat.rst:750 msgid "" "The named element allows a choice from a number of options; this is used for " "content models such as ``(A | B | C)``." msgstr "" -#: ../../../library/pyexpat.rst:701 +#: ../../../library/pyexpat.rst:757 msgid "Elements which are declared to be ``EMPTY`` have this model type." msgstr "" -#: ../../../library/pyexpat.rst:715 +#: ../../../library/pyexpat.rst:771 msgid "" "Models which represent a series of models which follow one after the other " "are indicated with this model type. This is used for models such as ``(A, " "B, C)``." msgstr "" -#: ../../../library/pyexpat.rst:718 +#: ../../../library/pyexpat.rst:774 msgid "The constants in the quantifier group are:" msgstr "" -#: ../../../library/pyexpat.rst:724 +#: ../../../library/pyexpat.rst:780 msgid "No modifier is given, so it can appear exactly once, as for ``A``." msgstr "" -#: ../../../library/pyexpat.rst:730 +#: ../../../library/pyexpat.rst:786 msgid "The model is optional: it can appear once or not at all, as for ``A?``." msgstr "" -#: ../../../library/pyexpat.rst:736 +#: ../../../library/pyexpat.rst:792 msgid "The model must occur one or more times (like ``A+``)." msgstr "" -#: ../../../library/pyexpat.rst:742 +#: ../../../library/pyexpat.rst:798 msgid "The model must occur zero or more times, as for ``A*``." msgstr "" -#: ../../../library/pyexpat.rst:748 +#: ../../../library/pyexpat.rst:804 msgid "Expat error constants" msgstr "" -#: ../../../library/pyexpat.rst:752 +#: ../../../library/pyexpat.rst:808 msgid "" "The following constants are provided in the :mod:`xml.parsers.expat.errors` " "module. These constants are useful in interpreting some of the attributes " @@ -746,206 +801,206 @@ msgid "" "XML_ERROR_{CONSTANT_NAME}]`." msgstr "" -#: ../../../library/pyexpat.rst:760 +#: ../../../library/pyexpat.rst:816 msgid "The ``errors`` module has the following attributes:" msgstr "" -#: ../../../library/pyexpat.rst:764 +#: ../../../library/pyexpat.rst:820 msgid "A dictionary mapping string descriptions to their error codes." msgstr "" -#: ../../../library/pyexpat.rst:771 +#: ../../../library/pyexpat.rst:827 msgid "A dictionary mapping numeric error codes to their string descriptions." msgstr "" -#: ../../../library/pyexpat.rst:781 +#: ../../../library/pyexpat.rst:837 msgid "" "An entity reference in an attribute value referred to an external entity " "instead of an internal entity." msgstr "" -#: ../../../library/pyexpat.rst:787 +#: ../../../library/pyexpat.rst:843 msgid "" "A character reference referred to a character which is illegal in XML (for " "example, character ``0``, or '``�``')." msgstr "" -#: ../../../library/pyexpat.rst:793 +#: ../../../library/pyexpat.rst:849 msgid "" "An entity reference referred to an entity which was declared with a " "notation, so cannot be parsed." msgstr "" -#: ../../../library/pyexpat.rst:799 +#: ../../../library/pyexpat.rst:855 msgid "An attribute was used more than once in a start tag." msgstr "" -#: ../../../library/pyexpat.rst:807 +#: ../../../library/pyexpat.rst:863 msgid "" "Raised when an input byte could not properly be assigned to a character; for " "example, a NUL byte (value ``0``) in a UTF-8 input stream." msgstr "" -#: ../../../library/pyexpat.rst:813 +#: ../../../library/pyexpat.rst:869 msgid "Something other than whitespace occurred after the document element." msgstr "" -#: ../../../library/pyexpat.rst:818 +#: ../../../library/pyexpat.rst:874 msgid "" "An XML declaration was found somewhere other than the start of the input " "data." msgstr "" -#: ../../../library/pyexpat.rst:823 +#: ../../../library/pyexpat.rst:879 msgid "" "The document contains no elements (XML requires all documents to contain " "exactly one top-level element).." msgstr "" -#: ../../../library/pyexpat.rst:829 +#: ../../../library/pyexpat.rst:885 msgid "Expat was not able to allocate memory internally." msgstr "" -#: ../../../library/pyexpat.rst:834 +#: ../../../library/pyexpat.rst:890 msgid "A parameter entity reference was found where it was not allowed." msgstr "" -#: ../../../library/pyexpat.rst:839 +#: ../../../library/pyexpat.rst:895 msgid "An incomplete character was found in the input." msgstr "" -#: ../../../library/pyexpat.rst:844 +#: ../../../library/pyexpat.rst:900 msgid "" "An entity reference contained another reference to the same entity; possibly " "via a different name, and possibly indirectly." msgstr "" -#: ../../../library/pyexpat.rst:850 +#: ../../../library/pyexpat.rst:906 msgid "Some unspecified syntax error was encountered." msgstr "" -#: ../../../library/pyexpat.rst:855 +#: ../../../library/pyexpat.rst:911 msgid "An end tag did not match the innermost open start tag." msgstr "" -#: ../../../library/pyexpat.rst:860 +#: ../../../library/pyexpat.rst:916 msgid "" "Some token (such as a start tag) was not closed before the end of the stream " "or the next token was encountered." msgstr "" -#: ../../../library/pyexpat.rst:866 +#: ../../../library/pyexpat.rst:922 msgid "A reference was made to an entity which was not defined." msgstr "" -#: ../../../library/pyexpat.rst:871 +#: ../../../library/pyexpat.rst:927 msgid "The document encoding is not supported by Expat." msgstr "" -#: ../../../library/pyexpat.rst:876 +#: ../../../library/pyexpat.rst:932 msgid "A CDATA marked section was not closed." msgstr "" -#: ../../../library/pyexpat.rst:884 +#: ../../../library/pyexpat.rst:940 msgid "" "The parser determined that the document was not \"standalone\" though it " "declared itself to be in the XML declaration, and the :attr:" "`NotStandaloneHandler` was set and returned ``0``." msgstr "" -#: ../../../library/pyexpat.rst:897 +#: ../../../library/pyexpat.rst:953 msgid "" "An operation was requested that requires DTD support to be compiled in, but " "Expat was configured without DTD support. This should never be reported by " "a standard build of the :mod:`xml.parsers.expat` module." msgstr "" -#: ../../../library/pyexpat.rst:904 +#: ../../../library/pyexpat.rst:960 msgid "" "A behavioral change was requested after parsing started that can only be " "changed before parsing has started. This is (currently) only raised by :" "meth:`UseForeignDTD`." msgstr "" -#: ../../../library/pyexpat.rst:911 +#: ../../../library/pyexpat.rst:967 msgid "An undeclared prefix was found when namespace processing was enabled." msgstr "" -#: ../../../library/pyexpat.rst:916 +#: ../../../library/pyexpat.rst:972 msgid "" "The document attempted to remove the namespace declaration associated with a " "prefix." msgstr "" -#: ../../../library/pyexpat.rst:922 +#: ../../../library/pyexpat.rst:978 msgid "A parameter entity contained incomplete markup." msgstr "" -#: ../../../library/pyexpat.rst:927 +#: ../../../library/pyexpat.rst:983 msgid "The document contained no document element at all." msgstr "" -#: ../../../library/pyexpat.rst:932 +#: ../../../library/pyexpat.rst:988 msgid "There was an error parsing a text declaration in an external entity." msgstr "" -#: ../../../library/pyexpat.rst:937 +#: ../../../library/pyexpat.rst:993 msgid "Characters were found in the public id that are not allowed." msgstr "" -#: ../../../library/pyexpat.rst:942 +#: ../../../library/pyexpat.rst:998 msgid "" "The requested operation was made on a suspended parser, but isn't allowed. " "This includes attempts to provide additional input or to stop the parser." msgstr "" -#: ../../../library/pyexpat.rst:948 +#: ../../../library/pyexpat.rst:1004 msgid "" "An attempt to resume the parser was made when the parser had not been " "suspended." msgstr "" -#: ../../../library/pyexpat.rst:953 ../../../library/pyexpat.rst:986 -#: ../../../library/pyexpat.rst:991 +#: ../../../library/pyexpat.rst:1009 ../../../library/pyexpat.rst:1042 +#: ../../../library/pyexpat.rst:1047 msgid "This should not be reported to Python applications." msgstr "" -#: ../../../library/pyexpat.rst:958 +#: ../../../library/pyexpat.rst:1014 msgid "" "The requested operation was made on a parser which was finished parsing " "input, but isn't allowed. This includes attempts to provide additional " "input or to stop the parser." msgstr "" -#: ../../../library/pyexpat.rst:968 +#: ../../../library/pyexpat.rst:1024 msgid "" "An attempt was made to undeclare reserved namespace prefix ``xml`` or to " "bind it to another namespace URI." msgstr "" -#: ../../../library/pyexpat.rst:975 +#: ../../../library/pyexpat.rst:1031 msgid "" "An attempt was made to declare or undeclare reserved namespace prefix " "``xmlns``." msgstr "" -#: ../../../library/pyexpat.rst:980 +#: ../../../library/pyexpat.rst:1036 msgid "" "An attempt was made to bind the URI of one the reserved namespace prefixes " "``xml`` and ``xmlns`` to another namespace prefix." msgstr "" -#: ../../../library/pyexpat.rst:996 +#: ../../../library/pyexpat.rst:1052 msgid "" "The limit on input amplification factor (from DTD and entities) has been " "breached." msgstr "" -#: ../../../library/pyexpat.rst:1001 +#: ../../../library/pyexpat.rst:1057 msgid "Footnotes" msgstr "" -#: ../../../library/pyexpat.rst:1002 +#: ../../../library/pyexpat.rst:1058 msgid "" "The encoding string included in XML output should conform to the appropriate " "standards. For example, \"UTF-8\" is valid, but \"UTF8\" is not. See https://" diff --git a/3.11/locale/pot/LC_MESSAGES/library/subprocess.pot b/3.11/locale/pot/LC_MESSAGES/library/subprocess.pot index cfe476f61d9..f46e5748bed 100644 --- a/3.11/locale/pot/LC_MESSAGES/library/subprocess.pot +++ b/3.11/locale/pot/LC_MESSAGES/library/subprocess.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-29 08:27+0000\n" +"POT-Creation-Date: 2026-09-02 12:28+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -152,8 +152,8 @@ msgid "" msgstr "" #: ../../../library/subprocess.rst:122 ../../../library/subprocess.rst:507 -#: ../../../library/subprocess.rst:1200 ../../../library/subprocess.rst:1240 -#: ../../../library/subprocess.rst:1303 +#: ../../../library/subprocess.rst:1206 ../../../library/subprocess.rst:1246 +#: ../../../library/subprocess.rst:1309 msgid "" "Changed Windows shell search order for ``shell=True``. The current directory " "and ``%PATH%`` are replaced with ``%COMSPEC%`` and ``%SystemRoot%" @@ -177,7 +177,7 @@ msgid "" "that it ran successfully." msgstr "" -#: ../../../library/subprocess.rst:141 ../../../library/subprocess.rst:947 +#: ../../../library/subprocess.rst:141 ../../../library/subprocess.rst:953 msgid "" "A negative value ``-N`` indicates that the child was terminated by signal " "``N`` (POSIX only)." @@ -355,8 +355,8 @@ msgid "" "binary streams. No encoding or line ending conversion is performed." msgstr "" -#: ../../../library/subprocess.rst:315 ../../../library/subprocess.rst:1555 -#: ../../../library/subprocess.rst:1573 +#: ../../../library/subprocess.rst:315 ../../../library/subprocess.rst:1561 +#: ../../../library/subprocess.rst:1579 msgid "Added the *encoding* and *errors* parameters." msgstr "" @@ -715,7 +715,7 @@ msgstr "" #: ../../../library/subprocess.rst:600 ../../../library/subprocess.rst:607 #: ../../../library/subprocess.rst:617 ../../../library/subprocess.rst:626 -#: ../../../library/subprocess.rst:635 ../../../library/subprocess.rst:641 +#: ../../../library/subprocess.rst:641 ../../../library/subprocess.rst:647 msgid ":ref:`Availability `: POSIX" msgstr "" @@ -761,13 +761,20 @@ msgid "" "passed verbatim. (POSIX only)" msgstr "" -#: ../../../library/subprocess.rst:638 +#: ../../../library/subprocess.rst:637 +msgid "" +"Specifying *user* will not drop existing supplementary group memberships! " +"The caller must also pass ``extra_groups=()`` to reduce the group membership " +"of the child process for security purposes." +msgstr "" + +#: ../../../library/subprocess.rst:644 msgid "" "If *umask* is not negative, the umask() system call will be made in the " "child process prior to the execution of the subprocess." msgstr "" -#: ../../../library/subprocess.rst:644 +#: ../../../library/subprocess.rst:650 msgid "" "If *env* is not ``None``, it must be a mapping that defines the environment " "variables for the new process; these are used instead of the default " @@ -776,14 +783,14 @@ msgid "" "data:`os.environ` or :data:`os.environb`." msgstr "" -#: ../../../library/subprocess.rst:652 +#: ../../../library/subprocess.rst:658 msgid "" "If specified, *env* must provide any variables required for the program to " "execute. On Windows, in order to run a `side-by-side assembly`_ the " "specified *env* **must** include a valid :envvar:`SystemRoot`." msgstr "" -#: ../../../library/subprocess.rst:658 +#: ../../../library/subprocess.rst:664 msgid "" "If *encoding* or *errors* are specified, or *text* is true, the file objects " "*stdin*, *stdout* and *stderr* are opened in text mode with the specified " @@ -793,73 +800,73 @@ msgid "" "in binary mode." msgstr "" -#: ../../../library/subprocess.rst:664 +#: ../../../library/subprocess.rst:670 msgid "*encoding* and *errors* were added." msgstr "" -#: ../../../library/subprocess.rst:667 ../../../library/subprocess.rst:1298 +#: ../../../library/subprocess.rst:673 ../../../library/subprocess.rst:1304 msgid "*text* was added as a more readable alias for *universal_newlines*." msgstr "" -#: ../../../library/subprocess.rst:670 +#: ../../../library/subprocess.rst:676 msgid "" "If given, *startupinfo* will be a :class:`STARTUPINFO` object, which is " "passed to the underlying ``CreateProcess`` function." msgstr "" -#: ../../../library/subprocess.rst:673 +#: ../../../library/subprocess.rst:679 msgid "If given, *creationflags*, can be one or more of the following flags:" msgstr "" -#: ../../../library/subprocess.rst:675 +#: ../../../library/subprocess.rst:681 msgid ":data:`CREATE_NEW_CONSOLE`" msgstr "" -#: ../../../library/subprocess.rst:676 +#: ../../../library/subprocess.rst:682 msgid ":data:`CREATE_NEW_PROCESS_GROUP`" msgstr "" -#: ../../../library/subprocess.rst:677 +#: ../../../library/subprocess.rst:683 msgid ":data:`ABOVE_NORMAL_PRIORITY_CLASS`" msgstr "" -#: ../../../library/subprocess.rst:678 +#: ../../../library/subprocess.rst:684 msgid ":data:`BELOW_NORMAL_PRIORITY_CLASS`" msgstr "" -#: ../../../library/subprocess.rst:679 +#: ../../../library/subprocess.rst:685 msgid ":data:`HIGH_PRIORITY_CLASS`" msgstr "" -#: ../../../library/subprocess.rst:680 +#: ../../../library/subprocess.rst:686 msgid ":data:`IDLE_PRIORITY_CLASS`" msgstr "" -#: ../../../library/subprocess.rst:681 +#: ../../../library/subprocess.rst:687 msgid ":data:`NORMAL_PRIORITY_CLASS`" msgstr "" -#: ../../../library/subprocess.rst:682 +#: ../../../library/subprocess.rst:688 msgid ":data:`REALTIME_PRIORITY_CLASS`" msgstr "" -#: ../../../library/subprocess.rst:683 +#: ../../../library/subprocess.rst:689 msgid ":data:`CREATE_NO_WINDOW`" msgstr "" -#: ../../../library/subprocess.rst:684 +#: ../../../library/subprocess.rst:690 msgid ":data:`DETACHED_PROCESS`" msgstr "" -#: ../../../library/subprocess.rst:685 +#: ../../../library/subprocess.rst:691 msgid ":data:`CREATE_DEFAULT_ERROR_MODE`" msgstr "" -#: ../../../library/subprocess.rst:686 +#: ../../../library/subprocess.rst:692 msgid ":data:`CREATE_BREAKAWAY_FROM_JOB`" msgstr "" -#: ../../../library/subprocess.rst:688 +#: ../../../library/subprocess.rst:694 msgid "" "*pipesize* can be used to change the size of the pipe when :data:`PIPE` is " "used for *stdin*, *stdout* or *stderr*. The size of the pipe is only changed " @@ -867,24 +874,24 @@ msgid "" "platforms will ignore this parameter." msgstr "" -#: ../../../library/subprocess.rst:693 +#: ../../../library/subprocess.rst:699 msgid "Added the *pipesize* parameter." msgstr "" -#: ../../../library/subprocess.rst:696 +#: ../../../library/subprocess.rst:702 msgid "" "Popen objects are supported as context managers via the :keyword:`with` " "statement: on exit, standard file descriptors are closed, and the process is " "waited for. ::" msgstr "" -#: ../../../library/subprocess.rst:714 +#: ../../../library/subprocess.rst:720 msgid "" "Raises an :ref:`auditing event ` ``subprocess.Popen`` with " "arguments ``executable``, ``args``, ``cwd``, ``env``." msgstr "" -#: ../../../library/subprocess.rst:705 +#: ../../../library/subprocess.rst:711 msgid "" "Popen and the other functions in this module that use it raise an :ref:" "`auditing event ` ``subprocess.Popen`` with arguments " @@ -892,17 +899,17 @@ msgid "" "be a single string or a list of strings, depending on platform." msgstr "" -#: ../../../library/subprocess.rst:710 +#: ../../../library/subprocess.rst:716 msgid "Added context manager support." msgstr "" -#: ../../../library/subprocess.rst:713 +#: ../../../library/subprocess.rst:719 msgid "" "Popen destructor now emits a :exc:`ResourceWarning` warning if the child " "process is still running." msgstr "" -#: ../../../library/subprocess.rst:717 +#: ../../../library/subprocess.rst:723 msgid "" "Popen can use :func:`os.posix_spawn` in some cases for better performance. " "On Windows Subsystem for Linux and QEMU User Emulation, Popen constructor " @@ -911,17 +918,17 @@ msgid "" "returncode`." msgstr "" -#: ../../../library/subprocess.rst:726 +#: ../../../library/subprocess.rst:732 msgid "Exceptions" msgstr "" -#: ../../../library/subprocess.rst:728 +#: ../../../library/subprocess.rst:734 msgid "" "Exceptions raised in the child process, before the new program has started " "to execute, will be re-raised in the parent." msgstr "" -#: ../../../library/subprocess.rst:731 +#: ../../../library/subprocess.rst:737 msgid "" "The most common exception raised is :exc:`OSError`. This occurs, for " "example, when trying to execute a non-existent file. Applications should " @@ -932,39 +939,39 @@ msgid "" "subprocess." msgstr "" -#: ../../../library/subprocess.rst:738 +#: ../../../library/subprocess.rst:744 msgid "" "A :exc:`ValueError` will be raised if :class:`Popen` is called with invalid " "arguments." msgstr "" -#: ../../../library/subprocess.rst:741 +#: ../../../library/subprocess.rst:747 msgid "" ":func:`check_call` and :func:`check_output` will raise :exc:" "`CalledProcessError` if the called process returns a non-zero return code." msgstr "" -#: ../../../library/subprocess.rst:745 +#: ../../../library/subprocess.rst:751 msgid "" "All of the functions and methods that accept a *timeout* parameter, such as :" "func:`run` and :meth:`Popen.communicate` will raise :exc:`TimeoutExpired` if " "the timeout expires before the process exits." msgstr "" -#: ../../../library/subprocess.rst:749 +#: ../../../library/subprocess.rst:755 msgid "" "Exceptions defined in this module all inherit from :exc:`SubprocessError`." msgstr "" -#: ../../../library/subprocess.rst:751 +#: ../../../library/subprocess.rst:757 msgid "The :exc:`SubprocessError` base class was added." msgstr "" -#: ../../../library/subprocess.rst:757 +#: ../../../library/subprocess.rst:763 msgid "Security Considerations" msgstr "" -#: ../../../library/subprocess.rst:759 +#: ../../../library/subprocess.rst:765 msgid "" "Unlike some other popen functions, this library will not implicitly choose " "to call a system shell. This means that all characters, including shell " @@ -977,7 +984,7 @@ msgid "" "escaping." msgstr "" -#: ../../../library/subprocess.rst:769 +#: ../../../library/subprocess.rst:775 msgid "" "On Windows, batch files (:file:`*.bat` or :file:`*.cmd`) may be launched by " "the operating system in a system shell regardless of the arguments passed to " @@ -988,34 +995,34 @@ msgid "" "`114539` for additional discussion." msgstr "" -#: ../../../library/subprocess.rst:779 +#: ../../../library/subprocess.rst:785 msgid "Popen Objects" msgstr "" -#: ../../../library/subprocess.rst:781 +#: ../../../library/subprocess.rst:787 msgid "Instances of the :class:`Popen` class have the following methods:" msgstr "" -#: ../../../library/subprocess.rst:786 +#: ../../../library/subprocess.rst:792 msgid "" "Check if child process has terminated. Set and return :attr:`~Popen." "returncode` attribute. Otherwise, returns ``None``." msgstr "" -#: ../../../library/subprocess.rst:792 +#: ../../../library/subprocess.rst:798 msgid "" "Wait for child process to terminate. Set and return :attr:`~Popen." "returncode` attribute." msgstr "" -#: ../../../library/subprocess.rst:795 +#: ../../../library/subprocess.rst:801 msgid "" "If the process does not terminate after *timeout* seconds, raise a :exc:" "`TimeoutExpired` exception. It is safe to catch this exception and retry " "the wait." msgstr "" -#: ../../../library/subprocess.rst:801 +#: ../../../library/subprocess.rst:807 msgid "" "This will deadlock when using ``stdout=PIPE`` or ``stderr=PIPE`` and the " "child process generates enough output to a pipe such that it blocks waiting " @@ -1023,7 +1030,7 @@ msgid "" "when using pipes to avoid that." msgstr "" -#: ../../../library/subprocess.rst:808 +#: ../../../library/subprocess.rst:814 msgid "" "When the ``timeout`` parameter is not ``None``, then (on POSIX) the function " "is implemented using a busy loop (non-blocking call and short sleeps). Use " @@ -1031,13 +1038,13 @@ msgid "" "create_subprocess_exec`." msgstr "" -#: ../../../library/subprocess.rst:813 ../../../library/subprocess.rst:854 -#: ../../../library/subprocess.rst:1195 ../../../library/subprocess.rst:1235 -#: ../../../library/subprocess.rst:1289 +#: ../../../library/subprocess.rst:819 ../../../library/subprocess.rst:860 +#: ../../../library/subprocess.rst:1201 ../../../library/subprocess.rst:1241 +#: ../../../library/subprocess.rst:1295 msgid "*timeout* was added." msgstr "" -#: ../../../library/subprocess.rst:818 +#: ../../../library/subprocess.rst:824 msgid "" "Interact with process: Send data to stdin. Read data from stdout and " "stderr, until end-of-file is reached. Wait for process to terminate and set " @@ -1047,13 +1054,13 @@ msgid "" "must be a string. Otherwise, it must be bytes." msgstr "" -#: ../../../library/subprocess.rst:825 +#: ../../../library/subprocess.rst:831 msgid "" ":meth:`communicate` returns a tuple ``(stdout_data, stderr_data)``. The data " "will be strings if streams were opened in text mode; otherwise, bytes." msgstr "" -#: ../../../library/subprocess.rst:829 +#: ../../../library/subprocess.rst:835 msgid "" "Note that if you want to send data to the process's stdin, you need to " "create the Popen object with ``stdin=PIPE``. Similarly, to get anything " @@ -1061,67 +1068,67 @@ msgid "" "and/or ``stderr=PIPE`` too." msgstr "" -#: ../../../library/subprocess.rst:834 +#: ../../../library/subprocess.rst:840 msgid "" "If the process does not terminate after *timeout* seconds, a :exc:" "`TimeoutExpired` exception will be raised. Catching this exception and " "retrying communication will not lose any output." msgstr "" -#: ../../../library/subprocess.rst:838 +#: ../../../library/subprocess.rst:844 msgid "" "The child process is not killed if the timeout expires, so in order to " "cleanup properly a well-behaved application should kill the child process " "and finish communication::" msgstr "" -#: ../../../library/subprocess.rst:851 +#: ../../../library/subprocess.rst:857 msgid "" "The data read is buffered in memory, so do not use this method if the data " "size is large or unlimited." msgstr "" -#: ../../../library/subprocess.rst:860 +#: ../../../library/subprocess.rst:866 msgid "Sends the signal *signal* to the child." msgstr "" -#: ../../../library/subprocess.rst:862 +#: ../../../library/subprocess.rst:868 msgid "Do nothing if the process completed." msgstr "" -#: ../../../library/subprocess.rst:866 +#: ../../../library/subprocess.rst:872 msgid "" "On Windows, SIGTERM is an alias for :meth:`terminate`. CTRL_C_EVENT and " "CTRL_BREAK_EVENT can be sent to processes started with a *creationflags* " "parameter which includes ``CREATE_NEW_PROCESS_GROUP``." msgstr "" -#: ../../../library/subprocess.rst:873 +#: ../../../library/subprocess.rst:879 msgid "" "Stop the child. On POSIX OSs the method sends :py:const:`~signal.SIGTERM` to " "the child. On Windows the Win32 API function :c:func:`!TerminateProcess` is " "called to stop the child." msgstr "" -#: ../../../library/subprocess.rst:880 +#: ../../../library/subprocess.rst:886 msgid "" "Kills the child. On POSIX OSs the function sends SIGKILL to the child. On " "Windows :meth:`kill` is an alias for :meth:`terminate`." msgstr "" -#: ../../../library/subprocess.rst:884 +#: ../../../library/subprocess.rst:890 msgid "" "The following attributes are also set by the class for you to access. " "Reassigning them to new values is unsupported:" msgstr "" -#: ../../../library/subprocess.rst:889 +#: ../../../library/subprocess.rst:895 msgid "" "The *args* argument as it was passed to :class:`Popen` -- a sequence of " "program arguments or else a single string." msgstr "" -#: ../../../library/subprocess.rst:896 +#: ../../../library/subprocess.rst:902 msgid "" "If the *stdin* argument was :data:`PIPE`, this attribute is a writeable " "stream object as returned by :func:`open`. If the *encoding* or *errors* " @@ -1130,7 +1137,7 @@ msgid "" "*stdin* argument was not :data:`PIPE`, this attribute is ``None``." msgstr "" -#: ../../../library/subprocess.rst:905 +#: ../../../library/subprocess.rst:911 msgid "" "If the *stdout* argument was :data:`PIPE`, this attribute is a readable " "stream object as returned by :func:`open`. Reading from the stream provides " @@ -1140,7 +1147,7 @@ msgid "" "argument was not :data:`PIPE`, this attribute is ``None``." msgstr "" -#: ../../../library/subprocess.rst:915 +#: ../../../library/subprocess.rst:921 msgid "" "If the *stderr* argument was :data:`PIPE`, this attribute is a readable " "stream object as returned by :func:`open`. Reading from the stream provides " @@ -1150,7 +1157,7 @@ msgid "" "argument was not :data:`PIPE`, this attribute is ``None``." msgstr "" -#: ../../../library/subprocess.rst:924 +#: ../../../library/subprocess.rst:930 msgid "" "Use :meth:`~Popen.communicate` rather than :attr:`.stdin.write `, :attr:`.stdout.read ` or :attr:`.stderr.read `__ structure is used for :class:`Popen` " @@ -1199,38 +1206,38 @@ msgid "" "only arguments." msgstr "" -#: ../../../library/subprocess.rst:965 +#: ../../../library/subprocess.rst:971 msgid "Keyword-only argument support was added." msgstr "" -#: ../../../library/subprocess.rst:970 +#: ../../../library/subprocess.rst:976 msgid "" "A bit field that determines whether certain :class:`STARTUPINFO` attributes " "are used when the process creates a window. ::" msgstr "" -#: ../../../library/subprocess.rst:978 +#: ../../../library/subprocess.rst:984 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute is " "the standard input handle for the process. If :data:`STARTF_USESTDHANDLES` " "is not specified, the default for standard input is the keyboard buffer." msgstr "" -#: ../../../library/subprocess.rst:985 +#: ../../../library/subprocess.rst:991 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute is " "the standard output handle for the process. Otherwise, this attribute is " "ignored and the default for standard output is the console window's buffer." msgstr "" -#: ../../../library/subprocess.rst:992 +#: ../../../library/subprocess.rst:998 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute is " "the standard error handle for the process. Otherwise, this attribute is " "ignored and the default for standard error is the console window's buffer." msgstr "" -#: ../../../library/subprocess.rst:998 +#: ../../../library/subprocess.rst:1004 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESHOWWINDOW`, this attribute " "can be any of the values that can be specified in the ``nCmdShow`` parameter " @@ -1239,34 +1246,34 @@ msgid "" "Otherwise, this attribute is ignored." msgstr "" -#: ../../../library/subprocess.rst:1005 +#: ../../../library/subprocess.rst:1011 msgid "" ":data:`SW_HIDE` is provided for this attribute. It is used when :class:" "`Popen` is called with ``shell=True``." msgstr "" -#: ../../../library/subprocess.rst:1010 +#: ../../../library/subprocess.rst:1016 msgid "" "A dictionary of additional attributes for process creation as given in " "``STARTUPINFOEX``, see `UpdateProcThreadAttribute `__." msgstr "" -#: ../../../library/subprocess.rst:1014 +#: ../../../library/subprocess.rst:1020 msgid "Supported attributes:" msgstr "" -#: ../../../library/subprocess.rst:1032 +#: ../../../library/subprocess.rst:1038 msgid "**handle_list**" msgstr "" -#: ../../../library/subprocess.rst:1017 +#: ../../../library/subprocess.rst:1023 msgid "" "Sequence of handles that will be inherited. *close_fds* must be true if non-" "empty." msgstr "" -#: ../../../library/subprocess.rst:1020 +#: ../../../library/subprocess.rst:1026 msgid "" "The handles must be temporarily made inheritable by :func:`os." "set_handle_inheritable` when passed to the :class:`Popen` constructor, else :" @@ -1274,7 +1281,7 @@ msgid "" "``ERROR_INVALID_PARAMETER`` (87)." msgstr "" -#: ../../../library/subprocess.rst:1027 +#: ../../../library/subprocess.rst:1033 msgid "" "In a multithreaded process, use caution to avoid leaking handles that are " "marked inheritable when combining this feature with concurrent calls to " @@ -1283,97 +1290,97 @@ msgid "" "temporarily creates inheritable handles." msgstr "" -#: ../../../library/subprocess.rst:1037 +#: ../../../library/subprocess.rst:1043 msgid "Windows Constants" msgstr "" -#: ../../../library/subprocess.rst:1039 +#: ../../../library/subprocess.rst:1045 msgid "The :mod:`subprocess` module exposes the following constants." msgstr "" -#: ../../../library/subprocess.rst:1043 +#: ../../../library/subprocess.rst:1049 msgid "" "The standard input device. Initially, this is the console input buffer, " "``CONIN$``." msgstr "" -#: ../../../library/subprocess.rst:1048 +#: ../../../library/subprocess.rst:1054 msgid "" "The standard output device. Initially, this is the active console screen " "buffer, ``CONOUT$``." msgstr "" -#: ../../../library/subprocess.rst:1053 +#: ../../../library/subprocess.rst:1059 msgid "" "The standard error device. Initially, this is the active console screen " "buffer, ``CONOUT$``." msgstr "" -#: ../../../library/subprocess.rst:1058 +#: ../../../library/subprocess.rst:1064 msgid "Hides the window. Another window will be activated." msgstr "" -#: ../../../library/subprocess.rst:1062 +#: ../../../library/subprocess.rst:1068 msgid "" "Specifies that the :attr:`STARTUPINFO.hStdInput`, :attr:`STARTUPINFO." "hStdOutput`, and :attr:`STARTUPINFO.hStdError` attributes contain additional " "information." msgstr "" -#: ../../../library/subprocess.rst:1068 +#: ../../../library/subprocess.rst:1074 msgid "" "Specifies that the :attr:`STARTUPINFO.wShowWindow` attribute contains " "additional information." msgstr "" -#: ../../../library/subprocess.rst:1073 +#: ../../../library/subprocess.rst:1079 msgid "" "The new process has a new console, instead of inheriting its parent's " "console (the default)." msgstr "" -#: ../../../library/subprocess.rst:1078 +#: ../../../library/subprocess.rst:1084 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "group will be created. This flag is necessary for using :func:`os.kill` on " "the subprocess." msgstr "" -#: ../../../library/subprocess.rst:1082 +#: ../../../library/subprocess.rst:1088 msgid "This flag is ignored if :data:`CREATE_NEW_CONSOLE` is specified." msgstr "" -#: ../../../library/subprocess.rst:1086 +#: ../../../library/subprocess.rst:1092 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will have an above average priority." msgstr "" -#: ../../../library/subprocess.rst:1093 +#: ../../../library/subprocess.rst:1099 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will have a below average priority." msgstr "" -#: ../../../library/subprocess.rst:1100 +#: ../../../library/subprocess.rst:1106 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will have a high priority." msgstr "" -#: ../../../library/subprocess.rst:1107 +#: ../../../library/subprocess.rst:1113 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will have an idle (lowest) priority." msgstr "" -#: ../../../library/subprocess.rst:1114 +#: ../../../library/subprocess.rst:1120 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will have an normal priority. (default)" msgstr "" -#: ../../../library/subprocess.rst:1121 +#: ../../../library/subprocess.rst:1127 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will have realtime priority. You should almost never use " @@ -1383,20 +1390,20 @@ msgid "" "perform brief tasks that should have limited interruptions." msgstr "" -#: ../../../library/subprocess.rst:1132 +#: ../../../library/subprocess.rst:1138 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will not create a window." msgstr "" -#: ../../../library/subprocess.rst:1139 +#: ../../../library/subprocess.rst:1145 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will not inherit its parent's console. This value cannot be used with " "CREATE_NEW_CONSOLE." msgstr "" -#: ../../../library/subprocess.rst:1147 +#: ../../../library/subprocess.rst:1153 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "does not inherit the error mode of the calling process. Instead, the new " @@ -1404,39 +1411,39 @@ msgid "" "multithreaded shell applications that run with hard errors disabled." msgstr "" -#: ../../../library/subprocess.rst:1157 +#: ../../../library/subprocess.rst:1163 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "is not associated with the job." msgstr "" -#: ../../../library/subprocess.rst:1165 +#: ../../../library/subprocess.rst:1171 msgid "Older high-level API" msgstr "" -#: ../../../library/subprocess.rst:1167 +#: ../../../library/subprocess.rst:1173 msgid "" "Prior to Python 3.5, these three functions comprised the high level API to " "subprocess. You can now use :func:`run` in many cases, but lots of existing " "code calls these functions." msgstr "" -#: ../../../library/subprocess.rst:1174 +#: ../../../library/subprocess.rst:1180 msgid "" "Run the command described by *args*. Wait for command to complete, then " "return the :attr:`~Popen.returncode` attribute." msgstr "" -#: ../../../library/subprocess.rst:1177 ../../../library/subprocess.rst:1217 +#: ../../../library/subprocess.rst:1183 ../../../library/subprocess.rst:1223 msgid "" "Code needing to capture stdout or stderr should use :func:`run` instead::" msgstr "" -#: ../../../library/subprocess.rst:1181 ../../../library/subprocess.rst:1221 +#: ../../../library/subprocess.rst:1187 ../../../library/subprocess.rst:1227 msgid "To suppress stdout or stderr, supply a value of :data:`DEVNULL`." msgstr "" -#: ../../../library/subprocess.rst:1183 ../../../library/subprocess.rst:1223 +#: ../../../library/subprocess.rst:1189 ../../../library/subprocess.rst:1229 msgid "" "The arguments shown above are merely some common ones. The full function " "signature is the same as that of the :class:`Popen` constructor - this " @@ -1444,14 +1451,14 @@ msgid "" "to that interface." msgstr "" -#: ../../../library/subprocess.rst:1190 ../../../library/subprocess.rst:1230 +#: ../../../library/subprocess.rst:1196 ../../../library/subprocess.rst:1236 msgid "" "Do not use ``stdout=PIPE`` or ``stderr=PIPE`` with this function. The child " "process will block if it generates enough output to a pipe to fill up the OS " "pipe buffer as the pipes are not being read from." msgstr "" -#: ../../../library/subprocess.rst:1210 +#: ../../../library/subprocess.rst:1216 msgid "" "Run command with arguments. Wait for command to complete. If the return " "code was zero then return, otherwise raise :exc:`CalledProcessError`. The :" @@ -1460,11 +1467,11 @@ msgid "" "to start the process it will propagate the exception that was raised." msgstr "" -#: ../../../library/subprocess.rst:1252 +#: ../../../library/subprocess.rst:1258 msgid "Run command with arguments and return its output." msgstr "" -#: ../../../library/subprocess.rst:1254 +#: ../../../library/subprocess.rst:1260 msgid "" "If the return code was non-zero it raises a :exc:`CalledProcessError`. The :" "exc:`CalledProcessError` object will have the return code in the :attr:" @@ -1472,11 +1479,11 @@ msgid "" "`~CalledProcessError.output` attribute." msgstr "" -#: ../../../library/subprocess.rst:1259 +#: ../../../library/subprocess.rst:1265 msgid "This is equivalent to::" msgstr "" -#: ../../../library/subprocess.rst:1263 +#: ../../../library/subprocess.rst:1269 msgid "" "The arguments shown above are merely some common ones. The full function " "signature is largely the same as that of :func:`run` - most arguments are " @@ -1486,52 +1493,52 @@ msgid "" "using the parent's standard input file handle." msgstr "" -#: ../../../library/subprocess.rst:1270 +#: ../../../library/subprocess.rst:1276 msgid "" "By default, this function will return the data as encoded bytes. The actual " "encoding of the output data may depend on the command being invoked, so the " "decoding to text will often need to be handled at the application level." msgstr "" -#: ../../../library/subprocess.rst:1274 +#: ../../../library/subprocess.rst:1280 msgid "" "This behaviour may be overridden by setting *text*, *encoding*, *errors*, or " "*universal_newlines* to ``True`` as described in :ref:`frequently-used-" "arguments` and :func:`run`." msgstr "" -#: ../../../library/subprocess.rst:1278 +#: ../../../library/subprocess.rst:1284 msgid "" "To also capture standard error in the result, use ``stderr=subprocess." "STDOUT``::" msgstr "" -#: ../../../library/subprocess.rst:1292 +#: ../../../library/subprocess.rst:1298 msgid "Support for the *input* keyword argument was added." msgstr "" -#: ../../../library/subprocess.rst:1295 +#: ../../../library/subprocess.rst:1301 msgid "*encoding* and *errors* were added. See :func:`run` for details." msgstr "" -#: ../../../library/subprocess.rst:1313 +#: ../../../library/subprocess.rst:1319 msgid "Replacing Older Functions with the :mod:`subprocess` Module" msgstr "" -#: ../../../library/subprocess.rst:1315 +#: ../../../library/subprocess.rst:1321 msgid "" "In this section, \"a becomes b\" means that b can be used as a replacement " "for a." msgstr "" -#: ../../../library/subprocess.rst:1319 +#: ../../../library/subprocess.rst:1325 msgid "" "All \"a\" functions in this section fail (more or less) silently if the " "executed program cannot be found; the \"b\" replacements raise :exc:" "`OSError` instead." msgstr "" -#: ../../../library/subprocess.rst:1323 +#: ../../../library/subprocess.rst:1329 msgid "" "In addition, the replacements using :func:`check_output` will fail with a :" "exc:`CalledProcessError` if the requested operation produces a non-zero " @@ -1539,134 +1546,134 @@ msgid "" "output` attribute of the raised exception." msgstr "" -#: ../../../library/subprocess.rst:1328 +#: ../../../library/subprocess.rst:1334 msgid "" "In the following examples, we assume that the relevant functions have " "already been imported from the :mod:`subprocess` module." msgstr "" -#: ../../../library/subprocess.rst:1333 +#: ../../../library/subprocess.rst:1339 msgid "Replacing :program:`/bin/sh` shell command substitution" msgstr "" -#: ../../../library/subprocess.rst:1339 ../../../library/subprocess.rst:1350 -#: ../../../library/subprocess.rst:1367 +#: ../../../library/subprocess.rst:1345 ../../../library/subprocess.rst:1356 +#: ../../../library/subprocess.rst:1373 msgid "becomes::" msgstr "" -#: ../../../library/subprocess.rst:1344 +#: ../../../library/subprocess.rst:1350 msgid "Replacing shell pipeline" msgstr "" -#: ../../../library/subprocess.rst:1357 +#: ../../../library/subprocess.rst:1363 msgid "" "The ``p1.stdout.close()`` call after starting the p2 is important in order " "for p1 to receive a SIGPIPE if p2 exits before p1." msgstr "" -#: ../../../library/subprocess.rst:1360 +#: ../../../library/subprocess.rst:1366 msgid "" "Alternatively, for trusted input, the shell's own pipeline support may still " "be used directly:" msgstr "" -#: ../../../library/subprocess.rst:1373 +#: ../../../library/subprocess.rst:1379 msgid "Replacing :func:`os.system`" msgstr "" -#: ../../../library/subprocess.rst:1381 +#: ../../../library/subprocess.rst:1387 msgid "Notes:" msgstr "" -#: ../../../library/subprocess.rst:1383 +#: ../../../library/subprocess.rst:1389 msgid "Calling the program through the shell is usually not required." msgstr "" -#: ../../../library/subprocess.rst:1384 +#: ../../../library/subprocess.rst:1390 msgid "" "The :func:`call` return value is encoded differently to that of :func:`os." "system`." msgstr "" -#: ../../../library/subprocess.rst:1387 +#: ../../../library/subprocess.rst:1393 msgid "" "The :func:`os.system` function ignores SIGINT and SIGQUIT signals while the " "command is running, but the caller must do this separately when using the :" "mod:`subprocess` module." msgstr "" -#: ../../../library/subprocess.rst:1391 +#: ../../../library/subprocess.rst:1397 msgid "A more realistic example would look like this::" msgstr "" -#: ../../../library/subprocess.rst:1404 +#: ../../../library/subprocess.rst:1410 msgid "Replacing the :func:`os.spawn ` family" msgstr "" -#: ../../../library/subprocess.rst:1406 +#: ../../../library/subprocess.rst:1412 msgid "P_NOWAIT example::" msgstr "" -#: ../../../library/subprocess.rst:1412 +#: ../../../library/subprocess.rst:1418 msgid "P_WAIT example::" msgstr "" -#: ../../../library/subprocess.rst:1418 +#: ../../../library/subprocess.rst:1424 msgid "Vector example::" msgstr "" -#: ../../../library/subprocess.rst:1424 +#: ../../../library/subprocess.rst:1430 msgid "Environment example::" msgstr "" -#: ../../../library/subprocess.rst:1433 +#: ../../../library/subprocess.rst:1439 msgid "Replacing :func:`os.popen`, :func:`os.popen2`, :func:`os.popen3`" msgstr "" -#: ../../../library/subprocess.rst:1463 +#: ../../../library/subprocess.rst:1469 msgid "Return code handling translates as follows::" msgstr "" -#: ../../../library/subprocess.rst:1479 +#: ../../../library/subprocess.rst:1485 msgid "Replacing functions from the :mod:`!popen2` module" msgstr "" -#: ../../../library/subprocess.rst:1483 +#: ../../../library/subprocess.rst:1489 msgid "" "If the cmd argument to popen2 functions is a string, the command is executed " "through /bin/sh. If it is a list, the command is directly executed." msgstr "" -#: ../../../library/subprocess.rst:1502 +#: ../../../library/subprocess.rst:1508 msgid "" ":class:`popen2.Popen3` and :class:`popen2.Popen4` basically work as :class:" "`subprocess.Popen`, except that:" msgstr "" -#: ../../../library/subprocess.rst:1505 +#: ../../../library/subprocess.rst:1511 msgid ":class:`Popen` raises an exception if the execution fails." msgstr "" -#: ../../../library/subprocess.rst:1507 +#: ../../../library/subprocess.rst:1513 msgid "The *capturestderr* argument is replaced with the *stderr* argument." msgstr "" -#: ../../../library/subprocess.rst:1509 +#: ../../../library/subprocess.rst:1515 msgid "``stdin=PIPE`` and ``stdout=PIPE`` must be specified." msgstr "" -#: ../../../library/subprocess.rst:1511 +#: ../../../library/subprocess.rst:1517 msgid "" "popen2 closes all file descriptors by default, but you have to specify " "``close_fds=True`` with :class:`Popen` to guarantee this behavior on all " "platforms or past Python versions." msgstr "" -#: ../../../library/subprocess.rst:1517 +#: ../../../library/subprocess.rst:1523 msgid "Legacy Shell Invocation Functions" msgstr "" -#: ../../../library/subprocess.rst:1519 +#: ../../../library/subprocess.rst:1525 msgid "" "This module also provides the following legacy functions from the 2.x " "``commands`` module. These operations implicitly invoke the system shell and " @@ -1674,11 +1681,11 @@ msgid "" "handling consistency are valid for these functions." msgstr "" -#: ../../../library/subprocess.rst:1526 +#: ../../../library/subprocess.rst:1532 msgid "Return ``(exitcode, output)`` of executing *cmd* in a shell." msgstr "" -#: ../../../library/subprocess.rst:1528 +#: ../../../library/subprocess.rst:1534 msgid "" "Execute the string *cmd* in a shell with :meth:`Popen.check_output` and " "return a 2-tuple ``(exitcode, output)``. *encoding* and *errors* are used to " @@ -1686,81 +1693,81 @@ msgid "" "details." msgstr "" -#: ../../../library/subprocess.rst:1533 +#: ../../../library/subprocess.rst:1539 msgid "" "A trailing newline is stripped from the output. The exit code for the " "command can be interpreted as the return code of subprocess. Example::" msgstr "" -#: ../../../library/subprocess.rst:1546 ../../../library/subprocess.rst:1568 +#: ../../../library/subprocess.rst:1552 ../../../library/subprocess.rst:1574 msgid ":ref:`Availability `: Unix, Windows." msgstr "" -#: ../../../library/subprocess.rst:1548 +#: ../../../library/subprocess.rst:1554 msgid "Windows support was added." msgstr "" -#: ../../../library/subprocess.rst:1551 +#: ../../../library/subprocess.rst:1557 msgid "" "The function now returns (exitcode, output) instead of (status, output) as " "it did in Python 3.3.3 and earlier. exitcode has the same value as :attr:" "`~Popen.returncode`." msgstr "" -#: ../../../library/subprocess.rst:1560 +#: ../../../library/subprocess.rst:1566 msgid "Return output (stdout and stderr) of executing *cmd* in a shell." msgstr "" -#: ../../../library/subprocess.rst:1562 +#: ../../../library/subprocess.rst:1568 msgid "" "Like :func:`getstatusoutput`, except the exit code is ignored and the return " "value is a string containing the command's output. Example::" msgstr "" -#: ../../../library/subprocess.rst:1570 +#: ../../../library/subprocess.rst:1576 msgid "Windows support added" msgstr "" -#: ../../../library/subprocess.rst:1578 +#: ../../../library/subprocess.rst:1584 msgid "Notes" msgstr "" -#: ../../../library/subprocess.rst:1583 +#: ../../../library/subprocess.rst:1589 msgid "Converting an argument sequence to a string on Windows" msgstr "" -#: ../../../library/subprocess.rst:1585 +#: ../../../library/subprocess.rst:1591 msgid "" "On Windows, an *args* sequence is converted to a string that can be parsed " "using the following rules (which correspond to the rules used by the MS C " "runtime):" msgstr "" -#: ../../../library/subprocess.rst:1589 +#: ../../../library/subprocess.rst:1595 msgid "" "Arguments are delimited by white space, which is either a space or a tab." msgstr "" -#: ../../../library/subprocess.rst:1592 +#: ../../../library/subprocess.rst:1598 msgid "" "A string surrounded by double quotation marks is interpreted as a single " "argument, regardless of white space contained within. A quoted string can " "be embedded in an argument." msgstr "" -#: ../../../library/subprocess.rst:1597 +#: ../../../library/subprocess.rst:1603 msgid "" "A double quotation mark preceded by a backslash is interpreted as a literal " "double quotation mark." msgstr "" -#: ../../../library/subprocess.rst:1600 +#: ../../../library/subprocess.rst:1606 msgid "" "Backslashes are interpreted literally, unless they immediately precede a " "double quotation mark." msgstr "" -#: ../../../library/subprocess.rst:1603 +#: ../../../library/subprocess.rst:1609 msgid "" "If backslashes immediately precede a double quotation mark, every pair of " "backslashes is interpreted as a literal backslash. If the number of " @@ -1768,33 +1775,33 @@ msgid "" "mark as described in rule 3." msgstr "" -#: ../../../library/subprocess.rst:1612 +#: ../../../library/subprocess.rst:1618 msgid ":mod:`shlex`" msgstr "" -#: ../../../library/subprocess.rst:1613 +#: ../../../library/subprocess.rst:1619 msgid "Module which provides function to parse and escape command lines." msgstr "" -#: ../../../library/subprocess.rst:1620 +#: ../../../library/subprocess.rst:1626 msgid "Disabling use of ``vfork()`` or ``posix_spawn()``" msgstr "" -#: ../../../library/subprocess.rst:1622 +#: ../../../library/subprocess.rst:1628 msgid "" "On Linux, :mod:`subprocess` defaults to using the ``vfork()`` system call " "internally when it is safe to do so rather than ``fork()``. This greatly " "improves performance." msgstr "" -#: ../../../library/subprocess.rst:1626 +#: ../../../library/subprocess.rst:1632 msgid "" "If you ever encounter a presumed highly unusual situation where you need to " "prevent ``vfork()`` from being used by Python, you can set the :const:" "`subprocess._USE_VFORK` attribute to a false value." msgstr "" -#: ../../../library/subprocess.rst:1634 +#: ../../../library/subprocess.rst:1640 msgid "" "Setting this has no impact on use of ``posix_spawn()`` which could use " "``vfork()`` internally within its libc implementation. There is a similar :" @@ -1802,7 +1809,7 @@ msgid "" "that." msgstr "" -#: ../../../library/subprocess.rst:1643 +#: ../../../library/subprocess.rst:1649 msgid "" "It is safe to set these to false on any Python version. They will have no " "effect on older versions when unsupported. Do not assume the attributes are " @@ -1810,18 +1817,18 @@ msgid "" "the corresponding function will be used, only that it may be." msgstr "" -#: ../../../library/subprocess.rst:1648 +#: ../../../library/subprocess.rst:1654 msgid "" "Please file issues any time you have to use these private knobs with a way " "to reproduce the issue you were seeing. Link to that issue from a comment in " "your code." msgstr "" -#: ../../../library/subprocess.rst:1652 +#: ../../../library/subprocess.rst:1658 msgid "``_USE_POSIX_SPAWN``" msgstr "" -#: ../../../library/subprocess.rst:1653 +#: ../../../library/subprocess.rst:1659 msgid "``_USE_VFORK``" msgstr "" diff --git a/3.11/locale/pot/LC_MESSAGES/using/windows.pot b/3.11/locale/pot/LC_MESSAGES/using/windows.pot index 6bd05fa6f04..da107a2c24f 100644 --- a/3.11/locale/pot/LC_MESSAGES/using/windows.pot +++ b/3.11/locale/pot/LC_MESSAGES/using/windows.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-29 08:27+0000\n" +"POT-Creation-Date: 2026-09-02 12:28+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -756,9 +756,9 @@ msgstr "" #: ../../../using/windows.rst:403 msgid "" "The ``nuget.exe`` command line tool may be downloaded directly from " -"``https://aka.ms/nugetclidl``, for example, using curl or PowerShell. With " -"the tool, the latest version of Python for 64-bit or 32-bit machines is " -"installed using::" +"``https://dist.nuget.org/win-x86-commandline/latest/nuget.exe``, for " +"example, using curl or PowerShell. With the tool, the latest version of " +"Python for 64-bit or 32-bit machines is installed using::" msgstr "" #: ../../../using/windows.rst:411 diff --git a/3.11/references.json b/3.11/references.json index 1ad1253133b..1318bef744b 100644 --- a/3.11/references.json +++ b/3.11/references.json @@ -16,7 +16,7 @@ }, "pot" : { - "tag" : "v3.11.15" + "tag" : "v3.11.16" }, "type" : "tag", "version" : "3.11"