From d196f92235b99702bdd1905e9a77bab13a85fd2c Mon Sep 17 00:00:00 2001 From: python-docs-turkish Date: Thu, 1 Aug 2024 00:20:19 +0000 Subject: [PATCH 1/2] Get changes from CPython Doc for 3.12 --- Makefile | 2 +- c-api/arg.po | 10 +- c-api/cell.po | 21 +- c-api/complex.po | 70 +- c-api/file.po | 6 +- c-api/float.po | 12 +- c-api/init.po | 667 ++++++------ c-api/init_config.po | 4 +- c-api/marshal.po | 4 +- c-api/module.po | 235 ++-- c-api/number.po | 10 +- c-api/slice.po | 49 +- c-api/sys.po | 9 +- c-api/typeobj.po | 6 +- faq/design.po | 6 +- faq/library.po | 6 +- faq/programming.po | 189 ++-- howto/descriptor.po | 4 +- howto/enum.po | 118 +- howto/logging-cookbook.po | 4 +- howto/logging.po | 284 ++--- library/2to3.po | 6 +- library/__main__.po | 8 +- library/_thread.po | 6 +- library/aifc.po | 4 +- library/array.po | 9 +- library/ast.po | 313 +++--- library/asyncio-eventloop.po | 325 +++--- library/asyncio-future.po | 6 +- library/asyncio-task.po | 4 +- library/asyncio.po | 32 +- library/audioop.po | 4 +- library/cgi.po | 10 +- library/cgitb.po | 4 +- library/chunk.po | 4 +- library/collections.abc.po | 4 +- library/collections.po | 4 +- library/colorsys.po | 4 +- library/configparser.po | 330 +++--- library/contextlib.po | 201 ++-- library/crypt.po | 4 +- library/ctypes.po | 73 +- library/datetime.po | 70 +- library/decimal.po | 486 +++++---- library/dis.po | 4 +- library/email.compat32-message.po | 210 ++-- library/email.header.po | 4 +- library/email.utils.po | 6 +- library/ensurepip.po | 8 +- library/enum.po | 4 +- library/exceptions.po | 23 +- library/fcntl.po | 18 +- library/fileinput.po | 4 +- library/fractions.po | 6 +- library/ftplib.po | 21 +- library/functions.po | 344 +++--- library/gc.po | 14 +- library/glob.po | 10 +- library/gzip.po | 44 +- library/http.client.po | 13 +- library/http.server.po | 4 +- library/imaplib.po | 14 +- library/imghdr.po | 4 +- library/importlib.po | 8 +- library/importlib.resources.abc.po | 6 +- library/inspect.po | 557 +++++----- library/io.po | 7 +- library/ipaddress.po | 8 +- library/itertools.po | 6 +- library/locale.po | 6 +- library/mailbox.po | 4 +- library/mailcap.po | 4 +- library/marshal.po | 18 +- library/math.po | 9 +- library/mimetypes.po | 6 +- library/mmap.po | 8 +- library/msilib.po | 4 +- library/msvcrt.po | 12 +- library/multiprocessing.po | 1038 +++++++++--------- library/nis.po | 4 +- library/nntplib.po | 13 +- library/optparse.po | 4 +- library/os.path.po | 6 +- library/os.po | 160 +-- library/ossaudiodev.po | 4 +- library/pathlib.po | 1043 ++++++++++-------- library/pdb.po | 5 +- library/pickle.po | 6 +- library/pipes.po | 4 +- library/pkgutil.po | 10 +- library/poplib.po | 13 +- library/pprint.po | 196 ++-- library/profile.po | 6 +- library/pty.po | 6 +- library/random.po | 10 +- library/re.po | 301 ++--- library/readline.po | 93 +- library/resource.po | 11 +- library/select.po | 4 +- library/shutil.po | 38 +- library/signal.po | 6 +- library/smtplib.po | 17 +- library/sndhdr.po | 4 +- library/socket.po | 82 +- library/spwd.po | 4 +- library/sqlite3.po | 20 +- library/ssl.po | 457 ++++---- library/statistics.po | 213 ++-- library/stdtypes.po | 1487 ++++++++++++------------- library/string.po | 8 +- library/subprocess.po | 12 +- library/sunau.po | 4 +- library/symtable.po | 64 +- library/sys.po | 56 +- library/sysconfig.po | 4 +- library/syslog.po | 17 +- library/telnetlib.po | 15 +- library/tempfile.po | 10 +- library/threading.po | 8 +- library/time.po | 16 +- library/types.po | 11 +- library/typing.po | 1224 +++++++++++---------- library/unittest.mock.po | 581 +++++----- library/unittest.po | 6 +- library/urllib.parse.po | 4 +- library/urllib.request.po | 12 +- library/uu.po | 4 +- library/webbrowser.po | 10 +- library/winreg.po | 72 +- library/xdrlib.po | 4 +- library/xml.etree.elementtree.po | 196 ++-- reference/compound_stmts.po | 818 +++++++------- reference/datamodel.po | 1282 +++++++++++----------- reference/expressions.po | 1143 ++++++++++--------- reference/lexical_analysis.po | 18 +- reference/simple_stmts.po | 413 +++---- sphinx.po | 46 +- tutorial/classes.po | 176 +-- tutorial/floatingpoint.po | 13 +- tutorial/inputoutput.po | 88 +- tutorial/introduction.po | 5 +- tutorial/stdlib.po | 5 +- tutorial/stdlib2.po | 20 +- using/cmdline.po | 260 +++-- using/configure.po | 6 +- whatsnew/2.1.po | 6 +- whatsnew/2.2.po | 4 +- whatsnew/2.3.po | 4 +- whatsnew/2.5.po | 8 +- whatsnew/2.6.po | 4 +- whatsnew/2.7.po | 4 +- whatsnew/3.1.po | 14 +- whatsnew/3.11.po | 1206 ++++++++++---------- whatsnew/3.12.po | 1633 +++++++++++++++++++--------- whatsnew/3.2.po | 4 +- whatsnew/3.3.po | 6 +- whatsnew/3.4.po | 4 +- whatsnew/3.5.po | 6 +- whatsnew/3.6.po | 4 +- whatsnew/3.7.po | 14 +- whatsnew/3.8.po | 5 +- 161 files changed, 10390 insertions(+), 9477 deletions(-) diff --git a/Makefile b/Makefile index 5bd186449..47c27746f 100644 --- a/Makefile +++ b/Makefile @@ -19,7 +19,7 @@ # test build, we're building with the .rst files that generated our # .po files. -CPYTHON_CURRENT_COMMIT := 2f7fada58091c518fd6784e108cce83bf6c310ac +CPYTHON_CURRENT_COMMIT := 5df322e91a40909e6904bbdbc0c3a6b6a9eead39 LANGUAGE := tr BRANCH := 3.12 diff --git a/c-api/arg.po b/c-api/arg.po index 2ba328083..ac1871a67 100644 --- a/c-api/arg.po +++ b/c-api/arg.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -542,7 +542,7 @@ msgid "``f`` (:class:`float`) [float]" msgstr "" #: c-api/arg.rst:283 -msgid "Convert a Python floating point number to a C :c:expr:`float`." +msgid "Convert a Python floating-point number to a C :c:expr:`float`." msgstr "" #: c-api/arg.rst:609 @@ -550,7 +550,7 @@ msgid "``d`` (:class:`float`) [double]" msgstr "" #: c-api/arg.rst:286 -msgid "Convert a Python floating point number to a C :c:expr:`double`." +msgid "Convert a Python floating-point number to a C :c:expr:`double`." msgstr "" #: c-api/arg.rst:288 @@ -1022,11 +1022,11 @@ msgid "" msgstr "" #: c-api/arg.rst:610 -msgid "Convert a C :c:expr:`double` to a Python floating point number." +msgid "Convert a C :c:expr:`double` to a Python floating-point number." msgstr "" #: c-api/arg.rst:613 -msgid "Convert a C :c:expr:`float` to a Python floating point number." +msgid "Convert a C :c:expr:`float` to a Python floating-point number." msgstr "" #: c-api/arg.rst:615 diff --git a/c-api/cell.po b/c-api/cell.po index 75acce7c8..1f74280be 100644 --- a/c-api/cell.po +++ b/c-api/cell.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-12-17 01:28+0300\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -53,24 +53,31 @@ msgid "" msgstr "" #: c-api/cell.rst:42 -msgid "Return the contents of the cell *cell*." +msgid "" +"Return the contents of the cell *cell*, which can be ``NULL``. If *cell* is " +"not a cell object, returns ``NULL`` with an exception set." msgstr "" -#: c-api/cell.rst:47 +#: c-api/cell.rst:48 msgid "" "Return the contents of the cell *cell*, but without checking that *cell* is " "non-``NULL`` and a cell object." msgstr "" -#: c-api/cell.rst:53 +#: c-api/cell.rst:54 msgid "" "Set the contents of the cell object *cell* to *value*. This releases the " "reference to any current content of the cell. *value* may be ``NULL``. " -"*cell* must be non-``NULL``; if it is not a cell object, ``-1`` will be " -"returned. On success, ``0`` will be returned." +"*cell* must be non-``NULL``." +msgstr "" + +#: c-api/cell.rst:58 +msgid "" +"On success, return ``0``. If *cell* is not a cell object, set an exception " +"and return ``-1``." msgstr "" -#: c-api/cell.rst:61 +#: c-api/cell.rst:64 msgid "" "Sets the value of the cell object *cell* to *value*. No reference counts " "are adjusted, and no checks are made for safety; *cell* must be non-``NULL`` " diff --git a/c-api/complex.po b/c-api/complex.po index a3ac1fc9b..7fc84a4fd 100644 --- a/c-api/complex.po +++ b/c-api/complex.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -44,117 +44,135 @@ msgid "" "The C structure which corresponds to the value portion of a Python complex " "number object. Most of the functions for dealing with complex number " "objects use structures of this type as input or output values, as " -"appropriate. It is defined as::" +"appropriate." msgstr "" -#: c-api/complex.rst:39 +#: c-api/complex.rst:33 +msgid "The structure is defined as::" +msgstr "" + +#: c-api/complex.rst:43 msgid "" "Return the sum of two complex numbers, using the C :c:type:`Py_complex` " "representation." msgstr "" -#: c-api/complex.rst:45 +#: c-api/complex.rst:49 msgid "" "Return the difference between two complex numbers, using the C :c:type:" "`Py_complex` representation." msgstr "" -#: c-api/complex.rst:51 +#: c-api/complex.rst:55 msgid "" "Return the negation of the complex number *num*, using the C :c:type:" "`Py_complex` representation." msgstr "" -#: c-api/complex.rst:57 +#: c-api/complex.rst:61 msgid "" "Return the product of two complex numbers, using the C :c:type:`Py_complex` " "representation." msgstr "" -#: c-api/complex.rst:63 +#: c-api/complex.rst:67 msgid "" "Return the quotient of two complex numbers, using the C :c:type:`Py_complex` " "representation." msgstr "" -#: c-api/complex.rst:66 +#: c-api/complex.rst:70 msgid "" "If *divisor* is null, this method returns zero and sets :c:data:`errno` to :" "c:macro:`!EDOM`." msgstr "" -#: c-api/complex.rst:72 +#: c-api/complex.rst:76 msgid "" "Return the exponentiation of *num* by *exp*, using the C :c:type:" "`Py_complex` representation." msgstr "" -#: c-api/complex.rst:75 +#: c-api/complex.rst:79 msgid "" "If *num* is null and *exp* is not a positive real number, this method " "returns zero and sets :c:data:`errno` to :c:macro:`!EDOM`." msgstr "" -#: c-api/complex.rst:80 +#: c-api/complex.rst:84 msgid "Complex Numbers as Python Objects" msgstr "" -#: c-api/complex.rst:85 +#: c-api/complex.rst:89 msgid "" "This subtype of :c:type:`PyObject` represents a Python complex number object." msgstr "" -#: c-api/complex.rst:90 +#: c-api/complex.rst:94 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python complex number " "type. It is the same object as :class:`complex` in the Python layer." msgstr "" -#: c-api/complex.rst:96 +#: c-api/complex.rst:100 msgid "" "Return true if its argument is a :c:type:`PyComplexObject` or a subtype of :" "c:type:`PyComplexObject`. This function always succeeds." msgstr "" -#: c-api/complex.rst:102 +#: c-api/complex.rst:106 msgid "" "Return true if its argument is a :c:type:`PyComplexObject`, but not a " "subtype of :c:type:`PyComplexObject`. This function always succeeds." msgstr "" -#: c-api/complex.rst:108 +#: c-api/complex.rst:112 msgid "" "Create a new Python complex number object from a C :c:type:`Py_complex` " -"value." +"value. Return ``NULL`` with an exception set on error." msgstr "" -#: c-api/complex.rst:113 -msgid "Return a new :c:type:`PyComplexObject` object from *real* and *imag*." +#: c-api/complex.rst:118 +msgid "" +"Return a new :c:type:`PyComplexObject` object from *real* and *imag*. Return " +"``NULL`` with an exception set on error." msgstr "" -#: c-api/complex.rst:118 +#: c-api/complex.rst:124 msgid "Return the real part of *op* as a C :c:expr:`double`." msgstr "" -#: c-api/complex.rst:123 +#: c-api/complex.rst:126 +msgid "" +"Upon failure, this method returns ``-1.0`` with an exception set, so one " +"should call :c:func:`PyErr_Occurred` to check for errors." +msgstr "" + +#: c-api/complex.rst:132 msgid "Return the imaginary part of *op* as a C :c:expr:`double`." msgstr "" -#: c-api/complex.rst:128 +#: c-api/complex.rst:137 msgid "Return the :c:type:`Py_complex` value of the complex number *op*." msgstr "" -#: c-api/complex.rst:130 +#: c-api/complex.rst:139 msgid "" "If *op* is not a Python complex number object but has a :meth:`~object." "__complex__` method, this method will first be called to convert *op* to a " "Python complex number object. If :meth:`!__complex__` is not defined then " "it falls back to :meth:`~object.__float__`. If :meth:`!__float__` is not " -"defined then it falls back to :meth:`~object.__index__`. Upon failure, this " -"method returns ``-1.0`` as a real value." +"defined then it falls back to :meth:`~object.__index__`." msgstr "" -#: c-api/complex.rst:137 +#: c-api/complex.rst:145 +msgid "" +"Upon failure, this method returns :c:type:`Py_complex` with :c:member:" +"`~Py_complex.real` set to ``-1.0`` and with an exception set, so one should " +"call :c:func:`PyErr_Occurred` to check for errors." +msgstr "" + +#: c-api/complex.rst:149 msgid "Use :meth:`~object.__index__` if available." msgstr "" diff --git a/c-api/file.po b/c-api/file.po index e75d0bad3..a5d15fea7 100644 --- a/c-api/file.po +++ b/c-api/file.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -117,9 +117,7 @@ msgid "This function is safe to call before :c:func:`Py_Initialize`." msgstr "" #: c-api/file.rst:90 -msgid "" -"Raises an :ref:`auditing event ` ``setopencodehook`` with no " -"arguments." +msgid "Raises an auditing event setopencodehook with no arguments." msgstr "" #: c-api/file.rst:100 diff --git a/c-api/float.po b/c-api/float.po index 1c708d919..8a677c385 100644 --- a/c-api/float.po +++ b/c-api/float.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -17,17 +17,17 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: c-api/float.rst:6 -msgid "Floating Point Objects" +msgid "Floating-Point Objects" msgstr "" #: c-api/float.rst:13 msgid "" -"This subtype of :c:type:`PyObject` represents a Python floating point object." +"This subtype of :c:type:`PyObject` represents a Python floating-point object." msgstr "" #: c-api/float.rst:18 msgid "" -"This instance of :c:type:`PyTypeObject` represents the Python floating point " +"This instance of :c:type:`PyTypeObject` represents the Python floating-point " "type. This is the same object as :class:`float` in the Python layer." msgstr "" @@ -57,7 +57,7 @@ msgstr "" #: c-api/float.rst:47 msgid "" "Return a C :c:expr:`double` representation of the contents of *pyfloat*. If " -"*pyfloat* is not a Python floating point object but has a :meth:`~object." +"*pyfloat* is not a Python floating-point object but has a :meth:`~object." "__float__` method, this method will first be called to convert *pyfloat* " "into a float. If :meth:`!__float__` is not defined then it falls back to :" "meth:`~object.__index__`. This method returns ``-1.0`` upon failure, so one " @@ -213,5 +213,5 @@ msgid "object" msgstr "" #: c-api/float.rst:8 -msgid "floating point" +msgid "floating-point" msgstr "" diff --git a/c-api/init.po b/c-api/init.po index 3a53ce487..3f66600c8 100644 --- a/c-api/init.po +++ b/c-api/init.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -556,12 +556,24 @@ msgid "" "`Py_NewInterpreter` below) that were created and not yet destroyed since the " "last call to :c:func:`Py_Initialize`. Ideally, this frees all memory " "allocated by the Python interpreter. This is a no-op when called for a " -"second time (without calling :c:func:`Py_Initialize` again first). Normally " -"the return value is ``0``. If there were errors during finalization " +"second time (without calling :c:func:`Py_Initialize` again first)." +msgstr "" + +#: c-api/init.rst:393 +msgid "" +"Since this is the reverse of :c:func:`Py_Initialize`, it should be called in " +"the same thread with the same interpreter active. That means the main " +"thread and the main interpreter. This should never be called while :c:func:" +"`Py_RunMain` is running." +msgstr "" + +#: c-api/init.rst:398 +msgid "" +"Normally the return value is ``0``. If there were errors during finalization " "(flushing buffered data), ``-1`` is returned." msgstr "" -#: c-api/init.rst:395 +#: c-api/init.rst:402 msgid "" "This function is provided for a number of reasons. An embedding application " "might want to restart Python without having to restart the application " @@ -572,7 +584,7 @@ msgid "" "Python before exiting from the application." msgstr "" -#: c-api/init.rst:403 +#: c-api/init.rst:410 msgid "" "**Bugs and caveats:** The destruction of modules and objects in modules is " "done in random order; this may cause destructors (:meth:`~object.__del__` " @@ -587,74 +599,73 @@ msgid "" "more than once." msgstr "" -#: c-api/init.rst:414 +#: c-api/init.rst:421 msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"_PySys_ClearAuditHooks`` with no arguments." +"Raises an auditing event cpython._PySys_ClearAuditHooks with no arguments." msgstr "" -#: c-api/init.rst:420 +#: c-api/init.rst:427 msgid "" "This is a backwards-compatible version of :c:func:`Py_FinalizeEx` that " "disregards the return value." msgstr "" -#: c-api/init.rst:425 +#: c-api/init.rst:432 msgid "Process-wide parameters" msgstr "" -#: c-api/init.rst:435 +#: c-api/init.rst:442 msgid "" "This API is kept for backward compatibility: setting :c:member:`PyConfig." "stdio_encoding` and :c:member:`PyConfig.stdio_errors` should be used " "instead, see :ref:`Python Initialization Configuration `." msgstr "" -#: c-api/init.rst:440 +#: c-api/init.rst:447 msgid "" "This function should be called before :c:func:`Py_Initialize`, if it is " "called at all. It specifies which encoding and error handling to use with " "standard IO, with the same meanings as in :func:`str.encode`." msgstr "" -#: c-api/init.rst:444 +#: c-api/init.rst:451 msgid "" "It overrides :envvar:`PYTHONIOENCODING` values, and allows embedding code to " "control IO encoding when the environment variable does not work." msgstr "" -#: c-api/init.rst:447 +#: c-api/init.rst:454 msgid "" "*encoding* and/or *errors* may be ``NULL`` to use :envvar:`PYTHONIOENCODING` " "and/or default values (depending on other settings)." msgstr "" -#: c-api/init.rst:451 +#: c-api/init.rst:458 msgid "" "Note that :data:`sys.stderr` always uses the \"backslashreplace\" error " "handler, regardless of this (or any other) setting." msgstr "" -#: c-api/init.rst:454 +#: c-api/init.rst:461 msgid "" "If :c:func:`Py_FinalizeEx` is called, this function will need to be called " "again in order to affect subsequent calls to :c:func:`Py_Initialize`." msgstr "" -#: c-api/init.rst:457 +#: c-api/init.rst:464 msgid "" "Returns ``0`` if successful, a nonzero value on error (e.g. calling after " "the interpreter has already been initialized)." msgstr "" -#: c-api/init.rst:472 +#: c-api/init.rst:479 msgid "" "This API is kept for backward compatibility: setting :c:member:`PyConfig." "program_name` should be used instead, see :ref:`Python Initialization " "Configuration `." msgstr "" -#: c-api/init.rst:476 +#: c-api/init.rst:483 msgid "" "This function should be called before :c:func:`Py_Initialize` is called for " "the first time, if it is called at all. It tells the interpreter the value " @@ -668,30 +679,30 @@ msgid "" "this storage." msgstr "" -#: c-api/init.rst:487 +#: c-api/init.rst:494 msgid "" "Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a :c:expr:" "`wchar_t *` string." msgstr "" -#: c-api/init.rst:497 +#: c-api/init.rst:504 msgid "" "Return the program name set with :c:func:`Py_SetProgramName`, or the " "default. The returned string points into static storage; the caller should " "not modify its value." msgstr "" -#: c-api/init.rst:520 c-api/init.rst:580 c-api/init.rst:827 +#: c-api/init.rst:527 c-api/init.rst:587 c-api/init.rst:834 msgid "" "This function should not be called before :c:func:`Py_Initialize`, otherwise " "it returns ``NULL``." msgstr "" -#: c-api/init.rst:523 c-api/init.rst:583 c-api/init.rst:830 +#: c-api/init.rst:530 c-api/init.rst:590 c-api/init.rst:837 msgid "It now returns ``NULL`` if called before :c:func:`Py_Initialize`." msgstr "" -#: c-api/init.rst:510 +#: c-api/init.rst:517 msgid "" "Return the *prefix* for installed platform-independent files. This is " "derived through a number of complicated rules from the program name set " @@ -705,7 +716,7 @@ msgid "" "also the next function." msgstr "" -#: c-api/init.rst:529 +#: c-api/init.rst:536 msgid "" "Return the *exec-prefix* for installed platform-*dependent* files. This is " "derived through a number of complicated rules from the program name set " @@ -719,7 +730,7 @@ msgid "" "on Unix." msgstr "" -#: c-api/init.rst:539 +#: c-api/init.rst:546 msgid "" "Background: The exec-prefix differs from the prefix when platform dependent " "files (such as executables and shared libraries) are installed in a " @@ -728,7 +739,7 @@ msgid "" "independent may be installed in :file:`/usr/local`." msgstr "" -#: c-api/init.rst:545 +#: c-api/init.rst:552 msgid "" "Generally speaking, a platform is a combination of hardware and software " "families, e.g. Sparc machines running the Solaris 2.x operating system are " @@ -742,7 +753,7 @@ msgid "" "independent from the Python version by which they were compiled!)." msgstr "" -#: c-api/init.rst:556 +#: c-api/init.rst:563 msgid "" "System administrators will know how to configure the :program:`mount` or :" "program:`automount` programs to share :file:`/usr/local` between platforms " @@ -750,7 +761,7 @@ msgid "" "platform." msgstr "" -#: c-api/init.rst:574 +#: c-api/init.rst:581 msgid "" "Return the full program name of the Python executable; this is computed as " "a side-effect of deriving the default module search path from the program " @@ -759,7 +770,7 @@ msgid "" "available to Python code as ``sys.executable``." msgstr "" -#: c-api/init.rst:594 +#: c-api/init.rst:601 msgid "" "Return the default module search path; this is computed from the program " "name (set by :c:func:`Py_SetProgramName` above) and some environment " @@ -772,7 +783,7 @@ msgid "" "for loading modules." msgstr "" -#: c-api/init.rst:620 +#: c-api/init.rst:627 msgid "" "This API is kept for backward compatibility: setting :c:member:`PyConfig." "module_search_paths` and :c:member:`PyConfig.module_search_paths_set` should " @@ -780,7 +791,7 @@ msgid "" "config>`." msgstr "" -#: c-api/init.rst:625 +#: c-api/init.rst:632 msgid "" "Set the default module search path. If this function is called before :c:" "func:`Py_Initialize`, then :c:func:`Py_GetPath` won't attempt to compute a " @@ -791,7 +802,7 @@ msgid "" "on Windows." msgstr "" -#: c-api/init.rst:633 +#: c-api/init.rst:640 msgid "" "This also causes :data:`sys.executable` to be set to the program full path " "(see :c:func:`Py_GetProgramFullPath`) and for :data:`sys.prefix` and :data:" @@ -799,31 +810,31 @@ msgid "" "required after calling :c:func:`Py_Initialize`." msgstr "" -#: c-api/init.rst:753 c-api/init.rst:815 +#: c-api/init.rst:760 c-api/init.rst:822 msgid "" "Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a :c:expr:" "`wchar_*` string." msgstr "" -#: c-api/init.rst:641 +#: c-api/init.rst:648 msgid "" "The path argument is copied internally, so the caller may free it after the " "call completes." msgstr "" -#: c-api/init.rst:644 +#: c-api/init.rst:651 msgid "" "The program full path is now used for :data:`sys.executable`, instead of the " "program name." msgstr "" -#: c-api/init.rst:653 +#: c-api/init.rst:660 msgid "" "Return the version of this Python interpreter. This is a string that looks " "something like ::" msgstr "" -#: c-api/init.rst:660 +#: c-api/init.rst:667 msgid "" "The first word (up to the first space character) is the current Python " "version; the first characters are the major and minor version separated by a " @@ -832,11 +843,11 @@ msgid "" "version`." msgstr "" -#: c-api/init.rst:665 +#: c-api/init.rst:672 msgid "See also the :c:var:`Py_Version` constant." msgstr "" -#: c-api/init.rst:672 +#: c-api/init.rst:679 msgid "" "Return the platform identifier for the current platform. On Unix, this is " "formed from the \"official\" name of the operating system, converted to " @@ -847,42 +858,42 @@ msgid "" "available to Python code as ``sys.platform``." msgstr "" -#: c-api/init.rst:683 +#: c-api/init.rst:690 msgid "" "Return the official copyright string for the current Python version, for " "example" msgstr "" -#: c-api/init.rst:685 +#: c-api/init.rst:692 msgid "``'Copyright 1991-1995 Stichting Mathematisch Centrum, Amsterdam'``" msgstr "" -#: c-api/init.rst:689 +#: c-api/init.rst:696 msgid "" "The returned string points into static storage; the caller should not modify " "its value. The value is available to Python code as ``sys.copyright``." msgstr "" -#: c-api/init.rst:695 +#: c-api/init.rst:702 msgid "" "Return an indication of the compiler used to build the current Python " "version, in square brackets, for example::" msgstr "" -#: c-api/init.rst:716 +#: c-api/init.rst:723 msgid "" "The returned string points into static storage; the caller should not modify " "its value. The value is available to Python code as part of the variable " "``sys.version``." msgstr "" -#: c-api/init.rst:709 +#: c-api/init.rst:716 msgid "" "Return information about the sequence number and build date and time of the " "current Python interpreter instance, for example ::" msgstr "" -#: c-api/init.rst:728 +#: c-api/init.rst:735 msgid "" "This API is kept for backward compatibility: setting :c:member:`PyConfig." "argv`, :c:member:`PyConfig.parse_argv` and :c:member:`PyConfig.safe_path` " @@ -890,7 +901,7 @@ msgid "" "config>`." msgstr "" -#: c-api/init.rst:733 +#: c-api/init.rst:740 msgid "" "Set :data:`sys.argv` based on *argc* and *argv*. These parameters are " "similar to those passed to the program's :c:func:`main` function with the " @@ -901,80 +912,80 @@ msgid "" "fatal condition is signalled using :c:func:`Py_FatalError`." msgstr "" -#: c-api/init.rst:741 +#: c-api/init.rst:748 msgid "" "If *updatepath* is zero, this is all the function does. If *updatepath* is " "non-zero, the function also modifies :data:`sys.path` according to the " "following algorithm:" msgstr "" -#: c-api/init.rst:745 +#: c-api/init.rst:752 msgid "" "If the name of an existing script is passed in ``argv[0]``, the absolute " "path of the directory where the script is located is prepended to :data:`sys." "path`." msgstr "" -#: c-api/init.rst:748 +#: c-api/init.rst:755 msgid "" "Otherwise (that is, if *argc* is ``0`` or ``argv[0]`` doesn't point to an " "existing file name), an empty string is prepended to :data:`sys.path`, which " "is the same as prepending the current working directory (``\".\"``)." msgstr "" -#: c-api/init.rst:792 +#: c-api/init.rst:799 msgid "" "See also :c:member:`PyConfig.orig_argv` and :c:member:`PyConfig.argv` " "members of the :ref:`Python Initialization Configuration `." msgstr "" -#: c-api/init.rst:760 +#: c-api/init.rst:767 msgid "" "It is recommended that applications embedding the Python interpreter for " "purposes other than executing a single script pass ``0`` as *updatepath*, " "and update :data:`sys.path` themselves if desired. See :cve:`2008-5983`." msgstr "" -#: c-api/init.rst:765 +#: c-api/init.rst:772 msgid "" "On versions before 3.1.3, you can achieve the same effect by manually " "popping the first :data:`sys.path` element after having called :c:func:" "`PySys_SetArgv`, for example using::" msgstr "" -#: c-api/init.rst:781 +#: c-api/init.rst:788 msgid "" "This API is kept for backward compatibility: setting :c:member:`PyConfig." "argv` and :c:member:`PyConfig.parse_argv` should be used instead, see :ref:" "`Python Initialization Configuration `." msgstr "" -#: c-api/init.rst:785 +#: c-api/init.rst:792 msgid "" "This function works like :c:func:`PySys_SetArgvEx` with *updatepath* set to " "``1`` unless the :program:`python` interpreter was started with the :option:" "`-I`." msgstr "" -#: c-api/init.rst:795 +#: c-api/init.rst:802 msgid "The *updatepath* value depends on :option:`-I`." msgstr "" -#: c-api/init.rst:802 +#: c-api/init.rst:809 msgid "" "This API is kept for backward compatibility: setting :c:member:`PyConfig." "home` should be used instead, see :ref:`Python Initialization Configuration " "`." msgstr "" -#: c-api/init.rst:806 +#: c-api/init.rst:813 msgid "" "Set the default \"home\" directory, that is, the location of the standard " "Python libraries. See :envvar:`PYTHONHOME` for the meaning of the argument " "string." msgstr "" -#: c-api/init.rst:810 +#: c-api/init.rst:817 msgid "" "The argument should point to a zero-terminated character string in static " "storage whose contents will not change for the duration of the program's " @@ -982,18 +993,18 @@ msgid "" "this storage." msgstr "" -#: c-api/init.rst:823 +#: c-api/init.rst:830 msgid "" "Return the default \"home\", that is, the value set by a previous call to :c:" "func:`Py_SetPythonHome`, or the value of the :envvar:`PYTHONHOME` " "environment variable if it is set." msgstr "" -#: c-api/init.rst:837 +#: c-api/init.rst:844 msgid "Thread State and the Global Interpreter Lock" msgstr "" -#: c-api/init.rst:844 +#: c-api/init.rst:851 msgid "" "The Python interpreter is not fully thread-safe. In order to support multi-" "threaded Python programs, there's a global lock, called the :term:`global " @@ -1005,7 +1016,7 @@ msgid "" "once instead of twice." msgstr "" -#: c-api/init.rst:854 +#: c-api/init.rst:861 msgid "" "Therefore, the rule exists that only the thread that has acquired the :term:" "`GIL` may operate on Python objects or call Python/C API functions. In order " @@ -1015,7 +1026,7 @@ msgid "" "a file, so that other Python threads can run in the meantime." msgstr "" -#: c-api/init.rst:864 +#: c-api/init.rst:871 msgid "" "The Python interpreter keeps some thread-specific bookkeeping information " "inside a data structure called :c:type:`PyThreadState`. There's also one " @@ -1023,32 +1034,32 @@ msgid "" "retrieved using :c:func:`PyThreadState_Get`." msgstr "" -#: c-api/init.rst:870 +#: c-api/init.rst:877 msgid "Releasing the GIL from extension code" msgstr "" -#: c-api/init.rst:872 +#: c-api/init.rst:879 msgid "" "Most extension code manipulating the :term:`GIL` has the following simple " "structure::" msgstr "" -#: c-api/init.rst:881 +#: c-api/init.rst:888 msgid "This is so common that a pair of macros exists to simplify it::" msgstr "" -#: c-api/init.rst:891 +#: c-api/init.rst:898 msgid "" "The :c:macro:`Py_BEGIN_ALLOW_THREADS` macro opens a new block and declares a " "hidden local variable; the :c:macro:`Py_END_ALLOW_THREADS` macro closes the " "block." msgstr "" -#: c-api/init.rst:895 +#: c-api/init.rst:902 msgid "The block above expands to the following code::" msgstr "" -#: c-api/init.rst:907 +#: c-api/init.rst:914 msgid "" "Here is how these functions work: the global interpreter lock is used to " "protect the pointer to the current thread state. When releasing the lock " @@ -1059,7 +1070,7 @@ msgid "" "state, the lock must be acquired before storing the thread state pointer." msgstr "" -#: c-api/init.rst:916 +#: c-api/init.rst:923 msgid "" "Calling system I/O functions is the most common use case for releasing the " "GIL, but it can also be useful before calling long-running computations " @@ -1069,11 +1080,11 @@ msgid "" "compressing or hashing data." msgstr "" -#: c-api/init.rst:927 +#: c-api/init.rst:934 msgid "Non-Python created threads" msgstr "" -#: c-api/init.rst:929 +#: c-api/init.rst:936 msgid "" "When threads are created using the dedicated Python APIs (such as the :mod:" "`threading` module), a thread state is automatically associated to them and " @@ -1083,7 +1094,7 @@ msgid "" "for them." msgstr "" -#: c-api/init.rst:936 +#: c-api/init.rst:943 msgid "" "If you need to call Python code from these threads (often this will be part " "of a callback API provided by the aforementioned third-party library), you " @@ -1094,14 +1105,14 @@ msgid "" "finally free the thread state data structure." msgstr "" -#: c-api/init.rst:944 +#: c-api/init.rst:951 msgid "" "The :c:func:`PyGILState_Ensure` and :c:func:`PyGILState_Release` functions " "do all of the above automatically. The typical idiom for calling into " "Python from a C thread is::" msgstr "" -#: c-api/init.rst:958 +#: c-api/init.rst:965 msgid "" "Note that the ``PyGILState_*`` functions assume there is only one global " "interpreter (created automatically by :c:func:`Py_Initialize`). Python " @@ -1110,11 +1121,11 @@ msgid "" "``PyGILState_*`` API is unsupported." msgstr "" -#: c-api/init.rst:968 +#: c-api/init.rst:975 msgid "Cautions about fork()" msgstr "" -#: c-api/init.rst:970 +#: c-api/init.rst:977 msgid "" "Another important thing to note about threads is their behaviour in the face " "of the C :c:func:`fork` call. On most systems with :c:func:`fork`, after a " @@ -1123,7 +1134,7 @@ msgid "" "CPython's runtime." msgstr "" -#: c-api/init.rst:976 +#: c-api/init.rst:983 msgid "" "The fact that only the \"current\" thread remains means any locks held by " "other threads will never be released. Python solves this for :func:`os.fork` " @@ -1140,7 +1151,7 @@ msgid "" "locks, but is not always able to." msgstr "" -#: c-api/init.rst:991 +#: c-api/init.rst:998 msgid "" "The fact that all other threads go away also means that CPython's runtime " "state there must be cleaned up properly, which :func:`os.fork` does. This " @@ -1153,17 +1164,17 @@ msgid "" "called immediately after." msgstr "" -#: c-api/init.rst:1004 +#: c-api/init.rst:1011 msgid "High-level API" msgstr "" -#: c-api/init.rst:1006 +#: c-api/init.rst:1013 msgid "" "These are the most commonly used types and functions when writing C " "extension code, or when embedding the Python interpreter:" msgstr "" -#: c-api/init.rst:1011 +#: c-api/init.rst:1018 msgid "" "This data structure represents the state shared by a number of cooperating " "threads. Threads belonging to the same interpreter share their module " @@ -1171,7 +1182,7 @@ msgid "" "in this structure." msgstr "" -#: c-api/init.rst:1016 +#: c-api/init.rst:1023 msgid "" "Threads belonging to different interpreters initially share nothing, except " "process state like available memory, open file descriptors and such. The " @@ -1179,52 +1190,52 @@ msgid "" "which interpreter they belong." msgstr "" -#: c-api/init.rst:1024 +#: c-api/init.rst:1031 msgid "" "This data structure represents the state of a single thread. The only " "public data member is:" msgstr "" -#: c-api/init.rst:1029 +#: c-api/init.rst:1036 msgid "This thread's interpreter state." msgstr "" -#: c-api/init.rst:1040 +#: c-api/init.rst:1047 msgid "Deprecated function which does nothing." msgstr "" -#: c-api/init.rst:1042 +#: c-api/init.rst:1049 msgid "" "In Python 3.6 and older, this function created the GIL if it didn't exist." msgstr "" -#: c-api/init.rst:1044 +#: c-api/init.rst:1051 msgid "The function now does nothing." msgstr "" -#: c-api/init.rst:1047 +#: c-api/init.rst:1054 msgid "" "This function is now called by :c:func:`Py_Initialize()`, so you don't have " "to call it yourself anymore." msgstr "" -#: c-api/init.rst:1051 +#: c-api/init.rst:1058 msgid "" "This function cannot be called before :c:func:`Py_Initialize()` anymore." msgstr "" -#: c-api/init.rst:1061 +#: c-api/init.rst:1068 msgid "" "Returns a non-zero value if :c:func:`PyEval_InitThreads` has been called. " "This function can be called without holding the GIL, and therefore can be " "used to avoid calls to the locking API when running single-threaded." msgstr "" -#: c-api/init.rst:1065 +#: c-api/init.rst:1072 msgid "The :term:`GIL` is now initialized by :c:func:`Py_Initialize()`." msgstr "" -#: c-api/init.rst:1073 +#: c-api/init.rst:1080 msgid "" "Release the global interpreter lock (if it has been created) and reset the " "thread state to ``NULL``, returning the previous thread state (which is not " @@ -1232,7 +1243,7 @@ msgid "" "acquired it." msgstr "" -#: c-api/init.rst:1081 +#: c-api/init.rst:1088 msgid "" "Acquire the global interpreter lock (if it has been created) and set the " "thread state to *tstate*, which must not be ``NULL``. If the lock has been " @@ -1240,7 +1251,7 @@ msgid "" "ensues." msgstr "" -#: c-api/init.rst:1133 c-api/init.rst:1415 +#: c-api/init.rst:1140 c-api/init.rst:1422 msgid "" "Calling this function from a thread when the runtime is finalizing will " "terminate the thread, even if the thread was not created by Python. You can " @@ -1249,27 +1260,27 @@ msgid "" "avoid unwanted termination." msgstr "" -#: c-api/init.rst:1095 +#: c-api/init.rst:1102 msgid "" "Return the current thread state. The global interpreter lock must be held. " "When the current thread state is ``NULL``, this issues a fatal error (so " "that the caller needn't check for ``NULL``)." msgstr "" -#: c-api/init.rst:1102 +#: c-api/init.rst:1109 msgid "" "Swap the current thread state with the thread state given by the argument " "*tstate*, which may be ``NULL``. The global interpreter lock must be held " "and is not released." msgstr "" -#: c-api/init.rst:1107 +#: c-api/init.rst:1114 msgid "" "The following functions use thread-local storage, and are not compatible " "with sub-interpreters:" msgstr "" -#: c-api/init.rst:1112 +#: c-api/init.rst:1119 msgid "" "Ensure that the current thread is ready to call the Python C API regardless " "of the current state of Python, or of the global interpreter lock. This may " @@ -1282,7 +1293,7 @@ msgid "" "is acceptable." msgstr "" -#: c-api/init.rst:1122 +#: c-api/init.rst:1129 msgid "" "The return value is an opaque \"handle\" to the thread state when :c:func:" "`PyGILState_Ensure` was called, and must be passed to :c:func:" @@ -1292,13 +1303,13 @@ msgid "" "func:`PyGILState_Release`." msgstr "" -#: c-api/init.rst:1129 +#: c-api/init.rst:1136 msgid "" "When the function returns, the current thread will hold the GIL and be able " "to call arbitrary Python code. Failure is a fatal error." msgstr "" -#: c-api/init.rst:1141 +#: c-api/init.rst:1148 msgid "" "Release any resources previously acquired. After this call, Python's state " "will be the same as it was prior to the corresponding :c:func:" @@ -1306,13 +1317,13 @@ msgid "" "caller, hence the use of the GILState API)." msgstr "" -#: c-api/init.rst:1146 +#: c-api/init.rst:1153 msgid "" "Every call to :c:func:`PyGILState_Ensure` must be matched by a call to :c:" "func:`PyGILState_Release` on the same thread." msgstr "" -#: c-api/init.rst:1152 +#: c-api/init.rst:1159 msgid "" "Get the current thread state for this thread. May return ``NULL`` if no " "GILState API has been used on the current thread. Note that the main thread " @@ -1320,7 +1331,7 @@ msgid "" "made on the main thread. This is mainly a helper/diagnostic function." msgstr "" -#: c-api/init.rst:1160 +#: c-api/init.rst:1167 msgid "" "Return ``1`` if the current thread is holding the GIL and ``0`` otherwise. " "This function can be called from any thread at any time. Only if it has had " @@ -1331,13 +1342,13 @@ msgid "" "otherwise behave differently." msgstr "" -#: c-api/init.rst:1172 +#: c-api/init.rst:1179 msgid "" "The following macros are normally used without a trailing semicolon; look " "for example usage in the Python source distribution." msgstr "" -#: c-api/init.rst:1178 +#: c-api/init.rst:1185 msgid "" "This macro expands to ``{ PyThreadState *_save; _save = PyEval_SaveThread();" "``. Note that it contains an opening brace; it must be matched with a " @@ -1345,7 +1356,7 @@ msgid "" "discussion of this macro." msgstr "" -#: c-api/init.rst:1186 +#: c-api/init.rst:1193 msgid "" "This macro expands to ``PyEval_RestoreThread(_save); }``. Note that it " "contains a closing brace; it must be matched with an earlier :c:macro:" @@ -1353,91 +1364,89 @@ msgid "" "macro." msgstr "" -#: c-api/init.rst:1194 +#: c-api/init.rst:1201 msgid "" "This macro expands to ``PyEval_RestoreThread(_save);``: it is equivalent to :" "c:macro:`Py_END_ALLOW_THREADS` without the closing brace." msgstr "" -#: c-api/init.rst:1200 +#: c-api/init.rst:1207 msgid "" "This macro expands to ``_save = PyEval_SaveThread();``: it is equivalent to :" "c:macro:`Py_BEGIN_ALLOW_THREADS` without the opening brace and variable " "declaration." msgstr "" -#: c-api/init.rst:1206 +#: c-api/init.rst:1213 msgid "Low-level API" msgstr "" -#: c-api/init.rst:1208 +#: c-api/init.rst:1215 msgid "" "All of the following functions must be called after :c:func:`Py_Initialize`." msgstr "" -#: c-api/init.rst:1210 +#: c-api/init.rst:1217 msgid ":c:func:`Py_Initialize()` now initializes the :term:`GIL`." msgstr "" -#: c-api/init.rst:1216 +#: c-api/init.rst:1223 msgid "" "Create a new interpreter state object. The global interpreter lock need not " "be held, but may be held if it is necessary to serialize calls to this " "function." msgstr "" -#: c-api/init.rst:1220 +#: c-api/init.rst:1227 msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"PyInterpreterState_New`` with no arguments." +"Raises an auditing event cpython.PyInterpreterState_New with no arguments." msgstr "" -#: c-api/init.rst:1225 +#: c-api/init.rst:1232 msgid "" "Reset all information in an interpreter state object. The global " "interpreter lock must be held." msgstr "" -#: c-api/init.rst:1228 +#: c-api/init.rst:1235 msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"PyInterpreterState_Clear`` with no arguments." +"Raises an auditing event cpython.PyInterpreterState_Clear with no arguments." msgstr "" -#: c-api/init.rst:1233 +#: c-api/init.rst:1240 msgid "" "Destroy an interpreter state object. The global interpreter lock need not " "be held. The interpreter state must have been reset with a previous call " "to :c:func:`PyInterpreterState_Clear`." msgstr "" -#: c-api/init.rst:1240 +#: c-api/init.rst:1247 msgid "" "Create a new thread state object belonging to the given interpreter object. " "The global interpreter lock need not be held, but may be held if it is " "necessary to serialize calls to this function." msgstr "" -#: c-api/init.rst:1247 +#: c-api/init.rst:1254 msgid "" "Reset all information in a thread state object. The global interpreter lock " "must be held." msgstr "" -#: c-api/init.rst:1250 +#: c-api/init.rst:1257 msgid "" "This function now calls the :c:member:`PyThreadState.on_delete` callback. " "Previously, that happened in :c:func:`PyThreadState_Delete`." msgstr "" -#: c-api/init.rst:1257 +#: c-api/init.rst:1264 msgid "" "Destroy a thread state object. The global interpreter lock need not be " "held. The thread state must have been reset with a previous call to :c:func:" "`PyThreadState_Clear`." msgstr "" -#: c-api/init.rst:1264 +#: c-api/init.rst:1271 msgid "" "Destroy the current thread state and release the global interpreter lock. " "Like :c:func:`PyThreadState_Delete`, the global interpreter lock need not be " @@ -1445,118 +1454,118 @@ msgid "" "`PyThreadState_Clear`." msgstr "" -#: c-api/init.rst:1272 +#: c-api/init.rst:1279 msgid "Get the current frame of the Python thread state *tstate*." msgstr "" -#: c-api/init.rst:1274 +#: c-api/init.rst:1281 msgid "" "Return a :term:`strong reference`. Return ``NULL`` if no frame is currently " "executing." msgstr "" -#: c-api/init.rst:1277 +#: c-api/init.rst:1284 msgid "See also :c:func:`PyEval_GetFrame`." msgstr "" -#: c-api/init.rst:1288 c-api/init.rst:1297 +#: c-api/init.rst:1295 c-api/init.rst:1304 msgid "*tstate* must not be ``NULL``." msgstr "" -#: c-api/init.rst:1286 +#: c-api/init.rst:1293 msgid "" "Get the unique thread state identifier of the Python thread state *tstate*." msgstr "" -#: c-api/init.rst:1295 +#: c-api/init.rst:1302 msgid "Get the interpreter of the Python thread state *tstate*." msgstr "" -#: c-api/init.rst:1304 +#: c-api/init.rst:1311 msgid "Suspend tracing and profiling in the Python thread state *tstate*." msgstr "" -#: c-api/init.rst:1306 +#: c-api/init.rst:1313 msgid "Resume them using the :c:func:`PyThreadState_LeaveTracing` function." msgstr "" -#: c-api/init.rst:1313 +#: c-api/init.rst:1320 msgid "" "Resume tracing and profiling in the Python thread state *tstate* suspended " "by the :c:func:`PyThreadState_EnterTracing` function." msgstr "" -#: c-api/init.rst:1316 +#: c-api/init.rst:1323 msgid "" "See also :c:func:`PyEval_SetTrace` and :c:func:`PyEval_SetProfile` functions." msgstr "" -#: c-api/init.rst:1324 +#: c-api/init.rst:1331 msgid "Get the current interpreter." msgstr "" -#: c-api/init.rst:1326 +#: c-api/init.rst:1333 msgid "" "Issue a fatal error if there no current Python thread state or no current " "interpreter. It cannot return NULL." msgstr "" -#: c-api/init.rst:1339 +#: c-api/init.rst:1346 msgid "The caller must hold the GIL." msgstr "" -#: c-api/init.rst:1336 +#: c-api/init.rst:1343 msgid "" "Return the interpreter's unique ID. If there was any error in doing so then " "``-1`` is returned and an error is set." msgstr "" -#: c-api/init.rst:1346 +#: c-api/init.rst:1353 msgid "" "Return a dictionary in which interpreter-specific data may be stored. If " "this function returns ``NULL`` then no exception has been raised and the " "caller should assume no interpreter-specific dict is available." msgstr "" -#: c-api/init.rst:1350 +#: c-api/init.rst:1357 msgid "" "This is not a replacement for :c:func:`PyModule_GetState()`, which " "extensions should use to store interpreter-specific state information." msgstr "" -#: c-api/init.rst:1357 +#: c-api/init.rst:1364 msgid "Type of a frame evaluation function." msgstr "" -#: c-api/init.rst:1359 +#: c-api/init.rst:1366 msgid "" "The *throwflag* parameter is used by the ``throw()`` method of generators: " "if non-zero, handle the current exception." msgstr "" -#: c-api/init.rst:1362 +#: c-api/init.rst:1369 msgid "The function now takes a *tstate* parameter." msgstr "" -#: c-api/init.rst:1365 +#: c-api/init.rst:1372 msgid "" "The *frame* parameter changed from ``PyFrameObject*`` to " "``_PyInterpreterFrame*``." msgstr "" -#: c-api/init.rst:1370 +#: c-api/init.rst:1377 msgid "Get the frame evaluation function." msgstr "" -#: c-api/init.rst:1380 +#: c-api/init.rst:1387 msgid "See the :pep:`523` \"Adding a frame evaluation API to CPython\"." msgstr "" -#: c-api/init.rst:1378 +#: c-api/init.rst:1385 msgid "Set the frame evaluation function." msgstr "" -#: c-api/init.rst:1387 +#: c-api/init.rst:1394 msgid "" "Return a dictionary in which extensions can store thread-specific state " "information. Each extension should use a unique key to use to store state " @@ -1565,7 +1574,7 @@ msgid "" "raised and the caller should assume no current thread state is available." msgstr "" -#: c-api/init.rst:1396 +#: c-api/init.rst:1403 msgid "" "Asynchronously raise an exception in a thread. The *id* argument is the " "thread id of the target thread; *exc* is the exception object to be raised. " @@ -1577,33 +1586,33 @@ msgid "" "raises no exceptions." msgstr "" -#: c-api/init.rst:1404 +#: c-api/init.rst:1411 msgid "" "The type of the *id* parameter changed from :c:expr:`long` to :c:expr:" "`unsigned long`." msgstr "" -#: c-api/init.rst:1410 +#: c-api/init.rst:1417 msgid "" "Acquire the global interpreter lock and set the current thread state to " "*tstate*, which must not be ``NULL``. The lock must have been created " "earlier. If this thread already has the lock, deadlock ensues." msgstr "" -#: c-api/init.rst:1459 +#: c-api/init.rst:1466 msgid "" "Updated to be consistent with :c:func:`PyEval_RestoreThread`, :c:func:" "`Py_END_ALLOW_THREADS`, and :c:func:`PyGILState_Ensure`, and terminate the " "current thread if called while the interpreter is finalizing." msgstr "" -#: c-api/init.rst:1426 +#: c-api/init.rst:1433 msgid "" ":c:func:`PyEval_RestoreThread` is a higher-level function which is always " "available (even when threads have not been initialized)." msgstr "" -#: c-api/init.rst:1432 +#: c-api/init.rst:1439 msgid "" "Reset the current thread state to ``NULL`` and release the global " "interpreter lock. The lock must have been created earlier and must be held " @@ -1612,25 +1621,25 @@ msgid "" "isn't, a fatal error is reported." msgstr "" -#: c-api/init.rst:1438 +#: c-api/init.rst:1445 msgid "" ":c:func:`PyEval_SaveThread` is a higher-level function which is always " "available (even when threads have not been initialized)." msgstr "" -#: c-api/init.rst:1444 +#: c-api/init.rst:1451 msgid "" "Acquire the global interpreter lock. The lock must have been created " "earlier. If this thread already has the lock, a deadlock ensues." msgstr "" -#: c-api/init.rst:1447 +#: c-api/init.rst:1454 msgid "" "This function does not update the current thread state. Please use :c:func:" "`PyEval_RestoreThread` or :c:func:`PyEval_AcquireThread` instead." msgstr "" -#: c-api/init.rst:1453 +#: c-api/init.rst:1460 msgid "" "Calling this function from a thread when the runtime is finalizing will " "terminate the thread, even if the thread was not created by Python. You can " @@ -1639,23 +1648,23 @@ msgid "" "avoid unwanted termination." msgstr "" -#: c-api/init.rst:1467 +#: c-api/init.rst:1474 msgid "" "Release the global interpreter lock. The lock must have been created " "earlier." msgstr "" -#: c-api/init.rst:1469 +#: c-api/init.rst:1476 msgid "" "This function does not update the current thread state. Please use :c:func:" "`PyEval_SaveThread` or :c:func:`PyEval_ReleaseThread` instead." msgstr "" -#: c-api/init.rst:1478 +#: c-api/init.rst:1485 msgid "Sub-interpreter support" msgstr "" -#: c-api/init.rst:1480 +#: c-api/init.rst:1487 msgid "" "While in most uses, you will only embed a single Python interpreter, there " "are cases where you need to create several independent interpreters in the " @@ -1663,7 +1672,7 @@ msgid "" "to do that." msgstr "" -#: c-api/init.rst:1485 +#: c-api/init.rst:1492 msgid "" "The \"main\" interpreter is the first one created when the runtime " "initializes. It is usually the only Python interpreter in a process. Unlike " @@ -1674,31 +1683,31 @@ msgid "" "returns a pointer to its state." msgstr "" -#: c-api/init.rst:1492 +#: c-api/init.rst:1499 msgid "" "You can switch between sub-interpreters using the :c:func:" "`PyThreadState_Swap` function. You can create and destroy them using the " "following functions:" msgstr "" -#: c-api/init.rst:1498 +#: c-api/init.rst:1505 msgid "" "Structure containing most parameters to configure a sub-interpreter. Its " "values are used only in :c:func:`Py_NewInterpreterFromConfig` and never " "modified by the runtime." msgstr "" -#: c-api/init.rst:1504 +#: c-api/init.rst:1511 msgid "Structure fields:" msgstr "" -#: c-api/init.rst:1508 +#: c-api/init.rst:1515 msgid "" "If this is ``0`` then the sub-interpreter will use its own \"object\" " "allocator state. Otherwise it will use (share) the main interpreter's." msgstr "" -#: c-api/init.rst:1512 +#: c-api/init.rst:1519 msgid "" "If this is ``0`` then :c:member:`~PyInterpreterConfig." "check_multi_interp_extensions` must be ``1`` (non-zero). If this is ``1`` " @@ -1706,44 +1715,44 @@ msgid "" "`PyInterpreterConfig_OWN_GIL`." msgstr "" -#: c-api/init.rst:1520 +#: c-api/init.rst:1527 msgid "" "If this is ``0`` then the runtime will not support forking the process in " "any thread where the sub-interpreter is currently active. Otherwise fork is " "unrestricted." msgstr "" -#: c-api/init.rst:1524 +#: c-api/init.rst:1531 msgid "" "Note that the :mod:`subprocess` module still works when fork is disallowed." msgstr "" -#: c-api/init.rst:1529 +#: c-api/init.rst:1536 msgid "" "If this is ``0`` then the runtime will not support replacing the current " "process via exec (e.g. :func:`os.execv`) in any thread where the sub-" "interpreter is currently active. Otherwise exec is unrestricted." msgstr "" -#: c-api/init.rst:1534 +#: c-api/init.rst:1541 msgid "" "Note that the :mod:`subprocess` module still works when exec is disallowed." msgstr "" -#: c-api/init.rst:1539 +#: c-api/init.rst:1546 msgid "" "If this is ``0`` then the sub-interpreter's :mod:`threading` module won't " "create threads. Otherwise threads are allowed." msgstr "" -#: c-api/init.rst:1545 +#: c-api/init.rst:1552 msgid "" "If this is ``0`` then the sub-interpreter's :mod:`threading` module won't " "create daemon threads. Otherwise daemon threads are allowed (as long as :c:" "member:`~PyInterpreterConfig.allow_threads` is non-zero)." msgstr "" -#: c-api/init.rst:1552 +#: c-api/init.rst:1559 msgid "" "If this is ``0`` then all extension modules may be imported, including " "legacy (single-phase init) modules, in any thread where the sub-interpreter " @@ -1752,37 +1761,37 @@ msgid "" "`Py_mod_multiple_interpreters`.)" msgstr "" -#: c-api/init.rst:1559 +#: c-api/init.rst:1566 msgid "" "This must be ``1`` (non-zero) if :c:member:`~PyInterpreterConfig." "use_main_obmalloc` is ``0``." msgstr "" -#: c-api/init.rst:1564 +#: c-api/init.rst:1571 msgid "" "This determines the operation of the GIL for the sub-interpreter. It may be " "one of the following:" msgstr "" -#: c-api/init.rst:1571 +#: c-api/init.rst:1578 msgid "Use the default selection (:c:macro:`PyInterpreterConfig_SHARED_GIL`)." msgstr "" -#: c-api/init.rst:1575 +#: c-api/init.rst:1582 msgid "Use (share) the main interpreter's GIL." msgstr "" -#: c-api/init.rst:1579 +#: c-api/init.rst:1586 msgid "Use the sub-interpreter's own GIL." msgstr "" -#: c-api/init.rst:1581 +#: c-api/init.rst:1588 msgid "" "If this is :c:macro:`PyInterpreterConfig_OWN_GIL` then :c:member:" "`PyInterpreterConfig.use_main_obmalloc` must be ``0``." msgstr "" -#: c-api/init.rst:1595 +#: c-api/init.rst:1602 msgid "" "Create a new sub-interpreter. This is an (almost) totally separate " "environment for the execution of Python code. In particular, the new " @@ -1795,13 +1804,13 @@ msgid "" "underlying file descriptors)." msgstr "" -#: c-api/init.rst:1605 +#: c-api/init.rst:1612 msgid "" "The given *config* controls the options with which the interpreter is " "initialized." msgstr "" -#: c-api/init.rst:1608 +#: c-api/init.rst:1615 msgid "" "Upon success, *tstate_p* will be set to the first thread state created in " "the new sub-interpreter. This thread state is made in the current thread " @@ -1812,7 +1821,7 @@ msgid "" "state." msgstr "" -#: c-api/init.rst:1617 +#: c-api/init.rst:1624 msgid "" "Like all other Python/C API functions, the global interpreter lock must be " "held before calling this function and is still held when it returns. " @@ -1824,13 +1833,13 @@ msgid "" "released here." msgstr "" -#: c-api/init.rst:1628 +#: c-api/init.rst:1635 msgid "" "Sub-interpreters are most effective when isolated from each other, with " "certain functionality restricted::" msgstr "" -#: c-api/init.rst:1642 +#: c-api/init.rst:1649 msgid "" "Note that the config is used only briefly and does not get modified. During " "initialization the config's values are converted into various :c:type:" @@ -1838,11 +1847,11 @@ msgid "" "internally on the :c:type:`PyInterpreterState`." msgstr "" -#: c-api/init.rst:1651 +#: c-api/init.rst:1658 msgid "Extension modules are shared between (sub-)interpreters as follows:" msgstr "" -#: c-api/init.rst:1653 +#: c-api/init.rst:1660 msgid "" "For modules using multi-phase initialization, e.g. :c:func:" "`PyModule_FromDefAndSpec`, a separate module object is created and " @@ -1850,7 +1859,7 @@ msgid "" "are shared between these module objects." msgstr "" -#: c-api/init.rst:1659 +#: c-api/init.rst:1666 msgid "" "For modules using single-phase initialization, e.g. :c:func:" "`PyModule_Create`, the first time a particular extension is imported, it is " @@ -1862,7 +1871,7 @@ msgid "" "might cause unwanted behavior (see `Bugs and caveats`_ below)." msgstr "" -#: c-api/init.rst:1670 +#: c-api/init.rst:1677 msgid "" "Note that this is different from what happens when an extension is imported " "after the interpreter has been completely re-initialized by calling :c:func:" @@ -1872,7 +1881,7 @@ msgid "" "shared between these modules." msgstr "" -#: c-api/init.rst:1690 +#: c-api/init.rst:1697 msgid "" "Create a new sub-interpreter. This is essentially just a wrapper around :c:" "func:`Py_NewInterpreterFromConfig` with a config that preserves the existing " @@ -1881,7 +1890,7 @@ msgid "" "single-phase init modules." msgstr "" -#: c-api/init.rst:1702 +#: c-api/init.rst:1709 msgid "" "Destroy the (sub-)interpreter represented by the given thread state. The " "given thread state must be the current thread state. See the discussion of " @@ -1891,17 +1900,17 @@ msgid "" "be held before calling this function. No GIL is held when it returns." msgstr "" -#: c-api/init.rst:1710 +#: c-api/init.rst:1717 msgid "" ":c:func:`Py_FinalizeEx` will destroy all sub-interpreters that haven't been " "explicitly destroyed at that point." msgstr "" -#: c-api/init.rst:1715 +#: c-api/init.rst:1722 msgid "A Per-Interpreter GIL" msgstr "" -#: c-api/init.rst:1717 +#: c-api/init.rst:1724 msgid "" "Using :c:func:`Py_NewInterpreterFromConfig` you can create a sub-interpreter " "that is completely isolated from other interpreters, including having its " @@ -1913,7 +1922,7 @@ msgid "" "just using threads. (See :pep:`554`.)" msgstr "" -#: c-api/init.rst:1727 +#: c-api/init.rst:1734 msgid "" "Using an isolated interpreter requires vigilance in preserving that " "isolation. That especially means not sharing any objects or mutable state " @@ -1927,7 +1936,7 @@ msgid "" "builtin objects." msgstr "" -#: c-api/init.rst:1738 +#: c-api/init.rst:1745 msgid "" "If you preserve isolation then you will have access to proper multi-core " "computing without the complications that come with free-threading. Failure " @@ -1935,7 +1944,7 @@ msgid "" "threading, including races and hard-to-debug crashes." msgstr "" -#: c-api/init.rst:1743 +#: c-api/init.rst:1750 msgid "" "Aside from that, one of the main challenges of using multiple isolated " "interpreters is how to communicate between them safely (not break isolation) " @@ -1945,11 +1954,11 @@ msgid "" "sharing) data between interpreters." msgstr "" -#: c-api/init.rst:1754 +#: c-api/init.rst:1761 msgid "Bugs and caveats" msgstr "" -#: c-api/init.rst:1756 +#: c-api/init.rst:1763 msgid "" "Because sub-interpreters (and the main interpreter) are part of the same " "process, the insulation between them isn't perfect --- for example, using " @@ -1962,7 +1971,7 @@ msgid "" "should be avoided if possible." msgstr "" -#: c-api/init.rst:1766 +#: c-api/init.rst:1773 msgid "" "Special care should be taken to avoid sharing user-defined functions, " "methods, instances or classes between sub-interpreters, since import " @@ -1971,7 +1980,7 @@ msgid "" "objects from which the above are reachable." msgstr "" -#: c-api/init.rst:1772 +#: c-api/init.rst:1779 msgid "" "Also note that combining this functionality with ``PyGILState_*`` APIs is " "delicate, because these APIs assume a bijection between Python thread states " @@ -1983,25 +1992,25 @@ msgid "" "created threads will probably be broken when using sub-interpreters." msgstr "" -#: c-api/init.rst:1783 +#: c-api/init.rst:1790 msgid "Asynchronous Notifications" msgstr "" -#: c-api/init.rst:1785 +#: c-api/init.rst:1792 msgid "" "A mechanism is provided to make asynchronous notifications to the main " "interpreter thread. These notifications take the form of a function pointer " "and a void pointer argument." msgstr "" -#: c-api/init.rst:1792 +#: c-api/init.rst:1799 msgid "" "Schedule a function to be called from the main interpreter thread. On " "success, ``0`` is returned and *func* is queued for being called in the main " "thread. On failure, ``-1`` is returned without setting any exception." msgstr "" -#: c-api/init.rst:1796 +#: c-api/init.rst:1803 msgid "" "When successfully queued, *func* will be *eventually* called from the main " "interpreter thread with the argument *arg*. It will be called " @@ -2009,17 +2018,17 @@ msgid "" "these conditions met:" msgstr "" -#: c-api/init.rst:1801 +#: c-api/init.rst:1808 msgid "on a :term:`bytecode` boundary;" msgstr "" -#: c-api/init.rst:1802 +#: c-api/init.rst:1809 msgid "" "with the main thread holding the :term:`global interpreter lock` (*func* can " "therefore use the full C API)." msgstr "" -#: c-api/init.rst:1805 +#: c-api/init.rst:1812 msgid "" "*func* must return ``0`` on success, or ``-1`` on failure with an exception " "set. *func* won't be interrupted to perform another asynchronous " @@ -2027,20 +2036,20 @@ msgid "" "if the global interpreter lock is released." msgstr "" -#: c-api/init.rst:1810 +#: c-api/init.rst:1817 msgid "" "This function doesn't need a current thread state to run, and it doesn't " "need the global interpreter lock." msgstr "" -#: c-api/init.rst:1813 +#: c-api/init.rst:1820 msgid "" "To call this function in a subinterpreter, the caller must hold the GIL. " "Otherwise, the function *func* can be scheduled to be called from the wrong " "interpreter." msgstr "" -#: c-api/init.rst:1818 +#: c-api/init.rst:1825 msgid "" "This is a low-level function, only useful for very special cases. There is " "no guarantee that *func* will be called as quick as possible. If the main " @@ -2050,7 +2059,7 @@ msgid "" "`PyGILState API`." msgstr "" -#: c-api/init.rst:1827 +#: c-api/init.rst:1834 msgid "" "If this function is called in a subinterpreter, the function *func* is now " "scheduled to be called from the subinterpreter, rather than being called " @@ -2058,18 +2067,18 @@ msgid "" "scheduled calls." msgstr "" -#: c-api/init.rst:1836 +#: c-api/init.rst:1843 msgid "Profiling and Tracing" msgstr "" -#: c-api/init.rst:1841 +#: c-api/init.rst:1848 msgid "" "The Python interpreter provides some low-level support for attaching " "profiling and execution tracing facilities. These are used for profiling, " "debugging, and coverage analysis tools." msgstr "" -#: c-api/init.rst:1845 +#: c-api/init.rst:1852 msgid "" "This C interface allows the profiling or tracing code to avoid the overhead " "of calling through Python-level callable objects, making a direct C function " @@ -2079,7 +2088,7 @@ msgid "" "reported to the Python-level trace functions in previous versions." msgstr "" -#: c-api/init.rst:1855 +#: c-api/init.rst:1862 msgid "" "The type of the trace function registered using :c:func:`PyEval_SetProfile` " "and :c:func:`PyEval_SetTrace`. The first parameter is the object passed to " @@ -2091,64 +2100,64 @@ msgid "" "value of *what*:" msgstr "" -#: c-api/init.rst:1864 +#: c-api/init.rst:1871 msgid "Value of *what*" msgstr "" -#: c-api/init.rst:1864 +#: c-api/init.rst:1871 msgid "Meaning of *arg*" msgstr "" -#: c-api/init.rst:1866 +#: c-api/init.rst:1873 msgid ":c:data:`PyTrace_CALL`" msgstr "" -#: c-api/init.rst:1871 c-api/init.rst:1882 +#: c-api/init.rst:1878 c-api/init.rst:1889 msgid "Always :c:data:`Py_None`." msgstr "" -#: c-api/init.rst:1868 +#: c-api/init.rst:1875 msgid ":c:data:`PyTrace_EXCEPTION`" msgstr "" -#: c-api/init.rst:1868 +#: c-api/init.rst:1875 msgid "Exception information as returned by :func:`sys.exc_info`." msgstr "" -#: c-api/init.rst:1871 +#: c-api/init.rst:1878 msgid ":c:data:`PyTrace_LINE`" msgstr "" -#: c-api/init.rst:1873 +#: c-api/init.rst:1880 msgid ":c:data:`PyTrace_RETURN`" msgstr "" -#: c-api/init.rst:1873 +#: c-api/init.rst:1880 msgid "" "Value being returned to the caller, or ``NULL`` if caused by an exception." msgstr "" -#: c-api/init.rst:1876 +#: c-api/init.rst:1883 msgid ":c:data:`PyTrace_C_CALL`" msgstr "" -#: c-api/init.rst:1878 c-api/init.rst:1880 +#: c-api/init.rst:1885 c-api/init.rst:1887 msgid "Function object being called." msgstr "" -#: c-api/init.rst:1878 +#: c-api/init.rst:1885 msgid ":c:data:`PyTrace_C_EXCEPTION`" msgstr "" -#: c-api/init.rst:1880 +#: c-api/init.rst:1887 msgid ":c:data:`PyTrace_C_RETURN`" msgstr "" -#: c-api/init.rst:1882 +#: c-api/init.rst:1889 msgid ":c:data:`PyTrace_OPCODE`" msgstr "" -#: c-api/init.rst:1887 +#: c-api/init.rst:1894 msgid "" "The value of the *what* parameter to a :c:type:`Py_tracefunc` function when " "a new call to a function or method is being reported, or a new entry into a " @@ -2157,7 +2166,7 @@ msgid "" "the corresponding frame." msgstr "" -#: c-api/init.rst:1896 +#: c-api/init.rst:1903 msgid "" "The value of the *what* parameter to a :c:type:`Py_tracefunc` function when " "an exception has been raised. The callback function is called with this " @@ -2169,7 +2178,7 @@ msgid "" "profiler." msgstr "" -#: c-api/init.rst:1907 +#: c-api/init.rst:1914 msgid "" "The value passed as the *what* parameter to a :c:type:`Py_tracefunc` " "function (but not a profiling function) when a line-number event is being " @@ -2177,31 +2186,31 @@ msgid "" "f_trace_lines` to *0* on that frame." msgstr "" -#: c-api/init.rst:1915 +#: c-api/init.rst:1922 msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when " "a call is about to return." msgstr "" -#: c-api/init.rst:1921 +#: c-api/init.rst:1928 msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when " "a C function is about to be called." msgstr "" -#: c-api/init.rst:1927 +#: c-api/init.rst:1934 msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when " "a C function has raised an exception." msgstr "" -#: c-api/init.rst:1933 +#: c-api/init.rst:1940 msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when " "a C function has returned." msgstr "" -#: c-api/init.rst:1939 +#: c-api/init.rst:1946 msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions (but " "not profiling functions) when a new opcode is about to be executed. This " @@ -2209,7 +2218,7 @@ msgid "" "attr:`~frame.f_trace_opcodes` to *1* on the frame." msgstr "" -#: c-api/init.rst:1947 +#: c-api/init.rst:1954 msgid "" "Set the profiler function to *func*. The *obj* parameter is passed to the " "function as its first parameter, and may be any Python object, or ``NULL``. " @@ -2219,28 +2228,28 @@ msgid "" "`PyTrace_LINE` :c:data:`PyTrace_OPCODE` and :c:data:`PyTrace_EXCEPTION`." msgstr "" -#: c-api/init.rst:1954 +#: c-api/init.rst:1961 msgid "See also the :func:`sys.setprofile` function." msgstr "" -#: c-api/init.rst:1963 c-api/init.rst:1989 +#: c-api/init.rst:1970 c-api/init.rst:1996 msgid "The caller must hold the :term:`GIL`." msgstr "" -#: c-api/init.rst:1960 +#: c-api/init.rst:1967 msgid "" "Like :c:func:`PyEval_SetProfile` but sets the profile function in all " "running threads belonging to the current interpreter instead of the setting " "it only on the current thread." msgstr "" -#: c-api/init.rst:1965 +#: c-api/init.rst:1972 msgid "" "As :c:func:`PyEval_SetProfile`, this function ignores any exceptions raised " "while setting the profile functions in all threads." msgstr "" -#: c-api/init.rst:1973 +#: c-api/init.rst:1980 msgid "" "Set the tracing function to *func*. This is similar to :c:func:" "`PyEval_SetProfile`, except the tracing function does receive line-number " @@ -2251,65 +2260,65 @@ msgid "" "*what* parameter." msgstr "" -#: c-api/init.rst:1980 +#: c-api/init.rst:1987 msgid "See also the :func:`sys.settrace` function." msgstr "" -#: c-api/init.rst:1986 +#: c-api/init.rst:1993 msgid "" "Like :c:func:`PyEval_SetTrace` but sets the tracing function in all running " "threads belonging to the current interpreter instead of the setting it only " "on the current thread." msgstr "" -#: c-api/init.rst:1991 +#: c-api/init.rst:1998 msgid "" "As :c:func:`PyEval_SetTrace`, this function ignores any exceptions raised " "while setting the trace functions in all threads." msgstr "" -#: c-api/init.rst:2000 +#: c-api/init.rst:2007 msgid "Advanced Debugger Support" msgstr "" -#: c-api/init.rst:2005 +#: c-api/init.rst:2012 msgid "" "These functions are only intended to be used by advanced debugging tools." msgstr "" -#: c-api/init.rst:2010 +#: c-api/init.rst:2017 msgid "" "Return the interpreter state object at the head of the list of all such " "objects." msgstr "" -#: c-api/init.rst:2015 +#: c-api/init.rst:2022 msgid "Return the main interpreter state object." msgstr "" -#: c-api/init.rst:2020 +#: c-api/init.rst:2027 msgid "" "Return the next interpreter state object after *interp* from the list of all " "such objects." msgstr "" -#: c-api/init.rst:2026 +#: c-api/init.rst:2033 msgid "" "Return the pointer to the first :c:type:`PyThreadState` object in the list " "of threads associated with the interpreter *interp*." msgstr "" -#: c-api/init.rst:2032 +#: c-api/init.rst:2039 msgid "" "Return the next thread state object after *tstate* from the list of all such " "objects belonging to the same :c:type:`PyInterpreterState` object." msgstr "" -#: c-api/init.rst:2039 +#: c-api/init.rst:2046 msgid "Thread Local Storage Support" msgstr "" -#: c-api/init.rst:2043 +#: c-api/init.rst:2050 msgid "" "The Python interpreter provides low-level support for thread-local storage " "(TLS) which wraps the underlying native TLS implementation to support the " @@ -2319,19 +2328,19 @@ msgid "" "thread." msgstr "" -#: c-api/init.rst:2050 +#: c-api/init.rst:2057 msgid "" "The GIL does *not* need to be held when calling these functions; they supply " "their own locking." msgstr "" -#: c-api/init.rst:2053 +#: c-api/init.rst:2060 msgid "" "Note that :file:`Python.h` does not include the declaration of the TLS APIs, " "you need to include :file:`pythread.h` to use thread-local storage." msgstr "" -#: c-api/init.rst:2057 +#: c-api/init.rst:2064 msgid "" "None of these API functions handle memory management on behalf of the :c:" "expr:`void*` values. You need to allocate and deallocate them yourself. If " @@ -2339,22 +2348,22 @@ msgid "" "don't do refcount operations on them either." msgstr "" -#: c-api/init.rst:2065 +#: c-api/init.rst:2072 msgid "Thread Specific Storage (TSS) API" msgstr "" -#: c-api/init.rst:2067 +#: c-api/init.rst:2074 msgid "" "TSS API is introduced to supersede the use of the existing TLS API within " "the CPython interpreter. This API uses a new type :c:type:`Py_tss_t` " "instead of :c:expr:`int` to represent thread keys." msgstr "" -#: c-api/init.rst:2073 +#: c-api/init.rst:2080 msgid "\"A New C-API for Thread-Local Storage in CPython\" (:pep:`539`)" msgstr "" -#: c-api/init.rst:2078 +#: c-api/init.rst:2085 msgid "" "This data structure represents the state of a thread key, the definition of " "which may depend on the underlying TLS implementation, and it has an " @@ -2362,52 +2371,52 @@ msgid "" "public members in this structure." msgstr "" -#: c-api/init.rst:2083 +#: c-api/init.rst:2090 msgid "" "When :ref:`Py_LIMITED_API ` is not defined, static allocation of " "this type by :c:macro:`Py_tss_NEEDS_INIT` is allowed." msgstr "" -#: c-api/init.rst:2089 +#: c-api/init.rst:2096 msgid "" "This macro expands to the initializer for :c:type:`Py_tss_t` variables. Note " "that this macro won't be defined with :ref:`Py_LIMITED_API `." msgstr "" -#: c-api/init.rst:2094 +#: c-api/init.rst:2101 msgid "Dynamic Allocation" msgstr "" -#: c-api/init.rst:2096 +#: c-api/init.rst:2103 msgid "" "Dynamic allocation of the :c:type:`Py_tss_t`, required in extension modules " "built with :ref:`Py_LIMITED_API `, where static allocation of this " "type is not possible due to its implementation being opaque at build time." msgstr "" -#: c-api/init.rst:2103 +#: c-api/init.rst:2110 msgid "" "Return a value which is the same state as a value initialized with :c:macro:" "`Py_tss_NEEDS_INIT`, or ``NULL`` in the case of dynamic allocation failure." msgstr "" -#: c-api/init.rst:2110 +#: c-api/init.rst:2117 msgid "" "Free the given *key* allocated by :c:func:`PyThread_tss_alloc`, after first " "calling :c:func:`PyThread_tss_delete` to ensure any associated thread locals " "have been unassigned. This is a no-op if the *key* argument is ``NULL``." msgstr "" -#: c-api/init.rst:2116 +#: c-api/init.rst:2123 msgid "" "A freed key becomes a dangling pointer. You should reset the key to ``NULL``." msgstr "" -#: c-api/init.rst:2121 +#: c-api/init.rst:2128 msgid "Methods" msgstr "" -#: c-api/init.rst:2123 +#: c-api/init.rst:2130 msgid "" "The parameter *key* of these functions must not be ``NULL``. Moreover, the " "behaviors of :c:func:`PyThread_tss_set` and :c:func:`PyThread_tss_get` are " @@ -2415,13 +2424,13 @@ msgid "" "func:`PyThread_tss_create`." msgstr "" -#: c-api/init.rst:2131 +#: c-api/init.rst:2138 msgid "" "Return a non-zero value if the given :c:type:`Py_tss_t` has been initialized " "by :c:func:`PyThread_tss_create`." msgstr "" -#: c-api/init.rst:2137 +#: c-api/init.rst:2144 msgid "" "Return a zero value on successful initialization of a TSS key. The behavior " "is undefined if the value pointed to by the *key* argument is not " @@ -2430,7 +2439,7 @@ msgid "" "no-op and immediately returns success." msgstr "" -#: c-api/init.rst:2146 +#: c-api/init.rst:2153 msgid "" "Destroy a TSS key to forget the values associated with the key across all " "threads, and change the key's initialization state to uninitialized. A " @@ -2439,31 +2448,31 @@ msgid "" "key -- calling it on an already destroyed key is a no-op." msgstr "" -#: c-api/init.rst:2155 +#: c-api/init.rst:2162 msgid "" "Return a zero value to indicate successfully associating a :c:expr:`void*` " "value with a TSS key in the current thread. Each thread has a distinct " "mapping of the key to a :c:expr:`void*` value." msgstr "" -#: c-api/init.rst:2162 +#: c-api/init.rst:2169 msgid "" "Return the :c:expr:`void*` value associated with a TSS key in the current " "thread. This returns ``NULL`` if no value is associated with the key in the " "current thread." msgstr "" -#: c-api/init.rst:2170 +#: c-api/init.rst:2177 msgid "Thread Local Storage (TLS) API" msgstr "" -#: c-api/init.rst:2172 +#: c-api/init.rst:2179 msgid "" "This API is superseded by :ref:`Thread Specific Storage (TSS) API `." msgstr "" -#: c-api/init.rst:2177 +#: c-api/init.rst:2184 msgid "" "This version of the API does not support platforms where the native TLS key " "is defined in a way that cannot be safely cast to ``int``. On such " @@ -2472,13 +2481,13 @@ msgid "" "platforms." msgstr "" -#: c-api/init.rst:2182 +#: c-api/init.rst:2189 msgid "" "Due to the compatibility problem noted above, this version of the API should " "not be used in new code." msgstr "" -#: c-api/init.rst:495 c-api/init.rst:570 +#: c-api/init.rst:502 c-api/init.rst:577 msgid "Py_SetProgramName()" msgstr "" @@ -2490,31 +2499,31 @@ msgstr "" msgid "modules (in module sys)" msgstr "" -#: c-api/init.rst:589 c-api/init.rst:615 +#: c-api/init.rst:596 c-api/init.rst:622 msgid "path (in module sys)" msgstr "" -#: c-api/init.rst:589 c-api/init.rst:1056 c-api/init.rst:1682 +#: c-api/init.rst:596 c-api/init.rst:1063 c-api/init.rst:1689 msgid "module" msgstr "" -#: c-api/init.rst:1587 c-api/init.rst:1682 +#: c-api/init.rst:1594 c-api/init.rst:1689 msgid "builtins" msgstr "" -#: c-api/init.rst:1587 c-api/init.rst:1682 +#: c-api/init.rst:1594 c-api/init.rst:1689 msgid "__main__" msgstr "" -#: c-api/init.rst:1587 c-api/init.rst:1682 +#: c-api/init.rst:1594 c-api/init.rst:1689 msgid "sys" msgstr "" -#: c-api/init.rst:589 c-api/init.rst:615 +#: c-api/init.rst:596 c-api/init.rst:622 msgid "search" msgstr "" -#: c-api/init.rst:589 c-api/init.rst:615 +#: c-api/init.rst:596 c-api/init.rst:622 msgid "path" msgstr "" @@ -2526,134 +2535,134 @@ msgstr "" msgid "PySys_SetArgvEx (C function)" msgstr "" -#: c-api/init.rst:1647 c-api/init.rst:1700 +#: c-api/init.rst:1654 c-api/init.rst:1707 msgid "Py_FinalizeEx (C function)" msgstr "" -#: c-api/init.rst:467 +#: c-api/init.rst:474 msgid "Py_Initialize()" msgstr "" -#: c-api/init.rst:467 c-api/init.rst:723 +#: c-api/init.rst:474 c-api/init.rst:730 msgid "main()" msgstr "" -#: c-api/init.rst:430 +#: c-api/init.rst:437 msgid "stdin" msgstr "" -#: c-api/init.rst:430 +#: c-api/init.rst:437 msgid "stdout" msgstr "" -#: c-api/init.rst:430 +#: c-api/init.rst:437 msgid "sdterr" msgstr "" -#: c-api/init.rst:615 +#: c-api/init.rst:622 msgid "Py_GetPath()" msgstr "" -#: c-api/init.rst:570 +#: c-api/init.rst:577 msgid "executable (in module sys)" msgstr "" -#: c-api/init.rst:589 +#: c-api/init.rst:596 msgid "Py_SetPath()" msgstr "" -#: c-api/init.rst:700 c-api/init.rst:714 +#: c-api/init.rst:707 c-api/init.rst:721 msgid "version (in module sys)" msgstr "" -#: c-api/init.rst:670 +#: c-api/init.rst:677 msgid "platform (in module sys)" msgstr "" -#: c-api/init.rst:687 +#: c-api/init.rst:694 msgid "copyright (in module sys)" msgstr "" -#: c-api/init.rst:723 +#: c-api/init.rst:730 msgid "Py_FatalError()" msgstr "" -#: c-api/init.rst:723 +#: c-api/init.rst:730 msgid "argv (in module sys)" msgstr "" -#: c-api/init.rst:839 +#: c-api/init.rst:846 msgid "global interpreter lock" msgstr "" -#: c-api/init.rst:839 +#: c-api/init.rst:846 msgid "interpreter lock" msgstr "" -#: c-api/init.rst:839 +#: c-api/init.rst:846 msgid "lock, interpreter" msgstr "" -#: c-api/init.rst:852 +#: c-api/init.rst:859 msgid "setswitchinterval (in module sys)" msgstr "" -#: c-api/init.rst:861 +#: c-api/init.rst:868 msgid "PyThreadState (C type)" msgstr "" -#: c-api/init.rst:887 +#: c-api/init.rst:894 msgid "Py_BEGIN_ALLOW_THREADS (C macro)" msgstr "" -#: c-api/init.rst:887 +#: c-api/init.rst:894 msgid "Py_END_ALLOW_THREADS (C macro)" msgstr "" -#: c-api/init.rst:903 +#: c-api/init.rst:910 msgid "PyEval_RestoreThread (C function)" msgstr "" -#: c-api/init.rst:903 +#: c-api/init.rst:910 msgid "PyEval_SaveThread (C function)" msgstr "" -#: c-api/init.rst:1034 +#: c-api/init.rst:1041 msgid "PyEval_AcquireThread()" msgstr "" -#: c-api/init.rst:1034 +#: c-api/init.rst:1041 msgid "PyEval_ReleaseThread()" msgstr "" -#: c-api/init.rst:1034 +#: c-api/init.rst:1041 msgid "PyEval_SaveThread()" msgstr "" -#: c-api/init.rst:1034 +#: c-api/init.rst:1041 msgid "PyEval_RestoreThread()" msgstr "" -#: c-api/init.rst:1056 +#: c-api/init.rst:1063 msgid "_thread" msgstr "" -#: c-api/init.rst:1682 +#: c-api/init.rst:1689 msgid "stdout (in module sys)" msgstr "" -#: c-api/init.rst:1682 +#: c-api/init.rst:1689 msgid "stderr (in module sys)" msgstr "" -#: c-api/init.rst:1682 +#: c-api/init.rst:1689 msgid "stdin (in module sys)" msgstr "" -#: c-api/init.rst:1647 +#: c-api/init.rst:1654 msgid "Py_Initialize (C function)" msgstr "" -#: c-api/init.rst:1677 +#: c-api/init.rst:1684 msgid "close (in module os)" msgstr "" diff --git a/c-api/init_config.po b/c-api/init_config.po index fbda4b7aa..c848cbe8c 100644 --- a/c-api/init_config.po +++ b/c-api/init_config.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -583,7 +583,7 @@ msgstr "" msgid "" "The :c:func:`PyConfig_Read` function only parses :c:member:`PyConfig.argv` " "arguments once: :c:member:`PyConfig.parse_argv` is set to ``2`` after " -"arguments are parsed. Since Python arguments are strippped from :c:member:" +"arguments are parsed. Since Python arguments are stripped from :c:member:" "`PyConfig.argv`, parsing arguments twice would parse the application options " "as Python options." msgstr "" diff --git a/c-api/marshal.po b/c-api/marshal.po index 44d833938..5f5244885 100644 --- a/c-api/marshal.po +++ b/c-api/marshal.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -37,7 +37,7 @@ msgstr "" msgid "" "The module supports two versions of the data format: version 0 is the " "historical version, version 1 shares interned strings in the file, and upon " -"unmarshalling. Version 2 uses a binary format for floating point numbers. " +"unmarshalling. Version 2 uses a binary format for floating-point numbers. " "``Py_MARSHAL_VERSION`` indicates the current file format (currently 2)." msgstr "" diff --git a/c-api/module.po b/c-api/module.po index 8c521178e..3cbb39770 100644 --- a/c-api/module.po +++ b/c-api/module.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -47,17 +47,21 @@ msgid "" "`__file__` attribute." msgstr "" -#: c-api/module.rst:48 +#: c-api/module.rst:270 c-api/module.rst:445 +msgid "Return ``NULL`` with an exception set on error." +msgstr "" + +#: c-api/module.rst:50 msgid ":attr:`__package__` and :attr:`__loader__` are set to ``None``." msgstr "" -#: c-api/module.rst:54 +#: c-api/module.rst:56 msgid "" "Similar to :c:func:`PyModule_NewObject`, but the name is a UTF-8 encoded " "string instead of a Unicode object." msgstr "" -#: c-api/module.rst:62 +#: c-api/module.rst:64 msgid "" "Return the dictionary object that implements *module*'s namespace; this " "object is the same as the :attr:`~object.__dict__` attribute of the module " @@ -65,40 +69,40 @@ msgid "" "object), :exc:`SystemError` is raised and ``NULL`` is returned." msgstr "" -#: c-api/module.rst:67 +#: c-api/module.rst:69 msgid "" "It is recommended extensions use other ``PyModule_*`` and ``PyObject_*`` " "functions rather than directly manipulate a module's :attr:`~object." "__dict__`." msgstr "" -#: c-api/module.rst:78 +#: c-api/module.rst:80 msgid "" "Return *module*'s :attr:`__name__` value. If the module does not provide " "one, or if it is not a string, :exc:`SystemError` is raised and ``NULL`` is " "returned." msgstr "" -#: c-api/module.rst:86 +#: c-api/module.rst:88 msgid "" "Similar to :c:func:`PyModule_GetNameObject` but return the name encoded to " "``'utf-8'``." msgstr "" -#: c-api/module.rst:91 +#: c-api/module.rst:93 msgid "" "Return the \"state\" of the module, that is, a pointer to the block of " "memory allocated at module creation time, or ``NULL``. See :c:member:" "`PyModuleDef.m_size`." msgstr "" -#: c-api/module.rst:98 +#: c-api/module.rst:100 msgid "" "Return a pointer to the :c:type:`PyModuleDef` struct from which the module " "was created, or ``NULL`` if the module wasn't created from a definition." msgstr "" -#: c-api/module.rst:108 +#: c-api/module.rst:110 msgid "" "Return the name of the file from which *module* was loaded using *module*'s :" "attr:`__file__` attribute. If this is not defined, or if it is not a " @@ -106,23 +110,23 @@ msgid "" "return a reference to a Unicode object." msgstr "" -#: c-api/module.rst:118 +#: c-api/module.rst:120 msgid "" "Similar to :c:func:`PyModule_GetFilenameObject` but return the filename " "encoded to 'utf-8'." msgstr "" -#: c-api/module.rst:121 +#: c-api/module.rst:123 msgid "" ":c:func:`PyModule_GetFilename` raises :exc:`UnicodeEncodeError` on " "unencodable filenames, use :c:func:`PyModule_GetFilenameObject` instead." msgstr "" -#: c-api/module.rst:129 +#: c-api/module.rst:131 msgid "Initializing C modules" msgstr "" -#: c-api/module.rst:131 +#: c-api/module.rst:133 msgid "" "Modules objects are usually created from extension modules (shared libraries " "which export an initialization function), or compiled-in modules (where the " @@ -130,55 +134,55 @@ msgid "" "See :ref:`building` or :ref:`extending-with-embedding` for details." msgstr "" -#: c-api/module.rst:136 +#: c-api/module.rst:138 msgid "" "The initialization function can either pass a module definition instance to :" "c:func:`PyModule_Create`, and return the resulting module object, or request " "\"multi-phase initialization\" by returning the definition struct itself." msgstr "" -#: c-api/module.rst:142 +#: c-api/module.rst:144 msgid "" "The module definition struct, which holds all information needed to create a " "module object. There is usually only one statically initialized variable of " "this type for each module." msgstr "" -#: c-api/module.rst:148 +#: c-api/module.rst:150 msgid "Always initialize this member to :c:macro:`PyModuleDef_HEAD_INIT`." msgstr "" -#: c-api/module.rst:152 +#: c-api/module.rst:154 msgid "Name for the new module." msgstr "" -#: c-api/module.rst:156 +#: c-api/module.rst:158 msgid "" "Docstring for the module; usually a docstring variable created with :c:macro:" "`PyDoc_STRVAR` is used." msgstr "" -#: c-api/module.rst:161 +#: c-api/module.rst:163 msgid "" "Module state may be kept in a per-module memory area that can be retrieved " "with :c:func:`PyModule_GetState`, rather than in static globals. This makes " "modules safe for use in multiple sub-interpreters." msgstr "" -#: c-api/module.rst:165 +#: c-api/module.rst:167 msgid "" "This memory area is allocated based on *m_size* on module creation, and " "freed when the module object is deallocated, after the :c:member:" "`~PyModuleDef.m_free` function has been called, if present." msgstr "" -#: c-api/module.rst:169 +#: c-api/module.rst:171 msgid "" "Setting ``m_size`` to ``-1`` means that the module does not support sub-" "interpreters, because it has global state." msgstr "" -#: c-api/module.rst:172 +#: c-api/module.rst:174 msgid "" "Setting it to a non-negative value means that the module can be re-" "initialized and specifies the additional amount of memory it requires for " @@ -186,36 +190,36 @@ msgid "" "initialization." msgstr "" -#: c-api/module.rst:177 +#: c-api/module.rst:179 msgid "See :PEP:`3121` for more details." msgstr "" -#: c-api/module.rst:181 +#: c-api/module.rst:183 msgid "" "A pointer to a table of module-level functions, described by :c:type:" "`PyMethodDef` values. Can be ``NULL`` if no functions are present." msgstr "" -#: c-api/module.rst:186 +#: c-api/module.rst:188 msgid "" "An array of slot definitions for multi-phase initialization, terminated by a " "``{0, NULL}`` entry. When using single-phase initialization, *m_slots* must " "be ``NULL``." msgstr "" -#: c-api/module.rst:192 +#: c-api/module.rst:194 msgid "" "Prior to version 3.5, this member was always set to ``NULL``, and was " "defined as:" msgstr "" -#: c-api/module.rst:199 +#: c-api/module.rst:201 msgid "" "A traversal function to call during GC traversal of the module object, or " "``NULL`` if not needed." msgstr "" -#: c-api/module.rst:217 c-api/module.rst:238 +#: c-api/module.rst:219 c-api/module.rst:240 msgid "" "This function is not called if the module state was requested but is not " "allocated yet. This is the case immediately after the module is created and " @@ -225,17 +229,17 @@ msgid "" "`PyModule_GetState`) is ``NULL``." msgstr "" -#: c-api/module.rst:230 c-api/module.rst:245 +#: c-api/module.rst:232 c-api/module.rst:247 msgid "No longer called before the module state is allocated." msgstr "" -#: c-api/module.rst:214 +#: c-api/module.rst:216 msgid "" "A clear function to call during GC clearing of the module object, or " "``NULL`` if not needed." msgstr "" -#: c-api/module.rst:224 +#: c-api/module.rst:226 msgid "" "Like :c:member:`PyTypeObject.tp_clear`, this function is not *always* called " "before a module is deallocated. For example, when reference counting is " @@ -244,55 +248,55 @@ msgid "" "directly." msgstr "" -#: c-api/module.rst:235 +#: c-api/module.rst:237 msgid "" "A function to call during deallocation of the module object, or ``NULL`` if " "not needed." msgstr "" -#: c-api/module.rst:249 +#: c-api/module.rst:251 msgid "Single-phase initialization" msgstr "" -#: c-api/module.rst:251 +#: c-api/module.rst:253 msgid "" "The module initialization function may create and return the module object " "directly. This is referred to as \"single-phase initialization\", and uses " "one of the following two module creation functions:" msgstr "" -#: c-api/module.rst:257 +#: c-api/module.rst:259 msgid "" "Create a new module object, given the definition in *def*. This behaves " "like :c:func:`PyModule_Create2` with *module_api_version* set to :c:macro:" "`PYTHON_API_VERSION`." msgstr "" -#: c-api/module.rst:264 +#: c-api/module.rst:266 msgid "" "Create a new module object, given the definition in *def*, assuming the API " "version *module_api_version*. If that version does not match the version of " "the running interpreter, a :exc:`RuntimeWarning` is emitted." msgstr "" -#: c-api/module.rst:270 +#: c-api/module.rst:274 msgid "" "Most uses of this function should be using :c:func:`PyModule_Create` " "instead; only use this if you are sure you need it." msgstr "" -#: c-api/module.rst:273 +#: c-api/module.rst:277 msgid "" "Before it is returned from in the initialization function, the resulting " "module object is typically populated using functions like :c:func:" "`PyModule_AddObjectRef`." msgstr "" -#: c-api/module.rst:279 +#: c-api/module.rst:283 msgid "Multi-phase initialization" msgstr "" -#: c-api/module.rst:281 +#: c-api/module.rst:285 msgid "" "An alternate way to specify extensions is to request \"multi-phase " "initialization\". Extension modules created this way behave more like Python " @@ -302,7 +306,7 @@ msgid "" "__init__` methods of classes." msgstr "" -#: c-api/module.rst:288 +#: c-api/module.rst:292 msgid "" "Unlike modules created using single-phase initialization, these modules are " "not singletons: if the *sys.modules* entry is removed and the module is re-" @@ -315,14 +319,14 @@ msgid "" "__dict__` or individual classes created with :c:func:`PyType_FromSpec`)." msgstr "" -#: c-api/module.rst:298 +#: c-api/module.rst:302 msgid "" "All modules created using multi-phase initialization are expected to " "support :ref:`sub-interpreters `. Making sure " "multiple modules are independent is typically enough to achieve this." msgstr "" -#: c-api/module.rst:302 +#: c-api/module.rst:306 msgid "" "To request multi-phase initialization, the initialization function " "(PyInit_modulename) returns a :c:type:`PyModuleDef` instance with non-empty :" @@ -330,65 +334,65 @@ msgid "" "instance must be initialized with the following function:" msgstr "" -#: c-api/module.rst:309 +#: c-api/module.rst:313 msgid "" "Ensures a module definition is a properly initialized Python object that " "correctly reports its type and reference count." msgstr "" -#: c-api/module.rst:312 +#: c-api/module.rst:316 msgid "Returns *def* cast to ``PyObject*``, or ``NULL`` if an error occurred." msgstr "" -#: c-api/module.rst:316 +#: c-api/module.rst:320 msgid "" "The *m_slots* member of the module definition must point to an array of " "``PyModuleDef_Slot`` structures:" msgstr "" -#: c-api/module.rst:323 +#: c-api/module.rst:327 msgid "A slot ID, chosen from the available values explained below." msgstr "" -#: c-api/module.rst:327 +#: c-api/module.rst:331 msgid "Value of the slot, whose meaning depends on the slot ID." msgstr "" -#: c-api/module.rst:331 +#: c-api/module.rst:335 msgid "The *m_slots* array must be terminated by a slot with id 0." msgstr "" -#: c-api/module.rst:333 +#: c-api/module.rst:337 msgid "The available slot types are:" msgstr "" -#: c-api/module.rst:337 +#: c-api/module.rst:341 msgid "" "Specifies a function that is called to create the module object itself. The " "*value* pointer of this slot must point to a function of the signature:" msgstr "" -#: c-api/module.rst:343 +#: c-api/module.rst:348 msgid "" "The function receives a :py:class:`~importlib.machinery.ModuleSpec` " "instance, as defined in :PEP:`451`, and the module definition. It should " "return a new module object, or set an error and return ``NULL``." msgstr "" -#: c-api/module.rst:348 +#: c-api/module.rst:353 msgid "" "This function should be kept minimal. In particular, it should not call " "arbitrary Python code, as trying to import the same module again may result " "in an infinite loop." msgstr "" -#: c-api/module.rst:352 +#: c-api/module.rst:357 msgid "" "Multiple ``Py_mod_create`` slots may not be specified in one module " "definition." msgstr "" -#: c-api/module.rst:355 +#: c-api/module.rst:360 msgid "" "If ``Py_mod_create`` is not specified, the import machinery will create a " "normal module object using :c:func:`PyModule_New`. The name is taken from " @@ -397,7 +401,7 @@ msgid "" "through symlinks, all while sharing a single module definition." msgstr "" -#: c-api/module.rst:361 +#: c-api/module.rst:366 msgid "" "There is no requirement for the returned object to be an instance of :c:type:" "`PyModule_Type`. Any type can be used, as long as it supports setting and " @@ -407,7 +411,7 @@ msgid "" "``Py_mod_create``." msgstr "" -#: c-api/module.rst:370 +#: c-api/module.rst:375 msgid "" "Specifies a function that is called to *execute* the module. This is " "equivalent to executing the code of a Python module: typically, this " @@ -415,59 +419,59 @@ msgid "" "function is:" msgstr "" -#: c-api/module.rst:378 +#: c-api/module.rst:384 msgid "" "If multiple ``Py_mod_exec`` slots are specified, they are processed in the " "order they appear in the *m_slots* array." msgstr "" -#: c-api/module.rst:383 +#: c-api/module.rst:389 msgid "Specifies one of the following values:" msgstr "" -#: c-api/module.rst:389 +#: c-api/module.rst:395 msgid "The module does not support being imported in subinterpreters." msgstr "" -#: c-api/module.rst:393 +#: c-api/module.rst:399 msgid "" "The module supports being imported in subinterpreters, but only when they " "share the main interpreter's GIL. (See :ref:`isolating-extensions-howto`.)" msgstr "" -#: c-api/module.rst:399 +#: c-api/module.rst:405 msgid "" "The module supports being imported in subinterpreters, even when they have " "their own GIL. (See :ref:`isolating-extensions-howto`.)" msgstr "" -#: c-api/module.rst:403 +#: c-api/module.rst:409 msgid "" "This slot determines whether or not importing this module in a " "subinterpreter will fail." msgstr "" -#: c-api/module.rst:406 +#: c-api/module.rst:412 msgid "" "Multiple ``Py_mod_multiple_interpreters`` slots may not be specified in one " "module definition." msgstr "" -#: c-api/module.rst:409 +#: c-api/module.rst:415 msgid "" "If ``Py_mod_multiple_interpreters`` is not specified, the import machinery " "defaults to ``Py_MOD_MULTIPLE_INTERPRETERS_NOT_SUPPORTED``." msgstr "" -#: c-api/module.rst:414 +#: c-api/module.rst:420 msgid "See :PEP:`489` for more details on multi-phase initialization." msgstr "" -#: c-api/module.rst:417 +#: c-api/module.rst:423 msgid "Low-level module creation functions" msgstr "" -#: c-api/module.rst:419 +#: c-api/module.rst:425 msgid "" "The following functions are called under the hood when using multi-phase " "initialization. They can be used directly, for example when creating module " @@ -475,14 +479,14 @@ msgid "" "``PyModule_ExecDef`` must be called to fully initialize a module." msgstr "" -#: c-api/module.rst:426 +#: c-api/module.rst:432 msgid "" "Create a new module object, given the definition in *def* and the ModuleSpec " "*spec*. This behaves like :c:func:`PyModule_FromDefAndSpec2` with " "*module_api_version* set to :c:macro:`PYTHON_API_VERSION`." msgstr "" -#: c-api/module.rst:434 +#: c-api/module.rst:440 msgid "" "Create a new module object, given the definition in *def* and the ModuleSpec " "*spec*, assuming the API version *module_api_version*. If that version does " @@ -490,24 +494,24 @@ msgid "" "emitted." msgstr "" -#: c-api/module.rst:441 +#: c-api/module.rst:449 msgid "" "Most uses of this function should be using :c:func:`PyModule_FromDefAndSpec` " "instead; only use this if you are sure you need it." msgstr "" -#: c-api/module.rst:448 +#: c-api/module.rst:456 msgid "Process any execution slots (:c:data:`Py_mod_exec`) given in *def*." msgstr "" -#: c-api/module.rst:454 +#: c-api/module.rst:462 msgid "" "Set the docstring for *module* to *docstring*. This function is called " "automatically when creating a module from ``PyModuleDef``, using either " "``PyModule_Create`` or ``PyModule_FromDefAndSpec``." msgstr "" -#: c-api/module.rst:463 +#: c-api/module.rst:471 msgid "" "Add the functions from the ``NULL`` terminated *functions* array to " "*module*. Refer to the :c:type:`PyMethodDef` documentation for details on " @@ -519,11 +523,11 @@ msgid "" "``PyModule_FromDefAndSpec``." msgstr "" -#: c-api/module.rst:475 +#: c-api/module.rst:483 msgid "Support functions" msgstr "" -#: c-api/module.rst:477 +#: c-api/module.rst:485 msgid "" "The module initialization function (if using single phase initialization) or " "a function called from a module execution slot (if using multi-phase " @@ -531,117 +535,118 @@ msgid "" "module state:" msgstr "" -#: c-api/module.rst:484 +#: c-api/module.rst:492 msgid "" "Add an object to *module* as *name*. This is a convenience function which " "can be used from the module's initialization function." msgstr "" -#: c-api/module.rst:487 +#: c-api/module.rst:495 msgid "" "On success, return ``0``. On error, raise an exception and return ``-1``." msgstr "" -#: c-api/module.rst:489 +#: c-api/module.rst:497 msgid "" -"Return ``NULL`` if *value* is ``NULL``. It must be called with an exception " +"Return ``-1`` if *value* is ``NULL``. It must be called with an exception " "raised in this case." msgstr "" -#: c-api/module.rst:541 +#: c-api/module.rst:549 msgid "Example usage::" msgstr "" -#: c-api/module.rst:559 +#: c-api/module.rst:567 msgid "" "The example can also be written without checking explicitly if *obj* is " "``NULL``::" msgstr "" -#: c-api/module.rst:575 +#: c-api/module.rst:583 msgid "" "Note that ``Py_XDECREF()`` should be used instead of ``Py_DECREF()`` in this " "case, since *obj* can be ``NULL``." msgstr "" -#: c-api/module.rst:526 +#: c-api/module.rst:534 msgid "" "Similar to :c:func:`PyModule_AddObjectRef`, but steals a reference to " "*value* on success (if it returns ``0``)." msgstr "" -#: c-api/module.rst:529 +#: c-api/module.rst:537 msgid "" "The new :c:func:`PyModule_AddObjectRef` function is recommended, since it is " "easy to introduce reference leaks by misusing the :c:func:" "`PyModule_AddObject` function." msgstr "" -#: c-api/module.rst:535 +#: c-api/module.rst:543 msgid "" "Unlike other functions that steal references, ``PyModule_AddObject()`` only " "releases the reference to *value* **on success**." msgstr "" -#: c-api/module.rst:538 +#: c-api/module.rst:546 msgid "" "This means that its return value must be checked, and calling code must :c:" "func:`Py_DECREF` *value* manually on error." msgstr "" -#: c-api/module.rst:581 +#: c-api/module.rst:589 msgid "" "Add an integer constant to *module* as *name*. This convenience function " -"can be used from the module's initialization function. Return ``-1`` on " -"error, ``0`` on success." +"can be used from the module's initialization function. Return ``-1`` with an " +"exception set on error, ``0`` on success." msgstr "" -#: c-api/module.rst:588 +#: c-api/module.rst:596 msgid "" "Add a string constant to *module* as *name*. This convenience function can " "be used from the module's initialization function. The string *value* must " -"be ``NULL``-terminated. Return ``-1`` on error, ``0`` on success." +"be ``NULL``-terminated. Return ``-1`` with an exception set on error, ``0`` " +"on success." msgstr "" -#: c-api/module.rst:595 +#: c-api/module.rst:604 msgid "" "Add an int constant to *module*. The name and the value are taken from " "*macro*. For example ``PyModule_AddIntMacro(module, AF_INET)`` adds the int " -"constant *AF_INET* with the value of *AF_INET* to *module*. Return ``-1`` on " -"error, ``0`` on success." +"constant *AF_INET* with the value of *AF_INET* to *module*. Return ``-1`` " +"with an exception set on error, ``0`` on success." msgstr "" -#: c-api/module.rst:603 +#: c-api/module.rst:612 msgid "Add a string constant to *module*." msgstr "" -#: c-api/module.rst:607 +#: c-api/module.rst:616 msgid "" "Add a type object to *module*. The type object is finalized by calling " "internally :c:func:`PyType_Ready`. The name of the type object is taken from " "the last component of :c:member:`~PyTypeObject.tp_name` after dot. Return " -"``-1`` on error, ``0`` on success." +"``-1`` with an exception set on error, ``0`` on success." msgstr "" -#: c-api/module.rst:617 +#: c-api/module.rst:626 msgid "Module lookup" msgstr "" -#: c-api/module.rst:619 +#: c-api/module.rst:628 msgid "" "Single-phase initialization creates singleton modules that can be looked up " "in the context of the current interpreter. This allows the module object to " "be retrieved later with only a reference to the module definition." msgstr "" -#: c-api/module.rst:623 +#: c-api/module.rst:632 msgid "" "These functions will not work on modules created using multi-phase " "initialization, since multiple such modules can be created from a single " "definition." msgstr "" -#: c-api/module.rst:628 +#: c-api/module.rst:637 msgid "" "Returns the module object that was created from *def* for the current " "interpreter. This method requires that the module object has been attached " @@ -650,18 +655,18 @@ msgid "" "to the interpreter state yet, it returns ``NULL``." msgstr "" -#: c-api/module.rst:635 +#: c-api/module.rst:644 msgid "" "Attaches the module object passed to the function to the interpreter state. " "This allows the module object to be accessible via :c:func:" "`PyState_FindModule`." msgstr "" -#: c-api/module.rst:638 +#: c-api/module.rst:647 msgid "Only effective on modules created using single-phase initialization." msgstr "" -#: c-api/module.rst:640 +#: c-api/module.rst:649 msgid "" "Python calls ``PyState_AddModule`` automatically after importing a module, " "so it is unnecessary (but harmless) to call it from module initialization " @@ -672,18 +677,18 @@ msgid "" "state updates)." msgstr "" -#: c-api/module.rst:659 +#: c-api/module.rst:668 msgid "The caller must hold the GIL." msgstr "" -#: c-api/module.rst:650 -msgid "Return 0 on success or -1 on failure." +#: c-api/module.rst:659 +msgid "Return ``-1`` with an exception set on error, ``0`` on success." msgstr "" -#: c-api/module.rst:656 +#: c-api/module.rst:665 msgid "" "Removes the module object created from *def* from the interpreter state. " -"Return 0 on success or -1 on failure." +"Return ``-1`` with an exception set on error, ``0`` on success." msgstr "" #: c-api/module.rst:8 @@ -698,7 +703,7 @@ msgstr "" msgid "ModuleType (in module types)" msgstr "" -#: c-api/module.rst:74 +#: c-api/module.rst:76 msgid "__name__ (module attribute)" msgstr "" @@ -706,7 +711,7 @@ msgstr "" msgid "__doc__ (module attribute)" msgstr "" -#: c-api/module.rst:104 +#: c-api/module.rst:106 msgid "__file__ (module attribute)" msgstr "" @@ -718,10 +723,10 @@ msgstr "" msgid "__loader__ (module attribute)" msgstr "" -#: c-api/module.rst:60 +#: c-api/module.rst:62 msgid "__dict__ (module attribute)" msgstr "" -#: c-api/module.rst:104 +#: c-api/module.rst:106 msgid "SystemError (built-in exception)" msgstr "" diff --git a/c-api/number.po b/c-api/number.po index 46a3b3ed6..d9322e8a2 100644 --- a/c-api/number.po +++ b/c-api/number.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -64,8 +64,8 @@ msgstr "" msgid "" "Return a reasonable approximation for the mathematical value of *o1* divided " "by *o2*, or ``NULL`` on failure. The return value is \"approximate\" " -"because binary floating point numbers are approximate; it is not possible to " -"represent all real numbers in base two. This function can return a floating " +"because binary floating-point numbers are approximate; it is not possible to " +"represent all real numbers in base two. This function can return a floating-" "point value when passed two integers. This is the equivalent of the Python " "expression ``o1 / o2``." msgstr "" @@ -183,8 +183,8 @@ msgstr "" msgid "" "Return a reasonable approximation for the mathematical value of *o1* divided " "by *o2*, or ``NULL`` on failure. The return value is \"approximate\" " -"because binary floating point numbers are approximate; it is not possible to " -"represent all real numbers in base two. This function can return a floating " +"because binary floating-point numbers are approximate; it is not possible to " +"represent all real numbers in base two. This function can return a floating-" "point value when passed two integers. The operation is done *in-place* when " "*o1* supports it. This is the equivalent of the Python statement ``o1 /= " "o2``." diff --git a/c-api/slice.po b/c-api/slice.po index 312f5d62e..f0da2a78d 100644 --- a/c-api/slice.po +++ b/c-api/slice.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -37,34 +37,39 @@ msgid "" "Return a new slice object with the given values. The *start*, *stop*, and " "*step* parameters are used as the values of the slice object attributes of " "the same names. Any of the values may be ``NULL``, in which case the " -"``None`` will be used for the corresponding attribute. Return ``NULL`` if " -"the new object could not be allocated." +"``None`` will be used for the corresponding attribute." msgstr "" -#: c-api/slice.rst:32 +#: c-api/slice.rst:28 +msgid "" +"Return ``NULL`` with an exception set if the new object could not be " +"allocated." +msgstr "" + +#: c-api/slice.rst:34 msgid "" "Retrieve the start, stop and step indices from the slice object *slice*, " "assuming a sequence of length *length*. Treats indices greater than *length* " "as errors." msgstr "" -#: c-api/slice.rst:36 +#: c-api/slice.rst:38 msgid "" "Returns ``0`` on success and ``-1`` on error with no exception set (unless " "one of the indices was not ``None`` and failed to be converted to an " "integer, in which case ``-1`` is returned with an exception set)." msgstr "" -#: c-api/slice.rst:40 +#: c-api/slice.rst:42 msgid "You probably do not want to use this function." msgstr "" -#: c-api/slice.rst:73 +#: c-api/slice.rst:75 msgid "" "The parameter type for the *slice* parameter was ``PySliceObject*`` before." msgstr "" -#: c-api/slice.rst:49 +#: c-api/slice.rst:51 msgid "" "Usable replacement for :c:func:`PySlice_GetIndices`. Retrieve the start, " "stop, and step indices from the slice object *slice* assuming a sequence of " @@ -73,22 +78,22 @@ msgid "" "normal slices." msgstr "" -#: c-api/slice.rst:55 -msgid "Returns ``0`` on success and ``-1`` on error with exception set." +#: c-api/slice.rst:57 +msgid "Return ``0`` on success and ``-1`` on error with an exception set." msgstr "" -#: c-api/slice.rst:58 +#: c-api/slice.rst:60 msgid "" "This function is considered not safe for resizable sequences. Its invocation " "should be replaced by a combination of :c:func:`PySlice_Unpack` and :c:func:" "`PySlice_AdjustIndices` where ::" msgstr "" -#: c-api/slice.rst:66 +#: c-api/slice.rst:68 msgid "is replaced by ::" msgstr "" -#: c-api/slice.rst:77 +#: c-api/slice.rst:79 msgid "" "If ``Py_LIMITED_API`` is not set or set to the value between ``0x03050400`` " "and ``0x03060000`` (not including) or ``0x03060100`` or higher :c:func:`!" @@ -97,14 +102,14 @@ msgid "" "*stop* and *step* are evaluated more than once." msgstr "" -#: c-api/slice.rst:84 +#: c-api/slice.rst:86 msgid "" "If ``Py_LIMITED_API`` is set to the value less than ``0x03050400`` or " "between ``0x03060000`` and ``0x03060100`` (not including) :c:func:`!" "PySlice_GetIndicesEx` is a deprecated function." msgstr "" -#: c-api/slice.rst:92 +#: c-api/slice.rst:94 msgid "" "Extract the start, stop and step data members from a slice object as C " "integers. Silently reduce values larger than ``PY_SSIZE_T_MAX`` to " @@ -113,34 +118,34 @@ msgid "" "less than ``-PY_SSIZE_T_MAX`` to ``-PY_SSIZE_T_MAX``." msgstr "" -#: c-api/slice.rst:98 -msgid "Return ``-1`` on error, ``0`` on success." +#: c-api/slice.rst:100 +msgid "Return ``-1`` with an exception set on error, ``0`` on success." msgstr "" -#: c-api/slice.rst:105 +#: c-api/slice.rst:107 msgid "" "Adjust start/end slice indices assuming a sequence of the specified length. " "Out of bounds indices are clipped in a manner consistent with the handling " "of normal slices." msgstr "" -#: c-api/slice.rst:109 +#: c-api/slice.rst:111 msgid "" "Return the length of the slice. Always successful. Doesn't call Python " "code." msgstr "" -#: c-api/slice.rst:116 +#: c-api/slice.rst:118 msgid "Ellipsis Object" msgstr "" -#: c-api/slice.rst:121 +#: c-api/slice.rst:123 msgid "" "The Python ``Ellipsis`` object. This object has no methods. Like :c:data:" "`Py_None`, it is an `immortal `_. " "singleton object." msgstr "" -#: c-api/slice.rst:125 +#: c-api/slice.rst:127 msgid ":c:data:`Py_Ellipsis` is immortal." msgstr "" diff --git a/c-api/sys.po b/c-api/sys.po index a7e8882b8..d592e9c9a 100644 --- a/c-api/sys.po +++ b/c-api/sys.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -451,8 +451,11 @@ msgstr "" #: c-api/sys.rst:395 msgid "" -"Raises an :ref:`auditing event ` ``sys.addaudithook`` with no " -"arguments." +"If the interpreter is initialized, this function raises an auditing event " +"sys.addaudithook with no arguments. If any existing hooks raise an exception " +"derived from Exception, the new hook will not be added and the exception is " +"cleared. As a result, callers cannot assume that their hook has been added " +"unless they control all existing hooks." msgstr "" #: c-api/sys.rst:397 diff --git a/c-api/typeobj.po b/c-api/typeobj.po index db316683c..6bde2c3df 100644 --- a/c-api/typeobj.po +++ b/c-api/typeobj.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2345,7 +2345,7 @@ msgstr "" #: c-api/typeobj.rst:1586 msgid "" "It is an error to set both the :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` bit " -"and :c:member:`~PyTypeObject.tp_weaklist`." +"and :c:member:`~PyTypeObject.tp_weaklistoffset`." msgstr "" #: c-api/typeobj.rst:1591 @@ -2360,7 +2360,7 @@ msgstr "" #: c-api/typeobj.rst:1598 msgid "" "If the :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` bit is set in the :c:member:" -"`~PyTypeObject.tp_dict` field, then :c:member:`~PyTypeObject." +"`~PyTypeObject.tp_flags` field, then :c:member:`~PyTypeObject." "tp_weaklistoffset` will be set to a negative value, to indicate that it is " "unsafe to use this field." msgstr "" diff --git a/faq/design.po b/faq/design.po index c7f0efabe..f1e8c11dd 100644 --- a/faq/design.po +++ b/faq/design.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-01 00:17+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -106,7 +106,7 @@ msgstr "" #: faq/design.rst:72 msgid "" "Many numbers that can be written easily in decimal notation cannot be " -"expressed exactly in binary floating-point. For example, after::" +"expressed exactly in binary floating point. For example, after::" msgstr "" #: faq/design.rst:77 @@ -128,7 +128,7 @@ msgstr "" #: faq/design.rst:90 msgid "" -"For a fuller explanation, please see the :ref:`floating point arithmetic " +"For a fuller explanation, please see the :ref:`floating-point arithmetic " "` chapter in the Python tutorial." msgstr "" diff --git a/faq/library.po b/faq/library.po index 00fdc77ec..c278d9e1c 100644 --- a/faq/library.po +++ b/faq/library.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -808,7 +808,7 @@ msgid "" msgstr "" #: faq/library.rst:828 -msgid "This returns a random floating point number in the range [0, 1)." +msgid "This returns a random floating-point number in the range [0, 1)." msgstr "" #: faq/library.rst:830 @@ -821,7 +821,7 @@ msgid "``randrange(a, b)`` chooses an integer in the range [a, b)." msgstr "" #: faq/library.rst:833 -msgid "``uniform(a, b)`` chooses a floating point number in the range [a, b)." +msgid "``uniform(a, b)`` chooses a floating-point number in the range [a, b)." msgstr "" #: faq/library.rst:834 diff --git a/faq/programming.po b/faq/programming.po index e4edad69d..9f11a8dee 100644 --- a/faq/programming.po +++ b/faq/programming.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -961,8 +961,8 @@ msgstr "" #: faq/programming.rst:871 msgid "" "For integers, use the built-in :func:`int` type constructor, e.g. " -"``int('144') == 144``. Similarly, :func:`float` converts to floating-point, " -"e.g. ``float('144') == 144.0``." +"``int('144') == 144``. Similarly, :func:`float` converts to a floating-" +"point number, e.g. ``float('144') == 144.0``." msgstr "" #: faq/programming.rst:875 @@ -1858,28 +1858,39 @@ msgstr "" #: faq/programming.rst:1744 msgid "" -"This doesn't guarantee privacy: an outside user can still deliberately " -"access the \"_classname__spam\" attribute, and private values are visible in " -"the object's ``__dict__``. Many Python programmers never bother to use " -"private variable names at all." +"The identifier can be used unchanged within the class, but to access it " +"outside the class, the mangled name must be used:" msgstr "" -#: faq/programming.rst:1751 +#: faq/programming.rst:1761 +msgid "" +"In particular, this does not guarantee privacy since an outside user can " +"still deliberately access the private attribute; many Python programmers " +"never bother to use private variable names at all." +msgstr "" + +#: faq/programming.rst:1767 +msgid "" +"The :ref:`private name mangling specifications ` for " +"details and special cases." +msgstr "" + +#: faq/programming.rst:1771 msgid "My class defines __del__ but it is not called when I delete the object." msgstr "" -#: faq/programming.rst:1753 +#: faq/programming.rst:1773 msgid "There are several possible reasons for this." msgstr "" -#: faq/programming.rst:1755 +#: faq/programming.rst:1775 msgid "" "The :keyword:`del` statement does not necessarily call :meth:`~object." "__del__` -- it simply decrements the object's reference count, and if this " "reaches zero :meth:`!__del__` is called." msgstr "" -#: faq/programming.rst:1759 +#: faq/programming.rst:1779 msgid "" "If your data structures contain circular links (e.g. a tree where each child " "has a parent reference and each parent has a list of children) the reference " @@ -1893,7 +1904,7 @@ msgid "" "cases where objects will never be collected." msgstr "" -#: faq/programming.rst:1770 +#: faq/programming.rst:1790 msgid "" "Despite the cycle collector, it's still a good idea to define an explicit " "``close()`` method on objects to be called whenever you're done with them. " @@ -1903,7 +1914,7 @@ msgid "" "once for the same object." msgstr "" -#: faq/programming.rst:1777 +#: faq/programming.rst:1797 msgid "" "Another way to avoid cyclical references is to use the :mod:`weakref` " "module, which allows you to point to objects without incrementing their " @@ -1911,28 +1922,28 @@ msgid "" "references for their parent and sibling references (if they need them!)." msgstr "" -#: faq/programming.rst:1790 +#: faq/programming.rst:1810 msgid "" "Finally, if your :meth:`!__del__` method raises an exception, a warning " "message is printed to :data:`sys.stderr`." msgstr "" -#: faq/programming.rst:1795 +#: faq/programming.rst:1815 msgid "How do I get a list of all instances of a given class?" msgstr "" -#: faq/programming.rst:1797 +#: faq/programming.rst:1817 msgid "" "Python does not keep track of all instances of a class (or of a built-in " "type). You can program the class's constructor to keep track of all " "instances by keeping a list of weak references to each instance." msgstr "" -#: faq/programming.rst:1803 +#: faq/programming.rst:1823 msgid "Why does the result of ``id()`` appear to be not unique?" msgstr "" -#: faq/programming.rst:1805 +#: faq/programming.rst:1825 msgid "" "The :func:`id` builtin returns an integer that is guaranteed to be unique " "during the lifetime of the object. Since in CPython, this is the object's " @@ -1941,7 +1952,7 @@ msgid "" "memory. This is illustrated by this example:" msgstr "" -#: faq/programming.rst:1816 +#: faq/programming.rst:1836 msgid "" "The two ids belong to different integer objects that are created before, and " "deleted immediately after execution of the ``id()`` call. To be sure that " @@ -1949,17 +1960,17 @@ msgid "" "reference to the object:" msgstr "" -#: faq/programming.rst:1829 +#: faq/programming.rst:1849 msgid "When can I rely on identity tests with the *is* operator?" msgstr "" -#: faq/programming.rst:1831 +#: faq/programming.rst:1851 msgid "" "The ``is`` operator tests for object identity. The test ``a is b`` is " "equivalent to ``id(a) == id(b)``." msgstr "" -#: faq/programming.rst:1834 +#: faq/programming.rst:1854 msgid "" "The most important property of an identity test is that an object is always " "identical to itself, ``a is a`` always returns ``True``. Identity tests are " @@ -1967,34 +1978,34 @@ msgid "" "tests are guaranteed to return a boolean ``True`` or ``False``." msgstr "" -#: faq/programming.rst:1839 +#: faq/programming.rst:1859 msgid "" "However, identity tests can *only* be substituted for equality tests when " "object identity is assured. Generally, there are three circumstances where " "identity is guaranteed:" msgstr "" -#: faq/programming.rst:1843 +#: faq/programming.rst:1863 msgid "" "1) Assignments create new names but do not change object identity. After " "the assignment ``new = old``, it is guaranteed that ``new is old``." msgstr "" -#: faq/programming.rst:1846 +#: faq/programming.rst:1866 msgid "" "2) Putting an object in a container that stores object references does not " "change object identity. After the list assignment ``s[0] = x``, it is " "guaranteed that ``s[0] is x``." msgstr "" -#: faq/programming.rst:1850 +#: faq/programming.rst:1870 msgid "" "3) If an object is a singleton, it means that only one instance of that " "object can exist. After the assignments ``a = None`` and ``b = None``, it " "is guaranteed that ``a is b`` because ``None`` is a singleton." msgstr "" -#: faq/programming.rst:1854 +#: faq/programming.rst:1874 msgid "" "In most other circumstances, identity tests are inadvisable and equality " "tests are preferred. In particular, identity tests should not be used to " @@ -2002,17 +2013,17 @@ msgid "" "guaranteed to be singletons::" msgstr "" -#: faq/programming.rst:1871 +#: faq/programming.rst:1891 msgid "Likewise, new instances of mutable containers are never identical::" msgstr "" -#: faq/programming.rst:1878 +#: faq/programming.rst:1898 msgid "" "In the standard library code, you will see several common patterns for " "correctly using identity tests:" msgstr "" -#: faq/programming.rst:1881 +#: faq/programming.rst:1901 msgid "" "1) As recommended by :pep:`8`, an identity test is the preferred way to " "check for ``None``. This reads like plain English in code and avoids " @@ -2020,7 +2031,7 @@ msgid "" "false." msgstr "" -#: faq/programming.rst:1885 +#: faq/programming.rst:1905 msgid "" "2) Detecting optional arguments can be tricky when ``None`` is a valid input " "value. In those situations, you can create a singleton sentinel object " @@ -2028,25 +2039,25 @@ msgid "" "implement a method that behaves like :meth:`dict.pop`::" msgstr "" -#: faq/programming.rst:1901 +#: faq/programming.rst:1921 msgid "" "3) Container implementations sometimes need to augment equality tests with " "identity tests. This prevents the code from being confused by objects such " "as ``float('NaN')`` that are not equal to themselves." msgstr "" -#: faq/programming.rst:1905 +#: faq/programming.rst:1925 msgid "" "For example, here is the implementation of :meth:`!collections.abc.Sequence." "__contains__`::" msgstr "" -#: faq/programming.rst:1916 +#: faq/programming.rst:1936 msgid "" "How can a subclass control what data is stored in an immutable instance?" msgstr "" -#: faq/programming.rst:1918 +#: faq/programming.rst:1938 msgid "" "When subclassing an immutable type, override the :meth:`~object.__new__` " "method instead of the :meth:`~object.__init__` method. The latter only runs " @@ -2054,35 +2065,35 @@ msgid "" "immutable instance." msgstr "" -#: faq/programming.rst:1923 +#: faq/programming.rst:1943 msgid "" "All of these immutable classes have a different signature than their parent " "class:" msgstr "" -#: faq/programming.rst:1949 +#: faq/programming.rst:1969 msgid "The classes can be used like this:" msgstr "" -#: faq/programming.rst:1966 +#: faq/programming.rst:1986 msgid "How do I cache method calls?" msgstr "" -#: faq/programming.rst:1968 +#: faq/programming.rst:1988 msgid "" "The two principal tools for caching methods are :func:`functools." "cached_property` and :func:`functools.lru_cache`. The former stores results " "at the instance level and the latter at the class level." msgstr "" -#: faq/programming.rst:1973 +#: faq/programming.rst:1993 msgid "" "The *cached_property* approach only works with methods that do not take any " "arguments. It does not create a reference to the instance. The cached " "method result will be kept only as long as the instance is alive." msgstr "" -#: faq/programming.rst:1977 +#: faq/programming.rst:1997 msgid "" "The advantage is that when an instance is no longer used, the cached method " "result will be released right away. The disadvantage is that if instances " @@ -2090,47 +2101,47 @@ msgid "" "without bound." msgstr "" -#: faq/programming.rst:1982 +#: faq/programming.rst:2002 msgid "" "The *lru_cache* approach works with methods that have :term:`hashable` " "arguments. It creates a reference to the instance unless special efforts " "are made to pass in weak references." msgstr "" -#: faq/programming.rst:1986 +#: faq/programming.rst:2006 msgid "" "The advantage of the least recently used algorithm is that the cache is " "bounded by the specified *maxsize*. The disadvantage is that instances are " "kept alive until they age out of the cache or until the cache is cleared." msgstr "" -#: faq/programming.rst:1991 +#: faq/programming.rst:2011 msgid "This example shows the various techniques::" msgstr "" -#: faq/programming.rst:2015 +#: faq/programming.rst:2035 msgid "" "The above example assumes that the *station_id* never changes. If the " "relevant instance attributes are mutable, the *cached_property* approach " "can't be made to work because it cannot detect changes to the attributes." msgstr "" -#: faq/programming.rst:2020 +#: faq/programming.rst:2040 msgid "" "To make the *lru_cache* approach work when the *station_id* is mutable, the " "class needs to define the :meth:`~object.__eq__` and :meth:`~object." "__hash__` methods so that the cache can detect relevant attribute updates::" msgstr "" -#: faq/programming.rst:2046 +#: faq/programming.rst:2066 msgid "Modules" msgstr "" -#: faq/programming.rst:2049 +#: faq/programming.rst:2069 msgid "How do I create a .pyc file?" msgstr "" -#: faq/programming.rst:2051 +#: faq/programming.rst:2071 msgid "" "When a module is imported for the first time (or when the source file has " "changed since the current compiled file was created) a ``.pyc`` file " @@ -2141,7 +2152,7 @@ msgid "" "particular ``python`` binary that created it. (See :pep:`3147` for details.)" msgstr "" -#: faq/programming.rst:2059 +#: faq/programming.rst:2079 msgid "" "One reason that a ``.pyc`` file may not be created is a permissions problem " "with the directory containing the source file, meaning that the " @@ -2150,7 +2161,7 @@ msgid "" "testing with a web server." msgstr "" -#: faq/programming.rst:2064 +#: faq/programming.rst:2084 msgid "" "Unless the :envvar:`PYTHONDONTWRITEBYTECODE` environment variable is set, " "creation of a .pyc file is automatic if you're importing a module and Python " @@ -2159,7 +2170,7 @@ msgid "" "subdirectory." msgstr "" -#: faq/programming.rst:2069 +#: faq/programming.rst:2089 msgid "" "Running Python on a top level script is not considered an import and no ``." "pyc`` will be created. For example, if you have a top-level module ``foo." @@ -2169,27 +2180,27 @@ msgid "" "for ``foo`` since ``foo.py`` isn't being imported." msgstr "" -#: faq/programming.rst:2076 +#: faq/programming.rst:2096 msgid "" "If you need to create a ``.pyc`` file for ``foo`` -- that is, to create a ``." "pyc`` file for a module that is not imported -- you can, using the :mod:" "`py_compile` and :mod:`compileall` modules." msgstr "" -#: faq/programming.rst:2080 +#: faq/programming.rst:2100 msgid "" "The :mod:`py_compile` module can manually compile any module. One way is to " "use the ``compile()`` function in that module interactively::" msgstr "" -#: faq/programming.rst:2086 +#: faq/programming.rst:2106 msgid "" "This will write the ``.pyc`` to a ``__pycache__`` subdirectory in the same " "location as ``foo.py`` (or you can override that with the optional parameter " "``cfile``)." msgstr "" -#: faq/programming.rst:2090 +#: faq/programming.rst:2110 msgid "" "You can also automatically compile all files in a directory or directories " "using the :mod:`compileall` module. You can do it from the shell prompt by " @@ -2197,11 +2208,11 @@ msgid "" "Python files to compile::" msgstr "" -#: faq/programming.rst:2099 +#: faq/programming.rst:2119 msgid "How do I find the current module name?" msgstr "" -#: faq/programming.rst:2101 +#: faq/programming.rst:2121 msgid "" "A module can find out its own module name by looking at the predefined " "global variable ``__name__``. If this has the value ``'__main__'``, the " @@ -2210,79 +2221,79 @@ msgid "" "only execute this code after checking ``__name__``::" msgstr "" -#: faq/programming.rst:2116 +#: faq/programming.rst:2136 msgid "How can I have modules that mutually import each other?" msgstr "" -#: faq/programming.rst:2118 +#: faq/programming.rst:2138 msgid "Suppose you have the following modules:" msgstr "" -#: faq/programming.rst:2120 +#: faq/programming.rst:2140 msgid ":file:`foo.py`::" msgstr "" -#: faq/programming.rst:2125 +#: faq/programming.rst:2145 msgid ":file:`bar.py`::" msgstr "" -#: faq/programming.rst:2130 +#: faq/programming.rst:2150 msgid "The problem is that the interpreter will perform the following steps:" msgstr "" -#: faq/programming.rst:2132 +#: faq/programming.rst:2152 msgid "main imports ``foo``" msgstr "" -#: faq/programming.rst:2133 +#: faq/programming.rst:2153 msgid "Empty globals for ``foo`` are created" msgstr "" -#: faq/programming.rst:2134 +#: faq/programming.rst:2154 msgid "``foo`` is compiled and starts executing" msgstr "" -#: faq/programming.rst:2135 +#: faq/programming.rst:2155 msgid "``foo`` imports ``bar``" msgstr "" -#: faq/programming.rst:2136 +#: faq/programming.rst:2156 msgid "Empty globals for ``bar`` are created" msgstr "" -#: faq/programming.rst:2137 +#: faq/programming.rst:2157 msgid "``bar`` is compiled and starts executing" msgstr "" -#: faq/programming.rst:2138 +#: faq/programming.rst:2158 msgid "" "``bar`` imports ``foo`` (which is a no-op since there already is a module " "named ``foo``)" msgstr "" -#: faq/programming.rst:2139 +#: faq/programming.rst:2159 msgid "" "The import mechanism tries to read ``foo_var`` from ``foo`` globals, to set " "``bar.foo_var = foo.foo_var``" msgstr "" -#: faq/programming.rst:2141 +#: faq/programming.rst:2161 msgid "" "The last step fails, because Python isn't done with interpreting ``foo`` yet " "and the global symbol dictionary for ``foo`` is still empty." msgstr "" -#: faq/programming.rst:2144 +#: faq/programming.rst:2164 msgid "" "The same thing happens when you use ``import foo``, and then try to access " "``foo.foo_var`` in global code." msgstr "" -#: faq/programming.rst:2147 +#: faq/programming.rst:2167 msgid "There are (at least) three possible workarounds for this problem." msgstr "" -#: faq/programming.rst:2149 +#: faq/programming.rst:2169 msgid "" "Guido van Rossum recommends avoiding all uses of ``from import ..." "``, and placing all code inside functions. Initializations of global " @@ -2291,59 +2302,59 @@ msgid "" "``.``." msgstr "" -#: faq/programming.rst:2154 +#: faq/programming.rst:2174 msgid "" "Jim Roskind suggests performing steps in the following order in each module:" msgstr "" -#: faq/programming.rst:2156 +#: faq/programming.rst:2176 msgid "" "exports (globals, functions, and classes that don't need imported base " "classes)" msgstr "" -#: faq/programming.rst:2158 +#: faq/programming.rst:2178 msgid "``import`` statements" msgstr "" -#: faq/programming.rst:2159 +#: faq/programming.rst:2179 msgid "" "active code (including globals that are initialized from imported values)." msgstr "" -#: faq/programming.rst:2161 +#: faq/programming.rst:2181 msgid "" "Van Rossum doesn't like this approach much because the imports appear in a " "strange place, but it does work." msgstr "" -#: faq/programming.rst:2164 +#: faq/programming.rst:2184 msgid "" "Matthias Urlichs recommends restructuring your code so that the recursive " "import is not necessary in the first place." msgstr "" -#: faq/programming.rst:2167 +#: faq/programming.rst:2187 msgid "These solutions are not mutually exclusive." msgstr "" -#: faq/programming.rst:2171 +#: faq/programming.rst:2191 msgid "__import__('x.y.z') returns ; how do I get z?" msgstr "" -#: faq/programming.rst:2173 +#: faq/programming.rst:2193 msgid "" "Consider using the convenience function :func:`~importlib.import_module` " "from :mod:`importlib` instead::" msgstr "" -#: faq/programming.rst:2180 +#: faq/programming.rst:2200 msgid "" "When I edit an imported module and reimport it, the changes don't show up. " "Why does this happen?" msgstr "" -#: faq/programming.rst:2182 +#: faq/programming.rst:2202 msgid "" "For reasons of efficiency as well as consistency, Python only reads the " "module file on the first time a module is imported. If it didn't, in a " @@ -2352,13 +2363,13 @@ msgid "" "re-reading of a changed module, do this::" msgstr "" -#: faq/programming.rst:2192 +#: faq/programming.rst:2212 msgid "" "Warning: this technique is not 100% fool-proof. In particular, modules " "containing statements like ::" msgstr "" -#: faq/programming.rst:2197 +#: faq/programming.rst:2217 msgid "" "will continue to work with the old version of the imported objects. If the " "module contains class definitions, existing class instances will *not* be " @@ -2366,7 +2377,7 @@ msgid "" "paradoxical behaviour::" msgstr "" -#: faq/programming.rst:2210 +#: faq/programming.rst:2230 msgid "" "The nature of the problem is made clear if you print out the \"identity\" of " "the class objects::" diff --git a/howto/descriptor.po b/howto/descriptor.po index e58e71d0d..4d70c598b 100644 --- a/howto/descriptor.po +++ b/howto/descriptor.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -559,7 +559,7 @@ msgstr "" #: howto/descriptor.rst:789 msgid "" "The logic for super's dotted lookup is in the :meth:`__getattribute__` " -"method for object returned by :class:`super()`." +"method for object returned by :func:`super`." msgstr "" #: howto/descriptor.rst:792 diff --git a/howto/enum.po b/howto/enum.po index e342f9af4..4ad9fea78 100644 --- a/howto/enum.po +++ b/howto/enum.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-12-01 14:57+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -971,78 +971,78 @@ msgstr "" msgid "names of pseudo-flags are constructed from their members' names::" msgstr "" -#: howto/enum.rst:1132 +#: howto/enum.rst:1140 msgid "multi-bit flags, aka aliases, can be returned from operations::" msgstr "" -#: howto/enum.rst:1143 +#: howto/enum.rst:1151 msgid "" "membership / containment checking: zero-valued flags are always considered " "to be contained::" msgstr "" -#: howto/enum.rst:1149 +#: howto/enum.rst:1157 msgid "" "otherwise, only if all bits of one flag are in the other flag will True be " "returned::" msgstr "" -#: howto/enum.rst:1158 +#: howto/enum.rst:1166 msgid "" "There is a new boundary mechanism that controls how out-of-range / invalid " "bits are handled: ``STRICT``, ``CONFORM``, ``EJECT``, and ``KEEP``:" msgstr "" -#: howto/enum.rst:1161 +#: howto/enum.rst:1169 msgid "STRICT --> raises an exception when presented with invalid values" msgstr "" -#: howto/enum.rst:1162 +#: howto/enum.rst:1170 msgid "CONFORM --> discards any invalid bits" msgstr "" -#: howto/enum.rst:1163 +#: howto/enum.rst:1171 msgid "EJECT --> lose Flag status and become a normal int with the given value" msgstr "" -#: howto/enum.rst:1164 +#: howto/enum.rst:1172 msgid "KEEP --> keep the extra bits" msgstr "" -#: howto/enum.rst:1166 +#: howto/enum.rst:1174 msgid "keeps Flag status and extra bits" msgstr "" -#: howto/enum.rst:1167 +#: howto/enum.rst:1175 msgid "extra bits do not show up in iteration" msgstr "" -#: howto/enum.rst:1168 +#: howto/enum.rst:1176 msgid "extra bits do show up in repr() and str()" msgstr "" -#: howto/enum.rst:1170 +#: howto/enum.rst:1178 msgid "" "The default for Flag is ``STRICT``, the default for ``IntFlag`` is " "``EJECT``, and the default for ``_convert_`` is ``KEEP`` (see ``ssl." "Options`` for an example of when ``KEEP`` is needed)." msgstr "" -#: howto/enum.rst:1178 +#: howto/enum.rst:1186 msgid "How are Enums and Flags different?" msgstr "" -#: howto/enum.rst:1180 +#: howto/enum.rst:1188 msgid "" "Enums have a custom metaclass that affects many aspects of both derived :" "class:`Enum` classes and their instances (members)." msgstr "" -#: howto/enum.rst:1185 +#: howto/enum.rst:1193 msgid "Enum Classes" msgstr "" -#: howto/enum.rst:1187 +#: howto/enum.rst:1195 msgid "" "The :class:`EnumType` metaclass is responsible for providing the :meth:" "`__contains__`, :meth:`__dir__`, :meth:`__iter__` and other methods that " @@ -1053,11 +1053,11 @@ msgid "" "`__getnewargs__`, :meth:`__str__` and :meth:`__repr__`)." msgstr "" -#: howto/enum.rst:1196 +#: howto/enum.rst:1204 msgid "Flag Classes" msgstr "" -#: howto/enum.rst:1198 +#: howto/enum.rst:1206 msgid "" "Flags have an expanded view of aliasing: to be canonical, the value of a " "flag needs to be a power-of-two value, and not a duplicate name. So, in " @@ -1066,11 +1066,11 @@ msgid "" "considered an alias." msgstr "" -#: howto/enum.rst:1204 +#: howto/enum.rst:1212 msgid "Enum Members (aka instances)" msgstr "" -#: howto/enum.rst:1206 +#: howto/enum.rst:1214 msgid "" "The most interesting thing about enum members is that they are singletons. :" "class:`EnumType` creates them all while it is creating the enum class " @@ -1079,37 +1079,37 @@ msgid "" "instances." msgstr "" -#: howto/enum.rst:1212 +#: howto/enum.rst:1220 msgid "Flag Members" msgstr "" -#: howto/enum.rst:1214 +#: howto/enum.rst:1222 msgid "" "Flag members can be iterated over just like the :class:`Flag` class, and " "only the canonical members will be returned. For example::" msgstr "" -#: howto/enum.rst:1220 +#: howto/enum.rst:1228 msgid "(Note that ``BLACK``, ``PURPLE``, and ``WHITE`` do not show up.)" msgstr "" -#: howto/enum.rst:1222 +#: howto/enum.rst:1230 msgid "" "Inverting a flag member returns the corresponding positive value, rather " "than a negative value --- for example::" msgstr "" -#: howto/enum.rst:1228 +#: howto/enum.rst:1236 msgid "" "Flag members have a length corresponding to the number of power-of-two " "values they contain. For example::" msgstr "" -#: howto/enum.rst:1238 +#: howto/enum.rst:1246 msgid "Enum Cookbook" msgstr "" -#: howto/enum.rst:1241 +#: howto/enum.rst:1249 msgid "" "While :class:`Enum`, :class:`IntEnum`, :class:`StrEnum`, :class:`Flag`, and :" "class:`IntFlag` are expected to cover the majority of use-cases, they cannot " @@ -1117,155 +1117,155 @@ msgid "" "that can be used directly, or as examples for creating one's own." msgstr "" -#: howto/enum.rst:1248 +#: howto/enum.rst:1256 msgid "Omitting values" msgstr "" -#: howto/enum.rst:1250 +#: howto/enum.rst:1258 msgid "" "In many use-cases, one doesn't care what the actual value of an enumeration " "is. There are several ways to define this type of simple enumeration:" msgstr "" -#: howto/enum.rst:1253 +#: howto/enum.rst:1261 msgid "use instances of :class:`auto` for the value" msgstr "" -#: howto/enum.rst:1254 +#: howto/enum.rst:1262 msgid "use instances of :class:`object` as the value" msgstr "" -#: howto/enum.rst:1255 +#: howto/enum.rst:1263 msgid "use a descriptive string as the value" msgstr "" -#: howto/enum.rst:1256 +#: howto/enum.rst:1264 msgid "" "use a tuple as the value and a custom :meth:`__new__` to replace the tuple " "with an :class:`int` value" msgstr "" -#: howto/enum.rst:1259 +#: howto/enum.rst:1267 msgid "" "Using any of these methods signifies to the user that these values are not " "important, and also enables one to add, remove, or reorder members without " "having to renumber the remaining members." msgstr "" -#: howto/enum.rst:1265 +#: howto/enum.rst:1273 msgid "Using :class:`auto`" msgstr "" -#: howto/enum.rst:1267 +#: howto/enum.rst:1275 msgid "Using :class:`auto` would look like::" msgstr "" -#: howto/enum.rst:1279 +#: howto/enum.rst:1287 msgid "Using :class:`object`" msgstr "" -#: howto/enum.rst:1281 +#: howto/enum.rst:1289 msgid "Using :class:`object` would look like::" msgstr "" -#: howto/enum.rst:1291 +#: howto/enum.rst:1299 msgid "" "This is also a good example of why you might want to write your own :meth:" "`__repr__`::" msgstr "" -#: howto/enum.rst:1307 +#: howto/enum.rst:1315 msgid "Using a descriptive string" msgstr "" -#: howto/enum.rst:1309 +#: howto/enum.rst:1317 msgid "Using a string as the value would look like::" msgstr "" -#: howto/enum.rst:1321 +#: howto/enum.rst:1329 msgid "Using a custom :meth:`__new__`" msgstr "" -#: howto/enum.rst:1323 +#: howto/enum.rst:1331 msgid "Using an auto-numbering :meth:`__new__` would look like::" msgstr "" -#: howto/enum.rst:1340 +#: howto/enum.rst:1348 msgid "" "To make a more general purpose ``AutoNumber``, add ``*args`` to the " "signature::" msgstr "" -#: howto/enum.rst:1350 +#: howto/enum.rst:1358 msgid "" "Then when you inherit from ``AutoNumber`` you can write your own " "``__init__`` to handle any extra arguments::" msgstr "" -#: howto/enum.rst:1369 +#: howto/enum.rst:1377 msgid "" "The :meth:`__new__` method, if defined, is used during creation of the Enum " "members; it is then replaced by Enum's :meth:`__new__` which is used after " "class creation for lookup of existing members." msgstr "" -#: howto/enum.rst:1375 +#: howto/enum.rst:1383 msgid "" "*Do not* call ``super().__new__()``, as the lookup-only ``__new__`` is the " "one that is found; instead, use the data type directly -- e.g.::" msgstr "" -#: howto/enum.rst:1382 +#: howto/enum.rst:1390 msgid "OrderedEnum" msgstr "" -#: howto/enum.rst:1384 +#: howto/enum.rst:1392 msgid "" "An ordered enumeration that is not based on :class:`IntEnum` and so " "maintains the normal :class:`Enum` invariants (such as not being comparable " "to other enumerations)::" msgstr "" -#: howto/enum.rst:1418 +#: howto/enum.rst:1426 msgid "DuplicateFreeEnum" msgstr "" -#: howto/enum.rst:1420 +#: howto/enum.rst:1428 msgid "" "Raises an error if a duplicate member value is found instead of creating an " "alias::" msgstr "" -#: howto/enum.rst:1445 +#: howto/enum.rst:1453 msgid "" "This is a useful example for subclassing Enum to add or change other " "behaviors as well as disallowing aliases. If the only desired change is " "disallowing aliases, the :func:`unique` decorator can be used instead." msgstr "" -#: howto/enum.rst:1451 +#: howto/enum.rst:1459 msgid "Planet" msgstr "" -#: howto/enum.rst:1453 +#: howto/enum.rst:1461 msgid "" "If :meth:`__new__` or :meth:`__init__` is defined, the value of the enum " "member will be passed to those methods::" msgstr "" -#: howto/enum.rst:1482 +#: howto/enum.rst:1490 msgid "TimePeriod" msgstr "" -#: howto/enum.rst:1484 +#: howto/enum.rst:1492 msgid "An example to show the :attr:`_ignore_` attribute in use::" msgstr "" -#: howto/enum.rst:1503 +#: howto/enum.rst:1511 msgid "Subclassing EnumType" msgstr "" -#: howto/enum.rst:1505 +#: howto/enum.rst:1513 msgid "" "While most enum needs can be met by customizing :class:`Enum` subclasses, " "either with class decorators or custom functions, :class:`EnumType` can be " diff --git a/howto/logging-cookbook.po b/howto/logging-cookbook.po index 1cd6b6ba4..46279a1eb 100644 --- a/howto/logging-cookbook.po +++ b/howto/logging-cookbook.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1947,7 +1947,7 @@ msgid "" "which writes to ``sys.stderr`` makes multiple writes, each of which results " "in a separate logged line (for example, the last three lines above). To get " "around this problem, you need to buffer things and only output log lines " -"when newlines are seen. Let's use a slghtly better implementation of " +"when newlines are seen. Let's use a slightly better implementation of " "``LoggerWriter``:" msgstr "" diff --git a/howto/logging.po b/howto/logging.po index 94e2adc5d..de51068cf 100644 --- a/howto/logging.po +++ b/howto/logging.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -136,7 +136,7 @@ msgid "" "below (in increasing order of severity):" msgstr "" -#: howto/logging.rst:830 +#: howto/logging.rst:870 msgid "Level" msgstr "" @@ -144,7 +144,7 @@ msgstr "" msgid "When it's used" msgstr "" -#: howto/logging.rst:840 +#: howto/logging.rst:880 msgid "``DEBUG``" msgstr "" @@ -153,7 +153,7 @@ msgid "" "Detailed information, typically of interest only when diagnosing problems." msgstr "" -#: howto/logging.rst:838 +#: howto/logging.rst:878 msgid "``INFO``" msgstr "" @@ -161,7 +161,7 @@ msgstr "" msgid "Confirmation that things are working as expected." msgstr "" -#: howto/logging.rst:836 +#: howto/logging.rst:876 msgid "``WARNING``" msgstr "" @@ -172,7 +172,7 @@ msgid "" "working as expected." msgstr "" -#: howto/logging.rst:834 +#: howto/logging.rst:874 msgid "``ERROR``" msgstr "" @@ -182,7 +182,7 @@ msgid "" "some function." msgstr "" -#: howto/logging.rst:832 +#: howto/logging.rst:872 msgid "``CRITICAL``" msgstr "" @@ -532,11 +532,11 @@ msgid "" "the following diagram." msgstr "" -#: howto/logging.rst:388 +#: howto/logging.rst:428 msgid "Loggers" msgstr "" -#: howto/logging.rst:390 +#: howto/logging.rst:430 msgid "" ":class:`Logger` objects have a threefold job. First, they expose several " "methods to application code so that applications can log messages at " @@ -546,17 +546,17 @@ msgid "" "handlers." msgstr "" -#: howto/logging.rst:396 +#: howto/logging.rst:436 msgid "" "The most widely used methods on logger objects fall into two categories: " "configuration and message sending." msgstr "" -#: howto/logging.rst:399 +#: howto/logging.rst:439 msgid "These are the most common configuration methods:" msgstr "" -#: howto/logging.rst:401 +#: howto/logging.rst:441 msgid "" ":meth:`Logger.setLevel` specifies the lowest-severity log message a logger " "will handle, where debug is the lowest built-in severity level and critical " @@ -565,32 +565,32 @@ msgid "" "messages and will ignore DEBUG messages." msgstr "" -#: howto/logging.rst:407 +#: howto/logging.rst:447 msgid "" ":meth:`Logger.addHandler` and :meth:`Logger.removeHandler` add and remove " "handler objects from the logger object. Handlers are covered in more detail " "in :ref:`handler-basic`." msgstr "" -#: howto/logging.rst:411 +#: howto/logging.rst:451 msgid "" ":meth:`Logger.addFilter` and :meth:`Logger.removeFilter` add and remove " "filter objects from the logger object. Filters are covered in more detail " "in :ref:`filter`." msgstr "" -#: howto/logging.rst:415 +#: howto/logging.rst:455 msgid "" "You don't need to always call these methods on every logger you create. See " "the last two paragraphs in this section." msgstr "" -#: howto/logging.rst:418 +#: howto/logging.rst:458 msgid "" "With the logger object configured, the following methods create log messages:" msgstr "" -#: howto/logging.rst:420 +#: howto/logging.rst:460 msgid "" ":meth:`Logger.debug`, :meth:`Logger.info`, :meth:`Logger.warning`, :meth:" "`Logger.error`, and :meth:`Logger.critical` all create log records with a " @@ -603,14 +603,14 @@ msgid "" "exception information." msgstr "" -#: howto/logging.rst:430 +#: howto/logging.rst:470 msgid "" ":meth:`Logger.exception` creates a log message similar to :meth:`Logger." "error`. The difference is that :meth:`Logger.exception` dumps a stack trace " "along with it. Call this method only from an exception handler." msgstr "" -#: howto/logging.rst:434 +#: howto/logging.rst:474 msgid "" ":meth:`Logger.log` takes a log level as an explicit argument. This is a " "little more verbose for logging messages than using the log level " @@ -618,7 +618,7 @@ msgid "" "levels." msgstr "" -#: howto/logging.rst:438 +#: howto/logging.rst:478 msgid "" ":func:`getLogger` returns a reference to a logger instance with the " "specified name if it is provided, or ``root`` if not. The names are period-" @@ -630,7 +630,7 @@ msgid "" "descendants of ``foo``." msgstr "" -#: howto/logging.rst:446 +#: howto/logging.rst:486 msgid "" "Loggers have a concept of *effective level*. If a level is not explicitly " "set on a logger, the level of its parent is used instead as its effective " @@ -642,7 +642,7 @@ msgid "" "handlers." msgstr "" -#: howto/logging.rst:454 +#: howto/logging.rst:494 msgid "" "Child loggers propagate messages up to the handlers associated with their " "ancestor loggers. Because of this, it is unnecessary to define and configure " @@ -652,11 +652,11 @@ msgid "" "attribute of a logger to ``False``.)" msgstr "" -#: howto/logging.rst:465 +#: howto/logging.rst:505 msgid "Handlers" msgstr "" -#: howto/logging.rst:467 +#: howto/logging.rst:507 msgid "" ":class:`~logging.Handler` objects are responsible for dispatching the " "appropriate log messages (based on the log messages' severity) to the " @@ -669,14 +669,14 @@ msgid "" "of a specific severity to a specific location." msgstr "" -#: howto/logging.rst:477 +#: howto/logging.rst:517 msgid "" "The standard library includes quite a few handler types (see :ref:`useful-" "handlers`); the tutorials use mainly :class:`StreamHandler` and :class:" "`FileHandler` in its examples." msgstr "" -#: howto/logging.rst:481 +#: howto/logging.rst:521 msgid "" "There are very few methods in a handler for application developers to " "concern themselves with. The only handler methods that seem relevant for " @@ -684,7 +684,7 @@ msgid "" "not creating custom handlers) are the following configuration methods:" msgstr "" -#: howto/logging.rst:486 +#: howto/logging.rst:526 msgid "" "The :meth:`~Handler.setLevel` method, just as in logger objects, specifies " "the lowest severity that will be dispatched to the appropriate destination. " @@ -694,19 +694,19 @@ msgid "" "send on." msgstr "" -#: howto/logging.rst:492 +#: howto/logging.rst:532 msgid "" ":meth:`~Handler.setFormatter` selects a Formatter object for this handler to " "use." msgstr "" -#: howto/logging.rst:495 +#: howto/logging.rst:535 msgid "" ":meth:`~Handler.addFilter` and :meth:`~Handler.removeFilter` respectively " "configure and deconfigure filter objects on handlers." msgstr "" -#: howto/logging.rst:498 +#: howto/logging.rst:538 msgid "" "Application code should not directly instantiate and use instances of :class:" "`Handler`. Instead, the :class:`Handler` class is a base class that defines " @@ -714,11 +714,11 @@ msgid "" "behavior that child classes can use (or override)." msgstr "" -#: howto/logging.rst:505 +#: howto/logging.rst:545 msgid "Formatters" msgstr "" -#: howto/logging.rst:507 +#: howto/logging.rst:547 msgid "" "Formatter objects configure the final order, structure, and contents of the " "log message. Unlike the base :class:`logging.Handler` class, application " @@ -728,20 +728,20 @@ msgid "" "string and a style indicator." msgstr "" -#: howto/logging.rst:516 +#: howto/logging.rst:556 msgid "" "If there is no message format string, the default is to use the raw " "message. If there is no date format string, the default date format is:" msgstr "" -#: howto/logging.rst:523 +#: howto/logging.rst:563 msgid "" "with the milliseconds tacked on at the end. The ``style`` is one of ``'%'``, " "``'{'``, or ``'$'``. If one of these is not specified, then ``'%'`` will be " "used." msgstr "" -#: howto/logging.rst:526 +#: howto/logging.rst:566 msgid "" "If the ``style`` is ``'%'``, the message format string uses ``%()s`` styled string substitution; the possible keys are documented in :" @@ -751,18 +751,18 @@ msgid "" "should conform to what is expected by :meth:`string.Template.substitute`." msgstr "" -#: howto/logging.rst:533 +#: howto/logging.rst:573 msgid "Added the ``style`` parameter." msgstr "" -#: howto/logging.rst:536 +#: howto/logging.rst:576 msgid "" "The following message format string will log the time in a human-readable " "format, the severity of the message, and the contents of the message, in " "that order::" msgstr "" -#: howto/logging.rst:542 +#: howto/logging.rst:582 msgid "" "Formatters use a user-configurable function to convert the creation time of " "a record to a tuple. By default, :func:`time.localtime` is used; to change " @@ -773,68 +773,68 @@ msgid "" "in the Formatter class (to ``time.gmtime`` for GMT display)." msgstr "" -#: howto/logging.rst:552 +#: howto/logging.rst:592 msgid "Configuring Logging" msgstr "" -#: howto/logging.rst:556 +#: howto/logging.rst:596 msgid "Programmers can configure logging in three ways:" msgstr "" -#: howto/logging.rst:558 +#: howto/logging.rst:598 msgid "" "Creating loggers, handlers, and formatters explicitly using Python code that " "calls the configuration methods listed above." msgstr "" -#: howto/logging.rst:560 +#: howto/logging.rst:600 msgid "" "Creating a logging config file and reading it using the :func:`fileConfig` " "function." msgstr "" -#: howto/logging.rst:562 +#: howto/logging.rst:602 msgid "" "Creating a dictionary of configuration information and passing it to the :" "func:`dictConfig` function." msgstr "" -#: howto/logging.rst:565 +#: howto/logging.rst:605 msgid "" "For the reference documentation on the last two options, see :ref:`logging-" "config-api`. The following example configures a very simple logger, a " "console handler, and a simple formatter using Python code::" msgstr "" -#: howto/logging.rst:595 +#: howto/logging.rst:635 msgid "" "Running this module from the command line produces the following output:" msgstr "" -#: howto/logging.rst:606 +#: howto/logging.rst:646 msgid "" "The following Python module creates a logger, handler, and formatter nearly " "identical to those in the example listed above, with the only difference " "being the names of the objects::" msgstr "" -#: howto/logging.rst:625 +#: howto/logging.rst:665 msgid "Here is the logging.conf file:" msgstr "" -#: howto/logging.rst:657 +#: howto/logging.rst:697 msgid "" "The output is nearly identical to that of the non-config-file-based example:" msgstr "" -#: howto/logging.rst:668 +#: howto/logging.rst:708 msgid "" "You can see that the config file approach has a few advantages over the " "Python code approach, mainly separation of configuration and code and the " "ability of noncoders to easily modify the logging properties." msgstr "" -#: howto/logging.rst:672 +#: howto/logging.rst:712 msgid "" "The :func:`fileConfig` function takes a default parameter, " "``disable_existing_loggers``, which defaults to ``True`` for reasons of " @@ -845,7 +845,7 @@ msgid "" "information, and specify ``False`` for this parameter if you wish." msgstr "" -#: howto/logging.rst:680 +#: howto/logging.rst:720 msgid "" "The dictionary passed to :func:`dictConfig` can also specify a Boolean value " "with key ``disable_existing_loggers``, which if not specified explicitly in " @@ -854,7 +854,7 @@ msgid "" "want - in which case, provide the key explicitly with a value of ``False``." msgstr "" -#: howto/logging.rst:690 +#: howto/logging.rst:730 msgid "" "Note that the class names referenced in config files need to be either " "relative to the logging module, or absolute values which can be resolved " @@ -865,7 +865,7 @@ msgid "" "path)." msgstr "" -#: howto/logging.rst:698 +#: howto/logging.rst:738 msgid "" "In Python 3.2, a new means of configuring logging has been introduced, using " "dictionaries to hold configuration information. This provides a superset of " @@ -880,30 +880,30 @@ msgid "" "a socket, or use whatever approach makes sense for your application." msgstr "" -#: howto/logging.rst:710 +#: howto/logging.rst:750 msgid "" "Here's an example of the same configuration as above, in YAML format for the " "new dictionary-based approach:" msgstr "" -#: howto/logging.rst:734 +#: howto/logging.rst:774 msgid "" "For more information about logging using a dictionary, see :ref:`logging-" "config-api`." msgstr "" -#: howto/logging.rst:738 +#: howto/logging.rst:778 msgid "What happens if no configuration is provided" msgstr "" -#: howto/logging.rst:740 +#: howto/logging.rst:780 msgid "" "If no logging configuration is provided, it is possible to have a situation " "where a logging event needs to be output, but no handlers can be found to " "output the event." msgstr "" -#: howto/logging.rst:744 +#: howto/logging.rst:784 msgid "" "The event is output using a 'handler of last resort', stored in :data:" "`lastResort`. This internal handler is not associated with any logger, and " @@ -915,32 +915,32 @@ msgid "" "severities will be output." msgstr "" -#: howto/logging.rst:755 +#: howto/logging.rst:795 msgid "For versions of Python prior to 3.2, the behaviour is as follows:" msgstr "" -#: howto/logging.rst:757 +#: howto/logging.rst:797 msgid "" "If :data:`raiseExceptions` is ``False`` (production mode), the event is " "silently dropped." msgstr "" -#: howto/logging.rst:760 +#: howto/logging.rst:800 msgid "" "If :data:`raiseExceptions` is ``True`` (development mode), a message 'No " "handlers could be found for logger X.Y.Z' is printed once." msgstr "" -#: howto/logging.rst:763 +#: howto/logging.rst:803 msgid "" "To obtain the pre-3.2 behaviour, :data:`lastResort` can be set to ``None``." msgstr "" -#: howto/logging.rst:769 +#: howto/logging.rst:809 msgid "Configuring Logging for a Library" msgstr "" -#: howto/logging.rst:771 +#: howto/logging.rst:811 msgid "" "When developing a library which uses logging, you should take care to " "document how the library uses logging - for example, the names of loggers " @@ -951,7 +951,7 @@ msgid "" "is regarded as the best default behaviour." msgstr "" -#: howto/logging.rst:779 +#: howto/logging.rst:819 msgid "" "If for some reason you *don't* want these messages printed in the absence of " "any logging configuration, you can attach a do-nothing handler to the top-" @@ -963,7 +963,7 @@ msgid "" "to those handlers, as normal." msgstr "" -#: howto/logging.rst:788 +#: howto/logging.rst:828 msgid "" "A do-nothing handler is included in the logging package: :class:`~logging." "NullHandler` (since Python 3.1). An instance of this handler could be added " @@ -974,14 +974,14 @@ msgid "" "etc. then the code::" msgstr "" -#: howto/logging.rst:799 +#: howto/logging.rst:839 msgid "" "should have the desired effect. If an organisation produces a number of " "libraries, then the logger name specified can be 'orgname.foo' rather than " "just 'foo'." msgstr "" -#: howto/logging.rst:803 +#: howto/logging.rst:843 msgid "" "It is strongly advised that you *do not log to the root logger* in your " "library. Instead, use a logger with a unique and easily identifiable name, " @@ -991,7 +991,7 @@ msgid "" "library as they wish." msgstr "" -#: howto/logging.rst:810 +#: howto/logging.rst:850 msgid "" "It is strongly advised that you *do not add any handlers other than* :class:" "`~logging.NullHandler` *to your library's loggers*. This is because the " @@ -1002,11 +1002,11 @@ msgid "" "carry out unit tests and deliver logs which suit their requirements." msgstr "" -#: howto/logging.rst:821 +#: howto/logging.rst:861 msgid "Logging Levels" msgstr "" -#: howto/logging.rst:823 +#: howto/logging.rst:863 msgid "" "The numeric values of logging levels are given in the following table. These " "are primarily of interest if you want to define your own levels, and need " @@ -1015,39 +1015,39 @@ msgid "" "value; the predefined name is lost." msgstr "" -#: howto/logging.rst:830 +#: howto/logging.rst:870 msgid "Numeric value" msgstr "" -#: howto/logging.rst:832 +#: howto/logging.rst:872 msgid "50" msgstr "" -#: howto/logging.rst:834 +#: howto/logging.rst:874 msgid "40" msgstr "" -#: howto/logging.rst:836 +#: howto/logging.rst:876 msgid "30" msgstr "" -#: howto/logging.rst:838 +#: howto/logging.rst:878 msgid "20" msgstr "" -#: howto/logging.rst:840 +#: howto/logging.rst:880 msgid "10" msgstr "" -#: howto/logging.rst:842 +#: howto/logging.rst:882 msgid "``NOTSET``" msgstr "" -#: howto/logging.rst:842 +#: howto/logging.rst:882 msgid "0" msgstr "" -#: howto/logging.rst:845 +#: howto/logging.rst:885 msgid "" "Levels can also be associated with loggers, being set either by the " "developer or through loading a saved logging configuration. When a logging " @@ -1057,14 +1057,14 @@ msgid "" "basic mechanism controlling the verbosity of logging output." msgstr "" -#: howto/logging.rst:852 +#: howto/logging.rst:892 msgid "" "Logging messages are encoded as instances of the :class:`~logging.LogRecord` " "class. When a logger decides to actually log an event, a :class:`~logging." "LogRecord` instance is created from the logging message." msgstr "" -#: howto/logging.rst:856 +#: howto/logging.rst:896 msgid "" "Logging messages are subjected to a dispatch mechanism through the use of :" "dfn:`handlers`, which are instances of subclasses of the :class:`Handler` " @@ -1081,7 +1081,7 @@ msgid "" "at which point the passing to ancestor handlers stops)." msgstr "" -#: howto/logging.rst:870 +#: howto/logging.rst:910 msgid "" "Just as for loggers, handlers can have levels associated with them. A " "handler's level acts as a filter in the same way as a logger's level does. " @@ -1091,11 +1091,11 @@ msgid "" "`~Handler.emit`." msgstr "" -#: howto/logging.rst:879 +#: howto/logging.rst:919 msgid "Custom Levels" msgstr "" -#: howto/logging.rst:881 +#: howto/logging.rst:921 msgid "" "Defining your own levels is possible, but should not be necessary, as the " "existing levels have been chosen on the basis of practical experience. " @@ -1108,27 +1108,27 @@ msgid "" "given numeric value might mean different things for different libraries." msgstr "" -#: howto/logging.rst:894 +#: howto/logging.rst:934 msgid "Useful Handlers" msgstr "" -#: howto/logging.rst:896 +#: howto/logging.rst:936 msgid "" "In addition to the base :class:`Handler` class, many useful subclasses are " "provided:" msgstr "" -#: howto/logging.rst:899 +#: howto/logging.rst:939 msgid "" ":class:`StreamHandler` instances send messages to streams (file-like " "objects)." msgstr "" -#: howto/logging.rst:902 +#: howto/logging.rst:942 msgid ":class:`FileHandler` instances send messages to disk files." msgstr "" -#: howto/logging.rst:904 +#: howto/logging.rst:944 msgid "" ":class:`~handlers.BaseRotatingHandler` is the base class for handlers that " "rotate log files at a certain point. It is not meant to be instantiated " @@ -1136,61 +1136,61 @@ msgid "" "`~handlers.TimedRotatingFileHandler`." msgstr "" -#: howto/logging.rst:909 +#: howto/logging.rst:949 msgid "" ":class:`~handlers.RotatingFileHandler` instances send messages to disk " "files, with support for maximum log file sizes and log file rotation." msgstr "" -#: howto/logging.rst:912 +#: howto/logging.rst:952 msgid "" ":class:`~handlers.TimedRotatingFileHandler` instances send messages to disk " "files, rotating the log file at certain timed intervals." msgstr "" -#: howto/logging.rst:915 +#: howto/logging.rst:955 msgid "" ":class:`~handlers.SocketHandler` instances send messages to TCP/IP sockets. " "Since 3.4, Unix domain sockets are also supported." msgstr "" -#: howto/logging.rst:918 +#: howto/logging.rst:958 msgid "" ":class:`~handlers.DatagramHandler` instances send messages to UDP sockets. " "Since 3.4, Unix domain sockets are also supported." msgstr "" -#: howto/logging.rst:921 +#: howto/logging.rst:961 msgid "" ":class:`~handlers.SMTPHandler` instances send messages to a designated email " "address." msgstr "" -#: howto/logging.rst:924 +#: howto/logging.rst:964 msgid "" ":class:`~handlers.SysLogHandler` instances send messages to a Unix syslog " "daemon, possibly on a remote machine." msgstr "" -#: howto/logging.rst:927 +#: howto/logging.rst:967 msgid "" ":class:`~handlers.NTEventLogHandler` instances send messages to a Windows " "NT/2000/XP event log." msgstr "" -#: howto/logging.rst:930 +#: howto/logging.rst:970 msgid "" ":class:`~handlers.MemoryHandler` instances send messages to a buffer in " "memory, which is flushed whenever specific criteria are met." msgstr "" -#: howto/logging.rst:933 +#: howto/logging.rst:973 msgid "" ":class:`~handlers.HTTPHandler` instances send messages to an HTTP server " "using either ``GET`` or ``POST`` semantics." msgstr "" -#: howto/logging.rst:936 +#: howto/logging.rst:976 msgid "" ":class:`~handlers.WatchedFileHandler` instances watch the file they are " "logging to. If the file changes, it is closed and reopened using the file " @@ -1198,13 +1198,13 @@ msgid "" "support the underlying mechanism used." msgstr "" -#: howto/logging.rst:941 +#: howto/logging.rst:981 msgid "" ":class:`~handlers.QueueHandler` instances send messages to a queue, such as " "those implemented in the :mod:`queue` or :mod:`multiprocessing` modules." msgstr "" -#: howto/logging.rst:944 +#: howto/logging.rst:984 msgid "" ":class:`NullHandler` instances do nothing with error messages. They are used " "by library developers who want to use logging, but want to avoid the 'No " @@ -1213,15 +1213,15 @@ msgid "" "more information." msgstr "" -#: howto/logging.rst:950 +#: howto/logging.rst:990 msgid "The :class:`NullHandler` class." msgstr "" -#: howto/logging.rst:953 +#: howto/logging.rst:993 msgid "The :class:`~handlers.QueueHandler` class." msgstr "" -#: howto/logging.rst:956 +#: howto/logging.rst:996 msgid "" "The :class:`NullHandler`, :class:`StreamHandler` and :class:`FileHandler` " "classes are defined in the core logging package. The other handlers are " @@ -1229,14 +1229,14 @@ msgid "" "module, :mod:`logging.config`, for configuration functionality.)" msgstr "" -#: howto/logging.rst:961 +#: howto/logging.rst:1001 msgid "" "Logged messages are formatted for presentation through instances of the :" "class:`Formatter` class. They are initialized with a format string suitable " "for use with the % operator and a dictionary." msgstr "" -#: howto/logging.rst:965 +#: howto/logging.rst:1005 msgid "" "For formatting multiple messages in a batch, instances of :class:" "`BufferingFormatter` can be used. In addition to the format string (which is " @@ -1244,7 +1244,7 @@ msgid "" "trailer format strings." msgstr "" -#: howto/logging.rst:970 +#: howto/logging.rst:1010 msgid "" "When filtering based on logger level and/or handler level is not enough, " "instances of :class:`Filter` can be added to both :class:`Logger` and :class:" @@ -1254,18 +1254,18 @@ msgid "" "value, the message is not processed further." msgstr "" -#: howto/logging.rst:977 +#: howto/logging.rst:1017 msgid "" "The basic :class:`Filter` functionality allows filtering by specific logger " "name. If this feature is used, messages sent to the named logger and its " "children are allowed through the filter, and all others dropped." msgstr "" -#: howto/logging.rst:985 +#: howto/logging.rst:1025 msgid "Exceptions raised during logging" msgstr "" -#: howto/logging.rst:987 +#: howto/logging.rst:1027 msgid "" "The logging package is designed to swallow exceptions which occur while " "logging in production. This is so that errors which occur while handling " @@ -1273,7 +1273,7 @@ msgid "" "errors - do not cause the application using logging to terminate prematurely." msgstr "" -#: howto/logging.rst:992 +#: howto/logging.rst:1032 msgid "" ":class:`SystemExit` and :class:`KeyboardInterrupt` exceptions are never " "swallowed. Other exceptions which occur during the :meth:`~Handler.emit` " @@ -1281,7 +1281,7 @@ msgid "" "handleError` method." msgstr "" -#: howto/logging.rst:997 +#: howto/logging.rst:1037 msgid "" "The default implementation of :meth:`~Handler.handleError` in :class:" "`Handler` checks to see if a module-level variable, :data:`raiseExceptions`, " @@ -1289,7 +1289,7 @@ msgid "" "the exception is swallowed." msgstr "" -#: howto/logging.rst:1003 +#: howto/logging.rst:1043 msgid "" "The default value of :data:`raiseExceptions` is ``True``. This is because " "during development, you typically want to be notified of any exceptions that " @@ -1297,11 +1297,11 @@ msgid "" "production usage." msgstr "" -#: howto/logging.rst:1013 +#: howto/logging.rst:1053 msgid "Using arbitrary objects as messages" msgstr "" -#: howto/logging.rst:1015 +#: howto/logging.rst:1055 msgid "" "In the preceding sections and examples, it has been assumed that the message " "passed when logging the event is a string. However, this is not the only " @@ -1313,11 +1313,11 @@ msgid "" "the wire." msgstr "" -#: howto/logging.rst:1026 +#: howto/logging.rst:1066 msgid "Optimization" msgstr "" -#: howto/logging.rst:1028 +#: howto/logging.rst:1068 msgid "" "Formatting of message arguments is deferred until it cannot be avoided. " "However, computing the arguments passed to the logging method can also be " @@ -1328,13 +1328,13 @@ msgid "" "code like this::" msgstr "" -#: howto/logging.rst:1040 +#: howto/logging.rst:1080 msgid "" "so that if the logger's threshold is set above ``DEBUG``, the calls to " "``expensive_func1`` and ``expensive_func2`` are never made." msgstr "" -#: howto/logging.rst:1043 +#: howto/logging.rst:1083 msgid "" "In some cases, :meth:`~Logger.isEnabledFor` can itself be more expensive " "than you'd like (e.g. for deeply nested loggers where an explicit level is " @@ -1346,7 +1346,7 @@ msgid "" "while the application is running (which is not all that common)." msgstr "" -#: howto/logging.rst:1052 +#: howto/logging.rst:1092 msgid "" "There are other optimizations which can be made for specific applications " "which need more precise control over what logging information is collected. " @@ -1354,94 +1354,94 @@ msgid "" "you don't need:" msgstr "" -#: howto/logging.rst:1058 +#: howto/logging.rst:1098 msgid "What you don't want to collect" msgstr "" -#: howto/logging.rst:1058 +#: howto/logging.rst:1098 msgid "How to avoid collecting it" msgstr "" -#: howto/logging.rst:1060 +#: howto/logging.rst:1100 msgid "Information about where calls were made from." msgstr "" -#: howto/logging.rst:1060 +#: howto/logging.rst:1100 msgid "" "Set ``logging._srcfile`` to ``None``. This avoids calling :func:`sys." "_getframe`, which may help to speed up your code in environments like PyPy " "(which can't speed up code that uses :func:`sys._getframe`)." msgstr "" -#: howto/logging.rst:1066 +#: howto/logging.rst:1106 msgid "Threading information." msgstr "" -#: howto/logging.rst:1066 +#: howto/logging.rst:1106 msgid "Set ``logging.logThreads`` to ``False``." msgstr "" -#: howto/logging.rst:1068 +#: howto/logging.rst:1108 msgid "Current process ID (:func:`os.getpid`)" msgstr "" -#: howto/logging.rst:1068 +#: howto/logging.rst:1108 msgid "Set ``logging.logProcesses`` to ``False``." msgstr "" -#: howto/logging.rst:1070 +#: howto/logging.rst:1110 msgid "" "Current process name when using ``multiprocessing`` to manage multiple " "processes." msgstr "" -#: howto/logging.rst:1070 +#: howto/logging.rst:1110 msgid "Set ``logging.logMultiprocessing`` to ``False``." msgstr "" -#: howto/logging.rst:1073 +#: howto/logging.rst:1113 msgid "Current :class:`asyncio.Task` name when using ``asyncio``." msgstr "" -#: howto/logging.rst:1073 +#: howto/logging.rst:1113 msgid "Set ``logging.logAsyncioTasks`` to ``False``." msgstr "" -#: howto/logging.rst:1077 +#: howto/logging.rst:1117 msgid "" "Also note that the core logging module only includes the basic handlers. If " "you don't import :mod:`logging.handlers` and :mod:`logging.config`, they " "won't take up any memory." msgstr "" -#: howto/logging.rst:1084 +#: howto/logging.rst:1124 msgid "Other resources" msgstr "" -#: howto/logging.rst:1088 +#: howto/logging.rst:1128 msgid "Module :mod:`logging`" msgstr "" -#: howto/logging.rst:1089 +#: howto/logging.rst:1129 msgid "API reference for the logging module." msgstr "" -#: howto/logging.rst:1091 +#: howto/logging.rst:1131 msgid "Module :mod:`logging.config`" msgstr "" -#: howto/logging.rst:1092 +#: howto/logging.rst:1132 msgid "Configuration API for the logging module." msgstr "" -#: howto/logging.rst:1094 +#: howto/logging.rst:1134 msgid "Module :mod:`logging.handlers`" msgstr "" -#: howto/logging.rst:1095 +#: howto/logging.rst:1135 msgid "Useful handlers included with the logging module." msgstr "" -#: howto/logging.rst:1097 +#: howto/logging.rst:1137 msgid ":ref:`A logging cookbook `" msgstr "" diff --git a/library/2to3.po b/library/2to3.po index 81613d412..43fe56b93 100644 --- a/library/2to3.po +++ b/library/2to3.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-12-17 01:28+0300\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -29,7 +29,7 @@ msgid "" "library, so it is possible to write your own fixers for 2to3." msgstr "" -#: library/2to3.rst:19 +#: library/2to3.rst:14 msgid "" "The ``lib2to3`` module was marked pending for deprecation in Python 3.9 " "(raising :exc:`PendingDeprecationWarning` on import) and fully deprecated in " @@ -625,7 +625,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/lib2to3/`" msgstr "" -#: library/2to3.rst:482 +#: library/2to3.rst:473 msgid "" "Python 3.9 switched to a PEG parser (see :pep:`617`) while lib2to3 is using " "a less flexible LL(1) parser. Python 3.10 includes new language syntax that " diff --git a/library/__main__.po b/library/__main__.po index acdd89cb5..37c58d758 100644 --- a/library/__main__.po +++ b/library/__main__.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -267,9 +267,9 @@ msgstr "" #: library/__main__.rst:254 msgid "" -"This won't work for ``__main__.py`` files in the root directory of a .zip " -"file though. Hence, for consistency, minimal ``__main__.py`` like the :mod:" -"`venv` one mentioned below are preferred." +"This won't work for ``__main__.py`` files in the root directory of a ``." +"zip`` file though. Hence, for consistency, a minimal ``__main__.py`` " +"without a ``__name__`` check is preferred." msgstr "" #: library/__main__.rst:260 diff --git a/library/_thread.po b/library/_thread.po index 065b0177b..0a5403f00 100644 --- a/library/_thread.po +++ b/library/_thread.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -77,8 +77,8 @@ msgstr "" #: library/_thread.rst:60 msgid "" -"Raises an :ref:`auditing event ` ``_thread.start_new_thread`` with " -"arguments ``function``, ``args``, ``kwargs``." +"Raises an auditing event _thread.start_new_thread with arguments function, " +"args, kwargs." msgstr "" #: library/_thread.rst:62 diff --git a/library/aifc.po b/library/aifc.po index 83dfaee11..d91e72081 100644 --- a/library/aifc.po +++ b/library/aifc.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/aifc.py`" msgstr "" -#: library/aifc.rst:19 +#: library/aifc.rst:16 msgid "" "The :mod:`aifc` module is deprecated (see :pep:`PEP 594 <594#aifc>` for " "details)." diff --git a/library/array.po b/library/array.po index 8461ff1fd..0722a3441 100644 --- a/library/array.po +++ b/library/array.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -23,7 +23,7 @@ msgstr "" #: library/array.rst:11 msgid "" "This module defines an object type which can compactly represent an array of " -"basic values: characters, integers, floating point numbers. Arrays are " +"basic values: characters, integers, floating-point numbers. Arrays are " "sequence types and behave very much like lists, except that the type of " "objects stored in them is constrained. The type is specified at object " "creation time by using a :dfn:`type code`, which is a single character. The " @@ -246,8 +246,7 @@ msgstr "" #: library/array.rst:96 msgid "" -"Raises an :ref:`auditing event ` ``array.__new__`` with arguments " -"``typecode``, ``initializer``." +"Raises an auditing event array.__new__ with arguments typecode, initializer." msgstr "" #: library/array.rst:101 @@ -404,7 +403,7 @@ msgid "" "be converted back to an array with the same type and value using :func:" "`eval`, so long as the :class:`~array.array` class has been imported using " "``from array import array``. Variables ``inf`` and ``nan`` must also be " -"defined if it contains corresponding floating point values. Examples::" +"defined if it contains corresponding floating-point values. Examples::" msgstr "" #: library/array.rst:267 diff --git a/library/ast.po b/library/ast.po index b3ec4f243..9f2b2cef3 100644 --- a/library/ast.po +++ b/library/ast.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -521,7 +521,7 @@ msgid "" "``targets``." msgstr "" -#: library/ast.rst:1161 library/ast.rst:1891 +#: library/ast.rst:1165 library/ast.rst:1895 msgid "" "``type_comment`` is an optional string with the type annotation as a comment." msgstr "" @@ -529,14 +529,21 @@ msgstr "" #: library/ast.rst:883 msgid "" "An assignment with a type annotation. ``target`` is a single node and can be " -"a :class:`Name`, a :class:`Attribute` or a :class:`Subscript`. " +"a :class:`Name`, an :class:`Attribute` or a :class:`Subscript`. " "``annotation`` is the annotation, such as a :class:`Constant` or :class:" -"`Name` node. ``value`` is a single optional node. ``simple`` is a boolean " -"integer set to True for a :class:`Name` node in ``target`` that do not " -"appear in between parenthesis and are hence pure names and not expressions." +"`Name` node. ``value`` is a single optional node." msgstr "" -#: library/ast.rst:938 +#: library/ast.rst:888 +msgid "" +"``simple`` is always either 0 (indicating a \"complex\" target) or 1 " +"(indicating a \"simple\" target). A \"simple\" target consists solely of a :" +"class:`Name` node that does not appear between parentheses; all other " +"targets are considered complex. Only simple targets appear in the :attr:" +"`__annotations__` dictionary of modules and classes." +msgstr "" + +#: library/ast.rst:942 msgid "" "Augmented assignment, such as ``a += 1``. In the following example, " "``target`` is a :class:`Name` node for ``x`` (with the :class:`Store` " @@ -544,36 +551,36 @@ msgid "" "value for 1." msgstr "" -#: library/ast.rst:943 +#: library/ast.rst:947 msgid "" "The ``target`` attribute cannot be of class :class:`Tuple` or :class:`List`, " "unlike the targets of :class:`Assign`." msgstr "" -#: library/ast.rst:960 +#: library/ast.rst:964 msgid "" "A ``raise`` statement. ``exc`` is the exception object to be raised, " "normally a :class:`Call` or :class:`Name`, or ``None`` for a standalone " "``raise``. ``cause`` is the optional part for ``y`` in ``raise x from y``." msgstr "" -#: library/ast.rst:977 +#: library/ast.rst:981 msgid "" "An assertion. ``test`` holds the condition, such as a :class:`Compare` node. " "``msg`` holds the failure message." msgstr "" -#: library/ast.rst:993 +#: library/ast.rst:997 msgid "" "Represents a ``del`` statement. ``targets`` is a list of nodes, such as :" "class:`Name`, :class:`Attribute` or :class:`Subscript` nodes." msgstr "" -#: library/ast.rst:1011 +#: library/ast.rst:1015 msgid "A ``pass`` statement." msgstr "" -#: library/ast.rst:1024 +#: library/ast.rst:1028 msgid "" "A :ref:`type alias ` created through the :keyword:`type` " "statement. ``name`` is the name of the alias, ``type_params`` is a list of :" @@ -581,21 +588,21 @@ msgid "" "type alias." msgstr "" -#: library/ast.rst:1042 +#: library/ast.rst:1046 msgid "" "Other statements which are only applicable inside functions or loops are " "described in other sections." msgstr "" -#: library/ast.rst:1046 +#: library/ast.rst:1050 msgid "Imports" msgstr "" -#: library/ast.rst:1050 +#: library/ast.rst:1054 msgid "An import statement. ``names`` is a list of :class:`alias` nodes." msgstr "" -#: library/ast.rst:1067 +#: library/ast.rst:1071 msgid "" "Represents ``from x import y``. ``module`` is a raw string of the 'from' " "name, without any leading dots, or ``None`` for statements such as ``from . " @@ -603,36 +610,36 @@ msgid "" "import (0 means absolute import)." msgstr "" -#: library/ast.rst:1089 +#: library/ast.rst:1093 msgid "" "Both parameters are raw strings of the names. ``asname`` can be ``None`` if " "the regular name is to be used." msgstr "" -#: library/ast.rst:1106 +#: library/ast.rst:1110 msgid "Control flow" msgstr "" -#: library/ast.rst:1109 +#: library/ast.rst:1113 msgid "" "Optional clauses such as ``else`` are stored as an empty list if they're not " "present." msgstr "" -#: library/ast.rst:1114 +#: library/ast.rst:1118 msgid "" "An ``if`` statement. ``test`` holds a single node, such as a :class:" "`Compare` node. ``body`` and ``orelse`` each hold a list of nodes." msgstr "" -#: library/ast.rst:1117 +#: library/ast.rst:1121 msgid "" "``elif`` clauses don't have a special representation in the AST, but rather " "appear as extra :class:`If` nodes within the ``orelse`` section of the " "previous one." msgstr "" -#: library/ast.rst:1152 +#: library/ast.rst:1156 msgid "" "A ``for`` loop. ``target`` holds the variable(s) the loop assigns to, as a " "single :class:`Name`, :class:`Tuple`, :class:`List`, :class:`Attribute` or :" @@ -642,30 +649,30 @@ msgid "" "via a ``break`` statement." msgstr "" -#: library/ast.rst:1187 +#: library/ast.rst:1191 msgid "" "A ``while`` loop. ``test`` holds the condition, such as a :class:`Compare` " "node." msgstr "" -#: library/ast.rst:1214 +#: library/ast.rst:1218 msgid "The ``break`` and ``continue`` statements." msgstr "" -#: library/ast.rst:1249 +#: library/ast.rst:1253 msgid "" "``try`` blocks. All attributes are list of nodes to execute, except for " "``handlers``, which is a list of :class:`ExceptHandler` nodes." msgstr "" -#: library/ast.rst:1295 +#: library/ast.rst:1299 msgid "" "``try`` blocks which are followed by ``except*`` clauses. The attributes are " "the same as for :class:`Try` but the :class:`ExceptHandler` nodes in " "``handlers`` are interpreted as ``except*`` blocks rather then ``except``." msgstr "" -#: library/ast.rst:1327 +#: library/ast.rst:1331 msgid "" "A single ``except`` clause. ``type`` is the exception type it will match, " "typically a :class:`Name` node (or ``None`` for a catch-all ``except:`` " @@ -673,14 +680,14 @@ msgid "" "``None`` if the clause doesn't have ``as foo``. ``body`` is a list of nodes." msgstr "" -#: library/ast.rst:1361 +#: library/ast.rst:1365 msgid "" "A ``with`` block. ``items`` is a list of :class:`withitem` nodes " "representing the context managers, and ``body`` is the indented block inside " "the context." msgstr "" -#: library/ast.rst:1371 +#: library/ast.rst:1375 msgid "" "A single context manager in a ``with`` block. ``context_expr`` is the " "context manager, often a :class:`Call` node. ``optional_vars`` is a :class:" @@ -688,18 +695,18 @@ msgid "" "if that isn't used." msgstr "" -#: library/ast.rst:1404 +#: library/ast.rst:1408 msgid "Pattern matching" msgstr "" -#: library/ast.rst:1409 +#: library/ast.rst:1413 msgid "" "A ``match`` statement. ``subject`` holds the subject of the match (the " "object that is being matched against the cases) and ``cases`` contains an " "iterable of :class:`match_case` nodes with the different cases." msgstr "" -#: library/ast.rst:1417 +#: library/ast.rst:1421 msgid "" "A single case pattern in a ``match`` statement. ``pattern`` contains the " "match pattern that the subject will be matched against. Note that the :class:" @@ -707,19 +714,19 @@ msgid "" "expressions, even when they share the same syntax." msgstr "" -#: library/ast.rst:1422 +#: library/ast.rst:1426 msgid "" "The ``guard`` attribute contains an expression that will be evaluated if the " "pattern matches the subject." msgstr "" -#: library/ast.rst:1425 +#: library/ast.rst:1429 msgid "" "``body`` contains a list of nodes to execute if the pattern matches and the " "result of evaluating the guard expression is true." msgstr "" -#: library/ast.rst:1470 +#: library/ast.rst:1474 msgid "" "A match literal or value pattern that compares by equality. ``value`` is an " "expression node. Permitted value nodes are restricted as described in the " @@ -727,14 +734,14 @@ msgid "" "equal to the evaluated value." msgstr "" -#: library/ast.rst:1499 +#: library/ast.rst:1503 msgid "" "A match literal pattern that compares by identity. ``value`` is the " "singleton to be compared against: ``None``, ``True``, or ``False``. This " "pattern succeeds if the match subject is the given constant." msgstr "" -#: library/ast.rst:1526 +#: library/ast.rst:1530 msgid "" "A match sequence pattern. ``patterns`` contains the patterns to be matched " "against the subject elements if the subject is a sequence. Matches a " @@ -742,7 +749,7 @@ msgid "" "otherwise matches a fixed length sequence." msgstr "" -#: library/ast.rst:1559 +#: library/ast.rst:1563 msgid "" "Matches the rest of the sequence in a variable length match sequence " "pattern. If ``name`` is not ``None``, a list containing the remaining " @@ -750,7 +757,7 @@ msgid "" "successful." msgstr "" -#: library/ast.rst:1601 +#: library/ast.rst:1605 msgid "" "A match mapping pattern. ``keys`` is a sequence of expression nodes. " "``patterns`` is a corresponding sequence of pattern nodes. ``rest`` is an " @@ -759,7 +766,7 @@ msgid "" "statement documentation." msgstr "" -#: library/ast.rst:1607 +#: library/ast.rst:1611 msgid "" "This pattern succeeds if the subject is a mapping, all evaluated key " "expressions are present in the mapping, and the value corresponding to each " @@ -768,7 +775,7 @@ msgid "" "overall mapping pattern is successful." msgstr "" -#: library/ast.rst:1649 +#: library/ast.rst:1653 msgid "" "A match class pattern. ``cls`` is an expression giving the nominal class to " "be matched. ``patterns`` is a sequence of pattern nodes to be matched " @@ -779,21 +786,21 @@ msgid "" "pattern)." msgstr "" -#: library/ast.rst:1656 +#: library/ast.rst:1660 msgid "" "This pattern succeeds if the subject is an instance of the nominated class, " "all positional patterns match the corresponding class-defined attributes, " "and any specified keyword attributes match their corresponding pattern." msgstr "" -#: library/ast.rst:1660 +#: library/ast.rst:1664 msgid "" "Note: classes may define a property that returns self in order to match a " "pattern node against the instance being matched. Several builtin types are " "also matched that way, as described in the match statement documentation." msgstr "" -#: library/ast.rst:1715 +#: library/ast.rst:1719 msgid "" "A match \"as-pattern\", capture pattern or wildcard pattern. ``pattern`` " "contains the match pattern that the subject will be matched against. If the " @@ -801,14 +808,14 @@ msgid "" "and will always succeed." msgstr "" -#: library/ast.rst:1720 +#: library/ast.rst:1724 msgid "" "The ``name`` attribute contains the name that will be bound if the pattern " "is successful. If ``name`` is ``None``, ``pattern`` must also be ``None`` " "and the node represents the wildcard pattern." msgstr "" -#: library/ast.rst:1758 +#: library/ast.rst:1762 msgid "" "A match \"or-pattern\". An or-pattern matches each of its subpatterns in " "turn to the subject, until one succeeds. The or-pattern is then deemed to " @@ -817,187 +824,187 @@ msgid "" "matched against the subject." msgstr "" -#: library/ast.rst:1793 +#: library/ast.rst:1797 msgid "Type parameters" msgstr "" -#: library/ast.rst:1795 +#: library/ast.rst:1799 msgid "" ":ref:`Type parameters ` can exist on classes, functions, and " "type aliases." msgstr "" -#: library/ast.rst:1800 +#: library/ast.rst:1804 msgid "" "A :class:`typing.TypeVar`. ``name`` is the name of the type variable. " "``bound`` is the bound or constraints, if any. If ``bound`` is a :class:" "`Tuple`, it represents constraints; otherwise it represents the bound." msgstr "" -#: library/ast.rst:1825 +#: library/ast.rst:1829 msgid "" "A :class:`typing.ParamSpec`. ``name`` is the name of the parameter " "specification." msgstr "" -#: library/ast.rst:1850 +#: library/ast.rst:1854 msgid "" "A :class:`typing.TypeVarTuple`. ``name`` is the name of the type variable " "tuple." msgstr "" -#: library/ast.rst:1875 +#: library/ast.rst:1879 msgid "Function and class definitions" msgstr "" -#: library/ast.rst:1879 +#: library/ast.rst:1883 msgid "A function definition." msgstr "" -#: library/ast.rst:1881 +#: library/ast.rst:1885 msgid "``name`` is a raw string of the function name." msgstr "" -#: library/ast.rst:1882 +#: library/ast.rst:1886 msgid "``args`` is an :class:`arguments` node." msgstr "" -#: library/ast.rst:1883 +#: library/ast.rst:1887 msgid "``body`` is the list of nodes inside the function." msgstr "" -#: library/ast.rst:1884 +#: library/ast.rst:1888 msgid "" "``decorator_list`` is the list of decorators to be applied, stored outermost " "first (i.e. the first in the list will be applied last)." msgstr "" -#: library/ast.rst:1886 +#: library/ast.rst:1890 msgid "``returns`` is the return annotation." msgstr "" -#: library/ast.rst:2064 +#: library/ast.rst:2068 msgid "``type_params`` is a list of :ref:`type parameters `." msgstr "" -#: library/ast.rst:2093 library/ast.rst:2104 +#: library/ast.rst:2097 library/ast.rst:2108 msgid "Added ``type_params``." msgstr "" -#: library/ast.rst:1899 +#: library/ast.rst:1903 msgid "" "``lambda`` is a minimal function definition that can be used inside an " "expression. Unlike :class:`FunctionDef`, ``body`` holds a single node." msgstr "" -#: library/ast.rst:1923 +#: library/ast.rst:1927 msgid "The arguments for a function." msgstr "" -#: library/ast.rst:1925 +#: library/ast.rst:1929 msgid "" "``posonlyargs``, ``args`` and ``kwonlyargs`` are lists of :class:`arg` nodes." msgstr "" -#: library/ast.rst:1926 +#: library/ast.rst:1930 msgid "" "``vararg`` and ``kwarg`` are single :class:`arg` nodes, referring to the " "``*args, **kwargs`` parameters." msgstr "" -#: library/ast.rst:1928 +#: library/ast.rst:1932 msgid "" "``kw_defaults`` is a list of default values for keyword-only arguments. If " "one is ``None``, the corresponding argument is required." msgstr "" -#: library/ast.rst:1930 +#: library/ast.rst:1934 msgid "" "``defaults`` is a list of default values for arguments that can be passed " "positionally. If there are fewer defaults, they correspond to the last n " "arguments." msgstr "" -#: library/ast.rst:1937 +#: library/ast.rst:1941 msgid "" "A single argument in a list. ``arg`` is a raw string of the argument name; " "``annotation`` is its annotation, such as a :class:`Name` node." msgstr "" -#: library/ast.rst:1942 +#: library/ast.rst:1946 msgid "" "``type_comment`` is an optional string with the type annotation as a comment" msgstr "" -#: library/ast.rst:1987 +#: library/ast.rst:1991 msgid "A ``return`` statement." msgstr "" -#: library/ast.rst:2002 +#: library/ast.rst:2006 msgid "" "A ``yield`` or ``yield from`` expression. Because these are expressions, " -"they must be wrapped in a :class:`Expr` node if the value sent back is not " +"they must be wrapped in an :class:`Expr` node if the value sent back is not " "used." msgstr "" -#: library/ast.rst:2027 +#: library/ast.rst:2031 msgid "" "``global`` and ``nonlocal`` statements. ``names`` is a list of raw strings." msgstr "" -#: library/ast.rst:2054 +#: library/ast.rst:2058 msgid "A class definition." msgstr "" -#: library/ast.rst:2056 +#: library/ast.rst:2060 msgid "``name`` is a raw string for the class name" msgstr "" -#: library/ast.rst:2057 +#: library/ast.rst:2061 msgid "``bases`` is a list of nodes for explicitly specified base classes." msgstr "" -#: library/ast.rst:2058 +#: library/ast.rst:2062 msgid "" "``keywords`` is a list of :class:`.keyword` nodes, principally for " "'metaclass'. Other keywords will be passed to the metaclass, as per " "`PEP-3115 `_." msgstr "" -#: library/ast.rst:2061 +#: library/ast.rst:2065 msgid "" "``body`` is a list of nodes representing the code within the class " "definition." msgstr "" -#: library/ast.rst:2063 +#: library/ast.rst:2067 msgid "``decorator_list`` is a list of nodes, as in :class:`FunctionDef`." msgstr "" -#: library/ast.rst:2097 +#: library/ast.rst:2101 msgid "Async and await" msgstr "" -#: library/ast.rst:2101 +#: library/ast.rst:2105 msgid "" "An ``async def`` function definition. Has the same fields as :class:" "`FunctionDef`." msgstr "" -#: library/ast.rst:2110 +#: library/ast.rst:2114 msgid "" "An ``await`` expression. ``value`` is what it waits for. Only valid in the " "body of an :class:`AsyncFunctionDef`." msgstr "" -#: library/ast.rst:2144 +#: library/ast.rst:2148 msgid "" "``async for`` loops and ``async with`` context managers. They have the same " "fields as :class:`For` and :class:`With`, respectively. Only valid in the " "body of an :class:`AsyncFunctionDef`." msgstr "" -#: library/ast.rst:2149 +#: library/ast.rst:2153 msgid "" "When a string is parsed by :func:`ast.parse`, operator nodes (subclasses of :" "class:`ast.operator`, :class:`ast.unaryop`, :class:`ast.cmpop`, :class:`ast." @@ -1006,23 +1013,23 @@ msgid "" "same value (e.g. :class:`ast.Add`)." msgstr "" -#: library/ast.rst:2157 +#: library/ast.rst:2161 msgid ":mod:`ast` Helpers" msgstr "" -#: library/ast.rst:2159 +#: library/ast.rst:2163 msgid "" "Apart from the node classes, the :mod:`ast` module defines these utility " "functions and classes for traversing abstract syntax trees:" msgstr "" -#: library/ast.rst:2164 +#: library/ast.rst:2168 msgid "" "Parse the source into an AST node. Equivalent to ``compile(source, " "filename, mode, ast.PyCF_ONLY_AST)``." msgstr "" -#: library/ast.rst:2167 +#: library/ast.rst:2171 msgid "" "If ``type_comments=True`` is given, the parser is modified to check and " "return type comments as specified by :pep:`484` and :pep:`526`. This is " @@ -1035,14 +1042,14 @@ msgid "" "empty list)." msgstr "" -#: library/ast.rst:2177 +#: library/ast.rst:2181 msgid "" "In addition, if ``mode`` is ``'func_type'``, the input syntax is modified to " "correspond to :pep:`484` \"signature type comments\", e.g. ``(str, int) -> " "List[str]``." msgstr "" -#: library/ast.rst:2181 +#: library/ast.rst:2185 msgid "" "Setting ``feature_version`` to a tuple ``(major, minor)`` will result in a " "\"best-effort\" attempt to parse using that Python version's grammar. For " @@ -1055,12 +1062,12 @@ msgid "" "``feature_version``." msgstr "" -#: library/ast.rst:2191 +#: library/ast.rst:2195 msgid "" "If source contains a null character (``\\0``), :exc:`ValueError` is raised." msgstr "" -#: library/ast.rst:2194 +#: library/ast.rst:2198 msgid "" "Note that successfully parsing source code into an AST object doesn't " "guarantee that the source code provided is valid Python code that can be " @@ -1070,43 +1077,43 @@ msgid "" "inside a function node)." msgstr "" -#: library/ast.rst:2201 +#: library/ast.rst:2205 msgid "" "In particular, :func:`ast.parse` won't do any scoping checks, which the " "compilation step does." msgstr "" -#: library/ast.rst:2205 +#: library/ast.rst:2209 msgid "" "It is possible to crash the Python interpreter with a sufficiently large/" "complex string due to stack depth limitations in Python's AST compiler." msgstr "" -#: library/ast.rst:2209 +#: library/ast.rst:2213 msgid "Added ``type_comments``, ``mode='func_type'`` and ``feature_version``." msgstr "" -#: library/ast.rst:2215 +#: library/ast.rst:2219 msgid "" "Unparse an :class:`ast.AST` object and generate a string with code that " "would produce an equivalent :class:`ast.AST` object if parsed back with :" "func:`ast.parse`." msgstr "" -#: library/ast.rst:2220 +#: library/ast.rst:2224 msgid "" "The produced code string will not necessarily be equal to the original code " "that generated the :class:`ast.AST` object (without any compiler " "optimizations, such as constant tuples/frozensets)." msgstr "" -#: library/ast.rst:2225 +#: library/ast.rst:2229 msgid "" "Trying to unparse a highly complex expression would result with :exc:" "`RecursionError`." msgstr "" -#: library/ast.rst:2233 +#: library/ast.rst:2237 msgid "" "Evaluate an expression node or a string containing only a Python literal or " "container display. The string or node provided may only consist of the " @@ -1114,14 +1121,14 @@ msgid "" "dicts, sets, booleans, ``None`` and ``Ellipsis``." msgstr "" -#: library/ast.rst:2238 +#: library/ast.rst:2242 msgid "" "This can be used for evaluating strings containing Python values without the " "need to parse the values oneself. It is not capable of evaluating " "arbitrarily complex expressions, for example involving operators or indexing." msgstr "" -#: library/ast.rst:2243 +#: library/ast.rst:2247 msgid "" "This function had been documented as \"safe\" in the past without defining " "what that meant. That was misleading. This is specifically designed not to " @@ -1133,31 +1140,31 @@ msgid "" "untrusted data is thus not recommended." msgstr "" -#: library/ast.rst:2253 +#: library/ast.rst:2257 msgid "" "It is possible to crash the Python interpreter due to stack depth " "limitations in Python's AST compiler." msgstr "" -#: library/ast.rst:2256 +#: library/ast.rst:2260 msgid "" "It can raise :exc:`ValueError`, :exc:`TypeError`, :exc:`SyntaxError`, :exc:" "`MemoryError` and :exc:`RecursionError` depending on the malformed input." msgstr "" -#: library/ast.rst:2260 +#: library/ast.rst:2264 msgid "Now allows bytes and set literals." msgstr "" -#: library/ast.rst:2263 +#: library/ast.rst:2267 msgid "Now supports creating empty sets with ``'set()'``." msgstr "" -#: library/ast.rst:2266 +#: library/ast.rst:2270 msgid "For string inputs, leading spaces and tabs are now stripped." msgstr "" -#: library/ast.rst:2272 +#: library/ast.rst:2276 msgid "" "Return the docstring of the given *node* (which must be a :class:" "`FunctionDef`, :class:`AsyncFunctionDef`, :class:`ClassDef`, or :class:" @@ -1165,11 +1172,11 @@ msgid "" "clean up the docstring's indentation with :func:`inspect.cleandoc`." msgstr "" -#: library/ast.rst:2278 +#: library/ast.rst:2282 msgid ":class:`AsyncFunctionDef` is now supported." msgstr "" -#: library/ast.rst:2284 +#: library/ast.rst:2288 msgid "" "Get source code segment of the *source* that generated *node*. If some " "location information (:attr:`~ast.AST.lineno`, :attr:`~ast.AST.end_lineno`, :" @@ -1177,13 +1184,13 @@ msgid "" "return ``None``." msgstr "" -#: library/ast.rst:2288 +#: library/ast.rst:2292 msgid "" "If *padded* is ``True``, the first line of a multi-line statement will be " "padded with spaces to match its original position." msgstr "" -#: library/ast.rst:2296 +#: library/ast.rst:2300 msgid "" "When you compile a node tree with :func:`compile`, the compiler expects :" "attr:`~ast.AST.lineno` and :attr:`~ast.AST.col_offset` attributes for every " @@ -1193,81 +1200,81 @@ msgid "" "starting at *node*." msgstr "" -#: library/ast.rst:2305 +#: library/ast.rst:2309 msgid "" "Increment the line number and end line number of each node in the tree " "starting at *node* by *n*. This is useful to \"move code\" to a different " "location in a file." msgstr "" -#: library/ast.rst:2312 +#: library/ast.rst:2316 msgid "" "Copy source location (:attr:`~ast.AST.lineno`, :attr:`~ast.AST.col_offset`, :" "attr:`~ast.AST.end_lineno`, and :attr:`~ast.AST.end_col_offset`) from " "*old_node* to *new_node* if possible, and return *new_node*." msgstr "" -#: library/ast.rst:2319 +#: library/ast.rst:2323 msgid "" "Yield a tuple of ``(fieldname, value)`` for each field in ``node._fields`` " "that is present on *node*." msgstr "" -#: library/ast.rst:2325 +#: library/ast.rst:2329 msgid "" "Yield all direct child nodes of *node*, that is, all fields that are nodes " "and all items of fields that are lists of nodes." msgstr "" -#: library/ast.rst:2331 +#: library/ast.rst:2335 msgid "" "Recursively yield all descendant nodes in the tree starting at *node* " "(including *node* itself), in no specified order. This is useful if you " "only want to modify nodes in place and don't care about the context." msgstr "" -#: library/ast.rst:2338 +#: library/ast.rst:2342 msgid "" "A node visitor base class that walks the abstract syntax tree and calls a " "visitor function for every node found. This function may return a value " "which is forwarded by the :meth:`visit` method." msgstr "" -#: library/ast.rst:2342 +#: library/ast.rst:2346 msgid "" "This class is meant to be subclassed, with the subclass adding visitor " "methods." msgstr "" -#: library/ast.rst:2347 +#: library/ast.rst:2351 msgid "" "Visit a node. The default implementation calls the method called :samp:" "`self.visit_{classname}` where *classname* is the name of the node class, " "or :meth:`generic_visit` if that method doesn't exist." msgstr "" -#: library/ast.rst:2353 +#: library/ast.rst:2357 msgid "This visitor calls :meth:`visit` on all children of the node." msgstr "" -#: library/ast.rst:2355 +#: library/ast.rst:2359 msgid "" "Note that child nodes of nodes that have a custom visitor method won't be " "visited unless the visitor calls :meth:`generic_visit` or visits them itself." msgstr "" -#: library/ast.rst:2361 +#: library/ast.rst:2365 msgid "Handles all constant nodes." msgstr "" -#: library/ast.rst:2363 +#: library/ast.rst:2367 msgid "" "Don't use the :class:`NodeVisitor` if you want to apply changes to nodes " "during traversal. For this a special visitor exists (:class:" "`NodeTransformer`) that allows modifications." msgstr "" -#: library/ast.rst:2369 +#: library/ast.rst:2373 msgid "" "Methods :meth:`!visit_Num`, :meth:`!visit_Str`, :meth:`!visit_Bytes`, :meth:" "`!visit_NameConstant` and :meth:`!visit_Ellipsis` are deprecated now and " @@ -1275,13 +1282,13 @@ msgid "" "`visit_Constant` method to handle all constant nodes." msgstr "" -#: library/ast.rst:2377 +#: library/ast.rst:2381 msgid "" "A :class:`NodeVisitor` subclass that walks the abstract syntax tree and " "allows modification of nodes." msgstr "" -#: library/ast.rst:2380 +#: library/ast.rst:2384 msgid "" "The :class:`NodeTransformer` will walk the AST and use the return value of " "the visitor methods to replace or remove the old node. If the return value " @@ -1290,27 +1297,27 @@ msgid "" "may be the original node in which case no replacement takes place." msgstr "" -#: library/ast.rst:2386 +#: library/ast.rst:2390 msgid "" "Here is an example transformer that rewrites all occurrences of name lookups " "(``foo``) to ``data['foo']``::" msgstr "" -#: library/ast.rst:2398 +#: library/ast.rst:2402 msgid "" "Keep in mind that if the node you're operating on has child nodes you must " "either transform the child nodes yourself or call the :meth:`~ast." "NodeVisitor.generic_visit` method for the node first." msgstr "" -#: library/ast.rst:2402 +#: library/ast.rst:2406 msgid "" "For nodes that were part of a collection of statements (that applies to all " "statement nodes), the visitor may also return a list of nodes rather than " "just a single node." msgstr "" -#: library/ast.rst:2406 +#: library/ast.rst:2410 msgid "" "If :class:`NodeTransformer` introduces new nodes (that weren't part of " "original tree) without giving them location information (such as :attr:`~ast." @@ -1318,11 +1325,11 @@ msgid "" "sub-tree to recalculate the location information::" msgstr "" -#: library/ast.rst:2414 +#: library/ast.rst:2418 msgid "Usually you use the transformer like this::" msgstr "" -#: library/ast.rst:2421 +#: library/ast.rst:2425 msgid "" "Return a formatted dump of the tree in *node*. This is mainly useful for " "debugging purposes. If *annotate_fields* is true (by default), the returned " @@ -1333,7 +1340,7 @@ msgid "" "true." msgstr "" -#: library/ast.rst:2429 +#: library/ast.rst:2433 msgid "" "If *indent* is a non-negative integer or string, then the tree will be " "pretty-printed with that indent level. An indent level of 0, negative, or " @@ -1343,87 +1350,87 @@ msgid "" "string is used to indent each level." msgstr "" -#: library/ast.rst:2436 +#: library/ast.rst:2440 msgid "Added the *indent* option." msgstr "" -#: library/ast.rst:2443 +#: library/ast.rst:2447 msgid "Compiler Flags" msgstr "" -#: library/ast.rst:2445 +#: library/ast.rst:2449 msgid "" "The following flags may be passed to :func:`compile` in order to change " "effects on the compilation of a program:" msgstr "" -#: library/ast.rst:2450 +#: library/ast.rst:2454 msgid "" "Enables support for top-level ``await``, ``async for``, ``async with`` and " "async comprehensions." msgstr "" -#: library/ast.rst:2457 +#: library/ast.rst:2461 msgid "" "Generates and returns an abstract syntax tree instead of returning a " "compiled code object." msgstr "" -#: library/ast.rst:2462 +#: library/ast.rst:2466 msgid "" "Enables support for :pep:`484` and :pep:`526` style type comments (``# type: " "``, ``# type: ignore ``)." msgstr "" -#: library/ast.rst:2471 +#: library/ast.rst:2475 msgid "Command-Line Usage" msgstr "" -#: library/ast.rst:2475 +#: library/ast.rst:2479 msgid "" "The :mod:`ast` module can be executed as a script from the command line. It " "is as simple as:" msgstr "" -#: library/ast.rst:2482 +#: library/ast.rst:2486 msgid "The following options are accepted:" msgstr "" -#: library/ast.rst:2488 +#: library/ast.rst:2492 msgid "Show the help message and exit." msgstr "" -#: library/ast.rst:2493 +#: library/ast.rst:2497 msgid "" "Specify what kind of code must be compiled, like the *mode* argument in :" "func:`parse`." msgstr "" -#: library/ast.rst:2498 +#: library/ast.rst:2502 msgid "Don't parse type comments." msgstr "" -#: library/ast.rst:2502 +#: library/ast.rst:2506 msgid "Include attributes such as line numbers and column offsets." msgstr "" -#: library/ast.rst:2507 +#: library/ast.rst:2511 msgid "Indentation of nodes in AST (number of spaces)." msgstr "" -#: library/ast.rst:2509 +#: library/ast.rst:2513 msgid "" "If :file:`infile` is specified its contents are parsed to AST and dumped to " "stdout. Otherwise, the content is read from stdin." msgstr "" -#: library/ast.rst:2515 +#: library/ast.rst:2519 msgid "" "`Green Tree Snakes `_, an external " "documentation resource, has good details on working with Python ASTs." msgstr "" -#: library/ast.rst:2518 +#: library/ast.rst:2522 msgid "" "`ASTTokens `_ " "annotates Python ASTs with the positions of tokens and text in the source " @@ -1431,21 +1438,21 @@ msgid "" "transformations." msgstr "" -#: library/ast.rst:2523 +#: library/ast.rst:2527 msgid "" "`leoAst.py `_ unifies the token-based and parse-tree-based views of python programs " "by inserting two-way links between tokens and ast nodes." msgstr "" -#: library/ast.rst:2528 +#: library/ast.rst:2532 msgid "" "`LibCST `_ parses code as a Concrete Syntax " "Tree that looks like an ast tree and keeps all formatting details. It's " "useful for building automated refactoring (codemod) applications and linters." msgstr "" -#: library/ast.rst:2533 +#: library/ast.rst:2537 msgid "" "`Parso `_ is a Python parser that supports " "error recovery and round-trip parsing for different Python versions (in " diff --git a/library/asyncio-eventloop.po b/library/asyncio-eventloop.po index 20cb71d2b..2c4f537d2 100644 --- a/library/asyncio-eventloop.po +++ b/library/asyncio-eventloop.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -252,8 +252,8 @@ msgid "" "used." msgstr "" -#: library/asyncio-eventloop.rst:176 library/asyncio-eventloop.rst:1242 -#: library/asyncio-eventloop.rst:1660 +#: library/asyncio-eventloop.rst:176 library/asyncio-eventloop.rst:1253 +#: library/asyncio-eventloop.rst:1671 msgid "Example::" msgstr "" @@ -528,8 +528,8 @@ msgstr "" msgid "The socket type will be :py:const:`~socket.SOCK_STREAM`." msgstr "" -#: library/asyncio-eventloop.rst:412 library/asyncio-eventloop.rst:1156 -#: library/asyncio-eventloop.rst:1172 +#: library/asyncio-eventloop.rst:412 library/asyncio-eventloop.rst:1164 +#: library/asyncio-eventloop.rst:1180 msgid "" "*protocol_factory* must be a callable returning an :ref:`asyncio protocol " "` implementation." @@ -866,7 +866,7 @@ msgid "" msgstr "" #: library/asyncio-eventloop.rst:652 library/asyncio-eventloop.rst:794 -#: library/asyncio-eventloop.rst:1225 +#: library/asyncio-eventloop.rst:1233 msgid ":ref:`Availability `: Unix." msgstr "" @@ -1183,7 +1183,7 @@ msgid "" "*callback* with the specified arguments once *fd* is available for writing." msgstr "" -#: library/asyncio-eventloop.rst:955 library/asyncio-eventloop.rst:1212 +#: library/asyncio-eventloop.rst:955 library/asyncio-eventloop.rst:1220 msgid "" "Use :func:`functools.partial` :ref:`to pass keyword arguments ` to *callback*." @@ -1388,7 +1388,17 @@ msgstr "" msgid "Asynchronous version of :meth:`socket.getnameinfo`." msgstr "" -#: library/asyncio-eventloop.rst:1142 +#: library/asyncio-eventloop.rst:1143 +msgid "" +"Both *getaddrinfo* and *getnameinfo* internally utilize their synchronous " +"versions through the loop's default thread pool executor. When this executor " +"is saturated, these methods may experience delays, which higher-level " +"networking libraries may report as increased timeouts. To mitigate this, " +"consider using a custom executor for other user tasks, or setting a default " +"executor with a larger number of workers." +msgstr "" + +#: library/asyncio-eventloop.rst:1150 msgid "" "Both *getaddrinfo* and *getnameinfo* methods were always documented to " "return a coroutine, but prior to Python 3.7 they were, in fact, returning :" @@ -1396,66 +1406,66 @@ msgid "" "coroutines." msgstr "" -#: library/asyncio-eventloop.rst:1150 +#: library/asyncio-eventloop.rst:1158 msgid "Working with pipes" msgstr "" -#: library/asyncio-eventloop.rst:1154 +#: library/asyncio-eventloop.rst:1162 msgid "Register the read end of *pipe* in the event loop." msgstr "" -#: library/asyncio-eventloop.rst:1159 +#: library/asyncio-eventloop.rst:1167 msgid "*pipe* is a :term:`file-like object `." msgstr "" -#: library/asyncio-eventloop.rst:1161 +#: library/asyncio-eventloop.rst:1169 msgid "" "Return pair ``(transport, protocol)``, where *transport* supports the :class:" "`ReadTransport` interface and *protocol* is an object instantiated by the " "*protocol_factory*." msgstr "" -#: library/asyncio-eventloop.rst:1165 library/asyncio-eventloop.rst:1181 +#: library/asyncio-eventloop.rst:1173 library/asyncio-eventloop.rst:1189 msgid "" "With :class:`SelectorEventLoop` event loop, the *pipe* is set to non-" "blocking mode." msgstr "" -#: library/asyncio-eventloop.rst:1170 +#: library/asyncio-eventloop.rst:1178 msgid "Register the write end of *pipe* in the event loop." msgstr "" -#: library/asyncio-eventloop.rst:1175 +#: library/asyncio-eventloop.rst:1183 msgid "*pipe* is :term:`file-like object `." msgstr "" -#: library/asyncio-eventloop.rst:1177 +#: library/asyncio-eventloop.rst:1185 msgid "" "Return pair ``(transport, protocol)``, where *transport* supports :class:" "`WriteTransport` interface and *protocol* is an object instantiated by the " "*protocol_factory*." msgstr "" -#: library/asyncio-eventloop.rst:1186 +#: library/asyncio-eventloop.rst:1194 msgid "" ":class:`SelectorEventLoop` does not support the above methods on Windows. " "Use :class:`ProactorEventLoop` instead for Windows." msgstr "" -#: library/asyncio-eventloop.rst:1191 +#: library/asyncio-eventloop.rst:1199 msgid "" "The :meth:`loop.subprocess_exec` and :meth:`loop.subprocess_shell` methods." msgstr "" -#: library/asyncio-eventloop.rst:1196 +#: library/asyncio-eventloop.rst:1204 msgid "Unix signals" msgstr "" -#: library/asyncio-eventloop.rst:1202 +#: library/asyncio-eventloop.rst:1210 msgid "Set *callback* as the handler for the *signum* signal." msgstr "" -#: library/asyncio-eventloop.rst:1204 +#: library/asyncio-eventloop.rst:1212 msgid "" "The callback will be invoked by *loop*, along with other queued callbacks " "and runnable coroutines of that event loop. Unlike signal handlers " @@ -1463,46 +1473,49 @@ msgid "" "function is allowed to interact with the event loop." msgstr "" -#: library/asyncio-eventloop.rst:1209 +#: library/asyncio-eventloop.rst:1217 msgid "" "Raise :exc:`ValueError` if the signal number is invalid or uncatchable. " "Raise :exc:`RuntimeError` if there is a problem setting up the handler." msgstr "" -#: library/asyncio-eventloop.rst:1215 +#: library/asyncio-eventloop.rst:1223 msgid "" "Like :func:`signal.signal`, this function must be invoked in the main thread." msgstr "" -#: library/asyncio-eventloop.rst:1220 +#: library/asyncio-eventloop.rst:1228 msgid "Remove the handler for the *sig* signal." msgstr "" -#: library/asyncio-eventloop.rst:1222 +#: library/asyncio-eventloop.rst:1230 msgid "" "Return ``True`` if the signal handler was removed, or ``False`` if no " "handler was set for the given signal." msgstr "" -#: library/asyncio-eventloop.rst:1229 +#: library/asyncio-eventloop.rst:1237 msgid "The :mod:`signal` module." msgstr "" -#: library/asyncio-eventloop.rst:1233 +#: library/asyncio-eventloop.rst:1241 msgid "Executing code in thread or process pools" msgstr "" -#: library/asyncio-eventloop.rst:1237 +#: library/asyncio-eventloop.rst:1245 msgid "Arrange for *func* to be called in the specified executor." msgstr "" -#: library/asyncio-eventloop.rst:1239 +#: library/asyncio-eventloop.rst:1247 msgid "" "The *executor* argument should be an :class:`concurrent.futures.Executor` " -"instance. The default executor is used if *executor* is ``None``." +"instance. The default executor is used if *executor* is ``None``. The " +"default executor can be set by :meth:`loop.set_default_executor`, otherwise, " +"a :class:`concurrent.futures.ThreadPoolExecutor` will be lazy-initialized " +"and used by :func:`run_in_executor` if needed." msgstr "" -#: library/asyncio-eventloop.rst:1284 +#: library/asyncio-eventloop.rst:1295 msgid "" "Note that the entry point guard (``if __name__ == '__main__'``) is required " "for option 3 due to the peculiarities of :mod:`multiprocessing`, which is " @@ -1510,17 +1523,17 @@ msgid "" "importing of main module `." msgstr "" -#: library/asyncio-eventloop.rst:1289 +#: library/asyncio-eventloop.rst:1300 msgid "This method returns a :class:`asyncio.Future` object." msgstr "" -#: library/asyncio-eventloop.rst:1291 +#: library/asyncio-eventloop.rst:1302 msgid "" "Use :func:`functools.partial` :ref:`to pass keyword arguments ` to *func*." msgstr "" -#: library/asyncio-eventloop.rst:1294 +#: library/asyncio-eventloop.rst:1305 msgid "" ":meth:`loop.run_in_executor` no longer configures the ``max_workers`` of the " "thread pool executor it creates, instead leaving it up to the thread pool " @@ -1528,32 +1541,32 @@ msgid "" "default." msgstr "" -#: library/asyncio-eventloop.rst:1303 +#: library/asyncio-eventloop.rst:1314 msgid "" "Set *executor* as the default executor used by :meth:`run_in_executor`. " "*executor* must be an instance of :class:`~concurrent.futures." "ThreadPoolExecutor`." msgstr "" -#: library/asyncio-eventloop.rst:1307 +#: library/asyncio-eventloop.rst:1318 msgid "" "*executor* must be an instance of :class:`~concurrent.futures." "ThreadPoolExecutor`." msgstr "" -#: library/asyncio-eventloop.rst:1313 +#: library/asyncio-eventloop.rst:1324 msgid "Error Handling API" msgstr "" -#: library/asyncio-eventloop.rst:1315 +#: library/asyncio-eventloop.rst:1326 msgid "Allows customizing how exceptions are handled in the event loop." msgstr "" -#: library/asyncio-eventloop.rst:1319 +#: library/asyncio-eventloop.rst:1330 msgid "Set *handler* as the new event loop exception handler." msgstr "" -#: library/asyncio-eventloop.rst:1321 +#: library/asyncio-eventloop.rst:1332 msgid "" "If *handler* is ``None``, the default exception handler will be set. " "Otherwise, *handler* must be a callable with the signature matching ``(loop, " @@ -1562,182 +1575,182 @@ msgid "" "(see :meth:`call_exception_handler` documentation for details about context)." msgstr "" -#: library/asyncio-eventloop.rst:1329 +#: library/asyncio-eventloop.rst:1340 msgid "" "If the handler is called on behalf of a :class:`~asyncio.Task` or :class:" "`~asyncio.Handle`, it is run in the :class:`contextvars.Context` of that " "task or callback handle." msgstr "" -#: library/asyncio-eventloop.rst:1335 +#: library/asyncio-eventloop.rst:1346 msgid "" "The handler may be called in the :class:`~contextvars.Context` of the task " "or handle where the exception originated." msgstr "" -#: library/asyncio-eventloop.rst:1340 +#: library/asyncio-eventloop.rst:1351 msgid "" "Return the current exception handler, or ``None`` if no custom exception " "handler was set." msgstr "" -#: library/asyncio-eventloop.rst:1347 +#: library/asyncio-eventloop.rst:1358 msgid "Default exception handler." msgstr "" -#: library/asyncio-eventloop.rst:1349 +#: library/asyncio-eventloop.rst:1360 msgid "" "This is called when an exception occurs and no exception handler is set. " "This can be called by a custom exception handler that wants to defer to the " "default handler behavior." msgstr "" -#: library/asyncio-eventloop.rst:1353 +#: library/asyncio-eventloop.rst:1364 msgid "" "*context* parameter has the same meaning as in :meth:" "`call_exception_handler`." msgstr "" -#: library/asyncio-eventloop.rst:1358 +#: library/asyncio-eventloop.rst:1369 msgid "Call the current event loop exception handler." msgstr "" -#: library/asyncio-eventloop.rst:1360 +#: library/asyncio-eventloop.rst:1371 msgid "" "*context* is a ``dict`` object containing the following keys (new keys may " "be introduced in future Python versions):" msgstr "" -#: library/asyncio-eventloop.rst:1363 +#: library/asyncio-eventloop.rst:1374 msgid "'message': Error message;" msgstr "" -#: library/asyncio-eventloop.rst:1364 +#: library/asyncio-eventloop.rst:1375 msgid "'exception' (optional): Exception object;" msgstr "" -#: library/asyncio-eventloop.rst:1365 +#: library/asyncio-eventloop.rst:1376 msgid "'future' (optional): :class:`asyncio.Future` instance;" msgstr "" -#: library/asyncio-eventloop.rst:1366 +#: library/asyncio-eventloop.rst:1377 msgid "'task' (optional): :class:`asyncio.Task` instance;" msgstr "" -#: library/asyncio-eventloop.rst:1367 +#: library/asyncio-eventloop.rst:1378 msgid "'handle' (optional): :class:`asyncio.Handle` instance;" msgstr "" -#: library/asyncio-eventloop.rst:1368 +#: library/asyncio-eventloop.rst:1379 msgid "'protocol' (optional): :ref:`Protocol ` instance;" msgstr "" -#: library/asyncio-eventloop.rst:1369 +#: library/asyncio-eventloop.rst:1380 msgid "'transport' (optional): :ref:`Transport ` instance;" msgstr "" -#: library/asyncio-eventloop.rst:1370 +#: library/asyncio-eventloop.rst:1381 msgid "'socket' (optional): :class:`socket.socket` instance;" msgstr "" -#: library/asyncio-eventloop.rst:1371 +#: library/asyncio-eventloop.rst:1382 msgid "'asyncgen' (optional): Asynchronous generator that caused" msgstr "" -#: library/asyncio-eventloop.rst:1372 +#: library/asyncio-eventloop.rst:1383 msgid "the exception." msgstr "" -#: library/asyncio-eventloop.rst:1376 +#: library/asyncio-eventloop.rst:1387 msgid "" "This method should not be overloaded in subclassed event loops. For custom " "exception handling, use the :meth:`set_exception_handler()` method." msgstr "" -#: library/asyncio-eventloop.rst:1381 +#: library/asyncio-eventloop.rst:1392 msgid "Enabling debug mode" msgstr "" -#: library/asyncio-eventloop.rst:1385 +#: library/asyncio-eventloop.rst:1396 msgid "Get the debug mode (:class:`bool`) of the event loop." msgstr "" -#: library/asyncio-eventloop.rst:1387 +#: library/asyncio-eventloop.rst:1398 msgid "" "The default value is ``True`` if the environment variable :envvar:" "`PYTHONASYNCIODEBUG` is set to a non-empty string, ``False`` otherwise." msgstr "" -#: library/asyncio-eventloop.rst:1393 +#: library/asyncio-eventloop.rst:1404 msgid "Set the debug mode of the event loop." msgstr "" -#: library/asyncio-eventloop.rst:1397 +#: library/asyncio-eventloop.rst:1408 msgid "" "The new :ref:`Python Development Mode ` can now also be used to " "enable the debug mode." msgstr "" -#: library/asyncio-eventloop.rst:1402 +#: library/asyncio-eventloop.rst:1413 msgid "" "This attribute can be used to set the minimum execution duration in seconds " "that is considered \"slow\". When debug mode is enabled, \"slow\" callbacks " "are logged." msgstr "" -#: library/asyncio-eventloop.rst:1406 +#: library/asyncio-eventloop.rst:1417 msgid "Default value is 100 milliseconds." msgstr "" -#: library/asyncio-eventloop.rst:1410 +#: library/asyncio-eventloop.rst:1421 msgid "The :ref:`debug mode of asyncio `." msgstr "" -#: library/asyncio-eventloop.rst:1414 +#: library/asyncio-eventloop.rst:1425 msgid "Running Subprocesses" msgstr "" -#: library/asyncio-eventloop.rst:1416 +#: library/asyncio-eventloop.rst:1427 msgid "" "Methods described in this subsections are low-level. In regular async/await " "code consider using the high-level :func:`asyncio.create_subprocess_shell` " "and :func:`asyncio.create_subprocess_exec` convenience functions instead." msgstr "" -#: library/asyncio-eventloop.rst:1423 +#: library/asyncio-eventloop.rst:1434 msgid "" "On Windows, the default event loop :class:`ProactorEventLoop` supports " "subprocesses, whereas :class:`SelectorEventLoop` does not. See :ref:" "`Subprocess Support on Windows ` for details." msgstr "" -#: library/asyncio-eventloop.rst:1434 +#: library/asyncio-eventloop.rst:1445 msgid "" "Create a subprocess from one or more string arguments specified by *args*." msgstr "" -#: library/asyncio-eventloop.rst:1437 +#: library/asyncio-eventloop.rst:1448 msgid "*args* must be a list of strings represented by:" msgstr "" -#: library/asyncio-eventloop.rst:1439 +#: library/asyncio-eventloop.rst:1450 msgid ":class:`str`;" msgstr "" -#: library/asyncio-eventloop.rst:1440 +#: library/asyncio-eventloop.rst:1451 msgid "" "or :class:`bytes`, encoded to the :ref:`filesystem encoding `." msgstr "" -#: library/asyncio-eventloop.rst:1443 +#: library/asyncio-eventloop.rst:1454 msgid "" "The first string specifies the program executable, and the remaining strings " "specify the arguments. Together, string arguments form the ``argv`` of the " "program." msgstr "" -#: library/asyncio-eventloop.rst:1447 +#: library/asyncio-eventloop.rst:1458 msgid "" "This is similar to the standard library :class:`subprocess.Popen` class " "called with ``shell=False`` and the list of strings passed as the first " @@ -1745,81 +1758,81 @@ msgid "" "which is list of strings, *subprocess_exec* takes multiple string arguments." msgstr "" -#: library/asyncio-eventloop.rst:1453 +#: library/asyncio-eventloop.rst:1464 msgid "" "The *protocol_factory* must be a callable returning a subclass of the :class:" "`asyncio.SubprocessProtocol` class." msgstr "" -#: library/asyncio-eventloop.rst:1456 +#: library/asyncio-eventloop.rst:1467 msgid "Other parameters:" msgstr "" -#: library/asyncio-eventloop.rst:1458 +#: library/asyncio-eventloop.rst:1469 msgid "*stdin* can be any of these:" msgstr "" -#: library/asyncio-eventloop.rst:1460 library/asyncio-eventloop.rst:1471 -#: library/asyncio-eventloop.rst:1481 +#: library/asyncio-eventloop.rst:1471 library/asyncio-eventloop.rst:1482 +#: library/asyncio-eventloop.rst:1492 msgid "a file-like object" msgstr "" -#: library/asyncio-eventloop.rst:1461 +#: library/asyncio-eventloop.rst:1472 msgid "" "an existing file descriptor (a positive integer), for example those created " "with :meth:`os.pipe()`" msgstr "" -#: library/asyncio-eventloop.rst:1462 library/asyncio-eventloop.rst:1472 -#: library/asyncio-eventloop.rst:1482 +#: library/asyncio-eventloop.rst:1473 library/asyncio-eventloop.rst:1483 +#: library/asyncio-eventloop.rst:1493 msgid "" "the :const:`subprocess.PIPE` constant (default) which will create a new pipe " "and connect it," msgstr "" -#: library/asyncio-eventloop.rst:1464 library/asyncio-eventloop.rst:1474 -#: library/asyncio-eventloop.rst:1484 +#: library/asyncio-eventloop.rst:1475 library/asyncio-eventloop.rst:1485 +#: library/asyncio-eventloop.rst:1495 msgid "" "the value ``None`` which will make the subprocess inherit the file " "descriptor from this process" msgstr "" -#: library/asyncio-eventloop.rst:1466 library/asyncio-eventloop.rst:1476 -#: library/asyncio-eventloop.rst:1486 +#: library/asyncio-eventloop.rst:1477 library/asyncio-eventloop.rst:1487 +#: library/asyncio-eventloop.rst:1497 msgid "" "the :const:`subprocess.DEVNULL` constant which indicates that the special :" "data:`os.devnull` file will be used" msgstr "" -#: library/asyncio-eventloop.rst:1469 +#: library/asyncio-eventloop.rst:1480 msgid "*stdout* can be any of these:" msgstr "" -#: library/asyncio-eventloop.rst:1479 +#: library/asyncio-eventloop.rst:1490 msgid "*stderr* can be any of these:" msgstr "" -#: library/asyncio-eventloop.rst:1488 +#: library/asyncio-eventloop.rst:1499 msgid "" "the :const:`subprocess.STDOUT` constant which will connect the standard " "error stream to the process' standard output stream" msgstr "" -#: library/asyncio-eventloop.rst:1491 +#: library/asyncio-eventloop.rst:1502 msgid "" "All other keyword arguments are passed to :class:`subprocess.Popen` without " "interpretation, except for *bufsize*, *universal_newlines*, *shell*, *text*, " "*encoding* and *errors*, which should not be specified at all." msgstr "" -#: library/asyncio-eventloop.rst:1496 +#: library/asyncio-eventloop.rst:1507 msgid "" "The ``asyncio`` subprocess API does not support decoding the streams as " "text. :func:`bytes.decode` can be used to convert the bytes returned from " "the stream to text." msgstr "" -#: library/asyncio-eventloop.rst:1500 +#: library/asyncio-eventloop.rst:1511 msgid "" "If a file-like object passed as *stdin*, *stdout* or *stderr* represents a " "pipe, then the other side of this pipe should be registered with :meth:" @@ -1827,52 +1840,52 @@ msgid "" "the event loop." msgstr "" -#: library/asyncio-eventloop.rst:1505 +#: library/asyncio-eventloop.rst:1516 msgid "" "See the constructor of the :class:`subprocess.Popen` class for documentation " "on other arguments." msgstr "" -#: library/asyncio-eventloop.rst:1508 +#: library/asyncio-eventloop.rst:1519 msgid "" "Returns a pair of ``(transport, protocol)``, where *transport* conforms to " "the :class:`asyncio.SubprocessTransport` base class and *protocol* is an " "object instantiated by the *protocol_factory*." msgstr "" -#: library/asyncio-eventloop.rst:1516 +#: library/asyncio-eventloop.rst:1527 msgid "" "Create a subprocess from *cmd*, which can be a :class:`str` or a :class:" "`bytes` string encoded to the :ref:`filesystem encoding `, using the platform's \"shell\" syntax." msgstr "" -#: library/asyncio-eventloop.rst:1521 +#: library/asyncio-eventloop.rst:1532 msgid "" "This is similar to the standard library :class:`subprocess.Popen` class " "called with ``shell=True``." msgstr "" -#: library/asyncio-eventloop.rst:1524 +#: library/asyncio-eventloop.rst:1535 msgid "" "The *protocol_factory* must be a callable returning a subclass of the :class:" "`SubprocessProtocol` class." msgstr "" -#: library/asyncio-eventloop.rst:1527 +#: library/asyncio-eventloop.rst:1538 msgid "" "See :meth:`~loop.subprocess_exec` for more details about the remaining " "arguments." msgstr "" -#: library/asyncio-eventloop.rst:1530 +#: library/asyncio-eventloop.rst:1541 msgid "" "Returns a pair of ``(transport, protocol)``, where *transport* conforms to " "the :class:`SubprocessTransport` base class and *protocol* is an object " "instantiated by the *protocol_factory*." msgstr "" -#: library/asyncio-eventloop.rst:1535 +#: library/asyncio-eventloop.rst:1546 msgid "" "It is the application's responsibility to ensure that all whitespace and " "special characters are quoted appropriately to avoid `shell injection " @@ -1882,116 +1895,116 @@ msgid "" "used to construct shell commands." msgstr "" -#: library/asyncio-eventloop.rst:1544 +#: library/asyncio-eventloop.rst:1555 msgid "Callback Handles" msgstr "" -#: library/asyncio-eventloop.rst:1548 +#: library/asyncio-eventloop.rst:1559 msgid "" "A callback wrapper object returned by :meth:`loop.call_soon`, :meth:`loop." "call_soon_threadsafe`." msgstr "" -#: library/asyncio-eventloop.rst:1553 +#: library/asyncio-eventloop.rst:1564 msgid "" "Return the :class:`contextvars.Context` object associated with the handle." msgstr "" -#: library/asyncio-eventloop.rst:1560 +#: library/asyncio-eventloop.rst:1571 msgid "" "Cancel the callback. If the callback has already been canceled or executed, " "this method has no effect." msgstr "" -#: library/asyncio-eventloop.rst:1565 +#: library/asyncio-eventloop.rst:1576 msgid "Return ``True`` if the callback was cancelled." msgstr "" -#: library/asyncio-eventloop.rst:1571 +#: library/asyncio-eventloop.rst:1582 msgid "" "A callback wrapper object returned by :meth:`loop.call_later`, and :meth:" "`loop.call_at`." msgstr "" -#: library/asyncio-eventloop.rst:1574 +#: library/asyncio-eventloop.rst:1585 msgid "This class is a subclass of :class:`Handle`." msgstr "" -#: library/asyncio-eventloop.rst:1578 +#: library/asyncio-eventloop.rst:1589 msgid "Return a scheduled callback time as :class:`float` seconds." msgstr "" -#: library/asyncio-eventloop.rst:1580 +#: library/asyncio-eventloop.rst:1591 msgid "" "The time is an absolute timestamp, using the same time reference as :meth:" "`loop.time`." msgstr "" -#: library/asyncio-eventloop.rst:1587 +#: library/asyncio-eventloop.rst:1598 msgid "Server Objects" msgstr "" -#: library/asyncio-eventloop.rst:1589 +#: library/asyncio-eventloop.rst:1600 msgid "" "Server objects are created by :meth:`loop.create_server`, :meth:`loop." "create_unix_server`, :func:`start_server`, and :func:`start_unix_server` " "functions." msgstr "" -#: library/asyncio-eventloop.rst:1593 +#: library/asyncio-eventloop.rst:1604 msgid "Do not instantiate the :class:`Server` class directly." msgstr "" -#: library/asyncio-eventloop.rst:1597 +#: library/asyncio-eventloop.rst:1608 msgid "" "*Server* objects are asynchronous context managers. When used in an ``async " "with`` statement, it's guaranteed that the Server object is closed and not " "accepting new connections when the ``async with`` statement is completed::" msgstr "" -#: library/asyncio-eventloop.rst:1610 +#: library/asyncio-eventloop.rst:1621 msgid "Server object is an asynchronous context manager since Python 3.7." msgstr "" -#: library/asyncio-eventloop.rst:1613 +#: library/asyncio-eventloop.rst:1624 msgid "" "This class was exposed publicly as ``asyncio.Server`` in Python 3.9.11, " "3.10.3 and 3.11." msgstr "" -#: library/asyncio-eventloop.rst:1618 +#: library/asyncio-eventloop.rst:1629 msgid "" "Stop serving: close listening sockets and set the :attr:`sockets` attribute " "to ``None``." msgstr "" -#: library/asyncio-eventloop.rst:1621 +#: library/asyncio-eventloop.rst:1632 msgid "" "The sockets that represent existing incoming client connections are left " "open." msgstr "" -#: library/asyncio-eventloop.rst:1624 +#: library/asyncio-eventloop.rst:1635 msgid "" "The server is closed asynchronously; use the :meth:`wait_closed` coroutine " "to wait until the server is closed (and no more connections are active)." msgstr "" -#: library/asyncio-eventloop.rst:1630 +#: library/asyncio-eventloop.rst:1641 msgid "Return the event loop associated with the server object." msgstr "" -#: library/asyncio-eventloop.rst:1636 +#: library/asyncio-eventloop.rst:1647 msgid "Start accepting connections." msgstr "" -#: library/asyncio-eventloop.rst:1638 +#: library/asyncio-eventloop.rst:1649 msgid "" "This method is idempotent, so it can be called when the server is already " "serving." msgstr "" -#: library/asyncio-eventloop.rst:1641 +#: library/asyncio-eventloop.rst:1652 msgid "" "The *start_serving* keyword-only parameter to :meth:`loop.create_server` " "and :meth:`asyncio.start_server` allows creating a Server object that is not " @@ -2000,100 +2013,100 @@ msgid "" "accepting connections." msgstr "" -#: library/asyncio-eventloop.rst:1652 +#: library/asyncio-eventloop.rst:1663 msgid "" "Start accepting connections until the coroutine is cancelled. Cancellation " "of ``serve_forever`` task causes the server to be closed." msgstr "" -#: library/asyncio-eventloop.rst:1656 +#: library/asyncio-eventloop.rst:1667 msgid "" "This method can be called if the server is already accepting connections. " "Only one ``serve_forever`` task can exist per one *Server* object." msgstr "" -#: library/asyncio-eventloop.rst:1678 +#: library/asyncio-eventloop.rst:1689 msgid "Return ``True`` if the server is accepting new connections." msgstr "" -#: library/asyncio-eventloop.rst:1684 +#: library/asyncio-eventloop.rst:1695 msgid "" "Wait until the :meth:`close` method completes and all active connections " "have finished." msgstr "" -#: library/asyncio-eventloop.rst:1689 +#: library/asyncio-eventloop.rst:1700 msgid "" "List of socket-like objects, ``asyncio.trsock.TransportSocket``, which the " "server is listening on." msgstr "" -#: library/asyncio-eventloop.rst:1692 +#: library/asyncio-eventloop.rst:1703 msgid "" "Prior to Python 3.7 ``Server.sockets`` used to return an internal list of " "server sockets directly. In 3.7 a copy of that list is returned." msgstr "" -#: library/asyncio-eventloop.rst:1702 +#: library/asyncio-eventloop.rst:1713 msgid "Event Loop Implementations" msgstr "" -#: library/asyncio-eventloop.rst:1704 +#: library/asyncio-eventloop.rst:1715 msgid "" "asyncio ships with two different event loop implementations: :class:" "`SelectorEventLoop` and :class:`ProactorEventLoop`." msgstr "" -#: library/asyncio-eventloop.rst:1707 +#: library/asyncio-eventloop.rst:1718 msgid "" "By default asyncio is configured to use :class:`SelectorEventLoop` on Unix " "and :class:`ProactorEventLoop` on Windows." msgstr "" -#: library/asyncio-eventloop.rst:1713 +#: library/asyncio-eventloop.rst:1724 msgid "An event loop based on the :mod:`selectors` module." msgstr "" -#: library/asyncio-eventloop.rst:1715 +#: library/asyncio-eventloop.rst:1726 msgid "" "Uses the most efficient *selector* available for the given platform. It is " "also possible to manually configure the exact selector implementation to be " "used::" msgstr "" -#: library/asyncio-eventloop.rst:1730 +#: library/asyncio-eventloop.rst:1741 msgid ":ref:`Availability `: Unix, Windows." msgstr "" -#: library/asyncio-eventloop.rst:1735 +#: library/asyncio-eventloop.rst:1746 msgid "An event loop for Windows that uses \"I/O Completion Ports\" (IOCP)." msgstr "" -#: library/asyncio-eventloop.rst:1737 +#: library/asyncio-eventloop.rst:1748 msgid ":ref:`Availability `: Windows." msgstr "" -#: library/asyncio-eventloop.rst:1741 +#: library/asyncio-eventloop.rst:1752 msgid "" "`MSDN documentation on I/O Completion Ports `_." msgstr "" -#: library/asyncio-eventloop.rst:1747 +#: library/asyncio-eventloop.rst:1758 msgid "Abstract base class for asyncio-compliant event loops." msgstr "" -#: library/asyncio-eventloop.rst:1749 +#: library/asyncio-eventloop.rst:1760 msgid "" "The :ref:`asyncio-event-loop-methods` section lists all methods that an " "alternative implementation of ``AbstractEventLoop`` should have defined." msgstr "" -#: library/asyncio-eventloop.rst:1755 +#: library/asyncio-eventloop.rst:1766 msgid "Examples" msgstr "" -#: library/asyncio-eventloop.rst:1757 +#: library/asyncio-eventloop.rst:1768 msgid "" "Note that all examples in this section **purposefully** show how to use the " "low-level event loop APIs, such as :meth:`loop.run_forever` and :meth:`loop." @@ -2101,70 +2114,70 @@ msgid "" "consider using the high-level functions like :func:`asyncio.run`." msgstr "" -#: library/asyncio-eventloop.rst:1767 +#: library/asyncio-eventloop.rst:1778 msgid "Hello World with call_soon()" msgstr "" -#: library/asyncio-eventloop.rst:1769 +#: library/asyncio-eventloop.rst:1780 msgid "" "An example using the :meth:`loop.call_soon` method to schedule a callback. " "The callback displays ``\"Hello World\"`` and then stops the event loop::" msgstr "" -#: library/asyncio-eventloop.rst:1793 +#: library/asyncio-eventloop.rst:1804 msgid "" "A similar :ref:`Hello World ` example created with a coroutine " "and the :func:`run` function." msgstr "" -#: library/asyncio-eventloop.rst:1800 +#: library/asyncio-eventloop.rst:1811 msgid "Display the current date with call_later()" msgstr "" -#: library/asyncio-eventloop.rst:1802 +#: library/asyncio-eventloop.rst:1813 msgid "" "An example of a callback displaying the current date every second. The " "callback uses the :meth:`loop.call_later` method to reschedule itself after " "5 seconds, and then stops the event loop::" msgstr "" -#: library/asyncio-eventloop.rst:1830 +#: library/asyncio-eventloop.rst:1841 msgid "" "A similar :ref:`current date ` example created with a " "coroutine and the :func:`run` function." msgstr "" -#: library/asyncio-eventloop.rst:1837 +#: library/asyncio-eventloop.rst:1848 msgid "Watch a file descriptor for read events" msgstr "" -#: library/asyncio-eventloop.rst:1839 +#: library/asyncio-eventloop.rst:1850 msgid "" "Wait until a file descriptor received some data using the :meth:`loop." "add_reader` method and then close the event loop::" msgstr "" -#: library/asyncio-eventloop.rst:1877 +#: library/asyncio-eventloop.rst:1888 msgid "" "A similar :ref:`example ` using " "transports, protocols, and the :meth:`loop.create_connection` method." msgstr "" -#: library/asyncio-eventloop.rst:1881 +#: library/asyncio-eventloop.rst:1892 msgid "" "Another similar :ref:`example ` " "using the high-level :func:`asyncio.open_connection` function and streams." msgstr "" -#: library/asyncio-eventloop.rst:1889 +#: library/asyncio-eventloop.rst:1900 msgid "Set signal handlers for SIGINT and SIGTERM" msgstr "" -#: library/asyncio-eventloop.rst:1891 +#: library/asyncio-eventloop.rst:1902 msgid "(This ``signals`` example only works on Unix.)" msgstr "" -#: library/asyncio-eventloop.rst:1893 +#: library/asyncio-eventloop.rst:1904 msgid "" "Register handlers for signals :const:`~signal.SIGINT` and :const:`~signal." "SIGTERM` using the :meth:`loop.add_signal_handler` method::" diff --git a/library/asyncio-future.po b/library/asyncio-future.po index 9f1a5552c..b5901db58 100644 --- a/library/asyncio-future.po +++ b/library/asyncio-future.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -179,7 +179,7 @@ msgstr "" #: library/asyncio-future.rst:122 msgid "" -"If the Future's result isn't yet available, this method raises a :exc:" +"If the Future's result isn't yet available, this method raises an :exc:" "`InvalidStateError` exception." msgstr "" @@ -189,7 +189,7 @@ msgstr "" #: library/asyncio-future.rst:136 msgid "" -"Raises a :exc:`InvalidStateError` error if the Future is already *done*." +"Raises an :exc:`InvalidStateError` error if the Future is already *done*." msgstr "" #: library/asyncio-future.rst:134 diff --git a/library/asyncio-task.po b/library/asyncio-task.po index 62ae094a2..3ed3cf890 100644 --- a/library/asyncio-task.po +++ b/library/asyncio-task.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1047,7 +1047,7 @@ msgstr "" #: library/asyncio-task.rst:1106 msgid "" -"If the Task's result isn't yet available, this method raises a :exc:" +"If the Task's result isn't yet available, this method raises an :exc:" "`InvalidStateError` exception." msgstr "" diff --git a/library/asyncio.po b/library/asyncio.po index b98b9f01d..02105d298 100644 --- a/library/asyncio.po +++ b/library/asyncio.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2024-07-06 18:16+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -16,15 +16,15 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -#: library/asyncio.rst:80 +#: library/asyncio.rst:87 msgid "High-level APIs" msgstr "Yüksek seviye API'lar" -#: library/asyncio.rst:92 +#: library/asyncio.rst:99 msgid "Low-level APIs" msgstr "Düşük seviye API'lar" -#: library/asyncio.rst:103 +#: library/asyncio.rst:110 msgid "Guides and Tutorials" msgstr "Rehberler ve Eğitimler" @@ -127,11 +127,6 @@ msgstr "" "geribildirim tabanlı kütüphane ve kodları :ref:`köprüleyerek ` async/await sözdizimi ile birleştirin." -#: library/asyncio.rst:61 -msgid "You can experiment with an ``asyncio`` concurrent context in the REPL:" -msgstr "" -"REPL üzerinde ``asyncio`` ile eşzamanlı bağlamda denemeler yapabilirsiniz:" - #: includes/wasm-notavail.rst:3 msgid ":ref:`Availability `: not Emscripten, not WASI." msgstr ":ref:`Uygunluk `: ne Emscripten , ne de WASI değil." @@ -146,10 +141,27 @@ msgstr "" "üzerinde çalışmaz veya mevcut değildir. Daha fazla bilgi için :ref:`wasm-" "availability` bölümüne bakınız." +#: library/asyncio.rst:64 +msgid "asyncio REPL" +msgstr "" + +#: library/asyncio.rst:65 +msgid "You can experiment with an ``asyncio`` concurrent context in the REPL:" +msgstr "" +"REPL üzerinde ``asyncio`` ile eşzamanlı bağlamda denemeler yapabilirsiniz:" + +#: library/asyncio.rst:77 +msgid "Raises an auditing event cpython.run_stdin with no arguments." +msgstr "" + #: library/asyncio.rst:79 +msgid "(also 3.11.10, 3.10.15, 3.9.20, and 3.8.20) Emits audit events." +msgstr "" + +#: library/asyncio.rst:86 msgid "Reference" msgstr "Referans" -#: library/asyncio.rst:112 +#: library/asyncio.rst:119 msgid "The source code for asyncio can be found in :source:`Lib/asyncio/`." msgstr "Asyncio için kaynak kodu :source:`Lib/asyncio/` dizininde bulunabilir." diff --git a/library/audioop.po b/library/audioop.po index 3b8999186..9050811bb 100644 --- a/library/audioop.po +++ b/library/audioop.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -20,7 +20,7 @@ msgstr "" msgid ":mod:`audioop` --- Manipulate raw audio data" msgstr "" -#: library/audioop.rst:11 +#: library/audioop.rst:8 msgid "" "The :mod:`audioop` module is deprecated (see :pep:`PEP 594 <594#audioop>` " "for details)." diff --git a/library/cgi.po b/library/cgi.po index 122d66762..2f63175aa 100644 --- a/library/cgi.po +++ b/library/cgi.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/cgi.py`" msgstr "" -#: library/cgi.rst:27 +#: library/cgi.rst:18 msgid "" "The :mod:`cgi` module is deprecated (see :pep:`PEP 594 <594#cgi>` for " "details and alternatives)." @@ -363,7 +363,7 @@ msgid "" "parameters are passed to :func:`urllib.parse.parse_qs` unchanged." msgstr "" -#: library/cgi.rst:307 +#: library/cgi.rst:303 msgid "" "This function, like the rest of the :mod:`cgi` module, is deprecated. It can " "be replaced by calling :func:`urllib.parse.parse_qs` directly on the desired " @@ -403,7 +403,7 @@ msgstr "" msgid "Added the *separator* parameter." msgstr "" -#: library/cgi.rst:337 +#: library/cgi.rst:332 msgid "" "This function, like the rest of the :mod:`cgi` module, is deprecated. It can " "be replaced with the functionality in the :mod:`email` package (e.g. :class:" @@ -417,7 +417,7 @@ msgid "" "and a dictionary of parameters." msgstr "" -#: library/cgi.rst:355 +#: library/cgi.rst:345 msgid "" "This function, like the rest of the :mod:`cgi` module, is deprecated. It can " "be replaced with the functionality in the :mod:`email` package, which " diff --git a/library/cgitb.po b/library/cgitb.po index 90089b5a9..7b5a47975 100644 --- a/library/cgitb.po +++ b/library/cgitb.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/cgitb.py`" msgstr "" -#: library/cgitb.rst:22 +#: library/cgitb.rst:19 msgid "" "The :mod:`cgitb` module is deprecated (see :pep:`PEP 594 <594#cgitb>` for " "details)." diff --git a/library/chunk.po b/library/chunk.po index 3e790850c..30d861b5d 100644 --- a/library/chunk.po +++ b/library/chunk.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/chunk.py`" msgstr "" -#: library/chunk.rst:23 +#: library/chunk.rst:20 msgid "" "The :mod:`chunk` module is deprecated (see :pep:`PEP 594 <594#chunk>` for " "details)." diff --git a/library/collections.abc.po b/library/collections.abc.po index 7a203a8f4..fc1704ec3 100644 --- a/library/collections.abc.po +++ b/library/collections.abc.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -497,7 +497,7 @@ msgstr "" msgid "The index() method added support for *stop* and *start* arguments." msgstr "" -#: library/collections.abc.rst:281 +#: library/collections.abc.rst:277 msgid "" "The :class:`ByteString` ABC has been deprecated. For use in typing, prefer a " "union, like ``bytes | bytearray``, or :class:`collections.abc.Buffer`. For " diff --git a/library/collections.po b/library/collections.po index 3d13e7673..29d2c518c 100644 --- a/library/collections.po +++ b/library/collections.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -194,7 +194,7 @@ msgstr "" #: library/collections.rst:102 msgid "" -"Note, the iteration order of a :class:`ChainMap()` is determined by scanning " +"Note, the iteration order of a :class:`ChainMap` is determined by scanning " "the mappings last to first::" msgstr "" diff --git a/library/colorsys.po b/library/colorsys.po index 4b07c1cae..b51c52202 100644 --- a/library/colorsys.po +++ b/library/colorsys.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -30,7 +30,7 @@ msgid "" "between colors expressed in the RGB (Red Green Blue) color space used in " "computer monitors and three other coordinate systems: YIQ, HLS (Hue " "Lightness Saturation) and HSV (Hue Saturation Value). Coordinates in all of " -"these color spaces are floating point values. In the YIQ space, the Y " +"these color spaces are floating-point values. In the YIQ space, the Y " "coordinate is between 0 and 1, but the I and Q coordinates can be positive " "or negative. In all other spaces, the coordinates are all between 0 and 1." msgstr "" diff --git a/library/configparser.po b/library/configparser.po index 210d54b70..02cfbd702 100644 --- a/library/configparser.po +++ b/library/configparser.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -106,32 +106,34 @@ msgid "" "and stored in lowercase [1]_." msgstr "" -#: library/configparser.rst:147 +#: library/configparser.rst:966 msgid "" "It is possible to read several configurations into a single :class:" "`ConfigParser`, where the most recently added configuration has the highest " "priority. Any conflicting keys are taken from the more recent configuration " -"while the previously existing keys are retained." +"while the previously existing keys are retained. The example below reads in " +"an ``override.ini`` file, which will override any conflicting keys from the " +"``example.ini`` file." msgstr "" -#: library/configparser.rst:168 +#: library/configparser.rst:173 msgid "" "This behaviour is equivalent to a :meth:`ConfigParser.read` call with " "several files passed to the *filenames* parameter." msgstr "" -#: library/configparser.rst:173 +#: library/configparser.rst:178 msgid "Supported Datatypes" msgstr "" -#: library/configparser.rst:175 +#: library/configparser.rst:180 msgid "" "Config parsers do not guess datatypes of values in configuration files, " "always storing them internally as strings. This means that if you need " "other datatypes, you should convert on your own:" msgstr "" -#: library/configparser.rst:186 +#: library/configparser.rst:191 msgid "" "Since this task is so common, config parsers provide a range of handy getter " "methods to handle integers, floats and booleans. The last one is the most " @@ -142,7 +144,7 @@ msgid "" "``'true'``/``'false'`` and ``'1'``/``'0'`` [1]_. For example:" msgstr "" -#: library/configparser.rst:203 +#: library/configparser.rst:208 msgid "" "Apart from :meth:`~ConfigParser.getboolean`, config parsers also provide " "equivalent :meth:`~ConfigParser.getint` and :meth:`~ConfigParser.getfloat` " @@ -150,17 +152,17 @@ msgid "" "ones. [1]_" msgstr "" -#: library/configparser.rst:209 +#: library/configparser.rst:214 msgid "Fallback Values" msgstr "" -#: library/configparser.rst:211 +#: library/configparser.rst:216 msgid "" "As with a dictionary, you can use a section's :meth:`~ConfigParser.get` " "method to provide fallback values:" msgstr "" -#: library/configparser.rst:224 +#: library/configparser.rst:229 msgid "" "Please note that default values have precedence over fallback values. For " "instance, in our example the ``'CompressionLevel'`` key was specified only " @@ -169,7 +171,7 @@ msgid "" "specify a fallback:" msgstr "" -#: library/configparser.rst:235 +#: library/configparser.rst:240 msgid "" "One more thing to be aware of is that the parser-level :meth:`~ConfigParser." "get` method provides a custom, more complex interface, maintained for " @@ -177,18 +179,18 @@ msgid "" "provided via the ``fallback`` keyword-only argument:" msgstr "" -#: library/configparser.rst:246 +#: library/configparser.rst:251 msgid "" "The same ``fallback`` argument can be used with the :meth:`~ConfigParser." "getint`, :meth:`~ConfigParser.getfloat` and :meth:`~ConfigParser.getboolean` " "methods, for example:" msgstr "" -#: library/configparser.rst:262 +#: library/configparser.rst:267 msgid "Supported INI File Structure" msgstr "" -#: library/configparser.rst:264 +#: library/configparser.rst:269 msgid "" "A configuration file consists of sections, each led by a ``[section]`` " "header, followed by key/value entries separated by a specific string (``=`` " @@ -201,35 +203,35 @@ msgid "" "parts of multiline values or ignored." msgstr "" -#: library/configparser.rst:274 +#: library/configparser.rst:279 msgid "" "By default, a valid section name can be any string that does not contain '\\" "\\n'. To change this, see :attr:`ConfigParser.SECTCRE`." msgstr "" -#: library/configparser.rst:277 +#: library/configparser.rst:282 msgid "" "Configuration files may include comments, prefixed by specific characters " "(``#`` and ``;`` by default [1]_). Comments may appear on their own on an " "otherwise empty line, possibly indented. [1]_" msgstr "" -#: library/configparser.rst:344 +#: library/configparser.rst:349 msgid "For example:" msgstr "" -#: library/configparser.rst:329 +#: library/configparser.rst:334 msgid "Interpolation of values" msgstr "" -#: library/configparser.rst:331 +#: library/configparser.rst:336 msgid "" "On top of the core functionality, :class:`ConfigParser` supports " "interpolation. This means values can be preprocessed before returning them " "from ``get()`` calls." msgstr "" -#: library/configparser.rst:339 +#: library/configparser.rst:344 msgid "" "The default implementation used by :class:`ConfigParser`. It enables values " "to contain format strings which refer to other values in the same section, " @@ -237,7 +239,7 @@ msgid "" "can be provided on initialization." msgstr "" -#: library/configparser.rst:357 +#: library/configparser.rst:362 msgid "" "In the example above, :class:`ConfigParser` with *interpolation* set to " "``BasicInterpolation()`` would resolve ``%(home_dir)s`` to the value of " @@ -247,14 +249,14 @@ msgid "" "specific order in the configuration file." msgstr "" -#: library/configparser.rst:364 +#: library/configparser.rst:369 msgid "" "With ``interpolation`` set to ``None``, the parser would simply return " "``%(my_dir)s/Pictures`` as the value of ``my_pictures`` and ``%(home_dir)s/" "lumberjack`` as the value of ``my_dir``." msgstr "" -#: library/configparser.rst:372 +#: library/configparser.rst:377 msgid "" "An alternative handler for interpolation which implements a more advanced " "syntax, used for instance in ``zc.buildout``. Extended interpolation is " @@ -264,21 +266,21 @@ msgid "" "possibly the default values from the special section)." msgstr "" -#: library/configparser.rst:379 +#: library/configparser.rst:384 msgid "" "For example, the configuration specified above with basic interpolation, " "would look like this with extended interpolation:" msgstr "" -#: library/configparser.rst:393 +#: library/configparser.rst:398 msgid "Values from other sections can be fetched as well:" msgstr "" -#: library/configparser.rst:415 +#: library/configparser.rst:420 msgid "Mapping Protocol Access" msgstr "" -#: library/configparser.rst:419 +#: library/configparser.rst:424 msgid "" "Mapping protocol access is a generic name for functionality that enables " "using custom objects as if they were dictionaries. In case of :mod:" @@ -286,7 +288,7 @@ msgid "" "``parser['section']['option']`` notation." msgstr "" -#: library/configparser.rst:424 +#: library/configparser.rst:429 msgid "" "``parser['section']`` in particular returns a proxy for the section's data " "in the parser. This means that the values are not copied but they are taken " @@ -295,7 +297,7 @@ msgid "" "original parser." msgstr "" -#: library/configparser.rst:430 +#: library/configparser.rst:435 msgid "" ":mod:`configparser` objects behave as close to actual dictionaries as " "possible. The mapping interface is complete and adheres to the :class:" @@ -303,7 +305,7 @@ msgid "" "that should be taken into account:" msgstr "" -#: library/configparser.rst:435 +#: library/configparser.rst:440 msgid "" "By default, all keys in sections are accessible in a case-insensitive manner " "[1]_. E.g. ``for option in parser[\"section\"]`` yields only " @@ -312,7 +314,7 @@ msgid "" "expressions return ``True``::" msgstr "" -#: library/configparser.rst:443 +#: library/configparser.rst:448 msgid "" "All sections include ``DEFAULTSECT`` values as well which means that ``." "clear()`` on a section may not leave the section visibly empty. This is " @@ -322,30 +324,30 @@ msgid "" "default value causes a :exc:`KeyError`." msgstr "" -#: library/configparser.rst:450 +#: library/configparser.rst:455 msgid "``DEFAULTSECT`` cannot be removed from the parser:" msgstr "" -#: library/configparser.rst:452 +#: library/configparser.rst:457 msgid "trying to delete it raises :exc:`ValueError`," msgstr "" -#: library/configparser.rst:454 +#: library/configparser.rst:459 msgid "``parser.clear()`` leaves it intact," msgstr "" -#: library/configparser.rst:456 +#: library/configparser.rst:461 msgid "``parser.popitem()`` never returns it." msgstr "" -#: library/configparser.rst:458 +#: library/configparser.rst:463 msgid "" "``parser.get(section, option, **kwargs)`` - the second argument is **not** a " "fallback value. Note however that the section-level ``get()`` methods are " "compatible both with the mapping protocol and the classic configparser API." msgstr "" -#: library/configparser.rst:462 +#: library/configparser.rst:467 msgid "" "``parser.items()`` is compatible with the mapping protocol (returns a list " "of *section_name*, *section_proxy* pairs including the DEFAULTSECT). " @@ -355,18 +357,18 @@ msgid "" "(unless ``raw=True`` is provided)." msgstr "" -#: library/configparser.rst:469 +#: library/configparser.rst:474 msgid "" "The mapping protocol is implemented on top of the existing legacy API so " "that subclasses overriding the original interface still should have mappings " "working as expected." msgstr "" -#: library/configparser.rst:475 +#: library/configparser.rst:480 msgid "Customizing Parser Behaviour" msgstr "" -#: library/configparser.rst:477 +#: library/configparser.rst:482 msgid "" "There are nearly as many INI format variants as there are applications using " "it. :mod:`configparser` goes a long way to provide support for the largest " @@ -375,17 +377,17 @@ msgid "" "customize some of the features." msgstr "" -#: library/configparser.rst:483 +#: library/configparser.rst:488 msgid "" "The most common way to change the way a specific config parser works is to " "use the :meth:`!__init__` options:" msgstr "" -#: library/configparser.rst:486 +#: library/configparser.rst:491 msgid "*defaults*, default value: ``None``" msgstr "" -#: library/configparser.rst:488 +#: library/configparser.rst:493 msgid "" "This option accepts a dictionary of key-value pairs which will be initially " "put in the ``DEFAULT`` section. This makes for an elegant way to support " @@ -393,17 +395,17 @@ msgid "" "the documented default." msgstr "" -#: library/configparser.rst:493 +#: library/configparser.rst:498 msgid "" "Hint: if you want to specify default values for a specific section, use :" "meth:`~ConfigParser.read_dict` before you read the actual file." msgstr "" -#: library/configparser.rst:496 +#: library/configparser.rst:501 msgid "*dict_type*, default value: :class:`dict`" msgstr "" -#: library/configparser.rst:498 +#: library/configparser.rst:503 msgid "" "This option has a major impact on how the mapping protocol will behave and " "how the written configuration files look. With the standard dictionary, " @@ -411,24 +413,24 @@ msgid "" "goes for options within sections." msgstr "" -#: library/configparser.rst:503 +#: library/configparser.rst:508 msgid "" "An alternative dictionary type can be used for example to sort sections and " "options on write-back." msgstr "" -#: library/configparser.rst:506 +#: library/configparser.rst:511 msgid "" "Please note: there are ways to add a set of key-value pairs in a single " "operation. When you use a regular dictionary in those operations, the order " "of the keys will be ordered. For example:" msgstr "" -#: library/configparser.rst:528 +#: library/configparser.rst:533 msgid "*allow_no_value*, default value: ``False``" msgstr "" -#: library/configparser.rst:530 +#: library/configparser.rst:535 msgid "" "Some configuration files are known to include settings without values, but " "which otherwise conform to the syntax supported by :mod:`configparser`. The " @@ -436,32 +438,32 @@ msgid "" "such values should be accepted:" msgstr "" -#: library/configparser.rst:565 +#: library/configparser.rst:570 msgid "*delimiters*, default value: ``('=', ':')``" msgstr "" -#: library/configparser.rst:567 +#: library/configparser.rst:572 msgid "" "Delimiters are substrings that delimit keys from values within a section. " "The first occurrence of a delimiting substring on a line is considered a " "delimiter. This means values (but not keys) can contain the delimiters." msgstr "" -#: library/configparser.rst:571 +#: library/configparser.rst:576 msgid "" "See also the *space_around_delimiters* argument to :meth:`ConfigParser." "write`." msgstr "" -#: library/configparser.rst:574 +#: library/configparser.rst:579 msgid "*comment_prefixes*, default value: ``('#', ';')``" msgstr "" -#: library/configparser.rst:576 +#: library/configparser.rst:581 msgid "*inline_comment_prefixes*, default value: ``None``" msgstr "" -#: library/configparser.rst:578 +#: library/configparser.rst:583 msgid "" "Comment prefixes are strings that indicate the start of a valid comment " "within a config file. *comment_prefixes* are used only on otherwise empty " @@ -471,13 +473,13 @@ msgid "" "used as prefixes for whole line comments." msgstr "" -#: library/configparser.rst:585 +#: library/configparser.rst:590 msgid "" "In previous versions of :mod:`configparser` behaviour matched " "``comment_prefixes=('#',';')`` and ``inline_comment_prefixes=(';',)``." msgstr "" -#: library/configparser.rst:589 +#: library/configparser.rst:594 msgid "" "Please note that config parsers don't support escaping of comment prefixes " "so using *inline_comment_prefixes* may prevent users from specifying option " @@ -487,11 +489,11 @@ msgid "" "values is to interpolate the prefix, for example::" msgstr "" -#: library/configparser.rst:635 +#: library/configparser.rst:640 msgid "*strict*, default value: ``True``" msgstr "" -#: library/configparser.rst:637 +#: library/configparser.rst:642 msgid "" "When set to ``True``, the parser will not allow for any section or option " "duplicates while reading from a single source (using :meth:`~ConfigParser." @@ -499,17 +501,17 @@ msgid "" "read_dict`). It is recommended to use strict parsers in new applications." msgstr "" -#: library/configparser.rst:642 +#: library/configparser.rst:647 msgid "" "In previous versions of :mod:`configparser` behaviour matched " "``strict=False``." msgstr "" -#: library/configparser.rst:646 +#: library/configparser.rst:651 msgid "*empty_lines_in_values*, default value: ``True``" msgstr "" -#: library/configparser.rst:648 +#: library/configparser.rst:653 msgid "" "In config parsers, values can span multiple lines as long as they are " "indented more than the key that holds them. By default parsers also let " @@ -519,7 +521,7 @@ msgid "" "lose track of the file structure. Take for instance:" msgstr "" -#: library/configparser.rst:663 +#: library/configparser.rst:668 msgid "" "This can be especially problematic for the user to see if she's using a " "proportional font to edit the file. That is why when your application does " @@ -528,13 +530,13 @@ msgid "" "would produce two keys, ``key`` and ``this``." msgstr "" -#: library/configparser.rst:669 +#: library/configparser.rst:674 msgid "" "*default_section*, default value: ``configparser.DEFAULTSECT`` (that is: " "``\"DEFAULT\"``)" msgstr "" -#: library/configparser.rst:672 +#: library/configparser.rst:677 msgid "" "The convention of allowing a special section of default values for other " "sections or interpolation purposes is a powerful concept of this library, " @@ -548,11 +550,11 @@ msgid "" "files from one format to another)." msgstr "" -#: library/configparser.rst:683 +#: library/configparser.rst:688 msgid "*interpolation*, default value: ``configparser.BasicInterpolation``" msgstr "" -#: library/configparser.rst:685 +#: library/configparser.rst:690 msgid "" "Interpolation behaviour may be customized by providing a custom handler " "through the *interpolation* argument. ``None`` can be used to turn off " @@ -562,11 +564,11 @@ msgid "" "`RawConfigParser` has a default value of ``None``." msgstr "" -#: library/configparser.rst:692 +#: library/configparser.rst:697 msgid "*converters*, default value: not set" msgstr "" -#: library/configparser.rst:694 +#: library/configparser.rst:699 msgid "" "Config parsers provide option value getters that perform type conversion. " "By default :meth:`~ConfigParser.getint`, :meth:`~ConfigParser.getfloat`, " @@ -580,7 +582,7 @@ msgid "" "``parser_instance['section'].getdecimal('key', 0)``." msgstr "" -#: library/configparser.rst:705 +#: library/configparser.rst:710 msgid "" "If the converter needs to access the state of the parser, it can be " "implemented as a method on a config parser subclass. If the name of this " @@ -588,14 +590,14 @@ msgid "" "the dict-compatible form (see the ``getdecimal()`` example above)." msgstr "" -#: library/configparser.rst:710 +#: library/configparser.rst:715 msgid "" "More advanced customization may be achieved by overriding default values of " "these parser attributes. The defaults are defined on the classes, so they " "may be overridden by subclasses or by attribute assignment." msgstr "" -#: library/configparser.rst:716 +#: library/configparser.rst:721 msgid "" "By default when using :meth:`~ConfigParser.getboolean`, config parsers " "consider the following values ``True``: ``'1'``, ``'yes'``, ``'true'``, " @@ -604,13 +606,13 @@ msgid "" "strings and their Boolean outcomes. For example:" msgstr "" -#: library/configparser.rst:734 +#: library/configparser.rst:739 msgid "" "Other typical Boolean pairs include ``accept``/``reject`` or ``enabled``/" "``disabled``." msgstr "" -#: library/configparser.rst:740 +#: library/configparser.rst:745 msgid "" "This method transforms option names on every read, get, or set operation. " "The default converts the name to lowercase. This also means that when a " @@ -618,14 +620,14 @@ msgid "" "method if that's unsuitable. For example:" msgstr "" -#: library/configparser.rst:770 +#: library/configparser.rst:775 msgid "" "The optionxform function transforms option names to a canonical form. This " "should be an idempotent function: if the name is already in canonical form, " "it should be returned unchanged." msgstr "" -#: library/configparser.rst:777 +#: library/configparser.rst:782 msgid "" "A compiled regular expression used to parse section headers. The default " "matches ``[section]`` to the name ``\"section\"``. Whitespace is considered " @@ -634,18 +636,18 @@ msgid "" "example:" msgstr "" -#: library/configparser.rst:805 +#: library/configparser.rst:810 msgid "" "While ConfigParser objects also use an ``OPTCRE`` attribute for recognizing " "option lines, it's not recommended to override it because that would " "interfere with constructor options *allow_no_value* and *delimiters*." msgstr "" -#: library/configparser.rst:811 +#: library/configparser.rst:816 msgid "Legacy API Examples" msgstr "" -#: library/configparser.rst:813 +#: library/configparser.rst:818 msgid "" "Mainly because of backwards compatibility concerns, :mod:`configparser` " "provides also a legacy API with explicit ``get``/``set`` methods. While " @@ -654,29 +656,29 @@ msgid "" "advanced, low-level and downright counterintuitive." msgstr "" -#: library/configparser.rst:819 +#: library/configparser.rst:824 msgid "An example of writing to a configuration file::" msgstr "" -#: library/configparser.rst:842 +#: library/configparser.rst:847 msgid "An example of reading the configuration file again::" msgstr "" -#: library/configparser.rst:860 +#: library/configparser.rst:865 msgid "To get interpolation, use :class:`ConfigParser`::" msgstr "" -#: library/configparser.rst:893 +#: library/configparser.rst:898 msgid "" "Default values are available in both types of ConfigParsers. They are used " "in interpolation if an option used is not defined elsewhere. ::" msgstr "" -#: library/configparser.rst:911 +#: library/configparser.rst:916 msgid "ConfigParser Objects" msgstr "" -#: library/configparser.rst:915 +#: library/configparser.rst:920 msgid "" "The main configuration parser. When *defaults* is given, it is initialized " "into the dictionary of intrinsic defaults. When *dict_type* is given, it " @@ -684,7 +686,7 @@ msgid "" "the options within a section, and for the default values." msgstr "" -#: library/configparser.rst:920 +#: library/configparser.rst:925 msgid "" "When *delimiters* is given, it is used as the set of substrings that divide " "keys from values. When *comment_prefixes* is given, it will be used as the " @@ -693,7 +695,7 @@ msgid "" "as the set of substrings that prefix comments in non-empty lines." msgstr "" -#: library/configparser.rst:926 +#: library/configparser.rst:931 msgid "" "When *strict* is ``True`` (the default), the parser won't allow for any " "section or option duplicates while reading from a single source (file, " @@ -706,7 +708,7 @@ msgid "" "without the trailing delimiter." msgstr "" -#: library/configparser.rst:936 +#: library/configparser.rst:941 msgid "" "When *default_section* is given, it specifies the name for the special " "section holding default values for other sections and interpolation purposes " @@ -716,7 +718,7 @@ msgid "" "settings to a new config file." msgstr "" -#: library/configparser.rst:943 +#: library/configparser.rst:948 msgid "" "Interpolation behaviour may be customized by providing a custom handler " "through the *interpolation* argument. ``None`` can be used to turn off " @@ -725,7 +727,7 @@ msgid "" "`dedicated documentation section <#interpolation-of-values>`_." msgstr "" -#: library/configparser.rst:949 +#: library/configparser.rst:954 msgid "" "All option names used in interpolation will be passed through the :meth:" "`optionxform` method just like any other option name reference. For " @@ -734,7 +736,7 @@ msgid "" "%(BAR)s`` are equivalent." msgstr "" -#: library/configparser.rst:955 +#: library/configparser.rst:960 msgid "" "When *converters* is given, it should be a dictionary where each key " "represents the name of a type converter and each value is a callable " @@ -743,44 +745,44 @@ msgid "" "object and section proxies." msgstr "" -#: library/configparser.rst:961 +#: library/configparser.rst:991 msgid "The default *dict_type* is :class:`collections.OrderedDict`." msgstr "" -#: library/configparser.rst:964 +#: library/configparser.rst:994 msgid "" "*allow_no_value*, *delimiters*, *comment_prefixes*, *strict*, " "*empty_lines_in_values*, *default_section* and *interpolation* were added." msgstr "" -#: library/configparser.rst:969 +#: library/configparser.rst:999 msgid "The *converters* argument was added." msgstr "" -#: library/configparser.rst:972 +#: library/configparser.rst:1002 msgid "" "The *defaults* argument is read with :meth:`read_dict()`, providing " "consistent behavior across the parser: non-string keys and values are " "implicitly converted to strings." msgstr "" -#: library/configparser.rst:1240 +#: library/configparser.rst:1270 msgid "" "The default *dict_type* is :class:`dict`, since it now preserves insertion " "order." msgstr "" -#: library/configparser.rst:983 +#: library/configparser.rst:1013 msgid "Return a dictionary containing the instance-wide defaults." msgstr "" -#: library/configparser.rst:988 +#: library/configparser.rst:1018 msgid "" "Return a list of the sections available; the *default section* is not " "included in the list." msgstr "" -#: library/configparser.rst:994 +#: library/configparser.rst:1024 msgid "" "Add a section named *section* to the instance. If a section by the given " "name already exists, :exc:`DuplicateSectionError` is raised. If the " @@ -788,34 +790,34 @@ msgid "" "the section must be a string; if not, :exc:`TypeError` is raised." msgstr "" -#: library/configparser.rst:999 +#: library/configparser.rst:1029 msgid "Non-string section names raise :exc:`TypeError`." msgstr "" -#: library/configparser.rst:1005 +#: library/configparser.rst:1035 msgid "" "Indicates whether the named *section* is present in the configuration. The " "*default section* is not acknowledged." msgstr "" -#: library/configparser.rst:1011 +#: library/configparser.rst:1041 msgid "Return a list of options available in the specified *section*." msgstr "" -#: library/configparser.rst:1016 +#: library/configparser.rst:1046 msgid "" "If the given *section* exists, and contains the given *option*, return :" "const:`True`; otherwise return :const:`False`. If the specified *section* " "is :const:`None` or an empty string, DEFAULT is assumed." msgstr "" -#: library/configparser.rst:1023 +#: library/configparser.rst:1053 msgid "" "Attempt to read and parse an iterable of filenames, returning a list of " "filenames which were successfully parsed." msgstr "" -#: library/configparser.rst:1026 +#: library/configparser.rst:1056 msgid "" "If *filenames* is a string, a :class:`bytes` object or a :term:`path-like " "object`, it is treated as a single filename. If a file named in *filenames* " @@ -826,7 +828,7 @@ msgid "" "be read." msgstr "" -#: library/configparser.rst:1035 +#: library/configparser.rst:1065 msgid "" "If none of the named files exist, the :class:`ConfigParser` instance will " "contain an empty dataset. An application which requires initial values to " @@ -834,49 +836,49 @@ msgid "" "`read_file` before calling :meth:`read` for any optional files::" msgstr "" -#: library/configparser.rst:1048 +#: library/configparser.rst:1078 msgid "" "Added the *encoding* parameter. Previously, all files were read using the " "default encoding for :func:`open`." msgstr "" -#: library/configparser.rst:1052 +#: library/configparser.rst:1082 msgid "The *filenames* parameter accepts a :term:`path-like object`." msgstr "" -#: library/configparser.rst:1055 +#: library/configparser.rst:1085 msgid "The *filenames* parameter accepts a :class:`bytes` object." msgstr "" -#: library/configparser.rst:1061 +#: library/configparser.rst:1091 msgid "" "Read and parse configuration data from *f* which must be an iterable " "yielding Unicode strings (for example files opened in text mode)." msgstr "" -#: library/configparser.rst:1064 +#: library/configparser.rst:1094 msgid "" "Optional argument *source* specifies the name of the file being read. If " "not given and *f* has a :attr:`!name` attribute, that is used for *source*; " "the default is ``''``." msgstr "" -#: library/configparser.rst:1068 +#: library/configparser.rst:1098 msgid "Replaces :meth:`!readfp`." msgstr "" -#: library/configparser.rst:1073 +#: library/configparser.rst:1103 msgid "Parse configuration data from a string." msgstr "" -#: library/configparser.rst:1075 +#: library/configparser.rst:1105 msgid "" "Optional argument *source* specifies a context-specific name of the string " "passed. If not given, ``''`` is used. This should commonly be a " "filesystem path or a URL." msgstr "" -#: library/configparser.rst:1084 +#: library/configparser.rst:1114 msgid "" "Load configuration from any object that provides a dict-like ``items()`` " "method. Keys are section names, values are dictionaries with keys and " @@ -885,17 +887,17 @@ msgid "" "automatically converted to strings." msgstr "" -#: library/configparser.rst:1090 +#: library/configparser.rst:1120 msgid "" "Optional argument *source* specifies a context-specific name of the " "dictionary passed. If not given, ```` is used." msgstr "" -#: library/configparser.rst:1093 +#: library/configparser.rst:1123 msgid "This method can be used to copy state between parsers." msgstr "" -#: library/configparser.rst:1100 +#: library/configparser.rst:1130 msgid "" "Get an *option* value for the named *section*. If *vars* is provided, it " "must be a dictionary. The *option* is looked up in *vars* (if provided), " @@ -904,35 +906,35 @@ msgid "" "provided as a *fallback* value." msgstr "" -#: library/configparser.rst:1106 +#: library/configparser.rst:1136 msgid "" "All the ``'%'`` interpolations are expanded in the return values, unless the " "*raw* argument is true. Values for interpolation keys are looked up in the " "same manner as the option." msgstr "" -#: library/configparser.rst:1110 +#: library/configparser.rst:1140 msgid "" "Arguments *raw*, *vars* and *fallback* are keyword only to protect users " "from trying to use the third argument as the *fallback* fallback (especially " "when using the mapping protocol)." msgstr "" -#: library/configparser.rst:1118 +#: library/configparser.rst:1148 msgid "" "A convenience method which coerces the *option* in the specified *section* " "to an integer. See :meth:`get` for explanation of *raw*, *vars* and " "*fallback*." msgstr "" -#: library/configparser.rst:1125 +#: library/configparser.rst:1155 msgid "" "A convenience method which coerces the *option* in the specified *section* " -"to a floating point number. See :meth:`get` for explanation of *raw*, " +"to a floating-point number. See :meth:`get` for explanation of *raw*, " "*vars* and *fallback*." msgstr "" -#: library/configparser.rst:1132 +#: library/configparser.rst:1162 msgid "" "A convenience method which coerces the *option* in the specified *section* " "to a Boolean value. Note that the accepted values for the option are " @@ -944,34 +946,34 @@ msgid "" "*fallback*." msgstr "" -#: library/configparser.rst:1145 +#: library/configparser.rst:1175 msgid "" "When *section* is not given, return a list of *section_name*, " "*section_proxy* pairs, including DEFAULTSECT." msgstr "" -#: library/configparser.rst:1148 +#: library/configparser.rst:1178 msgid "" "Otherwise, return a list of *name*, *value* pairs for the options in the " "given *section*. Optional arguments have the same meaning as for the :meth:" "`get` method." msgstr "" -#: library/configparser.rst:1152 +#: library/configparser.rst:1182 msgid "" "Items present in *vars* no longer appear in the result. The previous " "behaviour mixed actual parser options with variables provided for " "interpolation." msgstr "" -#: library/configparser.rst:1160 +#: library/configparser.rst:1190 msgid "" "If the given section exists, set the given option to the specified value; " "otherwise raise :exc:`NoSectionError`. *option* and *value* must be " "strings; if not, :exc:`TypeError` is raised." msgstr "" -#: library/configparser.rst:1167 +#: library/configparser.rst:1197 msgid "" "Write a representation of the configuration to the specified :term:`file " "object`, which must be opened in text mode (accepting strings). This " @@ -980,27 +982,27 @@ msgid "" "surrounded by spaces." msgstr "" -#: library/configparser.rst:1175 +#: library/configparser.rst:1205 msgid "" "Comments in the original configuration file are not preserved when writing " "the configuration back. What is considered a comment, depends on the given " "values for *comment_prefix* and *inline_comment_prefix*." msgstr "" -#: library/configparser.rst:1183 +#: library/configparser.rst:1213 msgid "" "Remove the specified *option* from the specified *section*. If the section " "does not exist, raise :exc:`NoSectionError`. If the option existed to be " "removed, return :const:`True`; otherwise return :const:`False`." msgstr "" -#: library/configparser.rst:1191 +#: library/configparser.rst:1221 msgid "" "Remove the specified *section* from the configuration. If the section in " "fact existed, return ``True``. Otherwise return ``False``." msgstr "" -#: library/configparser.rst:1197 +#: library/configparser.rst:1227 msgid "" "Transforms the option name *option* as found in an input file or as passed " "in by client code to the form that should be used in the internal " @@ -1009,7 +1011,7 @@ msgid "" "of this name on instances to affect this behavior." msgstr "" -#: library/configparser.rst:1203 +#: library/configparser.rst:1233 msgid "" "You don't need to subclass the parser to use this method, you can also set " "it on an instance, to a function that takes a string argument and returns a " @@ -1017,24 +1019,24 @@ msgid "" "sensitive::" msgstr "" -#: library/configparser.rst:1211 +#: library/configparser.rst:1241 msgid "" "Note that when reading configuration files, whitespace around the option " "names is stripped before :meth:`optionxform` is called." msgstr "" -#: library/configparser.rst:1217 +#: library/configparser.rst:1247 msgid "" "The maximum depth for recursive interpolation for :meth:`~configparser." "ConfigParser.get` when the *raw* parameter is false. This is relevant only " "when the default *interpolation* is used." msgstr "" -#: library/configparser.rst:1225 +#: library/configparser.rst:1255 msgid "RawConfigParser Objects" msgstr "" -#: library/configparser.rst:1235 +#: library/configparser.rst:1265 msgid "" "Legacy variant of the :class:`ConfigParser`. It has interpolation disabled " "by default and allows for non-string section names, option names, and values " @@ -1042,27 +1044,27 @@ msgid "" "``defaults=`` keyword argument handling." msgstr "" -#: library/configparser.rst:1245 +#: library/configparser.rst:1275 msgid "" "Consider using :class:`ConfigParser` instead which checks types of the " "values to be stored internally. If you don't want interpolation, you can " "use ``ConfigParser(interpolation=None)``." msgstr "" -#: library/configparser.rst:1252 +#: library/configparser.rst:1282 msgid "" "Add a section named *section* to the instance. If a section by the given " "name already exists, :exc:`DuplicateSectionError` is raised. If the " "*default section* name is passed, :exc:`ValueError` is raised." msgstr "" -#: library/configparser.rst:1256 +#: library/configparser.rst:1286 msgid "" "Type of *section* is not checked which lets users create non-string named " "sections. This behaviour is unsupported and may cause internal errors." msgstr "" -#: library/configparser.rst:1262 +#: library/configparser.rst:1292 msgid "" "If the given section exists, set the given option to the specified value; " "otherwise raise :exc:`NoSectionError`. While it is possible to use :class:" @@ -1072,7 +1074,7 @@ msgid "" "string values." msgstr "" -#: library/configparser.rst:1269 +#: library/configparser.rst:1299 msgid "" "This method lets users assign non-string values to keys internally. This " "behaviour is unsupported and will cause errors when attempting to write to a " @@ -1080,32 +1082,32 @@ msgid "" "not allow such assignments to take place." msgstr "" -#: library/configparser.rst:1276 +#: library/configparser.rst:1306 msgid "Exceptions" msgstr "" -#: library/configparser.rst:1280 +#: library/configparser.rst:1310 msgid "Base class for all other :mod:`configparser` exceptions." msgstr "" -#: library/configparser.rst:1285 +#: library/configparser.rst:1315 msgid "Exception raised when a specified section is not found." msgstr "" -#: library/configparser.rst:1290 +#: library/configparser.rst:1320 msgid "" "Exception raised if :meth:`~ConfigParser.add_section` is called with the " "name of a section that is already present or in strict parsers when a " "section if found more than once in a single input file, string or dictionary." msgstr "" -#: library/configparser.rst:1294 +#: library/configparser.rst:1324 msgid "" "Added the optional *source* and *lineno* attributes and parameters to :meth:" "`!__init__`." msgstr "" -#: library/configparser.rst:1301 +#: library/configparser.rst:1331 msgid "" "Exception raised by strict parsers if a single option appears twice during " "reading from a single file, string or dictionary. This catches misspellings " @@ -1113,58 +1115,58 @@ msgid "" "representing the same case-insensitive configuration key." msgstr "" -#: library/configparser.rst:1309 +#: library/configparser.rst:1339 msgid "" "Exception raised when a specified option is not found in the specified " "section." msgstr "" -#: library/configparser.rst:1315 +#: library/configparser.rst:1345 msgid "" "Base class for exceptions raised when problems occur performing string " "interpolation." msgstr "" -#: library/configparser.rst:1321 +#: library/configparser.rst:1351 msgid "" "Exception raised when string interpolation cannot be completed because the " "number of iterations exceeds :const:`MAX_INTERPOLATION_DEPTH`. Subclass of :" "exc:`InterpolationError`." msgstr "" -#: library/configparser.rst:1328 +#: library/configparser.rst:1358 msgid "" "Exception raised when an option referenced from a value does not exist. " "Subclass of :exc:`InterpolationError`." msgstr "" -#: library/configparser.rst:1334 +#: library/configparser.rst:1364 msgid "" "Exception raised when the source text into which substitutions are made does " "not conform to the required syntax. Subclass of :exc:`InterpolationError`." msgstr "" -#: library/configparser.rst:1340 +#: library/configparser.rst:1370 msgid "" "Exception raised when attempting to parse a file which has no section " "headers." msgstr "" -#: library/configparser.rst:1346 +#: library/configparser.rst:1376 msgid "Exception raised when errors occur attempting to parse a file." msgstr "" -#: library/configparser.rst:1348 +#: library/configparser.rst:1378 msgid "" "The ``filename`` attribute and :meth:`!__init__` constructor argument were " "removed. They have been available using the name ``source`` since 3.2." msgstr "" -#: library/configparser.rst:1353 +#: library/configparser.rst:1383 msgid "Footnotes" msgstr "" -#: library/configparser.rst:1354 +#: library/configparser.rst:1384 msgid "" "Config parsers allow for heavy customization. If you are interested in " "changing the behaviour outlined by the footnote reference, consult the " @@ -1191,14 +1193,14 @@ msgstr "" msgid "Windows ini file" msgstr "" -#: library/configparser.rst:335 +#: library/configparser.rst:340 msgid "% (percent)" msgstr "" -#: library/configparser.rst:368 +#: library/configparser.rst:373 msgid "interpolation in configuration files" msgstr "" -#: library/configparser.rst:368 +#: library/configparser.rst:373 msgid "$ (dollar)" msgstr "" diff --git a/library/contextlib.po b/library/contextlib.po index 02266a325..8e5de90d2 100644 --- a/library/contextlib.po +++ b/library/contextlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -252,37 +252,38 @@ msgstr "" msgid "This code is equivalent to::" msgstr "" -#: library/contextlib.rst:360 library/contextlib.rst:387 +#: library/contextlib.rst:362 library/contextlib.rst:389 msgid "This context manager is :ref:`reentrant `." msgstr "" #: library/contextlib.rst:315 msgid "" "If the code within the :keyword:`!with` block raises a :exc:" -"`BaseExceptionGroup`, suppressed exceptions are removed from the group. If " -"any exceptions in the group are not suppressed, a group containing them is " -"re-raised." +"`BaseExceptionGroup`, suppressed exceptions are removed from the group. Any " +"exceptions of the group which are not suppressed are re-raised in a new " +"group which is created using the original group's :meth:`~BaseExceptionGroup." +"derive` method." msgstr "" -#: library/contextlib.rst:321 +#: library/contextlib.rst:323 msgid "" -"``suppress`` now supports suppressing exceptions raised as part of an :exc:" +"``suppress`` now supports suppressing exceptions raised as part of a :exc:" "`BaseExceptionGroup`." msgstr "" -#: library/contextlib.rst:327 +#: library/contextlib.rst:329 msgid "" "Context manager for temporarily redirecting :data:`sys.stdout` to another " "file or file-like object." msgstr "" -#: library/contextlib.rst:330 +#: library/contextlib.rst:332 msgid "" "This tool adds flexibility to existing functions or classes whose output is " "hardwired to stdout." msgstr "" -#: library/contextlib.rst:333 +#: library/contextlib.rst:335 msgid "" "For example, the output of :func:`help` normally is sent to *sys.stdout*. " "You can capture that output in a string by redirecting the output to an :" @@ -291,17 +292,17 @@ msgid "" "`with` statement::" msgstr "" -#: library/contextlib.rst:343 +#: library/contextlib.rst:345 msgid "" "To send the output of :func:`help` to a file on disk, redirect the output to " "a regular file::" msgstr "" -#: library/contextlib.rst:350 +#: library/contextlib.rst:352 msgid "To send the output of :func:`help` to *sys.stderr*::" msgstr "" -#: library/contextlib.rst:355 +#: library/contextlib.rst:357 msgid "" "Note that the global side effect on :data:`sys.stdout` means that this " "context manager is not suitable for use in library code and most threaded " @@ -309,13 +310,13 @@ msgid "" "it is still a useful approach for many utility scripts." msgstr "" -#: library/contextlib.rst:367 +#: library/contextlib.rst:369 msgid "" "Similar to :func:`~contextlib.redirect_stdout` but redirecting :data:`sys." "stderr` to another file or file-like object." msgstr "" -#: library/contextlib.rst:377 +#: library/contextlib.rst:379 msgid "" "Non parallel-safe context manager to change the current working directory. " "As this changes a global state, the working directory, it is not suitable " @@ -325,60 +326,60 @@ msgid "" "when this context manager is active." msgstr "" -#: library/contextlib.rst:384 +#: library/contextlib.rst:386 msgid "" "This is a simple wrapper around :func:`~os.chdir`, it changes the current " "working directory upon entering and restores the old one on exit." msgstr "" -#: library/contextlib.rst:394 +#: library/contextlib.rst:396 msgid "" "A base class that enables a context manager to also be used as a decorator." msgstr "" -#: library/contextlib.rst:396 +#: library/contextlib.rst:398 msgid "" "Context managers inheriting from ``ContextDecorator`` have to implement " "``__enter__`` and ``__exit__`` as normal. ``__exit__`` retains its optional " "exception handling even when used as a decorator." msgstr "" -#: library/contextlib.rst:400 +#: library/contextlib.rst:402 msgid "" "``ContextDecorator`` is used by :func:`contextmanager`, so you get this " "functionality automatically." msgstr "" -#: library/contextlib.rst:403 +#: library/contextlib.rst:405 msgid "Example of ``ContextDecorator``::" msgstr "" -#: library/contextlib.rst:488 +#: library/contextlib.rst:490 msgid "The class can then be used like this::" msgstr "" -#: library/contextlib.rst:434 +#: library/contextlib.rst:436 msgid "" "This change is just syntactic sugar for any construct of the following form::" msgstr "" -#: library/contextlib.rst:440 +#: library/contextlib.rst:442 msgid "``ContextDecorator`` lets you instead write::" msgstr "" -#: library/contextlib.rst:446 +#: library/contextlib.rst:448 msgid "" "It makes it clear that the ``cm`` applies to the whole function, rather than " "just a piece of it (and saving an indentation level is nice, too)." msgstr "" -#: library/contextlib.rst:449 +#: library/contextlib.rst:451 msgid "" "Existing context managers that already have a base class can be extended by " "using ``ContextDecorator`` as a mixin class::" msgstr "" -#: library/contextlib.rst:462 +#: library/contextlib.rst:464 msgid "" "As the decorated function must be able to be called multiple times, the " "underlying context manager must support use in multiple :keyword:`with` " @@ -386,35 +387,35 @@ msgid "" "explicit :keyword:`!with` statement inside the function should be used." msgstr "" -#: library/contextlib.rst:472 +#: library/contextlib.rst:474 msgid "" "Similar to :class:`ContextDecorator` but only for asynchronous functions." msgstr "" -#: library/contextlib.rst:474 +#: library/contextlib.rst:476 msgid "Example of ``AsyncContextDecorator``::" msgstr "" -#: library/contextlib.rst:513 +#: library/contextlib.rst:515 msgid "" "A context manager that is designed to make it easy to programmatically " "combine other context managers and cleanup functions, especially those that " "are optional or otherwise driven by input data." msgstr "" -#: library/contextlib.rst:517 +#: library/contextlib.rst:519 msgid "" "For example, a set of files may easily be handled in a single with statement " "as follows::" msgstr "" -#: library/contextlib.rst:526 +#: library/contextlib.rst:528 msgid "" "The :meth:`~object.__enter__` method returns the :class:`ExitStack` " "instance, and performs no additional operations." msgstr "" -#: library/contextlib.rst:529 +#: library/contextlib.rst:531 msgid "" "Each instance maintains a stack of registered callbacks that are called in " "reverse order when the instance is closed (either explicitly or implicitly " @@ -422,14 +423,14 @@ msgid "" "invoked implicitly when the context stack instance is garbage collected." msgstr "" -#: library/contextlib.rst:534 +#: library/contextlib.rst:536 msgid "" "This stack model is used so that context managers that acquire their " "resources in their ``__init__`` method (such as file objects) can be handled " "correctly." msgstr "" -#: library/contextlib.rst:538 +#: library/contextlib.rst:540 msgid "" "Since registered callbacks are invoked in the reverse order of registration, " "this ends up behaving as if multiple nested :keyword:`with` statements had " @@ -439,7 +440,7 @@ msgid "" "updated state." msgstr "" -#: library/contextlib.rst:545 +#: library/contextlib.rst:547 msgid "" "This is a relatively low level API that takes care of the details of " "correctly unwinding the stack of exit callbacks. It provides a suitable " @@ -447,76 +448,76 @@ msgid "" "in application specific ways." msgstr "" -#: library/contextlib.rst:554 +#: library/contextlib.rst:556 msgid "" "Enters a new context manager and adds its :meth:`~object.__exit__` method to " "the callback stack. The return value is the result of the context manager's " "own :meth:`~object.__enter__` method." msgstr "" -#: library/contextlib.rst:558 +#: library/contextlib.rst:560 msgid "" "These context managers may suppress exceptions just as they normally would " "if used directly as part of a :keyword:`with` statement." msgstr "" -#: library/contextlib.rst:561 +#: library/contextlib.rst:563 msgid "" "Raises :exc:`TypeError` instead of :exc:`AttributeError` if *cm* is not a " "context manager." msgstr "" -#: library/contextlib.rst:567 +#: library/contextlib.rst:569 msgid "" "Adds a context manager's :meth:`~object.__exit__` method to the callback " "stack." msgstr "" -#: library/contextlib.rst:569 +#: library/contextlib.rst:571 msgid "" "As ``__enter__`` is *not* invoked, this method can be used to cover part of " "an :meth:`~object.__enter__` implementation with a context manager's own :" "meth:`~object.__exit__` method." msgstr "" -#: library/contextlib.rst:573 +#: library/contextlib.rst:575 msgid "" "If passed an object that is not a context manager, this method assumes it is " "a callback with the same signature as a context manager's :meth:`~object." "__exit__` method and adds it directly to the callback stack." msgstr "" -#: library/contextlib.rst:577 +#: library/contextlib.rst:579 msgid "" "By returning true values, these callbacks can suppress exceptions the same " "way context manager :meth:`~object.__exit__` methods can." msgstr "" -#: library/contextlib.rst:580 +#: library/contextlib.rst:582 msgid "" "The passed in object is returned from the function, allowing this method to " "be used as a function decorator." msgstr "" -#: library/contextlib.rst:585 +#: library/contextlib.rst:587 msgid "" "Accepts an arbitrary callback function and arguments and adds it to the " "callback stack." msgstr "" -#: library/contextlib.rst:588 +#: library/contextlib.rst:590 msgid "" "Unlike the other methods, callbacks added this way cannot suppress " "exceptions (as they are never passed the exception details)." msgstr "" -#: library/contextlib.rst:591 +#: library/contextlib.rst:593 msgid "" "The passed in callback is returned from the function, allowing this method " "to be used as a function decorator." msgstr "" -#: library/contextlib.rst:596 +#: library/contextlib.rst:598 msgid "" "Transfers the callback stack to a fresh :class:`ExitStack` instance and " "returns it. No callbacks are invoked by this operation - instead, they will " @@ -524,77 +525,77 @@ msgid "" "at the end of a :keyword:`with` statement)." msgstr "" -#: library/contextlib.rst:601 +#: library/contextlib.rst:603 msgid "" "For example, a group of files can be opened as an \"all or nothing\" " "operation as follows::" msgstr "" -#: library/contextlib.rst:615 +#: library/contextlib.rst:617 msgid "" "Immediately unwinds the callback stack, invoking callbacks in the reverse " "order of registration. For any context managers and exit callbacks " "registered, the arguments passed in will indicate that no exception occurred." msgstr "" -#: library/contextlib.rst:622 +#: library/contextlib.rst:624 msgid "" "An :ref:`asynchronous context manager `, similar to :" "class:`ExitStack`, that supports combining both synchronous and asynchronous " "context managers, as well as having coroutines for cleanup logic." msgstr "" -#: library/contextlib.rst:627 +#: library/contextlib.rst:629 msgid "" "The :meth:`~ExitStack.close` method is not implemented; :meth:`aclose` must " "be used instead." msgstr "" -#: library/contextlib.rst:632 +#: library/contextlib.rst:634 msgid "" "Similar to :meth:`ExitStack.enter_context` but expects an asynchronous " "context manager." msgstr "" -#: library/contextlib.rst:635 +#: library/contextlib.rst:637 msgid "" "Raises :exc:`TypeError` instead of :exc:`AttributeError` if *cm* is not an " "asynchronous context manager." msgstr "" -#: library/contextlib.rst:641 +#: library/contextlib.rst:643 msgid "" "Similar to :meth:`ExitStack.push` but expects either an asynchronous context " "manager or a coroutine function." msgstr "" -#: library/contextlib.rst:646 +#: library/contextlib.rst:648 msgid "Similar to :meth:`ExitStack.callback` but expects a coroutine function." msgstr "" -#: library/contextlib.rst:650 +#: library/contextlib.rst:652 msgid "Similar to :meth:`ExitStack.close` but properly handles awaitables." msgstr "" -#: library/contextlib.rst:652 +#: library/contextlib.rst:654 msgid "Continuing the example for :func:`asynccontextmanager`::" msgstr "" -#: library/contextlib.rst:664 +#: library/contextlib.rst:666 msgid "Examples and Recipes" msgstr "" -#: library/contextlib.rst:666 +#: library/contextlib.rst:668 msgid "" "This section describes some examples and recipes for making effective use of " "the tools provided by :mod:`contextlib`." msgstr "" -#: library/contextlib.rst:671 +#: library/contextlib.rst:673 msgid "Supporting a variable number of context managers" msgstr "" -#: library/contextlib.rst:673 +#: library/contextlib.rst:675 msgid "" "The primary use case for :class:`ExitStack` is the one given in the class " "documentation: supporting a variable number of context managers and other " @@ -604,18 +605,18 @@ msgid "" "of the context managers being optional::" msgstr "" -#: library/contextlib.rst:688 +#: library/contextlib.rst:690 msgid "" "As shown, :class:`ExitStack` also makes it quite easy to use :keyword:`with` " "statements to manage arbitrary resources that don't natively support the " "context management protocol." msgstr "" -#: library/contextlib.rst:694 +#: library/contextlib.rst:696 msgid "Catching exceptions from ``__enter__`` methods" msgstr "" -#: library/contextlib.rst:696 +#: library/contextlib.rst:698 msgid "" "It is occasionally desirable to catch exceptions from an ``__enter__`` " "method implementation, *without* inadvertently catching exceptions from the :" @@ -624,7 +625,7 @@ msgid "" "be separated slightly in order to allow this::" msgstr "" -#: library/contextlib.rst:711 +#: library/contextlib.rst:713 msgid "" "Actually needing to do this is likely to indicate that the underlying API " "should be providing a direct resource management interface for use with :" @@ -635,29 +636,29 @@ msgid "" "`with` statement." msgstr "" -#: library/contextlib.rst:721 +#: library/contextlib.rst:723 msgid "Cleaning up in an ``__enter__`` implementation" msgstr "" -#: library/contextlib.rst:723 +#: library/contextlib.rst:725 msgid "" "As noted in the documentation of :meth:`ExitStack.push`, this method can be " "useful in cleaning up an already allocated resource if later steps in the :" "meth:`~object.__enter__` implementation fail." msgstr "" -#: library/contextlib.rst:727 +#: library/contextlib.rst:729 msgid "" "Here's an example of doing this for a context manager that accepts resource " "acquisition and release functions, along with an optional validation " "function, and maps them to the context management protocol::" msgstr "" -#: library/contextlib.rst:767 +#: library/contextlib.rst:769 msgid "Replacing any use of ``try-finally`` and flag variables" msgstr "" -#: library/contextlib.rst:769 +#: library/contextlib.rst:771 msgid "" "A pattern you will sometimes see is a ``try-finally`` statement with a flag " "variable to indicate whether or not the body of the ``finally`` clause " @@ -665,57 +666,57 @@ msgid "" "by using an ``except`` clause instead), it looks something like this::" msgstr "" -#: library/contextlib.rst:783 +#: library/contextlib.rst:785 msgid "" "As with any ``try`` statement based code, this can cause problems for " "development and review, because the setup code and the cleanup code can end " "up being separated by arbitrarily long sections of code." msgstr "" -#: library/contextlib.rst:787 +#: library/contextlib.rst:789 msgid "" ":class:`ExitStack` makes it possible to instead register a callback for " "execution at the end of a ``with`` statement, and then later decide to skip " "executing that callback::" msgstr "" -#: library/contextlib.rst:799 +#: library/contextlib.rst:801 msgid "" "This allows the intended cleanup behaviour to be made explicit up front, " "rather than requiring a separate flag variable." msgstr "" -#: library/contextlib.rst:802 +#: library/contextlib.rst:804 msgid "" "If a particular application uses this pattern a lot, it can be simplified " "even further by means of a small helper class::" msgstr "" -#: library/contextlib.rst:820 +#: library/contextlib.rst:822 msgid "" "If the resource cleanup isn't already neatly bundled into a standalone " "function, then it is still possible to use the decorator form of :meth:" "`ExitStack.callback` to declare the resource cleanup in advance::" msgstr "" -#: library/contextlib.rst:835 +#: library/contextlib.rst:837 msgid "" "Due to the way the decorator protocol works, a callback function declared " "this way cannot take any parameters. Instead, any resources to be released " "must be accessed as closure variables." msgstr "" -#: library/contextlib.rst:841 +#: library/contextlib.rst:843 msgid "Using a context manager as a function decorator" msgstr "" -#: library/contextlib.rst:843 +#: library/contextlib.rst:845 msgid "" ":class:`ContextDecorator` makes it possible to use a context manager in both " "an ordinary ``with`` statement and also as a function decorator." msgstr "" -#: library/contextlib.rst:846 +#: library/contextlib.rst:848 msgid "" "For example, it is sometimes useful to wrap functions or groups of " "statements with a logger that can track the time of entry and time of exit. " @@ -724,15 +725,15 @@ msgid "" "in a single definition::" msgstr "" -#: library/contextlib.rst:867 +#: library/contextlib.rst:869 msgid "Instances of this class can be used as both a context manager::" msgstr "" -#: library/contextlib.rst:873 +#: library/contextlib.rst:875 msgid "And also as a function decorator::" msgstr "" -#: library/contextlib.rst:880 +#: library/contextlib.rst:882 msgid "" "Note that there is one additional limitation when using context managers as " "function decorators: there's no way to access the return value of :meth:" @@ -740,21 +741,21 @@ msgid "" "use an explicit ``with`` statement." msgstr "" -#: library/contextlib.rst:887 +#: library/contextlib.rst:889 msgid ":pep:`343` - The \"with\" statement" msgstr "" -#: library/contextlib.rst:888 +#: library/contextlib.rst:890 msgid "" "The specification, background, and examples for the Python :keyword:`with` " "statement." msgstr "" -#: library/contextlib.rst:894 +#: library/contextlib.rst:896 msgid "Single use, reusable and reentrant context managers" msgstr "" -#: library/contextlib.rst:896 +#: library/contextlib.rst:898 msgid "" "Most context managers are written in a way that means they can only be used " "effectively in a :keyword:`with` statement once. These single use context " @@ -762,32 +763,32 @@ msgid "" "them a second time will trigger an exception or otherwise not work correctly." msgstr "" -#: library/contextlib.rst:902 +#: library/contextlib.rst:904 msgid "" "This common limitation means that it is generally advisable to create " "context managers directly in the header of the :keyword:`with` statement " "where they are used (as shown in all of the usage examples above)." msgstr "" -#: library/contextlib.rst:906 +#: library/contextlib.rst:908 msgid "" "Files are an example of effectively single use context managers, since the " "first :keyword:`with` statement will close the file, preventing any further " "IO operations using that file object." msgstr "" -#: library/contextlib.rst:910 +#: library/contextlib.rst:912 msgid "" "Context managers created using :func:`contextmanager` are also single use " "context managers, and will complain about the underlying generator failing " "to yield if an attempt is made to use them a second time::" msgstr "" -#: library/contextlib.rst:938 +#: library/contextlib.rst:940 msgid "Reentrant context managers" msgstr "" -#: library/contextlib.rst:940 +#: library/contextlib.rst:942 msgid "" "More sophisticated context managers may be \"reentrant\". These context " "managers can not only be used in multiple :keyword:`with` statements, but " @@ -795,21 +796,21 @@ msgid "" "the same context manager." msgstr "" -#: library/contextlib.rst:945 +#: library/contextlib.rst:947 msgid "" ":class:`threading.RLock` is an example of a reentrant context manager, as " "are :func:`suppress`, :func:`redirect_stdout`, and :func:`chdir`. Here's a " "very simple example of reentrant use::" msgstr "" -#: library/contextlib.rst:964 +#: library/contextlib.rst:966 msgid "" "Real world examples of reentrancy are more likely to involve multiple " "functions calling each other and hence be far more complicated than this " "example." msgstr "" -#: library/contextlib.rst:968 +#: library/contextlib.rst:970 msgid "" "Note also that being reentrant is *not* the same thing as being thread " "safe. :func:`redirect_stdout`, for example, is definitely not thread safe, " @@ -817,11 +818,11 @@ msgid "" "stdout` to a different stream." msgstr "" -#: library/contextlib.rst:977 +#: library/contextlib.rst:979 msgid "Reusable context managers" msgstr "" -#: library/contextlib.rst:979 +#: library/contextlib.rst:981 msgid "" "Distinct from both single use and reentrant context managers are " "\"reusable\" context managers (or, to be completely explicit, \"reusable, " @@ -831,21 +832,21 @@ msgid "" "manager instance has already been used in a containing with statement." msgstr "" -#: library/contextlib.rst:986 +#: library/contextlib.rst:988 msgid "" ":class:`threading.Lock` is an example of a reusable, but not reentrant, " "context manager (for a reentrant lock, it is necessary to use :class:" "`threading.RLock` instead)." msgstr "" -#: library/contextlib.rst:990 +#: library/contextlib.rst:992 msgid "" "Another example of a reusable, but not reentrant, context manager is :class:" "`ExitStack`, as it invokes *all* currently registered callbacks when leaving " "any with statement, regardless of where those callbacks were added::" msgstr "" -#: library/contextlib.rst:1021 +#: library/contextlib.rst:1023 msgid "" "As the output from the example shows, reusing a single stack object across " "multiple with statements works correctly, but attempting to nest them will " @@ -853,7 +854,7 @@ msgid "" "which is unlikely to be desirable behaviour." msgstr "" -#: library/contextlib.rst:1026 +#: library/contextlib.rst:1028 msgid "" "Using separate :class:`ExitStack` instances instead of reusing a single " "instance avoids that problem::" diff --git a/library/crypt.po b/library/crypt.po index c95bb2ac9..ff0fc95d1 100644 --- a/library/crypt.po +++ b/library/crypt.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/crypt.py`" msgstr "" -#: library/crypt.rst:24 +#: library/crypt.rst:19 msgid "" "The :mod:`crypt` module is deprecated (see :pep:`PEP 594 <594#crypt>` for " "details and alternatives). The :mod:`hashlib` module is a potential " diff --git a/library/ctypes.po b/library/ctypes.po index d92e52ec3..c0e881f63 100644 --- a/library/ctypes.po +++ b/library/ctypes.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -117,7 +117,7 @@ msgstr "" msgid "" "Note that win32 system dlls like ``kernel32`` and ``user32`` often export " "ANSI as well as UNICODE versions of a function. The UNICODE version is " -"exported with an ``W`` appended to the name, while the ANSI version is " +"exported with a ``W`` appended to the name, while the ANSI version is " "exported with an ``A`` appended to the name. The win32 ``GetModuleHandle`` " "function, which returns a *module handle* for a given module name, has the " "following C prototype, and a macro is used to expose one of them as " @@ -1518,8 +1518,8 @@ msgstr "" #: library/ctypes.rst:1580 msgid "" -"Raises an :ref:`auditing event ` ``ctypes.dlopen`` with argument " -"``name``." +"Loading a library through any of these objects raises an auditing event " +"ctypes.dlopen with string argument name, the name used to load the library." msgstr "" #: library/ctypes.rst:1582 @@ -1531,8 +1531,9 @@ msgstr "" #: library/ctypes.rst:1586 msgid "" -"Raises an :ref:`auditing event ` ``ctypes.dlsym`` with arguments " -"``library``, ``name``." +"Accessing a function on a loaded library raises an auditing event ctypes." +"dlsym with arguments library (the library object) and name (the symbol's " +"name as a string or integer)." msgstr "" #: library/ctypes.rst:1588 @@ -1544,8 +1545,9 @@ msgstr "" #: library/ctypes.rst:1592 msgid "" -"Raises an :ref:`auditing event ` ``ctypes.dlsym/handle`` with " -"arguments ``handle``, ``name``." +"In cases when only the library handle is available rather than the object, " +"accessing a function raises an auditing event ctypes.dlsym/handle with " +"arguments handle (the raw library handle) and name." msgstr "" #: library/ctypes.rst:1594 @@ -1666,8 +1668,11 @@ msgstr "" #: library/ctypes.rst:1683 msgid "" -"Raises an :ref:`auditing event ` ``ctypes.set_exception`` with " -"argument ``code``." +"On Windows, when a foreign function call raises a system exception (for " +"example, due to an access violation), it will be captured and replaced with " +"a suitable Python exception. Further, an auditing event ctypes.set_exception " +"with argument code will be raised, allowing an audit hook to replace the " +"exception with its own." msgstr "" #: library/ctypes.rst:1685 @@ -1681,8 +1686,8 @@ msgstr "" #: library/ctypes.rst:1691 msgid "" -"Raises an :ref:`auditing event ` ``ctypes.call_function`` with " -"arguments ``func_pointer``, ``arguments``." +"Some ways to invoke foreign function calls may raise an auditing event " +"ctypes.call_function with arguments function pointer and arguments." msgstr "" #: library/ctypes.rst:1693 @@ -1887,9 +1892,7 @@ msgid "" msgstr "" #: library/ctypes.rst:1886 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.addressof`` with " -"argument ``obj``." +msgid "Raises an auditing event ctypes.addressof with argument obj." msgstr "" #: library/ctypes.rst:1891 @@ -1946,8 +1949,8 @@ msgstr "" #: library/ctypes.rst:1930 msgid "" -"Raises an :ref:`auditing event ` ``ctypes.create_string_buffer`` " -"with arguments ``init``, ``size``." +"Raises an auditing event ctypes.create_string_buffer with arguments init, " +"size." msgstr "" #: library/ctypes.rst:1935 @@ -1973,8 +1976,8 @@ msgstr "" #: library/ctypes.rst:1947 msgid "" -"Raises an :ref:`auditing event ` ``ctypes.create_unicode_buffer`` " -"with arguments ``init``, ``size``." +"Raises an auditing event ctypes.create_unicode_buffer with arguments init, " +"size." msgstr "" #: library/ctypes.rst:1952 @@ -2034,9 +2037,7 @@ msgid "" msgstr "" #: library/ctypes.rst:2005 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.get_errno`` with no " -"arguments." +msgid "Raises an auditing event ctypes.get_errno with no arguments." msgstr "" #: library/ctypes.rst:2009 @@ -2046,9 +2047,7 @@ msgid "" msgstr "" #: library/ctypes.rst:2012 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.get_last_error`` with no " -"arguments." +msgid "Raises an auditing event ctypes.get_last_error with no arguments." msgstr "" #: library/ctypes.rst:2016 @@ -2099,9 +2098,7 @@ msgid "" msgstr "" #: library/ctypes.rst:2057 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.set_errno`` with " -"argument ``errno``." +msgid "Raises an auditing event ctypes.set_errno with argument errno." msgstr "" #: library/ctypes.rst:2062 @@ -2112,9 +2109,7 @@ msgid "" msgstr "" #: library/ctypes.rst:2066 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.set_last_error`` with " -"argument ``error``." +msgid "Raises an auditing event ctypes.set_last_error with argument error." msgstr "" #: library/ctypes.rst:2071 @@ -2130,9 +2125,7 @@ msgid "" msgstr "" #: library/ctypes.rst:2081 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.string_at`` with " -"arguments ``ptr``, ``size``." +msgid "Raises an auditing event ctypes.string_at with arguments ptr, size." msgstr "" #: library/ctypes.rst:2086 @@ -2158,9 +2151,7 @@ msgid "" msgstr "" #: library/ctypes.rst:2104 -msgid "" -"Raises an :ref:`auditing event ` ``ctypes.wstring_at`` with " -"arguments ``ptr``, ``size``." +msgid "Raises an auditing event ctypes.wstring_at with arguments ptr, size." msgstr "" #: library/ctypes.rst:2110 @@ -2194,8 +2185,8 @@ msgstr "" #: library/ctypes.rst:2143 msgid "" -"Raises an :ref:`auditing event ` ``ctypes.cdata/buffer`` with " -"arguments ``pointer``, ``size``, ``offset``." +"Raises an auditing event ctypes.cdata/buffer with arguments pointer, size, " +"offset." msgstr "" #: library/ctypes.rst:2137 @@ -2214,8 +2205,8 @@ msgstr "" #: library/ctypes.rst:2150 msgid "" -"Raises an :ref:`auditing event ` ``ctypes.cdata`` with argument " -"``address``." +"This method, and others that indirectly call this method, raises an auditing " +"event ctypes.cdata with argument address." msgstr "" #: library/ctypes.rst:2152 diff --git a/library/datetime.po b/library/datetime.po index d807a27c2..cd1048a0e 100644 --- a/library/datetime.po +++ b/library/datetime.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2024-04-15 00:06-0400\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -98,9 +98,10 @@ msgid "Aware and Naive Objects" msgstr "Bilinçli ve Bilinçsiz Nesneler" #: library/datetime.rst:50 +#, fuzzy msgid "" "Date and time objects may be categorized as \"aware\" or \"naive\" depending " -"on whether or not they include timezone information." +"on whether or not they include time zone information." msgstr "" "Tarih ve zaman nesneleri, zaman dilimi içerip içermediklerine göre " "\"bilinçli\" veya \"bilinçsiz\" olarak kategorize edilebilir." @@ -119,11 +120,12 @@ msgstr "" "nesne, zaman içinde yoruma açık olmayan belirli bir anı temsil eder. [#]_" #: library/datetime.rst:59 +#, fuzzy msgid "" "A **naive** object does not contain enough information to unambiguously " "locate itself relative to other date/time objects. Whether a naive object " "represents Coordinated Universal Time (UTC), local time, or time in some " -"other timezone is purely up to the program, just like it is up to the " +"other time zone is purely up to the program, just like it is up to the " "program whether a particular number represents metres, miles, or mass. Naive " "objects are easy to understand and to work with, at the cost of ignoring " "some aspects of reality." @@ -156,9 +158,9 @@ msgstr "" #, fuzzy msgid "" "Only one concrete :class:`tzinfo` class, the :class:`timezone` class, is " -"supplied by the :mod:`!datetime` module. The :class:`timezone` class can " -"represent simple timezones with fixed offsets from UTC, such as UTC itself " -"or North American EST and EDT timezones. Supporting timezones at deeper " +"supplied by the :mod:`!datetime` module. The :class:`!timezone` class can " +"represent simple time zones with fixed offsets from UTC, such as UTC itself " +"or North American EST and EDT time zones. Supporting time zones at deeper " "levels of detail is up to the application. The rules for time adjustment " "across the world are more political than rational, change frequently, and " "there is no standard suitable for every application aside from UTC." @@ -200,7 +202,8 @@ msgstr "" "yıl sayısı. :const:`MAXYEAR`, ``9999``'a eşittir." #: library/datetime.rst:98 -msgid "Alias for the UTC timezone singleton :attr:`datetime.timezone.utc`." +#, fuzzy +msgid "Alias for the UTC time zone singleton :attr:`datetime.timezone.utc`." msgstr "" "UTC zaman dilimi singleton :attr:`datetime.timezone.utc` için takma ad." @@ -1232,7 +1235,7 @@ msgid "Added the *fold* parameter." msgstr "" #: library/datetime.rst:853 -msgid "Return the current local datetime, with :attr:`.tzinfo` ``None``." +msgid "Return the current local date and time, with :attr:`.tzinfo` ``None``." msgstr "" #: library/datetime.rst:855 @@ -1454,7 +1457,7 @@ msgstr "" #: library/datetime.rst:1054 msgid "" -"If *format* does not contain microseconds or timezone information, this is " +"If *format* does not contain microseconds or time zone information, this is " "equivalent to::" msgstr "" @@ -1692,13 +1695,13 @@ msgstr "" msgid "" "If provided, *tz* must be an instance of a :class:`tzinfo` subclass, and " "its :meth:`utcoffset` and :meth:`dst` methods must not return ``None``. If " -"*self* is naive, it is presumed to represent time in the system timezone." +"*self* is naive, it is presumed to represent time in the system time zone." msgstr "" #: library/datetime.rst:1272 msgid "" -"If called without arguments (or with ``tz=None``) the system local timezone " -"is assumed for the target timezone. The ``.tzinfo`` attribute of the " +"If called without arguments (or with ``tz=None``) the system local time zone " +"is assumed for the target time zone. The ``.tzinfo`` attribute of the " "converted datetime instance will be set to an instance of :class:`timezone` " "with the zone name and offset obtained from the OS." msgstr "" @@ -1707,17 +1710,18 @@ msgstr "" msgid "" "If ``self.tzinfo`` is *tz*, ``self.astimezone(tz)`` is equal to *self*: no " "adjustment of date or time data is performed. Else the result is local time " -"in the timezone *tz*, representing the same UTC time as *self*: after " +"in the time zone *tz*, representing the same UTC time as *self*: after " "``astz = dt.astimezone(tz)``, ``astz - astz.utcoffset()`` will have the same " "date and time data as ``dt - dt.utcoffset()``." msgstr "" #: library/datetime.rst:1283 msgid "" -"If you merely want to attach a time zone object *tz* to a datetime *dt* " -"without adjustment of date and time data, use ``dt.replace(tzinfo=tz)``. If " -"you merely want to remove the time zone object from an aware datetime *dt* " -"without conversion of date and time data, use ``dt.replace(tzinfo=None)``." +"If you merely want to attach a :class:`timezone` object *tz* to a datetime " +"*dt* without adjustment of date and time data, use ``dt." +"replace(tzinfo=tz)``. If you merely want to remove the :class:`!timezone` " +"object from an aware datetime *dt* without conversion of date and time data, " +"use ``dt.replace(tzinfo=None)``." msgstr "" #: library/datetime.rst:1288 @@ -1843,7 +1847,7 @@ msgstr "" msgid "" "There is no method to obtain the POSIX timestamp directly from a naive :" "class:`.datetime` instance representing UTC time. If your application uses " -"this convention and your system timezone is not set to UTC, you can obtain " +"this convention and your system time zone is not set to UTC, you can obtain " "the POSIX timestamp by supplying ``tzinfo=timezone.utc``::" msgstr "" @@ -2239,7 +2243,7 @@ msgid "" "implementations of the standard :class:`tzinfo` methods needed by the :class:" "`.datetime` methods you use. The :mod:`!datetime` module provides :class:" "`timezone`, a simple concrete subclass of :class:`tzinfo` which can " -"represent timezones with fixed offset from UTC such as UTC itself or North " +"represent time zones with fixed offset from UTC such as UTC itself or North " "American EST and EDT." msgstr "" @@ -2389,8 +2393,8 @@ msgid "" "datetime` method, ``dt.tzinfo`` is the same object as *self*. :class:" "`tzinfo` methods can rely on this, unless user code calls :class:`tzinfo` " "methods directly. The intent is that the :class:`tzinfo` methods interpret " -"*dt* as being in local time, and not need worry about objects in other " -"timezones." +"*dt* as being in local time, and not need worry about objects in other time " +"zones." msgstr "" #: library/datetime.rst:2104 @@ -2401,11 +2405,11 @@ msgstr "" #: library/datetime.rst:2109 msgid "" -"This is called from the default :class:`datetime.astimezone()` " -"implementation. When called from that, ``dt.tzinfo`` is *self*, and *dt*'s " -"date and time data are to be viewed as expressing a UTC time. The purpose " -"of :meth:`fromutc` is to adjust the date and time data, returning an " -"equivalent datetime in *self*'s local time." +"This is called from the default :meth:`datetime.astimezone` implementation. " +"When called from that, ``dt.tzinfo`` is *self*, and *dt*'s date and time " +"data are to be viewed as expressing a UTC time. The purpose of :meth:" +"`fromutc` is to adjust the date and time data, returning an equivalent " +"datetime in *self*'s local time." msgstr "" #: library/datetime.rst:2115 @@ -2492,17 +2496,17 @@ msgstr "" msgid "" "The :mod:`!datetime` module has a basic :class:`timezone` class (for " "handling arbitrary fixed offsets from UTC) and its :attr:`timezone.utc` " -"attribute (a UTC timezone instance)." +"attribute (a UTC :class:`!timezone` instance)." msgstr "" #: library/datetime.rst:2221 msgid "" -"``zoneinfo`` brings the *IANA timezone database* (also known as the Olson " +"``zoneinfo`` brings the *IANA time zone database* (also known as the Olson " "database) to Python, and its usage is recommended." msgstr "" #: library/datetime.rst:2224 -msgid "`IANA timezone database `_" +msgid "`IANA time zone database `_" msgstr "" #: library/datetime.rst:2225 @@ -2521,12 +2525,12 @@ msgstr "" #: library/datetime.rst:2237 msgid "" "The :class:`timezone` class is a subclass of :class:`tzinfo`, each instance " -"of which represents a timezone defined by a fixed offset from UTC." +"of which represents a time zone defined by a fixed offset from UTC." msgstr "" #: library/datetime.rst:2241 msgid "" -"Objects of this class cannot be used to represent timezone information in " +"Objects of this class cannot be used to represent time zone information in " "the locations where different offsets are used in different days of the year " "or where historical changes have been made to civil time." msgstr "" @@ -2583,7 +2587,7 @@ msgid "" msgstr "" #: library/datetime.rst:2302 -msgid "The UTC timezone, ``timezone(timedelta(0))``." +msgid "The UTC time zone, ``timezone(timedelta(0))``." msgstr "" #: library/datetime.rst:2311 @@ -3160,7 +3164,7 @@ msgstr "" #: library/datetime.rst:2511 msgid "" -"except when the format includes sub-second components or timezone offset " +"except when the format includes sub-second components or time zone offset " "information, which are supported in ``datetime.strptime`` but are discarded " "by ``time.strptime``." msgstr "" diff --git a/library/decimal.po b/library/decimal.po index 13c23248d..5fa5168fe 100644 --- a/library/decimal.po +++ b/library/decimal.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -17,7 +17,7 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: library/decimal.rst:2 -msgid ":mod:`!decimal` --- Decimal fixed point and floating point arithmetic" +msgid ":mod:`!decimal` --- Decimal fixed-point and floating-point arithmetic" msgstr "" #: library/decimal.rst:15 @@ -27,7 +27,7 @@ msgstr "" #: library/decimal.rst:33 msgid "" "The :mod:`decimal` module provides support for fast correctly rounded " -"decimal floating point arithmetic. It offers several advantages over the :" +"decimal floating-point arithmetic. It offers several advantages over the :" "class:`float` datatype:" msgstr "" @@ -186,7 +186,7 @@ msgstr "" #: library/decimal.rst:209 msgid "" "Decimals interact well with much of the rest of Python. Here is a small " -"decimal floating point flying circus:" +"decimal floating-point flying circus:" msgstr "" #: library/decimal.rst:241 @@ -287,7 +287,7 @@ msgstr "" #: library/decimal.rst:376 msgid "" -"If *value* is a :class:`float`, the binary floating point value is " +"If *value* is a :class:`float`, the binary floating-point value is " "losslessly converted to its exact decimal equivalent. This conversion can " "often require 53 or more digits of precision. For example, " "``Decimal(float('1.1'))`` converts to " @@ -334,7 +334,7 @@ msgstr "" #: library/decimal.rst:406 msgid "" -"Decimal floating point objects share many properties with the other built-in " +"Decimal floating-point objects share many properties with the other built-in " "numeric types such as :class:`float` and :class:`int`. All of the usual " "math operations and special methods apply. Likewise, decimal objects can be " "copied, pickled, printed, used as dictionary keys, used as set elements, " @@ -382,7 +382,7 @@ msgstr "" #: library/decimal.rst:448 msgid "" -"In addition to the standard numeric properties, decimal floating point " +"In addition to the standard numeric properties, decimal floating-point " "objects also have a number of specialized methods:" msgstr "" @@ -857,12 +857,12 @@ msgstr "" msgid "Return the square root of the argument to full precision." msgstr "" -#: library/decimal.rst:1468 +#: library/decimal.rst:1510 msgid "" "Convert to a string, using engineering notation if an exponent is needed." msgstr "" -#: library/decimal.rst:1470 +#: library/decimal.rst:1512 msgid "" "Engineering notation has an exponent which is a multiple of 3. This can " "leave up to 3 digits to the left of the decimal place and may require the " @@ -895,11 +895,55 @@ msgid "" "method in either the supplied *context* or the current context." msgstr "" -#: library/decimal.rst:904 +#: library/decimal.rst:900 +msgid "Decimal numbers can be rounded using the :func:`.round` function:" +msgstr "" + +#: library/decimal.rst:905 +msgid "" +"If *ndigits* is not given or ``None``, returns the nearest :class:`int` to " +"*number*, rounding ties to even, and ignoring the rounding mode of the :" +"class:`Decimal` context. Raises :exc:`OverflowError` if *number* is an " +"infinity or :exc:`ValueError` if it is a (quiet or signaling) NaN." +msgstr "" + +#: library/decimal.rst:911 +msgid "" +"If *ndigits* is an :class:`int`, the context's rounding mode is respected " +"and a :class:`Decimal` representing *number* rounded to the nearest multiple " +"of ``Decimal('1E-ndigits')`` is returned; in this case, ``round(number, " +"ndigits)`` is equivalent to ``self.quantize(Decimal('1E-ndigits'))``. " +"Returns ``Decimal('NaN')`` if *number* is a quiet NaN. Raises :class:" +"`InvalidOperation` if *number* is an infinity, a signaling NaN, or if the " +"length of the coefficient after the quantize operation would be greater than " +"the current context's precision. In other words, for the non-corner cases:" +msgstr "" + +#: library/decimal.rst:921 +msgid "" +"if *ndigits* is positive, return *number* rounded to *ndigits* decimal " +"places;" +msgstr "" + +#: library/decimal.rst:923 +msgid "if *ndigits* is zero, return *number* rounded to the nearest integer;" +msgstr "" + +#: library/decimal.rst:924 +msgid "" +"if *ndigits* is negative, return *number* rounded to the nearest multiple of " +"``10**abs(ndigits)``." +msgstr "" + +#: library/decimal.rst:927 +msgid "For example::" +msgstr "" + +#: library/decimal.rst:946 msgid "Logical operands" msgstr "" -#: library/decimal.rst:906 +#: library/decimal.rst:948 msgid "" "The :meth:`~Decimal.logical_and`, :meth:`~Decimal.logical_invert`, :meth:" "`~Decimal.logical_or`, and :meth:`~Decimal.logical_xor` methods expect their " @@ -908,38 +952,38 @@ msgid "" "are all either ``0`` or ``1``." msgstr "" -#: library/decimal.rst:918 +#: library/decimal.rst:960 msgid "Context objects" msgstr "" -#: library/decimal.rst:920 +#: library/decimal.rst:962 msgid "" "Contexts are environments for arithmetic operations. They govern precision, " "set rules for rounding, determine which signals are treated as exceptions, " "and limit the range for exponents." msgstr "" -#: library/decimal.rst:924 +#: library/decimal.rst:966 msgid "" "Each thread has its own current context which is accessed or changed using " "the :func:`getcontext` and :func:`setcontext` functions:" msgstr "" -#: library/decimal.rst:930 +#: library/decimal.rst:972 msgid "Return the current context for the active thread." msgstr "" -#: library/decimal.rst:935 +#: library/decimal.rst:977 msgid "Set the current context for the active thread to *c*." msgstr "" -#: library/decimal.rst:937 +#: library/decimal.rst:979 msgid "" "You can also use the :keyword:`with` statement and the :func:`localcontext` " "function to temporarily change the active context." msgstr "" -#: library/decimal.rst:942 +#: library/decimal.rst:984 msgid "" "Return a context manager that will set the current context for the active " "thread to a copy of *ctx* on entry to the with-statement and restore the " @@ -948,37 +992,37 @@ msgid "" "used to set the attributes of the new context." msgstr "" -#: library/decimal.rst:948 +#: library/decimal.rst:990 msgid "" "For example, the following code sets the current decimal precision to 42 " "places, performs a calculation, and then automatically restores the previous " "context::" msgstr "" -#: library/decimal.rst:958 +#: library/decimal.rst:1000 msgid "Using keyword arguments, the code would be the following::" msgstr "" -#: library/decimal.rst:966 +#: library/decimal.rst:1008 msgid "" "Raises :exc:`TypeError` if *kwargs* supplies an attribute that :class:" "`Context` doesn't support. Raises either :exc:`TypeError` or :exc:" "`ValueError` if *kwargs* supplies an invalid value for an attribute." msgstr "" -#: library/decimal.rst:970 +#: library/decimal.rst:1012 msgid "" ":meth:`localcontext` now supports setting context attributes through the use " "of keyword arguments." msgstr "" -#: library/decimal.rst:973 +#: library/decimal.rst:1015 msgid "" "New contexts can also be created using the :class:`Context` constructor " "described below. In addition, the module provides three pre-made contexts:" msgstr "" -#: library/decimal.rst:979 +#: library/decimal.rst:1021 msgid "" "This is a standard context defined by the General Decimal Arithmetic " "Specification. Precision is set to nine. Rounding is set to :const:" @@ -987,12 +1031,12 @@ msgid "" "`Subnormal`." msgstr "" -#: library/decimal.rst:985 +#: library/decimal.rst:1027 msgid "" "Because many of the traps are enabled, this context is useful for debugging." msgstr "" -#: library/decimal.rst:990 +#: library/decimal.rst:1032 msgid "" "This is a standard context defined by the General Decimal Arithmetic " "Specification. Precision is set to nine. Rounding is set to :const:" @@ -1000,7 +1044,7 @@ msgid "" "exceptions are not raised during computations)." msgstr "" -#: library/decimal.rst:995 +#: library/decimal.rst:1037 msgid "" "Because the traps are disabled, this context is useful for applications that " "prefer to have result value of ``NaN`` or ``Infinity`` instead of raising " @@ -1008,7 +1052,7 @@ msgid "" "conditions that would otherwise halt the program." msgstr "" -#: library/decimal.rst:1003 +#: library/decimal.rst:1045 msgid "" "This context is used by the :class:`Context` constructor as a prototype for " "new contexts. Changing a field (such a precision) has the effect of " @@ -1016,7 +1060,7 @@ msgid "" "constructor." msgstr "" -#: library/decimal.rst:1007 +#: library/decimal.rst:1049 msgid "" "This context is most useful in multi-threaded environments. Changing one of " "the fields before threads are started has the effect of setting system-wide " @@ -1024,65 +1068,65 @@ msgid "" "as it would require thread synchronization to prevent race conditions." msgstr "" -#: library/decimal.rst:1012 +#: library/decimal.rst:1054 msgid "" "In single threaded environments, it is preferable to not use this context at " "all. Instead, simply create contexts explicitly as described below." msgstr "" -#: library/decimal.rst:1015 +#: library/decimal.rst:1057 msgid "" "The default values are :attr:`Context.prec`\\ =\\ ``28``, :attr:`Context." "rounding`\\ =\\ :const:`ROUND_HALF_EVEN`, and enabled traps for :class:" "`Overflow`, :class:`InvalidOperation`, and :class:`DivisionByZero`." msgstr "" -#: library/decimal.rst:1020 +#: library/decimal.rst:1062 msgid "" "In addition to the three supplied contexts, new contexts can be created with " "the :class:`Context` constructor." msgstr "" -#: library/decimal.rst:1026 +#: library/decimal.rst:1068 msgid "" "Creates a new context. If a field is not specified or is :const:`None`, the " "default values are copied from the :const:`DefaultContext`. If the *flags* " "field is not specified or is :const:`None`, all flags are cleared." msgstr "" -#: library/decimal.rst:1030 +#: library/decimal.rst:1072 msgid "" "*prec* is an integer in the range [``1``, :const:`MAX_PREC`] that sets the " "precision for arithmetic operations in the context." msgstr "" -#: library/decimal.rst:1033 +#: library/decimal.rst:1075 msgid "" "The *rounding* option is one of the constants listed in the section " "`Rounding Modes`_." msgstr "" -#: library/decimal.rst:1036 +#: library/decimal.rst:1078 msgid "" "The *traps* and *flags* fields list any signals to be set. Generally, new " "contexts should only set traps and leave the flags clear." msgstr "" -#: library/decimal.rst:1039 +#: library/decimal.rst:1081 msgid "" "The *Emin* and *Emax* fields are integers specifying the outer limits " "allowable for exponents. *Emin* must be in the range [:const:`MIN_EMIN`, " "``0``], *Emax* in the range [``0``, :const:`MAX_EMAX`]." msgstr "" -#: library/decimal.rst:1043 +#: library/decimal.rst:1085 msgid "" "The *capitals* field is either ``0`` or ``1`` (the default). If set to " "``1``, exponents are printed with a capital ``E``; otherwise, a lowercase " "``e`` is used: ``Decimal('6.02e+23')``." msgstr "" -#: library/decimal.rst:1047 +#: library/decimal.rst:1089 msgid "" "The *clamp* field is either ``0`` (the default) or ``1``. If set to ``1``, " "the exponent ``e`` of a :class:`Decimal` instance representable in this " @@ -1096,13 +1140,13 @@ msgid "" "For example::" msgstr "" -#: library/decimal.rst:1062 +#: library/decimal.rst:1104 msgid "" "A *clamp* value of ``1`` allows compatibility with the fixed-width decimal " "interchange formats specified in IEEE 754." msgstr "" -#: library/decimal.rst:1065 +#: library/decimal.rst:1107 msgid "" "The :class:`Context` class defines several general purpose methods as well " "as a large number of methods for doing arithmetic directly in a given " @@ -1115,30 +1159,30 @@ msgid "" "instance of :class:`int`) anywhere that a Decimal instance is accepted." msgstr "" -#: library/decimal.rst:1078 +#: library/decimal.rst:1120 msgid "Resets all of the flags to ``0``." msgstr "" -#: library/decimal.rst:1082 +#: library/decimal.rst:1124 msgid "Resets all of the traps to ``0``." msgstr "" -#: library/decimal.rst:1088 +#: library/decimal.rst:1130 msgid "Return a duplicate of the context." msgstr "" -#: library/decimal.rst:1092 +#: library/decimal.rst:1134 msgid "Return a copy of the Decimal instance num." msgstr "" -#: library/decimal.rst:1096 +#: library/decimal.rst:1138 msgid "" "Creates a new Decimal instance from *num* but using *self* as context. " "Unlike the :class:`Decimal` constructor, the context precision, rounding " "method, flags, and traps are applied to the conversion." msgstr "" -#: library/decimal.rst:1100 +#: library/decimal.rst:1142 msgid "" "This is useful because constants are often given to a greater precision than " "is needed by the application. Another benefit is that rounding immediately " @@ -1147,14 +1191,14 @@ msgid "" "sum can change the result:" msgstr "" -#: library/decimal.rst:1114 +#: library/decimal.rst:1156 msgid "" "This method implements the to-number operation of the IBM specification. If " "the argument is a string, no leading or trailing whitespace or underscores " "are permitted." msgstr "" -#: library/decimal.rst:1120 +#: library/decimal.rst:1162 msgid "" "Creates a new Decimal instance from a float *f* but rounding using *self* as " "the context. Unlike the :meth:`Decimal.from_float` class method, the " @@ -1162,18 +1206,18 @@ msgid "" "conversion." msgstr "" -#: library/decimal.rst:1140 +#: library/decimal.rst:1182 msgid "" "Returns a value equal to ``Emin - prec + 1`` which is the minimum exponent " "value for subnormal results. When underflow occurs, the exponent is set to :" "const:`Etiny`." msgstr "" -#: library/decimal.rst:1146 +#: library/decimal.rst:1188 msgid "Returns a value equal to ``Emax - prec + 1``." msgstr "" -#: library/decimal.rst:1148 +#: library/decimal.rst:1190 msgid "" "The usual approach to working with decimals is to create :class:`Decimal` " "instances and then apply arithmetic operations which take place within the " @@ -1183,189 +1227,189 @@ msgid "" "recounted here." msgstr "" -#: library/decimal.rst:1158 +#: library/decimal.rst:1200 msgid "Returns the absolute value of *x*." msgstr "" -#: library/decimal.rst:1163 +#: library/decimal.rst:1205 msgid "Return the sum of *x* and *y*." msgstr "" -#: library/decimal.rst:1168 +#: library/decimal.rst:1210 msgid "Returns the same Decimal object *x*." msgstr "" -#: library/decimal.rst:1173 +#: library/decimal.rst:1215 msgid "Compares *x* and *y* numerically." msgstr "" -#: library/decimal.rst:1178 +#: library/decimal.rst:1220 msgid "Compares the values of the two operands numerically." msgstr "" -#: library/decimal.rst:1183 +#: library/decimal.rst:1225 msgid "Compares two operands using their abstract representation." msgstr "" -#: library/decimal.rst:1188 +#: library/decimal.rst:1230 msgid "" "Compares two operands using their abstract representation, ignoring sign." msgstr "" -#: library/decimal.rst:1193 +#: library/decimal.rst:1235 msgid "Returns a copy of *x* with the sign set to 0." msgstr "" -#: library/decimal.rst:1198 +#: library/decimal.rst:1240 msgid "Returns a copy of *x* with the sign inverted." msgstr "" -#: library/decimal.rst:1203 +#: library/decimal.rst:1245 msgid "Copies the sign from *y* to *x*." msgstr "" -#: library/decimal.rst:1208 +#: library/decimal.rst:1250 msgid "Return *x* divided by *y*." msgstr "" -#: library/decimal.rst:1213 +#: library/decimal.rst:1255 msgid "Return *x* divided by *y*, truncated to an integer." msgstr "" -#: library/decimal.rst:1218 +#: library/decimal.rst:1260 msgid "Divides two numbers and returns the integer part of the result." msgstr "" -#: library/decimal.rst:1223 +#: library/decimal.rst:1265 msgid "Returns ``e ** x``." msgstr "" -#: library/decimal.rst:1228 +#: library/decimal.rst:1270 msgid "Returns *x* multiplied by *y*, plus *z*." msgstr "" -#: library/decimal.rst:1233 +#: library/decimal.rst:1275 msgid "Returns ``True`` if *x* is canonical; otherwise returns ``False``." msgstr "" -#: library/decimal.rst:1238 +#: library/decimal.rst:1280 msgid "Returns ``True`` if *x* is finite; otherwise returns ``False``." msgstr "" -#: library/decimal.rst:1243 +#: library/decimal.rst:1285 msgid "Returns ``True`` if *x* is infinite; otherwise returns ``False``." msgstr "" -#: library/decimal.rst:1248 +#: library/decimal.rst:1290 msgid "Returns ``True`` if *x* is a qNaN or sNaN; otherwise returns ``False``." msgstr "" -#: library/decimal.rst:1253 +#: library/decimal.rst:1295 msgid "" "Returns ``True`` if *x* is a normal number; otherwise returns ``False``." msgstr "" -#: library/decimal.rst:1258 +#: library/decimal.rst:1300 msgid "Returns ``True`` if *x* is a quiet NaN; otherwise returns ``False``." msgstr "" -#: library/decimal.rst:1263 +#: library/decimal.rst:1305 msgid "Returns ``True`` if *x* is negative; otherwise returns ``False``." msgstr "" -#: library/decimal.rst:1268 +#: library/decimal.rst:1310 msgid "" "Returns ``True`` if *x* is a signaling NaN; otherwise returns ``False``." msgstr "" -#: library/decimal.rst:1273 +#: library/decimal.rst:1315 msgid "Returns ``True`` if *x* is subnormal; otherwise returns ``False``." msgstr "" -#: library/decimal.rst:1278 +#: library/decimal.rst:1320 msgid "Returns ``True`` if *x* is a zero; otherwise returns ``False``." msgstr "" -#: library/decimal.rst:1283 +#: library/decimal.rst:1325 msgid "Returns the natural (base e) logarithm of *x*." msgstr "" -#: library/decimal.rst:1288 +#: library/decimal.rst:1330 msgid "Returns the base 10 logarithm of *x*." msgstr "" -#: library/decimal.rst:1293 +#: library/decimal.rst:1335 msgid "Returns the exponent of the magnitude of the operand's MSD." msgstr "" -#: library/decimal.rst:1298 +#: library/decimal.rst:1340 msgid "Applies the logical operation *and* between each operand's digits." msgstr "" -#: library/decimal.rst:1303 +#: library/decimal.rst:1345 msgid "Invert all the digits in *x*." msgstr "" -#: library/decimal.rst:1308 +#: library/decimal.rst:1350 msgid "Applies the logical operation *or* between each operand's digits." msgstr "" -#: library/decimal.rst:1313 +#: library/decimal.rst:1355 msgid "Applies the logical operation *xor* between each operand's digits." msgstr "" -#: library/decimal.rst:1318 +#: library/decimal.rst:1360 msgid "Compares two values numerically and returns the maximum." msgstr "" -#: library/decimal.rst:1333 +#: library/decimal.rst:1375 msgid "Compares the values numerically with their sign ignored." msgstr "" -#: library/decimal.rst:1328 +#: library/decimal.rst:1370 msgid "Compares two values numerically and returns the minimum." msgstr "" -#: library/decimal.rst:1338 +#: library/decimal.rst:1380 msgid "Minus corresponds to the unary prefix minus operator in Python." msgstr "" -#: library/decimal.rst:1343 +#: library/decimal.rst:1385 msgid "Return the product of *x* and *y*." msgstr "" -#: library/decimal.rst:1348 +#: library/decimal.rst:1390 msgid "Returns the largest representable number smaller than *x*." msgstr "" -#: library/decimal.rst:1353 +#: library/decimal.rst:1395 msgid "Returns the smallest representable number larger than *x*." msgstr "" -#: library/decimal.rst:1358 +#: library/decimal.rst:1400 msgid "Returns the number closest to *x*, in direction towards *y*." msgstr "" -#: library/decimal.rst:1363 +#: library/decimal.rst:1405 msgid "Reduces *x* to its simplest form." msgstr "" -#: library/decimal.rst:1368 +#: library/decimal.rst:1410 msgid "Returns an indication of the class of *x*." msgstr "" -#: library/decimal.rst:1373 +#: library/decimal.rst:1415 msgid "" "Plus corresponds to the unary prefix plus operator in Python. This " "operation applies the context precision and rounding, so it is *not* an " "identity operation." msgstr "" -#: library/decimal.rst:1380 +#: library/decimal.rst:1422 msgid "Return ``x`` to the power of ``y``, reduced modulo ``modulo`` if given." msgstr "" -#: library/decimal.rst:1382 +#: library/decimal.rst:1424 msgid "" "With two arguments, compute ``x**y``. If ``x`` is negative then ``y`` must " "be integral. The result will be inexact unless ``y`` is integral and the " @@ -1374,42 +1418,42 @@ msgid "" "in the Python version." msgstr "" -#: library/decimal.rst:1388 +#: library/decimal.rst:1430 msgid "" "``Decimal(0) ** Decimal(0)`` results in ``InvalidOperation``, and if " "``InvalidOperation`` is not trapped, then results in ``Decimal('NaN')``." msgstr "" -#: library/decimal.rst:1391 +#: library/decimal.rst:1433 msgid "" "The C module computes :meth:`power` in terms of the correctly rounded :meth:" "`exp` and :meth:`ln` functions. The result is well-defined but only \"almost " "always correctly rounded\"." msgstr "" -#: library/decimal.rst:1396 +#: library/decimal.rst:1438 msgid "" "With three arguments, compute ``(x**y) % modulo``. For the three argument " "form, the following restrictions on the arguments hold:" msgstr "" -#: library/decimal.rst:1399 +#: library/decimal.rst:1441 msgid "all three arguments must be integral" msgstr "" -#: library/decimal.rst:1400 +#: library/decimal.rst:1442 msgid "``y`` must be nonnegative" msgstr "" -#: library/decimal.rst:1401 +#: library/decimal.rst:1443 msgid "at least one of ``x`` or ``y`` must be nonzero" msgstr "" -#: library/decimal.rst:1402 +#: library/decimal.rst:1444 msgid "``modulo`` must be nonzero and have at most 'precision' digits" msgstr "" -#: library/decimal.rst:1404 +#: library/decimal.rst:1446 msgid "" "The value resulting from ``Context.power(x, y, modulo)`` is equal to the " "value that would be obtained by computing ``(x**y) % modulo`` with unbounded " @@ -1418,110 +1462,110 @@ msgid "" "result is always exact." msgstr "" -#: library/decimal.rst:1414 +#: library/decimal.rst:1456 msgid "Returns a value equal to *x* (rounded), having the exponent of *y*." msgstr "" -#: library/decimal.rst:1419 +#: library/decimal.rst:1461 msgid "Just returns 10, as this is Decimal, :)" msgstr "" -#: library/decimal.rst:1424 +#: library/decimal.rst:1466 msgid "Returns the remainder from integer division." msgstr "" -#: library/decimal.rst:1426 +#: library/decimal.rst:1468 msgid "" "The sign of the result, if non-zero, is the same as that of the original " "dividend." msgstr "" -#: library/decimal.rst:1432 +#: library/decimal.rst:1474 msgid "" "Returns ``x - y * n``, where *n* is the integer nearest the exact value of " "``x / y`` (if the result is 0 then its sign will be the sign of *x*)." msgstr "" -#: library/decimal.rst:1438 +#: library/decimal.rst:1480 msgid "Returns a rotated copy of *x*, *y* times." msgstr "" -#: library/decimal.rst:1443 +#: library/decimal.rst:1485 msgid "Returns ``True`` if the two operands have the same exponent." msgstr "" -#: library/decimal.rst:1448 +#: library/decimal.rst:1490 msgid "Returns the first operand after adding the second value its exp." msgstr "" -#: library/decimal.rst:1453 +#: library/decimal.rst:1495 msgid "Returns a shifted copy of *x*, *y* times." msgstr "" -#: library/decimal.rst:1458 +#: library/decimal.rst:1500 msgid "Square root of a non-negative number to context precision." msgstr "" -#: library/decimal.rst:1463 +#: library/decimal.rst:1505 msgid "Return the difference between *x* and *y*." msgstr "" -#: library/decimal.rst:1477 +#: library/decimal.rst:1519 msgid "Rounds to an integer." msgstr "" -#: library/decimal.rst:1482 +#: library/decimal.rst:1524 msgid "Converts a number to a string using scientific notation." msgstr "" -#: library/decimal.rst:1489 +#: library/decimal.rst:1531 msgid "Constants" msgstr "" -#: library/decimal.rst:1491 +#: library/decimal.rst:1533 msgid "" "The constants in this section are only relevant for the C module. They are " "also included in the pure Python version for compatibility." msgstr "" -#: library/decimal.rst:1495 +#: library/decimal.rst:1537 msgid "32-bit" msgstr "" -#: library/decimal.rst:1495 +#: library/decimal.rst:1537 msgid "64-bit" msgstr "" -#: library/decimal.rst:1499 +#: library/decimal.rst:1541 msgid "``425000000``" msgstr "" -#: library/decimal.rst:1499 +#: library/decimal.rst:1541 msgid "``999999999999999999``" msgstr "" -#: library/decimal.rst:1501 +#: library/decimal.rst:1543 msgid "``-425000000``" msgstr "" -#: library/decimal.rst:1501 +#: library/decimal.rst:1543 msgid "``-999999999999999999``" msgstr "" -#: library/decimal.rst:1503 +#: library/decimal.rst:1545 msgid "``-849999999``" msgstr "" -#: library/decimal.rst:1503 +#: library/decimal.rst:1545 msgid "``-1999999999999999997``" msgstr "" -#: library/decimal.rst:1509 +#: library/decimal.rst:1551 msgid "" "The value is ``True``. Deprecated, because Python now always has threads." msgstr "" -#: library/decimal.rst:1515 +#: library/decimal.rst:1557 msgid "" "The default value is ``True``. If Python is :option:`configured using the --" "without-decimal-contextvar option <--without-decimal-contextvar>`, the C " @@ -1530,55 +1574,55 @@ msgid "" "scenarios." msgstr "" -#: library/decimal.rst:1524 +#: library/decimal.rst:1566 msgid "Rounding modes" msgstr "" -#: library/decimal.rst:1528 +#: library/decimal.rst:1570 msgid "Round towards ``Infinity``." msgstr "" -#: library/decimal.rst:1532 +#: library/decimal.rst:1574 msgid "Round towards zero." msgstr "" -#: library/decimal.rst:1536 +#: library/decimal.rst:1578 msgid "Round towards ``-Infinity``." msgstr "" -#: library/decimal.rst:1540 +#: library/decimal.rst:1582 msgid "Round to nearest with ties going towards zero." msgstr "" -#: library/decimal.rst:1544 +#: library/decimal.rst:1586 msgid "Round to nearest with ties going to nearest even integer." msgstr "" -#: library/decimal.rst:1548 +#: library/decimal.rst:1590 msgid "Round to nearest with ties going away from zero." msgstr "" -#: library/decimal.rst:1552 +#: library/decimal.rst:1594 msgid "Round away from zero." msgstr "" -#: library/decimal.rst:1556 +#: library/decimal.rst:1598 msgid "" "Round away from zero if last digit after rounding towards zero would have " "been 0 or 5; otherwise round towards zero." msgstr "" -#: library/decimal.rst:1563 +#: library/decimal.rst:1605 msgid "Signals" msgstr "" -#: library/decimal.rst:1565 +#: library/decimal.rst:1607 msgid "" "Signals represent conditions that arise during computation. Each corresponds " "to one context flag and one context trap enabler." msgstr "" -#: library/decimal.rst:1568 +#: library/decimal.rst:1610 msgid "" "The context flag is set whenever the condition is encountered. After the " "computation, flags may be checked for informational purposes (for instance, " @@ -1586,7 +1630,7 @@ msgid "" "sure to clear all flags before starting the next computation." msgstr "" -#: library/decimal.rst:1573 +#: library/decimal.rst:1615 msgid "" "If the context's trap enabler is set for the signal, then the condition " "causes a Python exception to be raised. For example, if the :class:" @@ -1594,58 +1638,58 @@ msgid "" "raised upon encountering the condition." msgstr "" -#: library/decimal.rst:1581 +#: library/decimal.rst:1623 msgid "Altered an exponent to fit representation constraints." msgstr "" -#: library/decimal.rst:1583 +#: library/decimal.rst:1625 msgid "" "Typically, clamping occurs when an exponent falls outside the context's :" "attr:`~Context.Emin` and :attr:`~Context.Emax` limits. If possible, the " "exponent is reduced to fit by adding zeros to the coefficient." msgstr "" -#: library/decimal.rst:1590 +#: library/decimal.rst:1632 msgid "Base class for other signals and a subclass of :exc:`ArithmeticError`." msgstr "" -#: library/decimal.rst:1595 +#: library/decimal.rst:1637 msgid "Signals the division of a non-infinite number by zero." msgstr "" -#: library/decimal.rst:1597 +#: library/decimal.rst:1639 msgid "" "Can occur with division, modulo division, or when raising a number to a " "negative power. If this signal is not trapped, returns ``Infinity`` or ``-" "Infinity`` with the sign determined by the inputs to the calculation." msgstr "" -#: library/decimal.rst:1604 +#: library/decimal.rst:1646 msgid "Indicates that rounding occurred and the result is not exact." msgstr "" -#: library/decimal.rst:1606 +#: library/decimal.rst:1648 msgid "" "Signals when non-zero digits were discarded during rounding. The rounded " "result is returned. The signal flag or trap is used to detect when results " "are inexact." msgstr "" -#: library/decimal.rst:1613 +#: library/decimal.rst:1655 msgid "An invalid operation was performed." msgstr "" -#: library/decimal.rst:1615 +#: library/decimal.rst:1657 msgid "" "Indicates that an operation was requested that does not make sense. If not " "trapped, returns ``NaN``. Possible causes include::" msgstr "" -#: library/decimal.rst:1631 +#: library/decimal.rst:1673 msgid "Numerical overflow." msgstr "" -#: library/decimal.rst:1633 +#: library/decimal.rst:1675 msgid "" "Indicates the exponent is larger than :attr:`Context.Emax` after rounding " "has occurred. If not trapped, the result depends on the rounding mode, " @@ -1654,42 +1698,42 @@ msgid "" "`Rounded` are also signaled." msgstr "" -#: library/decimal.rst:1642 +#: library/decimal.rst:1684 msgid "Rounding occurred though possibly no information was lost." msgstr "" -#: library/decimal.rst:1644 +#: library/decimal.rst:1686 msgid "" "Signaled whenever rounding discards digits; even if those digits are zero " "(such as rounding ``5.00`` to ``5.0``). If not trapped, returns the result " "unchanged. This signal is used to detect loss of significant digits." msgstr "" -#: library/decimal.rst:1652 +#: library/decimal.rst:1694 msgid "Exponent was lower than :attr:`~Context.Emin` prior to rounding." msgstr "" -#: library/decimal.rst:1654 +#: library/decimal.rst:1696 msgid "" "Occurs when an operation result is subnormal (the exponent is too small). If " "not trapped, returns the result unchanged." msgstr "" -#: library/decimal.rst:1660 +#: library/decimal.rst:1702 msgid "Numerical underflow with result rounded to zero." msgstr "" -#: library/decimal.rst:1662 +#: library/decimal.rst:1704 msgid "" "Occurs when a subnormal result is pushed to zero by rounding. :class:" "`Inexact` and :class:`Subnormal` are also signaled." msgstr "" -#: library/decimal.rst:1668 +#: library/decimal.rst:1710 msgid "Enable stricter semantics for mixing floats and Decimals." msgstr "" -#: library/decimal.rst:1670 +#: library/decimal.rst:1712 msgid "" "If the signal is not trapped (default), mixing floats and Decimals is " "permitted in the :class:`~decimal.Decimal` constructor, :meth:`~decimal." @@ -1700,26 +1744,26 @@ msgid "" "Context.create_decimal_from_float` do not set the flag." msgstr "" -#: library/decimal.rst:1678 +#: library/decimal.rst:1720 msgid "" "Otherwise (the signal is trapped), only equality comparisons and explicit " "conversions are silent. All other mixed operations raise :exc:" "`FloatOperation`." msgstr "" -#: library/decimal.rst:1682 +#: library/decimal.rst:1724 msgid "The following table summarizes the hierarchy of signals::" msgstr "" -#: library/decimal.rst:1703 -msgid "Floating Point Notes" +#: library/decimal.rst:1745 +msgid "Floating-Point Notes" msgstr "" -#: library/decimal.rst:1707 +#: library/decimal.rst:1749 msgid "Mitigating round-off error with increased precision" msgstr "" -#: library/decimal.rst:1709 +#: library/decimal.rst:1751 msgid "" "The use of decimal floating point eliminates decimal representation error " "(making it possible to represent ``0.1`` exactly); however, some operations " @@ -1727,33 +1771,33 @@ msgid "" "precision." msgstr "" -#: library/decimal.rst:1713 +#: library/decimal.rst:1755 msgid "" "The effects of round-off error can be amplified by the addition or " "subtraction of nearly offsetting quantities resulting in loss of " "significance. Knuth provides two instructive examples where rounded " -"floating point arithmetic with insufficient precision causes the breakdown " +"floating-point arithmetic with insufficient precision causes the breakdown " "of the associative and distributive properties of addition:" msgstr "" -#: library/decimal.rst:1737 +#: library/decimal.rst:1779 msgid "" "The :mod:`decimal` module makes it possible to restore the identities by " "expanding the precision sufficiently to avoid loss of significance:" msgstr "" -#: library/decimal.rst:1757 +#: library/decimal.rst:1799 msgid "Special values" msgstr "" -#: library/decimal.rst:1759 +#: library/decimal.rst:1801 msgid "" "The number system for the :mod:`decimal` module provides special values " "including ``NaN``, ``sNaN``, ``-Infinity``, ``Infinity``, and two zeros, " "``+0`` and ``-0``." msgstr "" -#: library/decimal.rst:1763 +#: library/decimal.rst:1805 msgid "" "Infinities can be constructed directly with: ``Decimal('Infinity')``. Also, " "they can arise from dividing by zero when the :exc:`DivisionByZero` signal " @@ -1762,14 +1806,14 @@ msgid "" "representable number." msgstr "" -#: library/decimal.rst:1768 +#: library/decimal.rst:1810 msgid "" "The infinities are signed (affine) and can be used in arithmetic operations " "where they get treated as very large, indeterminate numbers. For instance, " "adding a constant to infinity gives another infinite result." msgstr "" -#: library/decimal.rst:1772 +#: library/decimal.rst:1814 msgid "" "Some operations are indeterminate and return ``NaN``, or if the :exc:" "`InvalidOperation` signal is trapped, raise an exception. For example, " @@ -1780,14 +1824,14 @@ msgid "" "the calculation to proceed while flagging specific results as invalid." msgstr "" -#: library/decimal.rst:1780 +#: library/decimal.rst:1822 msgid "" "A variant is ``sNaN`` which signals rather than remaining quiet after every " "operation. This is a useful return value when an invalid result needs to " "interrupt a calculation for special handling." msgstr "" -#: library/decimal.rst:1784 +#: library/decimal.rst:1826 msgid "" "The behavior of Python's comparison operators can be a little surprising " "where a ``NaN`` is involved. A test for equality where one of the operands " @@ -1804,7 +1848,7 @@ msgid "" "compare_signal` methods instead." msgstr "" -#: library/decimal.rst:1797 +#: library/decimal.rst:1839 msgid "" "The signed zeros can result from calculations that underflow. They keep the " "sign that would have resulted if the calculation had been carried out to " @@ -1812,20 +1856,20 @@ msgid "" "negative zeros are treated as equal and their sign is informational." msgstr "" -#: library/decimal.rst:1802 +#: library/decimal.rst:1844 msgid "" "In addition to the two signed zeros which are distinct yet equal, there are " "various representations of zero with differing precisions yet equivalent in " "value. This takes a bit of getting used to. For an eye accustomed to " -"normalized floating point representations, it is not immediately obvious " +"normalized floating-point representations, it is not immediately obvious " "that the following calculation returns a value equal to zero:" msgstr "" -#: library/decimal.rst:1817 +#: library/decimal.rst:1859 msgid "Working with threads" msgstr "" -#: library/decimal.rst:1819 +#: library/decimal.rst:1861 msgid "" "The :func:`getcontext` function accesses a different :class:`Context` object " "for each thread. Having separate thread contexts means that threads may " @@ -1833,20 +1877,20 @@ msgid "" "other threads." msgstr "" -#: library/decimal.rst:1823 +#: library/decimal.rst:1865 msgid "" "Likewise, the :func:`setcontext` function automatically assigns its target " "to the current thread." msgstr "" -#: library/decimal.rst:1826 +#: library/decimal.rst:1868 msgid "" "If :func:`setcontext` has not been called before :func:`getcontext`, then :" "func:`getcontext` will automatically create a new context for use in the " "current thread." msgstr "" -#: library/decimal.rst:1830 +#: library/decimal.rst:1872 msgid "" "The new context is copied from a prototype context called *DefaultContext*. " "To control the defaults so that each thread will use the same values " @@ -1855,51 +1899,51 @@ msgid "" "a race condition between threads calling :func:`getcontext`. For example::" msgstr "" -#: library/decimal.rst:1855 +#: library/decimal.rst:1897 msgid "Recipes" msgstr "" -#: library/decimal.rst:1857 +#: library/decimal.rst:1899 msgid "" "Here are a few recipes that serve as utility functions and that demonstrate " "ways to work with the :class:`Decimal` class::" msgstr "" -#: library/decimal.rst:2012 +#: library/decimal.rst:2054 msgid "Decimal FAQ" msgstr "" -#: library/decimal.rst:2014 +#: library/decimal.rst:2056 msgid "" "Q. It is cumbersome to type ``decimal.Decimal('1234.5')``. Is there a way " "to minimize typing when using the interactive interpreter?" msgstr "" -#: library/decimal.rst:2017 +#: library/decimal.rst:2059 msgid "A. Some users abbreviate the constructor to just a single letter:" msgstr "" -#: library/decimal.rst:2023 +#: library/decimal.rst:2065 msgid "" "Q. In a fixed-point application with two decimal places, some inputs have " "many places and need to be rounded. Others are not supposed to have excess " "digits and need to be validated. What methods should be used?" msgstr "" -#: library/decimal.rst:2027 +#: library/decimal.rst:2069 msgid "" "A. The :meth:`~Decimal.quantize` method rounds to a fixed number of decimal " "places. If the :const:`Inexact` trap is set, it is also useful for " "validation:" msgstr "" -#: library/decimal.rst:2045 +#: library/decimal.rst:2087 msgid "" "Q. Once I have valid two place inputs, how do I maintain that invariant " "throughout an application?" msgstr "" -#: library/decimal.rst:2048 +#: library/decimal.rst:2090 msgid "" "A. Some operations like addition, subtraction, and multiplication by an " "integer will automatically preserve fixed point. Others operations, like " @@ -1907,13 +1951,13 @@ msgid "" "places and need to be followed-up with a :meth:`~Decimal.quantize` step:" msgstr "" -#: library/decimal.rst:2066 +#: library/decimal.rst:2108 msgid "" "In developing fixed-point applications, it is convenient to define functions " "to handle the :meth:`~Decimal.quantize` step:" msgstr "" -#: library/decimal.rst:2080 +#: library/decimal.rst:2122 msgid "" "Q. There are many ways to express the same value. The numbers ``200``, " "``200.000``, ``2E2``, and ``.02E+4`` all have the same value at various " @@ -1921,17 +1965,17 @@ msgid "" "canonical value?" msgstr "" -#: library/decimal.rst:2085 +#: library/decimal.rst:2127 msgid "" "A. The :meth:`~Decimal.normalize` method maps all equivalent values to a " "single representative:" msgstr "" -#: library/decimal.rst:2092 +#: library/decimal.rst:2134 msgid "Q. When does rounding occur in a computation?" msgstr "" -#: library/decimal.rst:2094 +#: library/decimal.rst:2136 msgid "" "A. It occurs *after* the computation. The philosophy of the decimal " "specification is that numbers are considered exact and are created " @@ -1941,13 +1985,13 @@ msgid "" "computation::" msgstr "" -#: library/decimal.rst:2112 +#: library/decimal.rst:2154 msgid "" "Q. Some decimal values always print with exponential notation. Is there a " "way to get a non-exponential representation?" msgstr "" -#: library/decimal.rst:2115 +#: library/decimal.rst:2157 msgid "" "A. For some values, exponential notation is the only way to express the " "number of significant places in the coefficient. For example, expressing " @@ -1955,31 +1999,31 @@ msgid "" "original's two-place significance." msgstr "" -#: library/decimal.rst:2120 +#: library/decimal.rst:2162 msgid "" "If an application does not care about tracking significance, it is easy to " "remove the exponent and trailing zeroes, losing significance, but keeping " "the value unchanged:" msgstr "" -#: library/decimal.rst:2130 +#: library/decimal.rst:2172 msgid "Q. Is there a way to convert a regular float to a :class:`Decimal`?" msgstr "" -#: library/decimal.rst:2132 +#: library/decimal.rst:2174 msgid "" -"A. Yes, any binary floating point number can be exactly expressed as a " +"A. Yes, any binary floating-point number can be exactly expressed as a " "Decimal though an exact conversion may take more precision than intuition " "would suggest:" msgstr "" -#: library/decimal.rst:2141 +#: library/decimal.rst:2183 msgid "" "Q. Within a complex calculation, how can I make sure that I haven't gotten a " "spurious result because of insufficient precision or rounding anomalies." msgstr "" -#: library/decimal.rst:2144 +#: library/decimal.rst:2186 msgid "" "A. The decimal module makes it easy to test results. A best practice is to " "re-run calculations using greater precision and with various rounding modes. " @@ -1987,14 +2031,14 @@ msgid "" "issues, ill-conditioned inputs, or a numerically unstable algorithm." msgstr "" -#: library/decimal.rst:2149 +#: library/decimal.rst:2191 msgid "" "Q. I noticed that context precision is applied to the results of operations " "but not to the inputs. Is there anything to watch out for when mixing " "values of different precisions?" msgstr "" -#: library/decimal.rst:2153 +#: library/decimal.rst:2195 msgid "" "A. Yes. The principle is that all values are considered to be exact and so " "is the arithmetic on those values. Only the results are rounded. The " @@ -2003,28 +2047,28 @@ msgid "" "haven't been rounded:" msgstr "" -#: library/decimal.rst:2166 +#: library/decimal.rst:2208 msgid "" "The solution is either to increase precision or to force rounding of inputs " "using the unary plus operation:" msgstr "" -#: library/decimal.rst:2175 +#: library/decimal.rst:2217 msgid "" "Alternatively, inputs can be rounded upon creation using the :meth:`Context." "create_decimal` method:" msgstr "" -#: library/decimal.rst:2181 +#: library/decimal.rst:2223 msgid "Q. Is the CPython implementation fast for large numbers?" msgstr "" -#: library/decimal.rst:2183 +#: library/decimal.rst:2225 msgid "" "A. Yes. In the CPython and PyPy3 implementations, the C/CFFI versions of " "the decimal module integrate the high speed `libmpdec `_ library for arbitrary precision " -"correctly rounded decimal floating point arithmetic [#]_. ``libmpdec`` uses " +"correctly rounded decimal floating-point arithmetic [#]_. ``libmpdec`` uses " "`Karatsuba multiplication `_ for medium-sized numbers and the `Number Theoretic " "Transform \n" @@ -1569,7 +1569,7 @@ msgid "``INTRINSIC_ASYNC_GEN_WRAP``" msgstr "" #: library/dis.rst:1595 -msgid "Wraps an aync generator value" +msgid "Wraps an async generator value" msgstr "" #: library/dis.rst:1597 diff --git a/library/email.compat32-message.po b/library/email.compat32-message.po index 71ba38499..8b5073ad1 100644 --- a/library/email.compat32-message.po +++ b/library/email.compat32-message.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -22,7 +22,7 @@ msgid "" "`~email.policy.compat32` API" msgstr "" -#: library/email.compat32-message.rst:12 +#: library/email.compat32-message.rst:13 msgid "" "The :class:`Message` class is very similar to the :class:`~email.message." "EmailMessage` class, without the methods added by that class, and with the " @@ -32,11 +32,11 @@ msgid "" "legacy code." msgstr "" -#: library/email.compat32-message.rst:19 +#: library/email.compat32-message.rst:20 msgid "The philosophy and structure of the two classes is otherwise the same." msgstr "" -#: library/email.compat32-message.rst:21 +#: library/email.compat32-message.rst:22 msgid "" "This document describes the behavior under the default (for :class:" "`Message`) policy :attr:`~email.policy.Compat32`. If you are going to use " @@ -44,7 +44,7 @@ msgid "" "class instead." msgstr "" -#: library/email.compat32-message.rst:25 +#: library/email.compat32-message.rst:26 msgid "" "An email message consists of *headers* and a *payload*. Headers must be :" "rfc:`5322` style names and values, where the field name and value are " @@ -56,7 +56,7 @@ msgid "" "`message/rfc822`." msgstr "" -#: library/email.compat32-message.rst:34 +#: library/email.compat32-message.rst:35 msgid "" "The conceptual model provided by a :class:`Message` object is that of an " "ordered dictionary of headers with additional methods for accessing both " @@ -66,7 +66,7 @@ msgid "" "methods must be used to access them." msgstr "" -#: library/email.compat32-message.rst:41 +#: library/email.compat32-message.rst:42 msgid "" "The :class:`Message` pseudo-dictionary is indexed by the header names, which " "must be ASCII values. The values of the dictionary are strings that are " @@ -80,11 +80,11 @@ msgid "" "mimetype:`multipart/\\*` and :mimetype:`message/rfc822`)." msgstr "" -#: library/email.compat32-message.rst:52 +#: library/email.compat32-message.rst:53 msgid "Here are the methods of the :class:`Message` class:" msgstr "" -#: library/email.compat32-message.rst:57 +#: library/email.compat32-message.rst:58 msgid "" "If *policy* is specified (it must be an instance of a :mod:`~email.policy` " "class) use the rules it specifies to update and serialize the representation " @@ -94,11 +94,11 @@ msgid "" "`~email.policy` documentation." msgstr "" -#: library/email.compat32-message.rst:64 +#: library/email.compat32-message.rst:65 msgid "The *policy* keyword argument was added." msgstr "" -#: library/email.compat32-message.rst:69 +#: library/email.compat32-message.rst:70 msgid "" "Return the entire message flattened as a string. When optional *unixfrom* " "is true, the envelope header is included in the returned string. *unixfrom* " @@ -111,14 +111,14 @@ msgid "" "*policy* will be passed to the ``Generator``." msgstr "" -#: library/email.compat32-message.rst:79 library/email.compat32-message.rst:121 +#: library/email.compat32-message.rst:80 library/email.compat32-message.rst:122 msgid "" "Flattening the message may trigger changes to the :class:`Message` if " "defaults need to be filled in to complete the transformation to a string " "(for example, MIME boundaries may be generated or modified)." msgstr "" -#: library/email.compat32-message.rst:83 +#: library/email.compat32-message.rst:84 msgid "" "Note that this method is provided as a convenience and may not always format " "the message the way you want. For example, by default it does not do the " @@ -128,7 +128,7 @@ msgid "" "method directly. For example::" msgstr "" -#: library/email.compat32-message.rst:97 +#: library/email.compat32-message.rst:98 msgid "" "If the message object contains binary data that is not encoded according to " "RFC standards, the non-compliant data will be replaced by unicode \"unknown " @@ -136,17 +136,17 @@ msgid "" "generator.BytesGenerator`.)" msgstr "" -#: library/email.compat32-message.rst:102 +#: library/email.compat32-message.rst:103 msgid "the *policy* keyword argument was added." msgstr "" -#: library/email.compat32-message.rst:107 +#: library/email.compat32-message.rst:108 msgid "" "Equivalent to :meth:`.as_string()`. Allows ``str(msg)`` to produce a string " "containing the formatted message." msgstr "" -#: library/email.compat32-message.rst:113 +#: library/email.compat32-message.rst:114 msgid "" "Return the entire message flattened as a bytes object. When optional " "*unixfrom* is true, the envelope header is included in the returned string. " @@ -156,7 +156,7 @@ msgid "" "specified *policy* will be passed to the ``BytesGenerator``." msgstr "" -#: library/email.compat32-message.rst:125 +#: library/email.compat32-message.rst:126 msgid "" "Note that this method is provided as a convenience and may not always format " "the message the way you want. For example, by default it does not do the " @@ -166,13 +166,13 @@ msgid "" "flatten` method directly. For example::" msgstr "" -#: library/email.compat32-message.rst:145 +#: library/email.compat32-message.rst:146 msgid "" "Equivalent to :meth:`.as_bytes()`. Allows ``bytes(msg)`` to produce a bytes " "object containing the formatted message." msgstr "" -#: library/email.compat32-message.rst:153 +#: library/email.compat32-message.rst:154 msgid "" "Return ``True`` if the message's payload is a list of sub-\\ :class:" "`Message` objects, otherwise return ``False``. When :meth:`is_multipart` " @@ -183,18 +183,18 @@ msgid "" "return ``True`` when the :class:`Message` is of type ``message/rfc822``.)" msgstr "" -#: library/email.compat32-message.rst:165 +#: library/email.compat32-message.rst:166 msgid "" "Set the message's envelope header to *unixfrom*, which should be a string." msgstr "" -#: library/email.compat32-message.rst:170 +#: library/email.compat32-message.rst:171 msgid "" "Return the message's envelope header. Defaults to ``None`` if the envelope " "header was never set." msgstr "" -#: library/email.compat32-message.rst:176 +#: library/email.compat32-message.rst:177 msgid "" "Add the given *payload* to the current payload, which must be ``None`` or a " "list of :class:`Message` objects before the call. After the call, the " @@ -203,14 +203,14 @@ msgid "" "instead." msgstr "" -#: library/email.compat32-message.rst:182 +#: library/email.compat32-message.rst:183 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class its functionality is replaced by :meth:`~email.message.EmailMessage." "set_content` and the related ``make`` and ``add`` methods." msgstr "" -#: library/email.compat32-message.rst:190 +#: library/email.compat32-message.rst:191 msgid "" "Return the current payload, which will be a list of :class:`Message` objects " "when :meth:`is_multipart` is ``True``, or a string when :meth:`is_multipart` " @@ -218,7 +218,7 @@ msgid "" "modify the message's payload in place." msgstr "" -#: library/email.compat32-message.rst:195 +#: library/email.compat32-message.rst:196 msgid "" "With optional argument *i*, :meth:`get_payload` will return the *i*-th " "element of the payload, counting from zero, if :meth:`is_multipart` is " @@ -228,7 +228,7 @@ msgid "" "exc:`TypeError` is raised." msgstr "" -#: library/email.compat32-message.rst:202 +#: library/email.compat32-message.rst:203 msgid "" "Optional *decode* is a flag indicating whether the payload should be decoded " "or not, according to the :mailheader:`Content-Transfer-Encoding` header. " @@ -244,7 +244,7 @@ msgid "" "or :class:`~email.errors.InvalidBase64CharactersDefect`, respectively)." msgstr "" -#: library/email.compat32-message.rst:216 +#: library/email.compat32-message.rst:217 msgid "" "When *decode* is ``False`` (the default) the body is returned as a string " "without decoding the :mailheader:`Content-Transfer-Encoding`. However, for " @@ -255,28 +255,28 @@ msgid "" "the email package, the body is decoded using the default ASCII charset." msgstr "" -#: library/email.compat32-message.rst:225 +#: library/email.compat32-message.rst:226 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class its functionality is replaced by :meth:`~email.message.EmailMessage." "get_content` and :meth:`~email.message.EmailMessage.iter_parts`." msgstr "" -#: library/email.compat32-message.rst:233 +#: library/email.compat32-message.rst:234 msgid "" "Set the entire message object's payload to *payload*. It is the client's " "responsibility to ensure the payload invariants. Optional *charset* sets " "the message's default character set; see :meth:`set_charset` for details." msgstr "" -#: library/email.compat32-message.rst:237 +#: library/email.compat32-message.rst:238 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class its functionality is replaced by :meth:`~email.message.EmailMessage." "set_content`." msgstr "" -#: library/email.compat32-message.rst:244 +#: library/email.compat32-message.rst:245 msgid "" "Set the character set of the payload to *charset*, which can either be a :" "class:`~email.charset.Charset` instance (see :mod:`email.charset`), a string " @@ -287,7 +287,7 @@ msgid "" "Anything else will generate a :exc:`TypeError`." msgstr "" -#: library/email.compat32-message.rst:252 +#: library/email.compat32-message.rst:253 msgid "" "If there is no existing :mailheader:`MIME-Version` header one will be " "added. If there is no existing :mailheader:`Content-Type` header, one will " @@ -304,26 +304,26 @@ msgid "" "not modified." msgstr "" -#: library/email.compat32-message.rst:266 +#: library/email.compat32-message.rst:267 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class its functionality is replaced by the *charset* parameter of the :meth:" "`email.emailmessage.EmailMessage.set_content` method." msgstr "" -#: library/email.compat32-message.rst:274 +#: library/email.compat32-message.rst:275 msgid "" "Return the :class:`~email.charset.Charset` instance associated with the " "message's payload." msgstr "" -#: library/email.compat32-message.rst:277 +#: library/email.compat32-message.rst:278 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class it always returns ``None``." msgstr "" -#: library/email.compat32-message.rst:282 +#: library/email.compat32-message.rst:283 msgid "" "The following methods implement a mapping-like interface for accessing the " "message's :rfc:`2822` headers. Note that there are some semantic " @@ -336,19 +336,19 @@ msgid "" "deleted and then re-added are always appended to the end of the header list." msgstr "" -#: library/email.compat32-message.rst:292 +#: library/email.compat32-message.rst:293 msgid "" "These semantic differences are intentional and are biased toward maximal " "convenience." msgstr "" -#: library/email.compat32-message.rst:295 +#: library/email.compat32-message.rst:296 msgid "" "Note that in all cases, any envelope header present in the message is not " "included in the mapping interface." msgstr "" -#: library/email.compat32-message.rst:298 +#: library/email.compat32-message.rst:299 msgid "" "In a model generated from bytes, any header values that (in contravention of " "the RFCs) contain non-ASCII bytes will, when retrieved through this " @@ -356,25 +356,25 @@ msgid "" "charset of ``unknown-8bit``." msgstr "" -#: library/email.compat32-message.rst:306 +#: library/email.compat32-message.rst:307 msgid "Return the total number of headers, including duplicates." msgstr "" -#: library/email.compat32-message.rst:311 +#: library/email.compat32-message.rst:312 msgid "" "Return ``True`` if the message object has a field named *name*. Matching is " "done case-insensitively and *name* should not include the trailing colon. " "Used for the ``in`` operator, e.g.::" msgstr "" -#: library/email.compat32-message.rst:321 +#: library/email.compat32-message.rst:322 msgid "" "Return the value of the named header field. *name* should not include the " "colon field separator. If the header is missing, ``None`` is returned; a :" "exc:`KeyError` is never raised." msgstr "" -#: library/email.compat32-message.rst:325 +#: library/email.compat32-message.rst:326 msgid "" "Note that if the named field appears more than once in the message's " "headers, exactly which of those field values will be returned is undefined. " @@ -382,59 +382,59 @@ msgid "" "headers." msgstr "" -#: library/email.compat32-message.rst:333 +#: library/email.compat32-message.rst:334 msgid "" "Add a header to the message with field name *name* and value *val*. The " "field is appended to the end of the message's existing fields." msgstr "" -#: library/email.compat32-message.rst:336 +#: library/email.compat32-message.rst:337 msgid "" "Note that this does *not* overwrite or delete any existing header with the " "same name. If you want to ensure that the new header is the only one " "present in the message with field name *name*, delete the field first, e.g.::" msgstr "" -#: library/email.compat32-message.rst:346 +#: library/email.compat32-message.rst:347 msgid "" "Delete all occurrences of the field with name *name* from the message's " "headers. No exception is raised if the named field isn't present in the " "headers." msgstr "" -#: library/email.compat32-message.rst:353 +#: library/email.compat32-message.rst:354 msgid "Return a list of all the message's header field names." msgstr "" -#: library/email.compat32-message.rst:358 +#: library/email.compat32-message.rst:359 msgid "Return a list of all the message's field values." msgstr "" -#: library/email.compat32-message.rst:363 +#: library/email.compat32-message.rst:364 msgid "" "Return a list of 2-tuples containing all the message's field headers and " "values." msgstr "" -#: library/email.compat32-message.rst:369 +#: library/email.compat32-message.rst:370 msgid "" "Return the value of the named header field. This is identical to :meth:" "`~object.__getitem__` except that optional *failobj* is returned if the " "named header is missing (defaults to ``None``)." msgstr "" -#: library/email.compat32-message.rst:373 +#: library/email.compat32-message.rst:374 msgid "Here are some additional useful methods:" msgstr "" -#: library/email.compat32-message.rst:378 +#: library/email.compat32-message.rst:379 msgid "" "Return a list of all the values for the field named *name*. If there are no " "such named headers in the message, *failobj* is returned (defaults to " "``None``)." msgstr "" -#: library/email.compat32-message.rst:385 +#: library/email.compat32-message.rst:386 msgid "" "Extended header setting. This method is similar to :meth:`__setitem__` " "except that additional header parameters can be provided as keyword " @@ -442,7 +442,7 @@ msgid "" "value for the header." msgstr "" -#: library/email.compat32-message.rst:390 +#: library/email.compat32-message.rst:391 msgid "" "For each item in the keyword argument dictionary *_params*, the key is taken " "as the parameter name, with underscores converted to dashes (since dashes " @@ -459,30 +459,30 @@ msgid "" "``None``." msgstr "" -#: library/email.compat32-message.rst:404 +#: library/email.compat32-message.rst:405 msgid "Here's an example::" msgstr "" -#: library/email.compat32-message.rst:408 +#: library/email.compat32-message.rst:409 msgid "This will add a header that looks like ::" msgstr "" -#: library/email.compat32-message.rst:412 +#: library/email.compat32-message.rst:413 msgid "An example with non-ASCII characters::" msgstr "" -#: library/email.compat32-message.rst:417 +#: library/email.compat32-message.rst:418 msgid "Which produces ::" msgstr "" -#: library/email.compat32-message.rst:424 +#: library/email.compat32-message.rst:425 msgid "" "Replace a header. Replace the first header found in the message that " "matches *_name*, retaining header order and field name case. If no matching " "header was found, a :exc:`KeyError` is raised." msgstr "" -#: library/email.compat32-message.rst:431 +#: library/email.compat32-message.rst:432 msgid "" "Return the message's content type. The returned string is coerced to lower " "case of the form :mimetype:`maintype/subtype`. If there was no :mailheader:" @@ -492,7 +492,7 @@ msgid "" "return a value." msgstr "" -#: library/email.compat32-message.rst:438 +#: library/email.compat32-message.rst:439 msgid "" ":rfc:`2045` defines a message's default type to be :mimetype:`text/plain` " "unless it appears inside a :mimetype:`multipart/digest` container, in which " @@ -501,19 +501,19 @@ msgid "" "the default type be :mimetype:`text/plain`." msgstr "" -#: library/email.compat32-message.rst:447 +#: library/email.compat32-message.rst:448 msgid "" "Return the message's main content type. This is the :mimetype:`maintype` " "part of the string returned by :meth:`get_content_type`." msgstr "" -#: library/email.compat32-message.rst:453 +#: library/email.compat32-message.rst:454 msgid "" "Return the message's sub-content type. This is the :mimetype:`subtype` part " "of the string returned by :meth:`get_content_type`." msgstr "" -#: library/email.compat32-message.rst:459 +#: library/email.compat32-message.rst:460 msgid "" "Return the default content type. Most messages have a default content type " "of :mimetype:`text/plain`, except for messages that are subparts of :" @@ -521,14 +521,14 @@ msgid "" "content type of :mimetype:`message/rfc822`." msgstr "" -#: library/email.compat32-message.rst:467 +#: library/email.compat32-message.rst:468 msgid "" "Set the default content type. *ctype* should either be :mimetype:`text/" "plain` or :mimetype:`message/rfc822`, although this is not enforced. The " "default content type is not stored in the :mailheader:`Content-Type` header." msgstr "" -#: library/email.compat32-message.rst:475 +#: library/email.compat32-message.rst:476 msgid "" "Return the message's :mailheader:`Content-Type` parameters, as a list. The " "elements of the returned list are 2-tuples of key/value pairs, as split on " @@ -538,22 +538,22 @@ msgid "" "`get_param` and is unquoted if optional *unquote* is ``True`` (the default)." msgstr "" -#: library/email.compat32-message.rst:483 +#: library/email.compat32-message.rst:484 msgid "" "Optional *failobj* is the object to return if there is no :mailheader:" "`Content-Type` header. Optional *header* is the header to search instead " "of :mailheader:`Content-Type`." msgstr "" -#: library/email.compat32-message.rst:487 -#: library/email.compat32-message.rst:525 +#: library/email.compat32-message.rst:488 +#: library/email.compat32-message.rst:526 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class its functionality is replaced by the *params* property of the " "individual header objects returned by the header access methods." msgstr "" -#: library/email.compat32-message.rst:495 +#: library/email.compat32-message.rst:496 msgid "" "Return the value of the :mailheader:`Content-Type` header's parameter " "*param* as a string. If the message has no :mailheader:`Content-Type` " @@ -561,13 +561,13 @@ msgid "" "(defaults to ``None``)." msgstr "" -#: library/email.compat32-message.rst:500 +#: library/email.compat32-message.rst:501 msgid "" "Optional *header* if given, specifies the message header to use instead of :" "mailheader:`Content-Type`." msgstr "" -#: library/email.compat32-message.rst:503 +#: library/email.compat32-message.rst:504 msgid "" "Parameter keys are always compared case insensitively. The return value can " "either be a string, or a 3-tuple if the parameter was :rfc:`2231` encoded. " @@ -577,7 +577,7 @@ msgid "" "``us-ascii`` charset. You can usually ignore ``LANGUAGE``." msgstr "" -#: library/email.compat32-message.rst:511 +#: library/email.compat32-message.rst:512 msgid "" "If your application doesn't care whether the parameter was encoded as in :" "rfc:`2231`, you can collapse the parameter value by calling :func:`email." @@ -586,14 +586,14 @@ msgid "" "value is a tuple, or the original string unquoted if it isn't. For example::" msgstr "" -#: library/email.compat32-message.rst:521 +#: library/email.compat32-message.rst:522 msgid "" "In any case, the parameter value (either the returned string, or the " "``VALUE`` item in the 3-tuple) is always unquoted, unless *unquote* is set " "to ``False``." msgstr "" -#: library/email.compat32-message.rst:534 +#: library/email.compat32-message.rst:535 msgid "" "Set a parameter in the :mailheader:`Content-Type` header. If the parameter " "already exists in the header, its value will be replaced with *value*. If " @@ -602,14 +602,14 @@ msgid "" "value will be appended as per :rfc:`2045`." msgstr "" -#: library/email.compat32-message.rst:540 +#: library/email.compat32-message.rst:541 msgid "" "Optional *header* specifies an alternative header to :mailheader:`Content-" "Type`, and all parameters will be quoted as necessary unless optional " "*requote* is ``False`` (the default is ``True``)." msgstr "" -#: library/email.compat32-message.rst:544 +#: library/email.compat32-message.rst:545 msgid "" "If optional *charset* is specified, the parameter will be encoded according " "to :rfc:`2231`. Optional *language* specifies the RFC 2231 language, " @@ -617,18 +617,18 @@ msgid "" "strings." msgstr "" -#: library/email.compat32-message.rst:549 +#: library/email.compat32-message.rst:550 msgid "" "If *replace* is ``False`` (the default) the header is moved to the end of " "the list of headers. If *replace* is ``True``, the header will be updated " "in place." msgstr "" -#: library/email.compat32-message.rst:553 +#: library/email.compat32-message.rst:554 msgid "``replace`` keyword was added." msgstr "" -#: library/email.compat32-message.rst:558 +#: library/email.compat32-message.rst:559 msgid "" "Remove the given parameter completely from the :mailheader:`Content-Type` " "header. The header will be re-written in place without the parameter or its " @@ -637,14 +637,14 @@ msgid "" "mailheader:`Content-Type`." msgstr "" -#: library/email.compat32-message.rst:567 +#: library/email.compat32-message.rst:568 msgid "" "Set the main type and subtype for the :mailheader:`Content-Type` header. " "*type* must be a string in the form :mimetype:`maintype/subtype`, otherwise " "a :exc:`ValueError` is raised." msgstr "" -#: library/email.compat32-message.rst:571 +#: library/email.compat32-message.rst:572 msgid "" "This method replaces the :mailheader:`Content-Type` header, keeping all the " "parameters in place. If *requote* is ``False``, this leaves the existing " @@ -652,20 +652,20 @@ msgid "" "default)." msgstr "" -#: library/email.compat32-message.rst:576 +#: library/email.compat32-message.rst:577 msgid "" "An alternative header can be specified in the *header* argument. When the :" "mailheader:`Content-Type` header is set a :mailheader:`MIME-Version` header " "is also added." msgstr "" -#: library/email.compat32-message.rst:580 +#: library/email.compat32-message.rst:581 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class its functionality is replaced by the ``make_`` and ``add_`` methods." msgstr "" -#: library/email.compat32-message.rst:587 +#: library/email.compat32-message.rst:588 msgid "" "Return the value of the ``filename`` parameter of the :mailheader:`Content-" "Disposition` header of the message. If the header does not have a " @@ -675,7 +675,7 @@ msgid "" "always be unquoted as per :func:`email.utils.unquote`." msgstr "" -#: library/email.compat32-message.rst:598 +#: library/email.compat32-message.rst:599 msgid "" "Return the value of the ``boundary`` parameter of the :mailheader:`Content-" "Type` header of the message, or *failobj* if either the header is missing, " @@ -683,7 +683,7 @@ msgid "" "unquoted as per :func:`email.utils.unquote`." msgstr "" -#: library/email.compat32-message.rst:606 +#: library/email.compat32-message.rst:607 msgid "" "Set the ``boundary`` parameter of the :mailheader:`Content-Type` header to " "*boundary*. :meth:`set_boundary` will always quote *boundary* if " @@ -691,7 +691,7 @@ msgid "" "object has no :mailheader:`Content-Type` header." msgstr "" -#: library/email.compat32-message.rst:611 +#: library/email.compat32-message.rst:612 msgid "" "Note that using this method is subtly different than deleting the old :" "mailheader:`Content-Type` header and adding a new one with the new boundary " @@ -701,28 +701,28 @@ msgid "" "the original :mailheader:`Content-Type` header." msgstr "" -#: library/email.compat32-message.rst:621 +#: library/email.compat32-message.rst:622 msgid "" "Return the ``charset`` parameter of the :mailheader:`Content-Type` header, " "coerced to lower case. If there is no :mailheader:`Content-Type` header, or " "if that header has no ``charset`` parameter, *failobj* is returned." msgstr "" -#: library/email.compat32-message.rst:625 +#: library/email.compat32-message.rst:626 msgid "" "Note that this method differs from :meth:`get_charset` which returns the :" "class:`~email.charset.Charset` instance for the default encoding of the " "message body." msgstr "" -#: library/email.compat32-message.rst:631 +#: library/email.compat32-message.rst:632 msgid "" "Return a list containing the character set names in the message. If the " "message is a :mimetype:`multipart`, then the list will contain one element " "for each subpart in the payload, otherwise, it will be a list of length 1." msgstr "" -#: library/email.compat32-message.rst:635 +#: library/email.compat32-message.rst:636 msgid "" "Each item in the list will be a string which is the value of the ``charset`` " "parameter in the :mailheader:`Content-Type` header for the represented " @@ -731,7 +731,7 @@ msgid "" "then that item in the returned list will be *failobj*." msgstr "" -#: library/email.compat32-message.rst:645 +#: library/email.compat32-message.rst:646 msgid "" "Return the lowercased value (without parameters) of the message's :" "mailheader:`Content-Disposition` header if it has one, or ``None``. The " @@ -739,7 +739,7 @@ msgid "" "the message follows :rfc:`2183`." msgstr "" -#: library/email.compat32-message.rst:654 +#: library/email.compat32-message.rst:655 msgid "" "The :meth:`walk` method is an all-purpose generator which can be used to " "iterate over all the parts and subparts of a message object tree, in depth-" @@ -747,13 +747,13 @@ msgid "" "in a ``for`` loop; each iteration returns the next subpart." msgstr "" -#: library/email.compat32-message.rst:659 +#: library/email.compat32-message.rst:660 msgid "" "Here's an example that prints the MIME type of every part of a multipart " "message structure:" msgstr "" -#: library/email.compat32-message.rst:685 +#: library/email.compat32-message.rst:686 msgid "" "``walk`` iterates over the subparts of any part where :meth:`is_multipart` " "returns ``True``, even though ``msg.get_content_maintype() == 'multipart'`` " @@ -761,21 +761,21 @@ msgid "" "``_structure`` debug helper function:" msgstr "" -#: library/email.compat32-message.rst:712 +#: library/email.compat32-message.rst:713 msgid "" "Here the ``message`` parts are not ``multiparts``, but they do contain " "subparts. ``is_multipart()`` returns ``True`` and ``walk`` descends into the " "subparts." msgstr "" -#: library/email.compat32-message.rst:717 +#: library/email.compat32-message.rst:718 msgid "" ":class:`Message` objects can also optionally contain two instance " "attributes, which can be used when generating the plain text of a MIME " "message." msgstr "" -#: library/email.compat32-message.rst:723 +#: library/email.compat32-message.rst:724 msgid "" "The format of a MIME document allows for some text between the blank line " "following the headers, and the first multipart boundary string. Normally, " @@ -785,7 +785,7 @@ msgid "" "can become visible." msgstr "" -#: library/email.compat32-message.rst:730 +#: library/email.compat32-message.rst:731 msgid "" "The *preamble* attribute contains this leading extra-armor text for MIME " "documents. When the :class:`~email.parser.Parser` discovers some text after " @@ -797,26 +797,26 @@ msgid "" "parser` and :mod:`email.generator` for details." msgstr "" -#: library/email.compat32-message.rst:740 +#: library/email.compat32-message.rst:741 msgid "" "Note that if the message object has no preamble, the *preamble* attribute " "will be ``None``." msgstr "" -#: library/email.compat32-message.rst:746 +#: library/email.compat32-message.rst:747 msgid "" "The *epilogue* attribute acts the same way as the *preamble* attribute, " "except that it contains text that appears between the last boundary and the " "end of the message." msgstr "" -#: library/email.compat32-message.rst:750 +#: library/email.compat32-message.rst:751 msgid "" "You do not need to set the epilogue to the empty string in order for the :" "class:`~email.generator.Generator` to print a newline at the end of the file." msgstr "" -#: library/email.compat32-message.rst:757 +#: library/email.compat32-message.rst:758 msgid "" "The *defects* attribute contains a list of all the problems found when " "parsing this message. See :mod:`email.errors` for a detailed description of " diff --git a/library/email.header.po b/library/email.header.po index 71a10272a..ac581dd70 100644 --- a/library/email.header.po +++ b/library/email.header.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -114,7 +114,7 @@ msgid "" "The maximum line length can be specified explicitly via *maxlinelen*. For " "splitting the first line to a shorter value (to account for the field header " "which isn't included in *s*, e.g. :mailheader:`Subject`) pass in the name of " -"the field in *header_name*. The default *maxlinelen* is 76, and the default " +"the field in *header_name*. The default *maxlinelen* is 78, and the default " "value for *header_name* is ``None``, meaning it is not taken into account " "for the first line of a long, split header." msgstr "" diff --git a/library/email.utils.po b/library/email.utils.po index f9dfe0c3e..82fe1b73e 100644 --- a/library/email.utils.po +++ b/library/email.utils.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -40,7 +40,7 @@ msgid "" "ignored." msgstr "" -#: library/email.utils.rst:26 +#: library/email.utils.rst:25 msgid "The *isdst* parameter." msgstr "" @@ -165,7 +165,7 @@ msgstr "" #: library/email.utils.rst:151 msgid "" -"Optional *timeval* if given is a floating point time value as accepted by :" +"Optional *timeval* if given is a floating-point time value as accepted by :" "func:`time.gmtime` and :func:`time.localtime`, otherwise the current time is " "used." msgstr "" diff --git a/library/ensurepip.po b/library/ensurepip.po index c938196bc..6a7e21f0e 100644 --- a/library/ensurepip.po +++ b/library/ensurepip.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -206,10 +206,8 @@ msgid "" "bootstrapping operation." msgstr "" -#: library/ensurepip.rst:136 -msgid "" -"Raises an :ref:`auditing event ` ``ensurepip.bootstrap`` with " -"argument ``root``." +#: library/ensurepip.rst:125 +msgid "Raises an auditing event ensurepip.bootstrap with argument root." msgstr "" #: library/ensurepip.rst:129 diff --git a/library/enum.po b/library/enum.po index 282efa195..73d5bacea 100644 --- a/library/enum.po +++ b/library/enum.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -642,7 +642,7 @@ msgstr "" msgid "" "``Flag`` is the same as :class:`Enum`, but its members support the bitwise " "operators ``&`` (*AND*), ``|`` (*OR*), ``^`` (*XOR*), and ``~`` (*INVERT*); " -"the results of those operators are members of the enumeration." +"the results of those operations are (aliases of) members of the enumeration." msgstr "" #: library/enum.rst:524 diff --git a/library/exceptions.po b/library/exceptions.po index 9da9ca690..fccc08854 100644 --- a/library/exceptions.po +++ b/library/exceptions.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-03-01 20:27+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2024-02-17 13:11+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -654,13 +654,14 @@ msgstr "" "dosya adıdır. Ayrıca, *filename2* kurucu argümanı ve niteliği eklenmiştir." #: library/exceptions.rst:411 +#, fuzzy msgid "" "Raised when the result of an arithmetic operation is too large to be " "represented. This cannot occur for integers (which would rather raise :exc:" "`MemoryError` than give up). However, for historical reasons, OverflowError " "is sometimes raised for integers that are outside a required range. " -"Because of the lack of standardization of floating point exception handling " -"in C, most floating point operations are not checked." +"Because of the lack of standardization of floating-point exception handling " +"in C, most floating-point operations are not checked." msgstr "" "Bir aritmetik işlemin sonucu gösterilemeyecek kadar büyük olduğunda ortaya " "çıkar. Bu durum tamsayılar için oluşmaz (tamsayılar vazgeçmektense :exc:" @@ -1530,9 +1531,11 @@ msgstr "" "``excs`` içine sarar." #: library/exceptions.rst:970 +#, fuzzy msgid "" -"This method is used by :meth:`subgroup` and :meth:`split`. A subclass needs " -"to override it in order to make :meth:`subgroup` and :meth:`split` return " +"This method is used by :meth:`subgroup` and :meth:`split`, which are used in " +"various contexts to break up an exception group. A subclass needs to " +"override it in order to make :meth:`subgroup` and :meth:`split` return " "instances of the subclass rather than :exc:`ExceptionGroup`." msgstr "" "Bu yöntem :meth:`subgroup` ve :meth:`split` tarafından kullanılır. Bir alt " @@ -1540,7 +1543,7 @@ msgstr "" "yerine alt sınıfın örneklerini döndürmesini sağlamak için bu metodu geçersiz " "kılması gerekir." -#: library/exceptions.rst:975 +#: library/exceptions.rst:976 msgid "" ":meth:`subgroup` and :meth:`split` copy the :attr:`~BaseException." "__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException." @@ -1554,7 +1557,7 @@ msgstr "" "`derive` tarafından döndürülene kopyalar, böylece bu alanların :meth:" "`derive` tarafından güncellenmesi gerekmez." -#: library/exceptions.rst:1008 +#: library/exceptions.rst:1009 msgid "" "Note that :exc:`BaseExceptionGroup` defines :meth:`~object.__new__`, so " "subclasses that need a different constructor signature need to override that " @@ -1568,7 +1571,7 @@ msgstr "" "gerekir. Örneğin, aşağıda bir exit_code kabul eden ve grubun mesajını bundan " "oluşturan bir istisna grubu alt sınıfı tanımlanmaktadır:" -#: library/exceptions.rst:1023 +#: library/exceptions.rst:1024 msgid "" "Like :exc:`ExceptionGroup`, any subclass of :exc:`BaseExceptionGroup` which " "is also a subclass of :exc:`Exception` can only wrap instances of :exc:" @@ -1578,11 +1581,11 @@ msgstr "" "exc:`Exception` alt sınıfı da yalnızca :exc:`Exception` örneklerini " "sarabilir." -#: library/exceptions.rst:1031 +#: library/exceptions.rst:1032 msgid "Exception hierarchy" msgstr "İstisna hiyerarşisi" -#: library/exceptions.rst:1033 +#: library/exceptions.rst:1034 msgid "The class hierarchy for built-in exceptions is:" msgstr "Gömülü istisnalar için sınıf hiyerarşisi şöyledir:" diff --git a/library/fcntl.po b/library/fcntl.po index 20040ce4b..bfba0d34e 100644 --- a/library/fcntl.po +++ b/library/fcntl.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -112,9 +112,7 @@ msgid "If the :c:func:`fcntl` call fails, an :exc:`OSError` is raised." msgstr "" #: library/fcntl.rst:85 -msgid "" -"Raises an :ref:`auditing event ` ``fcntl.fcntl`` with arguments " -"``fd``, ``cmd``, ``arg``." +msgid "Raises an auditing event fcntl.fcntl with arguments fd, cmd, arg." msgstr "" #: library/fcntl.rst:90 @@ -179,9 +177,7 @@ msgid "An example::" msgstr "" #: library/fcntl.rst:136 -msgid "" -"Raises an :ref:`auditing event ` ``fcntl.ioctl`` with arguments " -"``fd``, ``request``, ``arg``." +msgid "Raises an auditing event fcntl.ioctl with arguments fd, request, arg." msgstr "" #: library/fcntl.rst:141 @@ -198,9 +194,7 @@ msgid "" msgstr "" #: library/fcntl.rst:148 -msgid "" -"Raises an :ref:`auditing event ` ``fcntl.flock`` with arguments " -"``fd``, ``operation``." +msgid "Raises an auditing event fcntl.flock with arguments fd, operation." msgstr "" #: library/fcntl.rst:153 @@ -267,8 +261,8 @@ msgstr "" #: library/fcntl.rst:194 msgid "" -"Raises an :ref:`auditing event ` ``fcntl.lockf`` with arguments " -"``fd``, ``cmd``, ``len``, ``start``, ``whence``." +"Raises an auditing event fcntl.lockf with arguments fd, cmd, len, start, " +"whence." msgstr "" #: library/fcntl.rst:196 diff --git a/library/fileinput.po b/library/fileinput.po index d43529c4d..e4361e12b 100644 --- a/library/fileinput.po +++ b/library/fileinput.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -80,7 +80,7 @@ msgstr "" #: library/fileinput.rst:49 msgid "" "You can control how files are opened by providing an opening hook via the " -"*openhook* parameter to :func:`fileinput.input` or :class:`FileInput()`. The " +"*openhook* parameter to :func:`fileinput.input` or :func:`FileInput`. The " "hook must be a function that takes two arguments, *filename* and *mode*, and " "returns an accordingly opened file-like object. If *encoding* and/or " "*errors* are specified, they will be passed to the hook as additional " diff --git a/library/fractions.po b/library/fractions.po index 8090ca0f0..eaf4fbb2d 100644 --- a/library/fractions.po +++ b/library/fractions.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -45,7 +45,7 @@ msgid "" "class:`Fraction` instance with the same value. The next two versions accept " "either a :class:`float` or a :class:`decimal.Decimal` instance, and return " "a :class:`Fraction` instance with exactly the same value. Note that due to " -"the usual issues with binary floating-point (see :ref:`tut-fp-issues`), the " +"the usual issues with binary floating point (see :ref:`tut-fp-issues`), the " "argument to ``Fraction(1.1)`` is not exactly equal to 11/10, and so " "``Fraction(1.1)`` does *not* return ``Fraction(11, 10)`` as one might " "expect. (But see the documentation for the :meth:`limit_denominator` method " @@ -82,7 +82,7 @@ msgstr "" #: library/fractions.rst:88 msgid "" "The :func:`math.gcd` function is now used to normalize the *numerator* and " -"*denominator*. :func:`math.gcd` always return a :class:`int` type. " +"*denominator*. :func:`math.gcd` always returns an :class:`int` type. " "Previously, the GCD type depended on *numerator* and *denominator*." msgstr "" diff --git a/library/ftplib.po b/library/ftplib.po index 5c226a805..112a6750a 100644 --- a/library/ftplib.po +++ b/library/ftplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -182,10 +182,9 @@ msgid "" "timeout setting)." msgstr "" -#: library/ftplib.rst:198 +#: library/ftplib.rst:187 msgid "" -"Raises an :ref:`auditing event ` ``ftplib.connect`` with arguments " -"``self``, ``host``, ``port``." +"Raises an auditing event ftplib.connect with arguments self, host, port." msgstr "" #: library/ftplib.rst:195 @@ -219,10 +218,8 @@ msgid "" "Send a simple command string to the server and return the response string." msgstr "" -#: library/ftplib.rst:249 -msgid "" -"Raises an :ref:`auditing event ` ``ftplib.sendcmd`` with arguments " -"``self``, ``cmd``." +#: library/ftplib.rst:238 +msgid "Raises an auditing event ftplib.sendcmd with arguments self, cmd." msgstr "" #: library/ftplib.rst:234 @@ -236,8 +233,8 @@ msgstr "" msgid "Retrieve a file in binary transfer mode." msgstr "" -#: library/ftplib.rst:289 -msgid "An appropriate ``STOR`` command: :samp:`\"STOR {filename}\"`." +#: library/ftplib.rst:245 +msgid "An appropriate ``RETR`` command: :samp:`\"RETR {filename}\"`." msgstr "" #: library/ftplib.rst:248 @@ -281,6 +278,10 @@ msgstr "" msgid "Store a file in binary transfer mode." msgstr "" +#: library/ftplib.rst:289 +msgid "An appropriate ``STOR`` command: :samp:`\"STOR {filename}\"`." +msgstr "" + #: library/ftplib.rst:292 msgid "" "A file object (opened in binary mode) which is read until EOF, using its :" diff --git a/library/functions.po b/library/functions.po index fa61fd1a6..5176de222 100644 --- a/library/functions.po +++ b/library/functions.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2023-03-08 10:13-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -398,7 +398,7 @@ msgstr ":func:`__import__`" #, fuzzy msgid "" "Return the absolute value of a number. The argument may be an integer, a " -"floating point number, or an object implementing :meth:`~object.__abs__`. If " +"floating-point number, or an object implementing :meth:`~object.__abs__`. If " "the argument is a complex number, its magnitude is returned." msgstr "" "Bir sayının mutlak değerini döndürür. Argüman bir tam sayı, gerçel sayı " @@ -559,9 +559,9 @@ msgid "" msgstr "" #: library/functions.rst:180 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``builtins.breakpoint`` with " -"argument ``breakpointhook``." +"Raises an auditing event builtins.breakpoint with argument breakpointhook." msgstr "" "``breakpointhook`` parametresi ile :ref:`denetleme olayı ` " "``builtins.breakpoint`` ortaya çıkartır." @@ -881,12 +881,14 @@ msgstr "" "'a bakınız." #: library/functions.rst:343 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``compile`` with arguments " -"``source``, ``filename``." +"Raises an auditing event compile with arguments source and filename. This " +"event may also be raised by implicit compilation." msgstr "" "``source`` ve ``filename`` argümanlarıyla :ref:`denetleme olayı ` " -"``compile`` ortaya çıkartır." +"``compile`` ortaya çıkartır. Bu durum, örtük derleme ile de ortaya " +"çıkarılabilir." #: library/functions.rst:345 msgid "" @@ -1143,11 +1145,12 @@ msgstr "" "özellikleri sonuç listesinde yer almaz." #: library/functions.rst:538 +#, fuzzy msgid "" "Take two (non-complex) numbers as arguments and return a pair of numbers " "consisting of their quotient and remainder when using integer division. " "With mixed operand types, the rules for binary arithmetic operators apply. " -"For integers, the result is the same as ``(a // b, a % b)``. For floating " +"For integers, the result is the same as ``(a // b, a % b)``. For floating-" "point numbers the result is ``(q, a % b)``, where *q* is usually ``math." "floor(a / b)`` but may be 1 less than that. In any case ``q * b + a % b`` " "is very close to *a*, if ``a % b`` is non-zero it has the same sign as *b*, " @@ -1290,12 +1293,14 @@ msgstr "" "bakınız." #: library/functions.rst:671 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``exec`` with argument " -"``code_object``." +"Raises an auditing event exec with the code object as the argument. Code " +"compilation events may also be raised." msgstr "" -"``code_object`` argümanıyla bir :ref:`denetleme olayı ` ``exec`` " -"hatası ortaya çıkarır." +"Argüman olarak kod nesnesi ile bir :ref:`denetleme olayı ` " +"``exec`` hatası ortaya çıkartır. Kodun derlendiği sırada çıkan hatalar da " +"yükseltilir." #: library/functions.rst:673 msgid "" @@ -1442,7 +1447,7 @@ msgstr "" #: library/functions.rst:717 #, fuzzy -msgid "Return a floating point number constructed from a number or a string." +msgid "Return a floating-point number constructed from a number or a string." msgstr "Bir numara veya string *x* 'ten oluşturulan bir reel sayı döndürür." #: library/functions.rst:734 @@ -1476,9 +1481,10 @@ msgstr "" "için kabul edilebilir yazımlardır." #: library/functions.rst:758 +#, fuzzy msgid "" -"Otherwise, if the argument is an integer or a floating point number, a " -"floating point number with the same value (within Python's floating point " +"Otherwise, if the argument is an integer or a floating-point number, a " +"floating-point number with the same value (within Python's floating-point " "precision) is returned. If the argument is outside the range of a Python " "float, an :exc:`OverflowError` will be raised." msgstr "" @@ -1747,9 +1753,8 @@ msgid "This is the address of the object in memory." msgstr "Bu, bellekteki nesnenin adresidir." #: library/functions.rst:929 -msgid "" -"Raises an :ref:`auditing event ` ``builtins.id`` with argument " -"``id``." +#, fuzzy +msgid "Raises an auditing event builtins.id with argument id." msgstr "" "``id`` argümanıyla beraber bir :ref:`denetleme olayı ` ``builtins." "id`` ortaya çıkartır." @@ -1775,12 +1780,13 @@ msgstr "" "düzenleme ve geçmiş özellikleri sağlamak için onu kullanacaktır." #: library/functions.rst:948 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``builtins.input`` with argument " -"``prompt``." +"Raises an auditing event builtins.input with argument prompt before reading " +"input" msgstr "" -"``prompt`` argümanıyla birlikte bir :ref:`denetleme olayı ` " -"``builtins.input`` ortaya çıkartır." +"Girişi okumadan önce, ``prompt`` argümanıyla birlikte bir :ref:`denetleme " +"olayı ` ``builtins.input`` ortaya çıkartır" #: library/functions.rst:950 msgid "" @@ -1791,12 +1797,13 @@ msgstr "" "olayı ` ``builtins.input`` ortaya çıkartır" #: library/functions.rst:953 +#, fuzzy msgid "" -"Raises an :ref:`auditing event ` ``builtins.input/result`` with " -"argument ``result``." +"Raises an auditing event builtins.input/result with the result after " +"successfully reading input." msgstr "" -"``result`` argümanıyla birlikte bir :ref:`denetleme olayı ` " -"``builtins.input/result`` ortaya çıkartır." +"Girişi başarıyla okuduktan sonra sonuçla birlikte bir :ref:`auditing event " +"` ``builtins.input/result`` denetleme olayı ortaya çıkarır." #: library/functions.rst:955 msgid "" @@ -1819,7 +1826,7 @@ msgid "" "If the argument defines :meth:`~object.__int__`, ``int(x)`` returns ``x." "__int__()``. If the argument defines :meth:`~object.__index__`, it returns " "``x.__index__()``. If the argument defines :meth:`~object.__trunc__`, it " -"returns ``x.__trunc__()``. For floating point numbers, this truncates " +"returns ``x.__trunc__()``. For floating-point numbers, this truncates " "towards zero." msgstr "" "Bir numara veya *x* dizesinden bir tam sayı oluşturur. Eğer argüman " @@ -2620,9 +2627,8 @@ msgstr "" "modüllerine de bkz." #: library/functions.rst:1443 -msgid "" -"Raises an :ref:`auditing event ` ``open`` with arguments ``file``, " -"``mode``, ``flags``." +#, fuzzy +msgid "Raises an auditing event open with arguments path, mode, flags." msgstr "" "``file``, ``mode``, ``flags`` parametreleriyle bir :ref:`audition event " "` ``open`` ortaya çıkartır." @@ -2716,6 +2722,7 @@ msgstr "" "eş değerdir." #: library/functions.rst:1491 +#, fuzzy msgid "" "The arguments must have numeric types. With mixed operand types, the " "coercion rules for binary arithmetic operators apply. For :class:`int` " @@ -2725,7 +2732,9 @@ msgid "" "2)`` returns ``100``, but ``pow(10, -2)`` returns ``0.01``. For a negative " "base of type :class:`int` or :class:`float` and a non-integral exponent, a " "complex result is delivered. For example, ``pow(-9, 0.5)`` returns a value " -"close to ``3j``." +"close to ``3j``. Whereas, for a negative base of type :class:`int` or :class:" +"`float` with an integral exponent, a float result is delivered. For example, " +"``pow(-9, 2.0)`` returns ``81.0``." msgstr "" "Parametreler nümerik olmak zorundadır. Karışık işlenen türleriyle, ikili " "aritmetik operatörler için baskı kuralları geçerlidir. :class:`int` " @@ -2737,7 +2746,7 @@ msgstr "" "`float` tipinin negatif tabanı için, karmaşık bir sayı çıktı verilir. " "Örneğin, ``pow(-9, 0.5)``, ``3j`` 'ye yakın bir değer döndürür." -#: library/functions.rst:1501 +#: library/functions.rst:1503 msgid "" "For :class:`int` operands *base* and *exp*, if *mod* is present, *mod* must " "also be of integer type and *mod* must be nonzero. If *mod* is present and " @@ -2751,11 +2760,11 @@ msgstr "" "``pow(inv_base,-exp,mod)`` döndürülüri *inv_base, *base* mod *mod* 'un " "tersidir." -#: library/functions.rst:1507 +#: library/functions.rst:1509 msgid "Here's an example of computing an inverse for ``38`` modulo ``97``::" msgstr "Burada ``38`` mod ``97`` 'nin tersini işlemek için bir örnek var::" -#: library/functions.rst:1514 +#: library/functions.rst:1516 msgid "" "For :class:`int` operands, the three-argument form of ``pow`` now allows the " "second argument to be negative, permitting computation of modular inverses." @@ -2763,14 +2772,14 @@ msgstr "" ":class:`int` işlenenleri için, ``pow`` 'un üç parametreli formu artık ikinci " "parametrenin negatif olmasına, modüler terslerin hesaplanmasına izin verir." -#: library/functions.rst:1519 +#: library/functions.rst:1521 msgid "" "Allow keyword arguments. Formerly, only positional arguments were supported." msgstr "" "Anahtar kelime parametrelerine izin ver, önceden sadece pozisyonel " "parametreler desteklenirdi." -#: library/functions.rst:1526 +#: library/functions.rst:1528 msgid "" "Print *objects* to the text stream *file*, separated by *sep* and followed " "by *end*. *sep*, *end*, *file*, and *flush*, if present, must be given as " @@ -2780,7 +2789,7 @@ msgstr "" "şekilde *objects* 'i yazdırır. *sep*, *end, *file*, ve *flush* sunulursa " "anahtar kelime parametreleri olarak verilmelidir." -#: library/functions.rst:1530 +#: library/functions.rst:1532 msgid "" "All non-keyword arguments are converted to strings like :func:`str` does and " "written to the stream, separated by *sep* and followed by *end*. Both *sep* " @@ -2794,7 +2803,7 @@ msgstr "" "varsayılan değerler kullanılır. Eğer *objects* verilmediyse, :func:`print` " "sadece *end* 'i yazdırır." -#: library/functions.rst:1536 +#: library/functions.rst:1538 msgid "" "The *file* argument must be an object with a ``write(string)`` method; if it " "is not present or ``None``, :data:`sys.stdout` will be used. Since printed " @@ -2806,7 +2815,7 @@ msgstr "" "argümanlar metin dizelerine çevrildiğinden, :func:`print` ikili dosya " "nesneleri ile kullanılamaz. Bunlar için, ``file.write(...)`` 'ı kullanın." -#: library/functions.rst:1541 +#: library/functions.rst:1543 #, fuzzy msgid "" "Output buffering is usually determined by *file*. However, if *flush* is " @@ -2815,15 +2824,15 @@ msgstr "" "Çıktının arabelleğe alınıp alınmadığı genellikle *file* tarafından " "belirlenir, ama *flush* argümanı doğru ise, akış zorla boşaltılır." -#: library/functions.rst:1545 +#: library/functions.rst:1547 msgid "Added the *flush* keyword argument." msgstr "*flush* anahtar kelimesi argümanı eklendi." -#: library/functions.rst:1551 +#: library/functions.rst:1553 msgid "Return a property attribute." msgstr "Bir özellik özelliği döndürür." -#: library/functions.rst:1553 +#: library/functions.rst:1555 msgid "" "*fget* is a function for getting an attribute value. *fset* is a function " "for setting an attribute value. *fdel* is a function for deleting an " @@ -2834,11 +2843,11 @@ msgstr "" "bir özelliğin değerini silmek için kullanılan bir fonksiyondur, ve *doc* " "özellik için bir belge dizisi oluşturur." -#: library/functions.rst:1557 +#: library/functions.rst:1559 msgid "A typical use is to define a managed attribute ``x``::" msgstr "Yönetilen bir ``x`` özelliği tanımlamak için tipik bir yöntem::" -#: library/functions.rst:1574 +#: library/functions.rst:1576 msgid "" "If *c* is an instance of *C*, ``c.x`` will invoke the getter, ``c.x = " "value`` will invoke the setter, and ``del c.x`` the deleter." @@ -2846,7 +2855,7 @@ msgstr "" "Eğer *c*, *C* 'nin bir örneğiyse, ``c.x``, alıcı fonksiyonu çağıracaktır. " "``c.x = value`` ayarlayıcı fonksiyonu, ``del c.x`` ise siliciyi çağıracaktır." -#: library/functions.rst:1577 +#: library/functions.rst:1579 msgid "" "If given, *doc* will be the docstring of the property attribute. Otherwise, " "the property will copy *fget*'s docstring (if it exists). This makes it " @@ -2858,7 +2867,7 @@ msgstr "" "kopyalayacaktır. Bu :func:`property` 'i :term:`decorator` olarak kullanarak " "kolayca salt-okunur özellikler oluşturmayı mümkün kılar::" -#: library/functions.rst:1590 +#: library/functions.rst:1592 #, fuzzy msgid "" "The ``@property`` decorator turns the :meth:`!voltage` method into a " @@ -2869,7 +2878,7 @@ msgstr "" "bir özellik için \"getter\" metoduna dönüştürür ve *voltage* için doküman " "dizisini \"Get the current voltage.\" olarak ayarlar." -#: library/functions.rst:1598 +#: library/functions.rst:1600 #, fuzzy msgid "" "A property object has ``getter``, ``setter``, and ``deleter`` methods usable " @@ -2883,7 +2892,7 @@ msgstr "" "`~property.deleter` metotlarını içerir. Bu en iyi şekilde bir örnekle " "açıklanabilir::" -#: library/functions.rst:1622 +#: library/functions.rst:1624 msgid "" "This code is exactly equivalent to the first example. Be sure to give the " "additional functions the same name as the original property (``x`` in this " @@ -2892,7 +2901,7 @@ msgstr "" "Bu kod birinci örneğin tamamen eş değeridir. Orijinal özellikte olduğu gibi " "ekstra fonksiyonlara aynı ismi verdiğinizden emin olun (bu durumda ``x``)." -#: library/functions.rst:1626 +#: library/functions.rst:1628 msgid "" "The returned property object also has the attributes ``fget``, ``fset``, and " "``fdel`` corresponding to the constructor arguments." @@ -2900,11 +2909,11 @@ msgstr "" "Döndürülen property nesnesi yapıcı metotta verilen ``fget``, ``fset``, ve " "``fdel`` özelliklerine sahiptir." -#: library/functions.rst:1629 +#: library/functions.rst:1631 msgid "The docstrings of property objects are now writeable." msgstr "Property nesnelerinin doküman dizeleri artık yazılabilir." -#: library/functions.rst:1638 +#: library/functions.rst:1640 msgid "" "Rather than being a function, :class:`range` is actually an immutable " "sequence type, as documented in :ref:`typesseq-range` and :ref:`typesseq`." @@ -2913,7 +2922,7 @@ msgstr "" "tipidir. Daha fazla bilgi için :ref:`typesseq-range` ve :ref:`typesseq` 'e " "bakınız." -#: library/functions.rst:1644 +#: library/functions.rst:1646 #, fuzzy msgid "" "Return a string containing a printable representation of an object. For " @@ -2935,11 +2944,11 @@ msgstr "" "ne döndürdüğünü kontrol edebilir. :func:`sys.displayhook` erişilebilir " "değilse, bu fonksiyon :exc:`RuntimeError` değerini yükseltir." -#: library/functions.rst:1655 +#: library/functions.rst:1657 msgid "This class has a custom representation that can be evaluated::" msgstr "" -#: library/functions.rst:1668 +#: library/functions.rst:1670 #, fuzzy msgid "" "Return a reverse :term:`iterator`. *seq* must be an object which has a :" @@ -2952,7 +2961,7 @@ msgstr "" "tam sayı argümanları alan bir :meth:`__getitem__` metodu) destekleyen bir " "nesne olmalıdır." -#: library/functions.rst:1676 +#: library/functions.rst:1678 msgid "" "Return *number* rounded to *ndigits* precision after the decimal point. If " "*ndigits* is omitted or is ``None``, it returns the nearest integer to its " @@ -2962,7 +2971,7 @@ msgstr "" "*ndigits* verilmediyse veya ``None`` ise, *number* 'a en yakın tam sayı " "döndürülür." -#: library/functions.rst:1680 +#: library/functions.rst:1682 msgid "" "For the built-in types supporting :func:`round`, values are rounded to the " "closest multiple of 10 to the power minus *ndigits*; if two multiples are " @@ -2980,7 +2989,7 @@ msgstr "" "*ndigits* verilmediyse veya ``None`` ise döndürülen değer bir tam sayıdır. " "Aksi takdirde, döndürülen değerin tipi *number* 'ınkiyle aynıdır." -#: library/functions.rst:1689 +#: library/functions.rst:1691 msgid "" "For a general Python object ``number``, ``round`` delegates to ``number." "__round__``." @@ -2988,7 +2997,7 @@ msgstr "" "Genel bir Python nesnesi için ``number``, ``round`` ``number.__round__`` 'u " "temsil eder." -#: library/functions.rst:1694 +#: library/functions.rst:1696 msgid "" "The behavior of :func:`round` for floats can be surprising: for example, " "``round(2.675, 2)`` gives ``2.67`` instead of the expected ``2.68``. This is " @@ -3002,7 +3011,7 @@ msgstr "" "gösterilemeyeceğinden bu sonucu alıyoruz. Daha fazla bilgi için :ref:`tut-fp-" "issues` 'e bkz." -#: library/functions.rst:1706 +#: library/functions.rst:1708 msgid "" "Return a new :class:`set` object, optionally with elements taken from " "*iterable*. ``set`` is a built-in class. See :class:`set` and :ref:`types-" @@ -3012,7 +3021,7 @@ msgstr "" "nesnesi döndürür. ``set`` yerleşik bir sınıftır. Bu sınıf hakkında " "dokümantasyon için :class:`set` ve :ref:`types-set` 'e bakınız." -#: library/functions.rst:1710 +#: library/functions.rst:1712 msgid "" "For other containers see the built-in :class:`frozenset`, :class:`list`, :" "class:`tuple`, and :class:`dict` classes, as well as the :mod:`collections` " @@ -3022,7 +3031,7 @@ msgstr "" "`tuple` ve :class:`dict` sınıflarını; aynı zamanda :mod:`collections` " "modülüne bakınız." -#: library/functions.rst:1717 +#: library/functions.rst:1719 msgid "" "This is the counterpart of :func:`getattr`. The arguments are an object, a " "string, and an arbitrary value. The string may name an existing attribute " @@ -3035,7 +3044,7 @@ msgstr "" "Fonksiyon, nesnenin izin vermesi koşuluyla, değeri özelliğe atar. Örneğin " "``setattr(x, 'foobar', 123)`` ve ``x.foobar = 123`` eş değerdir." -#: library/functions.rst:1723 +#: library/functions.rst:1725 msgid "" "*name* need not be a Python identifier as defined in :ref:`identifiers` " "unless the object chooses to enforce that, for example in a custom :meth:" @@ -3049,7 +3058,7 @@ msgstr "" "zorunda değildir. Adı tanımlayıcı olmayan bir özelliğe nokta kullanılarak " "erişilemez, ancak :func:`getattr` vb. aracılığıyla erişilebilir." -#: library/functions.rst:1731 +#: library/functions.rst:1733 msgid "" "Since :ref:`private name mangling ` happens at " "compilation time, one must manually mangle a private attribute's (attributes " @@ -3059,14 +3068,14 @@ msgstr "" "olacağından, :func:`setattr` ile ayarlamak için özel bir niteliğin (iki alt " "çizgi ile başlayan nitelikler) adını manuel olarak değiştirmek gerekir." -#: library/functions.rst:1740 +#: library/functions.rst:1742 msgid "" "Return a :term:`slice` object representing the set of indices specified by " "``range(start, stop, step)``. The *start* and *step* arguments default to " "``None``." msgstr "" -#: library/functions.rst:1748 +#: library/functions.rst:1750 msgid "" "Slice objects have read-only data attributes :attr:`!start`, :attr:`!stop`, " "and :attr:`!step` which merely return the argument values (or their " @@ -3074,30 +3083,30 @@ msgid "" "by NumPy and other third-party packages." msgstr "" -#: library/functions.rst:1753 +#: library/functions.rst:1755 msgid "" "Slice objects are also generated when extended indexing syntax is used. For " "example: ``a[start:stop:step]`` or ``a[start:stop, i]``. See :func:" "`itertools.islice` for an alternate version that returns an :term:`iterator`." msgstr "" -#: library/functions.rst:1758 +#: library/functions.rst:1760 msgid "" "Slice objects are now :term:`hashable` (provided :attr:`~slice.start`, :attr:" "`~slice.stop`, and :attr:`~slice.step` are hashable)." msgstr "" -#: library/functions.rst:1764 +#: library/functions.rst:1766 msgid "Return a new sorted list from the items in *iterable*." msgstr "" "*iterable* 'ın içindeki elementlerden oluşan sıralı bir liste döndürür." -#: library/functions.rst:1766 +#: library/functions.rst:1768 msgid "" "Has two optional arguments which must be specified as keyword arguments." msgstr "İsimle belirtilmesi gereken 2 opsiyonel parametresi vardır." -#: library/functions.rst:1768 +#: library/functions.rst:1770 msgid "" "*key* specifies a function of one argument that is used to extract a " "comparison key from each element in *iterable* (for example, ``key=str." @@ -3107,7 +3116,7 @@ msgstr "" "için kullanılan bir argümanın fonksiyonunu belirtir (örneğin, ``key=str." "lower``). Varsayılan değer ``None`` 'dır (elementleri direkt karşılaştırır)." -#: library/functions.rst:1772 +#: library/functions.rst:1774 msgid "" "*reverse* is a boolean value. If set to ``True``, then the list elements " "are sorted as if each comparison were reversed." @@ -3115,7 +3124,7 @@ msgstr "" "*reverse* bir boolean değerdir. Eğer ``True`` ise, liste elementleri tüm " "karşılaştırmalar tersine çevrilmiş şekilde sıralanır." -#: library/functions.rst:1775 +#: library/functions.rst:1777 msgid "" "Use :func:`functools.cmp_to_key` to convert an old-style *cmp* function to a " "*key* function." @@ -3123,7 +3132,7 @@ msgstr "" "Eski stil *cmp* fonksiyonunu bir *key* fonksiyonuna dönüştürmek için :func:" "`functools.cmp_to_key` 'yi kullanın." -#: library/functions.rst:1778 +#: library/functions.rst:1780 msgid "" "The built-in :func:`sorted` function is guaranteed to be stable. A sort is " "stable if it guarantees not to change the relative order of elements that " @@ -3135,7 +3144,7 @@ msgstr "" "garantiliyorsa stabildir --- bu çoklu geçişlerle sıralama (örneğin önce " "departman, ardından maaş sıralama) için yardımcıdır." -#: library/functions.rst:1783 +#: library/functions.rst:1785 msgid "" "The sort algorithm uses only ``<`` comparisons between items. While " "defining an :meth:`~object.__lt__` method will suffice for sorting, :PEP:`8` " @@ -3155,18 +3164,18 @@ msgstr "" "uygulamak ayrıca yansıtılan :meth:`~object.__gt__` metodunu çağırabilen " "karmaşık tür karşılaştırmaları için karışıklığı da önler." -#: library/functions.rst:1792 +#: library/functions.rst:1794 msgid "" "For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." msgstr "" "Sıralama örnekleri ve kısa sıralama öğreticisi için :ref:`sortinghowto` 'ya " "bakınız." -#: library/functions.rst:1796 +#: library/functions.rst:1798 msgid "Transform a method into a static method." msgstr "Bir metodu statik metoda dönüştürür." -#: library/functions.rst:1798 +#: library/functions.rst:1800 msgid "" "A static method does not receive an implicit first argument. To declare a " "static method, use this idiom::" @@ -3174,7 +3183,7 @@ msgstr "" "Statik bir metot üstü kapalı şekilde bir ilk argüman almaz. Statik metot " "tanımlamak için bu ifadeyi kullanabilirsiniz::" -#: library/functions.rst:1805 +#: library/functions.rst:1807 msgid "" "The ``@staticmethod`` form is a function :term:`decorator` -- see :ref:" "`function` for details." @@ -3182,7 +3191,7 @@ msgstr "" "``@staticmethod`` ifadesi bir :term:`decorator` fonksiyonudur. -- detaylar " "için :ref:`function` bkz." -#: library/functions.rst:1808 +#: library/functions.rst:1810 #, fuzzy msgid "" "A static method can be called either on the class (such as ``C.f()``) or on " @@ -3194,7 +3203,7 @@ msgstr "" "(``C().f()`` gibi) çağırılabilir. Hatta normal fonksiyonlar gibi (``f()``) " "de çağırılabilirler." -#: library/functions.rst:1813 +#: library/functions.rst:1815 msgid "" "Static methods in Python are similar to those found in Java or C++. Also, " "see :func:`classmethod` for a variant that is useful for creating alternate " @@ -3204,7 +3213,7 @@ msgstr "" "için alternatif bir yapıcı metot oluşturmak isterseniz :func:`classmethod` " "bkz." -#: library/functions.rst:1817 +#: library/functions.rst:1819 msgid "" "Like all decorators, it is also possible to call ``staticmethod`` as a " "regular function and do something with its result. This is needed in some " @@ -3218,11 +3227,11 @@ msgstr "" "dönüşümü engellemek istediğinizde işinize yarayabilir. Böyle durumlar için, " "bu ifadeyi kullanabilirsiniz::" -#: library/functions.rst:1829 +#: library/functions.rst:1831 msgid "For more information on static methods, see :ref:`types`." msgstr "Statik metotlar hakkında daha fazla bilgi için, :ref:`types` bkz." -#: library/functions.rst:1831 +#: library/functions.rst:1833 msgid "" "Static methods now inherit the method attributes (``__module__``, " "``__name__``, ``__qualname__``, ``__doc__`` and ``__annotations__``), have a " @@ -3233,14 +3242,14 @@ msgstr "" "``__wrapped__`` özellikleri var ve artık normal fonksiyonlar gibi " "çağırılabilirler." -#: library/functions.rst:1846 +#: library/functions.rst:1848 msgid "" "Return a :class:`str` version of *object*. See :func:`str` for details." msgstr "" "*object* 'in :class:`str` versiyonunu döndürür. Detaylar için :func:`str` " "bkz." -#: library/functions.rst:1848 +#: library/functions.rst:1850 msgid "" "``str`` is the built-in string :term:`class`. For general information about " "strings, see :ref:`textseq`." @@ -3248,7 +3257,7 @@ msgstr "" "``str`` yerleşik dize :term:`class` 'ıdır. Dizeler hakkında genel bilgi " "için, :ref:`textseq` bkz." -#: library/functions.rst:1854 +#: library/functions.rst:1856 msgid "" "Sums *start* and the items of an *iterable* from left to right and returns " "the total. The *iterable*'s items are normally numbers, and the start value " @@ -3258,11 +3267,12 @@ msgstr "" "döndürür. *iterable* 'ın elemanları normal olarak numaralardır ve başlangıç " "değeri bir dize olamaz." -#: library/functions.rst:1858 +#: library/functions.rst:1860 +#, fuzzy msgid "" "For some use cases, there are good alternatives to :func:`sum`. The " "preferred, fast way to concatenate a sequence of strings is by calling ``''." -"join(sequence)``. To add floating point values with extended precision, " +"join(sequence)``. To add floating-point values with extended precision, " "see :func:`math.fsum`\\. To concatenate a series of iterables, consider " "using :func:`itertools.chain`." msgstr "" @@ -3273,17 +3283,17 @@ msgstr "" "nesnelerden oluşan bir diziyi birleştirmek istiyorsanız, :func:`itertools." "chain` fonksiyonunu kullanmayı göz önünde bulundurun." -#: library/functions.rst:1864 +#: library/functions.rst:1866 msgid "The *start* parameter can be specified as a keyword argument." msgstr "*start* parametresi bir anahtar kelime argümanı olarak belirtilebilir." -#: library/functions.rst:1867 +#: library/functions.rst:1869 msgid "" "Summation of floats switched to an algorithm that gives higher accuracy on " "most builds." msgstr "" -#: library/functions.rst:1874 +#: library/functions.rst:1876 msgid "" "Return a proxy object that delegates method calls to a parent or sibling " "class of *type*. This is useful for accessing inherited methods that have " @@ -3293,7 +3303,7 @@ msgstr "" "eden bir proxy objesi döndürür. Bu bir sınıfta üzerine yazılmış kalıtılan " "metotlara erişmek için kullanışlıdır." -#: library/functions.rst:1878 +#: library/functions.rst:1880 msgid "" "The *object_or_type* determines the :term:`method resolution order` to be " "searched. The search starts from the class right after the *type*." @@ -3301,7 +3311,7 @@ msgstr "" "*object_or_type* aranacak :term:`method resolution order` 'nı belirler. " "Arama *type* 'dan sonraki ilk sınıftan başlar." -#: library/functions.rst:1882 +#: library/functions.rst:1884 msgid "" "For example, if :attr:`~class.__mro__` of *object_or_type* is ``D -> B -> C -" "> A -> object`` and the value of *type* is ``B``, then :func:`super` " @@ -3311,7 +3321,7 @@ msgstr "" "> B -> C -> A -> object`` ise ve *type* değeri ``B`` ise, :func:`super` ``C -" "> A -> object`` 'i arar." -#: library/functions.rst:1886 +#: library/functions.rst:1888 msgid "" "The :attr:`~class.__mro__` attribute of the *object_or_type* lists the " "method resolution search order used by both :func:`getattr` and :func:" @@ -3323,7 +3333,7 @@ msgstr "" "listeler. Özellik dinamiktir ve kalıtım hiyerarşisi her güncellendiğinde " "değişebilir." -#: library/functions.rst:1891 +#: library/functions.rst:1893 msgid "" "If the second argument is omitted, the super object returned is unbound. If " "the second argument is an object, ``isinstance(obj, type)`` must be true. " @@ -3335,7 +3345,7 @@ msgstr "" "zorundadır. Eğer ikinci parametre bir tür ise, ``issubclass(type2, type)`` " "doğru olmak zorundadır (bu sınıf metotları için kullanışlıdır)." -#: library/functions.rst:1896 +#: library/functions.rst:1898 msgid "" "There are two typical use cases for *super*. In a class hierarchy with " "single inheritance, *super* can be used to refer to parent classes without " @@ -3346,7 +3356,7 @@ msgstr "" "hiyerarşisinde *super* üst sınıfları açıkça adlandırmadan onlara başvurmak " "için kullanılabilir. böylece kodu daha sürdürülebilir hale getirir." -#: library/functions.rst:1901 +#: library/functions.rst:1903 msgid "" "The second use case is to support cooperative multiple inheritance in a " "dynamic execution environment. This use case is unique to Python and is not " @@ -3367,12 +3377,12 @@ msgstr "" "sıra sınıf hiyerarşisindeki değişikliklere uyarlanır ve çalışma zamanından " "önce bilinmeyen kardeş sınıfları içerebilir) dikte eder." -#: library/functions.rst:1911 +#: library/functions.rst:1913 msgid "For both use cases, a typical superclass call looks like this::" msgstr "" "İki kullanım durumu için de, tipik bir üst sınıf çağrısı bu şekildedir::" -#: library/functions.rst:1918 +#: library/functions.rst:1920 msgid "" "In addition to method lookups, :func:`super` also works for attribute " "lookups. One possible use case for this is calling :term:`descriptors " @@ -3382,7 +3392,7 @@ msgstr "" "çalışır. Bunun kullanım şekli ebeveyn veya kardeş bir sınıfta :term:" "`tanımlayıcılar ` 'i çağırmaktır." -#: library/functions.rst:1922 +#: library/functions.rst:1924 #, fuzzy msgid "" "Note that :func:`super` is implemented as part of the binding process for " @@ -3399,7 +3409,7 @@ msgstr "" "`super`, ifadeler veya ``super()[name]`` gibi operatörler kullanarak kesin " "aramalar için tanımsızdır." -#: library/functions.rst:1930 +#: library/functions.rst:1932 msgid "" "Also note that, aside from the zero argument form, :func:`super` is not " "limited to use inside methods. The two argument form specifies the " @@ -3414,7 +3424,7 @@ msgstr "" "tanımının içinde çalışır, derleyici tanımlanan sınıfı doğru şekilde almak ve " "sıradan yöntemlere geçerli örnekten erişmek için gerekli detayları doldurur." -#: library/functions.rst:1937 +#: library/functions.rst:1939 msgid "" "For practical suggestions on how to design cooperative classes using :func:" "`super`, see `guide to using super() `_ bkz." -#: library/functions.rst:1947 +#: library/functions.rst:1949 msgid "" "Rather than being a function, :class:`tuple` is actually an immutable " "sequence type, as documented in :ref:`typesseq-tuple` and :ref:`typesseq`." @@ -3432,7 +3442,7 @@ msgstr "" "Bir fonksiyon olmaktansa, :class:`tuple` :ref:`typesseq-tuple` ve :ref:" "`typesseq` 'de gösterildiği gibi düzenlenemez bir dizi türüdür." -#: library/functions.rst:1956 +#: library/functions.rst:1958 msgid "" "With one argument, return the type of an *object*. The return value is a " "type object and generally the same object as returned by :attr:`object." @@ -3442,7 +3452,7 @@ msgstr "" "türüdür ve genellikle :attr:`object.__class__ ` " "tarafından döndürülen obje ile aynıdır." -#: library/functions.rst:1960 +#: library/functions.rst:1962 msgid "" "The :func:`isinstance` built-in function is recommended for testing the type " "of an object, because it takes subclasses into account." @@ -3450,7 +3460,7 @@ msgstr "" ":func:`isinstance` yerleşik fonksiyonu bir objenin türünü test etmek için " "önerilir. Çünkü altsınıfları hesaba katar." -#: library/functions.rst:1964 +#: library/functions.rst:1966 msgid "" "With three arguments, return a new type object. This is essentially a " "dynamic form of the :keyword:`class` statement. The *name* string is the " @@ -3471,11 +3481,11 @@ msgstr "" "özelliği yerine geçmeden önce kopyalanabilir veya sarılabilir. Aşağıdaki iki " "ifade birebir aynı :class:`type` nesneleri oluşturur:" -#: library/functions.rst:1979 +#: library/functions.rst:1981 msgid "See also :ref:`bltin-type-objects`." msgstr ":ref:`bltin-type-objects` 'e de bkz." -#: library/functions.rst:1981 +#: library/functions.rst:1983 msgid "" "Keyword arguments provided to the three argument form are passed to the " "appropriate metaclass machinery (usually :meth:`~object.__init_subclass__`) " @@ -3487,11 +3497,11 @@ msgstr "" "tanımındaki anahtar sözcüklerin (*metaclass* dışında) yapacağı şekilde " "iletilir." -#: library/functions.rst:1986 +#: library/functions.rst:1988 msgid "See also :ref:`class-customization`." msgstr ":ref:`class-customization` 'a da bkz." -#: library/functions.rst:1988 +#: library/functions.rst:1990 msgid "" "Subclasses of :class:`type` which don't override ``type.__new__`` may no " "longer use the one-argument form to get the type of an object." @@ -3499,7 +3509,7 @@ msgstr "" "``type.__new__`` 'in üzerine yazmayan :class:`type` altsınıfları artık bir " "objenin türünü almak için tek argümanlı formu kullanamaz." -#: library/functions.rst:1995 +#: library/functions.rst:1997 msgid "" "Return the :attr:`~object.__dict__` attribute for a module, class, instance, " "or any other object with a :attr:`~object.__dict__` attribute." @@ -3507,7 +3517,7 @@ msgstr "" "Bir modül, sınıf, örnek veya :attr:`~object.__dict__` özelliği bulunan " "herhangi bir obje için, :attr:`~object.__dict__` özelliğini döndürür." -#: library/functions.rst:1998 +#: library/functions.rst:2000 msgid "" "Objects such as modules and instances have an updateable :attr:`~object." "__dict__` attribute; however, other objects may have write restrictions on " @@ -3520,7 +3530,7 @@ msgstr "" "sınıflar doğrudan sözlük güncellemelerini önlemek için :class:`types." "MappingProxyType` sınıfını kullanırlar)." -#: library/functions.rst:2003 +#: library/functions.rst:2005 msgid "" "Without an argument, :func:`vars` acts like :func:`locals`. Note, the " "locals dictionary is only useful for reads since updates to the locals " @@ -3530,7 +3540,7 @@ msgstr "" "ona yapılan güncellemeler görmezden gelindiğinden ötürü, sadece okuma işlemi " "için kullanışlıdır." -#: library/functions.rst:2007 +#: library/functions.rst:2009 msgid "" "A :exc:`TypeError` exception is raised if an object is specified but it " "doesn't have a :attr:`~object.__dict__` attribute (for example, if its class " @@ -3540,7 +3550,7 @@ msgstr "" "(örneğin, :attr:`~object.__slots__` özelliğini tanımlayan bir sınıf ise), :" "exc:`TypeError` hatası ortaya çıkar." -#: library/functions.rst:2013 +#: library/functions.rst:2015 msgid "" "Iterate over several iterables in parallel, producing tuples with an item " "from each one." @@ -3548,11 +3558,11 @@ msgstr "" "Paralel olarak birkaç yinelenebilir nesneyi yineler ve hepsinden bir element " "alarak bir demet üretir." -#: library/functions.rst:2016 +#: library/functions.rst:2018 msgid "Example::" msgstr "Örnek::" -#: library/functions.rst:2025 +#: library/functions.rst:2027 msgid "" "More formally: :func:`zip` returns an iterator of tuples, where the *i*-th " "tuple contains the *i*-th element from each of the argument iterables." @@ -3561,7 +3571,7 @@ msgstr "" "parametre yineleyicisinden *i* 'inci elementi içerdiği bir yineleyici " "döndürür." -#: library/functions.rst:2028 +#: library/functions.rst:2030 msgid "" "Another way to think of :func:`zip` is that it turns rows into columns, and " "columns into rows. This is similar to `transposing a matrix `_ 'a benzer." -#: library/functions.rst:2032 +#: library/functions.rst:2034 msgid "" ":func:`zip` is lazy: The elements won't be processed until the iterable is " "iterated on, e.g. by a :keyword:`!for` loop or by wrapping in a :class:" @@ -3581,7 +3591,7 @@ msgstr "" "döngüsü veya :class:`list` tarafından sarılarak yinelenmediği sürece " "elementler işlenmez." -#: library/functions.rst:2036 +#: library/functions.rst:2038 msgid "" "One thing to consider is that the iterables passed to :func:`zip` could have " "different lengths; sometimes by design, and sometimes because of a bug in " @@ -3593,7 +3603,7 @@ msgstr "" "kodda oluşan bir hatadan dolayı farklı uzunluklarda olabilirler. Python " "bununla başa çıkmak için üç farklı yaklaşım sunar:" -#: library/functions.rst:2041 +#: library/functions.rst:2043 msgid "" "By default, :func:`zip` stops when the shortest iterable is exhausted. It " "will ignore the remaining items in the longer iterables, cutting off the " @@ -3603,7 +3613,7 @@ msgstr "" "durur. Daha uzun yinelebilirlerde kalan elementleri görmezden gelecektir ve " "sonucu en kısa yineleyicinin uzunluğuna eşitleyecektir::" -#: library/functions.rst:2048 +#: library/functions.rst:2050 msgid "" ":func:`zip` is often used in cases where the iterables are assumed to be of " "equal length. In such cases, it's recommended to use the ``strict=True`` " @@ -3613,7 +3623,7 @@ msgstr "" "kullanılır. Bu gibi durumlarda, ``strict=True`` opsiyonunu kullanmak " "önerilir. Çıktısı sıradan :func:`zip` ile aynıdır::" -#: library/functions.rst:2055 +#: library/functions.rst:2057 msgid "" "Unlike the default behavior, it raises a :exc:`ValueError` if one iterable " "is exhausted before the others:" @@ -3621,7 +3631,7 @@ msgstr "" "Varsayılan davranışın aksine, bir yinelenebilir diğerlerinden önce tükenirse " "bir :exc:`ValueError` ortaya çıkar:" -#: library/functions.rst:2073 +#: library/functions.rst:2075 msgid "" "Without the ``strict=True`` argument, any bug that results in iterables of " "different lengths will be silenced, possibly manifesting as a hard-to-find " @@ -3631,7 +3641,7 @@ msgstr "" "sonuçlanan hatalar susturulacaktır. Mümkün olduğunca programın başka bir " "bölümünde bulunması zor bir hata olarak tezahür ediyor." -#: library/functions.rst:2077 +#: library/functions.rst:2079 msgid "" "Shorter iterables can be padded with a constant value to make all the " "iterables have the same length. This is done by :func:`itertools." @@ -3641,7 +3651,7 @@ msgstr "" "uzunlukta olması için sabit bir değerle doldurulabilirler. Bu :func:" "`itertools.zip_longest` tarafından yapılır." -#: library/functions.rst:2081 +#: library/functions.rst:2083 msgid "" "Edge cases: With a single iterable argument, :func:`zip` returns an iterator " "of 1-tuples. With no arguments, it returns an empty iterator." @@ -3650,11 +3660,11 @@ msgstr "" "bir demetin yineleyicisini döndürür. Argüman verilmezse, boş bir yineleyici " "döndürür." -#: library/functions.rst:2084 +#: library/functions.rst:2086 msgid "Tips and tricks:" msgstr "İpucu ve hileler:" -#: library/functions.rst:2086 +#: library/functions.rst:2088 msgid "" "The left-to-right evaluation order of the iterables is guaranteed. This " "makes possible an idiom for clustering a data series into n-length groups " @@ -3669,7 +3679,7 @@ msgstr "" "sayıda çağrı yapmış olur. Bu, girdiyi n-uzunluklu parçalara bölme etkisine " "sahiptir." -#: library/functions.rst:2092 +#: library/functions.rst:2094 msgid "" ":func:`zip` in conjunction with the ``*`` operator can be used to unzip a " "list::" @@ -3677,11 +3687,11 @@ msgstr "" ":func:`zip`, bir listeyi açmak için ``*`` operatörüyle birlikte " "kullanılabilir::" -#: library/functions.rst:2103 +#: library/functions.rst:2105 msgid "Added the ``strict`` argument." msgstr "``strict`` argümanı eklendi." -#: library/functions.rst:2115 +#: library/functions.rst:2117 msgid "" "This is an advanced function that is not needed in everyday Python " "programming, unlike :func:`importlib.import_module`." @@ -3689,7 +3699,7 @@ msgstr "" "Bu :func:`importlib.import_module` 'un aksine günlük Python programlamasında " "genel olarak kullanılmayan gelişmiş bir fonksiyondur." -#: library/functions.rst:2118 +#: library/functions.rst:2120 msgid "" "This function is invoked by the :keyword:`import` statement. It can be " "replaced (by importing the :mod:`builtins` module and assigning to " @@ -3708,7 +3718,7 @@ msgstr "" "neden olmayacağından tavsiye **edilmez**. :func:`__import__` 'un doğrudan " "kullanımı da :func:`importlib.import_module` 'ın lehine tavsiye edilmez." -#: library/functions.rst:2127 +#: library/functions.rst:2129 msgid "" "The function imports the module *name*, potentially using the given " "*globals* and *locals* to determine how to interpret the name in a package " @@ -3724,7 +3734,7 @@ msgstr "" "*locals* argümanını kullanmaya teşebbüs etmez ve *globals* 'i :keyword:" "`import` ifadesinin paket bağlamını belirlemek için kullanır." -#: library/functions.rst:2134 +#: library/functions.rst:2136 msgid "" "*level* specifies whether to use absolute or relative imports. ``0`` (the " "default) means only perform absolute imports. Positive values for *level* " @@ -3738,7 +3748,7 @@ msgstr "" "dizinine göre aranacak üst dizinlerin sayısını gösterir (detaylar için :pep:" "`328` 'e bakınız)." -#: library/functions.rst:2140 +#: library/functions.rst:2142 msgid "" "When the *name* variable is of the form ``package.module``, normally, the " "top-level package (the name up till the first dot) is returned, *not* the " @@ -3749,7 +3759,7 @@ msgstr "" "((ilk noktaya kadar olan isim) döndürülür, *name* isimli modül *değil*. Boş " "olmayan bir *fromlist* argümanı verildiğinde, *name* isimli modül döndürülür." -#: library/functions.rst:2145 +#: library/functions.rst:2147 msgid "" "For example, the statement ``import spam`` results in bytecode resembling " "the following code::" @@ -3757,11 +3767,11 @@ msgstr "" "Örnek olarak, ``import spam`` ifadesi aşağıdaki koda benzeyen bayt koduyla " "sonuçlanır::" -#: library/functions.rst:2150 +#: library/functions.rst:2152 msgid "The statement ``import spam.ham`` results in this call::" msgstr "``import spam.ham`` ifadesi şu çağrıyla sonuçlanır::" -#: library/functions.rst:2154 +#: library/functions.rst:2156 msgid "" "Note how :func:`__import__` returns the toplevel module here because this is " "the object that is bound to a name by the :keyword:`import` statement." @@ -3770,7 +3780,7 @@ msgstr "" "dikkat edin, çünkü bu, :keyword:`import` ifadesiyle bir ada bağlanan " "nesnedir." -#: library/functions.rst:2157 +#: library/functions.rst:2159 msgid "" "On the other hand, the statement ``from spam.ham import eggs, sausage as " "saus`` results in ::" @@ -3778,7 +3788,7 @@ msgstr "" "Diğer yandan, ``from spam.ham import eggs, sausage as saus`` ifadesi şöyle " "sonuçlanır::" -#: library/functions.rst:2164 +#: library/functions.rst:2166 msgid "" "Here, the ``spam.ham`` module is returned from :func:`__import__`. From " "this object, the names to import are retrieved and assigned to their " @@ -3787,7 +3797,7 @@ msgstr "" "Burada, ``spam.ham`` modülü :func:`__import__` 'dan döndürülür. Bu objeden, " "içeri aktarılacak isimler alınır ve sırasıyla adlarına atanır." -#: library/functions.rst:2168 +#: library/functions.rst:2170 msgid "" "If you simply want to import a module (potentially within a package) by " "name, use :func:`importlib.import_module`." @@ -3795,7 +3805,7 @@ msgstr "" "Eğer ismiyle bir modülü (potansiyel olarak bir paket içinde) içe aktarmak " "istiyorsanız, :func:`importlib.import_module` 'i kullanın." -#: library/functions.rst:2171 +#: library/functions.rst:2173 msgid "" "Negative values for *level* are no longer supported (which also changes the " "default value to 0)." @@ -3803,7 +3813,7 @@ msgstr "" "*level* için negatif değerler artık desteklenmiyor (bu, varsayılan değeri 0 " "olarak da değiştirir)." -#: library/functions.rst:2175 +#: library/functions.rst:2177 msgid "" "When the command line options :option:`-E` or :option:`-I` are being used, " "the environment variable :envvar:`PYTHONCASEOK` is now ignored." @@ -3811,11 +3821,11 @@ msgstr "" "Komut satırı opsiyonlarından :option:`-E` veya :option:`-I` kullanıldığında, " "ortam değişkeni :envvar:`PYTHONCASEOK` görmezden gelinir." -#: library/functions.rst:2180 +#: library/functions.rst:2182 msgid "Footnotes" msgstr "Dipnotlar" -#: library/functions.rst:2181 +#: library/functions.rst:2183 msgid "" "Note that the parser only accepts the Unix-style end of line convention. If " "you are reading the code from a file, make sure to use newline conversion " @@ -3830,7 +3840,7 @@ msgstr "" msgid "Boolean" msgstr "" -#: library/functions.rst:1954 +#: library/functions.rst:1956 msgid "type" msgstr "" @@ -3855,7 +3865,7 @@ msgstr "" msgid "__format__" msgstr "" -#: library/functions.rst:1838 +#: library/functions.rst:1840 msgid "string" msgstr "" @@ -3910,7 +3920,7 @@ msgstr "" msgid "text mode" msgstr "metin modu (varsayılan)" -#: library/functions.rst:2109 +#: library/functions.rst:2111 msgid "module" msgstr "" @@ -3918,28 +3928,56 @@ msgstr "" msgid "sys" msgstr "" -#: library/functions.rst:1838 +#: library/functions.rst:1840 #, fuzzy msgid "str() (built-in function)" msgstr "Gömülü Fonksiyonlar" -#: library/functions.rst:1954 +#: library/functions.rst:1956 #, fuzzy msgid "object" msgstr ":func:`object`" -#: library/functions.rst:2109 +#: library/functions.rst:2111 msgid "statement" msgstr "" -#: library/functions.rst:2109 +#: library/functions.rst:2111 msgid "import" msgstr "" -#: library/functions.rst:2109 +#: library/functions.rst:2111 msgid "builtins" msgstr "" +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``compile`` with arguments " +#~ "``source``, ``filename``." +#~ msgstr "" +#~ "``source`` ve ``filename`` argümanlarıyla :ref:`denetleme olayı " +#~ "` ``compile`` ortaya çıkartır." + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``exec`` with argument " +#~ "``code_object``." +#~ msgstr "" +#~ "``code_object`` argümanıyla bir :ref:`denetleme olayı ` " +#~ "``exec`` hatası ortaya çıkarır." + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``builtins.input`` with " +#~ "argument ``prompt``." +#~ msgstr "" +#~ "``prompt`` argümanıyla birlikte bir :ref:`denetleme olayı ` " +#~ "``builtins.input`` ortaya çıkartır." + +#~ msgid "" +#~ "Raises an :ref:`auditing event ` ``builtins.input/result`` with " +#~ "argument ``result``." +#~ msgstr "" +#~ "``result`` argümanıyla birlikte bir :ref:`denetleme olayı ` " +#~ "``builtins.input/result`` ortaya çıkartır." + #~ msgid "" #~ "Return a complex number with the value *real* + *imag*\\*1j or convert a " #~ "string or number to a complex number. If the first parameter is a " diff --git a/library/gc.po b/library/gc.po index 0e124fc28..642853ec8 100644 --- a/library/gc.po +++ b/library/gc.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -95,9 +95,7 @@ msgid "New *generation* parameter." msgstr "" #: library/gc.rst:78 -msgid "" -"Raises an :ref:`auditing event ` ``gc.get_objects`` with argument " -"``generation``." +msgid "Raises an auditing event gc.get_objects with argument generation." msgstr "" #: library/gc.rst:82 @@ -186,9 +184,7 @@ msgid "" msgstr "" #: library/gc.rst:149 -msgid "" -"Raises an :ref:`auditing event ` ``gc.get_referrers`` with " -"argument ``objs``." +msgid "Raises an auditing event gc.get_referrers with argument objs." msgstr "" #: library/gc.rst:154 @@ -204,9 +200,7 @@ msgid "" msgstr "" #: library/gc.rst:162 -msgid "" -"Raises an :ref:`auditing event ` ``gc.get_referents`` with " -"argument ``objs``." +msgid "Raises an auditing event gc.get_referents with argument objs." msgstr "" #: library/gc.rst:166 diff --git a/library/glob.po b/library/glob.po index eb30e66c7..ea39b32af 100644 --- a/library/glob.po +++ b/library/glob.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -93,15 +93,13 @@ msgid "" msgstr "" #: library/glob.rst:100 -msgid "" -"Raises an :ref:`auditing event ` ``glob.glob`` with arguments " -"``pathname``, ``recursive``." +msgid "Raises an auditing event glob.glob with arguments pathname, recursive." msgstr "" #: library/glob.rst:101 msgid "" -"Raises an :ref:`auditing event ` ``glob.glob/2`` with arguments " -"``pathname``, ``recursive``, ``root_dir``, ``dir_fd``." +"Raises an auditing event glob.glob/2 with arguments pathname, recursive, " +"root_dir, dir_fd." msgstr "" #: library/glob.rst:77 diff --git a/library/gzip.po b/library/gzip.po index 4ad60f9e4..9cc276722 100644 --- a/library/gzip.po +++ b/library/gzip.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -283,10 +283,12 @@ msgstr "" msgid "" "Speed is improved by compressing all data at once instead of in a streamed " "fashion. Calls with *mtime* set to ``0`` are delegated to :func:`zlib." -"compress` for better speed." +"compress` for better speed. In this situation the output may contain a gzip " +"header \"OS\" byte value other than 255 \"unknown\" as supplied by the " +"underlying zlib implementation." msgstr "" -#: library/gzip.rst:201 +#: library/gzip.rst:203 msgid "" "Decompress the *data*, returning a :class:`bytes` object containing the " "uncompressed data. This function is capable of decompressing multi-member " @@ -295,82 +297,82 @@ msgid "" "*wbits* set to 31 is faster." msgstr "" -#: library/gzip.rst:208 +#: library/gzip.rst:210 msgid "" "Speed is improved by decompressing members at once in memory instead of in a " "streamed fashion." msgstr "" -#: library/gzip.rst:215 +#: library/gzip.rst:217 msgid "Examples of usage" msgstr "" -#: library/gzip.rst:217 +#: library/gzip.rst:219 msgid "Example of how to read a compressed file::" msgstr "" -#: library/gzip.rst:223 +#: library/gzip.rst:225 msgid "Example of how to create a compressed GZIP file::" msgstr "" -#: library/gzip.rst:230 +#: library/gzip.rst:232 msgid "Example of how to GZIP compress an existing file::" msgstr "" -#: library/gzip.rst:238 +#: library/gzip.rst:240 msgid "Example of how to GZIP compress a binary string::" msgstr "" -#: library/gzip.rst:246 +#: library/gzip.rst:248 msgid "Module :mod:`zlib`" msgstr "" -#: library/gzip.rst:247 +#: library/gzip.rst:249 msgid "" "The basic data compression module needed to support the :program:`gzip` file " "format." msgstr "" -#: library/gzip.rst:256 +#: library/gzip.rst:258 msgid "Command Line Interface" msgstr "" -#: library/gzip.rst:258 +#: library/gzip.rst:260 msgid "" "The :mod:`gzip` module provides a simple command line interface to compress " "or decompress files." msgstr "" -#: library/gzip.rst:261 +#: library/gzip.rst:263 msgid "Once executed the :mod:`gzip` module keeps the input file(s)." msgstr "" -#: library/gzip.rst:265 +#: library/gzip.rst:267 msgid "" "Add a new command line interface with a usage. By default, when you will " "execute the CLI, the default compression level is 6." msgstr "" -#: library/gzip.rst:269 +#: library/gzip.rst:271 msgid "Command line options" msgstr "" -#: library/gzip.rst:273 +#: library/gzip.rst:275 msgid "If *file* is not specified, read from :data:`sys.stdin`." msgstr "" -#: library/gzip.rst:277 +#: library/gzip.rst:279 msgid "Indicates the fastest compression method (less compression)." msgstr "" -#: library/gzip.rst:281 +#: library/gzip.rst:283 msgid "Indicates the slowest compression method (best compression)." msgstr "" -#: library/gzip.rst:285 +#: library/gzip.rst:287 msgid "Decompress the given file." msgstr "" -#: library/gzip.rst:289 +#: library/gzip.rst:291 msgid "Show the help message." msgstr "" diff --git a/library/http.client.po b/library/http.client.po index e6e2daf24..b4cbd5239 100644 --- a/library/http.client.po +++ b/library/http.client.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -438,10 +438,9 @@ msgid "" "already have a connection." msgstr "" -#: library/http.client.rst:415 +#: library/http.client.rst:404 msgid "" -"Raises an :ref:`auditing event ` ``http.client.connect`` with " -"arguments ``self``, ``host``, ``port``." +"Raises an auditing event http.client.connect with arguments self, host, port." msgstr "" #: library/http.client.rst:409 @@ -515,10 +514,8 @@ msgid "" "`endheaders` method has been called and before :meth:`getresponse` is called." msgstr "" -#: library/http.client.rst:485 -msgid "" -"Raises an :ref:`auditing event ` ``http.client.send`` with " -"arguments ``self``, ``data``." +#: library/http.client.rst:474 +msgid "Raises an auditing event http.client.send with arguments self, data." msgstr "" #: library/http.client.rst:480 diff --git a/library/http.server.po b/library/http.server.po index 2f51863df..6629b1745 100644 --- a/library/http.server.po +++ b/library/http.server.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -458,7 +458,7 @@ msgstr "" msgid "" "If the request was mapped to a file, it is opened. Any :exc:`OSError` " "exception in opening the requested file is mapped to a ``404``, ``'File not " -"found'`` error. If there was a ``'If-Modified-Since'`` header in the " +"found'`` error. If there was an ``'If-Modified-Since'`` header in the " "request, and the file was not modified after this time, a ``304``, ``'Not " "Modified'`` response is sent. Otherwise, the content type is guessed by " "calling the :meth:`guess_type` method, which in turn uses the " diff --git a/library/imaplib.po b/library/imaplib.po index 2670607d3..5ca2f3356 100644 --- a/library/imaplib.po +++ b/library/imaplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -415,10 +415,8 @@ msgid "" "You may override this method." msgstr "" -#: library/imaplib.rst:382 -msgid "" -"Raises an :ref:`auditing event ` ``imaplib.open`` with arguments " -"``self``, ``host``, ``port``." +#: library/imaplib.rst:371 +msgid "Raises an auditing event imaplib.open with arguments self, host, port." msgstr "" #: library/imaplib.rst:373 @@ -487,10 +485,8 @@ msgstr "" msgid "Sends ``data`` to the remote server. You may override this method." msgstr "" -#: library/imaplib.rst:455 -msgid "" -"Raises an :ref:`auditing event ` ``imaplib.send`` with arguments " -"``self``, ``data``." +#: library/imaplib.rst:444 +msgid "Raises an auditing event imaplib.send with arguments self, data." msgstr "" #: library/imaplib.rst:449 diff --git a/library/imghdr.po b/library/imghdr.po index 26e193c38..01b7a1706 100644 --- a/library/imghdr.po +++ b/library/imghdr.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/imghdr.py`" msgstr "" -#: library/imghdr.rst:13 +#: library/imghdr.rst:10 msgid "" "The :mod:`imghdr` module is deprecated (see :pep:`PEP 594 <594#imghdr>` for " "details and alternatives)." diff --git a/library/importlib.po b/library/importlib.po index 0c01a64ea..2f89047b4 100644 --- a/library/importlib.po +++ b/library/importlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -866,7 +866,7 @@ msgid "" "shipped within a package. Typically this is something like a data file that " "lives next to the ``__init__.py`` file of the package. The purpose of this " "class is to help abstract out the accessing of such data files so that it " -"does not matter if the package and its data file(s) are stored in a e.g. zip " +"does not matter if the package and its data file(s) are stored e.g. in a zip " "file versus on the file system." msgstr "" @@ -891,7 +891,7 @@ msgid "" "with this ABC should only be returned when the specified module is a package." msgstr "" -#: library/importlib.rst:795 +#: library/importlib.rst:793 msgid "Use :class:`importlib.resources.abc.TraversableResources` instead." msgstr "" @@ -954,7 +954,7 @@ msgid "" "resources.as_file`." msgstr "" -#: library/importlib.rst:737 +#: library/importlib.rst:735 msgid "Use :class:`importlib.resources.abc.Traversable` instead." msgstr "" diff --git a/library/importlib.resources.abc.po b/library/importlib.resources.abc.po index 829707f6e..231937e2e 100644 --- a/library/importlib.resources.abc.po +++ b/library/importlib.resources.abc.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -39,7 +39,7 @@ msgid "" "shipped within a package. Typically this is something like a data file that " "lives next to the ``__init__.py`` file of the package. The purpose of this " "class is to help abstract out the accessing of such data files so that it " -"does not matter if the package and its data file(s) are stored in a e.g. zip " +"does not matter if the package and its data file(s) are stored e.g. in a zip " "file versus on the file system." msgstr "" @@ -64,7 +64,7 @@ msgid "" "with this ABC should only be returned when the specified module is a package." msgstr "" -#: library/importlib.resources.abc.rst:48 +#: library/importlib.resources.abc.rst:46 msgid "Use :class:`importlib.resources.abc.TraversableResources` instead." msgstr "" diff --git a/library/inspect.po b/library/inspect.po index bfde26154..33d7db34a 100644 --- a/library/inspect.po +++ b/library/inspect.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -71,15 +71,16 @@ msgstr "" msgid "class" msgstr "" -#: library/inspect.rst:63 library/inspect.rst:248 +#: library/inspect.rst:63 library/inspect.rst:261 msgid "__doc__" msgstr "" -#: library/inspect.rst:63 library/inspect.rst:248 +#: library/inspect.rst:63 library/inspect.rst:261 msgid "documentation string" msgstr "" -#: library/inspect.rst:65 library/inspect.rst:217 library/inspect.rst:250 +#: library/inspect.rst:65 library/inspect.rst:217 library/inspect.rst:244 +#: library/inspect.rst:263 msgid "__name__" msgstr "" @@ -87,11 +88,13 @@ msgstr "" msgid "name with which this class was defined" msgstr "" -#: library/inspect.rst:68 library/inspect.rst:219 library/inspect.rst:253 +#: library/inspect.rst:68 library/inspect.rst:219 library/inspect.rst:246 +#: library/inspect.rst:266 msgid "__qualname__" msgstr "" -#: library/inspect.rst:68 library/inspect.rst:219 library/inspect.rst:253 +#: library/inspect.rst:68 library/inspect.rst:219 library/inspect.rst:246 +#: library/inspect.rst:266 msgid "qualified name" msgstr "" @@ -129,7 +132,7 @@ msgstr "" msgid "function object containing implementation of method" msgstr "" -#: library/inspect.rst:255 +#: library/inspect.rst:268 msgid "__self__" msgstr "" @@ -245,7 +248,7 @@ msgstr "" msgid "next inner traceback object (called by this level)" msgstr "" -#: library/inspect.rst:221 library/inspect.rst:238 +#: library/inspect.rst:221 library/inspect.rst:251 msgid "frame" msgstr "" @@ -305,7 +308,7 @@ msgstr "" msgid "tracing function for this frame, or ``None``" msgstr "" -#: library/inspect.rst:225 library/inspect.rst:242 +#: library/inspect.rst:225 library/inspect.rst:255 msgid "code" msgstr "" @@ -452,7 +455,7 @@ msgstr "" msgid "generator" msgstr "" -#: library/inspect.rst:231 +#: library/inspect.rst:231 library/inspect.rst:244 msgid "name" msgstr "" @@ -464,7 +467,7 @@ msgstr "" msgid "gi_running" msgstr "" -#: library/inspect.rst:223 +#: library/inspect.rst:240 msgid "is the generator running?" msgstr "" @@ -481,72 +484,92 @@ msgid "object being iterated by ``yield from``, or ``None``" msgstr "" #: library/inspect.rst:231 -msgid "coroutine" +msgid "async generator" msgstr "" #: library/inspect.rst:235 -msgid "cr_await" +msgid "ag_await" msgstr "" -#: library/inspect.rst:235 +#: library/inspect.rst:248 msgid "object being awaited on, or ``None``" msgstr "" #: library/inspect.rst:238 -msgid "cr_frame" +msgid "ag_frame" msgstr "" #: library/inspect.rst:240 +msgid "ag_running" +msgstr "" + +#: library/inspect.rst:242 +msgid "ag_code" +msgstr "" + +#: library/inspect.rst:244 +msgid "coroutine" +msgstr "" + +#: library/inspect.rst:248 +msgid "cr_await" +msgstr "" + +#: library/inspect.rst:251 +msgid "cr_frame" +msgstr "" + +#: library/inspect.rst:253 msgid "cr_running" msgstr "" -#: library/inspect.rst:240 +#: library/inspect.rst:253 msgid "is the coroutine running?" msgstr "" -#: library/inspect.rst:242 +#: library/inspect.rst:255 msgid "cr_code" msgstr "" -#: library/inspect.rst:244 +#: library/inspect.rst:257 msgid "cr_origin" msgstr "" -#: library/inspect.rst:244 +#: library/inspect.rst:257 msgid "where coroutine was created, or ``None``. See |coroutine-origin-link|" msgstr "" -#: library/inspect.rst:248 +#: library/inspect.rst:261 msgid "builtin" msgstr "" -#: library/inspect.rst:250 +#: library/inspect.rst:263 msgid "original name of this function or method" msgstr "" -#: library/inspect.rst:255 +#: library/inspect.rst:268 msgid "instance to which a method is bound, or ``None``" msgstr "" -#: library/inspect.rst:262 +#: library/inspect.rst:275 msgid "Add ``__qualname__`` and ``gi_yieldfrom`` attributes to generators." msgstr "" -#: library/inspect.rst:264 +#: library/inspect.rst:277 msgid "" "The ``__name__`` attribute of generators is now set from the function name, " "instead of the code name, and it can now be modified." msgstr "" -#: library/inspect.rst:269 +#: library/inspect.rst:282 msgid "Add ``cr_origin`` attribute to coroutines." msgstr "" -#: library/inspect.rst:273 +#: library/inspect.rst:286 msgid "Add ``__builtins__`` attribute to functions." msgstr "" -#: library/inspect.rst:277 +#: library/inspect.rst:290 msgid "" "Return all the members of an object in a list of ``(name, value)`` pairs " "sorted by name. If the optional *predicate* argument—which will be called " @@ -554,14 +577,14 @@ msgid "" "the predicate returns a true value are included." msgstr "" -#: library/inspect.rst:284 +#: library/inspect.rst:297 msgid "" ":func:`getmembers` will only return class attributes defined in the " "metaclass when the argument is a class and those attributes have been listed " "in the metaclass' custom :meth:`~object.__dir__`." msgstr "" -#: library/inspect.rst:291 +#: library/inspect.rst:304 msgid "" "Return all the members of an object in a list of ``(name, value)`` pairs " "sorted by name without triggering dynamic lookup via the descriptor " @@ -569,7 +592,7 @@ msgid "" "that satisfy a given predicate." msgstr "" -#: library/inspect.rst:298 +#: library/inspect.rst:311 msgid "" ":func:`getmembers_static` may not be able to retrieve all members that " "getmembers can fetch (like dynamically created attributes) and may find " @@ -578,7 +601,7 @@ msgid "" "cases." msgstr "" -#: library/inspect.rst:309 +#: library/inspect.rst:322 msgid "" "Return the name of the module named by the file *path*, without including " "the names of enclosing packages. The file extension is checked against all " @@ -587,52 +610,52 @@ msgid "" "``None`` is returned." msgstr "" -#: library/inspect.rst:315 +#: library/inspect.rst:328 msgid "" "Note that this function *only* returns a meaningful name for actual Python " "modules - paths that potentially refer to Python packages will still return " "``None``." msgstr "" -#: library/inspect.rst:319 +#: library/inspect.rst:332 msgid "The function is based directly on :mod:`importlib`." msgstr "" -#: library/inspect.rst:325 +#: library/inspect.rst:338 msgid "Return ``True`` if the object is a module." msgstr "" -#: library/inspect.rst:330 +#: library/inspect.rst:343 msgid "" "Return ``True`` if the object is a class, whether built-in or created in " "Python code." msgstr "" -#: library/inspect.rst:336 +#: library/inspect.rst:349 msgid "Return ``True`` if the object is a bound method written in Python." msgstr "" -#: library/inspect.rst:341 +#: library/inspect.rst:354 msgid "" "Return ``True`` if the object is a Python function, which includes functions " "created by a :term:`lambda` expression." msgstr "" -#: library/inspect.rst:347 +#: library/inspect.rst:360 msgid "Return ``True`` if the object is a Python generator function." msgstr "" -#: library/inspect.rst:349 +#: library/inspect.rst:362 msgid "" "Functions wrapped in :func:`functools.partial` now return ``True`` if the " "wrapped function is a Python generator function." msgstr "" -#: library/inspect.rst:356 +#: library/inspect.rst:369 msgid "Return ``True`` if the object is a generator." msgstr "" -#: library/inspect.rst:361 +#: library/inspect.rst:374 msgid "" "Return ``True`` if the object is a :term:`coroutine function` (a function " "defined with an :keyword:`async def` syntax), a :func:`functools.partial` " @@ -640,118 +663,118 @@ msgid "" "`markcoroutinefunction`." msgstr "" -#: library/inspect.rst:368 +#: library/inspect.rst:381 msgid "" "Functions wrapped in :func:`functools.partial` now return ``True`` if the " "wrapped function is a :term:`coroutine function`." msgstr "" -#: library/inspect.rst:372 +#: library/inspect.rst:385 msgid "" "Sync functions marked with :func:`markcoroutinefunction` now return ``True``." msgstr "" -#: library/inspect.rst:379 +#: library/inspect.rst:392 msgid "" "Decorator to mark a callable as a :term:`coroutine function` if it would not " "otherwise be detected by :func:`iscoroutinefunction`." msgstr "" -#: library/inspect.rst:382 +#: library/inspect.rst:395 msgid "" "This may be of use for sync functions that return a :term:`coroutine`, if " "the function is passed to an API that requires :func:`iscoroutinefunction`." msgstr "" -#: library/inspect.rst:385 +#: library/inspect.rst:398 msgid "" "When possible, using an :keyword:`async def` function is preferred. Also " "acceptable is calling the function and testing the return with :func:" "`iscoroutine`." msgstr "" -#: library/inspect.rst:394 +#: library/inspect.rst:407 msgid "" "Return ``True`` if the object is a :term:`coroutine` created by an :keyword:" "`async def` function." msgstr "" -#: library/inspect.rst:402 +#: library/inspect.rst:415 msgid "" "Return ``True`` if the object can be used in :keyword:`await` expression." msgstr "" -#: library/inspect.rst:404 +#: library/inspect.rst:417 msgid "" "Can also be used to distinguish generator-based coroutines from regular " "generators:" msgstr "" -#: library/inspect.rst:425 +#: library/inspect.rst:438 msgid "" "Return ``True`` if the object is an :term:`asynchronous generator` function, " "for example:" msgstr "" -#: library/inspect.rst:438 +#: library/inspect.rst:451 msgid "" "Functions wrapped in :func:`functools.partial` now return ``True`` if the " -"wrapped function is a :term:`asynchronous generator` function." +"wrapped function is an :term:`asynchronous generator` function." msgstr "" -#: library/inspect.rst:445 +#: library/inspect.rst:458 msgid "" "Return ``True`` if the object is an :term:`asynchronous generator iterator` " "created by an :term:`asynchronous generator` function." msgstr "" -#: library/inspect.rst:452 +#: library/inspect.rst:465 msgid "Return ``True`` if the object is a traceback." msgstr "" -#: library/inspect.rst:457 +#: library/inspect.rst:470 msgid "Return ``True`` if the object is a frame." msgstr "" -#: library/inspect.rst:462 +#: library/inspect.rst:475 msgid "Return ``True`` if the object is a code." msgstr "" -#: library/inspect.rst:467 +#: library/inspect.rst:480 msgid "" "Return ``True`` if the object is a built-in function or a bound built-in " "method." msgstr "" -#: library/inspect.rst:472 +#: library/inspect.rst:485 msgid "" "Return ``True`` if the type of object is a :class:`~types.MethodWrapperType`." msgstr "" -#: library/inspect.rst:474 +#: library/inspect.rst:487 msgid "" "These are instances of :class:`~types.MethodWrapperType`, such as :meth:" "`~object.__str__`, :meth:`~object.__eq__` and :meth:`~object.__repr__`." msgstr "" -#: library/inspect.rst:482 +#: library/inspect.rst:495 msgid "" "Return ``True`` if the object is a user-defined or built-in function or " "method." msgstr "" -#: library/inspect.rst:487 +#: library/inspect.rst:500 msgid "Return ``True`` if the object is an abstract base class." msgstr "" -#: library/inspect.rst:492 +#: library/inspect.rst:505 msgid "" "Return ``True`` if the object is a method descriptor, but not if :func:" "`ismethod`, :func:`isclass`, :func:`isfunction` or :func:`isbuiltin` are " "true." msgstr "" -#: library/inspect.rst:496 +#: library/inspect.rst:509 msgid "" "This, for example, is true of ``int.__add__``. An object passing this test " "has a :meth:`~object.__get__` method but not a :meth:`~object.__set__` " @@ -759,7 +782,7 @@ msgid "" "__name__` attribute is usually sensible, and :attr:`!__doc__` often is." msgstr "" -#: library/inspect.rst:502 +#: library/inspect.rst:515 msgid "" "Methods implemented via descriptors that also pass one of the other tests " "return ``False`` from the :func:`ismethoddescriptor` test, simply because " @@ -767,11 +790,11 @@ msgid "" "`~method.__func__` attribute (etc) when an object passes :func:`ismethod`." msgstr "" -#: library/inspect.rst:511 +#: library/inspect.rst:524 msgid "Return ``True`` if the object is a data descriptor." msgstr "" -#: library/inspect.rst:513 +#: library/inspect.rst:526 msgid "" "Data descriptors have a :attr:`~object.__set__` or a :attr:`~object." "__delete__` method. Examples are properties (defined in Python), getsets, " @@ -782,33 +805,33 @@ msgid "" "and members have both of these attributes), but this is not guaranteed." msgstr "" -#: library/inspect.rst:524 +#: library/inspect.rst:537 msgid "Return ``True`` if the object is a getset descriptor." msgstr "" -#: library/inspect.rst:528 +#: library/inspect.rst:541 msgid "" "getsets are attributes defined in extension modules via :c:type:" "`PyGetSetDef` structures. For Python implementations without such types, " "this method will always return ``False``." msgstr "" -#: library/inspect.rst:535 +#: library/inspect.rst:548 msgid "Return ``True`` if the object is a member descriptor." msgstr "" -#: library/inspect.rst:539 +#: library/inspect.rst:552 msgid "" "Member descriptors are attributes defined in extension modules via :c:type:" "`PyMemberDef` structures. For Python implementations without such types, " "this method will always return ``False``." msgstr "" -#: library/inspect.rst:547 +#: library/inspect.rst:560 msgid "Retrieving source code" msgstr "" -#: library/inspect.rst:551 +#: library/inspect.rst:564 msgid "" "Get the documentation string for an object, cleaned up with :func:" "`cleandoc`. If the documentation string for an object is not provided and " @@ -817,11 +840,11 @@ msgid "" "documentation string is invalid or missing." msgstr "" -#: library/inspect.rst:557 +#: library/inspect.rst:570 msgid "Documentation strings are now inherited if not overridden." msgstr "" -#: library/inspect.rst:563 +#: library/inspect.rst:576 msgid "" "Return in a single string any lines of comments immediately preceding the " "object's source code (for a class, function, or method), or at the top of " @@ -830,27 +853,27 @@ msgid "" "been defined in C or the interactive shell." msgstr "" -#: library/inspect.rst:572 +#: library/inspect.rst:585 msgid "" "Return the name of the (text or binary) file in which an object was defined. " "This will fail with a :exc:`TypeError` if the object is a built-in module, " "class, or function." msgstr "" -#: library/inspect.rst:579 +#: library/inspect.rst:592 msgid "" "Try to guess which module an object was defined in. Return ``None`` if the " "module cannot be determined." msgstr "" -#: library/inspect.rst:585 +#: library/inspect.rst:598 msgid "" "Return the name of the Python source file in which an object was defined or " "``None`` if no way can be identified to get the source. This will fail with " "a :exc:`TypeError` if the object is a built-in module, class, or function." msgstr "" -#: library/inspect.rst:593 +#: library/inspect.rst:606 msgid "" "Return a list of source lines and starting line number for an object. The " "argument may be a module, class, method, function, traceback, frame, or code " @@ -861,13 +884,13 @@ msgid "" "built-in module, class, or function." msgstr "" -#: library/inspect.rst:616 +#: library/inspect.rst:629 msgid "" ":exc:`OSError` is raised instead of :exc:`IOError`, now an alias of the " "former." msgstr "" -#: library/inspect.rst:609 +#: library/inspect.rst:622 msgid "" "Return the text of the source code for an object. The argument may be a " "module, class, method, function, traceback, frame, or code object. The " @@ -876,13 +899,13 @@ msgid "" "object is a built-in module, class, or function." msgstr "" -#: library/inspect.rst:623 +#: library/inspect.rst:636 msgid "" "Clean up indentation from docstrings that are indented to line up with " "blocks of code." msgstr "" -#: library/inspect.rst:626 +#: library/inspect.rst:639 msgid "" "All leading whitespace is removed from the first line. Any leading " "whitespace that can be uniformly removed from the second line onwards is " @@ -890,28 +913,28 @@ msgid "" "Also, all tabs are expanded to spaces." msgstr "" -#: library/inspect.rst:635 +#: library/inspect.rst:648 msgid "Introspecting callables with the Signature object" msgstr "" -#: library/inspect.rst:639 +#: library/inspect.rst:652 msgid "" "The :class:`Signature` object represents the call signature of a callable " "object and its return annotation. To retrieve a :class:`!Signature` object, " "use the :func:`!signature` function." msgstr "" -#: library/inspect.rst:646 +#: library/inspect.rst:659 msgid "Return a :class:`Signature` object for the given *callable*:" msgstr "" -#: library/inspect.rst:665 +#: library/inspect.rst:678 msgid "" "Accepts a wide range of Python callables, from plain functions and classes " "to :func:`functools.partial` objects." msgstr "" -#: library/inspect.rst:668 +#: library/inspect.rst:681 msgid "" "For objects defined in modules using stringized annotations (``from " "__future__ import annotations``), :func:`signature` will attempt to " @@ -921,7 +944,7 @@ msgid "" "func:`get_annotations` for instructions on how to use these parameters." msgstr "" -#: library/inspect.rst:677 +#: library/inspect.rst:690 msgid "" "Raises :exc:`ValueError` if no signature can be provided, and :exc:" "`TypeError` if that type of object is not supported. Also, if the " @@ -930,32 +953,32 @@ msgid "" "potentially raise any kind of exception." msgstr "" -#: library/inspect.rst:683 +#: library/inspect.rst:696 msgid "" "A slash(/) in the signature of a function denotes that the parameters prior " "to it are positional-only. For more info, see :ref:`the FAQ entry on " "positional-only parameters `." msgstr "" -#: library/inspect.rst:687 +#: library/inspect.rst:700 msgid "" "The *follow_wrapped* parameter was added. Pass ``False`` to get a signature " "of *callable* specifically (``callable.__wrapped__`` will not be used to " "unwrap decorated callables.)" msgstr "" -#: library/inspect.rst:803 +#: library/inspect.rst:816 msgid "The *globals*, *locals*, and *eval_str* parameters were added." msgstr "" -#: library/inspect.rst:698 +#: library/inspect.rst:711 msgid "" "Some callables may not be introspectable in certain implementations of " "Python. For example, in CPython, some built-in functions defined in C " "provide no metadata about their arguments." msgstr "" -#: library/inspect.rst:704 +#: library/inspect.rst:717 msgid "" "If the passed object has a :attr:`!__signature__` attribute, we may use it " "to create the signature. The exact semantics are an implementation detail " @@ -963,14 +986,14 @@ msgid "" "semantics." msgstr "" -#: library/inspect.rst:712 +#: library/inspect.rst:725 msgid "" "A :class:`!Signature` object represents the call signature of a function and " "its return annotation. For each parameter accepted by the function it " "stores a :class:`Parameter` object in its :attr:`parameters` collection." msgstr "" -#: library/inspect.rst:717 +#: library/inspect.rst:730 msgid "" "The optional *parameters* argument is a sequence of :class:`Parameter` " "objects, which is validated to check that there are no parameters with " @@ -979,54 +1002,54 @@ msgid "" "defaults follow parameters without defaults." msgstr "" -#: library/inspect.rst:723 +#: library/inspect.rst:736 msgid "" "The optional *return_annotation* argument can be an arbitrary Python object. " "It represents the \"return\" annotation of the callable." msgstr "" -#: library/inspect.rst:726 +#: library/inspect.rst:739 msgid "" ":class:`!Signature` objects are *immutable*. Use :meth:`Signature.replace` " "to make a modified copy." msgstr "" -#: library/inspect.rst:729 +#: library/inspect.rst:742 msgid ":class:`!Signature` objects are now picklable and :term:`hashable`." msgstr "" -#: library/inspect.rst:734 +#: library/inspect.rst:747 msgid "A special class-level marker to specify absence of a return annotation." msgstr "" -#: library/inspect.rst:738 +#: library/inspect.rst:751 msgid "" "An ordered mapping of parameters' names to the corresponding :class:" "`Parameter` objects. Parameters appear in strict definition order, " "including keyword-only parameters." msgstr "" -#: library/inspect.rst:1079 +#: library/inspect.rst:1092 msgid "" "Python only explicitly guaranteed that it preserved the declaration order of " "keyword-only parameters as of version 3.7, although in practice this order " "had always been preserved in Python 3." msgstr "" -#: library/inspect.rst:749 +#: library/inspect.rst:762 msgid "" "The \"return\" annotation for the callable. If the callable has no " "\"return\" annotation, this attribute is set to :attr:`Signature.empty`." msgstr "" -#: library/inspect.rst:754 +#: library/inspect.rst:767 msgid "" "Create a mapping from positional and keyword arguments to parameters. " "Returns :class:`BoundArguments` if ``*args`` and ``**kwargs`` match the " "signature, or raises a :exc:`TypeError`." msgstr "" -#: library/inspect.rst:760 +#: library/inspect.rst:773 msgid "" "Works the same way as :meth:`Signature.bind`, but allows the omission of " "some required arguments (mimics :func:`functools.partial` behavior.) " @@ -1034,7 +1057,7 @@ msgid "" "arguments do not match the signature." msgstr "" -#: library/inspect.rst:767 +#: library/inspect.rst:780 msgid "" "Create a new :class:`Signature` instance based on the instance :meth:" "`replace` was invoked on. It is possible to pass different *parameters* and/" @@ -1043,147 +1066,147 @@ msgid "" "Signature`, pass in :attr:`Signature.empty`." msgstr "" -#: library/inspect.rst:787 +#: library/inspect.rst:800 msgid "" "Return a :class:`Signature` (or its subclass) object for a given callable " "*obj*." msgstr "" -#: library/inspect.rst:790 +#: library/inspect.rst:803 msgid "This method simplifies subclassing of :class:`Signature`:" msgstr "" -#: library/inspect.rst:799 +#: library/inspect.rst:812 msgid "Its behavior is otherwise identical to that of :func:`signature`." msgstr "" -#: library/inspect.rst:809 +#: library/inspect.rst:822 msgid "" ":class:`!Parameter` objects are *immutable*. Instead of modifying a :class:`!" "Parameter` object, you can use :meth:`Parameter.replace` to create a " "modified copy." msgstr "" -#: library/inspect.rst:813 +#: library/inspect.rst:826 msgid "Parameter objects are now picklable and :term:`hashable`." msgstr "" -#: library/inspect.rst:818 +#: library/inspect.rst:831 msgid "" "A special class-level marker to specify absence of default values and " "annotations." msgstr "" -#: library/inspect.rst:823 +#: library/inspect.rst:836 msgid "" "The name of the parameter as a string. The name must be a valid Python " "identifier." msgstr "" -#: library/inspect.rst:828 +#: library/inspect.rst:841 msgid "" "CPython generates implicit parameter names of the form ``.0`` on the code " "objects used to implement comprehensions and generator expressions." msgstr "" -#: library/inspect.rst:832 +#: library/inspect.rst:845 msgid "" "These parameter names are now exposed by this module as names like " "``implicit0``." msgstr "" -#: library/inspect.rst:838 +#: library/inspect.rst:851 msgid "" "The default value for the parameter. If the parameter has no default value, " "this attribute is set to :attr:`Parameter.empty`." msgstr "" -#: library/inspect.rst:843 +#: library/inspect.rst:856 msgid "" "The annotation for the parameter. If the parameter has no annotation, this " "attribute is set to :attr:`Parameter.empty`." msgstr "" -#: library/inspect.rst:848 +#: library/inspect.rst:861 msgid "" "Describes how argument values are bound to the parameter. The possible " "values are accessible via :class:`Parameter` (like ``Parameter." "KEYWORD_ONLY``), and support comparison and ordering, in the following order:" msgstr "" -#: library/inspect.rst:855 +#: library/inspect.rst:868 msgid "Name" msgstr "" -#: library/inspect.rst:855 +#: library/inspect.rst:868 msgid "Meaning" msgstr "" -#: library/inspect.rst:857 +#: library/inspect.rst:870 msgid "*POSITIONAL_ONLY*" msgstr "" -#: library/inspect.rst:857 +#: library/inspect.rst:870 msgid "" "Value must be supplied as a positional argument. Positional only parameters " "are those which appear before a ``/`` entry (if present) in a Python " "function definition." msgstr "" -#: library/inspect.rst:862 +#: library/inspect.rst:875 msgid "*POSITIONAL_OR_KEYWORD*" msgstr "" -#: library/inspect.rst:862 +#: library/inspect.rst:875 msgid "" "Value may be supplied as either a keyword or positional argument (this is " "the standard binding behaviour for functions implemented in Python.)" msgstr "" -#: library/inspect.rst:867 +#: library/inspect.rst:880 msgid "*VAR_POSITIONAL*" msgstr "" -#: library/inspect.rst:867 +#: library/inspect.rst:880 msgid "" "A tuple of positional arguments that aren't bound to any other parameter. " "This corresponds to a ``*args`` parameter in a Python function definition." msgstr "" -#: library/inspect.rst:872 +#: library/inspect.rst:885 msgid "*KEYWORD_ONLY*" msgstr "" -#: library/inspect.rst:872 +#: library/inspect.rst:885 msgid "" "Value must be supplied as a keyword argument. Keyword only parameters are " "those which appear after a ``*`` or ``*args`` entry in a Python function " "definition." msgstr "" -#: library/inspect.rst:877 +#: library/inspect.rst:890 msgid "*VAR_KEYWORD*" msgstr "" -#: library/inspect.rst:877 +#: library/inspect.rst:890 msgid "" "A dict of keyword arguments that aren't bound to any other parameter. This " "corresponds to a ``**kwargs`` parameter in a Python function definition." msgstr "" -#: library/inspect.rst:883 +#: library/inspect.rst:896 msgid "Example: print all keyword-only arguments without default values:" msgstr "" -#: library/inspect.rst:899 -msgid "Describes a enum value of :attr:`Parameter.kind`." +#: library/inspect.rst:912 +msgid "Describes an enum value of :attr:`Parameter.kind`." msgstr "" -#: library/inspect.rst:903 +#: library/inspect.rst:916 msgid "Example: print all descriptions of arguments:" msgstr "" -#: library/inspect.rst:920 +#: library/inspect.rst:933 msgid "" "Create a new :class:`Parameter` instance based on the instance replaced was " "invoked on. To override a :class:`!Parameter` attribute, pass the " @@ -1191,94 +1214,94 @@ msgid "" "a :class:`!Parameter`, pass :attr:`Parameter.empty`." msgstr "" -#: library/inspect.rst:938 +#: library/inspect.rst:951 msgid "" "In Python 3.3 :class:`Parameter` objects were allowed to have ``name`` set " "to ``None`` if their ``kind`` was set to ``POSITIONAL_ONLY``. This is no " "longer permitted." msgstr "" -#: library/inspect.rst:945 +#: library/inspect.rst:958 msgid "" "Result of a :meth:`Signature.bind` or :meth:`Signature.bind_partial` call. " "Holds the mapping of arguments to the function's parameters." msgstr "" -#: library/inspect.rst:950 +#: library/inspect.rst:963 msgid "" "A mutable mapping of parameters' names to arguments' values. Contains only " "explicitly bound arguments. Changes in :attr:`arguments` will reflect in :" "attr:`args` and :attr:`kwargs`." msgstr "" -#: library/inspect.rst:954 +#: library/inspect.rst:967 msgid "" "Should be used in conjunction with :attr:`Signature.parameters` for any " "argument processing purposes." msgstr "" -#: library/inspect.rst:959 +#: library/inspect.rst:972 msgid "" "Arguments for which :meth:`Signature.bind` or :meth:`Signature.bind_partial` " "relied on a default value are skipped. However, if needed, use :meth:" "`BoundArguments.apply_defaults` to add them." msgstr "" -#: library/inspect.rst:964 +#: library/inspect.rst:977 msgid "" ":attr:`arguments` is now of type :class:`dict`. Formerly, it was of type :" "class:`collections.OrderedDict`." msgstr "" -#: library/inspect.rst:970 +#: library/inspect.rst:983 msgid "" "A tuple of positional arguments values. Dynamically computed from the :attr:" "`arguments` attribute." msgstr "" -#: library/inspect.rst:975 +#: library/inspect.rst:988 msgid "" "A dict of keyword arguments values. Dynamically computed from the :attr:" "`arguments` attribute." msgstr "" -#: library/inspect.rst:980 +#: library/inspect.rst:993 msgid "A reference to the parent :class:`Signature` object." msgstr "" -#: library/inspect.rst:984 +#: library/inspect.rst:997 msgid "Set default values for missing arguments." msgstr "" -#: library/inspect.rst:986 +#: library/inspect.rst:999 msgid "" "For variable-positional arguments (``*args``) the default is an empty tuple." msgstr "" -#: library/inspect.rst:989 +#: library/inspect.rst:1002 msgid "" "For variable-keyword arguments (``**kwargs``) the default is an empty dict." msgstr "" -#: library/inspect.rst:1002 +#: library/inspect.rst:1015 msgid "" "The :attr:`args` and :attr:`kwargs` properties can be used to invoke " "functions:" msgstr "" -#: library/inspect.rst:1017 +#: library/inspect.rst:1030 msgid ":pep:`362` - Function Signature Object." msgstr "" -#: library/inspect.rst:1018 +#: library/inspect.rst:1031 msgid "The detailed specification, implementation details and examples." msgstr "" -#: library/inspect.rst:1024 +#: library/inspect.rst:1037 msgid "Classes and functions" msgstr "" -#: library/inspect.rst:1028 +#: library/inspect.rst:1041 msgid "" "Arrange the given list of classes into a hierarchy of nested lists. Where a " "nested list appears, it contains classes derived from the class whose entry " @@ -1289,19 +1312,19 @@ msgid "" "will appear multiple times." msgstr "" -#: library/inspect.rst:1039 +#: library/inspect.rst:1052 msgid "" "Get the names and default values of a Python function's parameters. A :term:" "`named tuple` is returned:" msgstr "" -#: library/inspect.rst:1042 +#: library/inspect.rst:1055 msgid "" "``FullArgSpec(args, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, " "annotations)``" msgstr "" -#: library/inspect.rst:1045 +#: library/inspect.rst:1058 msgid "" "*args* is a list of the positional parameter names. *varargs* is the name of " "the ``*`` parameter or ``None`` if arbitrary positional arguments are not " @@ -1316,7 +1339,7 @@ msgid "" "report the function return value annotation (if any)." msgstr "" -#: library/inspect.rst:1060 +#: library/inspect.rst:1073 msgid "" "Note that :func:`signature` and :ref:`Signature Object ` provide the recommended API for callable introspection, and support " @@ -1326,14 +1349,14 @@ msgid "" "``inspect`` module API." msgstr "" -#: library/inspect.rst:1067 +#: library/inspect.rst:1080 msgid "" "This function is now based on :func:`signature`, but still ignores " "``__wrapped__`` attributes and includes the already bound first parameter in " "the signature output for bound methods." msgstr "" -#: library/inspect.rst:1072 +#: library/inspect.rst:1085 msgid "" "This method was previously documented as deprecated in favour of :func:" "`signature` in Python 3.5, but that decision has been reversed in order to " @@ -1341,7 +1364,7 @@ msgid "" "code migrating away from the legacy :func:`getargspec` API." msgstr "" -#: library/inspect.rst:1087 +#: library/inspect.rst:1100 msgid "" "Get information about arguments passed into a particular frame. A :term:" "`named tuple` ``ArgInfo(args, varargs, keywords, locals)`` is returned. " @@ -1350,18 +1373,18 @@ msgid "" "dictionary of the given frame." msgstr "" -#: library/inspect.rst:1104 +#: library/inspect.rst:1117 msgid "This function was inadvertently marked as deprecated in Python 3.5." msgstr "" -#: library/inspect.rst:1099 +#: library/inspect.rst:1112 msgid "" "Format a pretty argument spec from the four values returned by :func:" "`getargvalues`. The format\\* arguments are the corresponding optional " "formatting functions that are called to turn names and values into strings." msgstr "" -#: library/inspect.rst:1109 +#: library/inspect.rst:1122 msgid "" "Return a tuple of class cls's base classes, including cls, in method " "resolution order. No class appears more than once in this tuple. Note that " @@ -1369,7 +1392,7 @@ msgid "" "user-defined metatype is in use, cls will be the first element of the tuple." msgstr "" -#: library/inspect.rst:1117 +#: library/inspect.rst:1130 msgid "" "Bind the *args* and *kwds* to the argument names of the Python function or " "method *func*, as if it was called with them. For bound methods, bind also " @@ -1382,11 +1405,11 @@ msgid "" "example:" msgstr "" -#: library/inspect.rst:1143 +#: library/inspect.rst:1156 msgid "Use :meth:`Signature.bind` and :meth:`Signature.bind_partial` instead." msgstr "" -#: library/inspect.rst:1149 +#: library/inspect.rst:1162 msgid "" "Get the mapping of external name references in a Python function or method " "*func* to their current values. A :term:`named tuple` " @@ -1398,18 +1421,18 @@ msgid "" "builtins." msgstr "" -#: library/inspect.rst:1158 +#: library/inspect.rst:1171 msgid "" ":exc:`TypeError` is raised if *func* is not a Python function or method." msgstr "" -#: library/inspect.rst:1165 +#: library/inspect.rst:1178 msgid "" "Get the object wrapped by *func*. It follows the chain of :attr:" "`__wrapped__` attributes returning the last object in the chain." msgstr "" -#: library/inspect.rst:1168 +#: library/inspect.rst:1181 msgid "" "*stop* is an optional callback accepting an object in the wrapper chain as " "its sole argument that allows the unwrapping to be terminated early if the " @@ -1419,68 +1442,68 @@ msgid "" "``__signature__`` attribute defined." msgstr "" -#: library/inspect.rst:1175 +#: library/inspect.rst:1188 msgid ":exc:`ValueError` is raised if a cycle is encountered." msgstr "" -#: library/inspect.rst:1182 +#: library/inspect.rst:1195 msgid "Compute the annotations dict for an object." msgstr "" -#: library/inspect.rst:1184 +#: library/inspect.rst:1197 msgid "" "``obj`` may be a callable, class, or module. Passing in an object of any " "other type raises :exc:`TypeError`." msgstr "" -#: library/inspect.rst:1187 +#: library/inspect.rst:1200 msgid "" "Returns a dict. ``get_annotations()`` returns a new dict every time it's " "called; calling it twice on the same object will return two different but " "equivalent dicts." msgstr "" -#: library/inspect.rst:1191 +#: library/inspect.rst:1204 msgid "This function handles several details for you:" msgstr "" -#: library/inspect.rst:1193 +#: library/inspect.rst:1206 msgid "" "If ``eval_str`` is true, values of type ``str`` will be un-stringized using :" "func:`eval()`. This is intended for use with stringized annotations (``from " "__future__ import annotations``)." msgstr "" -#: library/inspect.rst:1197 +#: library/inspect.rst:1210 msgid "" "If ``obj`` doesn't have an annotations dict, returns an empty dict. " "(Functions and methods always have an annotations dict; classes, modules, " "and other types of callables may not.)" msgstr "" -#: library/inspect.rst:1201 +#: library/inspect.rst:1214 msgid "" "Ignores inherited annotations on classes. If a class doesn't have its own " "annotations dict, returns an empty dict." msgstr "" -#: library/inspect.rst:1203 +#: library/inspect.rst:1216 msgid "" "All accesses to object members and dict values are done using ``getattr()`` " "and ``dict.get()`` for safety." msgstr "" -#: library/inspect.rst:1205 +#: library/inspect.rst:1218 msgid "Always, always, always returns a freshly created dict." msgstr "" -#: library/inspect.rst:1207 +#: library/inspect.rst:1220 msgid "" "``eval_str`` controls whether or not values of type ``str`` are replaced " "with the result of calling :func:`eval()` on those values:" msgstr "" -#: library/inspect.rst:1210 +#: library/inspect.rst:1223 msgid "" "If eval_str is true, :func:`eval()` is called on values of type ``str``. " "(Note that ``get_annotations`` doesn't catch exceptions; if :func:`eval()` " @@ -1488,12 +1511,12 @@ msgid "" "call.)" msgstr "" -#: library/inspect.rst:1214 +#: library/inspect.rst:1227 msgid "" "If eval_str is false (the default), values of type ``str`` are unchanged." msgstr "" -#: library/inspect.rst:1216 +#: library/inspect.rst:1229 msgid "" "``globals`` and ``locals`` are passed in to :func:`eval()`; see the " "documentation for :func:`eval()` for more information. If ``globals`` or " @@ -1501,35 +1524,35 @@ msgid "" "specific default, contingent on ``type(obj)``:" msgstr "" -#: library/inspect.rst:1221 +#: library/inspect.rst:1234 msgid "If ``obj`` is a module, ``globals`` defaults to ``obj.__dict__``." msgstr "" -#: library/inspect.rst:1222 +#: library/inspect.rst:1235 msgid "" "If ``obj`` is a class, ``globals`` defaults to ``sys.modules[obj.__module__]." "__dict__`` and ``locals`` defaults to the ``obj`` class namespace." msgstr "" -#: library/inspect.rst:1225 +#: library/inspect.rst:1238 msgid "" "If ``obj`` is a callable, ``globals`` defaults to :attr:`obj.__globals__ " "`, although if ``obj`` is a wrapped function (using :" "func:`functools.update_wrapper`) it is first unwrapped." msgstr "" -#: library/inspect.rst:1230 +#: library/inspect.rst:1243 msgid "" "Calling ``get_annotations`` is best practice for accessing the annotations " "dict of any object. See :ref:`annotations-howto` for more information on " "annotations best practices." msgstr "" -#: library/inspect.rst:1240 +#: library/inspect.rst:1253 msgid "The interpreter stack" msgstr "" -#: library/inspect.rst:1242 +#: library/inspect.rst:1255 msgid "" "Some of the following functions return :class:`FrameInfo` objects. For " "backwards compatibility these objects allow tuple-like operations on all " @@ -1537,95 +1560,95 @@ msgid "" "may be removed in the future." msgstr "" -#: library/inspect.rst:1251 +#: library/inspect.rst:1264 msgid "The :ref:`frame object ` that the record corresponds to." msgstr "" -#: library/inspect.rst:1255 +#: library/inspect.rst:1268 msgid "" "The file name associated with the code being executed by the frame this " "record corresponds to." msgstr "" -#: library/inspect.rst:1260 +#: library/inspect.rst:1273 msgid "" "The line number of the current line associated with the code being executed " "by the frame this record corresponds to." msgstr "" -#: library/inspect.rst:1265 +#: library/inspect.rst:1278 msgid "" "The function name that is being executed by the frame this record " "corresponds to." msgstr "" -#: library/inspect.rst:1269 +#: library/inspect.rst:1282 msgid "" "A list of lines of context from the source code that's being executed by the " "frame this record corresponds to." msgstr "" -#: library/inspect.rst:1313 +#: library/inspect.rst:1326 msgid "" "The index of the current line being executed in the :attr:`code_context` " "list." msgstr "" -#: library/inspect.rst:1278 +#: library/inspect.rst:1291 msgid "" "A :class:`dis.Positions` object containing the start line number, end line " "number, start column offset, and end column offset associated with the " "instruction being executed by the frame this record corresponds to." msgstr "" -#: library/inspect.rst:1282 +#: library/inspect.rst:1295 msgid "Return a :term:`named tuple` instead of a :class:`tuple`." msgstr "" -#: library/inspect.rst:1285 +#: library/inspect.rst:1298 msgid "" ":class:`!FrameInfo` is now a class instance (that is backwards compatible " "with the previous :term:`named tuple`)." msgstr "" -#: library/inspect.rst:1294 +#: library/inspect.rst:1307 msgid "" "The file name associated with the code being executed by the frame this " "traceback corresponds to." msgstr "" -#: library/inspect.rst:1299 +#: library/inspect.rst:1312 msgid "" "The line number of the current line associated with the code being executed " "by the frame this traceback corresponds to." msgstr "" -#: library/inspect.rst:1304 +#: library/inspect.rst:1317 msgid "" "The function name that is being executed by the frame this traceback " "corresponds to." msgstr "" -#: library/inspect.rst:1308 +#: library/inspect.rst:1321 msgid "" "A list of lines of context from the source code that's being executed by the " "frame this traceback corresponds to." msgstr "" -#: library/inspect.rst:1317 +#: library/inspect.rst:1330 msgid "" "A :class:`dis.Positions` object containing the start line number, end line " "number, start column offset, and end column offset associated with the " "instruction being executed by the frame this traceback corresponds to." msgstr "" -#: library/inspect.rst:1322 +#: library/inspect.rst:1335 msgid "" ":class:`!Traceback` is now a class instance (that is backwards compatible " "with the previous :term:`named tuple`)." msgstr "" -#: library/inspect.rst:1329 +#: library/inspect.rst:1342 msgid "" "Keeping references to frame objects, as found in the first element of the " "frame records these functions return, can cause your program to create " @@ -1637,7 +1660,7 @@ msgid "" "consumption which occurs." msgstr "" -#: library/inspect.rst:1337 +#: library/inspect.rst:1350 msgid "" "Though the cycle detector will catch these, destruction of the frames (and " "local variables) can be made deterministic by removing the cycle in a :" @@ -1645,31 +1668,31 @@ msgid "" "disabled when Python was compiled or using :func:`gc.disable`. For example::" msgstr "" -#: library/inspect.rst:1349 +#: library/inspect.rst:1362 msgid "" "If you want to keep the frame around (for example to print a traceback " "later), you can also break reference cycles by using the :meth:`frame.clear` " "method." msgstr "" -#: library/inspect.rst:1353 +#: library/inspect.rst:1366 msgid "" "The optional *context* argument supported by most of these functions " "specifies the number of lines of context to return, which are centered " "around the current line." msgstr "" -#: library/inspect.rst:1360 +#: library/inspect.rst:1373 msgid "" "Get information about a frame or traceback object. A :class:`Traceback` " "object is returned." msgstr "" -#: library/inspect.rst:1363 +#: library/inspect.rst:1376 msgid "A :class:`Traceback` object is returned instead of a named tuple." msgstr "" -#: library/inspect.rst:1368 +#: library/inspect.rst:1381 msgid "" "Get a list of :class:`FrameInfo` objects for a frame and all outer frames. " "These frames represent the calls that lead to the creation of *frame*. The " @@ -1677,17 +1700,17 @@ msgid "" "represents the outermost call on *frame*'s stack." msgstr "" -#: library/inspect.rst:1388 library/inspect.rst:1429 +#: library/inspect.rst:1401 library/inspect.rst:1442 msgid "" "A list of :term:`named tuples ` ``FrameInfo(frame, filename, " "lineno, function, code_context, index)`` is returned." msgstr "" -#: library/inspect.rst:1393 library/inspect.rst:1434 +#: library/inspect.rst:1406 library/inspect.rst:1447 msgid "A list of :class:`FrameInfo` objects is returned." msgstr "" -#: library/inspect.rst:1383 +#: library/inspect.rst:1396 msgid "" "Get a list of :class:`FrameInfo` objects for a traceback's frame and all " "inner frames. These frames represent calls made as a consequence of " @@ -1695,11 +1718,11 @@ msgid "" "represents where the exception was raised." msgstr "" -#: library/inspect.rst:1398 +#: library/inspect.rst:1411 msgid "Return the frame object for the caller's stack frame." msgstr "" -#: library/inspect.rst:1402 +#: library/inspect.rst:1415 msgid "" "This function relies on Python stack frame support in the interpreter, which " "isn't guaranteed to exist in all implementations of Python. If running in " @@ -1707,14 +1730,14 @@ msgid "" "``None``." msgstr "" -#: library/inspect.rst:1410 +#: library/inspect.rst:1423 msgid "" "Return a list of :class:`FrameInfo` objects for the caller's stack. The " "first entry in the returned list represents the caller; the last entry " "represents the outermost call on the stack." msgstr "" -#: library/inspect.rst:1424 +#: library/inspect.rst:1437 msgid "" "Return a list of :class:`FrameInfo` objects for the stack between the " "current frame and the frame in which an exception currently being handled " @@ -1722,11 +1745,11 @@ msgid "" "entry represents where the exception was raised." msgstr "" -#: library/inspect.rst:1438 +#: library/inspect.rst:1451 msgid "Fetching attributes statically" msgstr "" -#: library/inspect.rst:1440 +#: library/inspect.rst:1453 msgid "" "Both :func:`getattr` and :func:`hasattr` can trigger code execution when " "fetching or checking for the existence of attributes. Descriptors, like " @@ -1734,20 +1757,20 @@ msgid "" "`~object.__getattribute__` may be called." msgstr "" -#: library/inspect.rst:1446 +#: library/inspect.rst:1459 msgid "" "For cases where you want passive introspection, like documentation tools, " "this can be inconvenient. :func:`getattr_static` has the same signature as :" "func:`getattr` but avoids executing code when it fetches attributes." msgstr "" -#: library/inspect.rst:1452 +#: library/inspect.rst:1465 msgid "" "Retrieve attributes without triggering dynamic lookup via the descriptor " "protocol, :meth:`~object.__getattr__` or :meth:`~object.__getattribute__`." msgstr "" -#: library/inspect.rst:1456 +#: library/inspect.rst:1469 msgid "" "Note: this function may not be able to retrieve all attributes that getattr " "can fetch (like dynamically created attributes) and may find attributes that " @@ -1755,31 +1778,31 @@ msgid "" "return descriptors objects instead of instance members." msgstr "" -#: library/inspect.rst:1462 +#: library/inspect.rst:1475 msgid "" "If the instance :attr:`~object.__dict__` is shadowed by another member (for " "example a property) then this function will be unable to find instance " "members." msgstr "" -#: library/inspect.rst:1468 +#: library/inspect.rst:1481 msgid "" ":func:`getattr_static` does not resolve descriptors, for example slot " "descriptors or getset descriptors on objects implemented in C. The " "descriptor object is returned instead of the underlying attribute." msgstr "" -#: library/inspect.rst:1472 +#: library/inspect.rst:1485 msgid "" "You can handle these with code like the following. Note that for arbitrary " "getset descriptors invoking these may trigger code execution::" msgstr "" -#: library/inspect.rst:1498 +#: library/inspect.rst:1511 msgid "Current State of Generators, Coroutines, and Asynchronous Generators" msgstr "" -#: library/inspect.rst:1500 +#: library/inspect.rst:1513 msgid "" "When implementing coroutine schedulers and for other advanced uses of " "generators, it is useful to determine whether a generator is currently " @@ -1788,31 +1811,31 @@ msgid "" "generator to be determined easily." msgstr "" -#: library/inspect.rst:1508 +#: library/inspect.rst:1521 msgid "Get current state of a generator-iterator." msgstr "" -#: library/inspect.rst:1526 library/inspect.rst:1543 +#: library/inspect.rst:1539 library/inspect.rst:1556 msgid "Possible states are:" msgstr "" -#: library/inspect.rst:1512 +#: library/inspect.rst:1525 msgid "GEN_CREATED: Waiting to start execution." msgstr "" -#: library/inspect.rst:1513 +#: library/inspect.rst:1526 msgid "GEN_RUNNING: Currently being executed by the interpreter." msgstr "" -#: library/inspect.rst:1514 +#: library/inspect.rst:1527 msgid "GEN_SUSPENDED: Currently suspended at a yield expression." msgstr "" -#: library/inspect.rst:1515 +#: library/inspect.rst:1528 msgid "GEN_CLOSED: Execution has completed." msgstr "" -#: library/inspect.rst:1521 +#: library/inspect.rst:1534 msgid "" "Get current state of a coroutine object. The function is intended to be " "used with coroutine objects created by :keyword:`async def` functions, but " @@ -1820,23 +1843,23 @@ msgid "" "``cr_frame`` attributes." msgstr "" -#: library/inspect.rst:1528 +#: library/inspect.rst:1541 msgid "CORO_CREATED: Waiting to start execution." msgstr "" -#: library/inspect.rst:1529 +#: library/inspect.rst:1542 msgid "CORO_RUNNING: Currently being executed by the interpreter." msgstr "" -#: library/inspect.rst:1530 +#: library/inspect.rst:1543 msgid "CORO_SUSPENDED: Currently suspended at an await expression." msgstr "" -#: library/inspect.rst:1531 +#: library/inspect.rst:1544 msgid "CORO_CLOSED: Execution has completed." msgstr "" -#: library/inspect.rst:1537 +#: library/inspect.rst:1550 msgid "" "Get current state of an asynchronous generator object. The function is " "intended to be used with asynchronous iterator objects created by :keyword:" @@ -1845,30 +1868,30 @@ msgid "" "``ag_frame`` attributes." msgstr "" -#: library/inspect.rst:1545 +#: library/inspect.rst:1558 msgid "AGEN_CREATED: Waiting to start execution." msgstr "" -#: library/inspect.rst:1546 +#: library/inspect.rst:1559 msgid "AGEN_RUNNING: Currently being executed by the interpreter." msgstr "" -#: library/inspect.rst:1547 +#: library/inspect.rst:1560 msgid "AGEN_SUSPENDED: Currently suspended at a yield expression." msgstr "" -#: library/inspect.rst:1548 +#: library/inspect.rst:1561 msgid "AGEN_CLOSED: Execution has completed." msgstr "" -#: library/inspect.rst:1552 +#: library/inspect.rst:1565 msgid "" "The current internal state of the generator can also be queried. This is " "mostly useful for testing purposes, to ensure that internal state is being " "updated as expected:" msgstr "" -#: library/inspect.rst:1558 +#: library/inspect.rst:1571 msgid "" "Get the mapping of live local variables in *generator* to their current " "values. A dictionary is returned that maps from variable names to values. " @@ -1876,14 +1899,14 @@ msgid "" "generator, and all the same caveats apply." msgstr "" -#: library/inspect.rst:1563 +#: library/inspect.rst:1576 msgid "" "If *generator* is a :term:`generator` with no currently associated frame, " "then an empty dictionary is returned. :exc:`TypeError` is raised if " "*generator* is not a Python generator object." msgstr "" -#: library/inspect.rst:1569 +#: library/inspect.rst:1582 msgid "" "This function relies on the generator exposing a Python stack frame for " "introspection, which isn't guaranteed to be the case in all implementations " @@ -1891,79 +1914,79 @@ msgid "" "dictionary." msgstr "" -#: library/inspect.rst:1578 +#: library/inspect.rst:1591 msgid "" "This function is analogous to :func:`~inspect.getgeneratorlocals`, but works " "for coroutine objects created by :keyword:`async def` functions." msgstr "" -#: library/inspect.rst:1585 +#: library/inspect.rst:1598 msgid "" "This function is analogous to :func:`~inspect.getgeneratorlocals`, but works " "for asynchronous generator objects created by :keyword:`async def` functions " "which use the :keyword:`yield` statement." msgstr "" -#: library/inspect.rst:1595 +#: library/inspect.rst:1608 msgid "Code Objects Bit Flags" msgstr "" -#: library/inspect.rst:1597 +#: library/inspect.rst:1610 msgid "" "Python code objects have a :attr:`~codeobject.co_flags` attribute, which is " "a bitmap of the following flags:" msgstr "" -#: library/inspect.rst:1602 +#: library/inspect.rst:1615 msgid "The code object is optimized, using fast locals." msgstr "" -#: library/inspect.rst:1606 +#: library/inspect.rst:1619 msgid "" "If set, a new dict will be created for the frame's :attr:`~frame.f_locals` " "when the code object is executed." msgstr "" -#: library/inspect.rst:1611 +#: library/inspect.rst:1624 msgid "The code object has a variable positional parameter (``*args``-like)." msgstr "" -#: library/inspect.rst:1615 +#: library/inspect.rst:1628 msgid "The code object has a variable keyword parameter (``**kwargs``-like)." msgstr "" -#: library/inspect.rst:1619 +#: library/inspect.rst:1632 msgid "The flag is set when the code object is a nested function." msgstr "" -#: library/inspect.rst:1623 +#: library/inspect.rst:1636 msgid "" "The flag is set when the code object is a generator function, i.e. a " "generator object is returned when the code object is executed." msgstr "" -#: library/inspect.rst:1628 +#: library/inspect.rst:1641 msgid "" "The flag is set when the code object is a coroutine function. When the code " "object is executed it returns a coroutine object. See :pep:`492` for more " "details." msgstr "" -#: library/inspect.rst:1636 +#: library/inspect.rst:1649 msgid "" "The flag is used to transform generators into generator-based coroutines. " "Generator objects with this flag can be used in ``await`` expression, and " "can ``yield from`` coroutine objects. See :pep:`492` for more details." msgstr "" -#: library/inspect.rst:1645 +#: library/inspect.rst:1658 msgid "" "The flag is set when the code object is an asynchronous generator function. " "When the code object is executed it returns an asynchronous generator " "object. See :pep:`525` for more details." msgstr "" -#: library/inspect.rst:1652 +#: library/inspect.rst:1665 msgid "" "The flags are specific to CPython, and may not be defined in other Python " "implementations. Furthermore, the flags are an implementation detail, and " @@ -1971,39 +1994,39 @@ msgid "" "use public APIs from the :mod:`inspect` module for any introspection needs." msgstr "" -#: library/inspect.rst:1660 +#: library/inspect.rst:1673 msgid "Buffer flags" msgstr "" -#: library/inspect.rst:1664 +#: library/inspect.rst:1677 msgid "" "This is an :class:`enum.IntFlag` that represents the flags that can be " "passed to the :meth:`~object.__buffer__` method of objects implementing the :" "ref:`buffer protocol `." msgstr "" -#: library/inspect.rst:1668 +#: library/inspect.rst:1681 msgid "The meaning of the flags is explained at :ref:`buffer-request-types`." msgstr "" -#: library/inspect.rst:1695 +#: library/inspect.rst:1708 msgid "Command Line Interface" msgstr "" -#: library/inspect.rst:1697 +#: library/inspect.rst:1710 msgid "" "The :mod:`inspect` module also provides a basic introspection capability " "from the command line." msgstr "" -#: library/inspect.rst:1702 +#: library/inspect.rst:1715 msgid "" "By default, accepts the name of a module and prints the source of that " "module. A class or function within the module can be printed instead by " "appended a colon and the qualified name of the target object." msgstr "" -#: library/inspect.rst:1708 +#: library/inspect.rst:1721 msgid "" "Print information about the specified object rather than the source code" msgstr "" diff --git a/library/io.po b/library/io.po index 82e0b5b12..2f0d69d72 100644 --- a/library/io.po +++ b/library/io.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -229,8 +229,9 @@ msgstr "" #: library/io.rst:175 msgid "" -"Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " -"``mode``, ``flags``." +"This function raises an auditing event open with arguments path, mode and " +"flags. The mode and flags arguments may have been modified or inferred from " +"the original call." msgstr "" #: library/io.rst:177 diff --git a/library/ipaddress.po b/library/ipaddress.po index 6e010859a..3e2d5b106 100644 --- a/library/ipaddress.po +++ b/library/ipaddress.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -934,9 +934,9 @@ msgstr "" #: library/ipaddress.rst:985 msgid "" "Return an iterator of the collapsed :class:`IPv4Network` or :class:" -"`IPv6Network` objects. *addresses* is an iterator of :class:`IPv4Network` " -"or :class:`IPv6Network` objects. A :exc:`TypeError` is raised if " -"*addresses* contains mixed version objects." +"`IPv6Network` objects. *addresses* is an :term:`iterable` of :class:" +"`IPv4Network` or :class:`IPv6Network` objects. A :exc:`TypeError` is raised " +"if *addresses* contains mixed version objects." msgstr "" #: library/ipaddress.rst:998 diff --git a/library/itertools.po b/library/itertools.po index 554220a5d..da69aeab7 100644 --- a/library/itertools.po +++ b/library/itertools.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -560,7 +560,7 @@ msgstr "" #: library/itertools.rst:332 msgid "" -"When counting with floating point numbers, better accuracy can sometimes be " +"When counting with floating-point numbers, better accuracy can sometimes be " "achieved by substituting multiplicative code such as: ``(start + step * i " "for i in count())``." msgstr "" @@ -879,6 +879,6 @@ msgid "" "overhead." msgstr "" -#: library/itertools.rst:951 +#: library/itertools.rst:956 msgid "The following recipes have a more mathematical flavor:" msgstr "" diff --git a/library/locale.po b/library/locale.po index af13c2c86..93330fc87 100644 --- a/library/locale.po +++ b/library/locale.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -606,7 +606,7 @@ msgstr "" #: library/locale.rst:436 msgid "" "Formats a number *val* according to the current :const:`LC_NUMERIC` setting. " -"The format follows the conventions of the ``%`` operator. For floating " +"The format follows the conventions of the ``%`` operator. For floating-" "point values, the decimal point is modified if appropriate. If *grouping* " "is ``True``, also takes the grouping into account." msgstr "" @@ -649,7 +649,7 @@ msgstr "" #: library/locale.rst:468 msgid "" -"Formats a floating point number using the same format as the built-in " +"Formats a floating-point number using the same format as the built-in " "function ``str(float)``, but takes the decimal point into account." msgstr "" diff --git a/library/mailbox.po b/library/mailbox.po index 0fe50dc54..eb7a70309 100644 --- a/library/mailbox.po +++ b/library/mailbox.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1547,7 +1547,7 @@ msgstr "" #: library/mailbox.rst:1281 msgid "" -"Return an :class:`Message` instance whose headers are the message's visible " +"Return a :class:`Message` instance whose headers are the message's visible " "headers and whose body is empty." msgstr "" diff --git a/library/mailcap.po b/library/mailcap.po index 96b57d365..1c49c7c14 100644 --- a/library/mailcap.po +++ b/library/mailcap.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-12-17 01:28+0300\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/mailcap.py`" msgstr "" -#: library/mailcap.rst:14 +#: library/mailcap.rst:10 msgid "" "The :mod:`mailcap` module is deprecated (see :pep:`PEP 594 <594#mailcap>` " "for details). The :mod:`mimetypes` module provides an alternative." diff --git a/library/marshal.po b/library/marshal.po index 063848d31..1dda733ae 100644 --- a/library/marshal.po +++ b/library/marshal.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -56,7 +56,7 @@ msgid "" "Not all Python object types are supported; in general, only objects whose " "value is independent from a particular invocation of Python can be written " "and read by this module. The following types are supported: booleans, " -"integers, floating point numbers, complex numbers, strings, bytes, " +"integers, floating-point numbers, complex numbers, strings, bytes, " "bytearrays, tuples, lists, sets, frozensets, dictionaries, and code objects, " "where it should be understood that tuples, lists, sets, frozensets and " "dictionaries are only supported as long as the values contained therein are " @@ -97,9 +97,7 @@ msgid "" msgstr "" #: library/marshal.rst:101 -msgid "" -"Raises an :ref:`auditing event ` ``marshal.dumps`` with arguments " -"``value``, ``version``." +msgid "Raises an auditing event marshal.dumps with arguments value, version." msgstr "" #: library/marshal.rst:74 @@ -111,9 +109,7 @@ msgid "" msgstr "" #: library/marshal.rst:79 -msgid "" -"Raises an :ref:`auditing event ` ``marshal.load`` with no " -"arguments." +msgid "Raises an auditing event marshal.load with no arguments." msgstr "" #: library/marshal.rst:83 @@ -149,9 +145,7 @@ msgid "" msgstr "" #: library/marshal.rst:110 -msgid "" -"Raises an :ref:`auditing event ` ``marshal.loads`` with argument " -"``bytes``." +msgid "Raises an auditing event marshal.loads with argument bytes." msgstr "" #: library/marshal.rst:114 @@ -168,7 +162,7 @@ msgstr "" msgid "" "Indicates the format that the module uses. Version 0 is the historical " "format, version 1 shares interned strings and version 2 uses a binary format " -"for floating point numbers. Version 3 adds support for object instancing and " +"for floating-point numbers. Version 3 adds support for object instancing and " "recursion. The current version is 4." msgstr "" diff --git a/library/math.po b/library/math.po index 68c934841..e07cfd711 100644 --- a/library/math.po +++ b/library/math.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2023-03-31 00:00+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -187,7 +187,7 @@ msgstr "" #: library/math.rst:110 #, fuzzy msgid "" -"Return an accurate floating point sum of values in the iterable. Avoids " +"Return an accurate floating-point sum of values in the iterable. Avoids " "loss of precision by tracking multiple intermediate partial sums." msgstr "" "Iterable içindeki değerlerin doğru bir kayan noktalı toplamını döndür. " @@ -211,7 +211,7 @@ msgstr "" #, fuzzy msgid "" "For further discussion and two alternative approaches, see the `ASPN " -"cookbook recipes for accurate floating point summation `_\\." msgstr "" @@ -489,8 +489,9 @@ msgstr "" "ile aynı işarete sahip olacaktır." #: library/math.rst:291 +#, fuzzy msgid "" -"On platforms using IEEE 754 binary floating-point, the result of this " +"On platforms using IEEE 754 binary floating point, the result of this " "operation is always exactly representable: no rounding error is introduced." msgstr "" "IEEE 754 ikili kayan nokta kullanan platformlarda, bu işlemin sonucu her " diff --git a/library/mimetypes.po b/library/mimetypes.po index 1c4e55675..50c263fa2 100644 --- a/library/mimetypes.po +++ b/library/mimetypes.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -150,7 +150,7 @@ msgid "" "file *filename* does not exist or cannot be read, ``None`` is returned." msgstr "" -#: library/mimetypes.rst:114 +#: library/mimetypes.rst:279 msgid "" "Add a mapping from the MIME type *type* to the extension *ext*. When the " "extension is already known, the new type will replace the old one. When the " @@ -158,7 +158,7 @@ msgid "" "extensions." msgstr "" -#: library/mimetypes.rst:118 +#: library/mimetypes.rst:283 msgid "" "When *strict* is ``True`` (the default), the mapping will be added to the " "official MIME types, otherwise to the non-standard ones." diff --git a/library/mmap.po b/library/mmap.po index cb4329d3b..612d81ee6 100644 --- a/library/mmap.po +++ b/library/mmap.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -117,10 +117,10 @@ msgid "" "`ALLOCATIONGRANULARITY`." msgstr "" -#: library/mmap.rst:174 +#: library/mmap.rst:163 msgid "" -"Raises an :ref:`auditing event ` ``mmap.__new__`` with arguments " -"``fileno``, ``length``, ``access``, ``offset``." +"Raises an auditing event mmap.__new__ with arguments fileno, length, access, " +"offset." msgstr "" #: library/mmap.rst:77 diff --git a/library/msilib.po b/library/msilib.po index e8c724c74..3b8213411 100644 --- a/library/msilib.po +++ b/library/msilib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/msilib/__init__.py`" msgstr "" -#: library/msilib.rst:19 +#: library/msilib.rst:16 msgid "" "The :mod:`msilib` module is deprecated (see :pep:`PEP 594 <594#msilib>` for " "details)." diff --git a/library/msvcrt.po b/library/msvcrt.po index 41d76e629..0d7a5d74f 100644 --- a/library/msvcrt.po +++ b/library/msvcrt.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -65,8 +65,7 @@ msgstr "" #: library/msvcrt.rst:45 msgid "" -"Raises an :ref:`auditing event ` ``msvcrt.locking`` with arguments " -"``fd``, ``mode``, ``nbytes``." +"Raises an auditing event msvcrt.locking with arguments fd, mode, nbytes." msgstr "" #: library/msvcrt.rst:51 @@ -103,8 +102,7 @@ msgstr "" #: library/msvcrt.rst:82 msgid "" -"Raises an :ref:`auditing event ` ``msvcrt.open_osfhandle`` with " -"arguments ``handle``, ``flags``." +"Raises an auditing event msvcrt.open_osfhandle with arguments handle, flags." msgstr "" #: library/msvcrt.rst:87 @@ -114,9 +112,7 @@ msgid "" msgstr "" #: library/msvcrt.rst:90 -msgid "" -"Raises an :ref:`auditing event ` ``msvcrt.get_osfhandle`` with " -"argument ``fd``." +msgid "Raises an auditing event msvcrt.get_osfhandle with argument fd." msgstr "" #: library/msvcrt.rst:96 diff --git a/library/multiprocessing.po b/library/multiprocessing.po index b681c99db..74f373c3b 100644 --- a/library/multiprocessing.po +++ b/library/multiprocessing.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -271,20 +271,22 @@ msgid "" msgstr "" #: library/multiprocessing.rst:256 -msgid "Queues are thread and process safe." +msgid "" +"Queues are thread and process safe. Any object put into a :mod:" +"`~multiprocessing` queue will be serialized." msgstr "" -#: library/multiprocessing.rst:258 +#: library/multiprocessing.rst:259 msgid "**Pipes**" msgstr "" -#: library/multiprocessing.rst:260 +#: library/multiprocessing.rst:261 msgid "" "The :func:`Pipe` function returns a pair of connection objects connected by " "a pipe which by default is duplex (two-way). For example::" msgstr "" -#: library/multiprocessing.rst:276 +#: library/multiprocessing.rst:277 msgid "" "The two connection objects returned by :func:`Pipe` represent the two ends " "of the pipe. Each connection object has :meth:`~Connection.send` and :meth:" @@ -294,55 +296,61 @@ msgid "" "corruption from processes using different ends of the pipe at the same time." msgstr "" -#: library/multiprocessing.rst:286 +#: library/multiprocessing.rst:285 +msgid "" +"The :meth:`~Connection.send` method serializes the the object and :meth:" +"`~Connection.recv` re-creates the object." +msgstr "" + +#: library/multiprocessing.rst:289 msgid "Synchronization between processes" msgstr "" -#: library/multiprocessing.rst:288 +#: library/multiprocessing.rst:291 msgid "" ":mod:`multiprocessing` contains equivalents of all the synchronization " "primitives from :mod:`threading`. For instance one can use a lock to ensure " "that only one process prints to standard output at a time::" msgstr "" -#: library/multiprocessing.rst:307 +#: library/multiprocessing.rst:310 msgid "" "Without using the lock output from the different processes is liable to get " "all mixed up." msgstr "" -#: library/multiprocessing.rst:312 +#: library/multiprocessing.rst:315 msgid "Sharing state between processes" msgstr "" -#: library/multiprocessing.rst:314 +#: library/multiprocessing.rst:317 msgid "" "As mentioned above, when doing concurrent programming it is usually best to " "avoid using shared state as far as possible. This is particularly true when " "using multiple processes." msgstr "" -#: library/multiprocessing.rst:318 +#: library/multiprocessing.rst:321 msgid "" "However, if you really do need to use some shared data then :mod:" "`multiprocessing` provides a couple of ways of doing so." msgstr "" -#: library/multiprocessing.rst:321 +#: library/multiprocessing.rst:324 msgid "**Shared memory**" msgstr "" -#: library/multiprocessing.rst:323 +#: library/multiprocessing.rst:326 msgid "" "Data can be stored in a shared memory map using :class:`Value` or :class:" "`Array`. For example, the following code ::" msgstr "" -#: library/multiprocessing.rst:344 library/multiprocessing.rst:390 +#: library/multiprocessing.rst:347 library/multiprocessing.rst:393 msgid "will print ::" msgstr "" -#: library/multiprocessing.rst:349 +#: library/multiprocessing.rst:352 msgid "" "The ``'d'`` and ``'i'`` arguments used when creating ``num`` and ``arr`` are " "typecodes of the kind used by the :mod:`array` module: ``'d'`` indicates a " @@ -350,25 +358,25 @@ msgid "" "objects will be process and thread-safe." msgstr "" -#: library/multiprocessing.rst:354 +#: library/multiprocessing.rst:357 msgid "" "For more flexibility in using shared memory one can use the :mod:" "`multiprocessing.sharedctypes` module which supports the creation of " "arbitrary ctypes objects allocated from shared memory." msgstr "" -#: library/multiprocessing.rst:358 +#: library/multiprocessing.rst:361 msgid "**Server process**" msgstr "" -#: library/multiprocessing.rst:360 +#: library/multiprocessing.rst:363 msgid "" "A manager object returned by :func:`Manager` controls a server process which " "holds Python objects and allows other processes to manipulate them using " "proxies." msgstr "" -#: library/multiprocessing.rst:364 +#: library/multiprocessing.rst:367 msgid "" "A manager returned by :func:`Manager` will support types :class:`list`, :" "class:`dict`, :class:`~managers.Namespace`, :class:`Lock`, :class:`RLock`, :" @@ -377,7 +385,7 @@ msgid "" "`Array`. For example, ::" msgstr "" -#: library/multiprocessing.rst:395 +#: library/multiprocessing.rst:398 msgid "" "Server process managers are more flexible than using shared memory objects " "because they can be made to support arbitrary object types. Also, a single " @@ -385,28 +393,28 @@ msgid "" "They are, however, slower than using shared memory." msgstr "" -#: library/multiprocessing.rst:402 +#: library/multiprocessing.rst:405 msgid "Using a pool of workers" msgstr "" -#: library/multiprocessing.rst:404 +#: library/multiprocessing.rst:407 msgid "" "The :class:`~multiprocessing.pool.Pool` class represents a pool of worker " "processes. It has methods which allows tasks to be offloaded to the worker " "processes in a few different ways." msgstr "" -#: library/multiprocessing.rst:408 +#: library/multiprocessing.rst:411 msgid "For example::" msgstr "" -#: library/multiprocessing.rst:452 +#: library/multiprocessing.rst:455 msgid "" "Note that the methods of a pool should only ever be used by the process " "which created it." msgstr "" -#: library/multiprocessing.rst:457 +#: library/multiprocessing.rst:460 msgid "" "Functionality within this package requires that the ``__main__`` module be " "importable by the children. This is covered in :ref:`multiprocessing-" @@ -415,35 +423,35 @@ msgid "" "work in the interactive interpreter. For example::" msgstr "" -#: library/multiprocessing.rst:480 +#: library/multiprocessing.rst:483 msgid "" "(If you try this it will actually output three full tracebacks interleaved " "in a semi-random fashion, and then you may have to stop the parent process " "somehow.)" msgstr "" -#: library/multiprocessing.rst:486 +#: library/multiprocessing.rst:489 msgid "Reference" msgstr "" -#: library/multiprocessing.rst:488 +#: library/multiprocessing.rst:491 msgid "" "The :mod:`multiprocessing` package mostly replicates the API of the :mod:" "`threading` module." msgstr "" -#: library/multiprocessing.rst:493 +#: library/multiprocessing.rst:496 msgid ":class:`Process` and exceptions" msgstr "" -#: library/multiprocessing.rst:498 +#: library/multiprocessing.rst:501 msgid "" "Process objects represent activity that is run in a separate process. The :" "class:`Process` class has equivalents of all the methods of :class:" "`threading.Thread`." msgstr "" -#: library/multiprocessing.rst:502 +#: library/multiprocessing.rst:505 msgid "" "The constructor should always be called with keyword arguments. *group* " "should always be ``None``; it exists solely for compatibility with :class:" @@ -457,29 +465,29 @@ msgid "" "creating process." msgstr "" -#: library/multiprocessing.rst:513 +#: library/multiprocessing.rst:516 msgid "" "By default, no arguments are passed to *target*. The *args* argument, which " "defaults to ``()``, can be used to specify a list or tuple of the arguments " "to pass to *target*." msgstr "" -#: library/multiprocessing.rst:517 +#: library/multiprocessing.rst:520 msgid "" "If a subclass overrides the constructor, it must make sure it invokes the " "base class constructor (:meth:`Process.__init__`) before doing anything else " "to the process." msgstr "" -#: library/multiprocessing.rst:521 +#: library/multiprocessing.rst:524 msgid "Added the *daemon* parameter." msgstr "" -#: library/multiprocessing.rst:526 +#: library/multiprocessing.rst:529 msgid "Method representing the process's activity." msgstr "" -#: library/multiprocessing.rst:528 +#: library/multiprocessing.rst:531 msgid "" "You may override this method in a subclass. The standard :meth:`run` method " "invokes the callable object passed to the object's constructor as the target " @@ -487,27 +495,27 @@ msgid "" "*args* and *kwargs* arguments, respectively." msgstr "" -#: library/multiprocessing.rst:533 +#: library/multiprocessing.rst:536 msgid "" "Using a list or tuple as the *args* argument passed to :class:`Process` " "achieves the same effect." msgstr "" -#: library/multiprocessing.rst:536 +#: library/multiprocessing.rst:539 msgid "Example::" msgstr "" -#: library/multiprocessing.rst:548 +#: library/multiprocessing.rst:551 msgid "Start the process's activity." msgstr "" -#: library/multiprocessing.rst:550 +#: library/multiprocessing.rst:553 msgid "" "This must be called at most once per process object. It arranges for the " "object's :meth:`run` method to be invoked in a separate process." msgstr "" -#: library/multiprocessing.rst:555 +#: library/multiprocessing.rst:558 msgid "" "If the optional argument *timeout* is ``None`` (the default), the method " "blocks until the process whose :meth:`join` method is called terminates. If " @@ -517,23 +525,23 @@ msgid "" "terminated." msgstr "" -#: library/multiprocessing.rst:562 +#: library/multiprocessing.rst:565 msgid "A process can be joined many times." msgstr "" -#: library/multiprocessing.rst:564 +#: library/multiprocessing.rst:567 msgid "" "A process cannot join itself because this would cause a deadlock. It is an " "error to attempt to join a process before it has been started." msgstr "" -#: library/multiprocessing.rst:569 +#: library/multiprocessing.rst:572 msgid "" "The process's name. The name is a string used for identification purposes " "only. It has no semantics. Multiple processes may be given the same name." msgstr "" -#: library/multiprocessing.rst:573 +#: library/multiprocessing.rst:576 msgid "" "The initial name is set by the constructor. If no explicit name is provided " "to the constructor, a name of the form 'Process-N\\ :sub:`1`:N\\ :sub:" @@ -541,33 +549,33 @@ msgid "" "child of its parent." msgstr "" -#: library/multiprocessing.rst:580 +#: library/multiprocessing.rst:583 msgid "Return whether the process is alive." msgstr "" -#: library/multiprocessing.rst:582 +#: library/multiprocessing.rst:585 msgid "" "Roughly, a process object is alive from the moment the :meth:`start` method " "returns until the child process terminates." msgstr "" -#: library/multiprocessing.rst:587 +#: library/multiprocessing.rst:590 msgid "" "The process's daemon flag, a Boolean value. This must be set before :meth:" "`start` is called." msgstr "" -#: library/multiprocessing.rst:590 +#: library/multiprocessing.rst:593 msgid "The initial value is inherited from the creating process." msgstr "" -#: library/multiprocessing.rst:592 +#: library/multiprocessing.rst:595 msgid "" "When a process exits, it attempts to terminate all of its daemonic child " "processes." msgstr "" -#: library/multiprocessing.rst:595 +#: library/multiprocessing.rst:598 msgid "" "Note that a daemonic process is not allowed to create child processes. " "Otherwise a daemonic process would leave its children orphaned if it gets " @@ -576,92 +584,92 @@ msgid "" "(and not joined) if non-daemonic processes have exited." msgstr "" -#: library/multiprocessing.rst:601 +#: library/multiprocessing.rst:604 msgid "" "In addition to the :class:`threading.Thread` API, :class:`Process` objects " "also support the following attributes and methods:" msgstr "" -#: library/multiprocessing.rst:606 +#: library/multiprocessing.rst:609 msgid "" "Return the process ID. Before the process is spawned, this will be ``None``." msgstr "" -#: library/multiprocessing.rst:611 +#: library/multiprocessing.rst:614 msgid "" "The child's exit code. This will be ``None`` if the process has not yet " "terminated." msgstr "" -#: library/multiprocessing.rst:614 +#: library/multiprocessing.rst:617 msgid "" "If the child's :meth:`run` method returned normally, the exit code will be " "0. If it terminated via :func:`sys.exit` with an integer argument *N*, the " "exit code will be *N*." msgstr "" -#: library/multiprocessing.rst:618 +#: library/multiprocessing.rst:621 msgid "" "If the child terminated due to an exception not caught within :meth:`run`, " "the exit code will be 1. If it was terminated by signal *N*, the exit code " "will be the negative value *-N*." msgstr "" -#: library/multiprocessing.rst:624 +#: library/multiprocessing.rst:627 msgid "The process's authentication key (a byte string)." msgstr "" -#: library/multiprocessing.rst:626 +#: library/multiprocessing.rst:629 msgid "" "When :mod:`multiprocessing` is initialized the main process is assigned a " "random string using :func:`os.urandom`." msgstr "" -#: library/multiprocessing.rst:629 +#: library/multiprocessing.rst:632 msgid "" "When a :class:`Process` object is created, it will inherit the " "authentication key of its parent process, although this may be changed by " "setting :attr:`authkey` to another byte string." msgstr "" -#: library/multiprocessing.rst:633 +#: library/multiprocessing.rst:636 msgid "See :ref:`multiprocessing-auth-keys`." msgstr "" -#: library/multiprocessing.rst:637 +#: library/multiprocessing.rst:640 msgid "" "A numeric handle of a system object which will become \"ready\" when the " "process ends." msgstr "" -#: library/multiprocessing.rst:640 +#: library/multiprocessing.rst:643 msgid "" "You can use this value if you want to wait on several events at once using :" "func:`multiprocessing.connection.wait`. Otherwise calling :meth:`join()` is " "simpler." msgstr "" -#: library/multiprocessing.rst:644 +#: library/multiprocessing.rst:647 msgid "" "On Windows, this is an OS handle usable with the ``WaitForSingleObject`` and " "``WaitForMultipleObjects`` family of API calls. On POSIX, this is a file " "descriptor usable with primitives from the :mod:`select` module." msgstr "" -#: library/multiprocessing.rst:652 +#: library/multiprocessing.rst:655 msgid "" "Terminate the process. On POSIX this is done using the :py:const:`~signal." "SIGTERM` signal; on Windows :c:func:`!TerminateProcess` is used. Note that " "exit handlers and finally clauses, etc., will not be executed." msgstr "" -#: library/multiprocessing.rst:656 +#: library/multiprocessing.rst:659 msgid "" "Note that descendant processes of the process will *not* be terminated -- " "they will simply become orphaned." msgstr "" -#: library/multiprocessing.rst:661 +#: library/multiprocessing.rst:664 msgid "" "If this method is used when the associated process is using a pipe or queue " "then the pipe or queue is liable to become corrupted and may become unusable " @@ -670,11 +678,11 @@ msgid "" "deadlock." msgstr "" -#: library/multiprocessing.rst:669 +#: library/multiprocessing.rst:672 msgid "Same as :meth:`terminate()` but using the ``SIGKILL`` signal on POSIX." msgstr "" -#: library/multiprocessing.rst:675 +#: library/multiprocessing.rst:678 msgid "" "Close the :class:`Process` object, releasing all resources associated with " "it. :exc:`ValueError` is raised if the underlying process is still " @@ -682,59 +690,59 @@ msgid "" "attributes of the :class:`Process` object will raise :exc:`ValueError`." msgstr "" -#: library/multiprocessing.rst:683 +#: library/multiprocessing.rst:686 msgid "" "Note that the :meth:`start`, :meth:`join`, :meth:`is_alive`, :meth:" "`terminate` and :attr:`exitcode` methods should only be called by the " "process that created the process object." msgstr "" -#: library/multiprocessing.rst:687 +#: library/multiprocessing.rst:690 msgid "Example usage of some of the methods of :class:`Process`:" msgstr "" -#: library/multiprocessing.rst:708 +#: library/multiprocessing.rst:711 msgid "The base class of all :mod:`multiprocessing` exceptions." msgstr "" -#: library/multiprocessing.rst:712 +#: library/multiprocessing.rst:715 msgid "" "Exception raised by :meth:`Connection.recv_bytes_into()` when the supplied " "buffer object is too small for the message read." msgstr "" -#: library/multiprocessing.rst:715 +#: library/multiprocessing.rst:718 msgid "" "If ``e`` is an instance of :exc:`BufferTooShort` then ``e.args[0]`` will " "give the message as a byte string." msgstr "" -#: library/multiprocessing.rst:720 +#: library/multiprocessing.rst:723 msgid "Raised when there is an authentication error." msgstr "" -#: library/multiprocessing.rst:724 +#: library/multiprocessing.rst:727 msgid "Raised by methods with a timeout when the timeout expires." msgstr "" -#: library/multiprocessing.rst:727 +#: library/multiprocessing.rst:730 msgid "Pipes and Queues" msgstr "" -#: library/multiprocessing.rst:729 +#: library/multiprocessing.rst:732 msgid "" "When using multiple processes, one generally uses message passing for " "communication between processes and avoids having to use any synchronization " "primitives like locks." msgstr "" -#: library/multiprocessing.rst:733 +#: library/multiprocessing.rst:736 msgid "" "For passing messages one can use :func:`Pipe` (for a connection between two " "processes) or a queue (which allows multiple producers and consumers)." msgstr "" -#: library/multiprocessing.rst:736 +#: library/multiprocessing.rst:739 msgid "" "The :class:`Queue`, :class:`SimpleQueue` and :class:`JoinableQueue` types " "are multi-producer, multi-consumer :abbr:`FIFO (first-in, first-out)` queues " @@ -744,7 +752,7 @@ msgid "" "Queue` class." msgstr "" -#: library/multiprocessing.rst:743 +#: library/multiprocessing.rst:746 msgid "" "If you use :class:`JoinableQueue` then you **must** call :meth:" "`JoinableQueue.task_done` for each task removed from the queue or else the " @@ -752,20 +760,28 @@ msgid "" "overflow, raising an exception." msgstr "" -#: library/multiprocessing.rst:748 +#: library/multiprocessing.rst:751 +msgid "" +"One difference from other Python queue implementations, is that :mod:" +"`multiprocessing` queues serializes all objects that are put into them " +"using :mod:`pickle`. The object return by the get method is a re-created " +"object that does not share memory with the original object." +msgstr "" + +#: library/multiprocessing.rst:756 msgid "" "Note that one can also create a shared queue by using a manager object -- " "see :ref:`multiprocessing-managers`." msgstr "" -#: library/multiprocessing.rst:753 +#: library/multiprocessing.rst:761 msgid "" ":mod:`multiprocessing` uses the usual :exc:`queue.Empty` and :exc:`queue." "Full` exceptions to signal a timeout. They are not available in the :mod:" "`multiprocessing` namespace so you need to import them from :mod:`queue`." msgstr "" -#: library/multiprocessing.rst:760 +#: library/multiprocessing.rst:768 msgid "" "When an object is put on a queue, the object is pickled and a background " "thread later flushes the pickled data to an underlying pipe. This has some " @@ -774,14 +790,14 @@ msgid "" "a queue created with a :ref:`manager `." msgstr "" -#: library/multiprocessing.rst:767 +#: library/multiprocessing.rst:775 msgid "" "After putting an object on an empty queue there may be an infinitesimal " "delay before the queue's :meth:`~Queue.empty` method returns :const:`False` " "and :meth:`~Queue.get_nowait` can return without raising :exc:`queue.Empty`." msgstr "" -#: library/multiprocessing.rst:772 +#: library/multiprocessing.rst:780 msgid "" "If multiple processes are enqueuing objects, it is possible for the objects " "to be received at the other end out-of-order. However, objects enqueued by " @@ -789,7 +805,7 @@ msgid "" "other." msgstr "" -#: library/multiprocessing.rst:779 +#: library/multiprocessing.rst:787 msgid "" "If a process is killed using :meth:`Process.terminate` or :func:`os.kill` " "while it is trying to use a :class:`Queue`, then the data in the queue is " @@ -797,7 +813,7 @@ msgid "" "exception when it tries to use the queue later on." msgstr "" -#: library/multiprocessing.rst:786 +#: library/multiprocessing.rst:794 msgid "" "As mentioned above, if a child process has put items on a queue (and it has " "not used :meth:`JoinableQueue.cancel_join_thread ` -- see also :ref:`multiprocessing-listeners-clients`." msgstr "" -#: library/multiprocessing.rst:1161 +#: library/multiprocessing.rst:1175 msgid "" "Send an object to the other end of the connection which should be read " "using :meth:`recv`." msgstr "" -#: library/multiprocessing.rst:1164 +#: library/multiprocessing.rst:1178 msgid "" "The object must be picklable. Very large pickles (approximately 32 MiB+, " "though it depends on the OS) may raise a :exc:`ValueError` exception." msgstr "" -#: library/multiprocessing.rst:1169 +#: library/multiprocessing.rst:1183 msgid "" "Return an object sent from the other end of the connection using :meth:" "`send`. Blocks until there is something to receive. Raises :exc:`EOFError` " "if there is nothing left to receive and the other end was closed." msgstr "" -#: library/multiprocessing.rst:1176 +#: library/multiprocessing.rst:1190 msgid "Return the file descriptor or handle used by the connection." msgstr "" -#: library/multiprocessing.rst:1180 +#: library/multiprocessing.rst:1194 msgid "Close the connection." msgstr "" -#: library/multiprocessing.rst:1182 +#: library/multiprocessing.rst:1196 msgid "This is called automatically when the connection is garbage collected." msgstr "" -#: library/multiprocessing.rst:1186 +#: library/multiprocessing.rst:1200 msgid "Return whether there is any data available to be read." msgstr "" -#: library/multiprocessing.rst:1188 +#: library/multiprocessing.rst:1202 msgid "" "If *timeout* is not specified then it will return immediately. If *timeout* " "is a number then this specifies the maximum time in seconds to block. If " "*timeout* is ``None`` then an infinite timeout is used." msgstr "" -#: library/multiprocessing.rst:1192 +#: library/multiprocessing.rst:1206 msgid "" "Note that multiple connection objects may be polled at once by using :func:" "`multiprocessing.connection.wait`." msgstr "" -#: library/multiprocessing.rst:1197 +#: library/multiprocessing.rst:1211 msgid "Send byte data from a :term:`bytes-like object` as a complete message." msgstr "" -#: library/multiprocessing.rst:1199 +#: library/multiprocessing.rst:1213 msgid "" "If *offset* is given then data is read from that position in *buffer*. If " "*size* is given then that many bytes will be read from buffer. Very large " @@ -1314,7 +1345,7 @@ msgid "" "exc:`ValueError` exception" msgstr "" -#: library/multiprocessing.rst:1206 +#: library/multiprocessing.rst:1220 msgid "" "Return a complete message of byte data sent from the other end of the " "connection as a string. Blocks until there is something to receive. Raises :" @@ -1322,19 +1353,19 @@ msgid "" "closed." msgstr "" -#: library/multiprocessing.rst:1211 +#: library/multiprocessing.rst:1225 msgid "" "If *maxlength* is specified and the message is longer than *maxlength* then :" "exc:`OSError` is raised and the connection will no longer be readable." msgstr "" -#: library/multiprocessing.rst:1215 +#: library/multiprocessing.rst:1229 msgid "" "This function used to raise :exc:`IOError`, which is now an alias of :exc:" "`OSError`." msgstr "" -#: library/multiprocessing.rst:1222 +#: library/multiprocessing.rst:1236 msgid "" "Read into *buffer* a complete message of byte data sent from the other end " "of the connection and return the number of bytes in the message. Blocks " @@ -1342,45 +1373,45 @@ msgid "" "nothing left to receive and the other end was closed." msgstr "" -#: library/multiprocessing.rst:1228 +#: library/multiprocessing.rst:1242 msgid "" "*buffer* must be a writable :term:`bytes-like object`. If *offset* is given " "then the message will be written into the buffer from that position. Offset " "must be a non-negative integer less than the length of *buffer* (in bytes)." msgstr "" -#: library/multiprocessing.rst:1233 +#: library/multiprocessing.rst:1247 msgid "" "If the buffer is too short then a :exc:`BufferTooShort` exception is raised " "and the complete message is available as ``e.args[0]`` where ``e`` is the " "exception instance." msgstr "" -#: library/multiprocessing.rst:1237 +#: library/multiprocessing.rst:1251 msgid "" "Connection objects themselves can now be transferred between processes " "using :meth:`Connection.send` and :meth:`Connection.recv`." msgstr "" -#: library/multiprocessing.rst:1241 +#: library/multiprocessing.rst:1255 msgid "" "Connection objects also now support the context management protocol -- see :" "ref:`typecontextmanager`. :meth:`~contextmanager.__enter__` returns the " "connection object, and :meth:`~contextmanager.__exit__` calls :meth:`close`." msgstr "" -#: library/multiprocessing.rst:1245 +#: library/multiprocessing.rst:1259 msgid "For example:" msgstr "" -#: library/multiprocessing.rst:1270 +#: library/multiprocessing.rst:1284 msgid "" "The :meth:`Connection.recv` method automatically unpickles the data it " "receives, which can be a security risk unless you can trust the process " "which sent the message." msgstr "" -#: library/multiprocessing.rst:1274 +#: library/multiprocessing.rst:1288 msgid "" "Therefore, unless the connection object was produced using :func:`Pipe` you " "should only use the :meth:`~Connection.recv` and :meth:`~Connection.send` " @@ -1388,71 +1419,71 @@ msgid "" "`multiprocessing-auth-keys`." msgstr "" -#: library/multiprocessing.rst:1281 +#: library/multiprocessing.rst:1295 msgid "" "If a process is killed while it is trying to read or write to a pipe then " "the data in the pipe is likely to become corrupted, because it may become " "impossible to be sure where the message boundaries lie." msgstr "" -#: library/multiprocessing.rst:1287 +#: library/multiprocessing.rst:1301 msgid "Synchronization primitives" msgstr "" -#: library/multiprocessing.rst:1291 +#: library/multiprocessing.rst:1305 msgid "" "Generally synchronization primitives are not as necessary in a multiprocess " "program as they are in a multithreaded program. See the documentation for :" "mod:`threading` module." msgstr "" -#: library/multiprocessing.rst:1295 +#: library/multiprocessing.rst:1309 msgid "" "Note that one can also create synchronization primitives by using a manager " "object -- see :ref:`multiprocessing-managers`." msgstr "" -#: library/multiprocessing.rst:1300 +#: library/multiprocessing.rst:1314 msgid "A barrier object: a clone of :class:`threading.Barrier`." msgstr "" -#: library/multiprocessing.rst:1306 +#: library/multiprocessing.rst:1320 msgid "" "A bounded semaphore object: a close analog of :class:`threading." "BoundedSemaphore`." msgstr "" -#: library/multiprocessing.rst:1309 library/multiprocessing.rst:1447 +#: library/multiprocessing.rst:1323 library/multiprocessing.rst:1461 msgid "" "A solitary difference from its close analog exists: its ``acquire`` method's " "first argument is named *block*, as is consistent with :meth:`Lock.acquire`." msgstr "" -#: library/multiprocessing.rst:1313 +#: library/multiprocessing.rst:1327 msgid "" "On macOS, this is indistinguishable from :class:`Semaphore` because " "``sem_getvalue()`` is not implemented on that platform." msgstr "" -#: library/multiprocessing.rst:1318 +#: library/multiprocessing.rst:1332 msgid "A condition variable: an alias for :class:`threading.Condition`." msgstr "" -#: library/multiprocessing.rst:1320 +#: library/multiprocessing.rst:1334 msgid "" "If *lock* is specified then it should be a :class:`Lock` or :class:`RLock` " "object from :mod:`multiprocessing`." msgstr "" -#: library/multiprocessing.rst:1323 library/multiprocessing.rst:1872 +#: library/multiprocessing.rst:1337 library/multiprocessing.rst:1875 msgid "The :meth:`~threading.Condition.wait_for` method was added." msgstr "" -#: library/multiprocessing.rst:1328 +#: library/multiprocessing.rst:1342 msgid "A clone of :class:`threading.Event`." msgstr "" -#: library/multiprocessing.rst:1333 +#: library/multiprocessing.rst:1347 msgid "" "A non-recursive lock object: a close analog of :class:`threading.Lock`. Once " "a process or thread has acquired a lock, subsequent attempts to acquire it " @@ -1463,24 +1494,24 @@ msgid "" "as noted." msgstr "" -#: library/multiprocessing.rst:1341 +#: library/multiprocessing.rst:1355 msgid "" "Note that :class:`Lock` is actually a factory function which returns an " "instance of ``multiprocessing.synchronize.Lock`` initialized with a default " "context." msgstr "" -#: library/multiprocessing.rst:1345 +#: library/multiprocessing.rst:1359 msgid "" ":class:`Lock` supports the :term:`context manager` protocol and thus may be " "used in :keyword:`with` statements." msgstr "" -#: library/multiprocessing.rst:1350 library/multiprocessing.rst:1401 +#: library/multiprocessing.rst:1364 library/multiprocessing.rst:1415 msgid "Acquire a lock, blocking or non-blocking." msgstr "" -#: library/multiprocessing.rst:1352 +#: library/multiprocessing.rst:1366 msgid "" "With the *block* argument set to ``True`` (the default), the method call " "will block until the lock is in an unlocked state, then set it to locked and " @@ -1488,14 +1519,14 @@ msgid "" "that in :meth:`threading.Lock.acquire`." msgstr "" -#: library/multiprocessing.rst:1357 +#: library/multiprocessing.rst:1371 msgid "" "With the *block* argument set to ``False``, the method call does not block. " "If the lock is currently in a locked state, return ``False``; otherwise set " "the lock to a locked state and return ``True``." msgstr "" -#: library/multiprocessing.rst:1361 +#: library/multiprocessing.rst:1375 msgid "" "When invoked with a positive, floating-point value for *timeout*, block for " "at most the number of seconds specified by *timeout* as long as the lock can " @@ -1509,19 +1540,19 @@ msgid "" "acquired or ``False`` if the timeout period has elapsed." msgstr "" -#: library/multiprocessing.rst:1376 +#: library/multiprocessing.rst:1390 msgid "" "Release a lock. This can be called from any process or thread, not only the " "process or thread which originally acquired the lock." msgstr "" -#: library/multiprocessing.rst:1379 +#: library/multiprocessing.rst:1393 msgid "" "Behavior is the same as in :meth:`threading.Lock.release` except that when " "invoked on an unlocked lock, a :exc:`ValueError` is raised." msgstr "" -#: library/multiprocessing.rst:1385 +#: library/multiprocessing.rst:1399 msgid "" "A recursive lock object: a close analog of :class:`threading.RLock`. A " "recursive lock must be released by the process or thread that acquired it. " @@ -1530,20 +1561,20 @@ msgid "" "release it once for each time it has been acquired." msgstr "" -#: library/multiprocessing.rst:1391 +#: library/multiprocessing.rst:1405 msgid "" "Note that :class:`RLock` is actually a factory function which returns an " "instance of ``multiprocessing.synchronize.RLock`` initialized with a default " "context." msgstr "" -#: library/multiprocessing.rst:1395 +#: library/multiprocessing.rst:1409 msgid "" ":class:`RLock` supports the :term:`context manager` protocol and thus may be " "used in :keyword:`with` statements." msgstr "" -#: library/multiprocessing.rst:1403 +#: library/multiprocessing.rst:1417 msgid "" "When invoked with the *block* argument set to ``True``, block until the lock " "is in an unlocked state (not owned by any process or thread) unless the lock " @@ -1556,7 +1587,7 @@ msgid "" "itself." msgstr "" -#: library/multiprocessing.rst:1413 +#: library/multiprocessing.rst:1427 msgid "" "When invoked with the *block* argument set to ``False``, do not block. If " "the lock has already been acquired (and thus is owned) by another process or " @@ -1567,14 +1598,14 @@ msgid "" "a return value of ``True``." msgstr "" -#: library/multiprocessing.rst:1421 +#: library/multiprocessing.rst:1435 msgid "" "Use and behaviors of the *timeout* argument are the same as in :meth:`Lock." "acquire`. Note that some of these behaviors of *timeout* differ from the " "implemented behaviors in :meth:`threading.RLock.acquire`." msgstr "" -#: library/multiprocessing.rst:1428 +#: library/multiprocessing.rst:1442 msgid "" "Release a lock, decrementing the recursion level. If after the decrement " "the recursion level is zero, reset the lock to unlocked (not owned by any " @@ -1584,7 +1615,7 @@ msgid "" "locked and owned by the calling process or thread." msgstr "" -#: library/multiprocessing.rst:1436 +#: library/multiprocessing.rst:1450 msgid "" "Only call this method when the calling process or thread owns the lock. An :" "exc:`AssertionError` is raised if this method is called by a process or " @@ -1593,32 +1624,17 @@ msgid "" "from the implemented behavior in :meth:`threading.RLock.release`." msgstr "" -#: library/multiprocessing.rst:1445 +#: library/multiprocessing.rst:1459 msgid "A semaphore object: a close analog of :class:`threading.Semaphore`." msgstr "" -#: library/multiprocessing.rst:1452 +#: library/multiprocessing.rst:1466 msgid "" "On macOS, ``sem_timedwait`` is unsupported, so calling ``acquire()`` with a " "timeout will emulate that function's behavior using a sleeping loop." msgstr "" -#: library/multiprocessing.rst:1457 -msgid "" -"If the SIGINT signal generated by :kbd:`Ctrl-C` arrives while the main " -"thread is blocked by a call to :meth:`BoundedSemaphore.acquire`, :meth:`Lock." -"acquire`, :meth:`RLock.acquire`, :meth:`Semaphore.acquire`, :meth:`Condition." -"acquire` or :meth:`Condition.wait` then the call will be immediately " -"interrupted and :exc:`KeyboardInterrupt` will be raised." -msgstr "" - -#: library/multiprocessing.rst:1463 -msgid "" -"This differs from the behaviour of :mod:`threading` where SIGINT will be " -"ignored while the equivalent blocking calls are in progress." -msgstr "" - -#: library/multiprocessing.rst:1468 +#: library/multiprocessing.rst:1471 msgid "" "Some of this package's functionality requires a functioning shared semaphore " "implementation on the host operating system. Without one, the :mod:" @@ -1627,31 +1643,31 @@ msgid "" "additional information." msgstr "" -#: library/multiprocessing.rst:1476 +#: library/multiprocessing.rst:1479 msgid "Shared :mod:`ctypes` Objects" msgstr "" -#: library/multiprocessing.rst:1478 +#: library/multiprocessing.rst:1481 msgid "" "It is possible to create shared objects using shared memory which can be " "inherited by child processes." msgstr "" -#: library/multiprocessing.rst:1483 +#: library/multiprocessing.rst:1486 msgid "" "Return a :mod:`ctypes` object allocated from shared memory. By default the " "return value is actually a synchronized wrapper for the object. The object " "itself can be accessed via the *value* attribute of a :class:`Value`." msgstr "" -#: library/multiprocessing.rst:1487 library/multiprocessing.rst:1574 +#: library/multiprocessing.rst:1490 library/multiprocessing.rst:1577 msgid "" "*typecode_or_type* determines the type of the returned object: it is either " "a ctypes type or a one character typecode of the kind used by the :mod:" "`array` module. *\\*args* is passed on to the constructor for the type." msgstr "" -#: library/multiprocessing.rst:1491 +#: library/multiprocessing.rst:1494 msgid "" "If *lock* is ``True`` (the default) then a new recursive lock object is " "created to synchronize access to the value. If *lock* is a :class:`Lock` " @@ -1661,31 +1677,31 @@ msgid "" "\"process-safe\"." msgstr "" -#: library/multiprocessing.rst:1498 +#: library/multiprocessing.rst:1501 msgid "" "Operations like ``+=`` which involve a read and write are not atomic. So " "if, for instance, you want to atomically increment a shared value it is " "insufficient to just do ::" msgstr "" -#: library/multiprocessing.rst:1504 +#: library/multiprocessing.rst:1507 msgid "" "Assuming the associated lock is recursive (which it is by default) you can " "instead do ::" msgstr "" -#: library/multiprocessing.rst:1510 library/multiprocessing.rst:1600 -#: library/multiprocessing.rst:1615 +#: library/multiprocessing.rst:1513 library/multiprocessing.rst:1603 +#: library/multiprocessing.rst:1618 msgid "Note that *lock* is a keyword-only argument." msgstr "" -#: library/multiprocessing.rst:1514 +#: library/multiprocessing.rst:1517 msgid "" "Return a ctypes array allocated from shared memory. By default the return " "value is actually a synchronized wrapper for the array." msgstr "" -#: library/multiprocessing.rst:1517 +#: library/multiprocessing.rst:1520 msgid "" "*typecode_or_type* determines the type of the elements of the returned " "array: it is either a ctypes type or a one character typecode of the kind " @@ -1695,7 +1711,7 @@ msgid "" "initialize the array and whose length determines the length of the array." msgstr "" -#: library/multiprocessing.rst:1524 +#: library/multiprocessing.rst:1527 msgid "" "If *lock* is ``True`` (the default) then a new lock object is created to " "synchronize access to the value. If *lock* is a :class:`Lock` or :class:" @@ -1705,28 +1721,28 @@ msgid "" "safe\"." msgstr "" -#: library/multiprocessing.rst:1531 +#: library/multiprocessing.rst:1534 msgid "Note that *lock* is a keyword only argument." msgstr "" -#: library/multiprocessing.rst:1533 +#: library/multiprocessing.rst:1536 msgid "" "Note that an array of :data:`ctypes.c_char` has *value* and *raw* attributes " "which allow one to use it to store and retrieve strings." msgstr "" -#: library/multiprocessing.rst:1538 +#: library/multiprocessing.rst:1541 msgid "The :mod:`multiprocessing.sharedctypes` module" msgstr "" -#: library/multiprocessing.rst:1543 +#: library/multiprocessing.rst:1546 msgid "" "The :mod:`multiprocessing.sharedctypes` module provides functions for " "allocating :mod:`ctypes` objects from shared memory which can be inherited " "by child processes." msgstr "" -#: library/multiprocessing.rst:1549 +#: library/multiprocessing.rst:1552 msgid "" "Although it is possible to store a pointer in shared memory remember that " "this will refer to a location in the address space of a specific process. " @@ -1735,11 +1751,11 @@ msgid "" "may cause a crash." msgstr "" -#: library/multiprocessing.rst:1557 +#: library/multiprocessing.rst:1560 msgid "Return a ctypes array allocated from shared memory." msgstr "" -#: library/multiprocessing.rst:1559 +#: library/multiprocessing.rst:1562 msgid "" "*typecode_or_type* determines the type of the elements of the returned " "array: it is either a ctypes type or a one character typecode of the kind " @@ -1749,39 +1765,39 @@ msgid "" "initialize the array and whose length determines the length of the array." msgstr "" -#: library/multiprocessing.rst:1566 +#: library/multiprocessing.rst:1569 msgid "" "Note that setting and getting an element is potentially non-atomic -- use :" "func:`Array` instead to make sure that access is automatically synchronized " "using a lock." msgstr "" -#: library/multiprocessing.rst:1572 +#: library/multiprocessing.rst:1575 msgid "Return a ctypes object allocated from shared memory." msgstr "" -#: library/multiprocessing.rst:1578 +#: library/multiprocessing.rst:1581 msgid "" "Note that setting and getting the value is potentially non-atomic -- use :" "func:`Value` instead to make sure that access is automatically synchronized " "using a lock." msgstr "" -#: library/multiprocessing.rst:1582 +#: library/multiprocessing.rst:1585 msgid "" "Note that an array of :data:`ctypes.c_char` has ``value`` and ``raw`` " "attributes which allow one to use it to store and retrieve strings -- see " "documentation for :mod:`ctypes`." msgstr "" -#: library/multiprocessing.rst:1588 +#: library/multiprocessing.rst:1591 msgid "" "The same as :func:`RawArray` except that depending on the value of *lock* a " "process-safe synchronization wrapper may be returned instead of a raw ctypes " "array." msgstr "" -#: library/multiprocessing.rst:1592 library/multiprocessing.rst:1608 +#: library/multiprocessing.rst:1595 library/multiprocessing.rst:1611 msgid "" "If *lock* is ``True`` (the default) then a new lock object is created to " "synchronize access to the value. If *lock* is a :class:`~multiprocessing." @@ -1791,121 +1807,121 @@ msgid "" "not necessarily be \"process-safe\"." msgstr "" -#: library/multiprocessing.rst:1604 +#: library/multiprocessing.rst:1607 msgid "" "The same as :func:`RawValue` except that depending on the value of *lock* a " "process-safe synchronization wrapper may be returned instead of a raw ctypes " "object." msgstr "" -#: library/multiprocessing.rst:1619 +#: library/multiprocessing.rst:1622 msgid "" "Return a ctypes object allocated from shared memory which is a copy of the " "ctypes object *obj*." msgstr "" -#: library/multiprocessing.rst:1624 +#: library/multiprocessing.rst:1627 msgid "" "Return a process-safe wrapper object for a ctypes object which uses *lock* " "to synchronize access. If *lock* is ``None`` (the default) then a :class:" "`multiprocessing.RLock` object is created automatically." msgstr "" -#: library/multiprocessing.rst:1628 +#: library/multiprocessing.rst:1631 msgid "" "A synchronized wrapper will have two methods in addition to those of the " "object it wraps: :meth:`get_obj` returns the wrapped object and :meth:" "`get_lock` returns the lock object used for synchronization." msgstr "" -#: library/multiprocessing.rst:1632 +#: library/multiprocessing.rst:1635 msgid "" "Note that accessing the ctypes object through the wrapper can be a lot " "slower than accessing the raw ctypes object." msgstr "" -#: library/multiprocessing.rst:1635 +#: library/multiprocessing.rst:1638 msgid "Synchronized objects support the :term:`context manager` protocol." msgstr "" -#: library/multiprocessing.rst:1639 +#: library/multiprocessing.rst:1642 msgid "" "The table below compares the syntax for creating shared ctypes objects from " "shared memory with the normal ctypes syntax. (In the table ``MyStruct`` is " "some subclass of :class:`ctypes.Structure`.)" msgstr "" -#: library/multiprocessing.rst:1644 +#: library/multiprocessing.rst:1647 msgid "ctypes" msgstr "" -#: library/multiprocessing.rst:1644 +#: library/multiprocessing.rst:1647 msgid "sharedctypes using type" msgstr "" -#: library/multiprocessing.rst:1644 +#: library/multiprocessing.rst:1647 msgid "sharedctypes using typecode" msgstr "" -#: library/multiprocessing.rst:1646 +#: library/multiprocessing.rst:1649 msgid "c_double(2.4)" msgstr "" -#: library/multiprocessing.rst:1646 +#: library/multiprocessing.rst:1649 msgid "RawValue(c_double, 2.4)" msgstr "" -#: library/multiprocessing.rst:1646 +#: library/multiprocessing.rst:1649 msgid "RawValue('d', 2.4)" msgstr "" -#: library/multiprocessing.rst:1647 +#: library/multiprocessing.rst:1650 msgid "MyStruct(4, 6)" msgstr "" -#: library/multiprocessing.rst:1647 +#: library/multiprocessing.rst:1650 msgid "RawValue(MyStruct, 4, 6)" msgstr "" -#: library/multiprocessing.rst:1648 +#: library/multiprocessing.rst:1651 msgid "(c_short * 7)()" msgstr "" -#: library/multiprocessing.rst:1648 +#: library/multiprocessing.rst:1651 msgid "RawArray(c_short, 7)" msgstr "" -#: library/multiprocessing.rst:1648 +#: library/multiprocessing.rst:1651 msgid "RawArray('h', 7)" msgstr "" -#: library/multiprocessing.rst:1649 +#: library/multiprocessing.rst:1652 msgid "(c_int * 3)(9, 2, 8)" msgstr "" -#: library/multiprocessing.rst:1649 +#: library/multiprocessing.rst:1652 msgid "RawArray(c_int, (9, 2, 8))" msgstr "" -#: library/multiprocessing.rst:1649 +#: library/multiprocessing.rst:1652 msgid "RawArray('i', (9, 2, 8))" msgstr "" -#: library/multiprocessing.rst:1653 +#: library/multiprocessing.rst:1656 msgid "" "Below is an example where a number of ctypes objects are modified by a child " "process::" msgstr "" -#: library/multiprocessing.rst:1691 +#: library/multiprocessing.rst:1694 msgid "The results printed are ::" msgstr "" -#: library/multiprocessing.rst:1704 +#: library/multiprocessing.rst:1707 msgid "Managers" msgstr "" -#: library/multiprocessing.rst:1706 +#: library/multiprocessing.rst:1709 msgid "" "Managers provide a way to create data which can be shared between different " "processes, including sharing over a network between processes running on " @@ -1914,7 +1930,7 @@ msgid "" "proxies." msgstr "" -#: library/multiprocessing.rst:1715 +#: library/multiprocessing.rst:1718 msgid "" "Returns a started :class:`~multiprocessing.managers.SyncManager` object " "which can be used for sharing objects between processes. The returned " @@ -1922,31 +1938,31 @@ msgid "" "will create shared objects and return corresponding proxies." msgstr "" -#: library/multiprocessing.rst:1723 +#: library/multiprocessing.rst:1726 msgid "" "Manager processes will be shutdown as soon as they are garbage collected or " "their parent process exits. The manager classes are defined in the :mod:" "`multiprocessing.managers` module:" msgstr "" -#: library/multiprocessing.rst:1729 +#: library/multiprocessing.rst:1732 msgid "Create a BaseManager object." msgstr "" -#: library/multiprocessing.rst:1731 +#: library/multiprocessing.rst:1734 msgid "" "Once created one should call :meth:`start` or ``get_server()." "serve_forever()`` to ensure that the manager object refers to a started " "manager process." msgstr "" -#: library/multiprocessing.rst:1734 +#: library/multiprocessing.rst:1737 msgid "" "*address* is the address on which the manager process listens for new " "connections. If *address* is ``None`` then an arbitrary one is chosen." msgstr "" -#: library/multiprocessing.rst:1737 +#: library/multiprocessing.rst:1740 msgid "" "*authkey* is the authentication key which will be used to check the validity " "of incoming connections to the server process. If *authkey* is ``None`` " @@ -1954,19 +1970,19 @@ msgid "" "it must be a byte string." msgstr "" -#: library/multiprocessing.rst:1742 +#: library/multiprocessing.rst:1745 msgid "" "*serializer* must be ``'pickle'`` (use :mod:`pickle` serialization) or " "``'xmlrpclib'`` (use :mod:`xmlrpc.client` serialization)." msgstr "" -#: library/multiprocessing.rst:1745 +#: library/multiprocessing.rst:1748 msgid "" "*ctx* is a context object, or ``None`` (use the current context). See the :" "func:`get_context` function." msgstr "" -#: library/multiprocessing.rst:1748 +#: library/multiprocessing.rst:1751 msgid "" "*shutdown_timeout* is a timeout in seconds used to wait until the process " "used by the manager completes in the :meth:`shutdown` method. If the " @@ -1974,54 +1990,54 @@ msgid "" "also times out, the process is killed." msgstr "" -#: library/multiprocessing.rst:1753 +#: library/multiprocessing.rst:1756 msgid "Added the *shutdown_timeout* parameter." msgstr "" -#: library/multiprocessing.rst:1758 +#: library/multiprocessing.rst:1761 msgid "" "Start a subprocess to start the manager. If *initializer* is not ``None`` " "then the subprocess will call ``initializer(*initargs)`` when it starts." msgstr "" -#: library/multiprocessing.rst:1763 +#: library/multiprocessing.rst:1766 msgid "" "Returns a :class:`Server` object which represents the actual server under " "the control of the Manager. The :class:`Server` object supports the :meth:" "`serve_forever` method::" msgstr "" -#: library/multiprocessing.rst:1772 +#: library/multiprocessing.rst:1775 msgid ":class:`Server` additionally has an :attr:`address` attribute." msgstr "" -#: library/multiprocessing.rst:1776 +#: library/multiprocessing.rst:1779 msgid "Connect a local manager object to a remote manager process::" msgstr "" -#: library/multiprocessing.rst:1784 +#: library/multiprocessing.rst:1787 msgid "" "Stop the process used by the manager. This is only available if :meth:" "`start` has been used to start the server process." msgstr "" -#: library/multiprocessing.rst:1787 +#: library/multiprocessing.rst:1790 msgid "This can be called multiple times." msgstr "" -#: library/multiprocessing.rst:1791 +#: library/multiprocessing.rst:1794 msgid "" "A classmethod which can be used for registering a type or callable with the " "manager class." msgstr "" -#: library/multiprocessing.rst:1794 +#: library/multiprocessing.rst:1797 msgid "" "*typeid* is a \"type identifier\" which is used to identify a particular " "type of shared object. This must be a string." msgstr "" -#: library/multiprocessing.rst:1797 +#: library/multiprocessing.rst:1800 msgid "" "*callable* is a callable used for creating objects for this type " "identifier. If a manager instance will be connected to the server using " @@ -2029,14 +2045,14 @@ msgid "" "then this can be left as ``None``." msgstr "" -#: library/multiprocessing.rst:1803 +#: library/multiprocessing.rst:1806 msgid "" "*proxytype* is a subclass of :class:`BaseProxy` which is used to create " "proxies for shared objects with this *typeid*. If ``None`` then a proxy " "class is created automatically." msgstr "" -#: library/multiprocessing.rst:1807 +#: library/multiprocessing.rst:1810 msgid "" "*exposed* is used to specify a sequence of method names which proxies for " "this typeid should be allowed to access using :meth:`BaseProxy." @@ -2047,7 +2063,7 @@ msgid "" "method and whose name does not begin with ``'_'``.)" msgstr "" -#: library/multiprocessing.rst:1816 +#: library/multiprocessing.rst:1819 msgid "" "*method_to_typeid* is a mapping used to specify the return type of those " "exposed methods which should return a proxy. It maps method names to typeid " @@ -2057,22 +2073,22 @@ msgid "" "returned by the method will be copied by value." msgstr "" -#: library/multiprocessing.rst:1823 +#: library/multiprocessing.rst:1826 msgid "" "*create_method* determines whether a method should be created with name " "*typeid* which can be used to tell the server process to create a new shared " "object and return a proxy for it. By default it is ``True``." msgstr "" -#: library/multiprocessing.rst:1827 +#: library/multiprocessing.rst:1830 msgid ":class:`BaseManager` instances also have one read-only property:" msgstr "" -#: library/multiprocessing.rst:1831 +#: library/multiprocessing.rst:1834 msgid "The address used by the manager." msgstr "" -#: library/multiprocessing.rst:1833 +#: library/multiprocessing.rst:1836 msgid "" "Manager objects support the context management protocol -- see :ref:" "`typecontextmanager`. :meth:`~contextmanager.__enter__` starts the server " @@ -2080,173 +2096,173 @@ msgid "" "object. :meth:`~contextmanager.__exit__` calls :meth:`shutdown`." msgstr "" -#: library/multiprocessing.rst:1839 +#: library/multiprocessing.rst:1842 msgid "" "In previous versions :meth:`~contextmanager.__enter__` did not start the " "manager's server process if it was not already started." msgstr "" -#: library/multiprocessing.rst:1844 +#: library/multiprocessing.rst:1847 msgid "" "A subclass of :class:`BaseManager` which can be used for the synchronization " "of processes. Objects of this type are returned by :func:`multiprocessing." "Manager`." msgstr "" -#: library/multiprocessing.rst:1848 +#: library/multiprocessing.rst:1851 msgid "" "Its methods create and return :ref:`multiprocessing-proxy_objects` for a " "number of commonly used data types to be synchronized across processes. This " "notably includes shared lists and dictionaries." msgstr "" -#: library/multiprocessing.rst:1854 +#: library/multiprocessing.rst:1857 msgid "" "Create a shared :class:`threading.Barrier` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1861 +#: library/multiprocessing.rst:1864 msgid "" "Create a shared :class:`threading.BoundedSemaphore` object and return a " "proxy for it." msgstr "" -#: library/multiprocessing.rst:1866 +#: library/multiprocessing.rst:1869 msgid "" "Create a shared :class:`threading.Condition` object and return a proxy for " "it." msgstr "" -#: library/multiprocessing.rst:1869 +#: library/multiprocessing.rst:1872 msgid "" "If *lock* is supplied then it should be a proxy for a :class:`threading." "Lock` or :class:`threading.RLock` object." msgstr "" -#: library/multiprocessing.rst:1877 +#: library/multiprocessing.rst:1880 msgid "" "Create a shared :class:`threading.Event` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1881 +#: library/multiprocessing.rst:1884 msgid "" "Create a shared :class:`threading.Lock` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1885 +#: library/multiprocessing.rst:1888 msgid "Create a shared :class:`Namespace` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1889 +#: library/multiprocessing.rst:1892 msgid "Create a shared :class:`queue.Queue` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1893 +#: library/multiprocessing.rst:1896 msgid "" "Create a shared :class:`threading.RLock` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1897 +#: library/multiprocessing.rst:1900 msgid "" "Create a shared :class:`threading.Semaphore` object and return a proxy for " "it." msgstr "" -#: library/multiprocessing.rst:1902 +#: library/multiprocessing.rst:1905 msgid "Create an array and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1906 +#: library/multiprocessing.rst:1909 msgid "" "Create an object with a writable ``value`` attribute and return a proxy for " "it." msgstr "" -#: library/multiprocessing.rst:1913 +#: library/multiprocessing.rst:1916 msgid "Create a shared :class:`dict` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1918 +#: library/multiprocessing.rst:1921 msgid "Create a shared :class:`list` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1920 +#: library/multiprocessing.rst:1923 msgid "" "Shared objects are capable of being nested. For example, a shared container " "object such as a shared list can contain other shared objects which will all " "be managed and synchronized by the :class:`SyncManager`." msgstr "" -#: library/multiprocessing.rst:1927 +#: library/multiprocessing.rst:1930 msgid "A type that can register with :class:`SyncManager`." msgstr "" -#: library/multiprocessing.rst:1929 +#: library/multiprocessing.rst:1932 msgid "" "A namespace object has no public methods, but does have writable attributes. " "Its representation shows the values of its attributes." msgstr "" -#: library/multiprocessing.rst:1932 +#: library/multiprocessing.rst:1935 msgid "" "However, when using a proxy for a namespace object, an attribute beginning " "with ``'_'`` will be an attribute of the proxy and not an attribute of the " "referent:" msgstr "" -#: library/multiprocessing.rst:1949 +#: library/multiprocessing.rst:1952 msgid "Customized managers" msgstr "" -#: library/multiprocessing.rst:1951 +#: library/multiprocessing.rst:1954 msgid "" "To create one's own manager, one creates a subclass of :class:`BaseManager` " "and uses the :meth:`~BaseManager.register` classmethod to register new types " "or callables with the manager class. For example::" msgstr "" -#: library/multiprocessing.rst:1976 +#: library/multiprocessing.rst:1979 msgid "Using a remote manager" msgstr "" -#: library/multiprocessing.rst:1978 +#: library/multiprocessing.rst:1981 msgid "" "It is possible to run a manager server on one machine and have clients use " "it from other machines (assuming that the firewalls involved allow it)." msgstr "" -#: library/multiprocessing.rst:1981 +#: library/multiprocessing.rst:1984 msgid "" "Running the following commands creates a server for a single shared queue " "which remote clients can access::" msgstr "" -#: library/multiprocessing.rst:1993 +#: library/multiprocessing.rst:1996 msgid "One client can access the server as follows::" msgstr "" -#: library/multiprocessing.rst:2003 +#: library/multiprocessing.rst:2006 msgid "Another client can also use it::" msgstr "" -#: library/multiprocessing.rst:2014 +#: library/multiprocessing.rst:2017 msgid "" "Local processes can also access that queue, using the code from above on the " "client to access it remotely::" msgstr "" -#: library/multiprocessing.rst:2039 +#: library/multiprocessing.rst:2042 msgid "Proxy Objects" msgstr "" -#: library/multiprocessing.rst:2041 +#: library/multiprocessing.rst:2044 msgid "" "A proxy is an object which *refers* to a shared object which lives " "(presumably) in a different process. The shared object is said to be the " "*referent* of the proxy. Multiple proxy objects may have the same referent." msgstr "" -#: library/multiprocessing.rst:2045 +#: library/multiprocessing.rst:2048 msgid "" "A proxy object has methods which invoke corresponding methods of its " "referent (although not every method of the referent will necessarily be " @@ -2254,14 +2270,14 @@ msgid "" "its referent can:" msgstr "" -#: library/multiprocessing.rst:2063 +#: library/multiprocessing.rst:2066 msgid "" "Notice that applying :func:`str` to a proxy will return the representation " "of the referent, whereas applying :func:`repr` will return the " "representation of the proxy." msgstr "" -#: library/multiprocessing.rst:2067 +#: library/multiprocessing.rst:2070 msgid "" "An important feature of proxy objects is that they are picklable so they can " "be passed between processes. As such, a referent can contain :ref:" @@ -2269,11 +2285,11 @@ msgid "" "lists, dicts, and other :ref:`multiprocessing-proxy_objects`:" msgstr "" -#: library/multiprocessing.rst:2083 +#: library/multiprocessing.rst:2086 msgid "Similarly, dict and list proxies may be nested inside one another::" msgstr "" -#: library/multiprocessing.rst:2096 +#: library/multiprocessing.rst:2099 msgid "" "If standard (non-proxy) :class:`list` or :class:`dict` objects are contained " "in a referent, modifications to those mutable values will not be propagated " @@ -2284,53 +2300,53 @@ msgid "" "assign the modified value to the container proxy::" msgstr "" -#: library/multiprocessing.rst:2115 +#: library/multiprocessing.rst:2118 msgid "" "This approach is perhaps less convenient than employing nested :ref:" "`multiprocessing-proxy_objects` for most use cases but also demonstrates a " "level of control over the synchronization." msgstr "" -#: library/multiprocessing.rst:2121 +#: library/multiprocessing.rst:2124 msgid "" "The proxy types in :mod:`multiprocessing` do nothing to support comparisons " "by value. So, for instance, we have:" msgstr "" -#: library/multiprocessing.rst:2129 +#: library/multiprocessing.rst:2132 msgid "" "One should just use a copy of the referent instead when making comparisons." msgstr "" -#: library/multiprocessing.rst:2133 +#: library/multiprocessing.rst:2136 msgid "Proxy objects are instances of subclasses of :class:`BaseProxy`." msgstr "" -#: library/multiprocessing.rst:2137 +#: library/multiprocessing.rst:2140 msgid "Call and return the result of a method of the proxy's referent." msgstr "" -#: library/multiprocessing.rst:2139 +#: library/multiprocessing.rst:2142 msgid "" "If ``proxy`` is a proxy whose referent is ``obj`` then the expression ::" msgstr "" -#: library/multiprocessing.rst:2143 +#: library/multiprocessing.rst:2146 msgid "will evaluate the expression ::" msgstr "" -#: library/multiprocessing.rst:2147 +#: library/multiprocessing.rst:2150 msgid "in the manager's process." msgstr "" -#: library/multiprocessing.rst:2149 +#: library/multiprocessing.rst:2152 msgid "" "The returned value will be a copy of the result of the call or a proxy to a " "new shared object -- see documentation for the *method_to_typeid* argument " "of :meth:`BaseManager.register`." msgstr "" -#: library/multiprocessing.rst:2153 +#: library/multiprocessing.rst:2156 msgid "" "If an exception is raised by the call, then is re-raised by :meth:" "`_callmethod`. If some other exception is raised in the manager's process " @@ -2338,78 +2354,78 @@ msgid "" "meth:`_callmethod`." msgstr "" -#: library/multiprocessing.rst:2158 +#: library/multiprocessing.rst:2161 msgid "" "Note in particular that an exception will be raised if *methodname* has not " "been *exposed*." msgstr "" -#: library/multiprocessing.rst:2161 +#: library/multiprocessing.rst:2164 msgid "An example of the usage of :meth:`_callmethod`:" msgstr "" -#: library/multiprocessing.rst:2177 +#: library/multiprocessing.rst:2180 msgid "Return a copy of the referent." msgstr "" -#: library/multiprocessing.rst:2179 +#: library/multiprocessing.rst:2182 msgid "If the referent is unpicklable then this will raise an exception." msgstr "" -#: library/multiprocessing.rst:2183 +#: library/multiprocessing.rst:2186 msgid "Return a representation of the proxy object." msgstr "" -#: library/multiprocessing.rst:2187 +#: library/multiprocessing.rst:2190 msgid "Return the representation of the referent." msgstr "" -#: library/multiprocessing.rst:2191 +#: library/multiprocessing.rst:2194 msgid "Cleanup" msgstr "" -#: library/multiprocessing.rst:2193 +#: library/multiprocessing.rst:2196 msgid "" "A proxy object uses a weakref callback so that when it gets garbage " "collected it deregisters itself from the manager which owns its referent." msgstr "" -#: library/multiprocessing.rst:2196 +#: library/multiprocessing.rst:2199 msgid "" "A shared object gets deleted from the manager process when there are no " "longer any proxies referring to it." msgstr "" -#: library/multiprocessing.rst:2201 +#: library/multiprocessing.rst:2204 msgid "Process Pools" msgstr "" -#: library/multiprocessing.rst:2206 +#: library/multiprocessing.rst:2209 msgid "" "One can create a pool of processes which will carry out tasks submitted to " "it with the :class:`Pool` class." msgstr "" -#: library/multiprocessing.rst:2211 +#: library/multiprocessing.rst:2214 msgid "" "A process pool object which controls a pool of worker processes to which " "jobs can be submitted. It supports asynchronous results with timeouts and " "callbacks and has a parallel map implementation." msgstr "" -#: library/multiprocessing.rst:2215 +#: library/multiprocessing.rst:2218 msgid "" "*processes* is the number of worker processes to use. If *processes* is " "``None`` then the number returned by :func:`os.cpu_count` is used." msgstr "" -#: library/multiprocessing.rst:2218 library/multiprocessing.rst:2779 +#: library/multiprocessing.rst:2221 library/multiprocessing.rst:2782 msgid "" "If *initializer* is not ``None`` then each worker process will call " "``initializer(*initargs)`` when it starts." msgstr "" -#: library/multiprocessing.rst:2221 +#: library/multiprocessing.rst:2224 msgid "" "*maxtasksperchild* is the number of tasks a worker process can complete " "before it will exit and be replaced with a fresh worker process, to enable " @@ -2417,7 +2433,7 @@ msgid "" "which means worker processes will live as long as the pool." msgstr "" -#: library/multiprocessing.rst:2226 +#: library/multiprocessing.rst:2229 msgid "" "*context* can be used to specify the context used for starting the worker " "processes. Usually a pool is created using the function :func:" @@ -2425,13 +2441,13 @@ msgid "" "both cases *context* is set appropriately." msgstr "" -#: library/multiprocessing.rst:2232 +#: library/multiprocessing.rst:2235 msgid "" "Note that the methods of the pool object should only be called by the " "process which created the pool." msgstr "" -#: library/multiprocessing.rst:2236 +#: library/multiprocessing.rst:2239 msgid "" ":class:`multiprocessing.pool` objects have internal resources that need to " "be properly managed (like any other resource) by using the pool as a context " @@ -2439,22 +2455,22 @@ msgid "" "to do this can lead to the process hanging on finalization." msgstr "" -#: library/multiprocessing.rst:2241 +#: library/multiprocessing.rst:2244 msgid "" "Note that it is **not correct** to rely on the garbage collector to destroy " "the pool as CPython does not assure that the finalizer of the pool will be " "called (see :meth:`object.__del__` for more information)." msgstr "" -#: library/multiprocessing.rst:2245 +#: library/multiprocessing.rst:2248 msgid "Added the *maxtasksperchild* parameter." msgstr "" -#: library/multiprocessing.rst:2248 +#: library/multiprocessing.rst:2251 msgid "Added the *context* parameter." msgstr "" -#: library/multiprocessing.rst:2253 +#: library/multiprocessing.rst:2256 msgid "" "Worker processes within a :class:`Pool` typically live for the complete " "duration of the Pool's work queue. A frequent pattern found in other systems " @@ -2465,7 +2481,7 @@ msgid "" "ability to the end user." msgstr "" -#: library/multiprocessing.rst:2263 +#: library/multiprocessing.rst:2266 msgid "" "Call *func* with arguments *args* and keyword arguments *kwds*. It blocks " "until the result is ready. Given this blocks, :meth:`apply_async` is better " @@ -2473,13 +2489,13 @@ msgid "" "executed in one of the workers of the pool." msgstr "" -#: library/multiprocessing.rst:2270 +#: library/multiprocessing.rst:2273 msgid "" "A variant of the :meth:`apply` method which returns a :class:" "`~multiprocessing.pool.AsyncResult` object." msgstr "" -#: library/multiprocessing.rst:2273 library/multiprocessing.rst:2304 +#: library/multiprocessing.rst:2276 library/multiprocessing.rst:2307 msgid "" "If *callback* is specified then it should be a callable which accepts a " "single argument. When the result becomes ready *callback* is applied to it, " @@ -2487,58 +2503,58 @@ msgid "" "applied instead." msgstr "" -#: library/multiprocessing.rst:2278 library/multiprocessing.rst:2309 +#: library/multiprocessing.rst:2281 library/multiprocessing.rst:2312 msgid "" "If *error_callback* is specified then it should be a callable which accepts " "a single argument. If the target function fails, then the *error_callback* " "is called with the exception instance." msgstr "" -#: library/multiprocessing.rst:2282 library/multiprocessing.rst:2313 +#: library/multiprocessing.rst:2285 library/multiprocessing.rst:2316 msgid "" "Callbacks should complete immediately since otherwise the thread which " "handles the results will get blocked." msgstr "" -#: library/multiprocessing.rst:2287 +#: library/multiprocessing.rst:2290 msgid "" "A parallel equivalent of the :func:`map` built-in function (it supports only " "one *iterable* argument though, for multiple iterables see :meth:`starmap`). " "It blocks until the result is ready." msgstr "" -#: library/multiprocessing.rst:2291 +#: library/multiprocessing.rst:2294 msgid "" "This method chops the iterable into a number of chunks which it submits to " "the process pool as separate tasks. The (approximate) size of these chunks " "can be specified by setting *chunksize* to a positive integer." msgstr "" -#: library/multiprocessing.rst:2295 +#: library/multiprocessing.rst:2298 msgid "" "Note that it may cause high memory usage for very long iterables. Consider " "using :meth:`imap` or :meth:`imap_unordered` with explicit *chunksize* " "option for better efficiency." msgstr "" -#: library/multiprocessing.rst:2301 +#: library/multiprocessing.rst:2304 msgid "" "A variant of the :meth:`.map` method which returns a :class:" "`~multiprocessing.pool.AsyncResult` object." msgstr "" -#: library/multiprocessing.rst:2318 +#: library/multiprocessing.rst:2321 msgid "A lazier version of :meth:`.map`." msgstr "" -#: library/multiprocessing.rst:2320 +#: library/multiprocessing.rst:2323 msgid "" "The *chunksize* argument is the same as the one used by the :meth:`.map` " "method. For very long iterables using a large value for *chunksize* can " "make the job complete **much** faster than using the default value of ``1``." msgstr "" -#: library/multiprocessing.rst:2325 +#: library/multiprocessing.rst:2328 msgid "" "Also if *chunksize* is ``1`` then the :meth:`!next` method of the iterator " "returned by the :meth:`imap` method has an optional *timeout* parameter: " @@ -2546,65 +2562,65 @@ msgid "" "result cannot be returned within *timeout* seconds." msgstr "" -#: library/multiprocessing.rst:2332 +#: library/multiprocessing.rst:2335 msgid "" "The same as :meth:`imap` except that the ordering of the results from the " "returned iterator should be considered arbitrary. (Only when there is only " "one worker process is the order guaranteed to be \"correct\".)" msgstr "" -#: library/multiprocessing.rst:2338 +#: library/multiprocessing.rst:2341 msgid "" "Like :meth:`~multiprocessing.pool.Pool.map` except that the elements of the " "*iterable* are expected to be iterables that are unpacked as arguments." msgstr "" -#: library/multiprocessing.rst:2342 +#: library/multiprocessing.rst:2345 msgid "" "Hence an *iterable* of ``[(1,2), (3, 4)]`` results in ``[func(1,2), " "func(3,4)]``." msgstr "" -#: library/multiprocessing.rst:2349 +#: library/multiprocessing.rst:2352 msgid "" "A combination of :meth:`starmap` and :meth:`map_async` that iterates over " "*iterable* of iterables and calls *func* with the iterables unpacked. " "Returns a result object." msgstr "" -#: library/multiprocessing.rst:2357 +#: library/multiprocessing.rst:2360 msgid "" "Prevents any more tasks from being submitted to the pool. Once all the " "tasks have been completed the worker processes will exit." msgstr "" -#: library/multiprocessing.rst:2362 +#: library/multiprocessing.rst:2365 msgid "" "Stops the worker processes immediately without completing outstanding work. " "When the pool object is garbage collected :meth:`terminate` will be called " "immediately." msgstr "" -#: library/multiprocessing.rst:2368 +#: library/multiprocessing.rst:2371 msgid "" "Wait for the worker processes to exit. One must call :meth:`close` or :meth:" "`terminate` before using :meth:`join`." msgstr "" -#: library/multiprocessing.rst:2371 +#: library/multiprocessing.rst:2374 msgid "" "Pool objects now support the context management protocol -- see :ref:" "`typecontextmanager`. :meth:`~contextmanager.__enter__` returns the pool " "object, and :meth:`~contextmanager.__exit__` calls :meth:`terminate`." msgstr "" -#: library/multiprocessing.rst:2379 +#: library/multiprocessing.rst:2382 msgid "" "The class of the result returned by :meth:`Pool.apply_async` and :meth:`Pool." "map_async`." msgstr "" -#: library/multiprocessing.rst:2384 +#: library/multiprocessing.rst:2387 msgid "" "Return the result when it arrives. If *timeout* is not ``None`` and the " "result does not arrive within *timeout* seconds then :exc:`multiprocessing." @@ -2612,41 +2628,41 @@ msgid "" "exception will be reraised by :meth:`get`." msgstr "" -#: library/multiprocessing.rst:2391 +#: library/multiprocessing.rst:2394 msgid "Wait until the result is available or until *timeout* seconds pass." msgstr "" -#: library/multiprocessing.rst:2395 +#: library/multiprocessing.rst:2398 msgid "Return whether the call has completed." msgstr "" -#: library/multiprocessing.rst:2399 +#: library/multiprocessing.rst:2402 msgid "" "Return whether the call completed without raising an exception. Will raise :" "exc:`ValueError` if the result is not ready." msgstr "" -#: library/multiprocessing.rst:2402 +#: library/multiprocessing.rst:2405 msgid "" "If the result is not ready, :exc:`ValueError` is raised instead of :exc:" "`AssertionError`." msgstr "" -#: library/multiprocessing.rst:2406 +#: library/multiprocessing.rst:2409 msgid "The following example demonstrates the use of a pool::" msgstr "" -#: library/multiprocessing.rst:2433 +#: library/multiprocessing.rst:2436 msgid "Listeners and Clients" msgstr "" -#: library/multiprocessing.rst:2438 +#: library/multiprocessing.rst:2441 msgid "" "Usually message passing between processes is done using queues or by using :" "class:`~Connection` objects returned by :func:`~multiprocessing.Pipe`." msgstr "" -#: library/multiprocessing.rst:2442 +#: library/multiprocessing.rst:2445 msgid "" "However, the :mod:`multiprocessing.connection` module allows some extra " "flexibility. It basically gives a high level message oriented API for " @@ -2655,45 +2671,45 @@ msgid "" "multiple connections at the same time." msgstr "" -#: library/multiprocessing.rst:2451 +#: library/multiprocessing.rst:2454 msgid "" "Send a randomly generated message to the other end of the connection and " "wait for a reply." msgstr "" -#: library/multiprocessing.rst:2454 +#: library/multiprocessing.rst:2457 msgid "" "If the reply matches the digest of the message using *authkey* as the key " "then a welcome message is sent to the other end of the connection. " "Otherwise :exc:`~multiprocessing.AuthenticationError` is raised." msgstr "" -#: library/multiprocessing.rst:2460 +#: library/multiprocessing.rst:2463 msgid "" "Receive a message, calculate the digest of the message using *authkey* as " "the key, and then send the digest back." msgstr "" -#: library/multiprocessing.rst:2463 +#: library/multiprocessing.rst:2466 msgid "" "If a welcome message is not received, then :exc:`~multiprocessing." "AuthenticationError` is raised." msgstr "" -#: library/multiprocessing.rst:2468 +#: library/multiprocessing.rst:2471 msgid "" "Attempt to set up a connection to the listener which is using address " "*address*, returning a :class:`~Connection`." msgstr "" -#: library/multiprocessing.rst:2471 +#: library/multiprocessing.rst:2474 msgid "" "The type of the connection is determined by *family* argument, but this can " "generally be omitted since it can usually be inferred from the format of " "*address*. (See :ref:`multiprocessing-address-formats`)" msgstr "" -#: library/multiprocessing.rst:2475 library/multiprocessing.rst:2510 +#: library/multiprocessing.rst:2478 library/multiprocessing.rst:2513 msgid "" "If *authkey* is given and not ``None``, it should be a byte string and will " "be used as the secret key for an HMAC-based authentication challenge. No " @@ -2702,26 +2718,26 @@ msgid "" "`multiprocessing-auth-keys`." msgstr "" -#: library/multiprocessing.rst:2483 +#: library/multiprocessing.rst:2486 msgid "" "A wrapper for a bound socket or Windows named pipe which is 'listening' for " "connections." msgstr "" -#: library/multiprocessing.rst:2486 +#: library/multiprocessing.rst:2489 msgid "" "*address* is the address to be used by the bound socket or named pipe of the " "listener object." msgstr "" -#: library/multiprocessing.rst:2491 +#: library/multiprocessing.rst:2494 msgid "" "If an address of '0.0.0.0' is used, the address will not be a connectable " "end point on Windows. If you require a connectable end-point, you should use " "'127.0.0.1'." msgstr "" -#: library/multiprocessing.rst:2495 +#: library/multiprocessing.rst:2498 msgid "" "*family* is the type of socket (or named pipe) to use. This can be one of " "the strings ``'AF_INET'`` (for a TCP socket), ``'AF_UNIX'`` (for a Unix " @@ -2735,49 +2751,49 @@ msgid "" "using :func:`tempfile.mkstemp`." msgstr "" -#: library/multiprocessing.rst:2506 +#: library/multiprocessing.rst:2509 msgid "" "If the listener object uses a socket then *backlog* (1 by default) is passed " "to the :meth:`~socket.socket.listen` method of the socket once it has been " "bound." msgstr "" -#: library/multiprocessing.rst:2518 +#: library/multiprocessing.rst:2521 msgid "" "Accept a connection on the bound socket or named pipe of the listener object " "and return a :class:`~Connection` object. If authentication is attempted and " "fails, then :exc:`~multiprocessing.AuthenticationError` is raised." msgstr "" -#: library/multiprocessing.rst:2525 +#: library/multiprocessing.rst:2528 msgid "" "Close the bound socket or named pipe of the listener object. This is called " "automatically when the listener is garbage collected. However it is " "advisable to call it explicitly." msgstr "" -#: library/multiprocessing.rst:2529 +#: library/multiprocessing.rst:2532 msgid "Listener objects have the following read-only properties:" msgstr "" -#: library/multiprocessing.rst:2533 +#: library/multiprocessing.rst:2536 msgid "The address which is being used by the Listener object." msgstr "" -#: library/multiprocessing.rst:2537 +#: library/multiprocessing.rst:2540 msgid "" "The address from which the last accepted connection came. If this is " "unavailable then it is ``None``." msgstr "" -#: library/multiprocessing.rst:2540 +#: library/multiprocessing.rst:2543 msgid "" "Listener objects now support the context management protocol -- see :ref:" "`typecontextmanager`. :meth:`~contextmanager.__enter__` returns the " "listener object, and :meth:`~contextmanager.__exit__` calls :meth:`close`." msgstr "" -#: library/multiprocessing.rst:2547 +#: library/multiprocessing.rst:2550 msgid "" "Wait till an object in *object_list* is ready. Returns the list of those " "objects in *object_list* which are ready. If *timeout* is a float then the " @@ -2786,32 +2802,32 @@ msgid "" "zero timeout." msgstr "" -#: library/multiprocessing.rst:2553 +#: library/multiprocessing.rst:2556 msgid "" "For both POSIX and Windows, an object can appear in *object_list* if it is" msgstr "" -#: library/multiprocessing.rst:2556 +#: library/multiprocessing.rst:2559 msgid "a readable :class:`~multiprocessing.connection.Connection` object;" msgstr "" -#: library/multiprocessing.rst:2557 +#: library/multiprocessing.rst:2560 msgid "a connected and readable :class:`socket.socket` object; or" msgstr "" -#: library/multiprocessing.rst:2558 +#: library/multiprocessing.rst:2561 msgid "" "the :attr:`~multiprocessing.Process.sentinel` attribute of a :class:" "`~multiprocessing.Process` object." msgstr "" -#: library/multiprocessing.rst:2561 +#: library/multiprocessing.rst:2564 msgid "" "A connection or socket object is ready when there is data available to be " "read from it, or the other end has been closed." msgstr "" -#: library/multiprocessing.rst:2564 +#: library/multiprocessing.rst:2567 msgid "" "**POSIX**: ``wait(object_list, timeout)`` almost equivalent ``select." "select(object_list, [], [], timeout)``. The difference is that, if :func:" @@ -2819,7 +2835,7 @@ msgid "" "an error number of ``EINTR``, whereas :func:`wait` will not." msgstr "" -#: library/multiprocessing.rst:2570 +#: library/multiprocessing.rst:2573 msgid "" "**Windows**: An item in *object_list* must either be an integer handle which " "is waitable (according to the definition used by the documentation of the " @@ -2829,46 +2845,46 @@ msgid "" "handles.)" msgstr "" -#: library/multiprocessing.rst:2580 +#: library/multiprocessing.rst:2583 msgid "**Examples**" msgstr "" -#: library/multiprocessing.rst:2582 +#: library/multiprocessing.rst:2585 msgid "" "The following server code creates a listener which uses ``'secret " "password'`` as an authentication key. It then waits for a connection and " "sends some data to the client::" msgstr "" -#: library/multiprocessing.rst:2601 +#: library/multiprocessing.rst:2604 msgid "" "The following code connects to the server and receives some data from the " "server::" msgstr "" -#: library/multiprocessing.rst:2618 +#: library/multiprocessing.rst:2621 msgid "" "The following code uses :func:`~multiprocessing.connection.wait` to wait for " "messages from multiple processes at once::" msgstr "" -#: library/multiprocessing.rst:2657 +#: library/multiprocessing.rst:2660 msgid "Address Formats" msgstr "" -#: library/multiprocessing.rst:2659 +#: library/multiprocessing.rst:2662 msgid "" "An ``'AF_INET'`` address is a tuple of the form ``(hostname, port)`` where " "*hostname* is a string and *port* is an integer." msgstr "" -#: library/multiprocessing.rst:2662 +#: library/multiprocessing.rst:2665 msgid "" "An ``'AF_UNIX'`` address is a string representing a filename on the " "filesystem." msgstr "" -#: library/multiprocessing.rst:2665 +#: library/multiprocessing.rst:2668 msgid "" "An ``'AF_PIPE'`` address is a string of the form :samp:`r'\\\\\\\\\\\\.\\" "\\pipe\\\\\\\\{PipeName}'`. To use :func:`Client` to connect to a named " @@ -2877,17 +2893,17 @@ msgid "" "instead." msgstr "" -#: library/multiprocessing.rst:2670 +#: library/multiprocessing.rst:2673 msgid "" "Note that any string beginning with two backslashes is assumed by default to " "be an ``'AF_PIPE'`` address rather than an ``'AF_UNIX'`` address." msgstr "" -#: library/multiprocessing.rst:2677 +#: library/multiprocessing.rst:2680 msgid "Authentication keys" msgstr "" -#: library/multiprocessing.rst:2679 +#: library/multiprocessing.rst:2682 msgid "" "When one uses :meth:`Connection.recv `, the data received " "is automatically unpickled. Unfortunately unpickling data from an untrusted " @@ -2895,7 +2911,7 @@ msgid "" "use the :mod:`hmac` module to provide digest authentication." msgstr "" -#: library/multiprocessing.rst:2685 +#: library/multiprocessing.rst:2688 msgid "" "An authentication key is a byte string which can be thought of as a " "password: once a connection is established both ends will demand proof that " @@ -2903,7 +2919,7 @@ msgid "" "using the same key does **not** involve sending the key over the connection.)" msgstr "" -#: library/multiprocessing.rst:2691 +#: library/multiprocessing.rst:2694 msgid "" "If authentication is requested but no authentication key is specified then " "the return value of ``current_process().authkey`` is used (see :class:" @@ -2914,17 +2930,17 @@ msgid "" "setting up connections between themselves." msgstr "" -#: library/multiprocessing.rst:2699 +#: library/multiprocessing.rst:2702 msgid "" "Suitable authentication keys can also be generated by using :func:`os." "urandom`." msgstr "" -#: library/multiprocessing.rst:2703 +#: library/multiprocessing.rst:2706 msgid "Logging" msgstr "" -#: library/multiprocessing.rst:2705 +#: library/multiprocessing.rst:2708 msgid "" "Some support for logging is available. Note, however, that the :mod:" "`logging` package does not use process shared locks so it is possible " @@ -2932,27 +2948,27 @@ msgid "" "mixed up." msgstr "" -#: library/multiprocessing.rst:2712 +#: library/multiprocessing.rst:2715 msgid "" "Returns the logger used by :mod:`multiprocessing`. If necessary, a new one " "will be created." msgstr "" -#: library/multiprocessing.rst:2715 +#: library/multiprocessing.rst:2718 msgid "" "When first created the logger has level :const:`logging.NOTSET` and no " "default handler. Messages sent to this logger will not by default propagate " "to the root logger." msgstr "" -#: library/multiprocessing.rst:2719 +#: library/multiprocessing.rst:2722 msgid "" "Note that on Windows child processes will only inherit the level of the " "parent process's logger -- any other customization of the logger will not be " "inherited." msgstr "" -#: library/multiprocessing.rst:2726 +#: library/multiprocessing.rst:2729 msgid "" "This function performs a call to :func:`get_logger` but in addition to " "returning the logger created by get_logger, it adds a handler which sends " @@ -2961,25 +2977,25 @@ msgid "" "``level`` argument." msgstr "" -#: library/multiprocessing.rst:2732 +#: library/multiprocessing.rst:2735 msgid "Below is an example session with logging turned on::" msgstr "" -#: library/multiprocessing.rst:2747 +#: library/multiprocessing.rst:2750 msgid "For a full table of logging levels, see the :mod:`logging` module." msgstr "" -#: library/multiprocessing.rst:2751 +#: library/multiprocessing.rst:2754 msgid "The :mod:`multiprocessing.dummy` module" msgstr "" -#: library/multiprocessing.rst:2756 +#: library/multiprocessing.rst:2759 msgid "" ":mod:`multiprocessing.dummy` replicates the API of :mod:`multiprocessing` " "but is no more than a wrapper around the :mod:`threading` module." msgstr "" -#: library/multiprocessing.rst:2761 +#: library/multiprocessing.rst:2764 msgid "" "In particular, the ``Pool`` function provided by :mod:`multiprocessing." "dummy` returns an instance of :class:`ThreadPool`, which is a subclass of :" @@ -2987,7 +3003,7 @@ msgid "" "worker threads rather than worker processes." msgstr "" -#: library/multiprocessing.rst:2769 +#: library/multiprocessing.rst:2772 msgid "" "A thread pool object which controls a pool of worker threads to which jobs " "can be submitted. :class:`ThreadPool` instances are fully interface " @@ -2997,18 +3013,18 @@ msgid "" "pool.Pool.terminate` manually." msgstr "" -#: library/multiprocessing.rst:2776 +#: library/multiprocessing.rst:2779 msgid "" "*processes* is the number of worker threads to use. If *processes* is " "``None`` then the number returned by :func:`os.cpu_count` is used." msgstr "" -#: library/multiprocessing.rst:2782 +#: library/multiprocessing.rst:2785 msgid "" "Unlike :class:`Pool`, *maxtasksperchild* and *context* cannot be provided." msgstr "" -#: library/multiprocessing.rst:2786 +#: library/multiprocessing.rst:2789 msgid "" "A :class:`ThreadPool` shares the same interface as :class:`Pool`, which is " "designed around a pool of processes and predates the introduction of the :" @@ -3018,7 +3034,7 @@ msgid "" "is not understood by any other libraries." msgstr "" -#: library/multiprocessing.rst:2793 +#: library/multiprocessing.rst:2796 msgid "" "Users should generally prefer to use :class:`concurrent.futures." "ThreadPoolExecutor`, which has a simpler interface that was designed around " @@ -3027,69 +3043,69 @@ msgid "" "`asyncio`." msgstr "" -#: library/multiprocessing.rst:2803 +#: library/multiprocessing.rst:2806 msgid "Programming guidelines" msgstr "" -#: library/multiprocessing.rst:2805 +#: library/multiprocessing.rst:2808 msgid "" "There are certain guidelines and idioms which should be adhered to when " "using :mod:`multiprocessing`." msgstr "" -#: library/multiprocessing.rst:2810 +#: library/multiprocessing.rst:2813 msgid "All start methods" msgstr "" -#: library/multiprocessing.rst:2812 +#: library/multiprocessing.rst:2815 msgid "The following applies to all start methods." msgstr "" -#: library/multiprocessing.rst:2814 +#: library/multiprocessing.rst:2817 msgid "Avoid shared state" msgstr "" -#: library/multiprocessing.rst:2816 +#: library/multiprocessing.rst:2819 msgid "" "As far as possible one should try to avoid shifting large amounts of data " "between processes." msgstr "" -#: library/multiprocessing.rst:2819 +#: library/multiprocessing.rst:2822 msgid "" "It is probably best to stick to using queues or pipes for communication " "between processes rather than using the lower level synchronization " "primitives." msgstr "" -#: library/multiprocessing.rst:2823 +#: library/multiprocessing.rst:2826 msgid "Picklability" msgstr "" -#: library/multiprocessing.rst:2825 +#: library/multiprocessing.rst:2828 msgid "Ensure that the arguments to the methods of proxies are picklable." msgstr "" -#: library/multiprocessing.rst:2827 +#: library/multiprocessing.rst:2830 msgid "Thread safety of proxies" msgstr "" -#: library/multiprocessing.rst:2829 +#: library/multiprocessing.rst:2832 msgid "" "Do not use a proxy object from more than one thread unless you protect it " "with a lock." msgstr "" -#: library/multiprocessing.rst:2832 +#: library/multiprocessing.rst:2835 msgid "" "(There is never a problem with different processes using the *same* proxy.)" msgstr "" -#: library/multiprocessing.rst:2834 +#: library/multiprocessing.rst:2837 msgid "Joining zombie processes" msgstr "" -#: library/multiprocessing.rst:2836 +#: library/multiprocessing.rst:2839 msgid "" "On POSIX when a process finishes but has not been joined it becomes a " "zombie. There should never be very many because each time a new process " @@ -3100,11 +3116,11 @@ msgid "" "explicitly join all the processes that you start." msgstr "" -#: library/multiprocessing.rst:2844 +#: library/multiprocessing.rst:2847 msgid "Better to inherit than pickle/unpickle" msgstr "" -#: library/multiprocessing.rst:2846 +#: library/multiprocessing.rst:2849 msgid "" "When using the *spawn* or *forkserver* start methods many types from :mod:" "`multiprocessing` need to be picklable so that child processes can use " @@ -3114,11 +3130,11 @@ msgid "" "inherit it from an ancestor process." msgstr "" -#: library/multiprocessing.rst:2854 +#: library/multiprocessing.rst:2857 msgid "Avoid terminating processes" msgstr "" -#: library/multiprocessing.rst:2856 +#: library/multiprocessing.rst:2859 msgid "" "Using the :meth:`Process.terminate ` " "method to stop a process is liable to cause any shared resources (such as " @@ -3126,18 +3142,18 @@ msgid "" "become broken or unavailable to other processes." msgstr "" -#: library/multiprocessing.rst:2862 +#: library/multiprocessing.rst:2865 msgid "" "Therefore it is probably best to only consider using :meth:`Process." "terminate ` on processes which never use " "any shared resources." msgstr "" -#: library/multiprocessing.rst:2866 +#: library/multiprocessing.rst:2869 msgid "Joining processes that use queues" msgstr "" -#: library/multiprocessing.rst:2868 +#: library/multiprocessing.rst:2871 msgid "" "Bear in mind that a process that has put items in a queue will wait before " "terminating until all the buffered items are fed by the \"feeder\" thread to " @@ -3146,7 +3162,7 @@ msgid "" "queue to avoid this behaviour.)" msgstr "" -#: library/multiprocessing.rst:2874 +#: library/multiprocessing.rst:2877 msgid "" "This means that whenever you use a queue you need to make sure that all " "items which have been put on the queue will eventually be removed before the " @@ -3155,21 +3171,21 @@ msgid "" "processes will be joined automatically." msgstr "" -#: library/multiprocessing.rst:2880 +#: library/multiprocessing.rst:2883 msgid "An example which will deadlock is the following::" msgstr "" -#: library/multiprocessing.rst:2894 +#: library/multiprocessing.rst:2897 msgid "" "A fix here would be to swap the last two lines (or simply remove the ``p." "join()`` line)." msgstr "" -#: library/multiprocessing.rst:2897 +#: library/multiprocessing.rst:2900 msgid "Explicitly pass resources to child processes" msgstr "" -#: library/multiprocessing.rst:2899 +#: library/multiprocessing.rst:2902 msgid "" "On POSIX using the *fork* start method, a child process can make use of a " "shared resource created in a parent process using a global resource. " @@ -3177,7 +3193,7 @@ msgid "" "for the child process." msgstr "" -#: library/multiprocessing.rst:2904 +#: library/multiprocessing.rst:2907 msgid "" "Apart from making the code (potentially) compatible with Windows and the " "other start methods this also ensures that as long as the child process is " @@ -3186,29 +3202,29 @@ msgid "" "collected in the parent process." msgstr "" -#: library/multiprocessing.rst:2911 +#: library/multiprocessing.rst:2914 msgid "So for instance ::" msgstr "" -#: library/multiprocessing.rst:2923 +#: library/multiprocessing.rst:2926 msgid "should be rewritten as ::" msgstr "" -#: library/multiprocessing.rst:2935 +#: library/multiprocessing.rst:2938 msgid "Beware of replacing :data:`sys.stdin` with a \"file like object\"" msgstr "" -#: library/multiprocessing.rst:2937 +#: library/multiprocessing.rst:2940 msgid ":mod:`multiprocessing` originally unconditionally called::" msgstr "" -#: library/multiprocessing.rst:2941 +#: library/multiprocessing.rst:2944 msgid "" "in the :meth:`multiprocessing.Process._bootstrap` method --- this resulted " "in issues with processes-in-processes. This has been changed to::" msgstr "" -#: library/multiprocessing.rst:2947 +#: library/multiprocessing.rst:2950 msgid "" "Which solves the fundamental issue of processes colliding with each other " "resulting in a bad file descriptor error, but introduces a potential danger " @@ -3218,33 +3234,33 @@ msgid "" "data being flushed to the object multiple times, resulting in corruption." msgstr "" -#: library/multiprocessing.rst:2954 +#: library/multiprocessing.rst:2957 msgid "" "If you write a file-like object and implement your own caching, you can make " "it fork-safe by storing the pid whenever you append to the cache, and " "discarding the cache when the pid changes. For example::" msgstr "" -#: library/multiprocessing.rst:2966 +#: library/multiprocessing.rst:2969 msgid "" "For more information, see :issue:`5155`, :issue:`5313` and :issue:`5331`" msgstr "" -#: library/multiprocessing.rst:2969 +#: library/multiprocessing.rst:2972 msgid "The *spawn* and *forkserver* start methods" msgstr "" -#: library/multiprocessing.rst:2971 +#: library/multiprocessing.rst:2974 msgid "" "There are a few extra restrictions which don't apply to the *fork* start " "method." msgstr "" -#: library/multiprocessing.rst:2974 +#: library/multiprocessing.rst:2977 msgid "More picklability" msgstr "" -#: library/multiprocessing.rst:2976 +#: library/multiprocessing.rst:2979 msgid "" "Ensure that all arguments to :meth:`Process.__init__` are picklable. Also, " "if you subclass :class:`~multiprocessing.Process` then make sure that " @@ -3252,11 +3268,11 @@ msgid "" "Process.start>` method is called." msgstr "" -#: library/multiprocessing.rst:2981 +#: library/multiprocessing.rst:2984 msgid "Global variables" msgstr "" -#: library/multiprocessing.rst:2983 +#: library/multiprocessing.rst:2986 msgid "" "Bear in mind that if code run in a child process tries to access a global " "variable, then the value it sees (if any) may not be the same as the value " @@ -3264,66 +3280,66 @@ msgid "" "Process.start>` was called." msgstr "" -#: library/multiprocessing.rst:2988 +#: library/multiprocessing.rst:2991 msgid "" "However, global variables which are just module level constants cause no " "problems." msgstr "" -#: library/multiprocessing.rst:2993 +#: library/multiprocessing.rst:2996 msgid "Safe importing of main module" msgstr "" -#: library/multiprocessing.rst:2995 +#: library/multiprocessing.rst:2998 msgid "" "Make sure that the main module can be safely imported by a new Python " "interpreter without causing unintended side effects (such as starting a new " "process)." msgstr "" -#: library/multiprocessing.rst:2999 +#: library/multiprocessing.rst:3002 msgid "" "For example, using the *spawn* or *forkserver* start method running the " "following module would fail with a :exc:`RuntimeError`::" msgstr "" -#: library/multiprocessing.rst:3011 +#: library/multiprocessing.rst:3014 msgid "" "Instead one should protect the \"entry point\" of the program by using ``if " "__name__ == '__main__':`` as follows::" msgstr "" -#: library/multiprocessing.rst:3025 +#: library/multiprocessing.rst:3028 msgid "" "(The ``freeze_support()`` line can be omitted if the program will be run " "normally instead of frozen.)" msgstr "" -#: library/multiprocessing.rst:3028 +#: library/multiprocessing.rst:3031 msgid "" "This allows the newly spawned Python interpreter to safely import the module " "and then run the module's ``foo()`` function." msgstr "" -#: library/multiprocessing.rst:3031 +#: library/multiprocessing.rst:3034 msgid "" "Similar restrictions apply if a pool or manager is created in the main " "module." msgstr "" -#: library/multiprocessing.rst:3038 +#: library/multiprocessing.rst:3041 msgid "Examples" msgstr "" -#: library/multiprocessing.rst:3040 +#: library/multiprocessing.rst:3043 msgid "Demonstration of how to create and use customized managers and proxies:" msgstr "" -#: library/multiprocessing.rst:3046 +#: library/multiprocessing.rst:3049 msgid "Using :class:`~multiprocessing.pool.Pool`:" msgstr "" -#: library/multiprocessing.rst:3052 +#: library/multiprocessing.rst:3055 msgid "" "An example showing how to use queues to feed tasks to a collection of worker " "processes and collect the results:" diff --git a/library/nis.po b/library/nis.po index b242fc9f2..347982cb9 100644 --- a/library/nis.po +++ b/library/nis.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-03-01 00:18+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -20,7 +20,7 @@ msgstr "" msgid ":mod:`nis` --- Interface to Sun's NIS (Yellow Pages)" msgstr "" -#: library/nis.rst:16 +#: library/nis.rst:13 msgid "" "The :mod:`nis` module is deprecated (see :pep:`PEP 594 <594#nis>` for " "details)." diff --git a/library/nntplib.po b/library/nntplib.po index df48185e7..56f39e305 100644 --- a/library/nntplib.po +++ b/library/nntplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -81,16 +81,15 @@ msgid "" "close the NNTP connection when done, e.g.:" msgstr "" -#: library/nntplib.rst:148 +#: library/nntplib.rst:137 msgid "" -"Raises an :ref:`auditing event ` ``nntplib.connect`` with " -"arguments ``self``, ``host``, ``port``." +"Raises an auditing event nntplib.connect with arguments self, host, port." msgstr "" -#: library/nntplib.rst:150 +#: library/nntplib.rst:139 msgid "" -"Raises an :ref:`auditing event ` ``nntplib.putline`` with " -"arguments ``self``, ``line``." +"All commands will raise an auditing event nntplib.putline with arguments " +"self and line, where line is the bytes about to be sent to the remote host." msgstr "" #: library/nntplib.rst:141 diff --git a/library/optparse.po b/library/optparse.po index 4d8c2faf9..2d72fe392 100644 --- a/library/optparse.po +++ b/library/optparse.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1624,7 +1624,7 @@ msgstr "" #: library/optparse.rst:1354 msgid "" -"an :class:`Values` object to store option arguments in (default: a new " +"a :class:`Values` object to store option arguments in (default: a new " "instance of :class:`Values`) -- if you give an existing object, the option " "defaults will not be initialized on it" msgstr "" diff --git a/library/os.path.po b/library/os.path.po index 015793474..5c9b0d8fd 100644 --- a/library/os.path.po +++ b/library/os.path.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -206,7 +206,7 @@ msgstr "" #: library/os.path.rst:201 msgid "" -"Return the time of last access of *path*. The return value is a floating " +"Return the time of last access of *path*. The return value is a floating-" "point number giving the number of seconds since the epoch (see the :mod:" "`time` module). Raise :exc:`OSError` if the file does not exist or is " "inaccessible." @@ -215,7 +215,7 @@ msgstr "" #: library/os.path.rst:208 msgid "" "Return the time of last modification of *path*. The return value is a " -"floating point number giving the number of seconds since the epoch (see " +"floating-point number giving the number of seconds since the epoch (see " "the :mod:`time` module). Raise :exc:`OSError` if the file does not exist or " "is inaccessible." msgstr "" diff --git a/library/os.po b/library/os.po index 40d01b431..8152c98de 100644 --- a/library/os.po +++ b/library/os.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -644,9 +644,7 @@ msgid "" msgstr "" #: library/os.rst:569 -msgid "" -"Raises an :ref:`auditing event ` ``os.putenv`` with arguments " -"``key``, ``value``." +msgid "Raises an auditing event os.putenv with arguments key, value." msgstr "" #: library/os.rst:571 @@ -865,9 +863,7 @@ msgid "" msgstr "" #: library/os.rst:807 -msgid "" -"Raises an :ref:`auditing event ` ``os.unsetenv`` with argument " -"``key``." +msgid "Raises an auditing event os.unsetenv with argument key." msgstr "" #: library/os.rst:809 @@ -1072,9 +1068,7 @@ msgid "" msgstr "" #: library/os.rst:2069 library/os.rst:2166 -msgid "" -"Raises an :ref:`auditing event ` ``os.chmod`` with arguments " -"``path``, ``mode``, ``dir_fd``." +msgid "Raises an auditing event os.chmod with arguments path, mode, dir_fd." msgstr "" #: library/os.rst:1021 library/os.rst:1651 library/os.rst:2095 @@ -1093,8 +1087,7 @@ msgstr "" #: library/os.rst:2091 library/os.rst:2179 msgid "" -"Raises an :ref:`auditing event ` ``os.chown`` with arguments " -"``path``, ``uid``, ``gid``, ``dir_fd``." +"Raises an auditing event os.chown with arguments path, uid, gid, dir_fd." msgstr "" #: library/os.rst:1027 @@ -1173,9 +1166,7 @@ msgid "" msgstr "" #: library/os.rst:1095 -msgid "" -"Raises an :ref:`auditing event ` ``os.truncate`` with arguments " -"``fd``, ``length``." +msgid "Raises an auditing event os.truncate with arguments fd, length." msgstr "" #: library/os.rst:3423 @@ -1215,9 +1206,7 @@ msgid "" msgstr "" #: library/os.rst:1136 -msgid "" -"Raises an :ref:`auditing event ` ``os.lockf`` with arguments " -"``fd``, ``cmd``, ``len``." +msgid "Raises an auditing event os.lockf with arguments fd, cmd, len." msgstr "" #: library/os.rst:1148 @@ -1359,9 +1348,7 @@ msgid "" msgstr "" #: library/os.rst:1242 -msgid "" -"Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " -"``mode``, ``flags``." +msgid "Raises an auditing event open with arguments path, mode, flags." msgstr "" #: library/os.rst:1249 @@ -1600,7 +1587,7 @@ msgstr "" #: library/os.rst:1500 msgid "" -"Write the *buffers* contents to file descriptor *fd* at a offset *offset*, " +"Write the *buffers* contents to file descriptor *fd* at an offset *offset*, " "leaving the file offset unchanged. *buffers* must be a sequence of :term:" "`bytes-like objects `. Buffers are processed in array " "order. Entire contents of the first buffer is written before proceeding to " @@ -2078,9 +2065,7 @@ msgid "" msgstr "" #: library/os.rst:2122 -msgid "" -"Raises an :ref:`auditing event ` ``os.chdir`` with argument " -"``path``." +msgid "Raises an auditing event os.chdir with argument path." msgstr "" #: library/os.rst:1991 @@ -2149,9 +2134,7 @@ msgid "" msgstr "" #: library/os.rst:2148 -msgid "" -"Raises an :ref:`auditing event ` ``os.chflags`` with arguments " -"``path``, ``flags``." +msgid "Raises an auditing event os.chflags with arguments path, flags." msgstr "" #: library/os.rst:2023 @@ -2350,8 +2333,8 @@ msgstr "" #: library/os.rst:2195 msgid "" -"Raises an :ref:`auditing event ` ``os.link`` with arguments " -"``src``, ``dst``, ``src_dir_fd``, ``dst_dir_fd``." +"Raises an auditing event os.link with arguments src, dst, src_dir_fd, " +"dst_dir_fd." msgstr "" #: library/os.rst:2197 @@ -2394,9 +2377,7 @@ msgid "" msgstr "" #: library/os.rst:2225 -msgid "" -"Raises an :ref:`auditing event ` ``os.listdir`` with argument " -"``path``." +msgid "Raises an auditing event os.listdir with argument path." msgstr "" #: library/os.rst:2228 @@ -2434,9 +2415,7 @@ msgid "May raise :exc:`OSError` if an error occurs collecting the drive names." msgstr "" #: library/os.rst:2258 -msgid "" -"Raises an :ref:`auditing event ` ``os.listdrives`` with no " -"arguments." +msgid "Raises an auditing event os.listdrives with no arguments." msgstr "" #: library/os.rst:2284 library/os.rst:2304 @@ -2469,9 +2448,7 @@ msgid "" msgstr "" #: library/os.rst:2282 -msgid "" -"Raises an :ref:`auditing event ` ``os.listmounts`` with argument " -"``volume``." +msgid "Raises an auditing event os.listmounts with argument volume." msgstr "" #: library/os.rst:2291 @@ -2492,9 +2469,7 @@ msgid "May raise :exc:`OSError` if an error occurs collecting the volumes." msgstr "" #: library/os.rst:2302 -msgid "" -"Raises an :ref:`auditing event ` ``os.listvolumes`` with no " -"arguments." +msgid "Raises an auditing event os.listvolumes with no arguments." msgstr "" #: library/os.rst:2311 @@ -2568,9 +2543,7 @@ msgid "" msgstr "" #: library/os.rst:2406 -msgid "" -"Raises an :ref:`auditing event ` ``os.mkdir`` with arguments " -"``path``, ``mode``, ``dir_fd``." +msgid "Raises an auditing event os.mkdir with arguments path, mode, dir_fd." msgstr "" #: library/os.rst:2377 @@ -2755,9 +2728,7 @@ msgid "This function is semantically identical to :func:`unlink`." msgstr "" #: library/os.rst:2595 library/os.rst:3437 -msgid "" -"Raises an :ref:`auditing event ` ``os.remove`` with arguments " -"``path``, ``dir_fd``." +msgid "Raises an auditing event os.remove with arguments path, dir_fd." msgstr "" #: library/os.rst:2586 @@ -2811,8 +2782,8 @@ msgstr "" #: library/os.rst:2645 library/os.rst:2662 msgid "" -"Raises an :ref:`auditing event ` ``os.rename`` with arguments " -"``src``, ``dst``, ``src_dir_fd``, ``dst_dir_fd``." +"Raises an auditing event os.rename with arguments src, dst, src_dir_fd, " +"dst_dir_fd." msgstr "" #: library/os.rst:2626 @@ -2856,9 +2827,7 @@ msgid "" msgstr "" #: library/os.rst:2680 -msgid "" -"Raises an :ref:`auditing event ` ``os.rmdir`` with arguments " -"``path``, ``dir_fd``." +msgid "Raises an auditing event os.rmdir with arguments path, dir_fd." msgstr "" #: library/os.rst:2691 @@ -2893,9 +2862,7 @@ msgid "" msgstr "" #: library/os.rst:2717 -msgid "" -"Raises an :ref:`auditing event ` ``os.scandir`` with argument " -"``path``." +msgid "Raises an auditing event os.scandir with argument path." msgstr "" #: library/os.rst:2719 @@ -3678,9 +3645,7 @@ msgid "" msgstr "" #: library/os.rst:3380 -msgid "" -"Raises an :ref:`auditing event ` ``os.symlink`` with arguments " -"``src``, ``dst``, ``dir_fd``." +msgid "Raises an auditing event os.symlink with arguments src, dst, dir_fd." msgstr "" #: library/os.rst:3390 @@ -3704,9 +3669,7 @@ msgid "" msgstr "" #: library/os.rst:3417 -msgid "" -"Raises an :ref:`auditing event ` ``os.truncate`` with arguments " -"``path``, ``length``." +msgid "Raises an auditing event os.truncate with arguments path, length." msgstr "" #: library/os.rst:3432 @@ -3760,8 +3723,7 @@ msgstr "" #: library/os.rst:3476 msgid "" -"Raises an :ref:`auditing event ` ``os.utime`` with arguments " -"``path``, ``times``, ``ns``, ``dir_fd``." +"Raises an auditing event os.utime with arguments path, times, ns, dir_fd." msgstr "" #: library/os.rst:3478 @@ -3863,8 +3825,8 @@ msgstr "" #: library/os.rst:3575 msgid "" -"Raises an :ref:`auditing event ` ``os.walk`` with arguments " -"``top``, ``topdown``, ``onerror``, ``followlinks``." +"Raises an auditing event os.walk with arguments top, topdown, onerror, " +"followlinks." msgstr "" #: library/os.rst:3577 @@ -3908,8 +3870,8 @@ msgstr "" #: library/os.rst:3636 msgid "" -"Raises an :ref:`auditing event ` ``os.fwalk`` with arguments " -"``top``, ``topdown``, ``onerror``, ``follow_symlinks``, ``dir_fd``." +"Raises an auditing event os.fwalk with arguments top, topdown, onerror, " +"follow_symlinks, dir_fd." msgstr "" #: library/os.rst:3645 @@ -3962,7 +3924,7 @@ msgstr "" #: library/os.rst:3703 msgid "" "*initval* is the initial value of the event counter. The initial value must " -"be an 32 bit unsigned integer. Please note that the initial value is limited " +"be a 32 bit unsigned integer. Please note that the initial value is limited " "to a 32 bit unsigned int although the event counter is an unsigned 64 bit " "integer with a maximum value of 2\\ :sup:`64`\\ -\\ 2." msgstr "" @@ -4030,7 +3992,7 @@ msgstr "" #: library/os.rst:3783 msgid "" -"Provide semaphore-like semantics for reads from a :func:`eventfd` file " +"Provide semaphore-like semantics for reads from an :func:`eventfd` file " "descriptor. On read the internal counter is decremented by one." msgstr "" @@ -4055,9 +4017,7 @@ msgid "" msgstr "" #: library/os.rst:3808 -msgid "" -"Raises an :ref:`auditing event ` ``os.getxattr`` with arguments " -"``path``, ``attribute``." +msgid "Raises an auditing event os.getxattr with arguments path, attribute." msgstr "" #: library/os.rst:3842 library/os.rst:3867 @@ -4073,9 +4033,7 @@ msgid "" msgstr "" #: library/os.rst:3824 -msgid "" -"Raises an :ref:`auditing event ` ``os.listxattr`` with argument " -"``path``." +msgid "Raises an auditing event os.listxattr with argument path." msgstr "" #: library/os.rst:3832 @@ -4087,9 +4045,7 @@ msgid "" msgstr "" #: library/os.rst:3840 -msgid "" -"Raises an :ref:`auditing event ` ``os.removexattr`` with arguments " -"``path``, ``attribute``." +msgid "Raises an auditing event os.removexattr with arguments path, attribute." msgstr "" #: library/os.rst:3848 @@ -4112,8 +4068,8 @@ msgstr "" #: library/os.rst:3865 msgid "" -"Raises an :ref:`auditing event ` ``os.setxattr`` with arguments " -"``path``, ``attribute``, ``value``, ``flags``." +"Raises an auditing event os.setxattr with arguments path, attribute, value, " +"flags." msgstr "" #: library/os.rst:3873 @@ -4187,9 +4143,7 @@ msgid "" msgstr "" #: library/os.rst:3929 -msgid "" -"Raises an :ref:`auditing event ` ``os.add_dll_directory`` with " -"argument ``path``." +msgid "Raises an auditing event os.add_dll_directory with argument path." msgstr "" #: library/os.rst:3933 @@ -4270,9 +4224,7 @@ msgid "" msgstr "" #: library/os.rst:3998 -msgid "" -"Raises an :ref:`auditing event ` ``os.exec`` with arguments " -"``path``, ``args``, ``env``." +msgid "Raises an auditing event os.exec with arguments path, args, env." msgstr "" #: library/os.rst:4002 @@ -4405,8 +4357,7 @@ msgid "" msgstr "" #: library/os.rst:4165 -msgid "" -"Raises an :ref:`auditing event ` ``os.fork`` with no arguments." +msgid "Raises an auditing event os.fork with no arguments." msgstr "" #: library/os.rst:4169 @@ -4472,8 +4423,7 @@ msgid "" msgstr "" #: library/os.rst:4214 -msgid "" -"Raises an :ref:`auditing event ` ``os.forkpty`` with no arguments." +msgid "Raises an auditing event os.forkpty with no arguments." msgstr "" #: library/os.rst:4221 @@ -4511,9 +4461,7 @@ msgid "See also :func:`signal.pthread_kill`." msgstr "" #: library/os.rst:4252 -msgid "" -"Raises an :ref:`auditing event ` ``os.kill`` with arguments " -"``pid``, ``sig``." +msgid "Raises an auditing event os.kill with arguments pid, sig." msgstr "" #: library/os.rst:4266 @@ -4521,9 +4469,7 @@ msgid "Send the signal *sig* to the process group *pgid*." msgstr "" #: library/os.rst:4268 -msgid "" -"Raises an :ref:`auditing event ` ``os.killpg`` with arguments " -"``pgid``, ``sig``." +msgid "Raises an auditing event os.killpg with arguments pgid, sig." msgstr "" #: library/os.rst:4275 @@ -4735,9 +4681,7 @@ msgid "" msgstr "" #: library/os.rst:4446 -msgid "" -"Raises an :ref:`auditing event ` ``os.posix_spawn`` with arguments " -"``path``, ``argv``, ``env``." +msgid "Raises an auditing event os.posix_spawn with arguments path, argv, env." msgstr "" #: library/os.rst:4440 @@ -4872,9 +4816,7 @@ msgid "" msgstr "" #: library/os.rst:4550 -msgid "" -"Raises an :ref:`auditing event ` ``os.spawn`` with arguments " -"``mode``, ``path``, ``args``, ``env``." +msgid "Raises an auditing event os.spawn with arguments mode, path, args, env." msgstr "" #: library/os.rst:4554 @@ -4972,15 +4914,13 @@ msgid "" msgstr "" #: library/os.rst:4635 -msgid "" -"Raises an :ref:`auditing event ` ``os.startfile`` with arguments " -"``path``, ``operation``." +msgid "Raises an auditing event os.startfile with arguments path, operation." msgstr "" #: library/os.rst:4637 msgid "" -"Raises an :ref:`auditing event ` ``os.startfile/2`` with arguments " -"``path``, ``operation``, ``arguments``, ``cwd``, ``show_cmd``." +"Raises an auditing event os.startfile/2 with arguments path, operation, " +"arguments, cwd, show_cmd." msgstr "" #: library/os.rst:4641 @@ -5031,9 +4971,7 @@ msgid "" msgstr "" #: library/os.rst:4674 -msgid "" -"Raises an :ref:`auditing event ` ``os.system`` with argument " -"``command``." +msgid "Raises an auditing event os.system with argument command." msgstr "" #: library/os.rst:4681 diff --git a/library/ossaudiodev.po b/library/ossaudiodev.po index 80bbf4eac..e4446487d 100644 --- a/library/ossaudiodev.po +++ b/library/ossaudiodev.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -20,7 +20,7 @@ msgstr "" msgid ":mod:`ossaudiodev` --- Access to OSS-compatible audio devices" msgstr "" -#: library/ossaudiodev.rst:12 +#: library/ossaudiodev.rst:9 msgid "" "The :mod:`ossaudiodev` module is deprecated (see :pep:`PEP 594 " "<594#ossaudiodev>` for details)." diff --git a/library/pathlib.po b/library/pathlib.po index 436d6c0dd..5c7b40930 100644 --- a/library/pathlib.po +++ b/library/pathlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -33,7 +33,17 @@ msgid "" "inherit from pure paths but also provide I/O operations." msgstr "" -#: library/pathlib.rst:25 +#: library/pathlib.rst:21 +msgid "" +"Inheritance diagram showing the classes available in pathlib. The\n" +"most basic class is PurePath, which has three direct subclasses:\n" +"PurePosixPath, PureWindowsPath, and Path. Further to these four\n" +"classes, there are two classes that use multiple inheritance:\n" +"PosixPath subclasses PurePosixPath and Path, and WindowsPath\n" +"subclasses PureWindowsPath and Path." +msgstr "" + +#: library/pathlib.rst:31 msgid "" "If you've never used this module before or just aren't sure which class is " "right for your task, :class:`Path` is most likely what you need. It " @@ -41,80 +51,80 @@ msgid "" "code is running on." msgstr "" -#: library/pathlib.rst:29 +#: library/pathlib.rst:35 msgid "Pure paths are useful in some special cases; for example:" msgstr "" -#: library/pathlib.rst:31 +#: library/pathlib.rst:37 msgid "" "If you want to manipulate Windows paths on a Unix machine (or vice versa). " "You cannot instantiate a :class:`WindowsPath` when running on Unix, but you " "can instantiate :class:`PureWindowsPath`." msgstr "" -#: library/pathlib.rst:34 +#: library/pathlib.rst:40 msgid "" "You want to make sure that your code only manipulates paths without actually " "accessing the OS. In this case, instantiating one of the pure classes may be " "useful since those simply don't have any OS-accessing operations." msgstr "" -#: library/pathlib.rst:39 +#: library/pathlib.rst:45 msgid ":pep:`428`: The pathlib module -- object-oriented filesystem paths." msgstr "" -#: library/pathlib.rst:42 +#: library/pathlib.rst:48 msgid "" "For low-level path manipulation on strings, you can also use the :mod:`os." "path` module." msgstr "" -#: library/pathlib.rst:47 +#: library/pathlib.rst:53 msgid "Basic use" msgstr "" -#: library/pathlib.rst:49 +#: library/pathlib.rst:55 msgid "Importing the main class::" msgstr "" -#: library/pathlib.rst:53 +#: library/pathlib.rst:59 msgid "Listing subdirectories::" msgstr "" -#: library/pathlib.rst:60 +#: library/pathlib.rst:66 msgid "Listing Python source files in this directory tree::" msgstr "" -#: library/pathlib.rst:67 +#: library/pathlib.rst:73 msgid "Navigating inside a directory tree::" msgstr "" -#: library/pathlib.rst:76 +#: library/pathlib.rst:82 msgid "Querying path properties::" msgstr "" -#: library/pathlib.rst:83 +#: library/pathlib.rst:89 msgid "Opening a file::" msgstr "" -#: library/pathlib.rst:93 +#: library/pathlib.rst:99 msgid "Pure paths" msgstr "" -#: library/pathlib.rst:95 +#: library/pathlib.rst:101 msgid "" "Pure path objects provide path-handling operations which don't actually " "access a filesystem. There are three ways to access these classes, which we " "also call *flavours*:" msgstr "" -#: library/pathlib.rst:101 +#: library/pathlib.rst:107 msgid "" "A generic class that represents the system's path flavour (instantiating it " "creates either a :class:`PurePosixPath` or a :class:`PureWindowsPath`)::" msgstr "" -#: library/pathlib.rst:107 +#: library/pathlib.rst:113 msgid "" "Each element of *pathsegments* can be either a string representing a path " "segment, or an object implementing the :class:`os.PathLike` interface where " @@ -122,88 +132,88 @@ msgid "" "path object::" msgstr "" -#: library/pathlib.rst:117 +#: library/pathlib.rst:123 msgid "When *pathsegments* is empty, the current directory is assumed::" msgstr "" -#: library/pathlib.rst:122 +#: library/pathlib.rst:128 msgid "" "If a segment is an absolute path, all previous segments are ignored (like :" "func:`os.path.join`)::" msgstr "" -#: library/pathlib.rst:130 +#: library/pathlib.rst:136 msgid "" "On Windows, the drive is not reset when a rooted relative path segment (e." "g., ``r'\\foo'``) is encountered::" msgstr "" -#: library/pathlib.rst:136 +#: library/pathlib.rst:142 msgid "" "Spurious slashes and single dots are collapsed, but double dots (``'..'``) " "and leading double slashes (``'//'``) are not, since this would change the " "meaning of a path for various reasons (e.g. symbolic links, UNC paths)::" msgstr "" -#: library/pathlib.rst:149 +#: library/pathlib.rst:155 msgid "" "(a naïve approach would make ``PurePosixPath('foo/../bar')`` equivalent to " "``PurePosixPath('bar')``, which is wrong if ``foo`` is a symbolic link to " "another directory)" msgstr "" -#: library/pathlib.rst:153 +#: library/pathlib.rst:159 msgid "" "Pure path objects implement the :class:`os.PathLike` interface, allowing " "them to be used anywhere the interface is accepted." msgstr "" -#: library/pathlib.rst:156 +#: library/pathlib.rst:162 msgid "Added support for the :class:`os.PathLike` interface." msgstr "" -#: library/pathlib.rst:161 +#: library/pathlib.rst:167 msgid "" "A subclass of :class:`PurePath`, this path flavour represents non-Windows " "filesystem paths::" msgstr "" -#: library/pathlib.rst:179 library/pathlib.rst:762 library/pathlib.rst:772 +#: library/pathlib.rst:185 library/pathlib.rst:768 library/pathlib.rst:778 msgid "*pathsegments* is specified similarly to :class:`PurePath`." msgstr "" -#: library/pathlib.rst:171 +#: library/pathlib.rst:177 msgid "" "A subclass of :class:`PurePath`, this path flavour represents Windows " "filesystem paths, including `UNC paths`_::" msgstr "" -#: library/pathlib.rst:183 +#: library/pathlib.rst:189 msgid "" "Regardless of the system you're running on, you can instantiate all of these " "classes, since they don't provide any operation that does system calls." msgstr "" -#: library/pathlib.rst:188 +#: library/pathlib.rst:194 msgid "General properties" msgstr "" -#: library/pathlib.rst:190 +#: library/pathlib.rst:196 msgid "" "Paths are immutable and :term:`hashable`. Paths of a same flavour are " "comparable and orderable. These properties respect the flavour's case-" "folding semantics::" msgstr "" -#: library/pathlib.rst:203 +#: library/pathlib.rst:209 msgid "Paths of a different flavour compare unequal and cannot be ordered::" msgstr "" -#: library/pathlib.rst:214 +#: library/pathlib.rst:220 msgid "Operators" msgstr "" -#: library/pathlib.rst:216 +#: library/pathlib.rst:222 msgid "" "The slash operator helps create child paths, like :func:`os.path.join`. If " "the argument is an absolute path, the previous path is ignored. On Windows, " @@ -211,255 +221,255 @@ msgid "" "``r'\\foo'``)::" msgstr "" -#: library/pathlib.rst:234 +#: library/pathlib.rst:240 msgid "" "A path object can be used anywhere an object implementing :class:`os." "PathLike` is accepted::" msgstr "" -#: library/pathlib.rst:242 +#: library/pathlib.rst:248 msgid "" "The string representation of a path is the raw filesystem path itself (in " "native form, e.g. with backslashes under Windows), which you can pass to any " "function taking a file path as a string::" msgstr "" -#: library/pathlib.rst:253 +#: library/pathlib.rst:259 msgid "" "Similarly, calling :class:`bytes` on a path gives the raw filesystem path as " "a bytes object, as encoded by :func:`os.fsencode`::" msgstr "" -#: library/pathlib.rst:260 +#: library/pathlib.rst:266 msgid "" "Calling :class:`bytes` is only recommended under Unix. Under Windows, the " "unicode form is the canonical representation of filesystem paths." msgstr "" -#: library/pathlib.rst:265 +#: library/pathlib.rst:271 msgid "Accessing individual parts" msgstr "" -#: library/pathlib.rst:267 +#: library/pathlib.rst:273 msgid "" "To access the individual \"parts\" (components) of a path, use the following " "property:" msgstr "" -#: library/pathlib.rst:272 +#: library/pathlib.rst:278 msgid "A tuple giving access to the path's various components::" msgstr "" -#: library/pathlib.rst:282 +#: library/pathlib.rst:288 msgid "(note how the drive and local root are regrouped in a single part)" msgstr "" -#: library/pathlib.rst:286 +#: library/pathlib.rst:292 msgid "Methods and properties" msgstr "" -#: library/pathlib.rst:292 +#: library/pathlib.rst:298 msgid "Pure paths provide the following methods and properties:" msgstr "" -#: library/pathlib.rst:296 +#: library/pathlib.rst:302 msgid "A string representing the drive letter or name, if any::" msgstr "" -#: library/pathlib.rst:305 +#: library/pathlib.rst:311 msgid "UNC shares are also considered drives::" msgstr "" -#: library/pathlib.rst:312 +#: library/pathlib.rst:318 msgid "A string representing the (local or global) root, if any::" msgstr "" -#: library/pathlib.rst:321 +#: library/pathlib.rst:327 msgid "UNC shares always have a root::" msgstr "" -#: library/pathlib.rst:326 +#: library/pathlib.rst:332 msgid "" "If the path starts with more than two successive slashes, :class:`~pathlib." "PurePosixPath` collapses them::" msgstr "" -#: library/pathlib.rst:338 +#: library/pathlib.rst:344 msgid "" "This behavior conforms to *The Open Group Base Specifications Issue 6*, " "paragraph `4.11 Pathname Resolution `_:" msgstr "" -#: library/pathlib.rst:342 +#: library/pathlib.rst:348 msgid "" "*\"A pathname that begins with two successive slashes may be interpreted in " "an implementation-defined manner, although more than two leading slashes " "shall be treated as a single slash.\"*" msgstr "" -#: library/pathlib.rst:348 +#: library/pathlib.rst:354 msgid "The concatenation of the drive and root::" msgstr "" -#: library/pathlib.rst:362 +#: library/pathlib.rst:368 msgid "" "An immutable sequence providing access to the logical ancestors of the path::" msgstr "" -#: library/pathlib.rst:373 +#: library/pathlib.rst:379 msgid "" "The parents sequence now supports :term:`slices ` and negative index " "values." msgstr "" -#: library/pathlib.rst:378 +#: library/pathlib.rst:384 msgid "The logical parent of the path::" msgstr "" -#: library/pathlib.rst:384 +#: library/pathlib.rst:390 msgid "You cannot go past an anchor, or empty path::" msgstr "" -#: library/pathlib.rst:394 +#: library/pathlib.rst:400 msgid "This is a purely lexical operation, hence the following behaviour::" msgstr "" -#: library/pathlib.rst:400 +#: library/pathlib.rst:406 msgid "" "If you want to walk an arbitrary filesystem path upwards, it is recommended " "to first call :meth:`Path.resolve` so as to resolve symlinks and eliminate " "``\"..\"`` components." msgstr "" -#: library/pathlib.rst:407 +#: library/pathlib.rst:413 msgid "" "A string representing the final path component, excluding the drive and " "root, if any::" msgstr "" -#: library/pathlib.rst:413 +#: library/pathlib.rst:419 msgid "UNC drive names are not considered::" msgstr "" -#: library/pathlib.rst:423 +#: library/pathlib.rst:429 msgid "The file extension of the final component, if any::" msgstr "" -#: library/pathlib.rst:435 +#: library/pathlib.rst:441 msgid "A list of the path's file extensions::" msgstr "" -#: library/pathlib.rst:447 +#: library/pathlib.rst:453 msgid "The final path component, without its suffix::" msgstr "" -#: library/pathlib.rst:459 +#: library/pathlib.rst:465 msgid "" "Return a string representation of the path with forward slashes (``/``)::" msgstr "" -#: library/pathlib.rst:470 +#: library/pathlib.rst:476 msgid "" "Represent the path as a ``file`` URI. :exc:`ValueError` is raised if the " "path isn't absolute." msgstr "" -#: library/pathlib.rst:483 +#: library/pathlib.rst:489 msgid "" "Return whether the path is absolute or not. A path is considered absolute " "if it has both a root and (if the flavour allows) a drive::" msgstr "" -#: library/pathlib.rst:503 +#: library/pathlib.rst:509 msgid "Return whether or not this path is relative to the *other* path." msgstr "" -#: library/pathlib.rst:511 +#: library/pathlib.rst:517 msgid "" "This method is string-based; it neither accesses the filesystem nor treats " "\"``..``\" segments specially. The following code is equivalent:" msgstr "" -#: library/pathlib.rst:522 +#: library/pathlib.rst:528 msgid "" "Passing additional arguments is deprecated; if supplied, they are joined " "with *other*." msgstr "" -#: library/pathlib.rst:527 +#: library/pathlib.rst:533 msgid "" "With :class:`PureWindowsPath`, return ``True`` if the path is considered " "reserved under Windows, ``False`` otherwise. With :class:`PurePosixPath`, " "``False`` is always returned." msgstr "" -#: library/pathlib.rst:536 +#: library/pathlib.rst:542 msgid "" "File system calls on reserved paths can fail mysteriously or have unintended " "effects." msgstr "" -#: library/pathlib.rst:542 +#: library/pathlib.rst:548 msgid "" "Calling this method is equivalent to combining the path with each of the " "given *pathsegments* in turn::" msgstr "" -#: library/pathlib.rst:557 +#: library/pathlib.rst:563 msgid "" "Match this path against the provided glob-style pattern. Return ``True`` if " "matching is successful, ``False`` otherwise." msgstr "" -#: library/pathlib.rst:560 +#: library/pathlib.rst:566 msgid "" "If *pattern* is relative, the path can be either relative or absolute, and " "matching is done from the right::" msgstr "" -#: library/pathlib.rst:570 +#: library/pathlib.rst:576 msgid "" "If *pattern* is absolute, the path must be absolute, and the whole path must " "match::" msgstr "" -#: library/pathlib.rst:578 +#: library/pathlib.rst:584 msgid "" "The *pattern* may be another path object; this speeds up matching the same " "pattern against multiple files::" msgstr "" -#: library/pathlib.rst:586 +#: library/pathlib.rst:592 msgid "" "The recursive wildcard \"``**``\" isn't supported by this method (it acts " "like non-recursive \"``*``\".)" msgstr "" -#: library/pathlib.rst:589 +#: library/pathlib.rst:595 msgid "Accepts an object implementing the :class:`os.PathLike` interface." msgstr "" -#: library/pathlib.rst:592 +#: library/pathlib.rst:598 msgid "As with other methods, case-sensitivity follows platform defaults::" msgstr "" -#: library/pathlib.rst:599 +#: library/pathlib.rst:605 msgid "" "Set *case_sensitive* to ``True`` or ``False`` to override this behaviour." msgstr "" -#: library/pathlib.rst:948 library/pathlib.rst:1361 +#: library/pathlib.rst:1212 library/pathlib.rst:1240 msgid "The *case_sensitive* parameter was added." msgstr "" -#: library/pathlib.rst:607 +#: library/pathlib.rst:613 msgid "" "Compute a version of this path relative to the path represented by *other*. " "If it's impossible, :exc:`ValueError` is raised::" msgstr "" -#: library/pathlib.rst:622 +#: library/pathlib.rst:628 msgid "" "When *walk_up* is false (the default), the path must start with *other*. " "When the argument is true, ``..`` entries may be added to form the relative " @@ -467,7 +477,7 @@ msgid "" "exc:`ValueError` is raised.::" msgstr "" -#: library/pathlib.rst:637 +#: library/pathlib.rst:643 msgid "" "This function is part of :class:`PurePath` and works with strings. It does " "not check or access the underlying file structure. This can impact the " @@ -475,38 +485,38 @@ msgid "" "call :meth:`~Path.resolve` first if necessary to resolve symlinks." msgstr "" -#: library/pathlib.rst:643 +#: library/pathlib.rst:649 msgid "" "The *walk_up* parameter was added (old behavior is the same as " "``walk_up=False``)." msgstr "" -#: library/pathlib.rst:648 +#: library/pathlib.rst:654 msgid "" "Passing additional positional arguments is deprecated; if supplied, they are " "joined with *other*." msgstr "" -#: library/pathlib.rst:653 +#: library/pathlib.rst:659 msgid "" "Return a new path with the :attr:`name` changed. If the original path " "doesn't have a name, ValueError is raised::" msgstr "" -#: library/pathlib.rst:670 +#: library/pathlib.rst:676 msgid "" "Return a new path with the :attr:`stem` changed. If the original path " "doesn't have a name, ValueError is raised::" msgstr "" -#: library/pathlib.rst:694 +#: library/pathlib.rst:700 msgid "" "Return a new path with the :attr:`suffix` changed. If the original path " "doesn't have a suffix, the new *suffix* is appended instead. If the " "*suffix* is an empty string, the original suffix is removed::" msgstr "" -#: library/pathlib.rst:711 +#: library/pathlib.rst:717 msgid "" "Create a new path object of the same type by combining the given " "*pathsegments*. This method is called whenever a derivative path is created, " @@ -514,199 +524,193 @@ msgid "" "this method to pass information to derivative paths, for example::" msgstr "" -#: library/pathlib.rst:737 +#: library/pathlib.rst:743 msgid "Concrete paths" msgstr "" -#: library/pathlib.rst:739 +#: library/pathlib.rst:745 msgid "" "Concrete paths are subclasses of the pure path classes. In addition to " "operations provided by the latter, they also provide methods to do system " "calls on path objects. There are three ways to instantiate concrete paths:" msgstr "" -#: library/pathlib.rst:745 +#: library/pathlib.rst:751 msgid "" "A subclass of :class:`PurePath`, this class represents concrete paths of the " "system's path flavour (instantiating it creates either a :class:`PosixPath` " "or a :class:`WindowsPath`)::" msgstr "" -#: library/pathlib.rst:756 +#: library/pathlib.rst:762 msgid "" "A subclass of :class:`Path` and :class:`PurePosixPath`, this class " "represents concrete non-Windows filesystem paths::" msgstr "" -#: library/pathlib.rst:766 +#: library/pathlib.rst:772 msgid "" "A subclass of :class:`Path` and :class:`PureWindowsPath`, this class " "represents concrete Windows filesystem paths::" msgstr "" -#: library/pathlib.rst:774 +#: library/pathlib.rst:780 msgid "" "You can only instantiate the class flavour that corresponds to your system " "(allowing system calls on non-compatible path flavours could lead to bugs or " "failures in your application)::" msgstr "" -#: library/pathlib.rst:794 -msgid "Methods" -msgstr "" - -#: library/pathlib.rst:796 +#: library/pathlib.rst:798 msgid "" -"Concrete paths provide the following methods in addition to pure paths " -"methods. Many of these methods can raise an :exc:`OSError` if a system call " +"Some concrete path methods can raise an :exc:`OSError` if a system call " "fails (for example because the path doesn't exist)." msgstr "" -#: library/pathlib.rst:802 -msgid "" -":meth:`~Path.exists()`, :meth:`~Path.is_dir()`, :meth:`~Path.is_file()`, :" -"meth:`~Path.is_mount()`, :meth:`~Path.is_symlink()`, :meth:`~Path." -"is_block_device()`, :meth:`~Path.is_char_device()`, :meth:`~Path." -"is_fifo()`, :meth:`~Path.is_socket()` now return ``False`` instead of " -"raising an exception for paths that contain characters unrepresentable at " -"the OS level." +#: library/pathlib.rst:803 +msgid "Expanding and resolving paths" msgstr "" -#: library/pathlib.rst:812 +#: library/pathlib.rst:807 msgid "" -"Return a new path object representing the current directory (as returned by :" -"func:`os.getcwd`)::" +"Return a new path object representing the user's home directory (as returned " +"by :func:`os.path.expanduser` with ``~`` construct). If the home directory " +"can't be resolved, :exc:`RuntimeError` is raised." msgstr "" #: library/pathlib.rst:821 msgid "" -"Return a new path object representing the user's home directory (as returned " -"by :func:`os.path.expanduser` with ``~`` construct). If the home directory " -"can't be resolved, :exc:`RuntimeError` is raised." +"Return a new path with expanded ``~`` and ``~user`` constructs, as returned " +"by :meth:`os.path.expanduser`. If a home directory can't be resolved, :exc:" +"`RuntimeError` is raised." msgstr "" -#: library/pathlib.rst:835 +#: library/pathlib.rst:836 msgid "" -"Return a :class:`os.stat_result` object containing information about this " -"path, like :func:`os.stat`. The result is looked up at each call to this " -"method." +"Return a new path object representing the current directory (as returned by :" +"func:`os.getcwd`)::" msgstr "" -#: library/pathlib.rst:838 +#: library/pathlib.rst:845 msgid "" -"This method normally follows symlinks; to stat a symlink add the argument " -"``follow_symlinks=False``, or use :meth:`~Path.lstat`." +"Make the path absolute, without normalization or resolving symlinks. Returns " +"a new path object::" msgstr "" -#: library/pathlib.rst:869 library/pathlib.rst:890 -msgid "The *follow_symlinks* parameter was added." +#: library/pathlib.rst:857 +msgid "" +"Make the path absolute, resolving any symlinks. A new path object is " +"returned::" msgstr "" -#: library/pathlib.rst:854 -msgid "Change the file mode and permissions, like :func:`os.chmod`." +#: library/pathlib.rst:866 +msgid "" +"\"``..``\" components are also eliminated (this is the only method to do " +"so)::" msgstr "" -#: library/pathlib.rst:856 +#: library/pathlib.rst:872 msgid "" -"This method normally follows symlinks. Some Unix flavours support changing " -"permissions on the symlink itself; on these platforms you may add the " -"argument ``follow_symlinks=False``, or use :meth:`~Path.lchmod`." +"If the path doesn't exist and *strict* is ``True``, :exc:`FileNotFoundError` " +"is raised. If *strict* is ``False``, the path is resolved as far as " +"possible and any remainder is appended without checking whether it exists. " +"If an infinite loop is encountered along the resolution path, :exc:" +"`RuntimeError` is raised." msgstr "" -#: library/pathlib.rst:874 -msgid "Return ``True`` if the path points to an existing file or directory." +#: library/pathlib.rst:878 +msgid "The *strict* parameter was added (pre-3.6 behavior is strict)." msgstr "" -#: library/pathlib.rst:876 +#: library/pathlib.rst:884 msgid "" -"This method normally follows symlinks; to check if a symlink exists, add the " -"argument ``follow_symlinks=False``." +"Return the path to which the symbolic link points (as returned by :func:`os." +"readlink`)::" +msgstr "" + +#: library/pathlib.rst:896 +msgid "Querying file type and status" msgstr "" -#: library/pathlib.rst:895 +#: library/pathlib.rst:900 msgid "" -"Return a new path with expanded ``~`` and ``~user`` constructs, as returned " -"by :meth:`os.path.expanduser`. If a home directory can't be resolved, :exc:" -"`RuntimeError` is raised." +":meth:`~Path.exists()`, :meth:`~Path.is_dir()`, :meth:`~Path.is_file()`, :" +"meth:`~Path.is_mount()`, :meth:`~Path.is_symlink()`, :meth:`~Path." +"is_block_device()`, :meth:`~Path.is_char_device()`, :meth:`~Path." +"is_fifo()`, :meth:`~Path.is_socket()` now return ``False`` instead of " +"raising an exception for paths that contain characters unrepresentable at " +"the OS level." msgstr "" #: library/pathlib.rst:910 msgid "" -"Glob the given relative *pattern* in the directory represented by this path, " -"yielding all matching files (of any kind)::" +"Return an :class:`os.stat_result` object containing information about this " +"path, like :func:`os.stat`. The result is looked up at each call to this " +"method." msgstr "" -#: library/pathlib.rst:918 +#: library/pathlib.rst:913 msgid "" -"Patterns are the same as for :mod:`fnmatch`, with the addition of \"``**``\" " -"which means \"this directory and all subdirectories, recursively\". In " -"other words, it enables recursive globbing::" +"This method normally follows symlinks; to stat a symlink add the argument " +"``follow_symlinks=False``, or use :meth:`~Path.lstat`." msgstr "" -#: library/pathlib.rst:929 -msgid "" -"This method calls :meth:`Path.is_dir` on the top-level directory and " -"propagates any :exc:`OSError` exception that is raised. Subsequent :exc:" -"`OSError` exceptions from scanning directories are suppressed." +#: library/pathlib.rst:952 library/pathlib.rst:1514 +msgid "The *follow_symlinks* parameter was added." msgstr "" -#: library/pathlib.rst:1350 +#: library/pathlib.rst:930 msgid "" -"By default, or when the *case_sensitive* keyword-only argument is set to " -"``None``, this method matches paths using platform-specific casing rules: " -"typically, case-sensitive on POSIX, and case-insensitive on Windows. Set " -"*case_sensitive* to ``True`` or ``False`` to override this behaviour." +"Like :meth:`Path.stat` but, if the path points to a symbolic link, return " +"the symbolic link's information rather than its target's." msgstr "" -#: library/pathlib.rst:939 -msgid "" -"Using the \"``**``\" pattern in large directory trees may consume an " -"inordinate amount of time." +#: library/pathlib.rst:936 +msgid "Return ``True`` if the path points to an existing file or directory." msgstr "" -#: library/pathlib.rst:942 +#: library/pathlib.rst:938 msgid "" -"Raises an :ref:`auditing event ` ``pathlib.Path.glob`` with " -"arguments ``self``, ``pattern``." +"This method normally follows symlinks; to check if a symlink exists, add the " +"argument ``follow_symlinks=False``." msgstr "" -#: library/pathlib.rst:1357 +#: library/pathlib.rst:958 msgid "" -"Return only directories if *pattern* ends with a pathname components " -"separator (:data:`~os.sep` or :data:`~os.altsep`)." +"Return ``True`` if the path points to a regular file (or a symbolic link " +"pointing to a regular file), ``False`` if it points to another kind of file." msgstr "" -#: library/pathlib.rst:954 +#: library/pathlib.rst:970 library/pathlib.rst:1021 library/pathlib.rst:1039 msgid "" -"Return the name of the group owning the file. :exc:`KeyError` is raised if " -"the file's gid isn't found in the system database." +"``False`` is also returned if the path doesn't exist or is a broken symlink; " +"other errors (such as permission errors) are propagated." msgstr "" -#: library/pathlib.rst:960 +#: library/pathlib.rst:967 msgid "" "Return ``True`` if the path points to a directory (or a symbolic link " "pointing to a directory), ``False`` if it points to another kind of file." msgstr "" -#: library/pathlib.rst:972 library/pathlib.rst:1023 library/pathlib.rst:1041 +#: library/pathlib.rst:976 msgid "" -"``False`` is also returned if the path doesn't exist or is a broken symlink; " -"other errors (such as permission errors) are propagated." +"Return ``True`` if the path points to a symbolic link, ``False`` otherwise." msgstr "" -#: library/pathlib.rst:969 +#: library/pathlib.rst:978 msgid "" -"Return ``True`` if the path points to a regular file (or a symbolic link " -"pointing to a regular file), ``False`` if it points to another kind of file." +"``False`` is also returned if the path doesn't exist; other errors (such as " +"permission errors) are propagated." msgstr "" -#: library/pathlib.rst:978 +#: library/pathlib.rst:984 msgid "" "Return ``True`` if the path points to a junction, and ``False`` for any " "other type of file. Currently only Windows supports junctions." msgstr "" -#: library/pathlib.rst:986 +#: library/pathlib.rst:992 msgid "" "Return ``True`` if the path is a :dfn:`mount point`: a point in a file " "system where a different file system has been mounted. On POSIX, the " @@ -718,74 +722,193 @@ msgid "" "mounted filesystem directory." msgstr "" -#: library/pathlib.rst:997 -msgid "Windows support was added." -msgstr "" - #: library/pathlib.rst:1003 -msgid "" -"Return ``True`` if the path points to a symbolic link, ``False`` otherwise." -msgstr "" - -#: library/pathlib.rst:1005 -msgid "" -"``False`` is also returned if the path doesn't exist; other errors (such as " -"permission errors) are propagated." +msgid "Windows support was added." msgstr "" -#: library/pathlib.rst:1011 +#: library/pathlib.rst:1009 msgid "" "Return ``True`` if the path points to a Unix socket (or a symbolic link " "pointing to a Unix socket), ``False`` if it points to another kind of file." msgstr "" -#: library/pathlib.rst:1020 +#: library/pathlib.rst:1018 msgid "" "Return ``True`` if the path points to a FIFO (or a symbolic link pointing to " "a FIFO), ``False`` if it points to another kind of file." msgstr "" -#: library/pathlib.rst:1029 +#: library/pathlib.rst:1027 msgid "" "Return ``True`` if the path points to a block device (or a symbolic link " "pointing to a block device), ``False`` if it points to another kind of file." msgstr "" -#: library/pathlib.rst:1038 +#: library/pathlib.rst:1036 msgid "" "Return ``True`` if the path points to a character device (or a symbolic link " "pointing to a character device), ``False`` if it points to another kind of " "file." msgstr "" -#: library/pathlib.rst:1047 +#: library/pathlib.rst:1045 +msgid "" +"Return whether this path points to the same file as *other_path*, which can " +"be either a Path object, or a string. The semantics are similar to :func:" +"`os.path.samefile` and :func:`os.path.samestat`." +msgstr "" + +#: library/pathlib.rst:1049 +msgid "" +"An :exc:`OSError` can be raised if either file cannot be accessed for some " +"reason." +msgstr "" + +#: library/pathlib.rst:1065 +msgid "Reading and writing files" +msgstr "" + +#: library/pathlib.rst:1070 +msgid "" +"Open the file pointed to by the path, like the built-in :func:`open` " +"function does::" +msgstr "" + +#: library/pathlib.rst:1082 +msgid "Return the decoded contents of the pointed-to file as a string::" +msgstr "" + +#: library/pathlib.rst:1090 +msgid "" +"The file is opened and then closed. The optional parameters have the same " +"meaning as in :func:`open`." +msgstr "" + +#: library/pathlib.rst:1098 +msgid "Return the binary contents of the pointed-to file as a bytes object::" +msgstr "" + +#: library/pathlib.rst:1111 +msgid "" +"Open the file pointed to in text mode, write *data* to it, and close the " +"file::" +msgstr "" + +#: library/pathlib.rst:1120 +msgid "" +"An existing file of the same name is overwritten. The optional parameters " +"have the same meaning as in :func:`open`." +msgstr "" + +#: library/pathlib.rst:1125 +msgid "The *newline* parameter was added." +msgstr "" + +#: library/pathlib.rst:1131 +msgid "" +"Open the file pointed to in bytes mode, write *data* to it, and close the " +"file::" +msgstr "" + +#: library/pathlib.rst:1140 +msgid "An existing file of the same name is overwritten." +msgstr "" + +#: library/pathlib.rst:1146 +msgid "Reading directories" +msgstr "" + +#: library/pathlib.rst:1150 msgid "" "When the path points to a directory, yield path objects of the directory " "contents::" msgstr "" -#: library/pathlib.rst:1061 +#: library/pathlib.rst:1164 msgid "" "The children are yielded in arbitrary order, and the special entries ``'.'`` " "and ``'..'`` are not included. If a file is removed from or added to the " -"directory after creating the iterator, whether a path object for that file " -"be included is unspecified." +"directory after creating the iterator, it is unspecified whether a path " +"object for that file is included." +msgstr "" + +#: library/pathlib.rst:1169 +msgid "" +"If the path is not a directory or otherwise inaccessible, :exc:`OSError` is " +"raised." msgstr "" -#: library/pathlib.rst:1068 +#: library/pathlib.rst:1174 +msgid "" +"Glob the given relative *pattern* in the directory represented by this path, " +"yielding all matching files (of any kind)::" +msgstr "" + +#: library/pathlib.rst:1182 +msgid "" +"Patterns are the same as for :mod:`fnmatch`, with the addition of \"``**``\" " +"which means \"this directory and all subdirectories, recursively\". In " +"other words, it enables recursive globbing::" +msgstr "" + +#: library/pathlib.rst:1193 +msgid "" +"This method calls :meth:`Path.is_dir` on the top-level directory and " +"propagates any :exc:`OSError` exception that is raised. Subsequent :exc:" +"`OSError` exceptions from scanning directories are suppressed." +msgstr "" + +#: library/pathlib.rst:1229 +msgid "" +"By default, or when the *case_sensitive* keyword-only argument is set to " +"``None``, this method matches paths using platform-specific casing rules: " +"typically, case-sensitive on POSIX, and case-insensitive on Windows. Set " +"*case_sensitive* to ``True`` or ``False`` to override this behaviour." +msgstr "" + +#: library/pathlib.rst:1203 +msgid "" +"Using the \"``**``\" pattern in large directory trees may consume an " +"inordinate amount of time." +msgstr "" + +#: library/pathlib.rst:1206 +msgid "" +"Raises an auditing event pathlib.Path.glob with arguments self, pattern." +msgstr "" + +#: library/pathlib.rst:1236 +msgid "" +"Return only directories if *pattern* ends with a pathname components " +"separator (:data:`~os.sep` or :data:`~os.altsep`)." +msgstr "" + +#: library/pathlib.rst:1218 +msgid "" +"Glob the given relative *pattern* recursively. This is like calling :func:" +"`Path.glob` with \"``**/``\" added in front of the *pattern*, where " +"*patterns* are the same as for :mod:`fnmatch`::" +msgstr "" + +#: library/pathlib.rst:1234 +msgid "" +"Raises an auditing event pathlib.Path.rglob with arguments self, pattern." +msgstr "" + +#: library/pathlib.rst:1246 msgid "" "Generate the file names in a directory tree by walking the tree either top-" "down or bottom-up." msgstr "" -#: library/pathlib.rst:1071 +#: library/pathlib.rst:1249 msgid "" "For each directory in the directory tree rooted at *self* (including *self* " "but excluding '.' and '..'), the method yields a 3-tuple of ``(dirpath, " "dirnames, filenames)``." msgstr "" -#: library/pathlib.rst:1075 +#: library/pathlib.rst:1253 msgid "" "*dirpath* is a :class:`Path` to the directory currently being walked, " "*dirnames* is a list of strings for the names of subdirectories in *dirpath* " @@ -795,7 +918,7 @@ msgid "" "name``. Whether or not the lists are sorted is file system-dependent." msgstr "" -#: library/pathlib.rst:1083 +#: library/pathlib.rst:1261 msgid "" "If the optional argument *top_down* is true (which is the default), the " "triple for a directory is generated before the triples for any of its " @@ -806,7 +929,7 @@ msgid "" "the directory and its subdirectories are walked." msgstr "" -#: library/pathlib.rst:1091 +#: library/pathlib.rst:1269 msgid "" "When *top_down* is true, the caller can modify the *dirnames* list in-place " "(for example, using :keyword:`del` or slice assignment), and :meth:`Path." @@ -819,7 +942,7 @@ msgid "" "generated by the time *dirnames* is yielded to the caller." msgstr "" -#: library/pathlib.rst:1101 +#: library/pathlib.rst:1279 msgid "" "By default, errors from :func:`os.scandir` are ignored. If the optional " "argument *on_error* is specified, it should be a callable; it will be called " @@ -828,7 +951,7 @@ msgid "" "filename is available as the ``filename`` attribute of the exception object." msgstr "" -#: library/pathlib.rst:1107 +#: library/pathlib.rst:1285 msgid "" "By default, :meth:`Path.walk` does not follow symbolic links, and instead " "adds them to the *filenames* list. Set *follow_symlinks* to true to resolve " @@ -837,14 +960,14 @@ msgid "" "(where supported)." msgstr "" -#: library/pathlib.rst:1114 +#: library/pathlib.rst:1292 msgid "" "Be aware that setting *follow_symlinks* to true can lead to infinite " "recursion if a link points to a parent directory of itself. :meth:`Path." "walk` does not keep track of the directories it has already visited." msgstr "" -#: library/pathlib.rst:1119 +#: library/pathlib.rst:1297 msgid "" ":meth:`Path.walk` assumes the directories it walks are not modified during " "execution. For example, if a directory from *dirnames* has been replaced " @@ -853,545 +976,501 @@ msgid "" "*dirnames* as appropriate." msgstr "" -#: library/pathlib.rst:1127 +#: library/pathlib.rst:1305 msgid "" "Unlike :func:`os.walk`, :meth:`Path.walk` lists symlinks to directories in " "*filenames* if *follow_symlinks* is false." msgstr "" -#: library/pathlib.rst:1130 +#: library/pathlib.rst:1308 msgid "" "This example displays the number of bytes used by all files in each " "directory, while ignoring ``__pycache__`` directories::" msgstr "" -#: library/pathlib.rst:1146 +#: library/pathlib.rst:1324 msgid "" "This next example is a simple implementation of :func:`shutil.rmtree`. " "Walking the tree bottom-up is essential as :func:`rmdir` doesn't allow " "deleting a directory before it is empty::" msgstr "" -#: library/pathlib.rst:1163 +#: library/pathlib.rst:1341 +msgid "Creating files and directories" +msgstr "" + +#: library/pathlib.rst:1345 msgid "" -"Like :meth:`Path.chmod` but, if the path points to a symbolic link, the " -"symbolic link's mode is changed rather than its target's." +"Create a file at this given path. If *mode* is given, it is combined with " +"the process's ``umask`` value to determine the file mode and access flags. " +"If the file already exists, the function succeeds when *exist_ok* is true " +"(and its modification time is updated to the current time), otherwise :exc:" +"`FileExistsError` is raised." msgstr "" -#: library/pathlib.rst:1169 +#: library/pathlib.rst:1352 msgid "" -"Like :meth:`Path.stat` but, if the path points to a symbolic link, return " -"the symbolic link's information rather than its target's." +"The :meth:`~Path.open`, :meth:`~Path.write_text` and :meth:`~Path." +"write_bytes` methods are often used to create files." msgstr "" -#: library/pathlib.rst:1175 +#: library/pathlib.rst:1358 msgid "" "Create a new directory at this given path. If *mode* is given, it is " -"combined with the process' ``umask`` value to determine the file mode and " +"combined with the process's ``umask`` value to determine the file mode and " "access flags. If the path already exists, :exc:`FileExistsError` is raised." msgstr "" -#: library/pathlib.rst:1180 +#: library/pathlib.rst:1363 msgid "" "If *parents* is true, any missing parents of this path are created as " "needed; they are created with the default permissions without taking *mode* " "into account (mimicking the POSIX ``mkdir -p`` command)." msgstr "" -#: library/pathlib.rst:1184 +#: library/pathlib.rst:1367 msgid "" "If *parents* is false (the default), a missing parent raises :exc:" "`FileNotFoundError`." msgstr "" -#: library/pathlib.rst:1187 +#: library/pathlib.rst:1370 msgid "" "If *exist_ok* is false (the default), :exc:`FileExistsError` is raised if " "the target directory already exists." msgstr "" -#: library/pathlib.rst:1190 +#: library/pathlib.rst:1373 msgid "" "If *exist_ok* is true, :exc:`FileExistsError` will not be raised unless the " "given path already exists in the file system and is not a directory (same " "behavior as the POSIX ``mkdir -p`` command)." msgstr "" -#: library/pathlib.rst:1194 +#: library/pathlib.rst:1377 msgid "The *exist_ok* parameter was added." msgstr "" -#: library/pathlib.rst:1200 -msgid "" -"Open the file pointed to by the path, like the built-in :func:`open` " -"function does::" +#: library/pathlib.rst:1383 +msgid "Make this path a symbolic link pointing to *target*." msgstr "" -#: library/pathlib.rst:1212 +#: library/pathlib.rst:1385 msgid "" -"Return the name of the user owning the file. :exc:`KeyError` is raised if " -"the file's uid isn't found in the system database." +"On Windows, a symlink represents either a file or a directory, and does not " +"morph to the target dynamically. If the target is present, the type of the " +"symlink will be created to match. Otherwise, the symlink will be created as " +"a directory if *target_is_directory* is true or a file symlink (the default) " +"otherwise. On non-Windows platforms, *target_is_directory* is ignored." msgstr "" -#: library/pathlib.rst:1218 -msgid "Return the binary contents of the pointed-to file as a bytes object::" +#: library/pathlib.rst:1403 +msgid "" +"The order of arguments (link, target) is the reverse of :func:`os.symlink`'s." msgstr "" -#: library/pathlib.rst:1231 -msgid "Return the decoded contents of the pointed-to file as a string::" +#: library/pathlib.rst:1409 +msgid "Make this path a hard link to the same file as *target*." msgstr "" -#: library/pathlib.rst:1239 +#: library/pathlib.rst:1412 msgid "" -"The file is opened and then closed. The optional parameters have the same " -"meaning as in :func:`open`." +"The order of arguments (link, target) is the reverse of :func:`os.link`'s." msgstr "" -#: library/pathlib.rst:1247 -msgid "" -"Return the path to which the symbolic link points (as returned by :func:`os." -"readlink`)::" +#: library/pathlib.rst:1419 +msgid "Renaming and deleting" msgstr "" -#: library/pathlib.rst:1260 +#: library/pathlib.rst:1423 msgid "" -"Rename this file or directory to the given *target*, and return a new Path " -"instance pointing to *target*. On Unix, if *target* exists and is a file, " -"it will be replaced silently if the user has permission. On Windows, if " -"*target* exists, :exc:`FileExistsError` will be raised. *target* can be " +"Rename this file or directory to the given *target*, and return a new :class:" +"`!Path` instance pointing to *target*. On Unix, if *target* exists and is a " +"file, it will be replaced silently if the user has permission. On Windows, " +"if *target* exists, :exc:`FileExistsError` will be raised. *target* can be " "either a string or another path object::" msgstr "" -#: library/pathlib.rst:1291 +#: library/pathlib.rst:1454 msgid "" "The target path may be absolute or relative. Relative paths are interpreted " -"relative to the current working directory, *not* the directory of the Path " -"object." +"relative to the current working directory, *not* the directory of the :class:" +"`!Path` object." msgstr "" -#: library/pathlib.rst:1279 +#: library/pathlib.rst:1442 msgid "" "It is implemented in terms of :func:`os.rename` and gives the same " "guarantees." msgstr "" -#: library/pathlib.rst:1295 -msgid "Added return value, return the new Path instance." +#: library/pathlib.rst:1458 +msgid "Added return value, return the new :class:`!Path` instance." msgstr "" -#: library/pathlib.rst:1287 +#: library/pathlib.rst:1450 msgid "" -"Rename this file or directory to the given *target*, and return a new Path " -"instance pointing to *target*. If *target* points to an existing file or " -"empty directory, it will be unconditionally replaced." +"Rename this file or directory to the given *target*, and return a new :class:" +"`!Path` instance pointing to *target*. If *target* points to an existing " +"file or empty directory, it will be unconditionally replaced." msgstr "" -#: library/pathlib.rst:1301 +#: library/pathlib.rst:1464 msgid "" -"Make the path absolute, without normalization or resolving symlinks. Returns " -"a new path object::" +"Remove this file or symbolic link. If the path points to a directory, use :" +"func:`Path.rmdir` instead." msgstr "" -#: library/pathlib.rst:1313 +#: library/pathlib.rst:1467 msgid "" -"Make the path absolute, resolving any symlinks. A new path object is " -"returned::" +"If *missing_ok* is false (the default), :exc:`FileNotFoundError` is raised " +"if the path does not exist." msgstr "" -#: library/pathlib.rst:1322 +#: library/pathlib.rst:1470 msgid "" -"\"``..``\" components are also eliminated (this is the only method to do " -"so)::" +"If *missing_ok* is true, :exc:`FileNotFoundError` exceptions will be ignored " +"(same behavior as the POSIX ``rm -f`` command)." msgstr "" -#: library/pathlib.rst:1328 -msgid "" -"If the path doesn't exist and *strict* is ``True``, :exc:`FileNotFoundError` " -"is raised. If *strict* is ``False``, the path is resolved as far as " -"possible and any remainder is appended without checking whether it exists. " -"If an infinite loop is encountered along the resolution path, :exc:" -"`RuntimeError` is raised." +#: library/pathlib.rst:1473 +msgid "The *missing_ok* parameter was added." msgstr "" -#: library/pathlib.rst:1334 -msgid "The *strict* parameter was added (pre-3.6 behavior is strict)." +#: library/pathlib.rst:1479 +msgid "Remove this directory. The directory must be empty." msgstr "" -#: library/pathlib.rst:1339 +#: library/pathlib.rst:1483 +msgid "Permissions and ownership" +msgstr "" + +#: library/pathlib.rst:1487 msgid "" -"Glob the given relative *pattern* recursively. This is like calling :func:" -"`Path.glob` with \"``**/``\" added in front of the *pattern*, where " -"*patterns* are the same as for :mod:`fnmatch`::" +"Return the name of the user owning the file. :exc:`KeyError` is raised if " +"the file's user identifier (UID) isn't found in the system database." msgstr "" -#: library/pathlib.rst:1355 +#: library/pathlib.rst:1493 msgid "" -"Raises an :ref:`auditing event ` ``pathlib.Path.rglob`` with " -"arguments ``self``, ``pattern``." +"Return the name of the group owning the file. :exc:`KeyError` is raised if " +"the file's group identifier (GID) isn't found in the system database." msgstr "" -#: library/pathlib.rst:1367 -msgid "Remove this directory. The directory must be empty." +#: library/pathlib.rst:1499 +msgid "Change the file mode and permissions, like :func:`os.chmod`." msgstr "" -#: library/pathlib.rst:1372 +#: library/pathlib.rst:1501 msgid "" -"Return whether this path points to the same file as *other_path*, which can " -"be either a Path object, or a string. The semantics are similar to :func:" -"`os.path.samefile` and :func:`os.path.samestat`." +"This method normally follows symlinks. Some Unix flavours support changing " +"permissions on the symlink itself; on these platforms you may add the " +"argument ``follow_symlinks=False``, or use :meth:`~Path.lchmod`." msgstr "" -#: library/pathlib.rst:1376 +#: library/pathlib.rst:1520 msgid "" -"An :exc:`OSError` can be raised if either file cannot be accessed for some " -"reason." +"Like :meth:`Path.chmod` but, if the path points to a symbolic link, the " +"symbolic link's mode is changed rather than its target's." msgstr "" -#: library/pathlib.rst:1393 -msgid "Make this path a symbolic link pointing to *target*." +#: library/pathlib.rst:1525 +msgid "Correspondence to tools in the :mod:`os` module" msgstr "" -#: library/pathlib.rst:1395 +#: library/pathlib.rst:1527 msgid "" -"On Windows, a symlink represents either a file or a directory, and does not " -"morph to the target dynamically. If the target is present, the type of the " -"symlink will be created to match. Otherwise, the symlink will be created as " -"a directory if *target_is_directory* is ``True`` or a file symlink (the " -"default) otherwise. On non-Windows platforms, *target_is_directory* is " -"ignored." +"Below is a table mapping various :mod:`os` functions to their corresponding :" +"class:`PurePath`/:class:`Path` equivalent." msgstr "" -#: library/pathlib.rst:1413 -msgid "" -"The order of arguments (link, target) is the reverse of :func:`os.symlink`'s." +#: library/pathlib.rst:1531 +msgid ":mod:`os` and :mod:`os.path`" msgstr "" -#: library/pathlib.rst:1418 -msgid "Make this path a hard link to the same file as *target*." +#: library/pathlib.rst:1531 +msgid ":mod:`pathlib`" msgstr "" -#: library/pathlib.rst:1421 -msgid "" -"The order of arguments (link, target) is the reverse of :func:`os.link`'s." +#: library/pathlib.rst:1533 +msgid ":func:`os.path.dirname`" msgstr "" -#: library/pathlib.rst:1429 -msgid "" -"Create a file at this given path. If *mode* is given, it is combined with " -"the process' ``umask`` value to determine the file mode and access flags. " -"If the file already exists, the function succeeds if *exist_ok* is true (and " -"its modification time is updated to the current time), otherwise :exc:" -"`FileExistsError` is raised." +#: library/pathlib.rst:1533 +msgid ":attr:`PurePath.parent`" msgstr "" -#: library/pathlib.rst:1438 -msgid "" -"Remove this file or symbolic link. If the path points to a directory, use :" -"func:`Path.rmdir` instead." +#: library/pathlib.rst:1534 +msgid ":func:`os.path.basename`" msgstr "" -#: library/pathlib.rst:1441 -msgid "" -"If *missing_ok* is false (the default), :exc:`FileNotFoundError` is raised " -"if the path does not exist." +#: library/pathlib.rst:1534 +msgid ":attr:`PurePath.name`" msgstr "" -#: library/pathlib.rst:1444 -msgid "" -"If *missing_ok* is true, :exc:`FileNotFoundError` exceptions will be ignored " -"(same behavior as the POSIX ``rm -f`` command)." +#: library/pathlib.rst:1535 +msgid ":func:`os.path.splitext`" msgstr "" -#: library/pathlib.rst:1447 -msgid "The *missing_ok* parameter was added." +#: library/pathlib.rst:1535 +msgid ":attr:`PurePath.stem`, :attr:`PurePath.suffix`" msgstr "" -#: library/pathlib.rst:1453 -msgid "" -"Open the file pointed to in bytes mode, write *data* to it, and close the " -"file::" +#: library/pathlib.rst:1536 +msgid ":func:`os.path.join`" msgstr "" -#: library/pathlib.rst:1462 -msgid "An existing file of the same name is overwritten." +#: library/pathlib.rst:1536 +msgid ":meth:`PurePath.joinpath`" msgstr "" -#: library/pathlib.rst:1469 -msgid "" -"Open the file pointed to in text mode, write *data* to it, and close the " -"file::" +#: library/pathlib.rst:1537 +msgid ":func:`os.path.isabs`" msgstr "" -#: library/pathlib.rst:1478 -msgid "" -"An existing file of the same name is overwritten. The optional parameters " -"have the same meaning as in :func:`open`." +#: library/pathlib.rst:1537 +msgid ":meth:`PurePath.is_absolute`" msgstr "" -#: library/pathlib.rst:1483 -msgid "The *newline* parameter was added." +#: library/pathlib.rst:1538 +msgid ":func:`os.path.relpath`" msgstr "" -#: library/pathlib.rst:1487 -msgid "Correspondence to tools in the :mod:`os` module" +#: library/pathlib.rst:1538 +msgid ":meth:`PurePath.relative_to` [1]_" msgstr "" -#: library/pathlib.rst:1489 -msgid "" -"Below is a table mapping various :mod:`os` functions to their corresponding :" -"class:`PurePath`/:class:`Path` equivalent." +#: library/pathlib.rst:1539 +msgid ":func:`os.path.expanduser`" msgstr "" -#: library/pathlib.rst:1494 -msgid "" -"Not all pairs of functions/methods below are equivalent. Some of them, " -"despite having some overlapping use-cases, have different semantics. They " -"include :func:`os.path.abspath` and :meth:`Path.absolute`, :func:`os.path." -"relpath` and :meth:`PurePath.relative_to`." +#: library/pathlib.rst:1539 +msgid ":meth:`Path.expanduser` [2]_" msgstr "" -#: library/pathlib.rst:1500 -msgid ":mod:`os` and :mod:`os.path`" +#: library/pathlib.rst:1540 +msgid ":func:`os.path.realpath`" msgstr "" -#: library/pathlib.rst:1500 -msgid ":mod:`pathlib`" +#: library/pathlib.rst:1540 +msgid ":meth:`Path.resolve`" msgstr "" -#: library/pathlib.rst:1502 +#: library/pathlib.rst:1541 msgid ":func:`os.path.abspath`" msgstr "" -#: library/pathlib.rst:1502 -msgid ":meth:`Path.absolute` [#]_" +#: library/pathlib.rst:1541 +msgid ":meth:`Path.absolute` [3]_" msgstr "" -#: library/pathlib.rst:1503 -msgid ":func:`os.path.realpath`" -msgstr "" - -#: library/pathlib.rst:1503 -msgid ":meth:`Path.resolve`" +#: library/pathlib.rst:1542 +msgid ":func:`os.path.exists`" msgstr "" -#: library/pathlib.rst:1504 -msgid ":func:`os.chmod`" +#: library/pathlib.rst:1542 +msgid ":meth:`Path.exists`" msgstr "" -#: library/pathlib.rst:1504 -msgid ":meth:`Path.chmod`" +#: library/pathlib.rst:1543 +msgid ":func:`os.path.isfile`" msgstr "" -#: library/pathlib.rst:1505 -msgid ":func:`os.mkdir`" +#: library/pathlib.rst:1543 +msgid ":meth:`Path.is_file`" msgstr "" -#: library/pathlib.rst:1506 -msgid ":meth:`Path.mkdir`" +#: library/pathlib.rst:1544 +msgid ":func:`os.path.isdir`" msgstr "" -#: library/pathlib.rst:1506 -msgid ":func:`os.makedirs`" +#: library/pathlib.rst:1544 +msgid ":meth:`Path.is_dir`" msgstr "" -#: library/pathlib.rst:1507 -msgid ":func:`os.rename`" +#: library/pathlib.rst:1545 +msgid ":func:`os.path.islink`" msgstr "" -#: library/pathlib.rst:1507 -msgid ":meth:`Path.rename`" +#: library/pathlib.rst:1545 +msgid ":meth:`Path.is_symlink`" msgstr "" -#: library/pathlib.rst:1508 -msgid ":func:`os.replace`" +#: library/pathlib.rst:1546 +msgid ":func:`os.path.isjunction`" msgstr "" -#: library/pathlib.rst:1508 -msgid ":meth:`Path.replace`" +#: library/pathlib.rst:1546 +msgid ":meth:`Path.is_junction`" msgstr "" -#: library/pathlib.rst:1509 -msgid ":func:`os.rmdir`" +#: library/pathlib.rst:1547 +msgid ":func:`os.path.ismount`" msgstr "" -#: library/pathlib.rst:1509 -msgid ":meth:`Path.rmdir`" +#: library/pathlib.rst:1547 +msgid ":meth:`Path.is_mount`" msgstr "" -#: library/pathlib.rst:1510 -msgid ":func:`os.remove`, :func:`os.unlink`" +#: library/pathlib.rst:1548 +msgid ":func:`os.path.samefile`" msgstr "" -#: library/pathlib.rst:1510 -msgid ":meth:`Path.unlink`" +#: library/pathlib.rst:1548 +msgid ":meth:`Path.samefile`" msgstr "" -#: library/pathlib.rst:1511 +#: library/pathlib.rst:1549 msgid ":func:`os.getcwd`" msgstr "" -#: library/pathlib.rst:1511 -msgid ":func:`Path.cwd`" +#: library/pathlib.rst:1549 +msgid ":meth:`Path.cwd`" msgstr "" -#: library/pathlib.rst:1512 -msgid ":func:`os.path.exists`" +#: library/pathlib.rst:1550 +msgid ":func:`os.stat`" msgstr "" -#: library/pathlib.rst:1512 -msgid ":meth:`Path.exists`" +#: library/pathlib.rst:1550 +msgid ":meth:`Path.stat`" msgstr "" -#: library/pathlib.rst:1513 -msgid ":func:`os.path.expanduser`" +#: library/pathlib.rst:1551 +msgid ":func:`os.lstat`" msgstr "" -#: library/pathlib.rst:1513 -msgid ":meth:`Path.expanduser` and :meth:`Path.home`" +#: library/pathlib.rst:1551 +msgid ":meth:`Path.lstat`" msgstr "" -#: library/pathlib.rst:1515 +#: library/pathlib.rst:1552 msgid ":func:`os.listdir`" msgstr "" -#: library/pathlib.rst:1515 +#: library/pathlib.rst:1552 msgid ":meth:`Path.iterdir`" msgstr "" -#: library/pathlib.rst:1516 +#: library/pathlib.rst:1553 msgid ":func:`os.walk`" msgstr "" -#: library/pathlib.rst:1516 -msgid ":meth:`Path.walk`" -msgstr "" - -#: library/pathlib.rst:1517 -msgid ":func:`os.path.isdir`" -msgstr "" - -#: library/pathlib.rst:1517 -msgid ":meth:`Path.is_dir`" -msgstr "" - -#: library/pathlib.rst:1518 -msgid ":func:`os.path.isfile`" -msgstr "" - -#: library/pathlib.rst:1518 -msgid ":meth:`Path.is_file`" +#: library/pathlib.rst:1553 +msgid ":meth:`Path.walk` [4]_" msgstr "" -#: library/pathlib.rst:1519 -msgid ":func:`os.path.islink`" +#: library/pathlib.rst:1554 +msgid ":func:`os.mkdir`, :func:`os.makedirs`" msgstr "" -#: library/pathlib.rst:1519 -msgid ":meth:`Path.is_symlink`" +#: library/pathlib.rst:1554 +msgid ":meth:`Path.mkdir`" msgstr "" -#: library/pathlib.rst:1520 +#: library/pathlib.rst:1555 msgid ":func:`os.link`" msgstr "" -#: library/pathlib.rst:1520 +#: library/pathlib.rst:1555 msgid ":meth:`Path.hardlink_to`" msgstr "" -#: library/pathlib.rst:1521 +#: library/pathlib.rst:1556 msgid ":func:`os.symlink`" msgstr "" -#: library/pathlib.rst:1521 +#: library/pathlib.rst:1556 msgid ":meth:`Path.symlink_to`" msgstr "" -#: library/pathlib.rst:1522 +#: library/pathlib.rst:1557 msgid ":func:`os.readlink`" msgstr "" -#: library/pathlib.rst:1522 +#: library/pathlib.rst:1557 msgid ":meth:`Path.readlink`" msgstr "" -#: library/pathlib.rst:1523 -msgid ":func:`os.path.relpath`" -msgstr "" - -#: library/pathlib.rst:1523 -msgid ":meth:`PurePath.relative_to` [#]_" -msgstr "" - -#: library/pathlib.rst:1524 -msgid ":func:`os.stat`" +#: library/pathlib.rst:1558 +msgid ":func:`os.rename`" msgstr "" -#: library/pathlib.rst:1524 -msgid ":meth:`Path.stat`, :meth:`Path.owner`, :meth:`Path.group`" +#: library/pathlib.rst:1558 +msgid ":meth:`Path.rename`" msgstr "" -#: library/pathlib.rst:1527 -msgid ":func:`os.path.isabs`" +#: library/pathlib.rst:1559 +msgid ":func:`os.replace`" msgstr "" -#: library/pathlib.rst:1527 -msgid ":meth:`PurePath.is_absolute`" +#: library/pathlib.rst:1559 +msgid ":meth:`Path.replace`" msgstr "" -#: library/pathlib.rst:1528 -msgid ":func:`os.path.join`" +#: library/pathlib.rst:1560 +msgid ":func:`os.remove`, :func:`os.unlink`" msgstr "" -#: library/pathlib.rst:1528 -msgid ":func:`PurePath.joinpath`" +#: library/pathlib.rst:1560 +msgid ":meth:`Path.unlink`" msgstr "" -#: library/pathlib.rst:1529 -msgid ":func:`os.path.basename`" +#: library/pathlib.rst:1561 +msgid ":func:`os.rmdir`" msgstr "" -#: library/pathlib.rst:1529 -msgid ":attr:`PurePath.name`" +#: library/pathlib.rst:1561 +msgid ":meth:`Path.rmdir`" msgstr "" -#: library/pathlib.rst:1530 -msgid ":func:`os.path.dirname`" +#: library/pathlib.rst:1562 +msgid ":func:`os.chmod`" msgstr "" -#: library/pathlib.rst:1530 -msgid ":attr:`PurePath.parent`" +#: library/pathlib.rst:1562 +msgid ":meth:`Path.chmod`" msgstr "" -#: library/pathlib.rst:1531 -msgid ":func:`os.path.samefile`" +#: library/pathlib.rst:1563 +msgid ":func:`os.lchmod`" msgstr "" -#: library/pathlib.rst:1531 -msgid ":meth:`Path.samefile`" +#: library/pathlib.rst:1563 +msgid ":meth:`Path.lchmod`" msgstr "" -#: library/pathlib.rst:1532 -msgid ":func:`os.path.splitext`" +#: library/pathlib.rst:1567 +msgid "Footnotes" msgstr "" -#: library/pathlib.rst:1532 -msgid ":attr:`PurePath.stem` and :attr:`PurePath.suffix`" +#: library/pathlib.rst:1568 +msgid "" +":func:`os.path.relpath` calls :func:`~os.path.abspath` to make paths " +"absolute and remove \"``..``\" parts, whereas :meth:`PurePath.relative_to` " +"is a lexical operation that raises :exc:`ValueError` when its inputs' " +"anchors differ (e.g. if one path is absolute and the other relative.)" msgstr "" -#: library/pathlib.rst:1537 -msgid "Footnotes" +#: library/pathlib.rst:1572 +msgid "" +":func:`os.path.expanduser` returns the path unchanged if the home directory " +"can't be resolved, whereas :meth:`Path.expanduser` raises :exc:" +"`RuntimeError`." msgstr "" -#: library/pathlib.rst:1538 +#: library/pathlib.rst:1575 msgid "" -":func:`os.path.abspath` normalizes the resulting path, which may change its " -"meaning in the presence of symlinks, while :meth:`Path.absolute` does not." +":func:`os.path.abspath` removes \"``..``\" components without resolving " +"symlinks, which may change the meaning of the path, whereas :meth:`Path." +"absolute` leaves any \"``..``\" components in the path." msgstr "" -#: library/pathlib.rst:1539 +#: library/pathlib.rst:1578 msgid "" -":meth:`PurePath.relative_to` requires ``self`` to be the subpath of the " -"argument, but :func:`os.path.relpath` does not." +":func:`os.walk` always follows symlinks when categorizing paths into " +"*dirnames* and *filenames*, whereas :meth:`Path.walk` categorizes all " +"symlinks into *filenames* when *follow_symlinks* is false (the default.)" msgstr "" #: library/pathlib.rst:11 diff --git a/library/pdb.po b/library/pdb.po index 0a5158e5c..f234bac48 100644 --- a/library/pdb.po +++ b/library/pdb.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -234,8 +234,7 @@ msgid "Example call to enable tracing with *skip*::" msgstr "" #: library/pdb.rst:210 -msgid "" -"Raises an :ref:`auditing event ` ``pdb.Pdb`` with no arguments." +msgid "Raises an auditing event pdb.Pdb with no arguments." msgstr "" #: library/pdb.rst:212 diff --git a/library/pickle.po b/library/pickle.po index a4b76f162..eaf789a11 100644 --- a/library/pickle.po +++ b/library/pickle.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -613,9 +613,7 @@ msgid "" msgstr "" #: library/pickle.rst:460 -msgid "" -"Raises an :ref:`auditing event ` ``pickle.find_class`` with " -"arguments ``module``, ``name``." +msgid "Raises an auditing event pickle.find_class with arguments module, name." msgstr "" #: library/pickle.rst:464 diff --git a/library/pipes.po b/library/pipes.po index c458932df..10aa44b68 100644 --- a/library/pipes.po +++ b/library/pipes.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-03-01 00:18+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/pipes.py`" msgstr "" -#: library/pipes.rst:17 +#: library/pipes.rst:13 msgid "" "The :mod:`pipes` module is deprecated (see :pep:`PEP 594 <594#pipes>` for " "details). Please use the :mod:`subprocess` module instead." diff --git a/library/pkgutil.po b/library/pkgutil.po index 133e4a0e3..48f957c97 100644 --- a/library/pkgutil.po +++ b/library/pkgutil.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -54,9 +54,9 @@ msgid "" "*name* argument. This feature is similar to :file:`\\*.pth` files (see the :" "mod:`site` module for more information), except that it doesn't special-case " "lines starting with ``import``. A :file:`\\*.pkg` file is trusted at face " -"value: apart from checking for duplicates, all entries found in a :file:`\\*." -"pkg` file are added to the path, regardless of whether they exist on the " -"filesystem. (This is a feature.)" +"value: apart from skipping blank lines and ignoring comments, all entries " +"found in a :file:`\\*.pkg` file are added to the path, regardless of whether " +"they exist on the filesystem (this is a feature)." msgstr "" #: library/pkgutil.rst:41 @@ -97,7 +97,7 @@ msgstr "" msgid "Updated to be based on :pep:`451`" msgstr "" -#: library/pkgutil.rst:104 +#: library/pkgutil.rst:103 msgid "Use :func:`importlib.util.find_spec` instead." msgstr "" diff --git a/library/poplib.po b/library/poplib.po index 2e9a5c5c1..f4317da60 100644 --- a/library/poplib.po +++ b/library/poplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -73,16 +73,15 @@ msgid "" "timeout setting will be used)." msgstr "" -#: library/poplib.rst:77 +#: library/poplib.rst:66 msgid "" -"Raises an :ref:`auditing event ` ``poplib.connect`` with arguments " -"``self``, ``host``, ``port``." +"Raises an auditing event poplib.connect with arguments self, host, port." msgstr "" -#: library/poplib.rst:79 +#: library/poplib.rst:68 msgid "" -"Raises an :ref:`auditing event ` ``poplib.putline`` with arguments " -"``self``, ``line``." +"All commands will raise an auditing event poplib.putline with arguments self " +"and line, where line is the bytes about to be sent to the remote host." msgstr "" #: library/poplib.rst:70 diff --git a/library/pprint.po b/library/pprint.po index a376c7189..f1eed88c9 100644 --- a/library/pprint.po +++ b/library/pprint.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -57,173 +57,153 @@ msgstr "" msgid "Functions" msgstr "" -#: library/pprint.rst:40 +#: library/pprint.rst:41 msgid "" -"Prints the formatted representation of *object* followed by a newline. If " -"*sort_dicts* is false (the default), dictionaries will be displayed with " -"their keys in insertion order, otherwise the dict keys will be sorted. " -"*args* and *kwargs* will be passed to :func:`~pprint.pprint` as formatting " -"parameters." +"Prints the formatted representation of *object*, followed by a newline. This " +"function may be used in the interactive interpreter instead of the :func:" +"`print` function for inspecting values. Tip: you can reassign ``print = " +"pprint.pp`` for use within a scope." msgstr "" -#: library/pprint.rst:63 -msgid "" -"Prints the formatted representation of *object* on *stream*, followed by a " -"newline. If *stream* is ``None``, :data:`sys.stdout` is used. This may be " -"used in the interactive interpreter instead of the :func:`print` function " -"for inspecting values (you can even reassign ``print = pprint.pprint`` for " -"use within a scope)." +#: library/pprint.rst:0 +msgid "Parameters" msgstr "" -#: library/pprint.rst:69 -msgid "" -"The configuration parameters *stream*, *indent*, *width*, *depth*, " -"*compact*, *sort_dicts* and *underscore_numbers* are passed to the :class:" -"`PrettyPrinter` constructor and their meanings are as described in its " -"documentation below." +#: library/pprint.rst:46 +msgid "The object to be printed." msgstr "" -#: library/pprint.rst:74 +#: library/pprint.rst:49 msgid "" -"Note that *sort_dicts* is ``True`` by default and you might want to use :" -"func:`~pprint.pp` instead where it is ``False`` by default." +"A file-like object to which the output will be written by calling its :meth:" +"`!write` method. If ``None`` (the default), :data:`sys.stdout` is used." msgstr "" -#: library/pprint.rst:80 -msgid "" -"Return the formatted representation of *object* as a string. *indent*, " -"*width*, *depth*, *compact*, *sort_dicts* and *underscore_numbers* are " -"passed to the :class:`PrettyPrinter` constructor as formatting parameters " -"and their meanings are as described in its documentation below." +#: library/pprint.rst:55 +msgid "The amount of indentation added for each nesting level." msgstr "" -#: library/pprint.rst:90 +#: library/pprint.rst:58 msgid "" -"Determine if the formatted representation of *object* is \"readable\", or " -"can be used to reconstruct the value using :func:`eval`. This always " -"returns ``False`` for recursive objects." +"The desired maximum number of characters per line in the output. If a " +"structure cannot be formatted within the width constraint, a best effort " +"will be made." msgstr "" -#: library/pprint.rst:100 +#: library/pprint.rst:63 msgid "" -"Determine if *object* requires a recursive representation. This function is " -"subject to the same limitations as noted in :func:`saferepr` below and may " -"raise an :exc:`RecursionError` if it fails to detect a recursive object." +"The number of nesting levels which may be printed. If the data structure " +"being printed is too deep, the next contained level is replaced by ``...``. " +"If ``None`` (the default), there is no constraint on the depth of the " +"objects being formatted." msgstr "" -#: library/pprint.rst:107 +#: library/pprint.rst:71 msgid "" -"Return a string representation of *object*, protected against recursion in " -"some common data structures, namely instances of :class:`dict`, :class:" -"`list` and :class:`tuple` or subclasses whose ``__repr__`` has not been " -"overridden. If the representation of object exposes a recursive entry, the " -"recursive reference will be represented as ````. The representation is not otherwise formatted." +"Control the way long :term:`sequences ` are formatted. If " +"``False`` (the default), each item of a sequence will be formatted on a " +"separate line, otherwise as many items as will fit within the *width* will " +"be formatted on each output line." msgstr "" -#: library/pprint.rst:120 -msgid "PrettyPrinter Objects" -msgstr "" - -#: library/pprint.rst:122 -msgid "This module defines one class:" +#: library/pprint.rst:78 +msgid "" +"If ``True``, dictionaries will be formatted with their keys sorted, " +"otherwise they will be displayed in insertion order (the default)." msgstr "" -#: library/pprint.rst:132 +#: library/pprint.rst:83 msgid "" -"Construct a :class:`PrettyPrinter` instance. This constructor understands " -"several keyword parameters." +"If ``True``, integers will be formatted with the ``_`` character for a " +"thousands separator, otherwise underscores are not displayed (the default)." msgstr "" -#: library/pprint.rst:135 +#: library/pprint.rst:105 msgid "" -"*stream* (default :data:`!sys.stdout`) is a :term:`file-like object` to " -"which the output will be written by calling its :meth:`!write` method. If " -"both *stream* and :data:`!sys.stdout` are ``None``, then :meth:" -"`~PrettyPrinter.pprint` silently returns." +"Alias for :func:`~pprint.pp` with *sort_dicts* set to ``True`` by default, " +"which would automatically sort the dictionaries' keys, you might want to " +"use :func:`~pprint.pp` instead where it is ``False`` by default." msgstr "" -#: library/pprint.rst:140 +#: library/pprint.rst:113 msgid "" -"Other values configure the manner in which nesting of complex data " -"structures is displayed." +"Return the formatted representation of *object* as a string. *indent*, " +"*width*, *depth*, *compact*, *sort_dicts* and *underscore_numbers* are " +"passed to the :class:`PrettyPrinter` constructor as formatting parameters " +"and their meanings are as described in the documentation above." msgstr "" -#: library/pprint.rst:143 +#: library/pprint.rst:123 msgid "" -"*indent* (default 1) specifies the amount of indentation added for each " -"nesting level." +"Determine if the formatted representation of *object* is \"readable\", or " +"can be used to reconstruct the value using :func:`eval`. This always " +"returns ``False`` for recursive objects." msgstr "" -#: library/pprint.rst:146 +#: library/pprint.rst:133 msgid "" -"*depth* controls the number of nesting levels which may be printed; if the " -"data structure being printed is too deep, the next contained level is " -"replaced by ``...``. By default, there is no constraint on the depth of the " -"objects being formatted." +"Determine if *object* requires a recursive representation. This function is " +"subject to the same limitations as noted in :func:`saferepr` below and may " +"raise an :exc:`RecursionError` if it fails to detect a recursive object." msgstr "" -#: library/pprint.rst:151 +#: library/pprint.rst:140 msgid "" -"*width* (default 80) specifies the desired maximum number of characters per " -"line in the output. If a structure cannot be formatted within the width " -"constraint, a best effort will be made." +"Return a string representation of *object*, protected against recursion in " +"some common data structures, namely instances of :class:`dict`, :class:" +"`list` and :class:`tuple` or subclasses whose ``__repr__`` has not been " +"overridden. If the representation of object exposes a recursive entry, the " +"recursive reference will be represented as ````. The representation is not otherwise formatted." msgstr "" -#: library/pprint.rst:155 -msgid "" -"*compact* impacts the way that long sequences (lists, tuples, sets, etc) are " -"formatted. If *compact* is false (the default) then each item of a sequence " -"will be formatted on a separate line. If *compact* is true, as many items " -"as will fit within the *width* will be formatted on each output line." +#: library/pprint.rst:153 +msgid "PrettyPrinter Objects" msgstr "" -#: library/pprint.rst:161 -msgid "" -"If *sort_dicts* is true (the default), dictionaries will be formatted with " -"their keys sorted, otherwise they will display in insertion order." +#: library/pprint.rst:160 +msgid "Construct a :class:`PrettyPrinter` instance." msgstr "" -#: library/pprint.rst:164 +#: library/pprint.rst:162 msgid "" -"If *underscore_numbers* is true, integers will be formatted with the ``_`` " -"character for a thousands separator, otherwise underscores are not displayed " -"(the default)." +"Arguments have the same meaning as for :func:`~pprint.pp`. Note that they " +"are in a different order, and that *sort_dicts* defaults to ``True``." msgstr "" -#: library/pprint.rst:168 +#: library/pprint.rst:189 msgid "Added the *compact* parameter." msgstr "" -#: library/pprint.rst:171 +#: library/pprint.rst:192 msgid "Added the *sort_dicts* parameter." msgstr "" -#: library/pprint.rst:174 +#: library/pprint.rst:195 msgid "Added the *underscore_numbers* parameter." msgstr "" -#: library/pprint.rst:177 +#: library/pprint.rst:198 msgid "No longer attempts to write to :data:`!sys.stdout` if it is ``None``." msgstr "" -#: library/pprint.rst:204 +#: library/pprint.rst:202 msgid ":class:`PrettyPrinter` instances have the following methods:" msgstr "" -#: library/pprint.rst:209 +#: library/pprint.rst:207 msgid "" "Return the formatted representation of *object*. This takes into account " "the options passed to the :class:`PrettyPrinter` constructor." msgstr "" -#: library/pprint.rst:215 +#: library/pprint.rst:213 msgid "" "Print the formatted representation of *object* on the configured stream, " "followed by a newline." msgstr "" -#: library/pprint.rst:218 +#: library/pprint.rst:216 msgid "" "The following methods provide the implementations for the corresponding " "functions of the same names. Using these methods on an instance is slightly " @@ -231,7 +211,7 @@ msgid "" "created." msgstr "" -#: library/pprint.rst:228 +#: library/pprint.rst:226 msgid "" "Determine if the formatted representation of the object is \"readable,\" or " "can be used to reconstruct the value using :func:`eval`. Note that this " @@ -240,18 +220,18 @@ msgid "" "returns ``False``." msgstr "" -#: library/pprint.rst:237 +#: library/pprint.rst:235 msgid "Determine if the object requires a recursive representation." msgstr "" -#: library/pprint.rst:239 +#: library/pprint.rst:237 msgid "" "This method is provided as a hook to allow subclasses to modify the way " "objects are converted to strings. The default implementation uses the " "internals of the :func:`saferepr` implementation." msgstr "" -#: library/pprint.rst:246 +#: library/pprint.rst:244 msgid "" "Returns three values: the formatted version of *object* as a string, a flag " "indicating whether the result is readable, and a flag indicating whether " @@ -269,45 +249,45 @@ msgid "" "of the current call." msgstr "" -#: library/pprint.rst:264 +#: library/pprint.rst:262 msgid "Example" msgstr "" -#: library/pprint.rst:266 +#: library/pprint.rst:264 msgid "" "To demonstrate several uses of the :func:`~pprint.pp` function and its " "parameters, let's fetch information about a project from `PyPI `_::" msgstr "" -#: library/pprint.rst:275 +#: library/pprint.rst:273 msgid "In its basic form, :func:`~pprint.pp` shows the whole object::" msgstr "" -#: library/pprint.rst:331 +#: library/pprint.rst:329 msgid "" "The result can be limited to a certain *depth* (ellipsis is used for deeper " "contents)::" msgstr "" -#: library/pprint.rst:377 +#: library/pprint.rst:375 msgid "" "Additionally, maximum character *width* can be suggested. If a long object " "cannot be split, the specified width will be exceeded::" msgstr "" -#: library/pprint.rst:226 +#: library/pprint.rst:224 msgid "built-in function" msgstr "" -#: library/pprint.rst:226 +#: library/pprint.rst:224 msgid "eval" msgstr "" -#: library/pprint.rst:127 +#: library/pprint.rst:155 msgid "..." msgstr "" -#: library/pprint.rst:127 +#: library/pprint.rst:155 msgid "placeholder" msgstr "" diff --git a/library/profile.po b/library/profile.po index 0c2eea095..216a49ab5 100644 --- a/library/profile.po +++ b/library/profile.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -924,7 +924,7 @@ msgid "" "function that you choose (see :ref:`profile-calibration`). For most " "machines, a timer that returns a lone integer value will provide the best " "results in terms of low overhead during profiling. (:func:`os.times` is " -"*pretty* bad, as it returns a tuple of floating point values). If you want " +"*pretty* bad, as it returns a tuple of floating-point values). If you want " "to substitute a better timer in the cleanest fashion, derive a class and " "hardwire a replacement dispatch method that best handles your timer call, " "along with the appropriate calibration constant." @@ -948,7 +948,7 @@ msgid "" "As the :class:`cProfile.Profile` class cannot be calibrated, custom timer " "functions should be used with care and should be as fast as possible. For " "the best results with a custom timer, it might be necessary to hard-code it " -"in the C source of the internal :mod:`_lsprof` module." +"in the C source of the internal :mod:`!_lsprof` module." msgstr "" #: library/profile.rst:697 diff --git a/library/pty.po b/library/pty.po index 6f0bf202e..873f5d855 100644 --- a/library/pty.po +++ b/library/pty.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -123,9 +123,7 @@ msgid "" msgstr "" #: library/pty.rst:82 -msgid "" -"Raises an :ref:`auditing event ` ``pty.spawn`` with argument " -"``argv``." +msgid "Raises an auditing event pty.spawn with argument argv." msgstr "" #: library/pty.rst:84 diff --git a/library/random.po b/library/random.po index 6d86f5ef5..5f57dea0c 100644 --- a/library/random.po +++ b/library/random.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -276,7 +276,7 @@ msgstr "" msgid "" "For a given seed, the :func:`choices` function with equal weighting " "typically produces a different sequence than repeated calls to :func:" -"`choice`. The algorithm used by :func:`choices` uses floating point " +"`choice`. The algorithm used by :func:`choices` uses floating-point " "arithmetic for internal consistency and speed. The algorithm used by :func:" "`choice` defaults to integer arithmetic with repeated selections to avoid " "small biases from round-off error." @@ -402,12 +402,12 @@ msgstr "" #: library/random.rst:295 msgid "" -"Return the next random floating point number in the range ``0.0 <= X < 1.0``" +"Return the next random floating-point number in the range ``0.0 <= X < 1.0``" msgstr "" #: library/random.rst:300 msgid "" -"Return a random floating point number *N* such that ``a <= N <= b`` for ``a " +"Return a random floating-point number *N* such that ``a <= N <= b`` for ``a " "<= b`` and ``b <= N <= a`` for ``b < a``." msgstr "" @@ -419,7 +419,7 @@ msgstr "" #: library/random.rst:310 msgid "" -"Return a random floating point number *N* such that ``low <= N <= high`` and " +"Return a random floating-point number *N* such that ``low <= N <= high`` and " "with the specified *mode* between those bounds. The *low* and *high* bounds " "default to zero and one. The *mode* argument defaults to the midpoint " "between the bounds, giving a symmetric distribution." diff --git a/library/re.po b/library/re.po index 793b12cd2..ddc8ce4d5 100644 --- a/library/re.po +++ b/library/re.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -144,7 +144,7 @@ msgstr "" msgid "The special characters are:" msgstr "" -#: library/re.rst:1606 +#: library/re.rst:1638 msgid "``.``" msgstr "" @@ -152,7 +152,7 @@ msgstr "" msgid "" "(Dot.) In the default mode, this matches any character except a newline. " "If the :const:`DOTALL` flag has been specified, this matches any character " -"including a newline." +"including a newline. ``(?s:.)`` matches any character regardless of flags." msgstr "" #: library/re.rst:108 @@ -1173,7 +1173,8 @@ msgid "" "match`, :func:`~Pattern.search` and other methods, described below." msgstr "" -#: library/re.rst:882 +#: library/re.rst:914 library/re.rst:943 library/re.rst:1018 +#: library/re.rst:1092 library/re.rst:1131 msgid "" "The expression's behaviour can be modified by specifying a *flags* value. " "Values can be any of the `flags`_ variables, combined using bitwise OR (the " @@ -1212,7 +1213,7 @@ msgid "" "some point in the string." msgstr "" -#: library/re.rst:917 +#: library/re.rst:921 msgid "" "If zero or more characters at the beginning of *string* match the regular " "expression *pattern*, return a corresponding :class:`~re.Match`. Return " @@ -1220,26 +1221,26 @@ msgid "" "different from a zero-length match." msgstr "" -#: library/re.rst:922 +#: library/re.rst:926 msgid "" "Note that even in :const:`MULTILINE` mode, :func:`re.match` will only match " "at the beginning of the string and not at the beginning of each line." msgstr "" -#: library/re.rst:925 +#: library/re.rst:929 msgid "" "If you want to locate a match anywhere in *string*, use :func:`search` " "instead (see also :ref:`search-vs-match`)." msgstr "" -#: library/re.rst:931 +#: library/re.rst:939 msgid "" "If the whole *string* matches the regular expression *pattern*, return a " "corresponding :class:`~re.Match`. Return ``None`` if the string does not " "match the pattern; note that this is different from a zero-length match." msgstr "" -#: library/re.rst:940 +#: library/re.rst:952 msgid "" "Split *string* by the occurrences of *pattern*. If capturing parentheses " "are used in *pattern*, then the text of all groups in the pattern are also " @@ -1248,42 +1249,42 @@ msgid "" "final element of the list. ::" msgstr "" -#: library/re.rst:955 +#: library/re.rst:967 msgid "" "If there are capturing groups in the separator and it matches at the start " "of the string, the result will start with an empty string. The same holds " "for the end of the string::" msgstr "" -#: library/re.rst:962 +#: library/re.rst:974 msgid "" "That way, separator components are always found at the same relative indices " "within the result list." msgstr "" -#: library/re.rst:965 +#: library/re.rst:977 msgid "" "Empty matches for the pattern split the string only when not adjacent to a " "previous empty match." msgstr "" -#: library/re.rst:1068 library/re.rst:1097 +#: library/re.rst:1096 library/re.rst:1125 msgid "Added the optional flags argument." msgstr "" -#: library/re.rst:980 +#: library/re.rst:996 msgid "" "Added support of splitting on a pattern that could match an empty string." msgstr "" -#: library/re.rst:986 +#: library/re.rst:1002 msgid "" "Return all non-overlapping matches of *pattern* in *string*, as a list of " "strings or tuples. The *string* is scanned left-to-right, and matches are " "returned in the order found. Empty matches are included in the result." msgstr "" -#: library/re.rst:990 +#: library/re.rst:1006 msgid "" "The result depends on the number of capturing groups in the pattern. If " "there are no groups, return a list of strings matching the whole pattern. " @@ -1293,11 +1294,11 @@ msgid "" "result." msgstr "" -#: library/re.rst:1013 +#: library/re.rst:1037 msgid "Non-empty matches can now start just after a previous empty match." msgstr "" -#: library/re.rst:1008 +#: library/re.rst:1028 msgid "" "Return an :term:`iterator` yielding :class:`~re.Match` objects over all non-" "overlapping matches for the RE *pattern* in *string*. The *string* is " @@ -1305,7 +1306,7 @@ msgid "" "matches are included in the result." msgstr "" -#: library/re.rst:1019 +#: library/re.rst:1043 msgid "" "Return the string obtained by replacing the leftmost non-overlapping " "occurrences of *pattern* in *string* by the replacement *repl*. If the " @@ -1319,18 +1320,18 @@ msgid "" "For example::" msgstr "" -#: library/re.rst:1035 +#: library/re.rst:1059 msgid "" "If *repl* is a function, it is called for every non-overlapping occurrence " "of *pattern*. The function takes a single :class:`~re.Match` argument, and " "returns the replacement string. For example::" msgstr "" -#: library/re.rst:1048 +#: library/re.rst:1072 msgid "The pattern may be a string or a :class:`~re.Pattern`." msgstr "" -#: library/re.rst:1050 +#: library/re.rst:1074 msgid "" "The optional argument *count* is the maximum number of pattern occurrences " "to be replaced; *count* must be a non-negative integer. If omitted or zero, " @@ -1339,7 +1340,7 @@ msgid "" "'abxd')`` returns ``'-a-b--d-'``." msgstr "" -#: library/re.rst:1058 +#: library/re.rst:1082 msgid "" "In string-type *repl* arguments, in addition to the character escapes and " "backreferences described above, ``\\g`` will use the substring matched " @@ -1352,59 +1353,59 @@ msgid "" "RE." msgstr "" -#: library/re.rst:1100 library/re.rst:1344 +#: library/re.rst:1128 library/re.rst:1376 msgid "Unmatched groups are replaced with an empty string." msgstr "" -#: library/re.rst:1074 +#: library/re.rst:1102 msgid "" "Unknown escapes in *pattern* consisting of ``'\\'`` and an ASCII letter now " "are errors." msgstr "" -#: library/re.rst:1078 +#: library/re.rst:1106 msgid "" "Unknown escapes in *repl* consisting of ``'\\'`` and an ASCII letter now are " "errors." msgstr "" -#: library/re.rst:1082 +#: library/re.rst:1110 msgid "" "Empty matches for the pattern are replaced when adjacent to a previous non-" "empty match." msgstr "" -#: library/re.rst:1086 +#: library/re.rst:1114 msgid "" "Group *id* can only contain ASCII digits. In :class:`bytes` replacement " "strings, group *name* can only contain bytes in the ASCII range " "(``b'\\x00'``-``b'\\x7f'``)." msgstr "" -#: library/re.rst:1094 +#: library/re.rst:1122 msgid "" "Perform the same operation as :func:`sub`, but return a tuple ``(new_string, " "number_of_subs_made)``." msgstr "" -#: library/re.rst:1106 +#: library/re.rst:1138 msgid "" "Escape special characters in *pattern*. This is useful if you want to match " "an arbitrary literal string that may have regular expression metacharacters " "in it. For example::" msgstr "" -#: library/re.rst:1121 +#: library/re.rst:1153 msgid "" "This function must not be used for the replacement string in :func:`sub` " "and :func:`subn`, only backslashes should be escaped. For example::" msgstr "" -#: library/re.rst:1129 +#: library/re.rst:1161 msgid "The ``'_'`` character is no longer escaped." msgstr "" -#: library/re.rst:1132 +#: library/re.rst:1164 msgid "" "Only characters that can have special meaning in a regular expression are " "escaped. As a result, ``'!'``, ``'\"'``, ``'%'``, ``\"'\"``, ``','``, " @@ -1412,15 +1413,15 @@ msgid "" "are no longer escaped." msgstr "" -#: library/re.rst:1141 +#: library/re.rst:1173 msgid "Clear the regular expression cache." msgstr "" -#: library/re.rst:1145 +#: library/re.rst:1177 msgid "Exceptions" msgstr "" -#: library/re.rst:1149 +#: library/re.rst:1181 msgid "" "Exception raised when a string passed to one of the functions here is not a " "valid regular expression (for example, it might contain unmatched " @@ -1429,45 +1430,45 @@ msgid "" "pattern. The error instance has the following additional attributes:" msgstr "" -#: library/re.rst:1157 +#: library/re.rst:1189 msgid "The unformatted error message." msgstr "" -#: library/re.rst:1161 +#: library/re.rst:1193 msgid "The regular expression pattern." msgstr "" -#: library/re.rst:1165 +#: library/re.rst:1197 msgid "The index in *pattern* where compilation failed (may be ``None``)." msgstr "" -#: library/re.rst:1169 +#: library/re.rst:1201 msgid "The line corresponding to *pos* (may be ``None``)." msgstr "" -#: library/re.rst:1173 +#: library/re.rst:1205 msgid "The column corresponding to *pos* (may be ``None``)." msgstr "" -#: library/re.rst:1175 +#: library/re.rst:1207 msgid "Added additional attributes." msgstr "" -#: library/re.rst:1181 +#: library/re.rst:1213 msgid "Regular Expression Objects" msgstr "" -#: library/re.rst:1185 +#: library/re.rst:1217 msgid "Compiled regular expression object returned by :func:`re.compile`." msgstr "" -#: library/re.rst:1187 +#: library/re.rst:1219 msgid "" ":py:class:`re.Pattern` supports ``[]`` to indicate a Unicode (str) or bytes " "pattern. See :ref:`types-genericalias`." msgstr "" -#: library/re.rst:1193 +#: library/re.rst:1225 msgid "" "Scan through *string* looking for the first location where this regular " "expression produces a match, and return a corresponding :class:`~re.Match`. " @@ -1476,7 +1477,7 @@ msgid "" "string." msgstr "" -#: library/re.rst:1198 +#: library/re.rst:1230 msgid "" "The optional second parameter *pos* gives an index in the string where the " "search is to start; it defaults to ``0``. This is not completely equivalent " @@ -1485,7 +1486,7 @@ msgid "" "necessarily at the index where the search is to start." msgstr "" -#: library/re.rst:1204 +#: library/re.rst:1236 msgid "" "The optional parameter *endpos* limits how far the string will be searched; " "it will be as if the string is *endpos* characters long, so only the " @@ -1495,7 +1496,7 @@ msgid "" "equivalent to ``rx.search(string[:50], 0)``. ::" msgstr "" -#: library/re.rst:1219 +#: library/re.rst:1251 msgid "" "If zero or more characters at the *beginning* of *string* match this regular " "expression, return a corresponding :class:`~re.Match`. Return ``None`` if " @@ -1503,101 +1504,101 @@ msgid "" "zero-length match." msgstr "" -#: library/re.rst:1242 +#: library/re.rst:1274 msgid "" "The optional *pos* and *endpos* parameters have the same meaning as for the :" "meth:`~Pattern.search` method. ::" msgstr "" -#: library/re.rst:1232 +#: library/re.rst:1264 msgid "" "If you want to locate a match anywhere in *string*, use :meth:`~Pattern." "search` instead (see also :ref:`search-vs-match`)." msgstr "" -#: library/re.rst:1238 +#: library/re.rst:1270 msgid "" "If the whole *string* matches this regular expression, return a " "corresponding :class:`~re.Match`. Return ``None`` if the string does not " "match the pattern; note that this is different from a zero-length match." msgstr "" -#: library/re.rst:1256 +#: library/re.rst:1288 msgid "Identical to the :func:`split` function, using the compiled pattern." msgstr "" -#: library/re.rst:1261 +#: library/re.rst:1293 msgid "" "Similar to the :func:`findall` function, using the compiled pattern, but " "also accepts optional *pos* and *endpos* parameters that limit the search " "region like for :meth:`search`." msgstr "" -#: library/re.rst:1268 +#: library/re.rst:1300 msgid "" "Similar to the :func:`finditer` function, using the compiled pattern, but " "also accepts optional *pos* and *endpos* parameters that limit the search " "region like for :meth:`search`." msgstr "" -#: library/re.rst:1275 +#: library/re.rst:1307 msgid "Identical to the :func:`sub` function, using the compiled pattern." msgstr "" -#: library/re.rst:1280 +#: library/re.rst:1312 msgid "Identical to the :func:`subn` function, using the compiled pattern." msgstr "" -#: library/re.rst:1285 +#: library/re.rst:1317 msgid "" "The regex matching flags. This is a combination of the flags given to :func:" "`.compile`, any ``(?...)`` inline flags in the pattern, and implicit flags " "such as :py:const:`~re.UNICODE` if the pattern is a Unicode string." msgstr "" -#: library/re.rst:1292 +#: library/re.rst:1324 msgid "The number of capturing groups in the pattern." msgstr "" -#: library/re.rst:1297 +#: library/re.rst:1329 msgid "" "A dictionary mapping any symbolic group names defined by ``(?P)`` to " "group numbers. The dictionary is empty if no symbolic groups were used in " "the pattern." msgstr "" -#: library/re.rst:1304 +#: library/re.rst:1336 msgid "The pattern string from which the pattern object was compiled." msgstr "" -#: library/re.rst:1307 +#: library/re.rst:1339 msgid "" "Added support of :func:`copy.copy` and :func:`copy.deepcopy`. Compiled " "regular expression objects are considered atomic." msgstr "" -#: library/re.rst:1315 +#: library/re.rst:1347 msgid "Match Objects" msgstr "" -#: library/re.rst:1317 +#: library/re.rst:1349 msgid "" "Match objects always have a boolean value of ``True``. Since :meth:`~Pattern." "match` and :meth:`~Pattern.search` return ``None`` when there is no match, " "you can test whether there was a match with a simple ``if`` statement::" msgstr "" -#: library/re.rst:1328 +#: library/re.rst:1360 msgid "Match object returned by successful ``match``\\ es and ``search``\\ es." msgstr "" -#: library/re.rst:1330 +#: library/re.rst:1362 msgid "" ":py:class:`re.Match` supports ``[]`` to indicate a Unicode (str) or bytes " "match. See :ref:`types-genericalias`." msgstr "" -#: library/re.rst:1336 +#: library/re.rst:1368 msgid "" "Return the string obtained by doing backslash substitution on the template " "string *template*, as done by the :meth:`~Pattern.sub` method. Escapes such " @@ -1607,7 +1608,7 @@ msgid "" "backreference ``\\g<0>`` will be replaced by the entire match." msgstr "" -#: library/re.rst:1349 +#: library/re.rst:1381 msgid "" "Returns one or more subgroups of the match. If there is a single argument, " "the result is a single string; if there are multiple arguments, the result " @@ -1622,7 +1623,7 @@ msgid "" "the pattern that matched multiple times, the last match is returned. ::" msgstr "" -#: library/re.rst:1371 +#: library/re.rst:1403 msgid "" "If the regular expression uses the ``(?P...)`` syntax, the *groupN* " "arguments may also be strings identifying groups by their group name. If a " @@ -1630,54 +1631,54 @@ msgid "" "`IndexError` exception is raised." msgstr "" -#: library/re.rst:1376 +#: library/re.rst:1408 msgid "A moderately complicated example::" msgstr "" -#: library/re.rst:1384 +#: library/re.rst:1416 msgid "Named groups can also be referred to by their index::" msgstr "" -#: library/re.rst:1391 +#: library/re.rst:1423 msgid "If a group matches multiple times, only the last match is accessible::" msgstr "" -#: library/re.rst:1400 +#: library/re.rst:1432 msgid "" "This is identical to ``m.group(g)``. This allows easier access to an " "individual group from a match::" msgstr "" -#: library/re.rst:1411 +#: library/re.rst:1443 msgid "Named groups are supported as well::" msgstr "" -#: library/re.rst:1424 +#: library/re.rst:1456 msgid "" "Return a tuple containing all the subgroups of the match, from 1 up to " "however many groups are in the pattern. The *default* argument is used for " "groups that did not participate in the match; it defaults to ``None``." msgstr "" -#: library/re.rst:1653 +#: library/re.rst:1685 msgid "For example::" msgstr "" -#: library/re.rst:1434 +#: library/re.rst:1466 msgid "" "If we make the decimal place and everything after it optional, not all " "groups might participate in the match. These groups will default to " "``None`` unless the *default* argument is given::" msgstr "" -#: library/re.rst:1447 +#: library/re.rst:1479 msgid "" "Return a dictionary containing all the *named* subgroups of the match, keyed " "by the subgroup name. The *default* argument is used for groups that did " "not participate in the match; it defaults to ``None``. For example::" msgstr "" -#: library/re.rst:1459 +#: library/re.rst:1491 msgid "" "Return the indices of the start and end of the substring matched by *group*; " "*group* defaults to zero (meaning the whole matched substring). Return " @@ -1686,7 +1687,7 @@ msgid "" "matched by group *g* (equivalent to ``m.group(g)``) is ::" msgstr "" -#: library/re.rst:1467 +#: library/re.rst:1499 msgid "" "Note that ``m.start(group)`` will equal ``m.end(group)`` if *group* matched " "a null string. For example, after ``m = re.search('b(c?)', 'cba')``, ``m." @@ -1694,32 +1695,32 @@ msgid "" "2, and ``m.start(2)`` raises an :exc:`IndexError` exception." msgstr "" -#: library/re.rst:1472 +#: library/re.rst:1504 msgid "An example that will remove *remove_this* from email addresses::" msgstr "" -#: library/re.rst:1482 +#: library/re.rst:1514 msgid "" "For a match *m*, return the 2-tuple ``(m.start(group), m.end(group))``. Note " "that if *group* did not contribute to the match, this is ``(-1, -1)``. " "*group* defaults to zero, the entire match." msgstr "" -#: library/re.rst:1489 +#: library/re.rst:1521 msgid "" "The value of *pos* which was passed to the :meth:`~Pattern.search` or :meth:" "`~Pattern.match` method of a :ref:`regex object `. This is the " "index into the string at which the RE engine started looking for a match." msgstr "" -#: library/re.rst:1496 +#: library/re.rst:1528 msgid "" "The value of *endpos* which was passed to the :meth:`~Pattern.search` or :" "meth:`~Pattern.match` method of a :ref:`regex object `. This is " "the index into the string beyond which the RE engine will not go." msgstr "" -#: library/re.rst:1503 +#: library/re.rst:1535 msgid "" "The integer index of the last matched capturing group, or ``None`` if no " "group was matched at all. For example, the expressions ``(a)b``, ``((a)" @@ -1728,43 +1729,43 @@ msgid "" "applied to the same string." msgstr "" -#: library/re.rst:1512 +#: library/re.rst:1544 msgid "" "The name of the last matched capturing group, or ``None`` if the group " "didn't have a name, or if no group was matched at all." msgstr "" -#: library/re.rst:1518 +#: library/re.rst:1550 msgid "" "The :ref:`regular expression object ` whose :meth:`~Pattern." "match` or :meth:`~Pattern.search` method produced this match instance." msgstr "" -#: library/re.rst:1524 +#: library/re.rst:1556 msgid "The string passed to :meth:`~Pattern.match` or :meth:`~Pattern.search`." msgstr "" -#: library/re.rst:1527 +#: library/re.rst:1559 msgid "" "Added support of :func:`copy.copy` and :func:`copy.deepcopy`. Match objects " "are considered atomic." msgstr "" -#: library/re.rst:1535 +#: library/re.rst:1567 msgid "Regular Expression Examples" msgstr "" -#: library/re.rst:1539 +#: library/re.rst:1571 msgid "Checking for a Pair" msgstr "" -#: library/re.rst:1541 +#: library/re.rst:1573 msgid "" "In this example, we'll use the following helper function to display match " "objects a little more gracefully::" msgstr "" -#: library/re.rst:1549 +#: library/re.rst:1581 msgid "" "Suppose you are writing a poker program where a player's hand is represented " "as a 5-character string with each character representing a card, \"a\" for " @@ -1772,28 +1773,28 @@ msgid "" "\"2\" through \"9\" representing the card with that value." msgstr "" -#: library/re.rst:1554 +#: library/re.rst:1586 msgid "To see if a given string is a valid hand, one could do the following::" msgstr "" -#: library/re.rst:1564 +#: library/re.rst:1596 msgid "" "That last hand, ``\"727ak\"``, contained a pair, or two of the same valued " "cards. To match this with a regular expression, one could use backreferences " "as such::" msgstr "" -#: library/re.rst:1574 +#: library/re.rst:1606 msgid "" "To find out what card the pair consists of, one could use the :meth:`~Match." "group` method of the match object in the following manner::" msgstr "" -#: library/re.rst:1593 +#: library/re.rst:1625 msgid "Simulating scanf()" msgstr "" -#: library/re.rst:1597 +#: library/re.rst:1629 msgid "" "Python does not currently have an equivalent to :c:func:`!scanf`. Regular " "expressions are generally more powerful, though also more verbose, than :c:" @@ -1802,124 +1803,124 @@ msgid "" "expressions." msgstr "" -#: library/re.rst:1604 +#: library/re.rst:1636 msgid ":c:func:`!scanf` Token" msgstr "" -#: library/re.rst:1604 +#: library/re.rst:1636 msgid "Regular Expression" msgstr "" -#: library/re.rst:1606 +#: library/re.rst:1638 msgid "``%c``" msgstr "" -#: library/re.rst:1608 +#: library/re.rst:1640 msgid "``%5c``" msgstr "" -#: library/re.rst:1608 +#: library/re.rst:1640 msgid "``.{5}``" msgstr "" -#: library/re.rst:1610 +#: library/re.rst:1642 msgid "``%d``" msgstr "" -#: library/re.rst:1610 +#: library/re.rst:1642 msgid "``[-+]?\\d+``" msgstr "" -#: library/re.rst:1612 +#: library/re.rst:1644 msgid "``%e``, ``%E``, ``%f``, ``%g``" msgstr "" -#: library/re.rst:1612 +#: library/re.rst:1644 msgid "``[-+]?(\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?``" msgstr "" -#: library/re.rst:1614 +#: library/re.rst:1646 msgid "``%i``" msgstr "" -#: library/re.rst:1614 +#: library/re.rst:1646 msgid "``[-+]?(0[xX][\\dA-Fa-f]+|0[0-7]*|\\d+)``" msgstr "" -#: library/re.rst:1616 +#: library/re.rst:1648 msgid "``%o``" msgstr "" -#: library/re.rst:1616 +#: library/re.rst:1648 msgid "``[-+]?[0-7]+``" msgstr "" -#: library/re.rst:1618 +#: library/re.rst:1650 msgid "``%s``" msgstr "" -#: library/re.rst:1618 +#: library/re.rst:1650 msgid "``\\S+``" msgstr "" -#: library/re.rst:1620 +#: library/re.rst:1652 msgid "``%u``" msgstr "" -#: library/re.rst:1620 +#: library/re.rst:1652 msgid "``\\d+``" msgstr "" -#: library/re.rst:1622 +#: library/re.rst:1654 msgid "``%x``, ``%X``" msgstr "" -#: library/re.rst:1622 +#: library/re.rst:1654 msgid "``[-+]?(0[xX])?[\\dA-Fa-f]+``" msgstr "" -#: library/re.rst:1625 +#: library/re.rst:1657 msgid "To extract the filename and numbers from a string like ::" msgstr "" -#: library/re.rst:1629 +#: library/re.rst:1661 msgid "you would use a :c:func:`!scanf` format like ::" msgstr "" -#: library/re.rst:1633 +#: library/re.rst:1665 msgid "The equivalent regular expression would be ::" msgstr "" -#: library/re.rst:1641 +#: library/re.rst:1673 msgid "search() vs. match()" msgstr "" -#: library/re.rst:1645 +#: library/re.rst:1677 msgid "" "Python offers different primitive operations based on regular expressions:" msgstr "" -#: library/re.rst:1647 +#: library/re.rst:1679 msgid ":func:`re.match` checks for a match only at the beginning of the string" msgstr "" -#: library/re.rst:1648 +#: library/re.rst:1680 msgid "" ":func:`re.search` checks for a match anywhere in the string (this is what " "Perl does by default)" msgstr "" -#: library/re.rst:1650 +#: library/re.rst:1682 msgid ":func:`re.fullmatch` checks for entire string to be a match" msgstr "" -#: library/re.rst:1662 +#: library/re.rst:1694 msgid "" "Regular expressions beginning with ``'^'`` can be used with :func:`search` " "to restrict the match at the beginning of the string::" msgstr "" -#: library/re.rst:1670 +#: library/re.rst:1702 msgid "" "Note however that in :const:`MULTILINE` mode :func:`match` only matches at " "the beginning of the string, whereas using :func:`search` with a regular " @@ -1927,11 +1928,11 @@ msgid "" "line. ::" msgstr "" -#: library/re.rst:1680 +#: library/re.rst:1712 msgid "Making a Phonebook" msgstr "" -#: library/re.rst:1682 +#: library/re.rst:1714 msgid "" ":func:`split` splits a string into a list delimited by the passed pattern. " "The method is invaluable for converting textual data into data structures " @@ -1939,37 +1940,37 @@ msgid "" "following example that creates a phonebook." msgstr "" -#: library/re.rst:1687 +#: library/re.rst:1719 msgid "" "First, here is the input. Normally it may come from a file, here we are " "using triple-quoted string syntax" msgstr "" -#: library/re.rst:1700 +#: library/re.rst:1732 msgid "" "The entries are separated by one or more newlines. Now we convert the string " "into a list with each nonempty line having its own entry:" msgstr "" -#: library/re.rst:1713 +#: library/re.rst:1745 msgid "" "Finally, split each entry into a list with first name, last name, telephone " "number, and address. We use the ``maxsplit`` parameter of :func:`split` " "because the address has spaces, our splitting pattern, in it:" msgstr "" -#: library/re.rst:1726 +#: library/re.rst:1758 msgid "" "The ``:?`` pattern matches the colon after the last name, so that it does " "not occur in the result list. With a ``maxsplit`` of ``4``, we could " "separate the house number from the street name:" msgstr "" -#: library/re.rst:1741 +#: library/re.rst:1773 msgid "Text Munging" msgstr "" -#: library/re.rst:1743 +#: library/re.rst:1775 msgid "" ":func:`sub` replaces every occurrence of a pattern with a string or the " "result of a function. This example demonstrates using :func:`sub` with a " @@ -1977,11 +1978,11 @@ msgid "" "each word of a sentence except for the first and last characters::" msgstr "" -#: library/re.rst:1761 +#: library/re.rst:1793 msgid "Finding all Adverbs" msgstr "" -#: library/re.rst:1763 +#: library/re.rst:1795 msgid "" ":func:`findall` matches *all* occurrences of a pattern, not just the first " "one as :func:`search` does. For example, if a writer wanted to find all of " @@ -1989,11 +1990,11 @@ msgid "" "manner::" msgstr "" -#: library/re.rst:1774 +#: library/re.rst:1806 msgid "Finding all Adverbs and their Positions" msgstr "" -#: library/re.rst:1776 +#: library/re.rst:1808 msgid "" "If one wants more information about all matches of a pattern than the " "matched text, :func:`finditer` is useful as it provides :class:`~re.Match` " @@ -2002,11 +2003,11 @@ msgid "" "they would use :func:`finditer` in the following manner::" msgstr "" -#: library/re.rst:1790 +#: library/re.rst:1822 msgid "Raw String Notation" msgstr "" -#: library/re.rst:1792 +#: library/re.rst:1824 msgid "" "Raw string notation (``r\"text\"``) keeps regular expressions sane. Without " "it, every backslash (``'\\'``) in a regular expression would have to be " @@ -2014,7 +2015,7 @@ msgid "" "lines of code are functionally identical::" msgstr "" -#: library/re.rst:1802 +#: library/re.rst:1834 msgid "" "When one wants to match a literal backslash, it must be escaped in the " "regular expression. With raw string notation, this means ``r\"\\\\\"``. " @@ -2022,29 +2023,29 @@ msgid "" "following lines of code functionally identical::" msgstr "" -#: library/re.rst:1814 +#: library/re.rst:1846 msgid "Writing a Tokenizer" msgstr "" -#: library/re.rst:1816 +#: library/re.rst:1848 msgid "" "A `tokenizer or scanner `_ " "analyzes a string to categorize groups of characters. This is a useful " "first step in writing a compiler or interpreter." msgstr "" -#: library/re.rst:1820 +#: library/re.rst:1852 msgid "" "The text categories are specified with regular expressions. The technique " "is to combine those into a single master regular expression and to loop over " "successive matches::" msgstr "" -#: library/re.rst:1876 +#: library/re.rst:1908 msgid "The tokenizer produces the following output::" msgstr "" -#: library/re.rst:1899 +#: library/re.rst:1931 msgid "" "Friedl, Jeffrey. Mastering Regular Expressions. 3rd ed., O'Reilly Media, " "2009. The third edition of the book no longer covers Python at all, but the " @@ -2060,7 +2061,7 @@ msgstr "" #: library/re.rst:235 library/re.rst:257 library/re.rst:295 library/re.rst:318 #: library/re.rst:405 library/re.rst:443 library/re.rst:455 library/re.rst:489 #: library/re.rst:522 library/re.rst:539 library/re.rst:575 library/re.rst:599 -#: library/re.rst:622 library/re.rst:653 library/re.rst:849 library/re.rst:1056 +#: library/re.rst:622 library/re.rst:653 library/re.rst:849 library/re.rst:1080 msgid "in regular expressions" msgstr "" @@ -2260,10 +2261,10 @@ msgstr "" msgid "# (hash)" msgstr "" -#: library/re.rst:1056 +#: library/re.rst:1080 msgid "\\g" msgstr "" -#: library/re.rst:1595 +#: library/re.rst:1627 msgid "scanf (C function)" msgstr "" diff --git a/library/readline.po b/library/readline.po index c4125c1fb..73b6d7bf4 100644 --- a/library/readline.po +++ b/library/readline.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -64,76 +64,83 @@ msgid "" "keybindings and TAB completion::" msgstr "" -#: library/readline.rst:49 +#: library/readline.rst:47 +msgid "" +"Also note that different libraries may use different history file formats. " +"When switching the underlying library, existing history files may become " +"unusable." +msgstr "" + +#: library/readline.rst:53 msgid "Init file" msgstr "" -#: library/readline.rst:51 +#: library/readline.rst:55 msgid "The following functions relate to the init file and user configuration:" msgstr "" -#: library/readline.rst:56 +#: library/readline.rst:60 msgid "" "Execute the init line provided in the *string* argument. This calls :c:func:" "`rl_parse_and_bind` in the underlying library." msgstr "" -#: library/readline.rst:62 +#: library/readline.rst:66 msgid "" "Execute a readline initialization file. The default filename is the last " "filename used. This calls :c:func:`rl_read_init_file` in the underlying " "library." msgstr "" -#: library/readline.rst:67 +#: library/readline.rst:71 msgid "Line buffer" msgstr "" -#: library/readline.rst:69 +#: library/readline.rst:73 msgid "The following functions operate on the line buffer:" msgstr "" -#: library/readline.rst:74 +#: library/readline.rst:78 msgid "" "Return the current contents of the line buffer (:c:data:`rl_line_buffer` in " "the underlying library)." msgstr "" -#: library/readline.rst:80 +#: library/readline.rst:84 msgid "" "Insert text into the line buffer at the cursor position. This calls :c:func:" "`rl_insert_text` in the underlying library, but ignores the return value." msgstr "" -#: library/readline.rst:87 +#: library/readline.rst:91 msgid "" "Change what's displayed on the screen to reflect the current contents of the " "line buffer. This calls :c:func:`rl_redisplay` in the underlying library." msgstr "" -#: library/readline.rst:92 +#: library/readline.rst:96 msgid "History file" msgstr "" -#: library/readline.rst:94 +#: library/readline.rst:98 msgid "The following functions operate on a history file:" msgstr "" -#: library/readline.rst:99 +#: library/readline.rst:103 msgid "" "Load a readline history file, and append it to the history list. The default " "filename is :file:`~/.history`. This calls :c:func:`read_history` in the " "underlying library." msgstr "" -#: library/readline.rst:106 +#: library/readline.rst:110 msgid "" "Save the history list to a readline history file, overwriting any existing " "file. The default filename is :file:`~/.history`. This calls :c:func:" "`write_history` in the underlying library." msgstr "" -#: library/readline.rst:113 +#: library/readline.rst:117 msgid "" "Append the last *nelements* items of history to a file. The default " "filename is :file:`~/.history`. The file must already exist. This calls :c:" @@ -141,7 +148,7 @@ msgid "" "if Python was compiled for a version of the library that supports it." msgstr "" -#: library/readline.rst:125 +#: library/readline.rst:129 msgid "" "Set or return the desired number of lines to save in the history file. The :" "func:`write_history_file` function uses this value to truncate the history " @@ -149,72 +156,72 @@ msgid "" "Negative values imply unlimited history file size." msgstr "" -#: library/readline.rst:133 +#: library/readline.rst:137 msgid "History list" msgstr "" -#: library/readline.rst:135 +#: library/readline.rst:139 msgid "The following functions operate on a global history list:" msgstr "" -#: library/readline.rst:140 +#: library/readline.rst:144 msgid "" "Clear the current history. This calls :c:func:`clear_history` in the " "underlying library. The Python function only exists if Python was compiled " "for a version of the library that supports it." msgstr "" -#: library/readline.rst:147 +#: library/readline.rst:151 msgid "" "Return the number of items currently in the history. (This is different " "from :func:`get_history_length`, which returns the maximum number of lines " "that will be written to a history file.)" msgstr "" -#: library/readline.rst:154 +#: library/readline.rst:158 msgid "" "Return the current contents of history item at *index*. The item index is " "one-based. This calls :c:func:`history_get` in the underlying library." msgstr "" -#: library/readline.rst:160 +#: library/readline.rst:164 msgid "" "Remove history item specified by its position from the history. The position " "is zero-based. This calls :c:func:`remove_history` in the underlying " "library." msgstr "" -#: library/readline.rst:167 +#: library/readline.rst:171 msgid "" "Replace history item specified by its position with *line*. The position is " "zero-based. This calls :c:func:`replace_history_entry` in the underlying " "library." msgstr "" -#: library/readline.rst:174 +#: library/readline.rst:178 msgid "" "Append *line* to the history buffer, as if it was the last line typed. This " "calls :c:func:`add_history` in the underlying library." msgstr "" -#: library/readline.rst:180 +#: library/readline.rst:184 msgid "" "Enable or disable automatic calls to :c:func:`add_history` when reading " "input via readline. The *enabled* argument should be a Boolean value that " "when true, enables auto history, and that when false, disables auto history." msgstr "" -#: library/readline.rst:188 +#: library/readline.rst:192 msgid "" "Auto history is enabled by default, and changes to this do not persist " "across multiple sessions." msgstr "" -#: library/readline.rst:193 +#: library/readline.rst:197 msgid "Startup hooks" msgstr "" -#: library/readline.rst:198 +#: library/readline.rst:202 msgid "" "Set or remove the function invoked by the :c:data:`rl_startup_hook` callback " "of the underlying library. If *function* is specified, it will be used as " @@ -223,7 +230,7 @@ msgid "" "readline prints the first prompt." msgstr "" -#: library/readline.rst:207 +#: library/readline.rst:211 msgid "" "Set or remove the function invoked by the :c:data:`rl_pre_input_hook` " "callback of the underlying library. If *function* is specified, it will be " @@ -234,11 +241,11 @@ msgid "" "of the library that supports it." msgstr "" -#: library/readline.rst:219 +#: library/readline.rst:223 msgid "Completion" msgstr "" -#: library/readline.rst:221 +#: library/readline.rst:225 msgid "" "The following functions relate to implementing a custom word completion " "function. This is typically operated by the Tab key, and can suggest and " @@ -248,7 +255,7 @@ msgid "" "custom completer, a different set of word delimiters should be set." msgstr "" -#: library/readline.rst:231 +#: library/readline.rst:235 msgid "" "Set or remove the completer function. If *function* is specified, it will " "be used as the new completer function; if omitted or ``None``, any completer " @@ -258,7 +265,7 @@ msgid "" "starting with *text*." msgstr "" -#: library/readline.rst:238 +#: library/readline.rst:242 msgid "" "The installed completer function is invoked by the *entry_func* callback " "passed to :c:func:`rl_completion_matches` in the underlying library. The " @@ -266,19 +273,19 @@ msgid "" "`rl_attempted_completion_function` callback of the underlying library." msgstr "" -#: library/readline.rst:247 +#: library/readline.rst:251 msgid "" "Get the completer function, or ``None`` if no completer function has been " "set." msgstr "" -#: library/readline.rst:252 +#: library/readline.rst:256 msgid "" "Get the type of completion being attempted. This returns the :c:data:" "`rl_completion_type` variable in the underlying library as an integer." msgstr "" -#: library/readline.rst:260 +#: library/readline.rst:264 msgid "" "Get the beginning or ending index of the completion scope. These indexes are " "the *start* and *end* arguments passed to the :c:data:" @@ -288,7 +295,7 @@ msgid "" "differently than libreadline." msgstr "" -#: library/readline.rst:271 +#: library/readline.rst:275 msgid "" "Set or get the word delimiters for completion. These determine the start of " "the word to be considered for completion (the completion scope). These " @@ -296,7 +303,7 @@ msgid "" "in the underlying library." msgstr "" -#: library/readline.rst:279 +#: library/readline.rst:283 msgid "" "Set or remove the completion display function. If *function* is specified, " "it will be used as the new completion display function; if omitted or " @@ -307,11 +314,11 @@ msgid "" "each time matches need to be displayed." msgstr "" -#: library/readline.rst:292 +#: library/readline.rst:296 msgid "Example" msgstr "" -#: library/readline.rst:294 +#: library/readline.rst:298 msgid "" "The following example demonstrates how to use the :mod:`readline` module's " "history reading and writing functions to automatically load and save a " @@ -320,19 +327,19 @@ msgid "" "sessions from the user's :envvar:`PYTHONSTARTUP` file. ::" msgstr "" -#: library/readline.rst:314 +#: library/readline.rst:318 msgid "" "This code is actually automatically run when Python is run in :ref:" "`interactive mode ` (see :ref:`rlcompleter-config`)." msgstr "" -#: library/readline.rst:317 +#: library/readline.rst:321 msgid "" "The following example achieves the same goal but supports concurrent " "interactive sessions, by only appending the new history. ::" msgstr "" -#: library/readline.rst:338 +#: library/readline.rst:342 msgid "" "The following example extends the :class:`code.InteractiveConsole` class to " "support history save/restore. ::" diff --git a/library/resource.po b/library/resource.po index 388438fd3..eee54a3bd 100644 --- a/library/resource.po +++ b/library/resource.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -114,8 +114,7 @@ msgstr "" #: library/resource.rst:83 msgid "" -"Raises an :ref:`auditing event ` ``resource.setrlimit`` with " -"arguments ``resource``, ``limits``." +"Raises an auditing event resource.setrlimit with arguments resource, limits." msgstr "" #: library/resource.rst:88 @@ -143,8 +142,8 @@ msgstr "" #: library/resource.rst:102 msgid "" -"Raises an :ref:`auditing event ` ``resource.prlimit`` with " -"arguments ``pid``, ``resource``, ``limits``." +"Raises an auditing event resource.prlimit with arguments pid, resource, " +"limits." msgstr "" #: library/resource.rst:104 @@ -331,7 +330,7 @@ msgstr "" #: library/resource.rst:307 msgid "" "The fields :attr:`ru_utime` and :attr:`ru_stime` of the return value are " -"floating point values representing the amount of time spent executing in " +"floating-point values representing the amount of time spent executing in " "user mode and the amount of time spent executing in system mode, " "respectively. The remaining values are integers. Consult the :manpage:" "`getrusage(2)` man page for detailed information about these values. A brief " diff --git a/library/select.po b/library/select.po index e322589b3..720bf7bcd 100644 --- a/library/select.po +++ b/library/select.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -181,7 +181,7 @@ msgstr "" msgid "" "Empty iterables are allowed, but acceptance of three empty iterables is " "platform-dependent. (It is known to work on Unix but not on Windows.) The " -"optional *timeout* argument specifies a time-out as a floating point number " +"optional *timeout* argument specifies a time-out as a floating-point number " "in seconds. When the *timeout* argument is omitted the function blocks " "until at least one file descriptor is ready. A time-out value of zero " "specifies a poll and never blocks." diff --git a/library/shutil.po b/library/shutil.po index f6676c06b..e9d305283 100644 --- a/library/shutil.po +++ b/library/shutil.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -92,9 +92,7 @@ msgid "" msgstr "" #: library/shutil.rst:177 library/shutil.rst:208 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.copyfile`` with " -"arguments ``src``, ``dst``." +msgid "Raises an auditing event shutil.copyfile with arguments src, dst." msgstr "" #: library/shutil.rst:72 @@ -136,9 +134,7 @@ msgid "" msgstr "" #: library/shutil.rst:179 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.copymode`` with " -"arguments ``src``, ``dst``." +msgid "Raises an auditing event shutil.copymode with arguments src, dst." msgstr "" #: library/shutil.rst:108 @@ -199,9 +195,7 @@ msgid "Please see :data:`os.supports_follow_symlinks` for more information." msgstr "" #: library/shutil.rst:210 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.copystat`` with " -"arguments ``src``, ``dst``." +msgid "Raises an auditing event shutil.copystat with arguments src, dst." msgstr "" #: library/shutil.rst:155 @@ -342,9 +336,7 @@ msgid "" msgstr "" #: library/shutil.rst:275 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.copytree`` with " -"arguments ``src``, ``dst``." +msgid "Raises an auditing event shutil.copytree with arguments src, dst." msgstr "" #: library/shutil.rst:277 @@ -410,9 +402,7 @@ msgid "" msgstr "" #: library/shutil.rst:330 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.rmtree`` with arguments " -"``path``, ``dir_fd``." +msgid "Raises an auditing event shutil.rmtree with arguments path, dir_fd." msgstr "" #: library/shutil.rst:332 @@ -481,9 +471,7 @@ msgid "" msgstr "" #: library/shutil.rst:380 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.move`` with arguments " -"``src``, ``dst``." +msgid "Raises an auditing event shutil.move with arguments src, dst." msgstr "" #: library/shutil.rst:382 @@ -537,9 +525,7 @@ msgid "See also :func:`os.chown`, the underlying function." msgstr "" #: library/shutil.rst:427 -msgid "" -"Raises an :ref:`auditing event ` ``shutil.chown`` with arguments " -"``path``, ``user``, ``group``." +msgid "Raises an auditing event shutil.chown with arguments path, user, group." msgstr "" #: library/shutil.rst:429 @@ -761,8 +747,8 @@ msgstr "" #: library/shutil.rst:616 msgid "" -"Raises an :ref:`auditing event ` ``shutil.make_archive`` with " -"arguments ``base_name``, ``format``, ``root_dir``, ``base_dir``." +"Raises an auditing event shutil.make_archive with arguments base_name, " +"format, root_dir, base_dir." msgstr "" #: library/shutil.rst:620 @@ -895,8 +881,8 @@ msgstr "" #: library/shutil.rst:704 msgid "" -"Raises an :ref:`auditing event ` ``shutil.unpack_archive`` with " -"arguments ``filename``, ``extract_dir``, ``format``." +"Raises an auditing event shutil.unpack_archive with arguments filename, " +"extract_dir, format." msgstr "" #: library/shutil.rst:708 diff --git a/library/signal.po b/library/signal.po index e9998f913..79181f200 100644 --- a/library/signal.po +++ b/library/signal.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -487,8 +487,8 @@ msgstr "" #: library/signal.rst:435 msgid "" -"Raises an :ref:`auditing event ` ``signal.pthread_kill`` with " -"arguments ``thread_id``, ``signalnum``." +"Raises an auditing event signal.pthread_kill with arguments thread_id, " +"signalnum." msgstr "" #: library/signal.rst:439 diff --git a/library/smtplib.po b/library/smtplib.po index 016b677b2..da5da9607 100644 --- a/library/smtplib.po +++ b/library/smtplib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -76,10 +76,10 @@ msgid "" "keyword:`!with` statement exits. E.g.::" msgstr "" -#: library/smtplib.rst:70 +#: library/smtplib.rst:59 msgid "" -"Raises an :ref:`auditing event ` ``smtplib.send`` with arguments " -"``self``, ``data``." +"All commands will raise an auditing event smtplib.SMTP.send with arguments " +"self and data, where data is the bytes about to be sent to the remote host." msgstr "" #: library/smtplib.rst:61 @@ -308,10 +308,9 @@ msgid "" "connection response." msgstr "" -#: library/smtplib.rst:264 +#: library/smtplib.rst:253 msgid "" -"Raises an :ref:`auditing event ` ``smtplib.connect`` with " -"arguments ``self``, ``host``, ``port``." +"Raises an auditing event smtplib.connect with arguments self, host, port." msgstr "" #: library/smtplib.rst:258 @@ -718,10 +717,10 @@ msgid "" "headers to be included with the message must be included in the message as " "entered; this example doesn't do any processing of the :rfc:`822` headers. " "In particular, the 'To' and 'From' addresses must be included in the message " -"headers explicitly. ::" +"headers explicitly::" msgstr "" -#: library/smtplib.rst:591 +#: library/smtplib.rst:590 msgid "" "In general, you will want to use the :mod:`email` package's features to " "construct an email message, which you can then send via :meth:`~smtplib.SMTP." diff --git a/library/sndhdr.po b/library/sndhdr.po index e0eb8440a..ffa8e77d3 100644 --- a/library/sndhdr.po +++ b/library/sndhdr.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/sndhdr.py`" msgstr "" -#: library/sndhdr.rst:20 +#: library/sndhdr.rst:17 msgid "" "The :mod:`sndhdr` module is deprecated (see :pep:`PEP 594 <594#sndhdr>` for " "details and alternatives)." diff --git a/library/socket.po b/library/socket.po index c523e2c90..07ba1847d 100644 --- a/library/socket.po +++ b/library/socket.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -882,10 +882,10 @@ msgstr "" msgid "The newly created socket is :ref:`non-inheritable `." msgstr "" -#: library/socket.rst:742 +#: library/socket.rst:731 msgid "" -"Raises an :ref:`auditing event ` ``socket.__new__`` with arguments " -"``self``, ``family``, ``type``, ``protocol``." +"Raises an auditing event socket.__new__ with arguments self, family, type, " +"protocol." msgstr "" #: library/socket.rst:733 @@ -1114,10 +1114,10 @@ msgid "" "`AF_INET6`), and is meant to be passed to the :meth:`socket.connect` method." msgstr "" -#: library/socket.rst:953 +#: library/socket.rst:942 msgid "" -"Raises an :ref:`auditing event ` ``socket.getaddrinfo`` with " -"arguments ``host``, ``port``, ``family``, ``type``, ``protocol``." +"Raises an auditing event socket.getaddrinfo with arguments host, port, " +"family, type, protocol." msgstr "" #: library/socket.rst:944 @@ -1158,10 +1158,8 @@ msgid "" "stack support." msgstr "" -#: library/socket.rst:1007 -msgid "" -"Raises an :ref:`auditing event ` ``socket.gethostbyname`` with " -"argument ``hostname``." +#: library/socket.rst:996 +msgid "Raises an auditing event socket.gethostbyname with argument hostname." msgstr "" #: library/socket.rst:998 library/socket.rst:1026 library/socket.rst:1054 @@ -1188,10 +1186,8 @@ msgid "" "interpreter is currently executing." msgstr "" -#: library/socket.rst:1017 -msgid "" -"Raises an :ref:`auditing event ` ``socket.gethostname`` with no " -"arguments." +#: library/socket.rst:1006 +msgid "Raises an auditing event socket.gethostname with no arguments." msgstr "" #: library/socket.rst:1008 @@ -1211,10 +1207,8 @@ msgid "" "`gethostbyaddr` supports both IPv4 and IPv6." msgstr "" -#: library/socket.rst:1035 -msgid "" -"Raises an :ref:`auditing event ` ``socket.gethostbyaddr`` with " -"argument ``ip_address``." +#: library/socket.rst:1024 +msgid "Raises an auditing event socket.gethostbyaddr with argument ip_address." msgstr "" #: library/socket.rst:1031 @@ -1236,10 +1230,8 @@ msgid "" "For more information about *flags* you can consult :manpage:`getnameinfo(3)`." msgstr "" -#: library/socket.rst:1052 -msgid "" -"Raises an :ref:`auditing event ` ``socket.getnameinfo`` with " -"argument ``sockaddr``." +#: library/socket.rst:1041 +msgid "Raises an auditing event socket.getnameinfo with argument sockaddr." msgstr "" #: library/socket.rst:1048 @@ -1258,10 +1250,10 @@ msgid "" "``'udp'``, otherwise any protocol will match." msgstr "" -#: library/socket.rst:1074 +#: library/socket.rst:1063 msgid "" -"Raises an :ref:`auditing event ` ``socket.getservbyname`` with " -"arguments ``servicename``, ``protocolname``." +"Raises an auditing event socket.getservbyname with arguments servicename, " +"protocolname." msgstr "" #: library/socket.rst:1070 @@ -1271,10 +1263,10 @@ msgid "" "``'udp'``, otherwise any protocol will match." msgstr "" -#: library/socket.rst:1085 +#: library/socket.rst:1074 msgid "" -"Raises an :ref:`auditing event ` ``socket.getservbyport`` with " -"arguments ``port``, ``protocolname``." +"Raises an auditing event socket.getservbyport with arguments port, " +"protocolname." msgstr "" #: library/socket.rst:1081 @@ -1459,10 +1451,8 @@ msgid "" "you don't have enough rights." msgstr "" -#: library/socket.rst:1272 -msgid "" -"Raises an :ref:`auditing event ` ``socket.sethostname`` with " -"argument ``name``." +#: library/socket.rst:1261 +msgid "Raises an auditing event socket.sethostname with argument name." msgstr "" #: library/socket.rst:1703 library/socket.rst:1747 @@ -1595,10 +1585,8 @@ msgid "" "format of *address* depends on the address family --- see above.)" msgstr "" -#: library/socket.rst:1409 -msgid "" -"Raises an :ref:`auditing event ` ``socket.bind`` with arguments " -"``self``, ``address``." +#: library/socket.rst:1398 +msgid "Raises an auditing event socket.bind with arguments self, address." msgstr "" #: library/socket.rst:1405 @@ -1647,10 +1635,8 @@ msgid "" "(or the exception raised by the signal handler)." msgstr "" -#: library/socket.rst:1470 -msgid "" -"Raises an :ref:`auditing event ` ``socket.connect`` with arguments " -"``self``, ``address``." +#: library/socket.rst:1459 +msgid "Raises an auditing event socket.connect with arguments self, address." msgstr "" #: library/socket.rst:1441 @@ -1984,10 +1970,8 @@ msgid "" "address family --- see above.)" msgstr "" -#: library/socket.rst:1827 -msgid "" -"Raises an :ref:`auditing event ` ``socket.sendto`` with arguments " -"``self``, ``address``." +#: library/socket.rst:1816 +msgid "Raises an auditing event socket.sendto with arguments self, address." msgstr "" #: library/socket.rst:1826 @@ -2021,10 +2005,8 @@ msgstr "" msgid ":ref:`Availability `: Unix, not WASI." msgstr "" -#: library/socket.rst:1870 -msgid "" -"Raises an :ref:`auditing event ` ``socket.sendmsg`` with arguments " -"``self``, ``address``." +#: library/socket.rst:1859 +msgid "Raises an auditing event socket.sendmsg with arguments self, address." msgstr "" #: library/socket.rst:1870 @@ -2082,7 +2064,7 @@ msgstr "" #: library/socket.rst:1919 msgid "" "Set a timeout on blocking socket operations. The *value* argument can be a " -"nonnegative floating point number expressing seconds, or ``None``. If a non-" +"nonnegative floating-point number expressing seconds, or ``None``. If a non-" "zero value is given, subsequent socket operations will raise a :exc:" "`timeout` exception if the timeout period *value* has elapsed before the " "operation has completed. If zero is given, the socket is put in non-" diff --git a/library/spwd.po b/library/spwd.po index b7163eb04..b381761d7 100644 --- a/library/spwd.po +++ b/library/spwd.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -20,7 +20,7 @@ msgstr "" msgid ":mod:`spwd` --- The shadow password database" msgstr "" -#: library/spwd.rst:12 +#: library/spwd.rst:9 msgid "" "The :mod:`spwd` module is deprecated (see :pep:`PEP 594 <594#spwd>` for " "details and alternatives)." diff --git a/library/sqlite3.po b/library/sqlite3.po index e35f303ba..a310b366c 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -345,15 +345,13 @@ msgid "Return type" msgstr "" #: library/sqlite3.rst:346 -msgid "" -"Raises an :ref:`auditing event ` ``sqlite3.connect`` with argument " -"``database``." +msgid "Raises an auditing event sqlite3.connect with argument database." msgstr "" #: library/sqlite3.rst:347 msgid "" -"Raises an :ref:`auditing event ` ``sqlite3.connect/handle`` with " -"argument ``connection_handle``." +"Raises an auditing event sqlite3.connect/handle with argument " +"connection_handle." msgstr "" #: library/sqlite3.rst:349 @@ -625,7 +623,7 @@ msgid "" "version of the SQLite library." msgstr "" -#: library/sqlite3.rst:560 +#: library/sqlite3.rst:557 msgid "" "This constant used to reflect the version number of the ``pysqlite`` " "package, a third-party library which used to upstream changes to :mod:`!" @@ -1058,8 +1056,8 @@ msgstr "" #: library/sqlite3.rst:1020 msgid "" -"Raises an :ref:`auditing event ` ``sqlite3.enable_load_extension`` " -"with arguments ``connection``, ``enabled``." +"Raises an auditing event sqlite3.enable_load_extension with arguments " +"connection, enabled." msgstr "" #: library/sqlite3.rst:1024 @@ -1085,8 +1083,8 @@ msgstr "" #: library/sqlite3.rst:1073 msgid "" -"Raises an :ref:`auditing event ` ``sqlite3.load_extension`` with " -"arguments ``connection``, ``path``." +"Raises an auditing event sqlite3.load_extension with arguments connection, " +"path." msgstr "" #: library/sqlite3.rst:1077 diff --git a/library/ssl.po b/library/ssl.po index dd7247f19..8f5e2cea0 100644 --- a/library/ssl.po +++ b/library/ssl.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -477,7 +477,7 @@ msgid "" "exactly ``True`` if the certificate is trustworthy for all purposes." msgstr "" -#: library/ssl.rst:1542 library/ssl.rst:1840 +#: library/ssl.rst:1555 library/ssl.rst:1853 msgid "Example::" msgstr "" @@ -522,7 +522,7 @@ msgid "" "does not send any for client cert authentication." msgstr "" -#: library/ssl.rst:2248 +#: library/ssl.rst:2261 msgid "See the discussion of :ref:`ssl-security` below." msgstr "" @@ -1364,7 +1364,7 @@ msgid "" "this will return ``None``." msgstr "" -#: library/ssl.rst:1630 +#: library/ssl.rst:1643 msgid "NPN has been superseded by ALPN" msgstr "" @@ -1598,22 +1598,37 @@ msgid "" "use TLS 1.2 as minimum TLS version." msgstr "" -#: library/ssl.rst:1432 +#: library/ssl.rst:1433 +msgid "" +":class:`SSLContext` only supports limited mutation once it has been used by " +"a connection. Adding new certificates to the internal trust store is " +"allowed, but changing ciphers, verification settings, or mTLS certificates " +"may result in surprising behavior." +msgstr "" + +#: library/ssl.rst:1440 +msgid "" +":class:`SSLContext` is designed to be shared and used by multiple " +"connections. Thus, it is thread-safe as long as it is not reconfigured after " +"being used by a connection." +msgstr "" + +#: library/ssl.rst:1445 msgid ":class:`SSLContext` objects have the following methods and attributes:" msgstr "" -#: library/ssl.rst:1436 +#: library/ssl.rst:1449 msgid "" "Get statistics about quantities of loaded X.509 certificates, count of X.509 " "certificates flagged as CA certificates and certificate revocation lists as " "dictionary." msgstr "" -#: library/ssl.rst:1440 +#: library/ssl.rst:1453 msgid "Example for a context with one CA cert and one other cert::" msgstr "" -#: library/ssl.rst:1450 +#: library/ssl.rst:1463 msgid "" "Load a private key and the corresponding certificate. The *certfile* string " "must be the path to a single file in PEM format containing the certificate " @@ -1624,7 +1639,7 @@ msgid "" "more information on how the certificate is stored in the *certfile*." msgstr "" -#: library/ssl.rst:1459 +#: library/ssl.rst:1472 msgid "" "The *password* argument may be a function to call to get the password for " "decrypting the private key. It will only be called if the private key is " @@ -1636,24 +1651,24 @@ msgid "" "encrypted and no password is needed." msgstr "" -#: library/ssl.rst:1468 +#: library/ssl.rst:1481 msgid "" "If the *password* argument is not specified and a password is required, " "OpenSSL's built-in password prompting mechanism will be used to " "interactively prompt the user for a password." msgstr "" -#: library/ssl.rst:1472 +#: library/ssl.rst:1485 msgid "" "An :class:`SSLError` is raised if the private key doesn't match with the " "certificate." msgstr "" -#: library/ssl.rst:1475 +#: library/ssl.rst:1488 msgid "New optional argument *password*." msgstr "" -#: library/ssl.rst:1480 +#: library/ssl.rst:1493 msgid "" "Load a set of default \"certification authority\" (CA) certificates from " "default locations. On Windows it loads CA certs from the ``CA`` and ``ROOT`` " @@ -1662,7 +1677,7 @@ msgid "" "from other locations, too." msgstr "" -#: library/ssl.rst:1486 +#: library/ssl.rst:1499 msgid "" "The *purpose* flag specifies what kind of CA certificates are loaded. The " "default settings :const:`Purpose.SERVER_AUTH` loads certificates, that are " @@ -1671,28 +1686,28 @@ msgid "" "certificate verification on the server side." msgstr "" -#: library/ssl.rst:1496 +#: library/ssl.rst:1509 msgid "" "Load a set of \"certification authority\" (CA) certificates used to validate " "other peers' certificates when :data:`verify_mode` is other than :data:" "`CERT_NONE`. At least one of *cafile* or *capath* must be specified." msgstr "" -#: library/ssl.rst:1500 +#: library/ssl.rst:1513 msgid "" "This method can also load certification revocation lists (CRLs) in PEM or " "DER format. In order to make use of CRLs, :attr:`SSLContext.verify_flags` " "must be configured properly." msgstr "" -#: library/ssl.rst:1504 +#: library/ssl.rst:1517 msgid "" "The *cafile* string, if present, is the path to a file of concatenated CA " "certificates in PEM format. See the discussion of :ref:`ssl-certificates` " "for more information about how to arrange the certificates in this file." msgstr "" -#: library/ssl.rst:1509 +#: library/ssl.rst:1522 msgid "" "The *capath* string, if present, is the path to a directory containing " "several CA certificates in PEM format, following an `OpenSSL specific layout " @@ -1700,7 +1715,7 @@ msgid "" "html>`_." msgstr "" -#: library/ssl.rst:1514 +#: library/ssl.rst:1527 msgid "" "The *cadata* object, if present, is either an ASCII string of one or more " "PEM-encoded certificates or a :term:`bytes-like object` of DER-encoded " @@ -1708,11 +1723,11 @@ msgid "" "are ignored but at least one certificate must be present." msgstr "" -#: library/ssl.rst:1519 +#: library/ssl.rst:1532 msgid "New optional argument *cadata*" msgstr "" -#: library/ssl.rst:1524 +#: library/ssl.rst:1537 msgid "" "Get a list of loaded \"certification authority\" (CA) certificates. If the " "``binary_form`` parameter is :const:`False` each list entry is a dict like " @@ -1722,19 +1737,19 @@ msgid "" "a SSL connection." msgstr "" -#: library/ssl.rst:1532 +#: library/ssl.rst:1545 msgid "" "Certificates in a capath directory aren't loaded unless they have been used " "at least once." msgstr "" -#: library/ssl.rst:1539 +#: library/ssl.rst:1552 msgid "" "Get a list of enabled ciphers. The list is in order of cipher priority. See :" "meth:`SSLContext.set_ciphers`." msgstr "" -#: library/ssl.rst:1576 +#: library/ssl.rst:1589 msgid "" "Load a set of default \"certification authority\" (CA) certificates from a " "filesystem path defined when building the OpenSSL library. Unfortunately, " @@ -1744,7 +1759,7 @@ msgid "" "configured properly." msgstr "" -#: library/ssl.rst:1585 +#: library/ssl.rst:1598 msgid "" "Set the available ciphers for sockets created with this context. It should " "be a string in the `OpenSSL cipher list format `_" msgstr "" -#: library/ssl.rst:1723 +#: library/ssl.rst:1736 msgid "Vincent Bernat." msgstr "" -#: library/ssl.rst:1729 +#: library/ssl.rst:1742 msgid "" "Wrap an existing Python socket *sock* and return an instance of :attr:" "`SSLContext.sslsocket_class` (default :class:`SSLSocket`). The returned SSL " @@ -1933,13 +1948,13 @@ msgid "" "a :const:`~socket.SOCK_STREAM` socket; other socket types are unsupported." msgstr "" -#: library/ssl.rst:1735 +#: library/ssl.rst:1748 msgid "" "The parameter ``server_side`` is a boolean which identifies whether server-" "side or client-side behavior is desired from this socket." msgstr "" -#: library/ssl.rst:1738 +#: library/ssl.rst:1751 msgid "" "For client-side sockets, the context construction is lazy; if the underlying " "socket isn't connected yet, the context construction will be performed " @@ -1950,7 +1965,7 @@ msgid "" "exc:`SSLError`." msgstr "" -#: library/ssl.rst:1746 +#: library/ssl.rst:1759 msgid "" "On client connections, the optional parameter *server_hostname* specifies " "the hostname of the service which we are connecting to. This allows a " @@ -1959,7 +1974,7 @@ msgid "" "*server_hostname* will raise a :exc:`ValueError` if *server_side* is true." msgstr "" -#: library/ssl.rst:1752 +#: library/ssl.rst:1765 msgid "" "The parameter ``do_handshake_on_connect`` specifies whether to do the SSL " "handshake automatically after doing a :meth:`socket.connect`, or whether the " @@ -1969,7 +1984,7 @@ msgid "" "socket I/O involved in the handshake." msgstr "" -#: library/ssl.rst:1759 +#: library/ssl.rst:1772 msgid "" "The parameter ``suppress_ragged_eofs`` specifies how the :meth:`SSLSocket." "recv` method should signal unexpected EOF from the other end of the " @@ -1979,40 +1994,40 @@ msgid "" "exceptions back to the caller." msgstr "" -#: library/ssl.rst:1766 +#: library/ssl.rst:1779 msgid "*session*, see :attr:`~SSLSocket.session`." msgstr "" -#: library/ssl.rst:1768 +#: library/ssl.rst:1781 msgid "" "To wrap an :class:`SSLSocket` in another :class:`SSLSocket`, use :meth:" "`SSLContext.wrap_bio`." msgstr "" -#: library/ssl.rst:1771 +#: library/ssl.rst:1784 msgid "" "Always allow a server_hostname to be passed, even if OpenSSL does not have " "SNI." msgstr "" -#: library/ssl.rst:1801 +#: library/ssl.rst:1814 msgid "*session* argument was added." msgstr "" -#: library/ssl.rst:1778 +#: library/ssl.rst:1791 msgid "" "The method returns an instance of :attr:`SSLContext.sslsocket_class` instead " "of hard-coded :class:`SSLSocket`." msgstr "" -#: library/ssl.rst:1784 +#: library/ssl.rst:1797 msgid "" "The return type of :meth:`SSLContext.wrap_socket`, defaults to :class:" "`SSLSocket`. The attribute can be overridden on instance of class in order " "to return a custom subclass of :class:`SSLSocket`." msgstr "" -#: library/ssl.rst:1793 +#: library/ssl.rst:1806 msgid "" "Wrap the BIO objects *incoming* and *outgoing* and return an instance of :" "attr:`SSLContext.sslobject_class` (default :class:`SSLObject`). The SSL " @@ -2020,26 +2035,26 @@ msgid "" "outgoing BIO." msgstr "" -#: library/ssl.rst:1798 +#: library/ssl.rst:1811 msgid "" "The *server_side*, *server_hostname* and *session* parameters have the same " "meaning as in :meth:`SSLContext.wrap_socket`." msgstr "" -#: library/ssl.rst:1804 +#: library/ssl.rst:1817 msgid "" "The method returns an instance of :attr:`SSLContext.sslobject_class` instead " "of hard-coded :class:`SSLObject`." msgstr "" -#: library/ssl.rst:1810 +#: library/ssl.rst:1823 msgid "" "The return type of :meth:`SSLContext.wrap_bio`, defaults to :class:" "`SSLObject`. The attribute can be overridden on instance of class in order " "to return a custom subclass of :class:`SSLObject`." msgstr "" -#: library/ssl.rst:1818 +#: library/ssl.rst:1831 msgid "" "Get statistics about the SSL sessions created or managed by this context. A " "dictionary is returned which maps the names of each `piece of information " @@ -2048,7 +2063,7 @@ msgid "" "misses in the session cache since the context was created::" msgstr "" -#: library/ssl.rst:1829 +#: library/ssl.rst:1842 msgid "" "Whether to match the peer cert's hostname in :meth:`SSLSocket.do_handshake`. " "The context's :attr:`~SSLContext.verify_mode` must be set to :data:" @@ -2061,7 +2076,7 @@ msgid "" "With other protocols, hostname checking must be enabled explicitly." msgstr "" -#: library/ssl.rst:1857 +#: library/ssl.rst:1870 msgid "" ":attr:`~SSLContext.verify_mode` is now automatically changed to :data:" "`CERT_REQUIRED` when hostname checking is enabled and :attr:`~SSLContext." @@ -2069,7 +2084,7 @@ msgid "" "failed with a :exc:`ValueError`." msgstr "" -#: library/ssl.rst:1864 +#: library/ssl.rst:1877 msgid "" "Write TLS keys to a keylog file, whenever key material is generated or " "received. The keylog file is designed for debugging purposes only. The file " @@ -2078,7 +2093,7 @@ msgid "" "synchronized between threads, but not between processes." msgstr "" -#: library/ssl.rst:1874 +#: library/ssl.rst:1887 msgid "" "A :class:`TLSVersion` enum member representing the highest supported TLS " "version. The value defaults to :attr:`TLSVersion.MAXIMUM_SUPPORTED`. The " @@ -2086,7 +2101,7 @@ msgid "" "`PROTOCOL_TLS_CLIENT`, and :attr:`PROTOCOL_TLS_SERVER`." msgstr "" -#: library/ssl.rst:1879 +#: library/ssl.rst:1892 msgid "" "The attributes :attr:`~SSLContext.maximum_version`, :attr:`~SSLContext." "minimum_version` and :attr:`SSLContext.options` all affect the supported SSL " @@ -2096,38 +2111,38 @@ msgid "" "`TLSVersion.TLSv1_2` will not be able to establish a TLS 1.2 connection." msgstr "" -#: library/ssl.rst:1892 +#: library/ssl.rst:1905 msgid "" "Like :attr:`SSLContext.maximum_version` except it is the lowest supported " "version or :attr:`TLSVersion.MINIMUM_SUPPORTED`." msgstr "" -#: library/ssl.rst:1899 +#: library/ssl.rst:1912 msgid "" "Control the number of TLS 1.3 session tickets of a :attr:" "`PROTOCOL_TLS_SERVER` context. The setting has no impact on TLS 1.0 to 1.2 " "connections." msgstr "" -#: library/ssl.rst:1907 +#: library/ssl.rst:1920 msgid "" "An integer representing the set of SSL options enabled on this context. The " "default value is :data:`OP_ALL`, but you can specify other options such as :" "data:`OP_NO_SSLv2` by ORing them together." msgstr "" -#: library/ssl.rst:1911 +#: library/ssl.rst:1924 msgid ":attr:`SSLContext.options` returns :class:`Options` flags:" msgstr "" -#: library/ssl.rst:1919 +#: library/ssl.rst:1932 msgid "" "All ``OP_NO_SSL*`` and ``OP_NO_TLS*`` options have been deprecated since " "Python 3.7. Use :attr:`SSLContext.minimum_version` and :attr:`SSLContext." "maximum_version` instead." msgstr "" -#: library/ssl.rst:1925 +#: library/ssl.rst:1938 msgid "" "Enable TLS 1.3 post-handshake client authentication. Post-handshake auth is " "disabled by default and a server can only request a TLS client certificate " @@ -2135,13 +2150,13 @@ msgid "" "client certificate at any time after the handshake." msgstr "" -#: library/ssl.rst:1930 +#: library/ssl.rst:1943 msgid "" "When enabled on client-side sockets, the client signals the server that it " "supports post-handshake authentication." msgstr "" -#: library/ssl.rst:1933 +#: library/ssl.rst:1946 msgid "" "When enabled on server-side sockets, :attr:`SSLContext.verify_mode` must be " "set to :data:`CERT_OPTIONAL` or :data:`CERT_REQUIRED`, too. The actual " @@ -2149,59 +2164,59 @@ msgid "" "verify_client_post_handshake` is called and some I/O is performed." msgstr "" -#: library/ssl.rst:1943 +#: library/ssl.rst:1956 msgid "" "The protocol version chosen when constructing the context. This attribute " "is read-only." msgstr "" -#: library/ssl.rst:1948 +#: library/ssl.rst:1961 msgid "" "Whether :attr:`~SSLContext.check_hostname` falls back to verify the cert's " "subject common name in the absence of a subject alternative name extension " "(default: true)." msgstr "" -#: library/ssl.rst:1956 +#: library/ssl.rst:1969 msgid "" "The flag had no effect with OpenSSL before version 1.1.1l. Python 3.8.9, " "3.9.3, and 3.10 include workarounds for previous versions." msgstr "" -#: library/ssl.rst:1961 +#: library/ssl.rst:1974 msgid "" "An integer representing the `security level `_ for the context. This " "attribute is read-only." msgstr "" -#: library/ssl.rst:1969 +#: library/ssl.rst:1982 msgid "" "The flags for certificate verification operations. You can set flags like :" "data:`VERIFY_CRL_CHECK_LEAF` by ORing them together. By default OpenSSL does " "neither require nor verify certificate revocation lists (CRLs)." msgstr "" -#: library/ssl.rst:1975 +#: library/ssl.rst:1988 msgid ":attr:`SSLContext.verify_flags` returns :class:`VerifyFlags` flags:" msgstr "" -#: library/ssl.rst:1983 +#: library/ssl.rst:1996 msgid "" "Whether to try to verify other peers' certificates and how to behave if " "verification fails. This attribute must be one of :data:`CERT_NONE`, :data:" "`CERT_OPTIONAL` or :data:`CERT_REQUIRED`." msgstr "" -#: library/ssl.rst:1987 +#: library/ssl.rst:2000 msgid ":attr:`SSLContext.verify_mode` returns :class:`VerifyMode` enum:" msgstr "" -#: library/ssl.rst:2000 +#: library/ssl.rst:2013 msgid "Certificates" msgstr "" -#: library/ssl.rst:2002 +#: library/ssl.rst:2015 msgid "" "Certificates in general are part of a public-key / private-key system. In " "this system, each *principal*, (which may be a machine, or a person, or an " @@ -2212,7 +2227,7 @@ msgid "" "other part, and **only** with the other part." msgstr "" -#: library/ssl.rst:2010 +#: library/ssl.rst:2023 msgid "" "A certificate contains information about two principals. It contains the " "name of a *subject*, and the subject's public key. It also contains a " @@ -2226,7 +2241,7 @@ msgid "" "as two fields, called \"notBefore\" and \"notAfter\"." msgstr "" -#: library/ssl.rst:2020 +#: library/ssl.rst:2033 msgid "" "In the Python use of certificates, a client or server can use a certificate " "to prove who they are. The other side of a network connection can also be " @@ -2239,18 +2254,18 @@ msgid "" "take place." msgstr "" -#: library/ssl.rst:2030 +#: library/ssl.rst:2043 msgid "" "Python uses files to contain certificates. They should be formatted as " "\"PEM\" (see :rfc:`1422`), which is a base-64 encoded form wrapped with a " "header line and a footer line::" msgstr "" -#: library/ssl.rst:2039 +#: library/ssl.rst:2052 msgid "Certificate chains" msgstr "" -#: library/ssl.rst:2041 +#: library/ssl.rst:2054 msgid "" "The Python files which contain certificates can contain a sequence of " "certificates, sometimes called a *certificate chain*. This chain should " @@ -2266,11 +2281,11 @@ msgid "" "agency which issued the certification authority's certificate::" msgstr "" -#: library/ssl.rst:2065 +#: library/ssl.rst:2078 msgid "CA certificates" msgstr "" -#: library/ssl.rst:2067 +#: library/ssl.rst:2080 msgid "" "If you are going to require validation of the other side of the connection's " "certificate, you need to provide a \"CA certs\" file, filled with the " @@ -2282,11 +2297,11 @@ msgid "" "create_default_context`." msgstr "" -#: library/ssl.rst:2076 +#: library/ssl.rst:2089 msgid "Combined key and certificate" msgstr "" -#: library/ssl.rst:2078 +#: library/ssl.rst:2091 msgid "" "Often the private key is stored in the same file as the certificate; in this " "case, only the ``certfile`` parameter to :meth:`SSLContext.load_cert_chain` " @@ -2294,11 +2309,11 @@ msgid "" "should come before the first certificate in the certificate chain::" msgstr "" -#: library/ssl.rst:2092 +#: library/ssl.rst:2105 msgid "Self-signed certificates" msgstr "" -#: library/ssl.rst:2094 +#: library/ssl.rst:2107 msgid "" "If you are going to create a server that provides SSL-encrypted connection " "services, you will need to acquire a certificate for that service. There " @@ -2308,51 +2323,51 @@ msgid "" "package, using something like the following::" msgstr "" -#: library/ssl.rst:2123 +#: library/ssl.rst:2136 msgid "" "The disadvantage of a self-signed certificate is that it is its own root " "certificate, and no one else will have it in their cache of known (and " "trusted) root certificates." msgstr "" -#: library/ssl.rst:2129 +#: library/ssl.rst:2142 msgid "Examples" msgstr "" -#: library/ssl.rst:2132 +#: library/ssl.rst:2145 msgid "Testing for SSL support" msgstr "" -#: library/ssl.rst:2134 +#: library/ssl.rst:2147 msgid "" "To test for the presence of SSL support in a Python installation, user code " "should use the following idiom::" msgstr "" -#: library/ssl.rst:2145 +#: library/ssl.rst:2158 msgid "Client-side operation" msgstr "" -#: library/ssl.rst:2147 +#: library/ssl.rst:2160 msgid "" "This example creates a SSL context with the recommended security settings " "for client sockets, including automatic certificate verification::" msgstr "" -#: library/ssl.rst:2152 +#: library/ssl.rst:2165 msgid "" "If you prefer to tune security settings yourself, you might create a context " "from scratch (but beware that you might not get the settings right)::" msgstr "" -#: library/ssl.rst:2159 +#: library/ssl.rst:2172 msgid "" "(this snippet assumes your operating system places a bundle of all CA " "certificates in ``/etc/ssl/certs/ca-bundle.crt``; if not, you'll get an " "error and have to adjust the location)" msgstr "" -#: library/ssl.rst:2163 +#: library/ssl.rst:2176 msgid "" "The :data:`PROTOCOL_TLS_CLIENT` protocol configures the context for cert " "validation and hostname verification. :attr:`~SSLContext.verify_mode` is set " @@ -2360,7 +2375,7 @@ msgid "" "``True``. All other protocols create SSL contexts with insecure defaults." msgstr "" -#: library/ssl.rst:2168 +#: library/ssl.rst:2181 msgid "" "When you use the context to connect to a server, :const:`CERT_REQUIRED` and :" "attr:`~SSLContext.check_hostname` validate the server certificate: it " @@ -2369,27 +2384,27 @@ msgid "" "properties like validity and identity of the hostname::" msgstr "" -#: library/ssl.rst:2178 +#: library/ssl.rst:2191 msgid "You may then fetch the certificate::" msgstr "" -#: library/ssl.rst:2182 +#: library/ssl.rst:2195 msgid "" "Visual inspection shows that the certificate does identify the desired " "service (that is, the HTTPS host ``www.python.org``)::" msgstr "" -#: library/ssl.rst:2225 +#: library/ssl.rst:2238 msgid "" "Now the SSL channel is established and the certificate verified, you can " "proceed to talk with the server::" msgstr "" -#: library/ssl.rst:2252 +#: library/ssl.rst:2265 msgid "Server-side operation" msgstr "" -#: library/ssl.rst:2254 +#: library/ssl.rst:2267 msgid "" "For server operation, typically you'll need to have a server certificate, " "and private key, each in a file. You'll first create a context holding the " @@ -2398,20 +2413,20 @@ msgid "" "start waiting for clients to connect::" msgstr "" -#: library/ssl.rst:2269 +#: library/ssl.rst:2282 msgid "" "When a client connects, you'll call :meth:`accept` on the socket to get the " "new socket from the other end, and use the context's :meth:`SSLContext." "wrap_socket` method to create a server-side SSL socket for the connection::" msgstr "" -#: library/ssl.rst:2282 +#: library/ssl.rst:2295 msgid "" "Then you'll read data from the ``connstream`` and do something with it till " "you are finished with the client (or the client is finished with you)::" msgstr "" -#: library/ssl.rst:2296 +#: library/ssl.rst:2309 msgid "" "And go back to listening for new client connections (of course, a real " "server would probably handle each client connection in a separate thread, or " @@ -2419,18 +2434,18 @@ msgid "" "event loop)." msgstr "" -#: library/ssl.rst:2304 +#: library/ssl.rst:2317 msgid "Notes on non-blocking sockets" msgstr "" -#: library/ssl.rst:2306 +#: library/ssl.rst:2319 msgid "" "SSL sockets behave slightly different than regular sockets in non-blocking " "mode. When working with non-blocking sockets, there are thus several things " "you need to be aware of:" msgstr "" -#: library/ssl.rst:2310 +#: library/ssl.rst:2323 msgid "" "Most :class:`SSLSocket` methods will raise either :exc:`SSLWantWriteError` " "or :exc:`SSLWantReadError` instead of :exc:`BlockingIOError` if an I/O " @@ -2442,13 +2457,13 @@ msgid "" "require a prior *write* to the underlying socket." msgstr "" -#: library/ssl.rst:2322 +#: library/ssl.rst:2335 msgid "" "In earlier Python versions, the :meth:`!SSLSocket.send` method returned zero " "instead of raising :exc:`SSLWantWriteError` or :exc:`SSLWantReadError`." msgstr "" -#: library/ssl.rst:2326 +#: library/ssl.rst:2339 msgid "" "Calling :func:`~select.select` tells you that the OS-level socket can be " "read from (or written to), but it does not imply that there is sufficient " @@ -2458,7 +2473,7 @@ msgid "" "`~select.select`." msgstr "" -#: library/ssl.rst:2333 +#: library/ssl.rst:2346 msgid "" "Conversely, since the SSL layer has its own framing, a SSL socket may still " "have data available for reading without :func:`~select.select` being aware " @@ -2467,13 +2482,13 @@ msgid "" "call if still necessary." msgstr "" -#: library/ssl.rst:2339 +#: library/ssl.rst:2352 msgid "" "(of course, similar provisions apply when using other primitives such as :" "func:`~select.poll`, or those in the :mod:`selectors` module)" msgstr "" -#: library/ssl.rst:2342 +#: library/ssl.rst:2355 msgid "" "The SSL handshake itself will be non-blocking: the :meth:`SSLSocket." "do_handshake` method has to be retried until it returns successfully. Here " @@ -2481,7 +2496,7 @@ msgid "" "readiness::" msgstr "" -#: library/ssl.rst:2358 +#: library/ssl.rst:2371 msgid "" "The :mod:`asyncio` module supports :ref:`non-blocking SSL sockets ` and provides a higher level API. It polls for events using " @@ -2490,26 +2505,26 @@ msgid "" "handshake asynchronously as well." msgstr "" -#: library/ssl.rst:2367 +#: library/ssl.rst:2380 msgid "Memory BIO Support" msgstr "" -#: library/ssl.rst:2371 +#: library/ssl.rst:2384 msgid "" "Ever since the SSL module was introduced in Python 2.6, the :class:" "`SSLSocket` class has provided two related but distinct areas of " "functionality:" msgstr "" -#: library/ssl.rst:2374 +#: library/ssl.rst:2387 msgid "SSL protocol handling" msgstr "" -#: library/ssl.rst:2375 +#: library/ssl.rst:2388 msgid "Network IO" msgstr "" -#: library/ssl.rst:2377 +#: library/ssl.rst:2390 msgid "" "The network IO API is identical to that provided by :class:`socket.socket`, " "from which :class:`SSLSocket` also inherits. This allows an SSL socket to be " @@ -2517,7 +2532,7 @@ msgid "" "add SSL support to an existing application." msgstr "" -#: library/ssl.rst:2382 +#: library/ssl.rst:2395 msgid "" "Combining SSL protocol handling and network IO usually works well, but there " "are some cases where it doesn't. An example is async IO frameworks that want " @@ -2529,7 +2544,7 @@ msgid "" "`SSLObject` is provided." msgstr "" -#: library/ssl.rst:2393 +#: library/ssl.rst:2406 msgid "" "A reduced-scope variant of :class:`SSLSocket` representing an SSL protocol " "instance that does not contain any network IO methods. This class is " @@ -2537,7 +2552,7 @@ msgid "" "for SSL through memory buffers." msgstr "" -#: library/ssl.rst:2398 +#: library/ssl.rst:2411 msgid "" "This class implements an interface on top of a low-level SSL object as " "implemented by OpenSSL. This object captures the state of an SSL connection " @@ -2545,7 +2560,7 @@ msgid "" "separate \"BIO\" objects which are OpenSSL's IO abstraction layer." msgstr "" -#: library/ssl.rst:2403 +#: library/ssl.rst:2416 msgid "" "This class has no public constructor. An :class:`SSLObject` instance must " "be created using the :meth:`~SSLContext.wrap_bio` method. This method will " @@ -2554,207 +2569,207 @@ msgid "" "instance, while the *outgoing* BIO is used to pass data the other way around." msgstr "" -#: library/ssl.rst:2410 +#: library/ssl.rst:2423 msgid "The following methods are available:" msgstr "" -#: library/ssl.rst:2412 +#: library/ssl.rst:2425 msgid ":attr:`~SSLSocket.context`" msgstr "" -#: library/ssl.rst:2413 +#: library/ssl.rst:2426 msgid ":attr:`~SSLSocket.server_side`" msgstr "" -#: library/ssl.rst:2414 +#: library/ssl.rst:2427 msgid ":attr:`~SSLSocket.server_hostname`" msgstr "" -#: library/ssl.rst:2415 +#: library/ssl.rst:2428 msgid ":attr:`~SSLSocket.session`" msgstr "" -#: library/ssl.rst:2416 +#: library/ssl.rst:2429 msgid ":attr:`~SSLSocket.session_reused`" msgstr "" -#: library/ssl.rst:2417 +#: library/ssl.rst:2430 msgid ":meth:`~SSLSocket.read`" msgstr "" -#: library/ssl.rst:2418 +#: library/ssl.rst:2431 msgid ":meth:`~SSLSocket.write`" msgstr "" -#: library/ssl.rst:2419 +#: library/ssl.rst:2432 msgid ":meth:`~SSLSocket.getpeercert`" msgstr "" -#: library/ssl.rst:2420 +#: library/ssl.rst:2433 msgid ":meth:`~SSLSocket.selected_alpn_protocol`" msgstr "" -#: library/ssl.rst:2421 +#: library/ssl.rst:2434 msgid ":meth:`~SSLSocket.selected_npn_protocol`" msgstr "" -#: library/ssl.rst:2422 +#: library/ssl.rst:2435 msgid ":meth:`~SSLSocket.cipher`" msgstr "" -#: library/ssl.rst:2423 +#: library/ssl.rst:2436 msgid ":meth:`~SSLSocket.shared_ciphers`" msgstr "" -#: library/ssl.rst:2424 +#: library/ssl.rst:2437 msgid ":meth:`~SSLSocket.compression`" msgstr "" -#: library/ssl.rst:2425 +#: library/ssl.rst:2438 msgid ":meth:`~SSLSocket.pending`" msgstr "" -#: library/ssl.rst:2426 +#: library/ssl.rst:2439 msgid ":meth:`~SSLSocket.do_handshake`" msgstr "" -#: library/ssl.rst:2427 +#: library/ssl.rst:2440 msgid ":meth:`~SSLSocket.verify_client_post_handshake`" msgstr "" -#: library/ssl.rst:2428 +#: library/ssl.rst:2441 msgid ":meth:`~SSLSocket.unwrap`" msgstr "" -#: library/ssl.rst:2429 +#: library/ssl.rst:2442 msgid ":meth:`~SSLSocket.get_channel_binding`" msgstr "" -#: library/ssl.rst:2430 +#: library/ssl.rst:2443 msgid ":meth:`~SSLSocket.version`" msgstr "" -#: library/ssl.rst:2432 +#: library/ssl.rst:2445 msgid "" "When compared to :class:`SSLSocket`, this object lacks the following " "features:" msgstr "" -#: library/ssl.rst:2435 +#: library/ssl.rst:2448 msgid "" "Any form of network IO; ``recv()`` and ``send()`` read and write only to the " "underlying :class:`MemoryBIO` buffers." msgstr "" -#: library/ssl.rst:2438 +#: library/ssl.rst:2451 msgid "" "There is no *do_handshake_on_connect* machinery. You must always manually " "call :meth:`~SSLSocket.do_handshake` to start the handshake." msgstr "" -#: library/ssl.rst:2441 +#: library/ssl.rst:2454 msgid "" "There is no handling of *suppress_ragged_eofs*. All end-of-file conditions " "that are in violation of the protocol are reported via the :exc:" "`SSLEOFError` exception." msgstr "" -#: library/ssl.rst:2445 +#: library/ssl.rst:2458 msgid "" "The method :meth:`~SSLSocket.unwrap` call does not return anything, unlike " "for an SSL socket where it returns the underlying socket." msgstr "" -#: library/ssl.rst:2448 +#: library/ssl.rst:2461 msgid "" "The *server_name_callback* callback passed to :meth:`SSLContext." "set_servername_callback` will get an :class:`SSLObject` instance instead of " "a :class:`SSLSocket` instance as its first parameter." msgstr "" -#: library/ssl.rst:2452 +#: library/ssl.rst:2465 msgid "Some notes related to the use of :class:`SSLObject`:" msgstr "" -#: library/ssl.rst:2454 +#: library/ssl.rst:2467 msgid "" "All IO on an :class:`SSLObject` is :ref:`non-blocking `. " "This means that for example :meth:`~SSLSocket.read` will raise an :exc:" "`SSLWantReadError` if it needs more data than the incoming BIO has available." msgstr "" -#: library/ssl.rst:2459 +#: library/ssl.rst:2472 msgid "" ":class:`SSLObject` instances must be created with :meth:`~SSLContext." "wrap_bio`. In earlier versions, it was possible to create instances " "directly. This was never documented or officially supported." msgstr "" -#: library/ssl.rst:2465 +#: library/ssl.rst:2478 msgid "" "An SSLObject communicates with the outside world using memory buffers. The " "class :class:`MemoryBIO` provides a memory buffer that can be used for this " "purpose. It wraps an OpenSSL memory BIO (Basic IO) object:" msgstr "" -#: library/ssl.rst:2471 +#: library/ssl.rst:2484 msgid "" "A memory buffer that can be used to pass data between Python and an SSL " "protocol instance." msgstr "" -#: library/ssl.rst:2476 +#: library/ssl.rst:2489 msgid "Return the number of bytes currently in the memory buffer." msgstr "" -#: library/ssl.rst:2480 +#: library/ssl.rst:2493 msgid "" "A boolean indicating whether the memory BIO is current at the end-of-file " "position." msgstr "" -#: library/ssl.rst:2485 +#: library/ssl.rst:2498 msgid "" "Read up to *n* bytes from the memory buffer. If *n* is not specified or " "negative, all bytes are returned." msgstr "" -#: library/ssl.rst:2490 +#: library/ssl.rst:2503 msgid "" "Write the bytes from *buf* to the memory BIO. The *buf* argument must be an " "object supporting the buffer protocol." msgstr "" -#: library/ssl.rst:2493 +#: library/ssl.rst:2506 msgid "" "The return value is the number of bytes written, which is always equal to " "the length of *buf*." msgstr "" -#: library/ssl.rst:2498 +#: library/ssl.rst:2511 msgid "" "Write an EOF marker to the memory BIO. After this method has been called, it " "is illegal to call :meth:`~MemoryBIO.write`. The attribute :attr:`eof` will " "become true after all data currently in the buffer has been read." msgstr "" -#: library/ssl.rst:2504 +#: library/ssl.rst:2517 msgid "SSL session" msgstr "" -#: library/ssl.rst:2510 +#: library/ssl.rst:2523 msgid "Session object used by :attr:`~SSLSocket.session`." msgstr "" -#: library/ssl.rst:2522 +#: library/ssl.rst:2535 msgid "Security considerations" msgstr "" -#: library/ssl.rst:2525 +#: library/ssl.rst:2538 msgid "Best defaults" msgstr "" -#: library/ssl.rst:2527 +#: library/ssl.rst:2540 msgid "" "For **client use**, if you don't have any special requirements for your " "security policy, it is highly recommended that you use the :func:" @@ -2764,19 +2779,19 @@ msgid "" "settings." msgstr "" -#: library/ssl.rst:2534 +#: library/ssl.rst:2547 msgid "" "For example, here is how you would use the :class:`smtplib.SMTP` class to " "create a trusted, secure connection to a SMTP server::" msgstr "" -#: library/ssl.rst:2543 +#: library/ssl.rst:2556 msgid "" "If a client certificate is needed for the connection, it can be added with :" "meth:`SSLContext.load_cert_chain`." msgstr "" -#: library/ssl.rst:2546 +#: library/ssl.rst:2559 msgid "" "By contrast, if you create the SSL context by calling the :class:" "`SSLContext` constructor yourself, it will not have certificate validation " @@ -2784,15 +2799,15 @@ msgid "" "paragraphs below to achieve a good security level." msgstr "" -#: library/ssl.rst:2552 +#: library/ssl.rst:2565 msgid "Manual settings" msgstr "" -#: library/ssl.rst:2555 +#: library/ssl.rst:2568 msgid "Verifying certificates" msgstr "" -#: library/ssl.rst:2557 +#: library/ssl.rst:2570 msgid "" "When calling the :class:`SSLContext` constructor directly, :const:" "`CERT_NONE` is the default. Since it does not authenticate the other peer, " @@ -2807,13 +2822,13 @@ msgid "" "enabled." msgstr "" -#: library/ssl.rst:2569 +#: library/ssl.rst:2582 msgid "" "Hostname matchings is now performed by OpenSSL. Python no longer uses :func:" "`match_hostname`." msgstr "" -#: library/ssl.rst:2573 +#: library/ssl.rst:2586 msgid "" "In server mode, if you want to authenticate your clients using the SSL layer " "(rather than using a higher-level authentication mechanism), you'll also " @@ -2821,11 +2836,11 @@ msgid "" "certificate." msgstr "" -#: library/ssl.rst:2579 +#: library/ssl.rst:2592 msgid "Protocol versions" msgstr "" -#: library/ssl.rst:2581 +#: library/ssl.rst:2594 msgid "" "SSL versions 2 and 3 are considered insecure and are therefore dangerous to " "use. If you want maximum compatibility between clients and servers, it is " @@ -2834,7 +2849,7 @@ msgid "" "by default." msgstr "" -#: library/ssl.rst:2594 +#: library/ssl.rst:2607 msgid "" "The SSL context created above will only allow TLSv1.3 and later (if " "supported by your system) connections to a server. :const:" @@ -2842,11 +2857,11 @@ msgid "" "default. You have to load certificates into the context." msgstr "" -#: library/ssl.rst:2601 +#: library/ssl.rst:2614 msgid "Cipher selection" msgstr "" -#: library/ssl.rst:2603 +#: library/ssl.rst:2616 msgid "" "If you have advanced security requirements, fine-tuning of the ciphers " "enabled when negotiating a SSL session is possible through the :meth:" @@ -2859,11 +2874,11 @@ msgid "" "ciphers`` command on your system." msgstr "" -#: library/ssl.rst:2614 +#: library/ssl.rst:2627 msgid "Multi-processing" msgstr "" -#: library/ssl.rst:2616 +#: library/ssl.rst:2629 msgid "" "If using this module as part of a multi-processed application (using, for " "example the :mod:`multiprocessing` or :mod:`concurrent.futures` modules), be " @@ -2874,17 +2889,17 @@ msgid "" "sufficient." msgstr "" -#: library/ssl.rst:2628 +#: library/ssl.rst:2641 msgid "TLS 1.3" msgstr "" -#: library/ssl.rst:2632 +#: library/ssl.rst:2645 msgid "" "The TLS 1.3 protocol behaves slightly differently than previous version of " "TLS/SSL. Some new TLS 1.3 features are not yet available." msgstr "" -#: library/ssl.rst:2635 +#: library/ssl.rst:2648 msgid "" "TLS 1.3 uses a disjunct set of cipher suites. All AES-GCM and ChaCha20 " "cipher suites are enabled by default. The method :meth:`SSLContext." @@ -2892,14 +2907,14 @@ msgid "" "`SSLContext.get_ciphers` returns them." msgstr "" -#: library/ssl.rst:2639 +#: library/ssl.rst:2652 msgid "" "Session tickets are no longer sent as part of the initial handshake and are " "handled differently. :attr:`SSLSocket.session` and :class:`SSLSession` are " "not compatible with TLS 1.3." msgstr "" -#: library/ssl.rst:2642 +#: library/ssl.rst:2655 msgid "" "Client-side certificates are also no longer verified during the initial " "handshake. A server can request a certificate at any time. Clients process " @@ -2907,103 +2922,103 @@ msgid "" "server." msgstr "" -#: library/ssl.rst:2646 +#: library/ssl.rst:2659 msgid "" "TLS 1.3 features like early data, deferred TLS client cert request, " "signature algorithm configuration, and rekeying are not supported yet." msgstr "" -#: library/ssl.rst:2652 +#: library/ssl.rst:2665 msgid "Class :class:`socket.socket`" msgstr "" -#: library/ssl.rst:2653 +#: library/ssl.rst:2666 msgid "Documentation of underlying :mod:`socket` class" msgstr "" -#: library/ssl.rst:2655 +#: library/ssl.rst:2668 msgid "" "`SSL/TLS Strong Encryption: An Introduction `_" msgstr "" -#: library/ssl.rst:2656 +#: library/ssl.rst:2669 msgid "Intro from the Apache HTTP Server documentation" msgstr "" -#: library/ssl.rst:2658 +#: library/ssl.rst:2671 msgid "" ":rfc:`RFC 1422: Privacy Enhancement for Internet Electronic Mail: Part II: " "Certificate-Based Key Management <1422>`" msgstr "" -#: library/ssl.rst:2659 +#: library/ssl.rst:2672 msgid "Steve Kent" msgstr "" -#: library/ssl.rst:2661 +#: library/ssl.rst:2674 msgid ":rfc:`RFC 4086: Randomness Requirements for Security <4086>`" msgstr "" -#: library/ssl.rst:2662 +#: library/ssl.rst:2675 msgid "Donald E., Jeffrey I. Schiller" msgstr "" -#: library/ssl.rst:2664 +#: library/ssl.rst:2677 msgid "" ":rfc:`RFC 5280: Internet X.509 Public Key Infrastructure Certificate and " "Certificate Revocation List (CRL) Profile <5280>`" msgstr "" -#: library/ssl.rst:2665 +#: library/ssl.rst:2678 msgid "D. Cooper" msgstr "" -#: library/ssl.rst:2667 +#: library/ssl.rst:2680 msgid "" ":rfc:`RFC 5246: The Transport Layer Security (TLS) Protocol Version 1.2 " "<5246>`" msgstr "" -#: library/ssl.rst:2668 +#: library/ssl.rst:2681 msgid "T. Dierks et. al." msgstr "" -#: library/ssl.rst:2670 +#: library/ssl.rst:2683 msgid ":rfc:`RFC 6066: Transport Layer Security (TLS) Extensions <6066>`" msgstr "" -#: library/ssl.rst:2671 +#: library/ssl.rst:2684 msgid "D. Eastlake" msgstr "" -#: library/ssl.rst:2673 +#: library/ssl.rst:2686 msgid "" "`IANA TLS: Transport Layer Security (TLS) Parameters `_" msgstr "" -#: library/ssl.rst:2674 +#: library/ssl.rst:2687 msgid "IANA" msgstr "" -#: library/ssl.rst:2676 +#: library/ssl.rst:2689 msgid "" ":rfc:`RFC 7525: Recommendations for Secure Use of Transport Layer Security " "(TLS) and Datagram Transport Layer Security (DTLS) <7525>`" msgstr "" -#: library/ssl.rst:2677 +#: library/ssl.rst:2690 msgid "IETF" msgstr "" -#: library/ssl.rst:2679 +#: library/ssl.rst:2692 msgid "" "`Mozilla's Server Side TLS recommendations `_" msgstr "" -#: library/ssl.rst:2680 +#: library/ssl.rst:2693 msgid "Mozilla" msgstr "" @@ -3031,10 +3046,10 @@ msgstr "" msgid "Secure Sockets Layer" msgstr "" -#: library/ssl.rst:1993 +#: library/ssl.rst:2006 msgid "certificates" msgstr "" -#: library/ssl.rst:1995 +#: library/ssl.rst:2008 msgid "X509 certificate" msgstr "" diff --git a/library/statistics.po b/library/statistics.po index 0a38cf369..2d25b38b3 100644 --- a/library/statistics.po +++ b/library/statistics.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -84,7 +84,7 @@ msgid ":func:`fmean`" msgstr "" #: library/statistics.rst:76 -msgid "Fast, floating point arithmetic mean, with optional weighting." +msgid "Fast, floating-point arithmetic mean, with optional weighting." msgstr "" #: library/statistics.rst:77 @@ -534,24 +534,33 @@ msgstr "" #: library/statistics.rst:411 msgid "" +"Only hashable inputs are supported. To handle type :class:`set`, consider " +"casting to :class:`frozenset`. To handle type :class:`list`, consider " +"casting to :class:`tuple`. For mixed or nested inputs, consider using this " +"slower quadratic algorithm that only depends on equality tests: ``max(data, " +"key=data.count)``." +msgstr "" + +#: library/statistics.rst:417 +msgid "" "Now handles multimodal datasets by returning the first mode encountered. " "Formerly, it raised :exc:`StatisticsError` when more than one mode was found." msgstr "" -#: library/statistics.rst:419 +#: library/statistics.rst:425 msgid "" "Return a list of the most frequently occurring values in the order they were " "first encountered in the *data*. Will return more than one result if there " "are multiple modes or an empty list if the *data* is empty:" msgstr "" -#: library/statistics.rst:435 +#: library/statistics.rst:441 msgid "" "Return the population standard deviation (the square root of the population " "variance). See :func:`pvariance` for arguments and other details." msgstr "" -#: library/statistics.rst:446 +#: library/statistics.rst:452 msgid "" "Return the population variance of *data*, a non-empty sequence or iterable " "of real-valued numbers. Variance, or second moment about the mean, is a " @@ -560,7 +569,7 @@ msgid "" "clustered closely around the mean." msgstr "" -#: library/statistics.rst:452 +#: library/statistics.rst:458 msgid "" "If the optional second argument *mu* is given, it should be the *population* " "mean of the *data*. It can also be used to compute the second moment around " @@ -568,39 +577,39 @@ msgid "" "the arithmetic mean is automatically calculated." msgstr "" -#: library/statistics.rst:457 +#: library/statistics.rst:463 msgid "" "Use this function to calculate the variance from the entire population. To " "estimate the variance from a sample, the :func:`variance` function is " "usually a better choice." msgstr "" -#: library/statistics.rst:461 +#: library/statistics.rst:467 msgid "Raises :exc:`StatisticsError` if *data* is empty." msgstr "" -#: library/statistics.rst:533 library/statistics.rst:637 +#: library/statistics.rst:539 library/statistics.rst:643 msgid "Examples:" msgstr "" -#: library/statistics.rst:471 +#: library/statistics.rst:477 msgid "" "If you have already calculated the mean of your data, you can pass it as the " "optional second argument *mu* to avoid recalculation:" msgstr "" -#: library/statistics.rst:480 +#: library/statistics.rst:486 msgid "Decimals and Fractions are supported:" msgstr "" -#: library/statistics.rst:494 +#: library/statistics.rst:500 msgid "" "When called with the entire population, this gives the population variance " "σ². When called on a sample instead, this is the biased sample variance s², " "also known as variance with N degrees of freedom." msgstr "" -#: library/statistics.rst:498 +#: library/statistics.rst:504 msgid "" "If you somehow know the true population mean μ, you may use this function to " "calculate the variance of a sample, giving the known population mean as the " @@ -609,13 +618,13 @@ msgid "" "variance." msgstr "" -#: library/statistics.rst:507 +#: library/statistics.rst:513 msgid "" "Return the sample standard deviation (the square root of the sample " "variance). See :func:`variance` for arguments and other details." msgstr "" -#: library/statistics.rst:518 +#: library/statistics.rst:524 msgid "" "Return the sample variance of *data*, an iterable of at least two real-" "valued numbers. Variance, or second moment about the mean, is a measure of " @@ -624,41 +633,41 @@ msgid "" "closely around the mean." msgstr "" -#: library/statistics.rst:524 +#: library/statistics.rst:530 msgid "" "If the optional second argument *xbar* is given, it should be the *sample* " "mean of *data*. If it is missing or ``None`` (the default), the mean is " "automatically calculated." msgstr "" -#: library/statistics.rst:528 +#: library/statistics.rst:534 msgid "" "Use this function when your data is a sample from a population. To calculate " "the variance from the entire population, see :func:`pvariance`." msgstr "" -#: library/statistics.rst:531 +#: library/statistics.rst:537 msgid "Raises :exc:`StatisticsError` if *data* has fewer than two values." msgstr "" -#: library/statistics.rst:541 +#: library/statistics.rst:547 msgid "" "If you have already calculated the sample mean of your data, you can pass it " "as the optional second argument *xbar* to avoid recalculation:" msgstr "" -#: library/statistics.rst:550 +#: library/statistics.rst:556 msgid "" "This function does not attempt to verify that you have passed the actual " "mean as *xbar*. Using arbitrary values for *xbar* can lead to invalid or " "impossible results." msgstr "" -#: library/statistics.rst:554 +#: library/statistics.rst:560 msgid "Decimal and Fraction values are supported:" msgstr "" -#: library/statistics.rst:568 +#: library/statistics.rst:574 msgid "" "This is the sample variance s² with Bessel's correction, also known as " "variance with N-1 degrees of freedom. Provided that the data points are " @@ -666,20 +675,20 @@ msgid "" "should be an unbiased estimate of the true population variance." msgstr "" -#: library/statistics.rst:573 +#: library/statistics.rst:579 msgid "" "If you somehow know the actual population mean μ you should pass it to the :" "func:`pvariance` function as the *mu* parameter to get the variance of a " "sample." msgstr "" -#: library/statistics.rst:579 +#: library/statistics.rst:585 msgid "" "Divide *data* into *n* continuous intervals with equal probability. Returns " "a list of ``n - 1`` cut points separating the intervals." msgstr "" -#: library/statistics.rst:582 +#: library/statistics.rst:588 msgid "" "Set *n* to 4 for quartiles (the default). Set *n* to 10 for deciles. Set " "*n* to 100 for percentiles which gives the 99 cuts points that separate " @@ -687,28 +696,28 @@ msgid "" "not least 1." msgstr "" -#: library/statistics.rst:587 +#: library/statistics.rst:593 msgid "" "The *data* can be any iterable containing sample data. For meaningful " "results, the number of data points in *data* should be larger than *n*. " "Raises :exc:`StatisticsError` if there are not at least two data points." msgstr "" -#: library/statistics.rst:591 +#: library/statistics.rst:597 msgid "" "The cut points are linearly interpolated from the two nearest data points. " "For example, if a cut point falls one-third of the distance between two " "sample values, ``100`` and ``112``, the cut-point will evaluate to ``104``." msgstr "" -#: library/statistics.rst:596 +#: library/statistics.rst:602 msgid "" "The *method* for computing quantiles can be varied depending on whether the " "*data* includes or excludes the lowest and highest possible values from the " "population." msgstr "" -#: library/statistics.rst:600 +#: library/statistics.rst:606 msgid "" "The default *method* is \"exclusive\" and is used for data sampled from a " "population that can have more extreme values than found in the samples. The " @@ -718,7 +727,7 @@ msgid "" "70%, 80%, 90%." msgstr "" -#: library/statistics.rst:607 +#: library/statistics.rst:613 msgid "" "Setting the *method* to \"inclusive\" is used for describing population data " "or for samples that are known to include the most extreme values from the " @@ -730,19 +739,19 @@ msgid "" "80%, 90%, 100%." msgstr "" -#: library/statistics.rst:631 +#: library/statistics.rst:637 msgid "" "Return the sample covariance of two inputs *x* and *y*. Covariance is a " "measure of the joint variability of two inputs." msgstr "" -#: library/statistics.rst:634 +#: library/statistics.rst:640 msgid "" "Both inputs must be of the same length (no less than two), otherwise :exc:" "`StatisticsError` is raised." msgstr "" -#: library/statistics.rst:655 +#: library/statistics.rst:661 msgid "" "Return the `Pearson's correlation coefficient `_ for two inputs. Pearson's correlation " @@ -750,7 +759,7 @@ msgid "" "direction of a linear relationship." msgstr "" -#: library/statistics.rst:661 +#: library/statistics.rst:667 msgid "" "If *method* is \"ranked\", computes `Spearman's rank correlation coefficient " "`_ " @@ -759,30 +768,30 @@ msgid "" "strength of a monotonic relationship." msgstr "" -#: library/statistics.rst:667 +#: library/statistics.rst:673 msgid "" "Spearman's correlation coefficient is appropriate for ordinal data or for " "continuous data that doesn't meet the linear proportion requirement for " "Pearson's correlation coefficient." msgstr "" -#: library/statistics.rst:671 +#: library/statistics.rst:677 msgid "" "Both inputs must be of the same length (no less than two), and need not to " "be constant, otherwise :exc:`StatisticsError` is raised." msgstr "" -#: library/statistics.rst:674 +#: library/statistics.rst:680 msgid "" "Example with `Kepler's laws of planetary motion `_:" msgstr "" -#: library/statistics.rst:701 +#: library/statistics.rst:707 msgid "Added support for Spearman's rank correlation coefficient." msgstr "" -#: library/statistics.rst:706 +#: library/statistics.rst:712 msgid "" "Return the slope and intercept of `simple linear regression `_ parameters estimated using " @@ -791,11 +800,11 @@ msgid "" "this linear function:" msgstr "" -#: library/statistics.rst:712 +#: library/statistics.rst:718 msgid "*y = slope \\* x + intercept + noise*" msgstr "" -#: library/statistics.rst:714 +#: library/statistics.rst:720 msgid "" "where ``slope`` and ``intercept`` are the regression parameters that are " "estimated, and ``noise`` represents the variability of the data that was not " @@ -803,14 +812,14 @@ msgid "" "predicted and actual values of the dependent variable)." msgstr "" -#: library/statistics.rst:720 +#: library/statistics.rst:726 msgid "" "Both inputs must be of the same length (no less than two), and the " "independent variable *x* cannot be constant; otherwise a :exc:" "`StatisticsError` is raised." msgstr "" -#: library/statistics.rst:724 +#: library/statistics.rst:730 msgid "" "For example, we can use the `release dates of the Monty Python films " "`_ to predict the " @@ -818,7 +827,7 @@ msgid "" "2019 assuming that they had kept the pace." msgstr "" -#: library/statistics.rst:738 +#: library/statistics.rst:744 msgid "" "If *proportional* is true, the independent variable *x* and the dependent " "variable *y* are assumed to be directly proportional. The data is fit to a " @@ -826,38 +835,38 @@ msgid "" "the underlying linear function simplifies to:" msgstr "" -#: library/statistics.rst:744 +#: library/statistics.rst:750 msgid "*y = slope \\* x + noise*" msgstr "" -#: library/statistics.rst:746 +#: library/statistics.rst:752 msgid "" "Continuing the example from :func:`correlation`, we look to see how well a " "model based on major planets can predict the orbital distances for dwarf " "planets:" msgstr "" -#: library/statistics.rst:766 +#: library/statistics.rst:772 msgid "Added support for *proportional*." msgstr "" -#: library/statistics.rst:770 +#: library/statistics.rst:776 msgid "Exceptions" msgstr "" -#: library/statistics.rst:772 +#: library/statistics.rst:778 msgid "A single exception is defined:" msgstr "" -#: library/statistics.rst:776 +#: library/statistics.rst:782 msgid "Subclass of :exc:`ValueError` for statistics-related exceptions." msgstr "" -#: library/statistics.rst:780 +#: library/statistics.rst:786 msgid ":class:`NormalDist` objects" msgstr "" -#: library/statistics.rst:782 +#: library/statistics.rst:788 msgid "" ":class:`NormalDist` is a tool for creating and manipulating normal " "distributions of a `random variable `_ and have a wide range of " "applications in statistics." msgstr "" -#: library/statistics.rst:794 +#: library/statistics.rst:800 msgid "" "Returns a new *NormalDist* object where *mu* represents the `arithmetic mean " "`_ and *sigma* represents the " "`standard deviation `_." msgstr "" -#: library/statistics.rst:799 +#: library/statistics.rst:805 msgid "If *sigma* is negative, raises :exc:`StatisticsError`." msgstr "" -#: library/statistics.rst:803 +#: library/statistics.rst:809 msgid "" "A read-only property for the `arithmetic mean `_ of a normal distribution." msgstr "" -#: library/statistics.rst:809 +#: library/statistics.rst:815 msgid "" "A read-only property for the `median `_ of a normal distribution." msgstr "" -#: library/statistics.rst:815 +#: library/statistics.rst:821 msgid "" "A read-only property for the `mode `_ of a normal distribution." msgstr "" -#: library/statistics.rst:821 +#: library/statistics.rst:827 msgid "" "A read-only property for the `standard deviation `_ of a normal distribution." msgstr "" -#: library/statistics.rst:827 +#: library/statistics.rst:833 msgid "" "A read-only property for the `variance `_ of a normal distribution. Equal to the square of the standard " "deviation." msgstr "" -#: library/statistics.rst:833 +#: library/statistics.rst:839 msgid "" "Makes a normal distribution instance with *mu* and *sigma* parameters " "estimated from the *data* using :func:`fmean` and :func:`stdev`." msgstr "" -#: library/statistics.rst:836 +#: library/statistics.rst:842 msgid "" "The *data* can be any :term:`iterable` and should consist of values that can " "be converted to type :class:`float`. If *data* does not contain at least " @@ -929,20 +938,20 @@ msgid "" "dispersion." msgstr "" -#: library/statistics.rst:844 +#: library/statistics.rst:850 msgid "" "Generates *n* random samples for a given mean and standard deviation. " "Returns a :class:`list` of :class:`float` values." msgstr "" -#: library/statistics.rst:847 +#: library/statistics.rst:853 msgid "" "If *seed* is given, creates a new instance of the underlying random number " "generator. This is useful for creating reproducible results, even in a " "multi-threading context." msgstr "" -#: library/statistics.rst:853 +#: library/statistics.rst:859 msgid "" "Using a `probability density function (pdf) `_, compute the relative likelihood that a " @@ -950,7 +959,7 @@ msgid "" "the limit of the ratio ``P(x <= X < x+dx) / dx`` as *dx* approaches zero." msgstr "" -#: library/statistics.rst:859 +#: library/statistics.rst:865 msgid "" "The relative likelihood is computed as the probability of a sample occurring " "in a narrow range divided by the width of the range (hence the word " @@ -958,7 +967,7 @@ msgid "" "can be greater than ``1.0``." msgstr "" -#: library/statistics.rst:866 +#: library/statistics.rst:872 msgid "" "Using a `cumulative distribution function (cdf) `_, compute the probability that a " @@ -966,7 +975,7 @@ msgid "" "is written ``P(X <= x)``." msgstr "" -#: library/statistics.rst:873 +#: library/statistics.rst:879 msgid "" "Compute the inverse cumulative distribution function, also known as the " "`quantile function `_ or " @@ -975,34 +984,34 @@ msgid "" "function. Mathematically, it is written ``x : P(X <= x) = p``." msgstr "" -#: library/statistics.rst:879 +#: library/statistics.rst:885 msgid "" "Finds the value *x* of the random variable *X* such that the probability of " "the variable being less than or equal to that value equals the given " "probability *p*." msgstr "" -#: library/statistics.rst:885 +#: library/statistics.rst:891 msgid "" "Measures the agreement between two normal probability distributions. Returns " "a value between 0.0 and 1.0 giving `the overlapping area for the two " "probability density functions `_." msgstr "" -#: library/statistics.rst:892 +#: library/statistics.rst:898 msgid "" "Divide the normal distribution into *n* continuous intervals with equal " "probability. Returns a list of (n - 1) cut points separating the intervals." msgstr "" -#: library/statistics.rst:896 +#: library/statistics.rst:902 msgid "" "Set *n* to 4 for quartiles (the default). Set *n* to 10 for deciles. Set " "*n* to 100 for percentiles which gives the 99 cuts points that separate the " "normal distribution into 100 equal sized groups." msgstr "" -#: library/statistics.rst:902 +#: library/statistics.rst:908 msgid "" "Compute the `Standard Score `_ describing *x* in terms of the number of standard " @@ -1010,20 +1019,20 @@ msgid "" "mean) / stdev``." msgstr "" -#: library/statistics.rst:910 +#: library/statistics.rst:916 msgid "" "Instances of :class:`NormalDist` support addition, subtraction, " "multiplication and division by a constant. These operations are used for " "translation and scaling. For example:" msgstr "" -#: library/statistics.rst:920 +#: library/statistics.rst:926 msgid "" "Dividing a constant by an instance of :class:`NormalDist` is not supported " "because the result wouldn't be normally distributed." msgstr "" -#: library/statistics.rst:923 +#: library/statistics.rst:929 msgid "" "Since normal distributions arise from additive effects of independent " "variables, it is possible to `add and subtract two independent normally " @@ -1032,19 +1041,19 @@ msgid "" "class:`NormalDist`. For example:" msgstr "" -#: library/statistics.rst:943 +#: library/statistics.rst:949 msgid "Examples and Recipes" msgstr "" -#: library/statistics.rst:947 +#: library/statistics.rst:953 msgid "Classic probability problems" msgstr "" -#: library/statistics.rst:949 +#: library/statistics.rst:955 msgid ":class:`NormalDist` readily solves classic probability problems." msgstr "" -#: library/statistics.rst:951 +#: library/statistics.rst:957 msgid "" "For example, given `historical data for SAT exams `_ showing that scores are " @@ -1053,35 +1062,35 @@ msgid "" "after rounding to the nearest whole number:" msgstr "" -#: library/statistics.rst:964 +#: library/statistics.rst:970 msgid "" "Find the `quartiles `_ and `deciles " "`_ for the SAT scores:" msgstr "" -#: library/statistics.rst:976 +#: library/statistics.rst:982 msgid "Monte Carlo inputs for simulations" msgstr "" -#: library/statistics.rst:978 +#: library/statistics.rst:984 msgid "" "To estimate the distribution for a model that isn't easy to solve " "analytically, :class:`NormalDist` can generate input samples for a `Monte " "Carlo simulation `_:" msgstr "" -#: library/statistics.rst:995 +#: library/statistics.rst:1001 msgid "Approximating binomial distributions" msgstr "" -#: library/statistics.rst:997 +#: library/statistics.rst:1003 msgid "" "Normal distributions can be used to approximate `Binomial distributions " "`_ when the sample " "size is large and when the probability of a successful trial is near 50%." msgstr "" -#: library/statistics.rst:1002 +#: library/statistics.rst:1008 msgid "" "For example, an open source conference has 750 attendees and two rooms with " "a 500 person capacity. There is a talk about Python and another about Ruby. " @@ -1090,15 +1099,15 @@ msgid "" "probability that the Python room will stay within its capacity limits?" msgstr "" -#: library/statistics.rst:1033 +#: library/statistics.rst:1039 msgid "Naive bayesian classifier" msgstr "" -#: library/statistics.rst:1035 +#: library/statistics.rst:1041 msgid "Normal distributions commonly arise in machine learning problems." msgstr "" -#: library/statistics.rst:1037 +#: library/statistics.rst:1043 msgid "" "Wikipedia has a `nice example of a Naive Bayesian Classifier `_. The " @@ -1106,20 +1115,20 @@ msgid "" "distributed features including height, weight, and foot size." msgstr "" -#: library/statistics.rst:1042 +#: library/statistics.rst:1048 msgid "" "We're given a training dataset with measurements for eight people. The " "measurements are assumed to be normally distributed, so we summarize the " "data with :class:`NormalDist`:" msgstr "" -#: library/statistics.rst:1055 +#: library/statistics.rst:1061 msgid "" "Next, we encounter a new person whose feature measurements are known but " "whose gender is unknown:" msgstr "" -#: library/statistics.rst:1064 +#: library/statistics.rst:1070 msgid "" "Starting with a 50% `prior probability `_ of being male or female, we compute the posterior as " @@ -1127,24 +1136,24 @@ msgid "" "given the gender:" msgstr "" -#: library/statistics.rst:1079 +#: library/statistics.rst:1085 msgid "" "The final prediction goes to the largest posterior. This is known as the " "`maximum a posteriori `_ or MAP:" msgstr "" -#: library/statistics.rst:1090 +#: library/statistics.rst:1096 msgid "Kernel density estimation" msgstr "" -#: library/statistics.rst:1092 +#: library/statistics.rst:1098 msgid "" "It is possible to estimate a continuous probability distribution from a " "fixed number of discrete samples." msgstr "" -#: library/statistics.rst:1095 +#: library/statistics.rst:1101 msgid "" "The basic idea is to smooth the data using `a kernel function such as a " "normal distribution, triangular distribution, or uniform distribution " @@ -1154,7 +1163,7 @@ msgid "" "*bandwidth*." msgstr "" -#: library/statistics.rst:1125 +#: library/statistics.rst:1131 msgid "" "`Wikipedia has an example `_ where we can use the ``kde_normal()`` " @@ -1162,24 +1171,24 @@ msgid "" "small sample:" msgstr "" -#: library/statistics.rst:1137 +#: library/statistics.rst:1143 msgid "The points in ``xarr`` and ``yarr`` can be used to make a PDF plot:" msgstr "" -#: library/statistics.rst:1139 +#: library/statistics.rst:1145 msgid "Scatter plot of the estimated probability density function." msgstr "" -#: library/statistics.rst:1142 +#: library/statistics.rst:1148 msgid "" "`Resample `_ the data " "to produce 100 new selections:" msgstr "" -#: library/statistics.rst:1149 +#: library/statistics.rst:1155 msgid "Determine the probability of a new selection being below ``2.0``:" msgstr "" -#: library/statistics.rst:1156 +#: library/statistics.rst:1162 msgid "Add a new sample data point and find the new CDF at ``2.0``:" msgstr "" diff --git a/library/stdtypes.po b/library/stdtypes.po index 1574a6274..9d0ae105d 100644 --- a/library/stdtypes.po +++ b/library/stdtypes.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2023-02-01 18:55-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -137,8 +137,8 @@ msgstr "İşlem" msgid "Result" msgstr "Sonuç" -#: library/stdtypes.rst:276 library/stdtypes.rst:965 library/stdtypes.rst:2419 -#: library/stdtypes.rst:3637 +#: library/stdtypes.rst:276 library/stdtypes.rst:965 library/stdtypes.rst:2422 +#: library/stdtypes.rst:3641 msgid "Notes" msgstr "Notlar" @@ -150,7 +150,7 @@ msgstr "``x or y``" msgid "if *x* is true, then *x*, else *y*" msgstr "*x* doğruysa, *x*, aksi halde *y*" -#: library/stdtypes.rst:967 library/stdtypes.rst:1181 library/stdtypes.rst:3643 +#: library/stdtypes.rst:967 library/stdtypes.rst:1181 library/stdtypes.rst:3647 msgid "\\(1)" msgstr "\\(1)" @@ -162,8 +162,8 @@ msgstr "``x and y``" msgid "if *x* is false, then *x*, else *y*" msgstr "*x* yanlışsa, *x*, aksi halde *y*" -#: library/stdtypes.rst:289 library/stdtypes.rst:1209 library/stdtypes.rst:2431 -#: library/stdtypes.rst:3649 +#: library/stdtypes.rst:289 library/stdtypes.rst:1209 library/stdtypes.rst:2434 +#: library/stdtypes.rst:3653 msgid "\\(2)" msgstr "\\(2)" @@ -175,14 +175,14 @@ msgstr "``not x``" msgid "if *x* is false, then ``True``, else ``False``" msgstr "*x* yanlışsa, ``True``, aksi halde ``False``" -#: library/stdtypes.rst:979 library/stdtypes.rst:2433 library/stdtypes.rst:2437 -#: library/stdtypes.rst:3651 library/stdtypes.rst:3655 -#: library/stdtypes.rst:3657 +#: library/stdtypes.rst:979 library/stdtypes.rst:2436 library/stdtypes.rst:2440 +#: library/stdtypes.rst:3655 library/stdtypes.rst:3659 +#: library/stdtypes.rst:3661 msgid "\\(3)" msgstr "\\(3)" -#: library/stdtypes.rst:320 library/stdtypes.rst:1016 library/stdtypes.rst:2465 -#: library/stdtypes.rst:3687 +#: library/stdtypes.rst:320 library/stdtypes.rst:1016 library/stdtypes.rst:2468 +#: library/stdtypes.rst:3691 msgid "Notes:" msgstr "Notlar:" @@ -233,8 +233,8 @@ msgstr "" msgid "This table summarizes the comparison operations:" msgstr "Bu tablo karşılaştırma operatörlerini özetlemektedir:" -#: library/stdtypes.rst:2396 library/stdtypes.rst:3614 -#: library/stdtypes.rst:3637 +#: library/stdtypes.rst:2399 library/stdtypes.rst:3618 +#: library/stdtypes.rst:3641 msgid "Meaning" msgstr "Anlamı" @@ -368,15 +368,16 @@ msgid "Numeric Types --- :class:`int`, :class:`float`, :class:`complex`" msgstr "Sayısal Türler --- :class:`int`, :class:`float`, :class:`complex`" #: library/stdtypes.rst:216 +#, fuzzy msgid "" -"There are three distinct numeric types: :dfn:`integers`, :dfn:`floating " +"There are three distinct numeric types: :dfn:`integers`, :dfn:`floating-" "point numbers`, and :dfn:`complex numbers`. In addition, Booleans are a " -"subtype of integers. Integers have unlimited precision. Floating point " +"subtype of integers. Integers have unlimited precision. Floating-point " "numbers are usually implemented using :c:expr:`double` in C; information " -"about the precision and internal representation of floating point numbers " +"about the precision and internal representation of floating-point numbers " "for the machine on which your program is running is available in :data:`sys." "float_info`. Complex numbers have a real and imaginary part, which are each " -"a floating point number. To extract these parts from a complex number *z*, " +"a floating-point number. To extract these parts from a complex number *z*, " "use ``z.real`` and ``z.imag``. (The standard library includes the additional " "numeric types :mod:`fractions.Fraction`, for rationals, and :mod:`decimal." "Decimal`, for floating-point numbers with user-definable precision.)" @@ -394,11 +395,12 @@ msgstr "" "sayılar için :mod:`decimal.Decimal` ek sayısal türlerini içerir.)" #: library/stdtypes.rst:238 +#, fuzzy msgid "" "Numbers are created by numeric literals or as the result of built-in " "functions and operators. Unadorned integer literals (including hex, octal " "and binary numbers) yield integers. Numeric literals containing a decimal " -"point or an exponent sign yield floating point numbers. Appending ``'j'`` " +"point or an exponent sign yield floating-point numbers. Appending ``'j'`` " "or ``'J'`` to a numeric literal yields an imaginary number (a complex number " "with a zero real part) which you can add to an integer or float to get a " "complex number with real and imaginary parts." @@ -572,7 +574,7 @@ msgstr "" "gerçek kısmı *re*, sanal kısmı *im* olan bir karmaşık sayı. *im* varsayılan " "olarak sıfırdır." -#: library/stdtypes.rst:1202 library/stdtypes.rst:3674 +#: library/stdtypes.rst:1202 library/stdtypes.rst:3678 msgid "\\(6)" msgstr "\\(6)" @@ -608,8 +610,8 @@ msgstr "``pow(x, y)``" msgid "*x* to the power *y*" msgstr "*x* üzeri *y*" -#: library/stdtypes.rst:313 library/stdtypes.rst:1194 library/stdtypes.rst:2455 -#: library/stdtypes.rst:3670 library/stdtypes.rst:3677 +#: library/stdtypes.rst:313 library/stdtypes.rst:1194 library/stdtypes.rst:2458 +#: library/stdtypes.rst:3674 library/stdtypes.rst:3681 msgid "\\(5)" msgstr "\\(5)" @@ -782,8 +784,8 @@ msgstr "``x | y``" msgid "bitwise :dfn:`or` of *x* and *y*" msgstr "bit düzeyinde *x* :dfn:`or` *y*" -#: library/stdtypes.rst:421 library/stdtypes.rst:1215 library/stdtypes.rst:2445 -#: library/stdtypes.rst:3663 +#: library/stdtypes.rst:421 library/stdtypes.rst:1215 library/stdtypes.rst:2448 +#: library/stdtypes.rst:3667 msgid "\\(4)" msgstr "\\(4)" @@ -1581,7 +1583,7 @@ msgstr "" "*x* 'in *s* içindeki ilk görüldüğü dizini (*i* dizininde veya sonrasında ve " "*j* dizininden önce)" -#: library/stdtypes.rst:3645 +#: library/stdtypes.rst:3649 msgid "\\(8)" msgstr "\\(8)" @@ -1954,7 +1956,10 @@ msgid "reverses the items of *s* in place" msgstr "*s* 'nin öğelerini yerinde tersine çevirir" #: library/stdtypes.rst:1223 -msgid "*t* must have the same length as the slice it is replacing." +#, fuzzy +msgid "" +"If *k* is not equal to ``1``, *t* must have the same length as the slice it " +"is replacing." msgstr "*t*, değiştirdiği dilimle aynı uzunlukta olmalıdır." #: library/stdtypes.rst:1226 @@ -2432,7 +2437,7 @@ msgstr "" msgid "" "The `linspace recipe `_ shows how to implement a lazy version of range " -"suitable for floating point applications." +"suitable for floating-point applications." msgstr "" "`Linspace tarifi `_ , kayan " "nokta uygulamaları için uygun olan tembel bir aralığın nasıl uygulanacağını " @@ -2724,7 +2729,7 @@ msgstr "" msgid "Return the string encoded to :class:`bytes`." msgstr "" -#: library/stdtypes.rst:2811 +#: library/stdtypes.rst:2814 msgid "" "*encoding* defaults to ``'utf-8'``; see :ref:`standard-encodings` for " "possible values." @@ -2752,11 +2757,11 @@ msgid "" "ref:`debug build ` is used." msgstr "" -#: library/stdtypes.rst:2830 +#: library/stdtypes.rst:2833 msgid "Added support for keyword arguments." msgstr "" -#: library/stdtypes.rst:2833 +#: library/stdtypes.rst:2836 msgid "" "The value of the *errors* argument is now checked in :ref:`devmode` and in :" "ref:`debug mode `." @@ -3295,12 +3300,14 @@ msgstr "" "sınırlama yoktur (tüm olası bölmeler yapılır)." #: library/stdtypes.rst:2092 +#, fuzzy msgid "" "If *sep* is given, consecutive delimiters are not grouped together and are " "deemed to delimit empty strings (for example, ``'1,,2'.split(',')`` returns " "``['1', '', '2']``). The *sep* argument may consist of multiple characters " -"(for example, ``'1<>2<>3'.split('<>')`` returns ``['1', '2', '3']``). " -"Splitting an empty string with a specified separator returns ``['']``." +"as a single delimiter (to split with multiple delimiters, use :func:`re." +"split`). Splitting an empty string with a specified separator returns " +"``['']``." msgstr "" "*sep* verilirse, ardışık sınırlayıcılar birlikte gruplanmaz ve boş dizeleri " "sınırladıkları kabul edilir (örneğin, ``'1,,2'.split(',')``, ``['1', '', " @@ -3308,15 +3315,15 @@ msgstr "" "(örneğin, ``'1<>2<>3'.split('<>')``, ``['1', '2', '3']`` döndürür). Boş bir " "dizeyi belirtilen bir ayırıcıyla bölmek ``['']`` döndürür." -#: library/stdtypes.rst:2114 library/stdtypes.rst:2234 -#: library/stdtypes.rst:3149 library/stdtypes.rst:3256 -#: library/stdtypes.rst:3297 library/stdtypes.rst:3339 -#: library/stdtypes.rst:3371 library/stdtypes.rst:3421 -#: library/stdtypes.rst:3490 library/stdtypes.rst:3514 +#: library/stdtypes.rst:2117 library/stdtypes.rst:2237 +#: library/stdtypes.rst:3151 library/stdtypes.rst:3260 +#: library/stdtypes.rst:3301 library/stdtypes.rst:3343 +#: library/stdtypes.rst:3375 library/stdtypes.rst:3425 +#: library/stdtypes.rst:3494 library/stdtypes.rst:3518 msgid "For example::" msgstr "Örneğin: ::" -#: library/stdtypes.rst:2107 +#: library/stdtypes.rst:2110 msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " "applied: runs of consecutive whitespace are regarded as a single separator, " @@ -3331,7 +3338,7 @@ msgstr "" "dizeler olmaz. Dolayısıyla, boş bir dizeyi veya sadece beyaz boşluktan " "oluşan bir dizeyi ``None`` ayırıcısıyla bölmek ``[]`` döndürür." -#: library/stdtypes.rst:2129 +#: library/stdtypes.rst:2132 msgid "" "Return a list of the lines in the string, breaking at line boundaries. Line " "breaks are not included in the resulting list unless *keepends* is given and " @@ -3341,7 +3348,7 @@ msgstr "" "Satır sonları için *keepends* belirtilmediği ve true değerinde olmadığı " "sürece, satır sonları sonuç listesine dahil edilmez." -#: library/stdtypes.rst:2133 +#: library/stdtypes.rst:2136 msgid "" "This method splits on the following line boundaries. In particular, the " "boundaries are a superset of :term:`universal newlines`." @@ -3349,107 +3356,107 @@ msgstr "" "Bu yöntem aşağıdaki satır sınırlarında bölme yapar. Spesifik olarak, " "sınırlar :term:`universal newlines` 'ın bir üst kümesidir." -#: library/stdtypes.rst:2137 +#: library/stdtypes.rst:2140 msgid "Representation" msgstr "Temsil" -#: library/stdtypes.rst:2137 +#: library/stdtypes.rst:2140 msgid "Description" msgstr "Açıklama" -#: library/stdtypes.rst:2139 +#: library/stdtypes.rst:2142 msgid "``\\n``" msgstr "``\\n``" -#: library/stdtypes.rst:2139 +#: library/stdtypes.rst:2142 msgid "Line Feed" msgstr "Satır Atlama" -#: library/stdtypes.rst:2141 +#: library/stdtypes.rst:2144 msgid "``\\r``" msgstr "``\\r``" -#: library/stdtypes.rst:2141 +#: library/stdtypes.rst:2144 msgid "Carriage Return" msgstr "Satır Başına Alma" -#: library/stdtypes.rst:2143 +#: library/stdtypes.rst:2146 msgid "``\\r\\n``" msgstr "``\\r\\n``" -#: library/stdtypes.rst:2143 +#: library/stdtypes.rst:2146 msgid "Carriage Return + Line Feed" msgstr "Satır Başına Alma + Satır Atlama" -#: library/stdtypes.rst:2145 +#: library/stdtypes.rst:2148 msgid "``\\v`` or ``\\x0b``" msgstr "``\\v`` or ``\\x0b``" -#: library/stdtypes.rst:2145 +#: library/stdtypes.rst:2148 msgid "Line Tabulation" msgstr "Satır Tablolama" -#: library/stdtypes.rst:2147 +#: library/stdtypes.rst:2150 msgid "``\\f`` or ``\\x0c``" msgstr "``\\f`` or ``\\x0c``" -#: library/stdtypes.rst:2147 +#: library/stdtypes.rst:2150 msgid "Form Feed" msgstr "Form Besleme" -#: library/stdtypes.rst:2149 +#: library/stdtypes.rst:2152 msgid "``\\x1c``" msgstr "``\\x1c``" -#: library/stdtypes.rst:2149 +#: library/stdtypes.rst:2152 msgid "File Separator" msgstr "Dosya Ayırıcı" -#: library/stdtypes.rst:2151 +#: library/stdtypes.rst:2154 msgid "``\\x1d``" msgstr "``\\x1d``" -#: library/stdtypes.rst:2151 +#: library/stdtypes.rst:2154 msgid "Group Separator" msgstr "Grup Ayırıcı" -#: library/stdtypes.rst:2153 +#: library/stdtypes.rst:2156 msgid "``\\x1e``" msgstr "``\\x1e``" -#: library/stdtypes.rst:2153 +#: library/stdtypes.rst:2156 msgid "Record Separator" msgstr "Kayıt Ayırıcı" -#: library/stdtypes.rst:2155 +#: library/stdtypes.rst:2158 msgid "``\\x85``" msgstr "``\\x85``" -#: library/stdtypes.rst:2155 +#: library/stdtypes.rst:2158 msgid "Next Line (C1 Control Code)" msgstr "Yeni Satır (C1 Denetim Kodu)" -#: library/stdtypes.rst:2157 +#: library/stdtypes.rst:2160 msgid "``\\u2028``" msgstr "``\\u2028``" -#: library/stdtypes.rst:2157 +#: library/stdtypes.rst:2160 msgid "Line Separator" msgstr "Satır Ayrıcı" -#: library/stdtypes.rst:2159 +#: library/stdtypes.rst:2162 msgid "``\\u2029``" msgstr "``\\u2029``" -#: library/stdtypes.rst:2159 +#: library/stdtypes.rst:2162 msgid "Paragraph Separator" msgstr "Paragraf Ayırıcı" -#: library/stdtypes.rst:2164 +#: library/stdtypes.rst:2167 msgid "``\\v`` and ``\\f`` added to list of line boundaries." msgstr "``\\v`` ve ``\\f`` satır sınırlarına eklenir." -#: library/stdtypes.rst:2173 +#: library/stdtypes.rst:2176 msgid "" "Unlike :meth:`~str.split` when a delimiter string *sep* is given, this " "method returns an empty list for the empty string, and a terminal line break " @@ -3459,11 +3466,11 @@ msgstr "" "farklı olarak, bu yöntem boş dize için boş bir liste döndürür ve bir " "terminal satır sonu fazladan bir satır ile sonuçlanmaz::" -#: library/stdtypes.rst:2182 +#: library/stdtypes.rst:2185 msgid "For comparison, ``split('\\n')`` gives::" msgstr "Kıyaslayacak olursak ``split(‘\\n’)`` şu değeri verir::" -#: library/stdtypes.rst:2192 +#: library/stdtypes.rst:2195 msgid "" "Return ``True`` if string starts with the *prefix*, otherwise return " "``False``. *prefix* can also be a tuple of prefixes to look for. With " @@ -3475,7 +3482,7 @@ msgstr "" "İsteğe bağlı *start* ile, o konumdan başlayan dizeyi sınar. İsteğe bağlı " "*end* ile, dizeyi o konumda karşılaştırmayı durdurur." -#: library/stdtypes.rst:2200 +#: library/stdtypes.rst:2203 msgid "" "Return a copy of the string with the leading and trailing characters " "removed. The *chars* argument is a string specifying the set of characters " @@ -3490,7 +3497,7 @@ msgstr "" "veya son ek değildir; bunun yerine, değerlerinin tüm kombinasyonları " "çıkarılır::" -#: library/stdtypes.rst:2211 +#: library/stdtypes.rst:2214 msgid "" "The outermost leading and trailing *chars* argument values are stripped from " "the string. Characters are removed from the leading end until reaching a " @@ -3502,7 +3509,7 @@ msgstr "" "karakterine ulaşılana kadar önde gelen uçtan çıkarılır. Benzer bir işlem son " "uçta da gerçekleşir. Örneğin::" -#: library/stdtypes.rst:2224 +#: library/stdtypes.rst:2227 msgid "" "Return a copy of the string with uppercase characters converted to lowercase " "and vice versa. Note that it is not necessarily true that ``s.swapcase()." @@ -3512,7 +3519,7 @@ msgstr "" "dizenin bir kopyasını döndürür. ``s.swapcase().swapcase() == s`` ifadesinin " "mutlaka doğru olması gerekmediğine dikkat edin." -#: library/stdtypes.rst:2231 +#: library/stdtypes.rst:2234 msgid "" "Return a titlecased version of the string where words start with an " "uppercase character and the remaining characters are lowercase." @@ -3520,7 +3527,7 @@ msgstr "" "Sözcüklerin büyük harfle başladığı ve kalan karakterlerin küçük harf olduğu " "dizenin başlıklandırılmış bir sürümünü döndürür." -#: library/stdtypes.rst:3458 +#: library/stdtypes.rst:3462 msgid "" "The algorithm uses a simple language-independent definition of a word as " "groups of consecutive letters. The definition works in many contexts but it " @@ -3532,13 +3539,13 @@ msgstr "" "kısaltmalar ve iyeliklerdeki kesme işaretlerinin kelime sınırları " "oluşturduğu anlamına gelir ve bu istenen sonuç olmayabilir::" -#: library/stdtypes.rst:2247 +#: library/stdtypes.rst:2250 msgid "" "The :func:`string.capwords` function does not have this problem, as it " "splits words on spaces only." msgstr "" -#: library/stdtypes.rst:2250 +#: library/stdtypes.rst:2253 #, fuzzy msgid "" "Alternatively, a workaround for apostrophes can be constructed using regular " @@ -3547,7 +3554,7 @@ msgstr "" "Alternatif olarak, kesme işaretleri için geçici bir çözüm düzenli ifadeler " "kullanılarak oluşturulabilir::" -#: library/stdtypes.rst:2265 +#: library/stdtypes.rst:2268 #, fuzzy msgid "" "Return a copy of the string in which each character has been mapped through " @@ -3569,19 +3576,19 @@ msgstr "" "veya karakteri kendisiyle eşlemek için bir :exc:`LookupError` istisnası " "oluşturmak." -#: library/stdtypes.rst:2274 +#: library/stdtypes.rst:2277 msgid "" "You can use :meth:`str.maketrans` to create a translation map from character-" "to-character mappings in different formats." msgstr "" -#: library/stdtypes.rst:2277 +#: library/stdtypes.rst:2280 msgid "" "See also the :mod:`codecs` module for a more flexible approach to custom " "character mappings." msgstr "" -#: library/stdtypes.rst:2283 +#: library/stdtypes.rst:2286 msgid "" "Return a copy of the string with all the cased characters [4]_ converted to " "uppercase. Note that ``s.upper().isupper()`` might be ``False`` if ``s`` " @@ -3590,7 +3597,7 @@ msgid "" "titlecase)." msgstr "" -#: library/stdtypes.rst:2289 +#: library/stdtypes.rst:2292 #, fuzzy msgid "" "The uppercasing algorithm used is `described in section 3.13 'Default Case " @@ -3599,7 +3606,7 @@ msgid "" msgstr "" "Harf büyütme algoritması, Unicode Standardının 3.13 bölümünde açıklanmıştır." -#: library/stdtypes.rst:2296 +#: library/stdtypes.rst:2299 msgid "" "Return a copy of the string left filled with ASCII ``'0'`` digits to make a " "string of length *width*. A leading sign prefix (``'+'``/``'-'``) is handled " @@ -3607,11 +3614,11 @@ msgid "" "original string is returned if *width* is less than or equal to ``len(s)``." msgstr "" -#: library/stdtypes.rst:2314 +#: library/stdtypes.rst:2317 msgid "``printf``-style String Formatting" msgstr "" -#: library/stdtypes.rst:2327 +#: library/stdtypes.rst:2330 msgid "" "The formatting operations described here exhibit a variety of quirks that " "lead to a number of common errors (such as failing to display tuples and " @@ -3622,7 +3629,7 @@ msgid "" "or extensibility." msgstr "" -#: library/stdtypes.rst:2335 +#: library/stdtypes.rst:2338 msgid "" "String objects have one unique built-in operation: the ``%`` operator " "(modulo). This is also known as the string *formatting* or *interpolation* " @@ -3632,7 +3639,7 @@ msgid "" "in the C language." msgstr "" -#: library/stdtypes.rst:2341 +#: library/stdtypes.rst:2344 msgid "" "If *format* requires a single argument, *values* may be a single non-tuple " "object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " @@ -3640,36 +3647,36 @@ msgid "" "example, a dictionary)." msgstr "" -#: library/stdtypes.rst:3569 +#: library/stdtypes.rst:3573 msgid "" "A conversion specifier contains two or more characters and has the following " "components, which must occur in this order:" msgstr "" -#: library/stdtypes.rst:3572 +#: library/stdtypes.rst:3576 msgid "The ``'%'`` character, which marks the start of the specifier." msgstr "" -#: library/stdtypes.rst:3574 +#: library/stdtypes.rst:3578 msgid "" "Mapping key (optional), consisting of a parenthesised sequence of characters " "(for example, ``(somename)``)." msgstr "" -#: library/stdtypes.rst:3577 +#: library/stdtypes.rst:3581 msgid "" "Conversion flags (optional), which affect the result of some conversion " "types." msgstr "" -#: library/stdtypes.rst:3580 +#: library/stdtypes.rst:3584 msgid "" "Minimum field width (optional). If specified as an ``'*'`` (asterisk), the " "actual width is read from the next element of the tuple in *values*, and the " "object to convert comes after the minimum field width and optional precision." msgstr "" -#: library/stdtypes.rst:3584 +#: library/stdtypes.rst:3588 msgid "" "Precision (optional), given as a ``'.'`` (dot) followed by the precision. " "If specified as ``'*'`` (an asterisk), the actual precision is read from the " @@ -3677,15 +3684,15 @@ msgid "" "the precision." msgstr "" -#: library/stdtypes.rst:3589 +#: library/stdtypes.rst:3593 msgid "Length modifier (optional)." msgstr "" -#: library/stdtypes.rst:3591 +#: library/stdtypes.rst:3595 msgid "Conversion type." msgstr "" -#: library/stdtypes.rst:2375 +#: library/stdtypes.rst:2378 msgid "" "When the right argument is a dictionary (or other mapping type), then the " "formats in the string *must* include a parenthesised mapping key into that " @@ -3693,277 +3700,277 @@ msgid "" "selects the value to be formatted from the mapping. For example:" msgstr "" -#: library/stdtypes.rst:3602 +#: library/stdtypes.rst:3606 msgid "" "In this case no ``*`` specifiers may occur in a format (since they require a " "sequential parameter list)." msgstr "" -#: library/stdtypes.rst:3605 +#: library/stdtypes.rst:3609 msgid "The conversion flag characters are:" msgstr "" -#: library/stdtypes.rst:3614 +#: library/stdtypes.rst:3618 msgid "Flag" msgstr "" -#: library/stdtypes.rst:3616 +#: library/stdtypes.rst:3620 msgid "``'#'``" msgstr "" -#: library/stdtypes.rst:3616 +#: library/stdtypes.rst:3620 msgid "" "The value conversion will use the \"alternate form\" (where defined below)." msgstr "" -#: library/stdtypes.rst:3619 +#: library/stdtypes.rst:3623 msgid "``'0'``" msgstr "" -#: library/stdtypes.rst:3619 +#: library/stdtypes.rst:3623 msgid "The conversion will be zero padded for numeric values." msgstr "" -#: library/stdtypes.rst:3621 +#: library/stdtypes.rst:3625 msgid "``'-'``" msgstr "" -#: library/stdtypes.rst:3621 +#: library/stdtypes.rst:3625 msgid "" "The converted value is left adjusted (overrides the ``'0'`` conversion if " "both are given)." msgstr "" -#: library/stdtypes.rst:3624 +#: library/stdtypes.rst:3628 msgid "``' '``" msgstr "" -#: library/stdtypes.rst:3624 +#: library/stdtypes.rst:3628 msgid "" "(a space) A blank should be left before a positive number (or empty string) " "produced by a signed conversion." msgstr "" -#: library/stdtypes.rst:3627 +#: library/stdtypes.rst:3631 msgid "``'+'``" msgstr "" -#: library/stdtypes.rst:3627 +#: library/stdtypes.rst:3631 msgid "" "A sign character (``'+'`` or ``'-'``) will precede the conversion (overrides " "a \"space\" flag)." msgstr "" -#: library/stdtypes.rst:3631 +#: library/stdtypes.rst:3635 msgid "" "A length modifier (``h``, ``l``, or ``L``) may be present, but is ignored as " "it is not necessary for Python -- so e.g. ``%ld`` is identical to ``%d``." msgstr "" -#: library/stdtypes.rst:3634 +#: library/stdtypes.rst:3638 msgid "The conversion types are:" msgstr "" -#: library/stdtypes.rst:3637 +#: library/stdtypes.rst:3641 msgid "Conversion" msgstr "" -#: library/stdtypes.rst:3639 +#: library/stdtypes.rst:3643 msgid "``'d'``" msgstr "" -#: library/stdtypes.rst:2423 library/stdtypes.rst:3641 +#: library/stdtypes.rst:2426 library/stdtypes.rst:3645 msgid "Signed integer decimal." msgstr "" -#: library/stdtypes.rst:3641 +#: library/stdtypes.rst:3645 msgid "``'i'``" msgstr "" -#: library/stdtypes.rst:3643 +#: library/stdtypes.rst:3647 msgid "``'o'``" msgstr "" -#: library/stdtypes.rst:3643 +#: library/stdtypes.rst:3647 msgid "Signed octal value." msgstr "" -#: library/stdtypes.rst:3645 +#: library/stdtypes.rst:3649 msgid "``'u'``" msgstr "" -#: library/stdtypes.rst:3645 +#: library/stdtypes.rst:3649 msgid "Obsolete type -- it is identical to ``'d'``." msgstr "" -#: library/stdtypes.rst:3647 +#: library/stdtypes.rst:3651 msgid "``'x'``" msgstr "" -#: library/stdtypes.rst:3647 +#: library/stdtypes.rst:3651 msgid "Signed hexadecimal (lowercase)." msgstr "" -#: library/stdtypes.rst:3649 +#: library/stdtypes.rst:3653 msgid "``'X'``" msgstr "" -#: library/stdtypes.rst:3649 +#: library/stdtypes.rst:3653 msgid "Signed hexadecimal (uppercase)." msgstr "" -#: library/stdtypes.rst:3651 +#: library/stdtypes.rst:3655 msgid "``'e'``" msgstr "" -#: library/stdtypes.rst:3651 -msgid "Floating point exponential format (lowercase)." +#: library/stdtypes.rst:3655 +msgid "Floating-point exponential format (lowercase)." msgstr "" -#: library/stdtypes.rst:3653 +#: library/stdtypes.rst:3657 msgid "``'E'``" msgstr "" -#: library/stdtypes.rst:3653 -msgid "Floating point exponential format (uppercase)." +#: library/stdtypes.rst:3657 +msgid "Floating-point exponential format (uppercase)." msgstr "" -#: library/stdtypes.rst:3655 +#: library/stdtypes.rst:3659 msgid "``'f'``" msgstr "" -#: library/stdtypes.rst:2439 library/stdtypes.rst:3657 -msgid "Floating point decimal format." +#: library/stdtypes.rst:2442 library/stdtypes.rst:3661 +msgid "Floating-point decimal format." msgstr "" -#: library/stdtypes.rst:3657 +#: library/stdtypes.rst:3661 msgid "``'F'``" msgstr "" -#: library/stdtypes.rst:3659 +#: library/stdtypes.rst:3663 msgid "``'g'``" msgstr "" -#: library/stdtypes.rst:3659 +#: library/stdtypes.rst:3663 msgid "" -"Floating point format. Uses lowercase exponential format if exponent is less " +"Floating-point format. Uses lowercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" -#: library/stdtypes.rst:3663 +#: library/stdtypes.rst:3667 msgid "``'G'``" msgstr "" -#: library/stdtypes.rst:3663 +#: library/stdtypes.rst:3667 msgid "" -"Floating point format. Uses uppercase exponential format if exponent is less " +"Floating-point format. Uses uppercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" -#: library/stdtypes.rst:3667 +#: library/stdtypes.rst:3671 msgid "``'c'``" msgstr "" -#: library/stdtypes.rst:2449 +#: library/stdtypes.rst:2452 msgid "Single character (accepts integer or single character string)." msgstr "" -#: library/stdtypes.rst:3680 +#: library/stdtypes.rst:3684 msgid "``'r'``" msgstr "" -#: library/stdtypes.rst:2452 +#: library/stdtypes.rst:2455 msgid "String (converts any Python object using :func:`repr`)." msgstr "" -#: library/stdtypes.rst:3674 +#: library/stdtypes.rst:3678 msgid "``'s'``" msgstr "" -#: library/stdtypes.rst:2455 +#: library/stdtypes.rst:2458 msgid "String (converts any Python object using :func:`str`)." msgstr "" -#: library/stdtypes.rst:3677 +#: library/stdtypes.rst:3681 msgid "``'a'``" msgstr "" -#: library/stdtypes.rst:2458 +#: library/stdtypes.rst:2461 msgid "String (converts any Python object using :func:`ascii`)." msgstr "" -#: library/stdtypes.rst:3683 +#: library/stdtypes.rst:3687 msgid "``'%'``" msgstr "" -#: library/stdtypes.rst:3683 +#: library/stdtypes.rst:3687 msgid "No argument is converted, results in a ``'%'`` character in the result." msgstr "" -#: library/stdtypes.rst:3690 +#: library/stdtypes.rst:3694 msgid "" "The alternate form causes a leading octal specifier (``'0o'``) to be " "inserted before the first digit." msgstr "" -#: library/stdtypes.rst:3694 +#: library/stdtypes.rst:3698 msgid "" "The alternate form causes a leading ``'0x'`` or ``'0X'`` (depending on " "whether the ``'x'`` or ``'X'`` format was used) to be inserted before the " "first digit." msgstr "" -#: library/stdtypes.rst:3698 +#: library/stdtypes.rst:3702 msgid "" "The alternate form causes the result to always contain a decimal point, even " "if no digits follow it." msgstr "" -#: library/stdtypes.rst:3701 +#: library/stdtypes.rst:3705 msgid "" "The precision determines the number of digits after the decimal point and " "defaults to 6." msgstr "" -#: library/stdtypes.rst:3705 +#: library/stdtypes.rst:3709 msgid "" "The alternate form causes the result to always contain a decimal point, and " "trailing zeroes are not removed as they would otherwise be." msgstr "" -#: library/stdtypes.rst:3708 +#: library/stdtypes.rst:3712 msgid "" "The precision determines the number of significant digits before and after " "the decimal point and defaults to 6." msgstr "" -#: library/stdtypes.rst:3712 +#: library/stdtypes.rst:3716 msgid "If precision is ``N``, the output is truncated to ``N`` characters." msgstr "" -#: library/stdtypes.rst:3721 +#: library/stdtypes.rst:3725 msgid "See :pep:`237`." msgstr "" -#: library/stdtypes.rst:2495 +#: library/stdtypes.rst:2498 msgid "" "Since Python strings have an explicit length, ``%s`` conversions do not " "assume that ``'\\0'`` is the end of the string." msgstr "" -#: library/stdtypes.rst:2500 +#: library/stdtypes.rst:2503 msgid "" "``%f`` conversions for numbers whose absolute value is over 1e50 are no " "longer replaced by ``%g`` conversions." msgstr "" -#: library/stdtypes.rst:2511 +#: library/stdtypes.rst:2514 msgid "" "Binary Sequence Types --- :class:`bytes`, :class:`bytearray`, :class:" "`memoryview`" msgstr "" -#: library/stdtypes.rst:2519 +#: library/stdtypes.rst:2522 msgid "" "The core built-in types for manipulating binary data are :class:`bytes` and :" "class:`bytearray`. They are supported by :class:`memoryview` which uses the :" @@ -3971,17 +3978,17 @@ msgid "" "objects without needing to make a copy." msgstr "" -#: library/stdtypes.rst:2524 +#: library/stdtypes.rst:2527 msgid "" "The :mod:`array` module supports efficient storage of basic data types like " "32-bit integers and IEEE754 double-precision floating values." msgstr "" -#: library/stdtypes.rst:2530 +#: library/stdtypes.rst:2533 msgid "Bytes Objects" msgstr "" -#: library/stdtypes.rst:2534 +#: library/stdtypes.rst:2537 msgid "" "Bytes objects are immutable sequences of single bytes. Since many major " "binary protocols are based on the ASCII text encoding, bytes objects offer " @@ -3989,41 +3996,41 @@ msgid "" "and are closely related to string objects in a variety of other ways." msgstr "" -#: library/stdtypes.rst:2541 +#: library/stdtypes.rst:2544 msgid "" "Firstly, the syntax for bytes literals is largely the same as that for " "string literals, except that a ``b`` prefix is added:" msgstr "" -#: library/stdtypes.rst:2544 +#: library/stdtypes.rst:2547 msgid "Single quotes: ``b'still allows embedded \"double\" quotes'``" msgstr "" -#: library/stdtypes.rst:2545 +#: library/stdtypes.rst:2548 #, fuzzy msgid "Double quotes: ``b\"still allows embedded 'single' quotes\"``" msgstr "Çift tırnak: ``b\"katıştırılmış 'tek' tırnaklara izin verir\"``" -#: library/stdtypes.rst:2546 +#: library/stdtypes.rst:2549 msgid "" "Triple quoted: ``b'''3 single quotes'''``, ``b\"\"\"3 double quotes\"\"\"``" msgstr "" -#: library/stdtypes.rst:2548 +#: library/stdtypes.rst:2551 msgid "" "Only ASCII characters are permitted in bytes literals (regardless of the " "declared source code encoding). Any binary values over 127 must be entered " "into bytes literals using the appropriate escape sequence." msgstr "" -#: library/stdtypes.rst:2552 +#: library/stdtypes.rst:2555 msgid "" "As with string literals, bytes literals may also use a ``r`` prefix to " "disable processing of escape sequences. See :ref:`strings` for more about " "the various forms of bytes literal, including supported escape sequences." msgstr "" -#: library/stdtypes.rst:2556 +#: library/stdtypes.rst:2559 msgid "" "While bytes literals and representations are based on ASCII text, bytes " "objects actually behave like immutable sequences of integers, with each " @@ -4036,29 +4043,29 @@ msgid "" "compatible will usually lead to data corruption)." msgstr "" -#: library/stdtypes.rst:2566 +#: library/stdtypes.rst:2569 msgid "" "In addition to the literal forms, bytes objects can be created in a number " "of other ways:" msgstr "" -#: library/stdtypes.rst:2569 +#: library/stdtypes.rst:2572 msgid "A zero-filled bytes object of a specified length: ``bytes(10)``" msgstr "" -#: library/stdtypes.rst:2570 +#: library/stdtypes.rst:2573 msgid "From an iterable of integers: ``bytes(range(20))``" msgstr "" -#: library/stdtypes.rst:2571 +#: library/stdtypes.rst:2574 msgid "Copying existing binary data via the buffer protocol: ``bytes(obj)``" msgstr "" -#: library/stdtypes.rst:2573 +#: library/stdtypes.rst:2576 msgid "Also see the :ref:`bytes ` built-in." msgstr "" -#: library/stdtypes.rst:2575 +#: library/stdtypes.rst:2578 msgid "" "Since 2 hexadecimal digits correspond precisely to a single byte, " "hexadecimal numbers are a commonly used format for describing binary data. " @@ -4066,32 +4073,32 @@ msgid "" "that format:" msgstr "" -#: library/stdtypes.rst:2581 +#: library/stdtypes.rst:2584 msgid "" "This :class:`bytes` class method returns a bytes object, decoding the given " "string object. The string must contain two hexadecimal digits per byte, " "with ASCII whitespace being ignored." msgstr "" -#: library/stdtypes.rst:2588 +#: library/stdtypes.rst:2591 msgid "" ":meth:`bytes.fromhex` now skips all ASCII whitespace in the string, not just " "spaces." msgstr "" -#: library/stdtypes.rst:2592 +#: library/stdtypes.rst:2595 msgid "" "A reverse conversion function exists to transform a bytes object into its " "hexadecimal representation." msgstr "" -#: library/stdtypes.rst:2682 +#: library/stdtypes.rst:2685 msgid "" "Return a string object containing two hexadecimal digits for each byte in " "the instance." msgstr "" -#: library/stdtypes.rst:2603 +#: library/stdtypes.rst:2606 msgid "" "If you want to make the hex string easier to read, you can specify a single " "character separator *sep* parameter to include in the output. By default, " @@ -4100,13 +4107,13 @@ msgid "" "the separator position from the right, negative values from the left." msgstr "" -#: library/stdtypes.rst:2620 +#: library/stdtypes.rst:2623 msgid "" ":meth:`bytes.hex` now supports optional *sep* and *bytes_per_sep* parameters " "to insert separators between bytes in the hex output." msgstr "" -#: library/stdtypes.rst:2624 +#: library/stdtypes.rst:2627 msgid "" "Since bytes objects are sequences of integers (akin to a tuple), for a bytes " "object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be a bytes " @@ -4114,58 +4121,58 @@ msgid "" "and slicing will produce a string of length 1)" msgstr "" -#: library/stdtypes.rst:2629 +#: library/stdtypes.rst:2632 msgid "" "The representation of bytes objects uses the literal format (``b'...'``) " "since it is often more useful than e.g. ``bytes([46, 46, 46])``. You can " "always convert a bytes object into a list of integers using ``list(b)``." msgstr "" -#: library/stdtypes.rst:2637 +#: library/stdtypes.rst:2640 msgid "Bytearray Objects" msgstr "" -#: library/stdtypes.rst:2641 +#: library/stdtypes.rst:2644 msgid "" ":class:`bytearray` objects are a mutable counterpart to :class:`bytes` " "objects." msgstr "" -#: library/stdtypes.rst:2646 +#: library/stdtypes.rst:2649 msgid "" "There is no dedicated literal syntax for bytearray objects, instead they are " "always created by calling the constructor:" msgstr "" -#: library/stdtypes.rst:2649 +#: library/stdtypes.rst:2652 msgid "Creating an empty instance: ``bytearray()``" msgstr "" -#: library/stdtypes.rst:2650 +#: library/stdtypes.rst:2653 msgid "Creating a zero-filled instance with a given length: ``bytearray(10)``" msgstr "" -#: library/stdtypes.rst:2651 +#: library/stdtypes.rst:2654 msgid "From an iterable of integers: ``bytearray(range(20))``" msgstr "" -#: library/stdtypes.rst:2652 +#: library/stdtypes.rst:2655 msgid "" "Copying existing binary data via the buffer protocol: ``bytearray(b'Hi!')``" msgstr "" -#: library/stdtypes.rst:2654 +#: library/stdtypes.rst:2657 msgid "" "As bytearray objects are mutable, they support the :ref:`mutable ` sequence operations in addition to the common bytes and bytearray " "operations described in :ref:`bytes-methods`." msgstr "" -#: library/stdtypes.rst:2658 +#: library/stdtypes.rst:2661 msgid "Also see the :ref:`bytearray ` built-in." msgstr "" -#: library/stdtypes.rst:2660 +#: library/stdtypes.rst:2663 msgid "" "Since 2 hexadecimal digits correspond precisely to a single byte, " "hexadecimal numbers are a commonly used format for describing binary data. " @@ -4173,33 +4180,33 @@ msgid "" "in that format:" msgstr "" -#: library/stdtypes.rst:2666 +#: library/stdtypes.rst:2669 msgid "" "This :class:`bytearray` class method returns bytearray object, decoding the " "given string object. The string must contain two hexadecimal digits per " "byte, with ASCII whitespace being ignored." msgstr "" -#: library/stdtypes.rst:2673 +#: library/stdtypes.rst:2676 msgid "" ":meth:`bytearray.fromhex` now skips all ASCII whitespace in the string, not " "just spaces." msgstr "" -#: library/stdtypes.rst:2677 +#: library/stdtypes.rst:2680 msgid "" "A reverse conversion function exists to transform a bytearray object into " "its hexadecimal representation." msgstr "" -#: library/stdtypes.rst:2690 +#: library/stdtypes.rst:2693 msgid "" "Similar to :meth:`bytes.hex`, :meth:`bytearray.hex` now supports optional " "*sep* and *bytes_per_sep* parameters to insert separators between bytes in " "the hex output." msgstr "" -#: library/stdtypes.rst:2695 +#: library/stdtypes.rst:2698 msgid "" "Since bytearray objects are sequences of integers (akin to a list), for a " "bytearray object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be " @@ -4207,7 +4214,7 @@ msgid "" "both indexing and slicing will produce a string of length 1)" msgstr "" -#: library/stdtypes.rst:2700 +#: library/stdtypes.rst:2703 msgid "" "The representation of bytearray objects uses the bytes literal format " "(``bytearray(b'...')``) since it is often more useful than e.g. " @@ -4215,11 +4222,11 @@ msgid "" "a list of integers using ``list(b)``." msgstr "" -#: library/stdtypes.rst:2709 +#: library/stdtypes.rst:2712 msgid "Bytes and Bytearray Operations" msgstr "" -#: library/stdtypes.rst:2714 +#: library/stdtypes.rst:2717 msgid "" "Both bytes and bytearray objects support the :ref:`common ` " "sequence operations. They interoperate not just with operands of the same " @@ -4228,98 +4235,98 @@ msgid "" "return type of the result may depend on the order of operands." msgstr "" -#: library/stdtypes.rst:2722 +#: library/stdtypes.rst:2725 msgid "" "The methods on bytes and bytearray objects don't accept strings as their " "arguments, just as the methods on strings don't accept bytes as their " "arguments. For example, you have to write::" msgstr "" -#: library/stdtypes.rst:2729 +#: library/stdtypes.rst:2732 msgid "and::" msgstr "" -#: library/stdtypes.rst:2734 +#: library/stdtypes.rst:2737 msgid "" "Some bytes and bytearray operations assume the use of ASCII compatible " "binary formats, and hence should be avoided when working with arbitrary " "binary data. These restrictions are covered below." msgstr "" -#: library/stdtypes.rst:2739 +#: library/stdtypes.rst:2742 msgid "" "Using these ASCII based operations to manipulate binary data that is not " "stored in an ASCII based format may lead to data corruption." msgstr "" -#: library/stdtypes.rst:2742 +#: library/stdtypes.rst:2745 msgid "" "The following methods on bytes and bytearray objects can be used with " "arbitrary binary data." msgstr "" -#: library/stdtypes.rst:2748 +#: library/stdtypes.rst:2751 msgid "" "Return the number of non-overlapping occurrences of subsequence *sub* in the " "range [*start*, *end*]. Optional arguments *start* and *end* are " "interpreted as in slice notation." msgstr "" -#: library/stdtypes.rst:2857 library/stdtypes.rst:2945 -#: library/stdtypes.rst:2958 +#: library/stdtypes.rst:2860 library/stdtypes.rst:2948 +#: library/stdtypes.rst:2961 msgid "" "The subsequence to search for may be any :term:`bytes-like object` or an " "integer in the range 0 to 255." msgstr "" -#: library/stdtypes.rst:2755 +#: library/stdtypes.rst:2758 msgid "" "If *sub* is empty, returns the number of empty slices between characters " "which is the length of the bytes object plus one." msgstr "" -#: library/stdtypes.rst:2869 library/stdtypes.rst:2948 -#: library/stdtypes.rst:2961 +#: library/stdtypes.rst:2872 library/stdtypes.rst:2951 +#: library/stdtypes.rst:2964 msgid "Also accept an integer in the range 0 to 255 as the subsequence." msgstr "" -#: library/stdtypes.rst:2765 +#: library/stdtypes.rst:2768 msgid "" "If the binary data starts with the *prefix* string, return " "``bytes[len(prefix):]``. Otherwise, return a copy of the original binary " "data::" msgstr "" -#: library/stdtypes.rst:2774 +#: library/stdtypes.rst:2777 msgid "The *prefix* may be any :term:`bytes-like object`." msgstr "" -#: library/stdtypes.rst:2800 library/stdtypes.rst:3026 -#: library/stdtypes.rst:3071 library/stdtypes.rst:3127 -#: library/stdtypes.rst:3215 library/stdtypes.rst:3382 -#: library/stdtypes.rst:3480 library/stdtypes.rst:3523 -#: library/stdtypes.rst:3725 +#: library/stdtypes.rst:2803 library/stdtypes.rst:3029 +#: library/stdtypes.rst:3074 library/stdtypes.rst:3130 +#: library/stdtypes.rst:3219 library/stdtypes.rst:3386 +#: library/stdtypes.rst:3484 library/stdtypes.rst:3527 +#: library/stdtypes.rst:3729 msgid "" "The bytearray version of this method does *not* operate in place - it always " "produces a new object, even if no changes were made." msgstr "" -#: library/stdtypes.rst:2787 +#: library/stdtypes.rst:2790 msgid "" "If the binary data ends with the *suffix* string and that *suffix* is not " "empty, return ``bytes[:-len(suffix)]``. Otherwise, return a copy of the " "original binary data::" msgstr "" -#: library/stdtypes.rst:2796 +#: library/stdtypes.rst:2799 msgid "The *suffix* may be any :term:`bytes-like object`." msgstr "" -#: library/stdtypes.rst:2809 +#: library/stdtypes.rst:2812 msgid "Return the bytes decoded to a :class:`str`." msgstr "" -#: library/stdtypes.rst:2814 +#: library/stdtypes.rst:2817 msgid "" "*errors* controls how decoding errors are handled. If ``'strict'`` (the " "default), a :exc:`UnicodeError` exception is raised. Other possible values " @@ -4327,21 +4334,21 @@ msgid "" "`codecs.register_error`. See :ref:`error-handlers` for details." msgstr "" -#: library/stdtypes.rst:2820 +#: library/stdtypes.rst:2823 msgid "" "For performance reasons, the value of *errors* is not checked for validity " "unless a decoding error actually occurs, :ref:`devmode` is enabled or a :ref:" "`debug build ` is used." msgstr "" -#: library/stdtypes.rst:2826 +#: library/stdtypes.rst:2829 msgid "" "Passing the *encoding* argument to :class:`str` allows decoding any :term:" "`bytes-like object` directly, without needing to make a temporary :class:`!" "bytes` or :class:`!bytearray` object." msgstr "" -#: library/stdtypes.rst:2841 +#: library/stdtypes.rst:2844 msgid "" "Return ``True`` if the binary data ends with the specified *suffix*, " "otherwise return ``False``. *suffix* can also be a tuple of suffixes to " @@ -4349,11 +4356,11 @@ msgid "" "optional *end*, stop comparing at that position." msgstr "" -#: library/stdtypes.rst:2846 +#: library/stdtypes.rst:2849 msgid "The suffix(es) to search for may be any :term:`bytes-like object`." msgstr "" -#: library/stdtypes.rst:2852 +#: library/stdtypes.rst:2855 msgid "" "Return the lowest index in the data where the subsequence *sub* is found, " "such that *sub* is contained in the slice ``s[start:end]``. Optional " @@ -4361,20 +4368,20 @@ msgid "" "``-1`` if *sub* is not found." msgstr "" -#: library/stdtypes.rst:2862 +#: library/stdtypes.rst:2865 msgid "" "The :meth:`~bytes.find` method should be used only if you need to know the " "position of *sub*. To check if *sub* is a substring or not, use the :" "keyword:`in` operator::" msgstr "" -#: library/stdtypes.rst:2876 +#: library/stdtypes.rst:2879 msgid "" "Like :meth:`~bytes.find`, but raise :exc:`ValueError` when the subsequence " "is not found." msgstr "" -#: library/stdtypes.rst:2889 +#: library/stdtypes.rst:2892 msgid "" "Return a bytes or bytearray object which is the concatenation of the binary " "data sequences in *iterable*. A :exc:`TypeError` will be raised if there " @@ -4384,7 +4391,7 @@ msgid "" "method." msgstr "" -#: library/stdtypes.rst:2900 +#: library/stdtypes.rst:2903 msgid "" "This static method returns a translation table usable for :meth:`bytes." "translate` that will map each character in *from* into the character at the " @@ -4392,7 +4399,7 @@ msgid "" "objects ` and have the same length." msgstr "" -#: library/stdtypes.rst:2911 +#: library/stdtypes.rst:2914 msgid "" "Split the sequence at the first occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself or its " @@ -4401,24 +4408,24 @@ msgid "" "by two empty bytes or bytearray objects." msgstr "" -#: library/stdtypes.rst:2975 +#: library/stdtypes.rst:2978 msgid "The separator to search for may be any :term:`bytes-like object`." msgstr "" -#: library/stdtypes.rst:2924 +#: library/stdtypes.rst:2927 msgid "" "Return a copy of the sequence with all occurrences of subsequence *old* " "replaced by *new*. If the optional argument *count* is given, only the " "first *count* occurrences are replaced." msgstr "" -#: library/stdtypes.rst:2928 +#: library/stdtypes.rst:2931 msgid "" "The subsequence to search for and its replacement may be any :term:`bytes-" "like object`." msgstr "" -#: library/stdtypes.rst:2940 +#: library/stdtypes.rst:2943 msgid "" "Return the highest index in the sequence where the subsequence *sub* is " "found, such that *sub* is contained within ``s[start:end]``. Optional " @@ -4426,13 +4433,13 @@ msgid "" "``-1`` on failure." msgstr "" -#: library/stdtypes.rst:2955 +#: library/stdtypes.rst:2958 msgid "" "Like :meth:`~bytes.rfind` but raises :exc:`ValueError` when the subsequence " "*sub* is not found." msgstr "" -#: library/stdtypes.rst:2968 +#: library/stdtypes.rst:2971 msgid "" "Split the sequence at the last occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself or its " @@ -4441,7 +4448,7 @@ msgid "" "followed by a copy of the original sequence." msgstr "" -#: library/stdtypes.rst:2981 +#: library/stdtypes.rst:2984 msgid "" "Return ``True`` if the binary data starts with the specified *prefix*, " "otherwise return ``False``. *prefix* can also be a tuple of prefixes to " @@ -4449,11 +4456,11 @@ msgid "" "optional *end*, stop comparing at that position." msgstr "" -#: library/stdtypes.rst:2986 +#: library/stdtypes.rst:2989 msgid "The prefix(es) to search for may be any :term:`bytes-like object`." msgstr "" -#: library/stdtypes.rst:2992 +#: library/stdtypes.rst:2995 msgid "" "Return a copy of the bytes or bytearray object where all bytes occurring in " "the optional argument *delete* are removed, and the remaining bytes have " @@ -4461,22 +4468,22 @@ msgid "" "object of length 256." msgstr "" -#: library/stdtypes.rst:2997 +#: library/stdtypes.rst:3000 msgid "" "You can use the :func:`bytes.maketrans` method to create a translation table." msgstr "" -#: library/stdtypes.rst:3000 +#: library/stdtypes.rst:3003 msgid "" "Set the *table* argument to ``None`` for translations that only delete " "characters::" msgstr "" -#: library/stdtypes.rst:3006 +#: library/stdtypes.rst:3009 msgid "*delete* is now supported as a keyword argument." msgstr "" -#: library/stdtypes.rst:3010 +#: library/stdtypes.rst:3013 msgid "" "The following methods on bytes and bytearray objects have default behaviours " "that assume the use of ASCII compatible binary formats, but can still be " @@ -4485,7 +4492,7 @@ msgid "" "instead produce new objects." msgstr "" -#: library/stdtypes.rst:3019 +#: library/stdtypes.rst:3022 msgid "" "Return a copy of the object centered in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " @@ -4493,7 +4500,7 @@ msgid "" "less than or equal to ``len(s)``." msgstr "" -#: library/stdtypes.rst:3033 +#: library/stdtypes.rst:3036 msgid "" "Return a copy of the object left justified in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " @@ -4501,7 +4508,7 @@ msgid "" "less than or equal to ``len(s)``." msgstr "" -#: library/stdtypes.rst:3047 +#: library/stdtypes.rst:3050 msgid "" "Return a copy of the sequence with specified leading bytes removed. The " "*chars* argument is a binary sequence specifying the set of byte values to " @@ -4511,14 +4518,14 @@ msgid "" "all combinations of its values are stripped::" msgstr "" -#: library/stdtypes.rst:3059 +#: library/stdtypes.rst:3062 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`. See :meth:`~bytes.removeprefix` for a method that will remove a " "single prefix string rather than all of a set of characters. For example::" msgstr "" -#: library/stdtypes.rst:3078 +#: library/stdtypes.rst:3081 msgid "" "Return a copy of the object right justified in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " @@ -4526,7 +4533,7 @@ msgid "" "less than or equal to ``len(s)``." msgstr "" -#: library/stdtypes.rst:3092 +#: library/stdtypes.rst:3095 msgid "" "Split the binary sequence into subsequences of the same type, using *sep* as " "the delimiter string. If *maxsplit* is given, at most *maxsplit* splits are " @@ -4536,7 +4543,7 @@ msgid "" "described in detail below." msgstr "" -#: library/stdtypes.rst:3103 +#: library/stdtypes.rst:3106 msgid "" "Return a copy of the sequence with specified trailing bytes removed. The " "*chars* argument is a binary sequence specifying the set of byte values to " @@ -4546,14 +4553,14 @@ msgid "" "all combinations of its values are stripped::" msgstr "" -#: library/stdtypes.rst:3115 +#: library/stdtypes.rst:3118 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`. See :meth:`~bytes.removesuffix` for a method that will remove a " "single suffix string rather than all of a set of characters. For example::" msgstr "" -#: library/stdtypes.rst:3134 +#: library/stdtypes.rst:3137 msgid "" "Split the binary sequence into subsequences of the same type, using *sep* as " "the delimiter string. If *maxsplit* is given and non-negative, at most " @@ -4562,18 +4569,24 @@ msgid "" "limit on the number of splits (all possible splits are made)." msgstr "" -#: library/stdtypes.rst:3140 +#: library/stdtypes.rst:3143 +#, fuzzy msgid "" "If *sep* is given, consecutive delimiters are not grouped together and are " "deemed to delimit empty subsequences (for example, ``b'1,,2'.split(b',')`` " "returns ``[b'1', b'', b'2']``). The *sep* argument may consist of a " -"multibyte sequence (for example, ``b'1<>2<>3'.split(b'<>')`` returns " -"``[b'1', b'2', b'3']``). Splitting an empty sequence with a specified " -"separator returns ``[b'']`` or ``[bytearray(b'')]`` depending on the type of " -"object being split. The *sep* argument may be any :term:`bytes-like object`." +"multibyte sequence as a single delimiter. Splitting an empty sequence with a " +"specified separator returns ``[b'']`` or ``[bytearray(b'')]`` depending on " +"the type of object being split. The *sep* argument may be any :term:`bytes-" +"like object`." msgstr "" +"*sep* verilirse, ardışık sınırlayıcılar birlikte gruplanmaz ve boş dizeleri " +"sınırladıkları kabul edilir (örneğin, ``'1,,2'.split(',')``, ``['1', '', " +"'2']`` döndürür). *sep* bağımsız değişkeni birden çok karakterden oluşabilir " +"(örneğin, ``'1<>2<>3'.split('<>')``, ``['1', '2', '3']`` döndürür). Boş bir " +"dizeyi belirtilen bir ayırıcıyla bölmek ``['']`` döndürür." -#: library/stdtypes.rst:3158 +#: library/stdtypes.rst:3162 msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " "applied: runs of consecutive ASCII whitespace are regarded as a single " @@ -4583,7 +4596,7 @@ msgid "" "without a specified separator returns ``[]``." msgstr "" -#: library/stdtypes.rst:3179 +#: library/stdtypes.rst:3183 msgid "" "Return a copy of the sequence with specified leading and trailing bytes " "removed. The *chars* argument is a binary sequence specifying the set of " @@ -4593,13 +4606,13 @@ msgid "" "a prefix or suffix; rather, all combinations of its values are stripped::" msgstr "" -#: library/stdtypes.rst:3192 +#: library/stdtypes.rst:3196 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`." msgstr "" -#: library/stdtypes.rst:3201 +#: library/stdtypes.rst:3205 msgid "" "The following methods on bytes and bytearray objects assume the use of ASCII " "compatible binary formats and should not be applied to arbitrary binary " @@ -4607,14 +4620,14 @@ msgid "" "operate in place, and instead produce new objects." msgstr "" -#: library/stdtypes.rst:3209 +#: library/stdtypes.rst:3213 msgid "" "Return a copy of the sequence with each byte interpreted as an ASCII " "character, and the first byte capitalized and the rest lowercased. Non-ASCII " "byte values are passed through unchanged." msgstr "" -#: library/stdtypes.rst:3222 +#: library/stdtypes.rst:3226 msgid "" "Return a copy of the sequence where all ASCII tab characters are replaced by " "one or more ASCII spaces, depending on the current column and the given tab " @@ -4630,7 +4643,7 @@ msgid "" "by one regardless of how the byte value is represented when printed::" msgstr "" -#: library/stdtypes.rst:3250 +#: library/stdtypes.rst:3254 msgid "" "Return ``True`` if all bytes in the sequence are alphabetical ASCII " "characters or ASCII decimal digits and the sequence is not empty, ``False`` " @@ -4639,7 +4652,7 @@ msgid "" "digits are those byte values in the sequence ``b'0123456789'``." msgstr "" -#: library/stdtypes.rst:3267 +#: library/stdtypes.rst:3271 msgid "" "Return ``True`` if all bytes in the sequence are alphabetic ASCII characters " "and the sequence is not empty, ``False`` otherwise. Alphabetic ASCII " @@ -4647,34 +4660,34 @@ msgid "" "``b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'``." msgstr "" -#: library/stdtypes.rst:3283 +#: library/stdtypes.rst:3287 msgid "" "Return ``True`` if the sequence is empty or all bytes in the sequence are " "ASCII, ``False`` otherwise. ASCII bytes are in the range 0-0x7F." msgstr "" -#: library/stdtypes.rst:3293 +#: library/stdtypes.rst:3297 msgid "" "Return ``True`` if all bytes in the sequence are ASCII decimal digits and " "the sequence is not empty, ``False`` otherwise. ASCII decimal digits are " "those byte values in the sequence ``b'0123456789'``." msgstr "" -#: library/stdtypes.rst:3308 +#: library/stdtypes.rst:3312 msgid "" "Return ``True`` if there is at least one lowercase ASCII character in the " "sequence and no uppercase ASCII characters, ``False`` otherwise." msgstr "" -#: library/stdtypes.rst:3360 library/stdtypes.rst:3426 -#: library/stdtypes.rst:3495 +#: library/stdtypes.rst:3364 library/stdtypes.rst:3430 +#: library/stdtypes.rst:3499 msgid "" "Lowercase ASCII characters are those byte values in the sequence " "``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " "values in the sequence ``b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``." msgstr "" -#: library/stdtypes.rst:3326 +#: library/stdtypes.rst:3330 msgid "" "Return ``True`` if all bytes in the sequence are ASCII whitespace and the " "sequence is not empty, ``False`` otherwise. ASCII whitespace characters are " @@ -4682,27 +4695,27 @@ msgid "" "newline, carriage return, vertical tab, form feed)." msgstr "" -#: library/stdtypes.rst:3335 +#: library/stdtypes.rst:3339 msgid "" "Return ``True`` if the sequence is ASCII titlecase and the sequence is not " "empty, ``False`` otherwise. See :meth:`bytes.title` for more details on the " "definition of \"titlecase\"." msgstr "" -#: library/stdtypes.rst:3350 +#: library/stdtypes.rst:3354 msgid "" "Return ``True`` if there is at least one uppercase alphabetic ASCII " "character in the sequence and no lowercase ASCII characters, ``False`` " "otherwise." msgstr "" -#: library/stdtypes.rst:3368 +#: library/stdtypes.rst:3372 msgid "" "Return a copy of the sequence with all the uppercase ASCII characters " "converted to their corresponding lowercase counterpart." msgstr "" -#: library/stdtypes.rst:3393 +#: library/stdtypes.rst:3397 msgid "" "Return a list of the lines in the binary sequence, breaking at ASCII line " "boundaries. This method uses the :term:`universal newlines` approach to " @@ -4710,20 +4723,20 @@ msgid "" "*keepends* is given and true." msgstr "" -#: library/stdtypes.rst:3405 +#: library/stdtypes.rst:3409 msgid "" "Unlike :meth:`~bytes.split` when a delimiter string *sep* is given, this " "method returns an empty list for the empty string, and a terminal line break " "does not result in an extra line::" msgstr "" -#: library/stdtypes.rst:3418 +#: library/stdtypes.rst:3422 msgid "" "Return a copy of the sequence with all the lowercase ASCII characters " "converted to their corresponding uppercase counterpart and vice-versa." msgstr "" -#: library/stdtypes.rst:3430 +#: library/stdtypes.rst:3434 msgid "" "Unlike :func:`str.swapcase()`, it is always the case that ``bin.swapcase()." "swapcase() == bin`` for the binary versions. Case conversions are " @@ -4731,14 +4744,14 @@ msgid "" "Unicode code points." msgstr "" -#: library/stdtypes.rst:3444 +#: library/stdtypes.rst:3448 msgid "" "Return a titlecased version of the binary sequence where words start with an " "uppercase ASCII character and the remaining characters are lowercase. " "Uncased byte values are left unmodified." msgstr "" -#: library/stdtypes.rst:3453 +#: library/stdtypes.rst:3457 msgid "" "Lowercase ASCII characters are those byte values in the sequence " "``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " @@ -4746,20 +4759,20 @@ msgid "" "values are uncased." msgstr "" -#: library/stdtypes.rst:3466 +#: library/stdtypes.rst:3470 msgid "" "A workaround for apostrophes can be constructed using regular expressions::" msgstr "" "Kesme işaretleri için geçici bir çözüm düzenli ifadeler kullanılarak " "oluşturulabilir::" -#: library/stdtypes.rst:3487 +#: library/stdtypes.rst:3491 msgid "" "Return a copy of the sequence with all the lowercase ASCII characters " "converted to their corresponding uppercase counterpart." msgstr "" -#: library/stdtypes.rst:3508 +#: library/stdtypes.rst:3512 msgid "" "Return a copy of the sequence left filled with ASCII ``b'0'`` digits to make " "a sequence of length *width*. A leading sign prefix (``b'+'``/ ``b'-'``) is " @@ -4768,11 +4781,11 @@ msgid "" "*width* is less than or equal to ``len(seq)``." msgstr "" -#: library/stdtypes.rst:3530 +#: library/stdtypes.rst:3534 msgid "``printf``-style Bytes Formatting" msgstr "" -#: library/stdtypes.rst:3547 +#: library/stdtypes.rst:3551 msgid "" "The formatting operations described here exhibit a variety of quirks that " "lead to a number of common errors (such as failing to display tuples and " @@ -4780,7 +4793,7 @@ msgid "" "dictionary, wrap it in a tuple." msgstr "" -#: library/stdtypes.rst:3552 +#: library/stdtypes.rst:3556 msgid "" "Bytes objects (``bytes``/``bytearray``) have one unique built-in operation: " "the ``%`` operator (modulo). This is also known as the bytes *formatting* or " @@ -4790,7 +4803,7 @@ msgid "" "func:`sprintf` in the C language." msgstr "" -#: library/stdtypes.rst:3559 +#: library/stdtypes.rst:3563 msgid "" "If *format* requires a single argument, *values* may be a single non-tuple " "object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " @@ -4798,7 +4811,7 @@ msgid "" "example, a dictionary)." msgstr "" -#: library/stdtypes.rst:3593 +#: library/stdtypes.rst:3597 msgid "" "When the right argument is a dictionary (or other mapping type), then the " "formats in the bytes object *must* include a parenthesised mapping key into " @@ -4806,73 +4819,73 @@ msgid "" "mapping key selects the value to be formatted from the mapping. For example:" msgstr "" -#: library/stdtypes.rst:3667 +#: library/stdtypes.rst:3671 msgid "Single byte (accepts integer or single byte objects)." msgstr "" -#: library/stdtypes.rst:3670 +#: library/stdtypes.rst:3674 msgid "``'b'``" msgstr "" -#: library/stdtypes.rst:3670 +#: library/stdtypes.rst:3674 msgid "" "Bytes (any object that follows the :ref:`buffer protocol ` or " "has :meth:`~object.__bytes__`)." msgstr "" -#: library/stdtypes.rst:3674 +#: library/stdtypes.rst:3678 msgid "" "``'s'`` is an alias for ``'b'`` and should only be used for Python2/3 code " "bases." msgstr "" -#: library/stdtypes.rst:3677 +#: library/stdtypes.rst:3681 msgid "" "Bytes (converts any Python object using ``repr(obj).encode('ascii', " "'backslashreplace')``)." msgstr "" -#: library/stdtypes.rst:3680 +#: library/stdtypes.rst:3684 msgid "" "``'r'`` is an alias for ``'a'`` and should only be used for Python2/3 code " "bases." msgstr "" -#: library/stdtypes.rst:3680 +#: library/stdtypes.rst:3684 msgid "\\(7)" msgstr "" -#: library/stdtypes.rst:3715 +#: library/stdtypes.rst:3719 msgid "``b'%s'`` is deprecated, but will not be removed during the 3.x series." msgstr "" -#: library/stdtypes.rst:3718 +#: library/stdtypes.rst:3722 msgid "``b'%r'`` is deprecated, but will not be removed during the 3.x series." msgstr "" -#: library/stdtypes.rst:3730 +#: library/stdtypes.rst:3734 msgid ":pep:`461` - Adding % formatting to bytes and bytearray" msgstr "" -#: library/stdtypes.rst:3737 +#: library/stdtypes.rst:3741 msgid "Memory Views" msgstr "" -#: library/stdtypes.rst:3739 +#: library/stdtypes.rst:3743 msgid "" ":class:`memoryview` objects allow Python code to access the internal data of " "an object that supports the :ref:`buffer protocol ` without " "copying." msgstr "" -#: library/stdtypes.rst:3745 +#: library/stdtypes.rst:3749 msgid "" "Create a :class:`memoryview` that references *object*. *object* must " "support the buffer protocol. Built-in objects that support the buffer " "protocol include :class:`bytes` and :class:`bytearray`." msgstr "" -#: library/stdtypes.rst:3749 +#: library/stdtypes.rst:3753 msgid "" "A :class:`memoryview` has the notion of an *element*, which is the atomic " "memory unit handled by the originating *object*. For many simple types such " @@ -4880,32 +4893,32 @@ msgid "" "other types such as :class:`array.array` may have bigger elements." msgstr "" -#: library/stdtypes.rst:3754 +#: library/stdtypes.rst:3758 msgid "" "``len(view)`` is equal to the length of :class:`~memoryview.tolist`, which " "is the nested list representation of the view. If ``view.ndim = 1``, this is " "equal to the number of elements in the view." msgstr "" -#: library/stdtypes.rst:3758 +#: library/stdtypes.rst:3762 msgid "" "If ``view.ndim == 0``, ``len(view)`` now raises :exc:`TypeError` instead of " "returning 1." msgstr "" -#: library/stdtypes.rst:3761 +#: library/stdtypes.rst:3765 msgid "" "The :class:`~memoryview.itemsize` attribute will give you the number of " "bytes in a single element." msgstr "" -#: library/stdtypes.rst:3764 +#: library/stdtypes.rst:3768 msgid "" "A :class:`memoryview` supports slicing and indexing to expose its data. One-" "dimensional slicing will result in a subview::" msgstr "" -#: library/stdtypes.rst:3777 +#: library/stdtypes.rst:3781 msgid "" "If :class:`~memoryview.format` is one of the native format specifiers from " "the :mod:`struct` module, indexing with an integer or a tuple of integers is " @@ -4916,82 +4929,82 @@ msgid "" "memoryviews can be indexed with the empty tuple." msgstr "" -#: library/stdtypes.rst:3786 +#: library/stdtypes.rst:3790 msgid "Here is an example with a non-byte format::" msgstr "" -#: library/stdtypes.rst:3798 +#: library/stdtypes.rst:3802 msgid "" "If the underlying object is writable, the memoryview supports one-" "dimensional slice assignment. Resizing is not allowed::" msgstr "" -#: library/stdtypes.rst:3819 +#: library/stdtypes.rst:3823 msgid "" "One-dimensional memoryviews of :term:`hashable` (read-only) types with " "formats 'B', 'b' or 'c' are also hashable. The hash is defined as ``hash(m) " "== hash(m.tobytes())``::" msgstr "" -#: library/stdtypes.rst:3831 +#: library/stdtypes.rst:3835 msgid "" "One-dimensional memoryviews can now be sliced. One-dimensional memoryviews " "with formats 'B', 'b' or 'c' are now :term:`hashable`." msgstr "" -#: library/stdtypes.rst:3835 +#: library/stdtypes.rst:3839 msgid "" "memoryview is now registered automatically with :class:`collections.abc." "Sequence`" msgstr "" -#: library/stdtypes.rst:3839 +#: library/stdtypes.rst:3843 msgid "memoryviews can now be indexed with tuple of integers." msgstr "" -#: library/stdtypes.rst:3842 +#: library/stdtypes.rst:3846 msgid ":class:`memoryview` has several methods:" msgstr "" -#: library/stdtypes.rst:3846 +#: library/stdtypes.rst:3850 msgid "" "A memoryview and a :pep:`3118` exporter are equal if their shapes are " "equivalent and if all corresponding values are equal when the operands' " "respective format codes are interpreted using :mod:`struct` syntax." msgstr "" -#: library/stdtypes.rst:3850 +#: library/stdtypes.rst:3854 msgid "" "For the subset of :mod:`struct` format strings currently supported by :meth:" "`tolist`, ``v`` and ``w`` are equal if ``v.tolist() == w.tolist()``::" msgstr "" -#: library/stdtypes.rst:3869 +#: library/stdtypes.rst:3873 msgid "" "If either format string is not supported by the :mod:`struct` module, then " "the objects will always compare as unequal (even if the format strings and " "buffer contents are identical)::" msgstr "" -#: library/stdtypes.rst:3885 +#: library/stdtypes.rst:3889 msgid "" -"Note that, as with floating point numbers, ``v is w`` does *not* imply ``v " +"Note that, as with floating-point numbers, ``v is w`` does *not* imply ``v " "== w`` for memoryview objects." msgstr "" -#: library/stdtypes.rst:3888 +#: library/stdtypes.rst:3892 msgid "" "Previous versions compared the raw memory disregarding the item format and " "the logical array structure." msgstr "" -#: library/stdtypes.rst:3894 +#: library/stdtypes.rst:3898 msgid "" "Return the data in the buffer as a bytestring. This is equivalent to " "calling the :class:`bytes` constructor on the memoryview. ::" msgstr "" -#: library/stdtypes.rst:3903 +#: library/stdtypes.rst:3907 msgid "" "For non-contiguous arrays the result is equal to the flattened list " "representation with all elements converted to bytes. :meth:`tobytes` " @@ -4999,7 +5012,7 @@ msgid "" "module syntax." msgstr "" -#: library/stdtypes.rst:3908 +#: library/stdtypes.rst:3912 msgid "" "*order* can be {'C', 'F', 'A'}. When *order* is 'C' or 'F', the data of the " "original array is converted to C or Fortran order. For contiguous views, 'A' " @@ -5008,36 +5021,36 @@ msgid "" "to C first. *order=None* is the same as *order='C'*." msgstr "" -#: library/stdtypes.rst:3917 +#: library/stdtypes.rst:3921 msgid "" "Return a string object containing two hexadecimal digits for each byte in " "the buffer. ::" msgstr "" -#: library/stdtypes.rst:3926 +#: library/stdtypes.rst:3930 msgid "" "Similar to :meth:`bytes.hex`, :meth:`memoryview.hex` now supports optional " "*sep* and *bytes_per_sep* parameters to insert separators between bytes in " "the hex output." msgstr "" -#: library/stdtypes.rst:3933 +#: library/stdtypes.rst:3937 msgid "Return the data in the buffer as a list of elements. ::" msgstr "" -#: library/stdtypes.rst:3943 +#: library/stdtypes.rst:3947 msgid "" ":meth:`tolist` now supports all single character native formats in :mod:" "`struct` module syntax as well as multi-dimensional representations." msgstr "" -#: library/stdtypes.rst:3950 +#: library/stdtypes.rst:3954 msgid "" "Return a readonly version of the memoryview object. The original memoryview " "object is unchanged. ::" msgstr "" -#: library/stdtypes.rst:3969 +#: library/stdtypes.rst:3973 msgid "" "Release the underlying buffer exposed by the memoryview object. Many " "objects take special actions when a view is held on them (for example, a :" @@ -5046,20 +5059,20 @@ msgid "" "resources) as soon as possible." msgstr "" -#: library/stdtypes.rst:3975 +#: library/stdtypes.rst:3979 msgid "" "After this method has been called, any further operation on the view raises " "a :class:`ValueError` (except :meth:`release()` itself which can be called " "multiple times)::" msgstr "" -#: library/stdtypes.rst:3986 +#: library/stdtypes.rst:3990 msgid "" "The context management protocol can be used for a similar effect, using the " "``with`` statement::" msgstr "" -#: library/stdtypes.rst:4002 +#: library/stdtypes.rst:4006 msgid "" "Cast a memoryview to a new format or shape. *shape* defaults to " "``[byte_length//new_itemsize]``, which means that the result view will be " @@ -5068,7 +5081,7 @@ msgid "" "contiguous -> 1D." msgstr "" -#: library/stdtypes.rst:4008 +#: library/stdtypes.rst:4012 msgid "" "The destination format is restricted to a single element native format in :" "mod:`struct` syntax. One of the formats must be a byte format ('B', 'b' or " @@ -5076,50 +5089,50 @@ msgid "" "Note that all byte lengths may depend on the operating system." msgstr "" -#: library/stdtypes.rst:4014 +#: library/stdtypes.rst:4018 msgid "Cast 1D/long to 1D/unsigned bytes::" msgstr "" -#: library/stdtypes.rst:4037 +#: library/stdtypes.rst:4041 msgid "Cast 1D/unsigned bytes to 1D/char::" msgstr "" -#: library/stdtypes.rst:4050 +#: library/stdtypes.rst:4054 msgid "Cast 1D/bytes to 3D/ints to 1D/signed char::" msgstr "" -#: library/stdtypes.rst:4076 +#: library/stdtypes.rst:4080 msgid "Cast 1D/unsigned long to 2D/unsigned long::" msgstr "" -#: library/stdtypes.rst:4090 +#: library/stdtypes.rst:4094 msgid "The source format is no longer restricted when casting to a byte view." msgstr "" -#: library/stdtypes.rst:4093 +#: library/stdtypes.rst:4097 msgid "There are also several readonly attributes available:" msgstr "" -#: library/stdtypes.rst:4097 +#: library/stdtypes.rst:4101 msgid "The underlying object of the memoryview::" msgstr "" -#: library/stdtypes.rst:4108 +#: library/stdtypes.rst:4112 msgid "" "``nbytes == product(shape) * itemsize == len(m.tobytes())``. This is the " "amount of space in bytes that the array would use in a contiguous " "representation. It is not necessarily equal to ``len(m)``::" msgstr "" -#: library/stdtypes.rst:4127 +#: library/stdtypes.rst:4131 msgid "Multi-dimensional arrays::" msgstr "" -#: library/stdtypes.rst:4144 +#: library/stdtypes.rst:4148 msgid "A bool indicating whether the memory is read only." msgstr "" -#: library/stdtypes.rst:4148 +#: library/stdtypes.rst:4152 msgid "" "A string containing the format (in :mod:`struct` module style) for each " "element in the view. A memoryview can be created from exporters with " @@ -5127,59 +5140,59 @@ msgid "" "restricted to native single element formats." msgstr "" -#: library/stdtypes.rst:4153 +#: library/stdtypes.rst:4157 msgid "" "format ``'B'`` is now handled according to the struct module syntax. This " "means that ``memoryview(b'abc')[0] == b'abc'[0] == 97``." msgstr "" -#: library/stdtypes.rst:4159 +#: library/stdtypes.rst:4163 msgid "The size in bytes of each element of the memoryview::" msgstr "" -#: library/stdtypes.rst:4172 +#: library/stdtypes.rst:4176 msgid "" "An integer indicating how many dimensions of a multi-dimensional array the " "memory represents." msgstr "" -#: library/stdtypes.rst:4177 +#: library/stdtypes.rst:4181 msgid "" "A tuple of integers the length of :attr:`ndim` giving the shape of the " "memory as an N-dimensional array." msgstr "" -#: library/stdtypes.rst:4188 +#: library/stdtypes.rst:4192 msgid "An empty tuple instead of ``None`` when ndim = 0." msgstr "" -#: library/stdtypes.rst:4185 +#: library/stdtypes.rst:4189 msgid "" "A tuple of integers the length of :attr:`ndim` giving the size in bytes to " "access each element for each dimension of the array." msgstr "" -#: library/stdtypes.rst:4193 +#: library/stdtypes.rst:4197 msgid "Used internally for PIL-style arrays. The value is informational only." msgstr "" -#: library/stdtypes.rst:4197 +#: library/stdtypes.rst:4201 msgid "A bool indicating whether the memory is C-:term:`contiguous`." msgstr "Belleğin C-:term:`contiguous` olup olmadığını gösteren bir bool." -#: library/stdtypes.rst:4203 +#: library/stdtypes.rst:4207 msgid "A bool indicating whether the memory is Fortran :term:`contiguous`." msgstr "Belleğin Fortran :term:`contiguous` olup olmadığını gösteren bir bool." -#: library/stdtypes.rst:4209 +#: library/stdtypes.rst:4213 msgid "A bool indicating whether the memory is :term:`contiguous`." msgstr "Belleğin :term:`contiguous` olup olmadığını gösteren bir bool." -#: library/stdtypes.rst:4217 +#: library/stdtypes.rst:4221 msgid "Set Types --- :class:`set`, :class:`frozenset`" msgstr "Set Türleri --- :class:`set`, :class:`frozenset`" -#: library/stdtypes.rst:4221 +#: library/stdtypes.rst:4225 msgid "" "A :dfn:`set` object is an unordered collection of distinct :term:`hashable` " "objects. Common uses include membership testing, removing duplicates from a " @@ -5195,7 +5208,7 @@ msgstr "" "için yerleşik :class:`dict`, :class:`list` ve :class:`tuple` sınıflarına ve :" "mod:`collections` modülüne bakın)" -#: library/stdtypes.rst:4228 +#: library/stdtypes.rst:4232 msgid "" "Like other collections, sets support ``x in set``, ``len(set)``, and ``for x " "in set``. Being an unordered collection, sets do not record element " @@ -5207,7 +5220,7 @@ msgstr "" "eleman konumunu veya ekleme sırasını kaydetmez. Buna göre, kümeler " "dizinleme, dilimleme veya sıra benzeri davranışları desteklemez." -#: library/stdtypes.rst:4233 +#: library/stdtypes.rst:4237 msgid "" "There are currently two built-in set types, :class:`set` and :class:" "`frozenset`. The :class:`set` type is mutable --- the contents can be " @@ -5226,7 +5239,7 @@ msgstr "" "term:`hashable` --- içeriği oluşturulduktan sonra değiştirilemez; bu nedenle " "bir sözlük anahtarı veya başka bir kümenin öğesi olarak kullanılabilir." -#: library/stdtypes.rst:4241 +#: library/stdtypes.rst:4245 msgid "" "Non-empty sets (not frozensets) can be created by placing a comma-separated " "list of elements within braces, for example: ``{'jack', 'sjoerd'}``, in " @@ -5236,11 +5249,11 @@ msgstr "" "parantez içine virgülle ayrılmış bir öğe listesi yerleştirilerek " "oluşturulabilir, örneğin: ``{'jack', 'sjoerd'}``." -#: library/stdtypes.rst:4245 +#: library/stdtypes.rst:4249 msgid "The constructors for both classes work the same:" msgstr "Her iki sınıfın kurucuları aynı şekilde çalışır:" -#: library/stdtypes.rst:4250 +#: library/stdtypes.rst:4254 msgid "" "Return a new set or frozenset object whose elements are taken from " "*iterable*. The elements of a set must be :term:`hashable`. To represent " @@ -5252,24 +5265,24 @@ msgstr "" "kümelerini temsil etmek için, iç kümeler :class:`frozenset` nesneleri " "olmalıdır. Eğer *iterable* belirtilmemişse, yeni bir boş küme döndürülür." -#: library/stdtypes.rst:4256 +#: library/stdtypes.rst:4260 msgid "Sets can be created by several means:" msgstr "Setler çeşitli yollarla oluşturulabilir:" -#: library/stdtypes.rst:4258 +#: library/stdtypes.rst:4262 msgid "" "Use a comma-separated list of elements within braces: ``{'jack', 'sjoerd'}``" msgstr "" "Parantez içinde virgülle ayrılmış bir öğe listesi kullanın: ``{'jack', " "'sjoerd'}``" -#: library/stdtypes.rst:4259 +#: library/stdtypes.rst:4263 msgid "" "Use a set comprehension: ``{c for c in 'abracadabra' if c not in 'abc'}``" msgstr "" "Bir küme kavrayışı kullanın: ``{c for c in 'abracadabra' if c not in 'abc'}``" -#: library/stdtypes.rst:4260 +#: library/stdtypes.rst:4264 msgid "" "Use the type constructor: ``set()``, ``set('foobar')``, ``set(['a', 'b', " "'foo'])``" @@ -5277,26 +5290,26 @@ msgstr "" "Tür kurucusunu kullanın: ``set()``, ``set('foobar')``, ``set(['a', 'b', " "'foo'])``" -#: library/stdtypes.rst:4262 +#: library/stdtypes.rst:4266 msgid "" "Instances of :class:`set` and :class:`frozenset` provide the following " "operations:" msgstr "" ":class:`set` ve :class:`frozenset` örnekleri aşağıdaki işlemleri sağlar:" -#: library/stdtypes.rst:4267 +#: library/stdtypes.rst:4271 msgid "Return the number of elements in set *s* (cardinality of *s*)." msgstr "*s* kümesindeki eleman sayısını döndürür (*s*'nin kardinalitesi)." -#: library/stdtypes.rst:4271 +#: library/stdtypes.rst:4275 msgid "Test *x* for membership in *s*." msgstr "*x*'i *s* üyeliği için test edin." -#: library/stdtypes.rst:4275 +#: library/stdtypes.rst:4279 msgid "Test *x* for non-membership in *s*." msgstr "*x*'in *s*'ye üye olup olmadığını test edin." -#: library/stdtypes.rst:4279 +#: library/stdtypes.rst:4283 msgid "" "Return ``True`` if the set has no elements in common with *other*. Sets are " "disjoint if and only if their intersection is the empty set." @@ -5304,11 +5317,11 @@ msgstr "" "Kümenin *other* kümelerle ortak hiçbir elemanı yoksa ``True`` döndürür. " "Kümeler, ancak ve ancak kesişimleri boş küme ise ayrıktır." -#: library/stdtypes.rst:4285 +#: library/stdtypes.rst:4289 msgid "Test whether every element in the set is in *other*." msgstr "Kümedeki her elemanın *other* içinde olup olmadığını test edin." -#: library/stdtypes.rst:4289 +#: library/stdtypes.rst:4293 msgid "" "Test whether the set is a proper subset of *other*, that is, ``set <= other " "and set != other``." @@ -5316,11 +5329,11 @@ msgstr "" "Kümenin *other* kümenin uygun bir alt kümesi olup olmadığını, yani ``set <= " "other and set != other`` olup olmadığını test eder." -#: library/stdtypes.rst:4295 +#: library/stdtypes.rst:4299 msgid "Test whether every element in *other* is in the set." msgstr "Kümedeki her elemanın *other* içinde olup olmadığını test edin." -#: library/stdtypes.rst:4299 +#: library/stdtypes.rst:4303 msgid "" "Test whether the set is a proper superset of *other*, that is, ``set >= " "other and set != other``." @@ -5328,33 +5341,33 @@ msgstr "" "Kümenin *other* kümenin uygun bir üst kümesi olup olmadığını, yani ``set >= " "other and set != other`` olup olmadığını test edin." -#: library/stdtypes.rst:4305 +#: library/stdtypes.rst:4309 msgid "Return a new set with elements from the set and all others." msgstr "" "Kümedeki ve diğer tüm kümelerdeki elemanları içeren yeni bir küme döndürür." -#: library/stdtypes.rst:4310 +#: library/stdtypes.rst:4314 msgid "Return a new set with elements common to the set and all others." msgstr "" "Küme ve diğer tüm kümeler için ortak öğeler içeren yeni bir küme döndürür." -#: library/stdtypes.rst:4315 +#: library/stdtypes.rst:4319 msgid "Return a new set with elements in the set that are not in the others." msgstr "" "Küme içinde diğerlerinde olmayan elemanlar içeren yeni bir küme döndürür." -#: library/stdtypes.rst:4320 +#: library/stdtypes.rst:4324 msgid "" "Return a new set with elements in either the set or *other* but not both." msgstr "" "Elemanları ya kümede ya da *diğer* kümede olan ancak her ikisinde de olmayan " "yeni bir küme döndürür." -#: library/stdtypes.rst:4324 +#: library/stdtypes.rst:4328 msgid "Return a shallow copy of the set." msgstr "Kümenin yüzeysel bir kopyasını döndürür." -#: library/stdtypes.rst:4327 +#: library/stdtypes.rst:4331 msgid "" "Note, the non-operator versions of :meth:`union`, :meth:`intersection`, :" "meth:`difference`, :meth:`symmetric_difference`, :meth:`issubset`, and :meth:" @@ -5372,7 +5385,7 @@ msgstr "" "\n" "Translated with www.DeepL.com/Translator (free version)" -#: library/stdtypes.rst:4334 +#: library/stdtypes.rst:4338 msgid "" "Both :class:`set` and :class:`frozenset` support set to set comparisons. Two " "sets are equal if and only if every element of each set is contained in the " @@ -5391,7 +5404,7 @@ msgstr "" "\n" "Translated with www.DeepL.com/Translator (free version)" -#: library/stdtypes.rst:4341 +#: library/stdtypes.rst:4345 msgid "" "Instances of :class:`set` are compared to instances of :class:`frozenset` " "based on their members. For example, ``set('abc') == frozenset('abc')`` " @@ -5401,7 +5414,7 @@ msgstr "" "karşılaştırılır. Örneğin, ``set('abc') == frozenset('abc')`` ``True`` " "döndürür ve ``set('abc') in set([frozenset('abc')])`` de öyle." -#: library/stdtypes.rst:4345 +#: library/stdtypes.rst:4349 msgid "" "The subset and equality comparisons do not generalize to a total ordering " "function. For example, any two nonempty disjoint sets are not equal and are " @@ -5413,7 +5426,7 @@ msgstr "" "değildir ve birbirinin alt kümesi değildir, bu nedenle aşağıdakilerin *all* " "``Yanlış`` döndürür: ``ab``." -#: library/stdtypes.rst:4350 +#: library/stdtypes.rst:4354 msgid "" "Since sets only define partial ordering (subset relationships), the output " "of the :meth:`list.sort` method is undefined for lists of sets." @@ -5421,11 +5434,11 @@ msgstr "" "Kümeler yalnızca kısmi sıralama (alt küme ilişkileri) tanımladığından, :meth:" "`list.sort` yönteminin çıktısı küme listeleri için tanımsızdır." -#: library/stdtypes.rst:4353 +#: library/stdtypes.rst:4357 msgid "Set elements, like dictionary keys, must be :term:`hashable`." msgstr "Sözlük anahtarları gibi küme öğeleri de :term:`hashable` olmalıdır." -#: library/stdtypes.rst:4355 +#: library/stdtypes.rst:4359 msgid "" "Binary operations that mix :class:`set` instances with :class:`frozenset` " "return the type of the first operand. For example: ``frozenset('ab') | " @@ -5435,7 +5448,7 @@ msgstr "" "ilk işlenenin türünü döndürür. Örneğin: ``frozenset('ab') | set('bc')`` " "bir :class:`frozenset` örneği döndürür." -#: library/stdtypes.rst:4359 +#: library/stdtypes.rst:4363 msgid "" "The following table lists operations available for :class:`set` that do not " "apply to immutable instances of :class:`frozenset`:" @@ -5443,31 +5456,31 @@ msgstr "" "Aşağıdaki tabloda :class:`set` için kullanılabilen ve :class:`frozenset` 'in " "değişmez örneklerine uygulanmayan işlemler listelenmektedir:" -#: library/stdtypes.rst:4365 +#: library/stdtypes.rst:4369 msgid "Update the set, adding elements from all others." msgstr "Diğer tüm öğeleri ekleyerek seti güncelleyin." -#: library/stdtypes.rst:4370 +#: library/stdtypes.rst:4374 msgid "Update the set, keeping only elements found in it and all others." msgstr "" "Yalnızca içinde bulunan öğeleri ve diğerlerini koruyarak seti güncelleyin." -#: library/stdtypes.rst:4375 +#: library/stdtypes.rst:4379 msgid "Update the set, removing elements found in others." msgstr "Diğerlerinde bulunan öğeleri kaldırarak kümeyi güncelleyin." -#: library/stdtypes.rst:4380 +#: library/stdtypes.rst:4384 msgid "" "Update the set, keeping only elements found in either set, but not in both." msgstr "" "Kümeyi güncelleyin, yalnızca her iki kümede de bulunan öğeleri saklayın, " "ancak her ikisinde de bulunmayın." -#: library/stdtypes.rst:4384 +#: library/stdtypes.rst:4388 msgid "Add element *elem* to the set." msgstr "Kümeye *elem* öğesini ekleyin." -#: library/stdtypes.rst:4388 +#: library/stdtypes.rst:4392 msgid "" "Remove element *elem* from the set. Raises :exc:`KeyError` if *elem* is not " "contained in the set." @@ -5475,11 +5488,11 @@ msgstr "" "Kümeden *elem* elemanını kaldırır. Eğer *elem* kümede bulunmuyorsa :exc:" "`KeyError` değerini yükseltir." -#: library/stdtypes.rst:4393 +#: library/stdtypes.rst:4397 msgid "Remove element *elem* from the set if it is present." msgstr "Eğer varsa *elem* öğesini kümeden kaldırır." -#: library/stdtypes.rst:4397 +#: library/stdtypes.rst:4401 msgid "" "Remove and return an arbitrary element from the set. Raises :exc:`KeyError` " "if the set is empty." @@ -5487,11 +5500,11 @@ msgstr "" "Kümeden rastgele bir elemanı kaldırır ve döndürür. Küme boşsa :exc:" "`KeyError` değerini yükseltir." -#: library/stdtypes.rst:4402 +#: library/stdtypes.rst:4406 msgid "Remove all elements from the set." msgstr "Kümeden tüm öğeleri kaldırın." -#: library/stdtypes.rst:4405 +#: library/stdtypes.rst:4409 msgid "" "Note, the non-operator versions of the :meth:`update`, :meth:" "`intersection_update`, :meth:`difference_update`, and :meth:" @@ -5502,7 +5515,7 @@ msgstr "" "ve :meth:`symmetric_difference_update` metotlarının operatör olmayan " "versiyonları herhangi bir iterable'ı argüman olarak kabul edecektir." -#: library/stdtypes.rst:4410 +#: library/stdtypes.rst:4414 #, fuzzy msgid "" "Note, the *elem* argument to the :meth:`~object.__contains__`, :meth:" @@ -5513,11 +5526,11 @@ msgstr "" "*elem* argümanı bir küme olabilir. Eş değer bir frozenset aramayı " "desteklemek için, *elem*'den geçici bir tane oluşturulur." -#: library/stdtypes.rst:4419 +#: library/stdtypes.rst:4423 msgid "Mapping Types --- :class:`dict`" msgstr "Mapping Types --- :class:`dict`" -#: library/stdtypes.rst:4429 +#: library/stdtypes.rst:4433 msgid "" "A :term:`mapping` object maps :term:`hashable` values to arbitrary objects. " "Mappings are mutable objects. There is currently only one standard mapping " @@ -5531,7 +5544,7 @@ msgstr "" "class:`list`, :class:`set` ve :class:`tuple` sınıflarına ve :mod:" "`collections` modülüne bakın)." -#: library/stdtypes.rst:4435 +#: library/stdtypes.rst:4439 msgid "" "A dictionary's keys are *almost* arbitrary values. Values that are not :" "term:`hashable`, that is, values containing lists, dictionaries or other " @@ -5546,7 +5559,7 @@ msgstr "" "``True`` gibi) aynı sözlük girdisini indekslemek için birbirinin yerine " "kullanılabilir." -#: library/stdtypes.rst:4446 +#: library/stdtypes.rst:4450 msgid "" "Return a new dictionary initialized from an optional positional argument and " "a possibly empty set of keyword arguments." @@ -5554,27 +5567,27 @@ msgstr "" "İsteğe bağlı bir konumsal bağımsız değişken ve muhtemelen boş bir anahtar " "sözcük bağımsız değişken kümesinden başlatılan yeni bir sözlük döndürür." -#: library/stdtypes.rst:4449 +#: library/stdtypes.rst:4453 msgid "Dictionaries can be created by several means:" msgstr "Sözlükler çeşitli yollarla oluşturulabilir:" -#: library/stdtypes.rst:4451 +#: library/stdtypes.rst:4455 msgid "" "Use a comma-separated list of ``key: value`` pairs within braces: ``{'jack': " "4098, 'sjoerd': 4127}`` or ``{4098: 'jack', 4127: 'sjoerd'}``" msgstr "" -#: library/stdtypes.rst:4453 +#: library/stdtypes.rst:4457 msgid "Use a dict comprehension: ``{}``, ``{x: x ** 2 for x in range(10)}``" msgstr "" -#: library/stdtypes.rst:4454 +#: library/stdtypes.rst:4458 msgid "" "Use the type constructor: ``dict()``, ``dict([('foo', 100), ('bar', " "200)])``, ``dict(foo=100, bar=200)``" msgstr "" -#: library/stdtypes.rst:4457 +#: library/stdtypes.rst:4461 msgid "" "If no positional argument is given, an empty dictionary is created. If a " "positional argument is given and it is a mapping object, a dictionary is " @@ -5586,7 +5599,7 @@ msgid "" "value for that key becomes the corresponding value in the new dictionary." msgstr "" -#: library/stdtypes.rst:4467 +#: library/stdtypes.rst:4471 msgid "" "If keyword arguments are given, the keyword arguments and their values are " "added to the dictionary created from the positional argument. If a key " @@ -5594,39 +5607,39 @@ msgid "" "the value from the positional argument." msgstr "" -#: library/stdtypes.rst:4472 +#: library/stdtypes.rst:4476 msgid "" "To illustrate, the following examples all return a dictionary equal to " "``{\"one\": 1, \"two\": 2, \"three\": 3}``::" msgstr "" -#: library/stdtypes.rst:4484 +#: library/stdtypes.rst:4488 msgid "" "Providing keyword arguments as in the first example only works for keys that " "are valid Python identifiers. Otherwise, any valid keys can be used." msgstr "" -#: library/stdtypes.rst:4488 +#: library/stdtypes.rst:4492 msgid "" "These are the operations that dictionaries support (and therefore, custom " "mapping types should support too):" msgstr "" -#: library/stdtypes.rst:4493 +#: library/stdtypes.rst:4497 msgid "Return a list of all the keys used in the dictionary *d*." msgstr "" -#: library/stdtypes.rst:4497 +#: library/stdtypes.rst:4501 msgid "Return the number of items in the dictionary *d*." msgstr "" -#: library/stdtypes.rst:4501 +#: library/stdtypes.rst:4505 msgid "" "Return the item of *d* with key *key*. Raises a :exc:`KeyError` if *key* is " "not in the map." msgstr "" -#: library/stdtypes.rst:4506 +#: library/stdtypes.rst:4510 msgid "" "If a subclass of dict defines a method :meth:`__missing__` and *key* is not " "present, the ``d[key]`` operation calls that method with the key *key* as " @@ -5637,51 +5650,51 @@ msgid "" "an instance variable::" msgstr "" -#: library/stdtypes.rst:4525 +#: library/stdtypes.rst:4529 msgid "" "The example above shows part of the implementation of :class:`collections." "Counter`. A different ``__missing__`` method is used by :class:`collections." "defaultdict`." msgstr "" -#: library/stdtypes.rst:4531 +#: library/stdtypes.rst:4535 msgid "Set ``d[key]`` to *value*." msgstr "" -#: library/stdtypes.rst:4535 +#: library/stdtypes.rst:4539 msgid "" "Remove ``d[key]`` from *d*. Raises a :exc:`KeyError` if *key* is not in the " "map." msgstr "" -#: library/stdtypes.rst:4540 +#: library/stdtypes.rst:4544 msgid "Return ``True`` if *d* has a key *key*, else ``False``." msgstr "" -#: library/stdtypes.rst:4544 +#: library/stdtypes.rst:4548 msgid "Equivalent to ``not key in d``." msgstr "" -#: library/stdtypes.rst:4548 +#: library/stdtypes.rst:4552 msgid "" "Return an iterator over the keys of the dictionary. This is a shortcut for " "``iter(d.keys())``." msgstr "" -#: library/stdtypes.rst:4553 +#: library/stdtypes.rst:4557 msgid "Remove all items from the dictionary." msgstr "" -#: library/stdtypes.rst:4557 +#: library/stdtypes.rst:4561 msgid "Return a shallow copy of the dictionary." msgstr "" -#: library/stdtypes.rst:4561 +#: library/stdtypes.rst:4565 msgid "" "Create a new dictionary with keys from *iterable* and values set to *value*." msgstr "" -#: library/stdtypes.rst:4563 +#: library/stdtypes.rst:4567 msgid "" ":meth:`fromkeys` is a class method that returns a new dictionary. *value* " "defaults to ``None``. All of the values refer to just a single instance, so " @@ -5690,70 +5703,70 @@ msgid "" "` instead." msgstr "" -#: library/stdtypes.rst:4571 +#: library/stdtypes.rst:4575 msgid "" "Return the value for *key* if *key* is in the dictionary, else *default*. If " "*default* is not given, it defaults to ``None``, so that this method never " "raises a :exc:`KeyError`." msgstr "" -#: library/stdtypes.rst:4577 +#: library/stdtypes.rst:4581 msgid "" "Return a new view of the dictionary's items (``(key, value)`` pairs). See " "the :ref:`documentation of view objects `." msgstr "" -#: library/stdtypes.rst:4582 +#: library/stdtypes.rst:4586 msgid "" "Return a new view of the dictionary's keys. See the :ref:`documentation of " "view objects `." msgstr "" -#: library/stdtypes.rst:4587 +#: library/stdtypes.rst:4591 msgid "" "If *key* is in the dictionary, remove it and return its value, else return " "*default*. If *default* is not given and *key* is not in the dictionary, a :" "exc:`KeyError` is raised." msgstr "" -#: library/stdtypes.rst:4593 +#: library/stdtypes.rst:4597 msgid "" "Remove and return a ``(key, value)`` pair from the dictionary. Pairs are " "returned in :abbr:`LIFO (last-in, first-out)` order." msgstr "" -#: library/stdtypes.rst:4596 +#: library/stdtypes.rst:4600 msgid "" ":meth:`popitem` is useful to destructively iterate over a dictionary, as " "often used in set algorithms. If the dictionary is empty, calling :meth:" "`popitem` raises a :exc:`KeyError`." msgstr "" -#: library/stdtypes.rst:4600 +#: library/stdtypes.rst:4604 msgid "" "LIFO order is now guaranteed. In prior versions, :meth:`popitem` would " "return an arbitrary key/value pair." msgstr "" -#: library/stdtypes.rst:4606 +#: library/stdtypes.rst:4610 msgid "" "Return a reverse iterator over the keys of the dictionary. This is a " "shortcut for ``reversed(d.keys())``." msgstr "" -#: library/stdtypes.rst:4613 +#: library/stdtypes.rst:4617 msgid "" "If *key* is in the dictionary, return its value. If not, insert *key* with " "a value of *default* and return *default*. *default* defaults to ``None``." msgstr "" -#: library/stdtypes.rst:4619 +#: library/stdtypes.rst:4623 msgid "" "Update the dictionary with the key/value pairs from *other*, overwriting " "existing keys. Return ``None``." msgstr "" -#: library/stdtypes.rst:4622 +#: library/stdtypes.rst:4626 msgid "" ":meth:`update` accepts either another dictionary object or an iterable of " "key/value pairs (as tuples or other iterables of length two). If keyword " @@ -5761,71 +5774,71 @@ msgid "" "pairs: ``d.update(red=1, blue=2)``." msgstr "" -#: library/stdtypes.rst:4629 +#: library/stdtypes.rst:4633 msgid "" "Return a new view of the dictionary's values. See the :ref:`documentation " "of view objects `." msgstr "" -#: library/stdtypes.rst:4632 +#: library/stdtypes.rst:4636 msgid "" "An equality comparison between one ``dict.values()`` view and another will " "always return ``False``. This also applies when comparing ``dict.values()`` " "to itself::" msgstr "" -#: library/stdtypes.rst:4642 +#: library/stdtypes.rst:4646 msgid "" "Create a new dictionary with the merged keys and values of *d* and *other*, " "which must both be dictionaries. The values of *other* take priority when " "*d* and *other* share keys." msgstr "" -#: library/stdtypes.rst:4650 +#: library/stdtypes.rst:4654 msgid "" "Update the dictionary *d* with keys and values from *other*, which may be " "either a :term:`mapping` or an :term:`iterable` of key/value pairs. The " "values of *other* take priority when *d* and *other* share keys." msgstr "" -#: library/stdtypes.rst:4656 +#: library/stdtypes.rst:4660 msgid "" "Dictionaries compare equal if and only if they have the same ``(key, " "value)`` pairs (regardless of ordering). Order comparisons ('<', '<=', '>=', " "'>') raise :exc:`TypeError`." msgstr "" -#: library/stdtypes.rst:4660 +#: library/stdtypes.rst:4664 msgid "" "Dictionaries preserve insertion order. Note that updating a key does not " "affect the order. Keys added after deletion are inserted at the end. ::" msgstr "" -#: library/stdtypes.rst:4678 +#: library/stdtypes.rst:4682 msgid "" "Dictionary order is guaranteed to be insertion order. This behavior was an " "implementation detail of CPython from 3.6." msgstr "" -#: library/stdtypes.rst:4682 +#: library/stdtypes.rst:4686 msgid "Dictionaries and dictionary views are reversible. ::" msgstr "" -#: library/stdtypes.rst:4694 +#: library/stdtypes.rst:4698 msgid "Dictionaries are now reversible." msgstr "" -#: library/stdtypes.rst:4699 +#: library/stdtypes.rst:4703 msgid "" ":class:`types.MappingProxyType` can be used to create a read-only view of a :" "class:`dict`." msgstr "" -#: library/stdtypes.rst:4706 +#: library/stdtypes.rst:4710 msgid "Dictionary view objects" msgstr "" -#: library/stdtypes.rst:4708 +#: library/stdtypes.rst:4712 msgid "" "The objects returned by :meth:`dict.keys`, :meth:`dict.values` and :meth:" "`dict.items` are *view objects*. They provide a dynamic view on the " @@ -5833,23 +5846,23 @@ msgid "" "reflects these changes." msgstr "" -#: library/stdtypes.rst:4713 +#: library/stdtypes.rst:4717 msgid "" "Dictionary views can be iterated over to yield their respective data, and " "support membership tests:" msgstr "" -#: library/stdtypes.rst:4718 +#: library/stdtypes.rst:4722 msgid "Return the number of entries in the dictionary." msgstr "" -#: library/stdtypes.rst:4722 +#: library/stdtypes.rst:4726 msgid "" "Return an iterator over the keys, values or items (represented as tuples of " "``(key, value)``) in the dictionary." msgstr "" -#: library/stdtypes.rst:4725 +#: library/stdtypes.rst:4729 msgid "" "Keys and values are iterated over in insertion order. This allows the " "creation of ``(value, key)`` pairs using :func:`zip`: ``pairs = zip(d." @@ -5857,39 +5870,39 @@ msgid "" "[(v, k) for (k, v) in d.items()]``." msgstr "" -#: library/stdtypes.rst:4730 +#: library/stdtypes.rst:4734 msgid "" "Iterating views while adding or deleting entries in the dictionary may raise " "a :exc:`RuntimeError` or fail to iterate over all entries." msgstr "" -#: library/stdtypes.rst:4733 +#: library/stdtypes.rst:4737 msgid "Dictionary order is guaranteed to be insertion order." msgstr "" -#: library/stdtypes.rst:4738 +#: library/stdtypes.rst:4742 msgid "" "Return ``True`` if *x* is in the underlying dictionary's keys, values or " "items (in the latter case, *x* should be a ``(key, value)`` tuple)." msgstr "" -#: library/stdtypes.rst:4743 +#: library/stdtypes.rst:4747 msgid "" "Return a reverse iterator over the keys, values or items of the dictionary. " "The view will be iterated in reverse order of the insertion." msgstr "" -#: library/stdtypes.rst:4746 +#: library/stdtypes.rst:4750 msgid "Dictionary views are now reversible." msgstr "" -#: library/stdtypes.rst:4751 +#: library/stdtypes.rst:4755 msgid "" "Return a :class:`types.MappingProxyType` that wraps the original dictionary " "to which the view refers." msgstr "" -#: library/stdtypes.rst:4756 +#: library/stdtypes.rst:4760 msgid "" "Keys views are set-like since their entries are unique and :term:`hashable`. " "Items views also have set-like operations since the (key, value) pairs are " @@ -5903,15 +5916,15 @@ msgid "" "input." msgstr "" -#: library/stdtypes.rst:4768 +#: library/stdtypes.rst:4772 msgid "An example of dictionary view usage::" msgstr "" -#: library/stdtypes.rst:4812 +#: library/stdtypes.rst:4816 msgid "Context Manager Types" msgstr "Bağlam Yöneticisi Türleri" -#: library/stdtypes.rst:4819 +#: library/stdtypes.rst:4823 msgid "" "Python's :keyword:`with` statement supports the concept of a runtime context " "defined by a context manager. This is implemented using a pair of methods " @@ -5919,7 +5932,7 @@ msgid "" "before the statement body is executed and exited when the statement ends:" msgstr "" -#: library/stdtypes.rst:4827 +#: library/stdtypes.rst:4831 msgid "" "Enter the runtime context and return either this object or another object " "related to the runtime context. The value returned by this method is bound " @@ -5927,14 +5940,14 @@ msgid "" "using this context manager." msgstr "" -#: library/stdtypes.rst:4832 +#: library/stdtypes.rst:4836 msgid "" "An example of a context manager that returns itself is a :term:`file " "object`. File objects return themselves from __enter__() to allow :func:" "`open` to be used as the context expression in a :keyword:`with` statement." msgstr "" -#: library/stdtypes.rst:4836 +#: library/stdtypes.rst:4840 msgid "" "An example of a context manager that returns a related object is the one " "returned by :func:`decimal.localcontext`. These managers set the active " @@ -5944,7 +5957,7 @@ msgid "" "the :keyword:`!with` statement." msgstr "" -#: library/stdtypes.rst:4846 +#: library/stdtypes.rst:4850 msgid "" "Exit the runtime context and return a Boolean flag indicating if any " "exception that occurred should be suppressed. If an exception occurred while " @@ -5953,7 +5966,7 @@ msgid "" "arguments are ``None``." msgstr "" -#: library/stdtypes.rst:4851 +#: library/stdtypes.rst:4855 msgid "" "Returning a true value from this method will cause the :keyword:`with` " "statement to suppress the exception and continue execution with the " @@ -5964,7 +5977,7 @@ msgid "" "statement." msgstr "" -#: library/stdtypes.rst:4858 +#: library/stdtypes.rst:4862 msgid "" "The exception passed in should never be reraised explicitly - instead, this " "method should return a false value to indicate that the method completed " @@ -5973,7 +5986,7 @@ msgid "" "__exit__` method has actually failed." msgstr "" -#: library/stdtypes.rst:4864 +#: library/stdtypes.rst:4868 msgid "" "Python defines several context managers to support easy thread " "synchronisation, prompt closure of files or other objects, and simpler " @@ -5982,7 +5995,7 @@ msgid "" "management protocol. See the :mod:`contextlib` module for some examples." msgstr "" -#: library/stdtypes.rst:4870 +#: library/stdtypes.rst:4874 msgid "" "Python's :term:`generator`\\s and the :class:`contextlib.contextmanager` " "decorator provide a convenient way to implement these protocols. If a " @@ -5992,7 +6005,7 @@ msgid "" "rather than the iterator produced by an undecorated generator function." msgstr "" -#: library/stdtypes.rst:4877 +#: library/stdtypes.rst:4881 msgid "" "Note that there is no specific slot for any of these methods in the type " "structure for Python objects in the Python/C API. Extension types wanting to " @@ -6001,23 +6014,23 @@ msgid "" "a single class dictionary lookup is negligible." msgstr "" -#: library/stdtypes.rst:4885 +#: library/stdtypes.rst:4889 msgid "" "Type Annotation Types --- :ref:`Generic Alias `, :ref:" "`Union `" msgstr "" -#: library/stdtypes.rst:4890 +#: library/stdtypes.rst:4894 msgid "" "The core built-in types for :term:`type annotations ` are :ref:" "`Generic Alias ` and :ref:`Union `." msgstr "" -#: library/stdtypes.rst:4897 +#: library/stdtypes.rst:4901 msgid "Generic Alias Type" msgstr "Genel Takma Ad Türü" -#: library/stdtypes.rst:4903 +#: library/stdtypes.rst:4907 msgid "" "``GenericAlias`` objects are generally created by :ref:`subscripting " "` a class. They are most often used with :ref:`container " @@ -6027,13 +6040,13 @@ msgid "" "are intended primarily for use with :term:`type annotations `." msgstr "" -#: library/stdtypes.rst:4913 +#: library/stdtypes.rst:4917 msgid "" "It is generally only possible to subscript a class if the class implements " "the special method :meth:`~object.__class_getitem__`." msgstr "" -#: library/stdtypes.rst:4916 +#: library/stdtypes.rst:4920 msgid "" "A ``GenericAlias`` object acts as a proxy for a :term:`generic type`, " "implementing *parameterized generics*." @@ -6041,7 +6054,7 @@ msgstr "" "Bir ``GenericAlias`` nesnesi, :term:`generic type` için bir vekil olarak " "hareket eder ve *parameterized generics* uygular." -#: library/stdtypes.rst:4919 +#: library/stdtypes.rst:4923 msgid "" "For a container class, the argument(s) supplied to a :ref:`subscription " "` of the class may indicate the type(s) of the elements an " @@ -6050,7 +6063,7 @@ msgid "" "`bytes`." msgstr "" -#: library/stdtypes.rst:4925 +#: library/stdtypes.rst:4929 msgid "" "For a class which defines :meth:`~object.__class_getitem__` but is not a " "container, the argument(s) supplied to a subscription of the class will " @@ -6059,7 +6072,7 @@ msgid "" "the :class:`str` data type and the :class:`bytes` data type:" msgstr "" -#: library/stdtypes.rst:4931 +#: library/stdtypes.rst:4935 msgid "" "If ``x = re.search('foo', 'foo')``, ``x`` will be a :ref:`re.Match ` object where the return values of ``x.group(0)`` and ``x[0]`` will " @@ -6067,7 +6080,7 @@ msgid "" "annotations with the ``GenericAlias`` ``re.Match[str]``." msgstr "" -#: library/stdtypes.rst:4937 +#: library/stdtypes.rst:4941 msgid "" "If ``y = re.search(b'bar', b'bar')``, (note the ``b`` for :class:`bytes`), " "``y`` will also be an instance of ``re.Match``, but the return values of ``y." @@ -6076,7 +6089,7 @@ msgid "" "objects>` objects with ``re.Match[bytes]``." msgstr "" -#: library/stdtypes.rst:4943 +#: library/stdtypes.rst:4947 msgid "" "``GenericAlias`` objects are instances of the class :class:`types." "GenericAlias`, which can also be used to create ``GenericAlias`` objects " @@ -6085,7 +6098,7 @@ msgstr "" "``GenericAlias`` nesneleri, doğrudan ``GenericAlias`` nesneleri oluşturmak " "için de kullanılabilen :class:`types.GenericAlias` sınıfının örnekleridir." -#: library/stdtypes.rst:4949 +#: library/stdtypes.rst:4953 msgid "" "Creates a ``GenericAlias`` representing a type ``T`` parameterized by types " "*X*, *Y*, and more depending on the ``T`` used. For example, a function " @@ -6096,7 +6109,7 @@ msgstr "" "Örneğin, :class:`float` elemanları içeren bir :class:`list` bekleyen bir " "fonksiyon::" -#: library/stdtypes.rst:4957 +#: library/stdtypes.rst:4961 msgid "" "Another example for :term:`mapping` objects, using a :class:`dict`, which is " "a generic type expecting two type parameters representing the key type and " @@ -6108,7 +6121,7 @@ msgstr "" "başka bir örnek. Bu örnekte, fonksiyon :class:`str` türünde anahtarları ve :" "class:`int` türünde değerleri olan bir ``dict`` bekler::" -#: library/stdtypes.rst:4965 +#: library/stdtypes.rst:4969 msgid "" "The builtin functions :func:`isinstance` and :func:`issubclass` do not " "accept ``GenericAlias`` types for their second argument::" @@ -6116,7 +6129,7 @@ msgstr "" "Yerleşik :func:`isinstance` ve :func:`issubclass` işlevleri ikinci " "argümanları için ``GenericAlias`` türlerini kabul etmez::" -#: library/stdtypes.rst:4973 +#: library/stdtypes.rst:4977 msgid "" "The Python runtime does not enforce :term:`type annotations `. " "This extends to generic types and their type parameters. When creating a " @@ -6130,7 +6143,7 @@ msgstr "" "elemanlar türlerine göre kontrol edilmez. Örneğin, aşağıdaki kod tavsiye " "edilmez, ancak hatasız çalışacaktır::" -#: library/stdtypes.rst:4983 +#: library/stdtypes.rst:4987 msgid "" "Furthermore, parameterized generics erase type parameters during object " "creation::" @@ -6138,7 +6151,7 @@ msgstr "" "Ayrıca, parametrelendirilmiş jenerikler nesne oluşturma sırasında tip " "parametrelerini siler::" -#: library/stdtypes.rst:4994 +#: library/stdtypes.rst:4998 msgid "" "Calling :func:`repr` or :func:`str` on a generic shows the parameterized " "type::" @@ -6146,7 +6159,7 @@ msgstr "" "Bir jenerik üzerinde :func:`repr` veya :func:`str` çağrısı " "parametrelendirilmiş türü gösterir::" -#: library/stdtypes.rst:5002 +#: library/stdtypes.rst:5006 msgid "" "The :meth:`~object.__getitem__` method of generic containers will raise an " "exception to disallow mistakes like ``dict[str][str]``::" @@ -6154,7 +6167,7 @@ msgstr "" "Genel kapsayıcıların :meth:`~object.__getitem__` metodu, ``dict[str][str]`` " "gibi hatalara izin vermemek için bir istisna oluşturacaktır::" -#: library/stdtypes.rst:5010 +#: library/stdtypes.rst:5014 msgid "" "However, such expressions are valid when :ref:`type variables ` " "are used. The index must have as many elements as there are type variable " @@ -6164,11 +6177,11 @@ msgstr "" "geçerlidir. Dizin, ``GenericAlias`` nesnesinin :attr:`~genericalias." "__args__` öğesindeki tür değişkeni öğeleri kadar öğeye sahip olmalıdır::" -#: library/stdtypes.rst:5021 +#: library/stdtypes.rst:5025 msgid "Standard Generic Classes" msgstr "Standart Jenerik Sınıflar" -#: library/stdtypes.rst:5023 +#: library/stdtypes.rst:5027 msgid "" "The following standard library classes support parameterized generics. This " "list is non-exhaustive." @@ -6176,235 +6189,235 @@ msgstr "" "Bu standart kütüphane sınıfları parametrelendirilmiş jenerikleri destekler. " "Bu liste kapsamlı değildir." -#: library/stdtypes.rst:5026 +#: library/stdtypes.rst:5030 msgid ":class:`tuple`" msgstr ":class:`tuple`" -#: library/stdtypes.rst:5027 +#: library/stdtypes.rst:5031 msgid ":class:`list`" msgstr ":class:`list`" -#: library/stdtypes.rst:5028 +#: library/stdtypes.rst:5032 msgid ":class:`dict`" msgstr ":class:`dict`" -#: library/stdtypes.rst:5029 +#: library/stdtypes.rst:5033 msgid ":class:`set`" msgstr ":class:`set`" -#: library/stdtypes.rst:5030 +#: library/stdtypes.rst:5034 msgid ":class:`frozenset`" msgstr ":class:`frozenset`" -#: library/stdtypes.rst:5031 +#: library/stdtypes.rst:5035 msgid ":class:`type`" msgstr ":class:`type`" -#: library/stdtypes.rst:5032 +#: library/stdtypes.rst:5036 msgid ":class:`collections.deque`" msgstr ":class:`collections.deque`" -#: library/stdtypes.rst:5033 +#: library/stdtypes.rst:5037 msgid ":class:`collections.defaultdict`" msgstr ":class:`collections.defaultdict`" -#: library/stdtypes.rst:5034 +#: library/stdtypes.rst:5038 msgid ":class:`collections.OrderedDict`" msgstr ":class:`collections.OrderedDict`" -#: library/stdtypes.rst:5035 +#: library/stdtypes.rst:5039 msgid ":class:`collections.Counter`" msgstr ":class:`collections.Counter`" -#: library/stdtypes.rst:5036 +#: library/stdtypes.rst:5040 msgid ":class:`collections.ChainMap`" msgstr ":class:`collections.ChainMap`" -#: library/stdtypes.rst:5037 +#: library/stdtypes.rst:5041 msgid ":class:`collections.abc.Awaitable`" msgstr ":class:`collections.abc.Awaitable`" -#: library/stdtypes.rst:5038 +#: library/stdtypes.rst:5042 msgid ":class:`collections.abc.Coroutine`" msgstr ":class:`collections.abc.Coroutine`" -#: library/stdtypes.rst:5039 +#: library/stdtypes.rst:5043 msgid ":class:`collections.abc.AsyncIterable`" msgstr ":class:`collections.abc.AsyncIterable`" -#: library/stdtypes.rst:5040 +#: library/stdtypes.rst:5044 msgid ":class:`collections.abc.AsyncIterator`" msgstr ":class:`collections.abc.AsyncIterator`" -#: library/stdtypes.rst:5041 +#: library/stdtypes.rst:5045 msgid ":class:`collections.abc.AsyncGenerator`" msgstr ":class:`collections.abc.AsyncGenerator`" -#: library/stdtypes.rst:5042 +#: library/stdtypes.rst:5046 msgid ":class:`collections.abc.Iterable`" msgstr ":class:`collections.abc.Iterable`" -#: library/stdtypes.rst:5043 +#: library/stdtypes.rst:5047 msgid ":class:`collections.abc.Iterator`" msgstr ":class:`collections.abc.Iterator`" -#: library/stdtypes.rst:5044 +#: library/stdtypes.rst:5048 msgid ":class:`collections.abc.Generator`" msgstr ":class:`collections.abc.Generator`" -#: library/stdtypes.rst:5045 +#: library/stdtypes.rst:5049 msgid ":class:`collections.abc.Reversible`" msgstr ":class:`collections.abc.Reversible`" -#: library/stdtypes.rst:5046 +#: library/stdtypes.rst:5050 msgid ":class:`collections.abc.Container`" msgstr ":class:`collections.abc.Container`" -#: library/stdtypes.rst:5047 +#: library/stdtypes.rst:5051 msgid ":class:`collections.abc.Collection`" msgstr ":class:`collections.abc.Collection`" -#: library/stdtypes.rst:5048 +#: library/stdtypes.rst:5052 msgid ":class:`collections.abc.Callable`" msgstr ":class:`collections.abc.Callable`" -#: library/stdtypes.rst:5049 +#: library/stdtypes.rst:5053 msgid ":class:`collections.abc.Set`" msgstr ":class:`collections.abc.Set`" -#: library/stdtypes.rst:5050 +#: library/stdtypes.rst:5054 msgid ":class:`collections.abc.MutableSet`" msgstr ":class:`collections.abc.MutableSet`" -#: library/stdtypes.rst:5051 +#: library/stdtypes.rst:5055 msgid ":class:`collections.abc.Mapping`" msgstr ":class:`collections.abc.Mapping`" -#: library/stdtypes.rst:5052 +#: library/stdtypes.rst:5056 msgid ":class:`collections.abc.MutableMapping`" msgstr ":class:`collections.abc.MutableMapping`" -#: library/stdtypes.rst:5053 +#: library/stdtypes.rst:5057 msgid ":class:`collections.abc.Sequence`" msgstr ":class:`collections.abc.Sequence`" -#: library/stdtypes.rst:5054 +#: library/stdtypes.rst:5058 msgid ":class:`collections.abc.MutableSequence`" msgstr ":class:`collections.abc.MutableSequence`" -#: library/stdtypes.rst:5055 +#: library/stdtypes.rst:5059 msgid ":class:`collections.abc.ByteString`" msgstr ":class:`collections.abc.ByteString`" -#: library/stdtypes.rst:5056 +#: library/stdtypes.rst:5060 msgid ":class:`collections.abc.MappingView`" msgstr ":class:`collections.abc.MappingView`" -#: library/stdtypes.rst:5057 +#: library/stdtypes.rst:5061 msgid ":class:`collections.abc.KeysView`" msgstr ":class:`collections.abc.KeysView`" -#: library/stdtypes.rst:5058 +#: library/stdtypes.rst:5062 msgid ":class:`collections.abc.ItemsView`" msgstr ":class:`collections.abc.ItemsView`" -#: library/stdtypes.rst:5059 +#: library/stdtypes.rst:5063 msgid ":class:`collections.abc.ValuesView`" msgstr ":class:`collections.abc.ValuesView`" -#: library/stdtypes.rst:5060 +#: library/stdtypes.rst:5064 msgid ":class:`contextlib.AbstractContextManager`" msgstr ":class:`contextlib.AbstractContextManager`" -#: library/stdtypes.rst:5061 +#: library/stdtypes.rst:5065 msgid ":class:`contextlib.AbstractAsyncContextManager`" msgstr ":class:`contextlib.AbstractAsyncContextManager`" -#: library/stdtypes.rst:5062 +#: library/stdtypes.rst:5066 msgid ":class:`dataclasses.Field`" msgstr ":class:`dataclasses.Field`" -#: library/stdtypes.rst:5063 +#: library/stdtypes.rst:5067 msgid ":class:`functools.cached_property`" msgstr ":class:`functools.cached_property`" -#: library/stdtypes.rst:5064 +#: library/stdtypes.rst:5068 msgid ":class:`functools.partialmethod`" msgstr "" -#: library/stdtypes.rst:5065 +#: library/stdtypes.rst:5069 msgid ":class:`os.PathLike`" msgstr ":class:`os.PathLike`" -#: library/stdtypes.rst:5066 +#: library/stdtypes.rst:5070 msgid ":class:`queue.LifoQueue`" msgstr ":class:`queue.LifoQueue`" -#: library/stdtypes.rst:5067 +#: library/stdtypes.rst:5071 msgid ":class:`queue.Queue`" msgstr ":class:`queue.Queue`" -#: library/stdtypes.rst:5068 +#: library/stdtypes.rst:5072 msgid ":class:`queue.PriorityQueue`" msgstr ":class:`queue.PriorityQueue`" -#: library/stdtypes.rst:5069 +#: library/stdtypes.rst:5073 msgid ":class:`queue.SimpleQueue`" msgstr ":class:`tuple`" -#: library/stdtypes.rst:5070 +#: library/stdtypes.rst:5074 msgid ":ref:`re.Pattern `" msgstr ":ref:`re.Pattern `" -#: library/stdtypes.rst:5071 +#: library/stdtypes.rst:5075 msgid ":ref:`re.Match `" msgstr ":ref:`re.Match `" -#: library/stdtypes.rst:5072 +#: library/stdtypes.rst:5076 msgid ":class:`shelve.BsdDbShelf`" msgstr ":class:`shelve.BsdDbShelf`" -#: library/stdtypes.rst:5073 +#: library/stdtypes.rst:5077 msgid ":class:`shelve.DbfilenameShelf`" msgstr ":class:`shelve.DbfilenameShelf`" -#: library/stdtypes.rst:5074 +#: library/stdtypes.rst:5078 msgid ":class:`shelve.Shelf`" msgstr ":class:`shelve.Shelf`" -#: library/stdtypes.rst:5075 +#: library/stdtypes.rst:5079 msgid ":class:`types.MappingProxyType`" msgstr ":class:`types.MappingProxyType`" -#: library/stdtypes.rst:5076 +#: library/stdtypes.rst:5080 msgid ":class:`weakref.WeakKeyDictionary`" msgstr "" -#: library/stdtypes.rst:5077 +#: library/stdtypes.rst:5081 msgid ":class:`weakref.WeakMethod`" msgstr "" -#: library/stdtypes.rst:5078 +#: library/stdtypes.rst:5082 msgid ":class:`weakref.WeakSet`" msgstr ":class:`weakref.WeakSet`" -#: library/stdtypes.rst:5079 +#: library/stdtypes.rst:5083 msgid ":class:`weakref.WeakValueDictionary`" msgstr "" -#: library/stdtypes.rst:5084 +#: library/stdtypes.rst:5088 msgid "Special Attributes of ``GenericAlias`` objects" msgstr "``GenericAlias`` objesinin Özel Öznitelikleri" -#: library/stdtypes.rst:5086 +#: library/stdtypes.rst:5090 msgid "All parameterized generics implement special read-only attributes." msgstr "Tüm parametreli jenerikler özel salt okunur öznitelikler uygular." -#: library/stdtypes.rst:5090 +#: library/stdtypes.rst:5094 msgid "This attribute points at the non-parameterized generic class::" msgstr "Bu öznitelik, parametrelendirilmemiş genel sınıfa işaret eder::" -#: library/stdtypes.rst:5098 +#: library/stdtypes.rst:5102 msgid "" "This attribute is a :class:`tuple` (possibly of length 1) of generic types " "passed to the original :meth:`~object.__class_getitem__` of the generic " @@ -6414,7 +6427,7 @@ msgstr "" "öğesine iletilen jenerik tiplerinden bir :class:`tuple` 'dır (muhtemelen 1 " "uzunluğunda)::" -#: library/stdtypes.rst:5108 +#: library/stdtypes.rst:5112 msgid "" "This attribute is a lazily computed tuple (possibly empty) of unique type " "variables found in ``__args__``::" @@ -6422,7 +6435,7 @@ msgstr "" "Bu öznitelik, ''__args__'' içinde bulunan benzersiz tür değişkenlerin tembel " "bir şekilde hesaplanmış bir demetidir (muhtemelen boş):" -#: library/stdtypes.rst:5119 +#: library/stdtypes.rst:5123 msgid "" "A ``GenericAlias`` object with :class:`typing.ParamSpec` parameters may not " "have correct ``__parameters__`` after substitution because :class:`typing." @@ -6432,49 +6445,49 @@ msgstr "" "değiştirildikten sonra doğru ``__parameters__`` olmayabilir çünkü :class:" "`typing.ParamSpec` öncelikle statik tip kontrolü için tasarlanmıştır." -#: library/stdtypes.rst:5126 +#: library/stdtypes.rst:5130 msgid "" "A boolean that is true if the alias has been unpacked using the ``*`` " "operator (see :data:`~typing.TypeVarTuple`)." msgstr "" -#: library/stdtypes.rst:5134 +#: library/stdtypes.rst:5138 msgid ":pep:`484` - Type Hints" msgstr "" -#: library/stdtypes.rst:5135 +#: library/stdtypes.rst:5139 msgid "Introducing Python's framework for type annotations." msgstr "" -#: library/stdtypes.rst:5137 +#: library/stdtypes.rst:5141 msgid ":pep:`585` - Type Hinting Generics In Standard Collections" msgstr "" ":pep:`585` - Standart Koleksiyonlarda Tip İma Etme (Type Hinting) Jenerikleri" -#: library/stdtypes.rst:5138 +#: library/stdtypes.rst:5142 msgid "" "Introducing the ability to natively parameterize standard-library classes, " "provided they implement the special class method :meth:`~object." "__class_getitem__`." msgstr "" -#: library/stdtypes.rst:5142 +#: library/stdtypes.rst:5146 msgid "" ":ref:`Generics`, :ref:`user-defined generics ` and :" "class:`typing.Generic`" msgstr "" -#: library/stdtypes.rst:5143 +#: library/stdtypes.rst:5147 msgid "" "Documentation on how to implement generic classes that can be parameterized " "at runtime and understood by static type-checkers." msgstr "" -#: library/stdtypes.rst:5152 +#: library/stdtypes.rst:5156 msgid "Union Type" msgstr "Sendika Türü" -#: library/stdtypes.rst:5158 +#: library/stdtypes.rst:5162 msgid "" "A union object holds the value of the ``|`` (bitwise or) operation on " "multiple :ref:`type objects `. These types are intended " @@ -6488,7 +6501,7 @@ msgstr "" "Birleşim türü ifadesi, aşağıdakilere kıyasla daha temiz tür ipucu sözdizimi " "sağlar :data:`typing.Union`." -#: library/stdtypes.rst:5165 +#: library/stdtypes.rst:5169 msgid "" "Defines a union object which holds types *X*, *Y*, and so forth. ``X | Y`` " "means either X or Y. It is equivalent to ``typing.Union[X, Y]``. For " @@ -6499,7 +6512,7 @@ msgstr "" "anlamına gelir. Bu, ``typing.Union[X, Y]`` ile eş değerdir. Örneğin, " "aşağıdaki işlev :class:`int` veya :class:`float`::" -#: library/stdtypes.rst:5175 +#: library/stdtypes.rst:5179 msgid "" "The ``|`` operand cannot be used at runtime to define unions where one or " "more members is a forward reference. For example, ``int | \"Foo\"``, where " @@ -6508,34 +6521,34 @@ msgid "" "a string, e.g. ``\"int | Foo\"``." msgstr "" -#: library/stdtypes.rst:5183 +#: library/stdtypes.rst:5187 msgid "" "Union objects can be tested for equality with other union objects. Details:" msgstr "" "Birlik nesneleri, diğer birlik nesneleriyle eşitlik açısından test " "edilebilir. Detaylar:" -#: library/stdtypes.rst:5185 +#: library/stdtypes.rst:5189 msgid "Unions of unions are flattened::" msgstr "Birliklerin birlikleri düzleştirimiştir::" -#: library/stdtypes.rst:5189 +#: library/stdtypes.rst:5193 msgid "Redundant types are removed::" msgstr "Gereksiz türler kaldırılır::" -#: library/stdtypes.rst:5193 +#: library/stdtypes.rst:5197 msgid "When comparing unions, the order is ignored::" msgstr "Birlikleri karşılaştırırken, sipariş göz ardı edilir::" -#: library/stdtypes.rst:5197 +#: library/stdtypes.rst:5201 msgid "It is compatible with :data:`typing.Union`::" msgstr ":data:`typing.Union`:: ile uyumludur:" -#: library/stdtypes.rst:5201 +#: library/stdtypes.rst:5205 msgid "Optional types can be spelled as a union with ``None``::" msgstr "İsteğe bağlı türler ``None``:: ile bir birlik olarak yazılabilir:" -#: library/stdtypes.rst:5208 +#: library/stdtypes.rst:5212 msgid "" "Calls to :func:`isinstance` and :func:`issubclass` are also supported with a " "union object::" @@ -6543,14 +6556,14 @@ msgstr "" ":func:`isinstance` ve :func:`issubclass` çağrıları da bir birlik nesnesiyle " "desteklenir::" -#: library/stdtypes.rst:5214 +#: library/stdtypes.rst:5218 #, fuzzy msgid "" "However, :ref:`parameterized generics ` in union objects " "cannot be checked::" msgstr "Ancak, :ref:`types-genericalias` içeren union nesneleri kullanılamaz::" -#: library/stdtypes.rst:5224 +#: library/stdtypes.rst:5228 msgid "" "The user-exposed type for the union object can be accessed from :data:`types." "UnionType` and used for :func:`isinstance` checks. An object cannot be " @@ -6560,7 +6573,7 @@ msgstr "" "erişilebilir ve :func:`isinstance` kontrolleri için kullanılabilir. Bir " "nesne şu türden örneklenemez::" -#: library/stdtypes.rst:5237 +#: library/stdtypes.rst:5241 #, fuzzy msgid "" "The :meth:`!__or__` method for type objects was added to support the syntax " @@ -6571,15 +6584,15 @@ msgstr "" "için eklendi. Eğer bir metaclass :meth:`__or__` metodunu uygularsa, Union " "bunu geçersiz kılabilir::" -#: library/stdtypes.rst:5257 +#: library/stdtypes.rst:5261 msgid ":pep:`604` -- PEP proposing the ``X | Y`` syntax and the Union type." msgstr ":pep:`604` -- ``X | Y`` sözdizimini ve Birlik türünü öneren PEP." -#: library/stdtypes.rst:5265 +#: library/stdtypes.rst:5269 msgid "Other Built-in Types" msgstr "Diğer Yerleşik Tipler" -#: library/stdtypes.rst:5267 +#: library/stdtypes.rst:5271 msgid "" "The interpreter supports several other kinds of objects. Most of these " "support only one or two operations." @@ -6587,11 +6600,11 @@ msgstr "" "Yorumlayıcı başka nesne türlerini de destekler. Bunların çoğu yalnızca bir " "veya iki işlemi destekler." -#: library/stdtypes.rst:5274 +#: library/stdtypes.rst:5278 msgid "Modules" msgstr "Modüller" -#: library/stdtypes.rst:5276 +#: library/stdtypes.rst:5280 msgid "" "The only special operation on a module is attribute access: ``m.name``, " "where *m* is a module and *name* accesses a name defined in *m*'s symbol " @@ -6609,7 +6622,7 @@ msgstr "" "bunun yerine bir yerlerde *foo* adında bir modül için (harici) bir " "*tanımlama* gerektirir)" -#: library/stdtypes.rst:5283 +#: library/stdtypes.rst:5287 msgid "" "A special attribute of every module is :attr:`~object.__dict__`. This is the " "dictionary containing the module's symbol table. Modifying this dictionary " @@ -6627,7 +6640,7 @@ msgstr "" "`` yazamazsınız). :attr:`~object.__dict__` öğesinin doğrudan değiştirilmesi " "önerilmez." -#: library/stdtypes.rst:5291 +#: library/stdtypes.rst:5295 msgid "" "Modules built into the interpreter are written like this: ````. If loaded from a file, they are written as ````. Eğer bir dosyadan yüklenmişlerse, ```` şeklinde yazılırlar." -#: library/stdtypes.rst:5299 +#: library/stdtypes.rst:5303 msgid "Classes and Class Instances" msgstr "Sınıflar ve Sınıf Örnekleri" -#: library/stdtypes.rst:5301 +#: library/stdtypes.rst:5305 msgid "See :ref:`objects` and :ref:`class` for these." msgstr "Bunlar için :ref:`class` ve :ref:`objects` bakın." -#: library/stdtypes.rst:5307 +#: library/stdtypes.rst:5311 msgid "Functions" msgstr "Fonksiyonlar" -#: library/stdtypes.rst:5309 +#: library/stdtypes.rst:5313 msgid "" "Function objects are created by function definitions. The only operation on " "a function object is to call it: ``func(argument-list)``." @@ -6658,7 +6671,7 @@ msgstr "" "fonksiyon nesnesi üzerindeki tek işlem onu çağırmaktır: ``func(argument-" "list)``." -#: library/stdtypes.rst:5312 +#: library/stdtypes.rst:5316 msgid "" "There are really two flavors of function objects: built-in functions and " "user-defined functions. Both support the same operation (to call the " @@ -6670,15 +6683,15 @@ msgstr "" "çağırmak için), ancak uygulama farklıdır, dolayısıyla farklı nesne türleri " "vardır." -#: library/stdtypes.rst:5316 +#: library/stdtypes.rst:5320 msgid "See :ref:`function` for more information." msgstr "Daha fazla bilgi için :ref:`function` bölümüne bakınız." -#: library/stdtypes.rst:5322 +#: library/stdtypes.rst:5326 msgid "Methods" msgstr "Yöntemler" -#: library/stdtypes.rst:5326 +#: library/stdtypes.rst:5330 #, fuzzy msgid "" "Methods are functions that are called using the attribute notation. There " @@ -6691,7 +6704,7 @@ msgstr "" "yöntemleri. Yerleşik yöntemler, onları destekleyen türlerle birlikte " "tanımlanır." -#: library/stdtypes.rst:5331 +#: library/stdtypes.rst:5335 #, fuzzy msgid "" "If you access a method (a function defined in a class namespace) through an " @@ -6713,7 +6726,7 @@ msgstr "" "``m(arg-1, arg-2, ..., arg-n)`` çağrısı tamamen ``m.__func__(m.__self__, " "arg-1, arg-2, ..., arg-n)`` çağrısına eş değerdir." -#: library/stdtypes.rst:5342 +#: library/stdtypes.rst:5346 #, fuzzy msgid "" "Like :ref:`function objects `, bound method objects " @@ -6732,16 +6745,16 @@ msgstr "" "ayarlamak için, bunu temel işlev nesnesi üzerinde açıkça ayarlamanız " "gerekir::" -#: library/stdtypes.rst:5365 +#: library/stdtypes.rst:5369 #, fuzzy msgid "See :ref:`instance-methods` for more information." msgstr "Daha fazla bilgi için :ref:`types` sayfasına bakın." -#: library/stdtypes.rst:5373 +#: library/stdtypes.rst:5377 msgid "Code Objects" msgstr "Kod Nesneleri" -#: library/stdtypes.rst:5379 +#: library/stdtypes.rst:5383 #, fuzzy msgid "" "Code objects are used by the implementation to represent \"pseudo-compiled\" " @@ -6758,7 +6771,7 @@ msgstr "" "tarafından döndürülür ve :attr:`__code__` niteliği aracılığıyla işlev " "nesnelerinden çıkarılabilir. Ayrıca :mod:`code` modülüne de bakınız." -#: library/stdtypes.rst:5386 +#: library/stdtypes.rst:5390 #, fuzzy msgid "" "Accessing :attr:`~function.__code__` raises an :ref:`auditing event " @@ -6768,7 +6781,7 @@ msgstr "" "``__code__`` 'e erişmek,``obj`` ve ``\"__code__\"`` argümanlarıyla :ref:" "`denetim etkinliği ` ``object.__getattr__`` oluşturur." -#: library/stdtypes.rst:5393 +#: library/stdtypes.rst:5397 msgid "" "A code object can be executed or evaluated by passing it (instead of a " "source string) to the :func:`exec` or :func:`eval` built-in functions." @@ -6776,15 +6789,15 @@ msgstr "" "Bir kod nesnesi (kaynak dize yerine) :func:`exec` veya :func:`eval` yerleşik " "işlevlerine geçirilerek yürütülebilir veya değerlendirilebilir." -#: library/stdtypes.rst:5396 +#: library/stdtypes.rst:5400 msgid "See :ref:`types` for more information." msgstr "Daha fazla bilgi için :ref:`types` sayfasına bakın." -#: library/stdtypes.rst:5402 +#: library/stdtypes.rst:5406 msgid "Type Objects" msgstr "Type Objects" -#: library/stdtypes.rst:5408 +#: library/stdtypes.rst:5412 msgid "" "Type objects represent the various object types. An object's type is " "accessed by the built-in function :func:`type`. There are no special " @@ -6796,15 +6809,15 @@ msgstr "" "işlem yoktur. Standart modül :mod:`types` tüm standart yerleşik türler için " "isimleri tanımlar." -#: library/stdtypes.rst:5413 +#: library/stdtypes.rst:5417 msgid "Types are written like this: ````." msgstr "Türler şu şekilde yazılır: ````." -#: library/stdtypes.rst:5419 +#: library/stdtypes.rst:5423 msgid "The Null Object" msgstr "Null Nesne" -#: library/stdtypes.rst:5421 +#: library/stdtypes.rst:5425 msgid "" "This object is returned by functions that don't explicitly return a value. " "It supports no special operations. There is exactly one null object, named " @@ -6814,15 +6827,15 @@ msgstr "" "operasyonları desteklemez. Tam olarak ``None`` (yerleşik bir ad) adlı bir " "null nesne vardır. ``type(None)()`` aynı singleton'u üretir." -#: library/stdtypes.rst:5425 +#: library/stdtypes.rst:5429 msgid "It is written as ``None``." msgstr "''Yok'' olarak yazılmıştır." -#: library/stdtypes.rst:5432 +#: library/stdtypes.rst:5436 msgid "The Ellipsis Object" msgstr "Üç Nokta Nesnesi" -#: library/stdtypes.rst:5434 +#: library/stdtypes.rst:5438 msgid "" "This object is commonly used by slicing (see :ref:`slicings`). It supports " "no special operations. There is exactly one ellipsis object, named :const:" @@ -6834,15 +6847,15 @@ msgstr "" "ad) adında bir elips nesnesi vardır. ``type(Ellipsis)()``, :const:" "`Ellipsis` singletonunu üretir." -#: library/stdtypes.rst:5439 +#: library/stdtypes.rst:5443 msgid "It is written as ``Ellipsis`` or ``...``." msgstr "``Ellipsis`` veya ``...`` olarak yazılmıştır." -#: library/stdtypes.rst:5445 +#: library/stdtypes.rst:5449 msgid "The NotImplemented Object" msgstr "NotImplemented Nesnesi" -#: library/stdtypes.rst:5447 +#: library/stdtypes.rst:5451 #, fuzzy msgid "" "This object is returned from comparisons and binary operations when they are " @@ -6855,16 +6868,16 @@ msgstr "" "ref:`comparisons` sayfasına bakın. Tam olarak bir ``NotImplemented`` " "nesnesi vardır. ``type(NotImplemented)()``, singleton örneğini üretir." -#: library/stdtypes.rst:5452 +#: library/stdtypes.rst:5456 #, fuzzy msgid "It is written as :code:`NotImplemented`." msgstr "''NotImplemented'' olarak yazılmıştır." -#: library/stdtypes.rst:5458 +#: library/stdtypes.rst:5462 msgid "Internal Objects" msgstr "İç Nesneler" -#: library/stdtypes.rst:5460 +#: library/stdtypes.rst:5464 #, fuzzy msgid "" "See :ref:`types` for this information. It describes :ref:`stack frame " @@ -6874,11 +6887,11 @@ msgstr "" "Bu bilgi için :ref:`types` sayfasına bakın. Yığın çerçeve nesnelerini, geri " "izleme nesnelerini ve dilim nesnelerini açıklar." -#: library/stdtypes.rst:5468 +#: library/stdtypes.rst:5472 msgid "Special Attributes" msgstr "Özel Özellikler" -#: library/stdtypes.rst:5470 +#: library/stdtypes.rst:5474 msgid "" "The implementation adds a few special read-only attributes to several object " "types, where they are relevant. Some of these are not reported by the :func:" @@ -6888,7 +6901,7 @@ msgstr "" "öznitelik ekler. Bunlardan bazıları :func:`dir` yerleşik işlevi tarafından " "bildirilmez." -#: library/stdtypes.rst:5477 +#: library/stdtypes.rst:5481 msgid "" "A dictionary or other mapping object used to store an object's (writable) " "attributes." @@ -6896,20 +6909,20 @@ msgstr "" "Bir nesnenin (yazılabilir) özniteliklerini depolamak için kullanılan sözlük " "veya başka bir eşleme nesnesi." -#: library/stdtypes.rst:5483 +#: library/stdtypes.rst:5487 msgid "The class to which a class instance belongs." msgstr "Bir sınıf örneğinin ait olduğu sınıf." -#: library/stdtypes.rst:5488 +#: library/stdtypes.rst:5492 msgid "The tuple of base classes of a class object." msgstr "Bir sınıf elemanının temel sınıflarının kümesi." -#: library/stdtypes.rst:5493 +#: library/stdtypes.rst:5497 msgid "" "The name of the class, function, method, descriptor, or generator instance." msgstr "Sınıf, fonksiyon, yöntem, tanımlayıcı veya üretici örneğinin adı." -#: library/stdtypes.rst:5499 +#: library/stdtypes.rst:5503 msgid "" "The :term:`qualified name` of the class, function, method, descriptor, or " "generator instance." @@ -6917,13 +6930,13 @@ msgstr "" "Sınıf, fonksiyon, yöntem, tanımlayıcı veya üretici örneğinin :term:" "`qualified name`." -#: library/stdtypes.rst:5507 +#: library/stdtypes.rst:5511 msgid "" "The :ref:`type parameters ` of generic classes, functions, and :" "ref:`type aliases `." msgstr "" -#: library/stdtypes.rst:5515 +#: library/stdtypes.rst:5519 msgid "" "This attribute is a tuple of classes that are considered when looking for " "base classes during method resolution." @@ -6931,7 +6944,7 @@ msgstr "" "Bu öznitelik, yöntem çözümlemesi sırasında temel sınıfları ararken dikkate " "alınan bir sınıf kümesidir." -#: library/stdtypes.rst:5521 +#: library/stdtypes.rst:5525 msgid "" "This method can be overridden by a metaclass to customize the method " "resolution order for its instances. It is called at class instantiation, " @@ -6941,7 +6954,7 @@ msgstr "" "meta sınıf tarafından geçersiz kılınabilir. Sınıf örneğinde çağrılır ve " "sonucu :attr:`~class.__mro__` içinde depolanır." -#: library/stdtypes.rst:5528 +#: library/stdtypes.rst:5532 msgid "" "Each class keeps a list of weak references to its immediate subclasses. " "This method returns a list of all those references still alive. The list is " @@ -6951,11 +6964,11 @@ msgstr "" "tutar. Bu yöntem, hala var olan tüm bu başvuruların bir listesini " "döndürür. Liste tanım sırasına göredir. Örnek::" -#: library/stdtypes.rst:5539 +#: library/stdtypes.rst:5543 msgid "Integer string conversion length limitation" msgstr "" -#: library/stdtypes.rst:5541 +#: library/stdtypes.rst:5545 msgid "" "CPython has a global limit for converting between :class:`int` and :class:" "`str` to mitigate denial of service attacks. This limit *only* applies to " @@ -6963,7 +6976,7 @@ msgid "" "binary conversions are unlimited. The limit can be configured." msgstr "" -#: library/stdtypes.rst:5546 +#: library/stdtypes.rst:5550 msgid "" "The :class:`int` type in CPython is an arbitrary length number stored in " "binary form (commonly known as a \"bignum\"). There exists no algorithm that " @@ -6973,24 +6986,24 @@ msgid "" "value such as ``int('1' * 500_000)`` can take over a second on a fast CPU." msgstr "" -#: library/stdtypes.rst:5553 +#: library/stdtypes.rst:5557 msgid "" "Limiting conversion size offers a practical way to avoid :cve:`2020-10735`." msgstr "" -#: library/stdtypes.rst:5555 +#: library/stdtypes.rst:5559 msgid "" "The limit is applied to the number of digit characters in the input or " "output string when a non-linear conversion algorithm would be involved. " "Underscores and the sign are not counted towards the limit." msgstr "" -#: library/stdtypes.rst:5559 +#: library/stdtypes.rst:5563 msgid "" "When an operation would exceed the limit, a :exc:`ValueError` is raised:" msgstr "" -#: library/stdtypes.rst:5581 +#: library/stdtypes.rst:5585 msgid "" "The default limit is 4300 digits as provided in :data:`sys.int_info." "default_max_str_digits `. The lowest limit that can be " @@ -6998,95 +7011,95 @@ msgid "" "str_digits_check_threshold `." msgstr "" -#: library/stdtypes.rst:5586 +#: library/stdtypes.rst:5590 msgid "Verification:" msgstr "Doğrulama" -#: library/stdtypes.rst:5601 +#: library/stdtypes.rst:5605 msgid "Affected APIs" msgstr "" -#: library/stdtypes.rst:5603 +#: library/stdtypes.rst:5607 msgid "" "The limitation only applies to potentially slow conversions between :class:" "`int` and :class:`str` or :class:`bytes`:" msgstr "" -#: library/stdtypes.rst:5606 +#: library/stdtypes.rst:5610 msgid "``int(string)`` with default base 10." msgstr "" -#: library/stdtypes.rst:5607 +#: library/stdtypes.rst:5611 msgid "``int(string, base)`` for all bases that are not a power of 2." msgstr "" -#: library/stdtypes.rst:5608 +#: library/stdtypes.rst:5612 msgid "``str(integer)``." msgstr "" -#: library/stdtypes.rst:5609 +#: library/stdtypes.rst:5613 msgid "``repr(integer)``." msgstr "" -#: library/stdtypes.rst:5610 +#: library/stdtypes.rst:5614 msgid "" "any other string conversion to base 10, for example ``f\"{integer}\"``, " "``\"{}\".format(integer)``, or ``b\"%d\" % integer``." msgstr "" -#: library/stdtypes.rst:5613 +#: library/stdtypes.rst:5617 msgid "The limitations do not apply to functions with a linear algorithm:" msgstr "" -#: library/stdtypes.rst:5615 +#: library/stdtypes.rst:5619 msgid "``int(string, base)`` with base 2, 4, 8, 16, or 32." msgstr "" -#: library/stdtypes.rst:5616 +#: library/stdtypes.rst:5620 msgid ":func:`int.from_bytes` and :func:`int.to_bytes`." msgstr "" -#: library/stdtypes.rst:5617 +#: library/stdtypes.rst:5621 msgid ":func:`hex`, :func:`oct`, :func:`bin`." msgstr "" -#: library/stdtypes.rst:5618 +#: library/stdtypes.rst:5622 msgid ":ref:`formatspec` for hex, octal, and binary numbers." msgstr "" -#: library/stdtypes.rst:5619 +#: library/stdtypes.rst:5623 #, fuzzy msgid ":class:`str` to :class:`float`." msgstr ":class:`str` 'den :class:`float` 'a." -#: library/stdtypes.rst:5620 +#: library/stdtypes.rst:5624 msgid ":class:`str` to :class:`decimal.Decimal`." msgstr "" -#: library/stdtypes.rst:5623 +#: library/stdtypes.rst:5627 msgid "Configuring the limit" msgstr "" -#: library/stdtypes.rst:5625 +#: library/stdtypes.rst:5629 msgid "" "Before Python starts up you can use an environment variable or an " "interpreter command line flag to configure the limit:" msgstr "" -#: library/stdtypes.rst:5628 +#: library/stdtypes.rst:5632 msgid "" ":envvar:`PYTHONINTMAXSTRDIGITS`, e.g. ``PYTHONINTMAXSTRDIGITS=640 python3`` " "to set the limit to 640 or ``PYTHONINTMAXSTRDIGITS=0 python3`` to disable " "the limitation." msgstr "" -#: library/stdtypes.rst:5631 +#: library/stdtypes.rst:5635 msgid "" ":option:`-X int_max_str_digits <-X>`, e.g. ``python3 -X " "int_max_str_digits=640``" msgstr "" -#: library/stdtypes.rst:5633 +#: library/stdtypes.rst:5637 msgid "" ":data:`sys.flags.int_max_str_digits` contains the value of :envvar:" "`PYTHONINTMAXSTRDIGITS` or :option:`-X int_max_str_digits <-X>`. If both the " @@ -7095,38 +7108,38 @@ msgid "" "int_info.default_max_str_digits` was used during initialization." msgstr "" -#: library/stdtypes.rst:5639 +#: library/stdtypes.rst:5643 msgid "" "From code, you can inspect the current limit and set a new one using these :" "mod:`sys` APIs:" msgstr "" -#: library/stdtypes.rst:5642 +#: library/stdtypes.rst:5646 msgid "" ":func:`sys.get_int_max_str_digits` and :func:`sys.set_int_max_str_digits` " "are a getter and setter for the interpreter-wide limit. Subinterpreters have " "their own limit." msgstr "" -#: library/stdtypes.rst:5646 +#: library/stdtypes.rst:5650 msgid "" "Information about the default and minimum can be found in :data:`sys." "int_info`:" msgstr "" -#: library/stdtypes.rst:5648 +#: library/stdtypes.rst:5652 msgid "" ":data:`sys.int_info.default_max_str_digits ` is the compiled-" "in default limit." msgstr "" -#: library/stdtypes.rst:5650 +#: library/stdtypes.rst:5654 msgid "" ":data:`sys.int_info.str_digits_check_threshold ` is the lowest " "accepted value for the limit (other than 0 which disables it)." msgstr "" -#: library/stdtypes.rst:5657 +#: library/stdtypes.rst:5661 msgid "" "Setting a low limit *can* lead to problems. While rare, code exists that " "contains integer constants in decimal in their source that exceed the " @@ -7138,7 +7151,7 @@ msgid "" "constants is to convert them to ``0x`` hexadecimal form as it has no limit." msgstr "" -#: library/stdtypes.rst:5666 +#: library/stdtypes.rst:5670 msgid "" "Test your application thoroughly if you use a low limit. Ensure your tests " "run with the limit set early via the environment or flag so that it applies " @@ -7146,11 +7159,11 @@ msgid "" "to precompile ``.py`` sources to ``.pyc`` files." msgstr "" -#: library/stdtypes.rst:5672 +#: library/stdtypes.rst:5676 msgid "Recommended configuration" msgstr "" -#: library/stdtypes.rst:5674 +#: library/stdtypes.rst:5678 msgid "" "The default :data:`sys.int_info.default_max_str_digits` is expected to be " "reasonable for most applications. If your application requires a different " @@ -7158,19 +7171,19 @@ msgid "" "as these APIs were added in security patch releases in versions before 3.12." msgstr "" -#: library/stdtypes.rst:5679 +#: library/stdtypes.rst:5683 msgid "Example::" msgstr "Örnek::" -#: library/stdtypes.rst:5691 +#: library/stdtypes.rst:5695 msgid "If you need to disable it entirely, set it to ``0``." msgstr "" -#: library/stdtypes.rst:5695 +#: library/stdtypes.rst:5699 msgid "Footnotes" msgstr "Dipnotlar" -#: library/stdtypes.rst:5696 +#: library/stdtypes.rst:5700 msgid "" "Additional information on these special methods may be found in the Python " "Reference Manual (:ref:`customization`)." @@ -7178,7 +7191,7 @@ msgstr "" "Bu özel yöntemler hakkında daha fazla bilgi Python Referans El Kitabında (:" "ref:`customization`) bulunabilir." -#: library/stdtypes.rst:5699 +#: library/stdtypes.rst:5703 msgid "" "As a consequence, the list ``[1, 2]`` is considered equal to ``[1.0, 2.0]``, " "and similarly for tuples." @@ -7186,12 +7199,12 @@ msgstr "" "Sonuç olarak, ``[1, 2]`` listesi ``[1.0, 2.0]`` ve benzer şekilde demetler " "için eşit kabul edilir." -#: library/stdtypes.rst:5702 +#: library/stdtypes.rst:5706 msgid "They must have since the parser can't tell the type of the operands." msgstr "" "Ayrıştırıcı, işlenenlerin türünü söyleyemediğinden sahip olmaları gerekir." -#: library/stdtypes.rst:5704 +#: library/stdtypes.rst:5708 msgid "" "Cased characters are those with general category property being one of " "\"Lu\" (Letter, uppercase), \"Ll\" (Letter, lowercase), or \"Lt\" (Letter, " @@ -7201,7 +7214,7 @@ msgstr "" "\"Ll\" (Harf, küçük harf) veya \"Lt\" (Harf, başlık) karakterlerinden biri " "olan karakterlerdir." -#: library/stdtypes.rst:5707 +#: library/stdtypes.rst:5711 msgid "" "To format only a tuple you should therefore provide a singleton tuple whose " "only element is the tuple to be formatted." @@ -7215,11 +7228,11 @@ msgid "built-in" msgstr "Gömülü Türler" #: library/stdtypes.rst:316 library/stdtypes.rst:950 library/stdtypes.rst:1139 -#: library/stdtypes.rst:4421 library/stdtypes.rst:5404 +#: library/stdtypes.rst:4425 library/stdtypes.rst:5408 msgid "types" msgstr "" -#: library/stdtypes.rst:1154 library/stdtypes.rst:4421 +#: library/stdtypes.rst:1154 library/stdtypes.rst:4425 msgid "statement" msgstr "" @@ -7341,9 +7354,9 @@ msgstr "``is not``" #: library/stdtypes.rst:208 library/stdtypes.rst:1117 library/stdtypes.rst:1259 #: library/stdtypes.rst:1382 library/stdtypes.rst:1539 -#: library/stdtypes.rst:2532 library/stdtypes.rst:4219 -#: library/stdtypes.rst:4899 library/stdtypes.rst:5324 -#: library/stdtypes.rst:5368 +#: library/stdtypes.rst:2535 library/stdtypes.rst:4223 +#: library/stdtypes.rst:4903 library/stdtypes.rst:5328 +#: library/stdtypes.rst:5372 #, fuzzy msgid "object" msgstr "Kod Nesneleri" @@ -7401,7 +7414,7 @@ msgstr "" #: library/stdtypes.rst:229 #, fuzzy -msgid "floating point" +msgid "floating-point" msgstr "*x* 'in gerçel sayıya (float) dönüştürülmüş hali" #: library/stdtypes.rst:229 @@ -7436,8 +7449,8 @@ msgstr "" msgid "arithmetic" msgstr "" -#: library/stdtypes.rst:950 library/stdtypes.rst:4421 library/stdtypes.rst:5389 -#: library/stdtypes.rst:5404 +#: library/stdtypes.rst:950 library/stdtypes.rst:4425 library/stdtypes.rst:5393 +#: library/stdtypes.rst:5408 msgid "built-in function" msgstr "" @@ -7454,7 +7467,7 @@ msgstr "" msgid "complex" msgstr ":func:`complex`" -#: library/stdtypes.rst:2389 library/stdtypes.rst:3607 +#: library/stdtypes.rst:2392 library/stdtypes.rst:3611 msgid "+ (plus)" msgstr "" @@ -7468,11 +7481,11 @@ msgstr "Grup Ayırıcı" msgid "binary operator" msgstr "Satır Ayrıcı" -#: library/stdtypes.rst:2389 library/stdtypes.rst:3607 +#: library/stdtypes.rst:2392 library/stdtypes.rst:3611 msgid "- (minus)" msgstr "" -#: library/stdtypes.rst:2346 library/stdtypes.rst:3564 +#: library/stdtypes.rst:2349 library/stdtypes.rst:3568 msgid "* (asterisk)" msgstr "" @@ -7484,7 +7497,7 @@ msgstr "" msgid "//" msgstr "" -#: library/stdtypes.rst:2316 library/stdtypes.rst:3532 +#: library/stdtypes.rst:2319 library/stdtypes.rst:3536 msgid "% (percent)" msgstr "" @@ -7492,7 +7505,7 @@ msgstr "" msgid "**" msgstr "" -#: library/stdtypes.rst:393 library/stdtypes.rst:1154 library/stdtypes.rst:4421 +#: library/stdtypes.rst:393 library/stdtypes.rst:1154 library/stdtypes.rst:4425 #, fuzzy msgid "operations on" msgstr "İşlem" @@ -7502,7 +7515,7 @@ msgstr "İşlem" msgid "conjugate() (complex number method)" msgstr "*c* karmaşık sayısının eşleniği" -#: library/stdtypes.rst:1605 library/stdtypes.rst:5404 +#: library/stdtypes.rst:1605 library/stdtypes.rst:5408 #, fuzzy msgid "module" msgstr "Modüller" @@ -7571,7 +7584,7 @@ msgstr "" msgid "iterator protocol" msgstr "" -#: library/stdtypes.rst:4814 +#: library/stdtypes.rst:4818 msgid "protocol" msgstr "" @@ -7598,7 +7611,7 @@ msgstr "" msgid "iteration over" msgstr "İşlem" -#: library/stdtypes.rst:4421 +#: library/stdtypes.rst:4425 msgid "len" msgstr "" @@ -7680,12 +7693,12 @@ msgstr "" msgid "list" msgstr "" -#: library/stdtypes.rst:2513 library/stdtypes.rst:2711 -#: library/stdtypes.rst:3532 +#: library/stdtypes.rst:2516 library/stdtypes.rst:2714 +#: library/stdtypes.rst:3536 msgid "bytearray" msgstr "" -#: library/stdtypes.rst:4421 library/stdtypes.rst:5404 +#: library/stdtypes.rst:4425 library/stdtypes.rst:5408 msgid "type" msgstr "" @@ -7693,7 +7706,7 @@ msgstr "" msgid "assignment" msgstr "" -#: library/stdtypes.rst:4421 +#: library/stdtypes.rst:4425 msgid "del" msgstr "" @@ -7734,7 +7747,7 @@ msgstr "" msgid "range" msgstr "Aralıklar" -#: library/stdtypes.rst:1552 library/stdtypes.rst:2316 +#: library/stdtypes.rst:1552 library/stdtypes.rst:2319 msgid "string" msgstr "" @@ -7756,16 +7769,16 @@ msgstr "" msgid "io.StringIO" msgstr "" -#: library/stdtypes.rst:2505 +#: library/stdtypes.rst:2508 msgid "buffer protocol" msgstr "" -#: library/stdtypes.rst:2513 library/stdtypes.rst:2711 -#: library/stdtypes.rst:3532 +#: library/stdtypes.rst:2516 library/stdtypes.rst:2714 +#: library/stdtypes.rst:3536 msgid "bytes" msgstr "" -#: library/stdtypes.rst:2711 +#: library/stdtypes.rst:2714 #, fuzzy msgid "methods" msgstr "Yöntemler" @@ -7774,191 +7787,191 @@ msgstr "Yöntemler" msgid "re" msgstr "" -#: library/stdtypes.rst:3386 +#: library/stdtypes.rst:3390 msgid "universal newlines" msgstr "" -#: library/stdtypes.rst:2124 +#: library/stdtypes.rst:2127 msgid "str.splitlines method" msgstr "" -#: library/stdtypes.rst:2316 +#: library/stdtypes.rst:2319 msgid "formatting, string (%)" msgstr "" -#: library/stdtypes.rst:2316 +#: library/stdtypes.rst:2319 msgid "interpolation, string (%)" msgstr "" -#: library/stdtypes.rst:2316 +#: library/stdtypes.rst:2319 msgid "formatting, printf" msgstr "" -#: library/stdtypes.rst:2316 +#: library/stdtypes.rst:2319 msgid "interpolation, printf" msgstr "" -#: library/stdtypes.rst:3532 +#: library/stdtypes.rst:3536 msgid "printf-style formatting" msgstr "" -#: library/stdtypes.rst:3532 +#: library/stdtypes.rst:3536 msgid "sprintf-style formatting" msgstr "" -#: library/stdtypes.rst:3564 +#: library/stdtypes.rst:3568 msgid "() (parentheses)" msgstr "" -#: library/stdtypes.rst:2389 library/stdtypes.rst:3607 +#: library/stdtypes.rst:2392 library/stdtypes.rst:3611 msgid "in printf-style formatting" msgstr "" -#: library/stdtypes.rst:3564 +#: library/stdtypes.rst:3568 msgid ". (dot)" msgstr "" -#: library/stdtypes.rst:3607 +#: library/stdtypes.rst:3611 msgid "# (hash)" msgstr "" -#: library/stdtypes.rst:3607 +#: library/stdtypes.rst:3611 msgid "space" msgstr "" -#: library/stdtypes.rst:2505 +#: library/stdtypes.rst:2508 #, fuzzy msgid "binary sequence types" msgstr "Değiştirilebilir Dizi Tipleri" -#: library/stdtypes.rst:2513 +#: library/stdtypes.rst:2516 msgid "memoryview" msgstr "" -#: library/stdtypes.rst:2513 +#: library/stdtypes.rst:2516 msgid "array" msgstr "" -#: library/stdtypes.rst:3386 +#: library/stdtypes.rst:3390 msgid "bytes.splitlines method" msgstr "" -#: library/stdtypes.rst:3386 +#: library/stdtypes.rst:3390 msgid "bytearray.splitlines method" msgstr "" -#: library/stdtypes.rst:3532 +#: library/stdtypes.rst:3536 msgid "formatting" msgstr "" -#: library/stdtypes.rst:3532 +#: library/stdtypes.rst:3536 msgid "bytes (%)" msgstr "" -#: library/stdtypes.rst:3532 +#: library/stdtypes.rst:3536 msgid "bytearray (%)" msgstr "" -#: library/stdtypes.rst:3532 +#: library/stdtypes.rst:3536 #, fuzzy msgid "interpolation" msgstr "Satır Tablolama" -#: library/stdtypes.rst:4219 +#: library/stdtypes.rst:4223 msgid "set" msgstr "" -#: library/stdtypes.rst:4421 +#: library/stdtypes.rst:4425 msgid "mapping" msgstr "" -#: library/stdtypes.rst:4421 +#: library/stdtypes.rst:4425 msgid "dictionary" msgstr "" -#: library/stdtypes.rst:4504 +#: library/stdtypes.rst:4508 msgid "__missing__()" msgstr "" -#: library/stdtypes.rst:4814 +#: library/stdtypes.rst:4818 #, fuzzy msgid "context manager" msgstr "Bağlam Yöneticisi Türleri" -#: library/stdtypes.rst:4814 +#: library/stdtypes.rst:4818 msgid "context management protocol" msgstr "" -#: library/stdtypes.rst:4814 +#: library/stdtypes.rst:4818 #, fuzzy msgid "context management" msgstr "Bağlam Yöneticisi Türleri" -#: library/stdtypes.rst:4887 +#: library/stdtypes.rst:4891 msgid "annotation" msgstr "" -#: library/stdtypes.rst:4887 +#: library/stdtypes.rst:4891 msgid "type annotation; type hint" msgstr "" -#: library/stdtypes.rst:4899 +#: library/stdtypes.rst:4903 #, fuzzy msgid "GenericAlias" msgstr "Genel Takma Ad Türü" -#: library/stdtypes.rst:4899 +#: library/stdtypes.rst:4903 msgid "Generic" msgstr "" -#: library/stdtypes.rst:4899 +#: library/stdtypes.rst:4903 msgid "Alias" msgstr "" -#: library/stdtypes.rst:5154 +#: library/stdtypes.rst:5158 #, fuzzy msgid "Union" msgstr "Sendika Türü" -#: library/stdtypes.rst:5154 +#: library/stdtypes.rst:5158 msgid "union" msgstr "" -#: library/stdtypes.rst:5324 +#: library/stdtypes.rst:5328 #, fuzzy msgid "method" msgstr "Yöntemler" -#: library/stdtypes.rst:5368 +#: library/stdtypes.rst:5372 msgid "code" msgstr "" -#: library/stdtypes.rst:5368 +#: library/stdtypes.rst:5372 #, fuzzy msgid "code object" msgstr "Kod Nesneleri" -#: library/stdtypes.rst:5375 +#: library/stdtypes.rst:5379 msgid "compile" msgstr "" -#: library/stdtypes.rst:5375 +#: library/stdtypes.rst:5379 msgid "__code__ (function object attribute)" msgstr "" -#: library/stdtypes.rst:5389 +#: library/stdtypes.rst:5393 msgid "exec" msgstr "" -#: library/stdtypes.rst:5389 +#: library/stdtypes.rst:5393 msgid "eval" msgstr "" -#: library/stdtypes.rst:5428 +#: library/stdtypes.rst:5432 msgid "..." msgstr "" -#: library/stdtypes.rst:5428 +#: library/stdtypes.rst:5432 msgid "ellipsis literal" msgstr "" diff --git a/library/string.po b/library/string.po index 646187de5..048131b65 100644 --- a/library/string.po +++ b/library/string.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -522,7 +522,7 @@ msgstr "" #: library/string.rst:420 msgid "" "The ``'_'`` option signals the use of an underscore for a thousands " -"separator for floating point presentation types and for integer presentation " +"separator for floating-point presentation types and for integer presentation " "type ``'d'``. For integer presentation types ``'b'``, ``'o'``, ``'x'``, and " "``'X'``, underscores will be inserted every 4 digits. For other " "presentation types, specifying this option is an error." @@ -668,9 +668,9 @@ msgstr "" #: library/string.rst:493 msgid "" "In addition to the above presentation types, integers can be formatted with " -"the floating point presentation types listed below (except ``'n'`` and " +"the floating-point presentation types listed below (except ``'n'`` and " "``None``). When doing so, :func:`float` is used to convert the integer to a " -"floating point number before formatting." +"floating-point number before formatting." msgstr "" #: library/string.rst:498 diff --git a/library/subprocess.po b/library/subprocess.po index 03974dead..136501d84 100644 --- a/library/subprocess.po +++ b/library/subprocess.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -872,10 +872,12 @@ msgid "" "waited for. ::" msgstr "" -#: library/subprocess.rst:712 +#: library/subprocess.rst:701 msgid "" -"Raises an :ref:`auditing event ` ``subprocess.Popen`` with " -"arguments ``executable``, ``args``, ``cwd``, ``env``." +"Popen and the other functions in this module that use it raise an auditing " +"event subprocess.Popen with arguments executable, args, cwd, and env. The " +"value for args may be a single string or a list of strings, depending on " +"platform." msgstr "" #: library/subprocess.rst:703 @@ -1363,7 +1365,7 @@ msgstr "" #: library/subprocess.rst:1112 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " -"will have an normal priority. (default)" +"will have a normal priority. (default)" msgstr "" #: library/subprocess.rst:1119 diff --git a/library/sunau.po b/library/sunau.po index ef11371f1..4d136a123 100644 --- a/library/sunau.po +++ b/library/sunau.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/sunau.py`" msgstr "" -#: library/sunau.rst:15 +#: library/sunau.rst:12 msgid "" "The :mod:`sunau` module is deprecated (see :pep:`PEP 594 <594#sunau>` for " "details)." diff --git a/library/symtable.po b/library/symtable.po index 2ce1c62b1..789f6cd31 100644 --- a/library/symtable.po +++ b/library/symtable.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -147,88 +147,112 @@ msgid "A namespace of a class. This class inherits from :class:`SymbolTable`." msgstr "" #: library/symtable.rst:130 -msgid "Return a tuple containing the names of methods declared in the class." +msgid "" +"Return a tuple containing the names of method-like functions declared in the " +"class." +msgstr "" + +#: library/symtable.rst:133 +msgid "" +"Here, the term 'method' designates *any* function defined in the class body " +"via :keyword:`def` or :keyword:`async def`." +msgstr "" + +#: library/symtable.rst:136 +msgid "" +"Functions defined in a deeper scope (e.g., in an inner class) are not picked " +"up by :meth:`get_methods`." +msgstr "" + +#: library/symtable.rst:139 +msgid "For example:" +msgstr "" + +#: library/symtable.rst:161 +msgid "" +"Although ``A().f()`` raises :exc:`TypeError` at runtime, ``A.f`` is still " +"considered as a method-like function." msgstr "" -#: library/symtable.rst:135 +#: library/symtable.rst:166 msgid "" "An entry in a :class:`SymbolTable` corresponding to an identifier in the " "source. The constructor is not public." msgstr "" -#: library/symtable.rst:140 +#: library/symtable.rst:171 msgid "Return the symbol's name." msgstr "" -#: library/symtable.rst:144 +#: library/symtable.rst:175 msgid "Return ``True`` if the symbol is used in its block." msgstr "" -#: library/symtable.rst:148 +#: library/symtable.rst:179 msgid "Return ``True`` if the symbol is created from an import statement." msgstr "" -#: library/symtable.rst:152 +#: library/symtable.rst:183 msgid "Return ``True`` if the symbol is a parameter." msgstr "" -#: library/symtable.rst:156 +#: library/symtable.rst:187 msgid "Return ``True`` if the symbol is global." msgstr "" -#: library/symtable.rst:160 +#: library/symtable.rst:191 msgid "Return ``True`` if the symbol is nonlocal." msgstr "" -#: library/symtable.rst:164 +#: library/symtable.rst:195 msgid "" "Return ``True`` if the symbol is declared global with a global statement." msgstr "" -#: library/symtable.rst:168 +#: library/symtable.rst:199 msgid "Return ``True`` if the symbol is local to its block." msgstr "" -#: library/symtable.rst:172 +#: library/symtable.rst:203 msgid "Return ``True`` if the symbol is annotated." msgstr "" -#: library/symtable.rst:178 +#: library/symtable.rst:209 msgid "" "Return ``True`` if the symbol is referenced in its block, but not assigned " "to." msgstr "" -#: library/symtable.rst:183 +#: library/symtable.rst:214 msgid "Return ``True`` if the symbol is assigned to in its block." msgstr "" -#: library/symtable.rst:187 +#: library/symtable.rst:218 msgid "Return ``True`` if name binding introduces new namespace." msgstr "" -#: library/symtable.rst:189 +#: library/symtable.rst:220 msgid "" "If the name is used as the target of a function or class statement, this " "will be true." msgstr "" -#: library/symtable.rst:192 +#: library/symtable.rst:223 msgid "For example::" msgstr "" -#: library/symtable.rst:198 +#: library/symtable.rst:229 msgid "" "Note that a single name can be bound to multiple objects. If the result is " "``True``, the name may also be bound to other objects, like an int or list, " "that does not introduce a new namespace." msgstr "" -#: library/symtable.rst:204 +#: library/symtable.rst:235 msgid "Return a list of namespaces bound to this name." msgstr "" -#: library/symtable.rst:208 +#: library/symtable.rst:239 msgid "" "Return the namespace bound to this name. If more than one or no namespace is " "bound to this name, a :exc:`ValueError` is raised." diff --git a/library/sys.po b/library/sys.po index 92060d598..adf3ade44 100644 --- a/library/sys.po +++ b/library/sys.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -73,8 +73,11 @@ msgstr "" #: library/sys.rst:49 msgid "" -"Raises an :ref:`auditing event ` ``sys.addaudithook`` with no " -"arguments." +"Calling sys.addaudithook() will itself raise an auditing event named sys." +"addaudithook with no arguments. If any existing hooks raise an exception " +"derived from RuntimeError, the new hook will not be added and the exception " +"suppressed. As a result, callers cannot assume that their hook has been " +"added unless they control all existing hooks." msgstr "" #: library/sys.rst:51 @@ -264,9 +267,7 @@ msgid "" msgstr "" #: library/sys.rst:214 -msgid "" -"Raises an :ref:`auditing event ` ``sys._current_frames`` with no " -"arguments." +msgid "Raises an auditing event sys._current_frames with no arguments." msgstr "" #: library/sys.rst:218 @@ -282,9 +283,7 @@ msgid "This is most useful for statistical profiling." msgstr "" #: library/sys.rst:227 -msgid "" -"Raises an :ref:`auditing event ` ``sys._current_exceptions`` with " -"no arguments." +msgid "Raises an auditing event sys._current_exceptions with no arguments." msgstr "" #: library/sys.rst:229 @@ -471,8 +470,11 @@ msgstr "" #: library/sys.rst:394 msgid "" -"Raises an :ref:`auditing event ` ``sys.excepthook`` with arguments " -"``hook``, ``type``, ``value``, ``traceback``." +"Raise an auditing event sys.excepthook with arguments hook, type, value, " +"traceback when an uncaught exception occurs. If no hook has been set, hook " +"may be None. If any hook raises an exception derived from RuntimeError the " +"call to the hook will be suppressed. Otherwise, the audit hook exception " +"will be reported as unraisable and sys.excepthook will be called." msgstr "" #: library/sys.rst:396 @@ -1095,9 +1097,7 @@ msgid "" msgstr "" #: library/sys.rst:886 -msgid "" -"Raises an :ref:`auditing event ` ``sys._getframe`` with argument " -"``frame``." +msgid "Raises an auditing event sys._getframe with argument frame." msgstr "" #: library/sys.rst:906 @@ -1116,9 +1116,7 @@ msgid "" msgstr "" #: library/sys.rst:902 -msgid "" -"Raises an :ref:`auditing event ` ``sys._getframemodulename`` with " -"argument ``depth``." +msgid "Raises an auditing event sys._getframemodulename with argument depth." msgstr "" #: library/sys.rst:916 @@ -1417,8 +1415,8 @@ msgstr "" #: library/sys.rst:1166 msgid "" -"Raises an :ref:`auditing event ` ``cpython.run_interactivehook`` " -"with argument ``hook``." +"Raises an auditing event cpython.run_interactivehook with the hook object as " +"the argument when the hook is called on startup." msgstr "" #: library/sys.rst:1168 @@ -1905,9 +1903,7 @@ msgid "A C function has raised an exception. *arg* is the C function object." msgstr "" #: library/sys.rst:1517 -msgid "" -"Raises an :ref:`auditing event ` ``sys.setprofile`` with no " -"arguments." +msgid "Raises an auditing event sys.setprofile with no arguments." msgstr "" #: library/sys.rst:1522 @@ -2070,9 +2066,7 @@ msgid "For more information on code and frame objects, refer to :ref:`types`." msgstr "" #: library/sys.rst:1635 -msgid "" -"Raises an :ref:`auditing event ` ``sys.settrace`` with no " -"arguments." +msgid "Raises an auditing event sys.settrace with no arguments." msgstr "" #: library/sys.rst:1639 @@ -2108,14 +2102,12 @@ msgstr "" #: library/sys.rst:1663 msgid "" -"Raises an :ref:`auditing event ` ``sys." -"set_asyncgen_hooks_firstiter`` with no arguments." +"Raises an auditing event sys.set_asyncgen_hooks_firstiter with no arguments." msgstr "" #: library/sys.rst:1665 msgid "" -"Raises an :ref:`auditing event ` ``sys." -"set_asyncgen_hooks_finalizer`` with no arguments." +"Raises an auditing event sys.set_asyncgen_hooks_finalizer with no arguments." msgstr "" #: library/sys.rst:1667 @@ -2468,8 +2460,10 @@ msgstr "" #: library/sys.rst:1929 msgid "" -"Raises an :ref:`auditing event ` ``sys.unraisablehook`` with " -"arguments ``hook``, ``unraisable``." +"Raise an auditing event sys.unraisablehook with arguments hook, unraisable " +"when an exception that cannot be handled occurs. The unraisable object is " +"the same as what will be passed to the hook. If no hook has been set, hook " +"may be None." msgstr "" #: library/sys.rst:1931 diff --git a/library/sysconfig.po b/library/sysconfig.po index 2448d215b..1b3d9215f 100644 --- a/library/sysconfig.po +++ b/library/sysconfig.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -605,7 +605,7 @@ msgstr "" msgid "" "This is used mainly to distinguish platform-specific build directories and " "platform-specific built distributions. Typically includes the OS name and " -"version and the architecture (as supplied by 'os.uname()'), although the " +"version and the architecture (as supplied by :func:`os.uname`), although the " "exact information included depends on the OS; e.g., on Linux, the kernel " "version isn't particularly important." msgstr "" diff --git a/library/syslog.po b/library/syslog.po index 51875c2af..efb59f321 100644 --- a/library/syslog.po +++ b/library/syslog.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -60,8 +60,7 @@ msgstr "" #: library/syslog.rst:36 msgid "" -"Raises an :ref:`auditing event ` ``syslog.syslog`` with arguments " -"``priority``, ``message``." +"Raises an auditing event syslog.syslog with arguments priority, message." msgstr "" #: library/syslog.rst:38 @@ -99,8 +98,8 @@ msgstr "" #: library/syslog.rst:64 msgid "" -"Raises an :ref:`auditing event ` ``syslog.openlog`` with arguments " -"``ident``, ``logoption``, ``facility``." +"Raises an auditing event syslog.openlog with arguments ident, logoption, " +"facility." msgstr "" #: library/syslog.rst:66 @@ -131,9 +130,7 @@ msgid "" msgstr "" #: library/syslog.rst:87 -msgid "" -"Raises an :ref:`auditing event ` ``syslog.closelog`` with no " -"arguments." +msgid "Raises an auditing event syslog.closelog with no arguments." msgstr "" #: library/syslog.rst:99 @@ -147,9 +144,7 @@ msgid "" msgstr "" #: library/syslog.rst:106 -msgid "" -"Raises an :ref:`auditing event ` ``syslog.setlogmask`` with " -"argument ``maskpri``." +msgid "Raises an auditing event syslog.setlogmask with argument maskpri." msgstr "" #: library/syslog.rst:108 diff --git a/library/telnetlib.po b/library/telnetlib.po index 3d48c2401..b1c7c87ff 100644 --- a/library/telnetlib.po +++ b/library/telnetlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/telnetlib.py`" msgstr "" -#: library/telnetlib.rst:17 +#: library/telnetlib.rst:14 msgid "" "The :mod:`telnetlib` module is deprecated (see :pep:`PEP 594 " "<594#telnetlib>` for details and alternatives)." @@ -189,10 +189,10 @@ msgstr "" msgid "Do not try to reopen an already connected instance." msgstr "" -#: library/telnetlib.rst:161 +#: library/telnetlib.rst:150 msgid "" -"Raises an :ref:`auditing event ` ``telnetlib.Telnet.open`` with " -"arguments ``self``, ``host``, ``port``." +"Raises an auditing event telnetlib.Telnet.open with arguments self, host, " +"port." msgstr "" #: library/telnetlib.rst:155 @@ -227,10 +227,9 @@ msgid "" "connection is closed." msgstr "" -#: library/telnetlib.rst:198 +#: library/telnetlib.rst:187 msgid "" -"Raises an :ref:`auditing event ` ``telnetlib.Telnet.write`` with " -"arguments ``self``, ``buffer``." +"Raises an auditing event telnetlib.Telnet.write with arguments self, buffer." msgstr "" #: library/telnetlib.rst:189 diff --git a/library/tempfile.po b/library/tempfile.po index eb41077f8..e85b7bb04 100644 --- a/library/tempfile.po +++ b/library/tempfile.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -103,9 +103,7 @@ msgid "" msgstr "" #: library/tempfile.rst:137 library/tempfile.rst:264 -msgid "" -"Raises an :ref:`auditing event ` ``tempfile.mkstemp`` with " -"argument ``fullpath``." +msgid "Raises an auditing event tempfile.mkstemp with argument fullpath." msgstr "" #: library/tempfile.rst:72 @@ -295,9 +293,7 @@ msgid "" msgstr "" #: library/tempfile.rst:290 -msgid "" -"Raises an :ref:`auditing event ` ``tempfile.mkdtemp`` with " -"argument ``fullpath``." +msgid "Raises an auditing event tempfile.mkdtemp with argument fullpath." msgstr "" #: library/tempfile.rst:214 diff --git a/library/threading.po b/library/threading.po index 9c4f41db7..68543f6bb 100644 --- a/library/threading.po +++ b/library/threading.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -538,7 +538,7 @@ msgstr "" #: library/threading.rst:411 msgid "" "When the *timeout* argument is present and not ``None``, it should be a " -"floating point number specifying a timeout for the operation in seconds (or " +"floating-point number specifying a timeout for the operation in seconds (or " "fractions thereof). As :meth:`~Thread.join` always returns ``None``, you " "must call :meth:`~Thread.is_alive` after :meth:`~Thread.join` to decide " "whether a timeout happened -- if the thread is still alive, the :meth:" @@ -1017,7 +1017,7 @@ msgstr "" #: library/threading.rst:792 msgid "" "When the *timeout* argument is present and not ``None``, it should be a " -"floating point number specifying a timeout for the operation in seconds (or " +"floating-point number specifying a timeout for the operation in seconds (or " "fractions thereof)." msgstr "" @@ -1292,7 +1292,7 @@ msgstr "" #: library/threading.rst:1019 msgid "" "When the timeout argument is present and not ``None``, it should be a " -"floating point number specifying a timeout for the operation in seconds, or " +"floating-point number specifying a timeout for the operation in seconds, or " "fractions thereof." msgstr "" diff --git a/library/time.po b/library/time.po index 753194ca9..ec87efe69 100644 --- a/library/time.po +++ b/library/time.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2023-03-01 11:44+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -126,7 +126,7 @@ msgstr "" #, fuzzy msgid "" "On the other hand, the precision of :func:`.time` and :func:`sleep` is " -"better than their Unix equivalents: times are expressed as floating point " +"better than their Unix equivalents: times are expressed as floating-point " "numbers, :func:`.time` returns the most accurate time available (using Unix :" "c:func:`!gettimeofday` where available), and :func:`sleep` will accept a " "time with a nonzero fraction (Unix :c:func:`!select` is used to implement " @@ -475,11 +475,12 @@ msgstr "" "yıllarla sınırlı olması yaygın bir durumdur." #: library/time.rst:273 +#, fuzzy msgid "" "This is the inverse function of :func:`localtime`. Its argument is the :" "class:`struct_time` or full 9-tuple (since the dst flag is needed; use " "``-1`` as the dst flag if it is unknown) which expresses the time in *local* " -"time, not UTC. It returns a floating point number, for compatibility with :" +"time, not UTC. It returns a floating-point number, for compatibility with :" "func:`.time`. If the input value cannot be represented as a valid time, " "either :exc:`OverflowError` or :exc:`ValueError` will be raised (which " "depends on whether the invalid value is caught by Python or the underlying C " @@ -589,9 +590,10 @@ msgstr "" "döndürür." #: library/time.rst:360 +#, fuzzy msgid "" "Suspend execution of the calling thread for the given number of seconds. The " -"argument may be a floating point number to indicate a more precise sleep " +"argument may be a floating-point number to indicate a more precise sleep " "time." msgstr "" "Çağıran iş parçacığının yürütülmesini verilen saniye sayısı kadar askıya " @@ -1218,8 +1220,9 @@ msgstr "" "`TypeError` yükseltir." #: library/time.rst:645 +#, fuzzy msgid "" -"Return the time in seconds since the epoch_ as a floating point number. The " +"Return the time in seconds since the epoch_ as a floating-point number. The " "handling of `leap seconds`_ is platform dependent. On Windows and most Unix " "systems, the leap seconds are not counted towards the time in seconds since " "the epoch_. This is commonly referred to as `Unix time `_ olarak anılır." #: library/time.rst:651 +#, fuzzy msgid "" -"Note that even though the time is always returned as a floating point " +"Note that even though the time is always returned as a floating-point " "number, not all systems provide time with a better precision than 1 second. " "While this function normally returns non-decreasing values, it can return a " "lower value than a previous call if the system clock has been set back " diff --git a/library/types.po b/library/types.po index 13f86c2b1..677f6cabc 100644 --- a/library/types.po +++ b/library/types.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -189,9 +189,7 @@ msgid "" msgstr "" #: library/types.rst:159 -msgid "" -"Raises an :ref:`auditing event ` ``function.__new__`` with " -"argument ``code``." +msgid "Raises an auditing event function.__new__ with argument code." msgstr "" #: library/types.rst:161 @@ -226,9 +224,8 @@ msgstr "" #: library/types.rst:193 msgid "" -"Raises an :ref:`auditing event ` ``code.__new__`` with arguments " -"``code``, ``filename``, ``name``, ``argcount``, ``posonlyargcount``, " -"``kwonlyargcount``, ``nlocals``, ``stacksize``, ``flags``." +"Raises an auditing event code.__new__ with arguments code, filename, name, " +"argcount, posonlyargcount, kwonlyargcount, nlocals, stacksize, flags." msgstr "" #: library/types.rst:195 diff --git a/library/typing.po b/library/typing.po index 8754e8d57..b70850f3b 100644 --- a/library/typing.po +++ b/library/typing.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -41,115 +41,115 @@ msgstr "" #: library/typing.rst:33 msgid "" -"The function ``moon_weight`` takes an argument expected to be an instance " -"of :class:`float`, as indicated by the *type hint* ``earth_weight: float``. " -"The function is expected to return an instance of :class:`str`, as indicated " -"by the ``-> str`` hint." +"The function ``surface_area_of_cube`` takes an argument expected to be an " +"instance of :class:`float`, as indicated by the :term:`type hint` " +"``edge_length: float``. The function is expected to return an instance of :" +"class:`str`, as indicated by the ``-> str`` hint." msgstr "" -#: library/typing.rst:37 +#: library/typing.rst:38 msgid "" "While type hints can be simple classes like :class:`float` or :class:`str`, " "they can also be more complex. The :mod:`typing` module provides a " "vocabulary of more advanced type hints." msgstr "" -#: library/typing.rst:41 +#: library/typing.rst:42 msgid "" "New features are frequently added to the ``typing`` module. The :pypi:" "`typing_extensions` package provides backports of these new features to " "older versions of Python." msgstr "" -#: library/typing.rst:47 +#: library/typing.rst:48 msgid "" "`\"Typing cheat sheet\" `_" msgstr "" -#: library/typing.rst:48 +#: library/typing.rst:49 msgid "A quick overview of type hints (hosted at the mypy docs)" msgstr "" -#: library/typing.rst:50 +#: library/typing.rst:51 msgid "" "\"Type System Reference\" section of `the mypy docs `_" msgstr "" -#: library/typing.rst:51 +#: library/typing.rst:52 msgid "" "The Python typing system is standardised via PEPs, so this reference should " "broadly apply to most Python type checkers. (Some parts may still be " "specific to mypy.)" msgstr "" -#: library/typing.rst:55 +#: library/typing.rst:56 msgid "" "`\"Static Typing with Python\" `_" msgstr "" -#: library/typing.rst:56 +#: library/typing.rst:57 msgid "" "Type-checker-agnostic documentation written by the community detailing type " "system features, useful typing related tools and typing best practices." msgstr "" -#: library/typing.rst:63 +#: library/typing.rst:64 msgid "Specification for the Python Type System" msgstr "" -#: library/typing.rst:65 +#: library/typing.rst:66 msgid "" "The canonical, up-to-date specification of the Python type system can be " "found at `\"Specification for the Python type system\" `_." msgstr "" -#: library/typing.rst:71 +#: library/typing.rst:72 msgid "Type aliases" msgstr "" -#: library/typing.rst:73 +#: library/typing.rst:74 msgid "" "A type alias is defined using the :keyword:`type` statement, which creates " "an instance of :class:`TypeAliasType`. In this example, ``Vector`` and " "``list[float]`` will be treated equivalently by static type checkers::" msgstr "" -#: library/typing.rst:86 +#: library/typing.rst:87 msgid "" "Type aliases are useful for simplifying complex type signatures. For " "example::" msgstr "" -#: library/typing.rst:104 +#: library/typing.rst:106 msgid "" "The :keyword:`type` statement is new in Python 3.12. For backwards " "compatibility, type aliases can also be created through simple assignment::" msgstr "" -#: library/typing.rst:109 +#: library/typing.rst:111 msgid "" "Or marked with :data:`TypeAlias` to make it explicit that this is a type " "alias, not a normal variable assignment::" msgstr "" -#: library/typing.rst:119 +#: library/typing.rst:121 msgid "NewType" msgstr "" -#: library/typing.rst:121 +#: library/typing.rst:123 msgid "Use the :class:`NewType` helper to create distinct types::" msgstr "" -#: library/typing.rst:128 +#: library/typing.rst:130 msgid "" "The static type checker will treat the new type as if it were a subclass of " "the original type. This is useful in helping catch logical errors::" msgstr "" -#: library/typing.rst:140 +#: library/typing.rst:142 msgid "" "You may still perform all ``int`` operations on a variable of type " "``UserId``, but the result will always be of type ``int``. This lets you " @@ -157,7 +157,7 @@ msgid "" "you from accidentally creating a ``UserId`` in an invalid way::" msgstr "" -#: library/typing.rst:148 +#: library/typing.rst:150 msgid "" "Note that these checks are enforced only by the static type checker. At " "runtime, the statement ``Derived = NewType('Derived', Base)`` will make " @@ -166,31 +166,31 @@ msgid "" "class or introduce much overhead beyond that of a regular function call." msgstr "" -#: library/typing.rst:154 +#: library/typing.rst:156 msgid "" "More precisely, the expression ``some_value is Derived(some_value)`` is " "always true at runtime." msgstr "" -#: library/typing.rst:157 +#: library/typing.rst:159 msgid "It is invalid to create a subtype of ``Derived``::" msgstr "" -#: library/typing.rst:166 +#: library/typing.rst:168 msgid "" "However, it is possible to create a :class:`NewType` based on a 'derived' " "``NewType``::" msgstr "" -#: library/typing.rst:174 +#: library/typing.rst:176 msgid "and typechecking for ``ProUserId`` will work as expected." msgstr "" -#: library/typing.rst:176 +#: library/typing.rst:178 msgid "See :pep:`484` for more details." msgstr "" -#: library/typing.rst:180 +#: library/typing.rst:182 msgid "" "Recall that the use of a type alias declares two types to be *equivalent* to " "one another. Doing ``type Alias = Original`` will make the static type " @@ -198,7 +198,7 @@ msgid "" "cases. This is useful when you want to simplify complex type signatures." msgstr "" -#: library/typing.rst:185 +#: library/typing.rst:187 msgid "" "In contrast, ``NewType`` declares one type to be a *subtype* of another. " "Doing ``Derived = NewType('Derived', Original)`` will make the static type " @@ -208,24 +208,24 @@ msgid "" "errors with minimal runtime cost." msgstr "" -#: library/typing.rst:194 +#: library/typing.rst:196 msgid "" "``NewType`` is now a class rather than a function. As a result, there is " "some additional runtime cost when calling ``NewType`` over a regular " "function." msgstr "" -#: library/typing.rst:199 +#: library/typing.rst:201 msgid "" "The performance of calling ``NewType`` has been restored to its level in " "Python 3.9." msgstr "" -#: library/typing.rst:206 +#: library/typing.rst:208 msgid "Annotating callable objects" msgstr "" -#: library/typing.rst:208 +#: library/typing.rst:210 msgid "" "Functions -- or other :term:`callable` objects -- can be annotated using :" "class:`collections.abc.Callable` or :data:`typing.Callable`. " @@ -233,11 +233,11 @@ msgid "" "of type :class:`int` and returns a :class:`str`." msgstr "" -#: library/typing.rst:2829 library/typing.rst:2973 +#: library/typing.rst:2831 library/typing.rst:2977 msgid "For example:" msgstr "" -#: library/typing.rst:231 +#: library/typing.rst:233 msgid "" "The subscription syntax must always be used with exactly two values: the " "argument list and the return type. The argument list must be a list of " @@ -245,13 +245,13 @@ msgid "" "type must be a single type." msgstr "" -#: library/typing.rst:236 +#: library/typing.rst:238 msgid "" "If a literal ellipsis ``...`` is given as the argument list, it indicates " "that a callable with any arbitrary parameter list would be acceptable:" msgstr "" -#: library/typing.rst:248 +#: library/typing.rst:250 msgid "" "``Callable`` cannot express complex signatures such as functions that take a " "variadic number of arguments, :ref:`overloaded functions `, or " @@ -260,7 +260,7 @@ msgid "" "__call__` method:" msgstr "" -#: library/typing.rst:275 +#: library/typing.rst:277 msgid "" "Callables which take other callables as arguments may indicate that their " "parameter types are dependent on each other using :class:`ParamSpec`. " @@ -271,54 +271,54 @@ msgid "" "ReturnType]`` respectively." msgstr "" -#: library/typing.rst:3499 +#: library/typing.rst:3503 msgid "" "``Callable`` now supports :class:`ParamSpec` and :data:`Concatenate`. See :" "pep:`612` for more details." msgstr "" -#: library/typing.rst:288 +#: library/typing.rst:290 msgid "" "The documentation for :class:`ParamSpec` and :class:`Concatenate` provides " "examples of usage in ``Callable``." msgstr "" -#: library/typing.rst:294 +#: library/typing.rst:296 msgid "Generics" msgstr "" -#: library/typing.rst:296 +#: library/typing.rst:298 msgid "" "Since type information about objects kept in containers cannot be statically " "inferred in a generic way, many container classes in the standard library " "support subscription to denote the expected types of container elements." msgstr "" -#: library/typing.rst:313 +#: library/typing.rst:315 msgid "" "Generic functions and classes can be parameterized by using :ref:`type " "parameter syntax `::" msgstr "" -#: library/typing.rst:321 +#: library/typing.rst:323 msgid "Or by using the :class:`TypeVar` factory directly::" msgstr "" -#: library/typing.rst:331 +#: library/typing.rst:333 msgid "Syntactic support for generics is new in Python 3.12." msgstr "" -#: library/typing.rst:337 +#: library/typing.rst:339 msgid "Annotating tuples" msgstr "" -#: library/typing.rst:339 +#: library/typing.rst:341 msgid "" "For most containers in Python, the typing system assumes that all elements " "in the container will be of the same type. For example::" msgstr "" -#: library/typing.rst:354 +#: library/typing.rst:356 msgid "" ":class:`list` only accepts one type argument, so a type checker would emit " "an error on the ``y`` assignment above. Similarly, :class:`~collections.abc." @@ -326,7 +326,7 @@ msgid "" "the keys, and the second indicates the type of the values." msgstr "" -#: library/typing.rst:360 +#: library/typing.rst:362 msgid "" "Unlike most other Python containers, however, it is common in idiomatic " "Python code for tuples to have elements which are not all of the same type. " @@ -334,7 +334,7 @@ msgid "" "`tuple` accepts *any number* of type arguments::" msgstr "" -#: library/typing.rst:376 +#: library/typing.rst:378 msgid "" "To denote a tuple which could be of *any* length, and in which all elements " "are of the same type ``T``, use ``tuple[T, ...]``. To denote an empty tuple, " @@ -342,11 +342,11 @@ msgid "" "using ``tuple[Any, ...]``::" msgstr "" -#: library/typing.rst:399 +#: library/typing.rst:401 msgid "The type of class objects" msgstr "" -#: library/typing.rst:401 +#: library/typing.rst:403 msgid "" "A variable annotated with ``C`` may accept a value of type ``C``. In " "contrast, a variable annotated with ``type[C]`` (or :class:`typing.Type[C] " @@ -354,104 +354,104 @@ msgid "" "will accept the *class object* of ``C``. For example::" msgstr "" -#: library/typing.rst:411 +#: library/typing.rst:413 msgid "Note that ``type[C]`` is covariant::" msgstr "" -#: library/typing.rst:427 +#: library/typing.rst:429 msgid "" "The only legal parameters for :class:`type` are classes, :data:`Any`, :ref:" "`type variables `, and unions of any of these types. For example::" msgstr "" -#: library/typing.rst:439 +#: library/typing.rst:441 msgid "" "``type[Any]`` is equivalent to :class:`type`, which is the root of Python's :" "ref:`metaclass hierarchy `." msgstr "" -#: library/typing.rst:445 +#: library/typing.rst:447 msgid "User-defined generic types" msgstr "" -#: library/typing.rst:447 +#: library/typing.rst:449 msgid "A user-defined class can be defined as a generic class." msgstr "" -#: library/typing.rst:470 +#: library/typing.rst:472 msgid "" "This syntax indicates that the class ``LoggedVar`` is parameterised around a " "single :ref:`type variable ` ``T`` . This also makes ``T`` valid as " "a type within the class body." msgstr "" -#: library/typing.rst:474 +#: library/typing.rst:476 msgid "" "Generic classes implicitly inherit from :class:`Generic`. For compatibility " "with Python 3.11 and lower, it is also possible to inherit explicitly from :" "class:`Generic` to indicate a generic class::" msgstr "" -#: library/typing.rst:485 +#: library/typing.rst:487 msgid "" "Generic classes have :meth:`~object.__class_getitem__` methods, meaning they " "can be parameterised at runtime (e.g. ``LoggedVar[int]`` below)::" msgstr "" -#: library/typing.rst:494 +#: library/typing.rst:496 msgid "" "A generic type can have any number of type variables. All varieties of :" "class:`TypeVar` are permissible as parameters for a generic type::" msgstr "" -#: library/typing.rst:509 +#: library/typing.rst:511 msgid "" "Each type variable argument to :class:`Generic` must be distinct. This is " "thus invalid::" msgstr "" -#: library/typing.rst:523 +#: library/typing.rst:525 msgid "Generic classes can also inherit from other classes::" msgstr "" -#: library/typing.rst:530 +#: library/typing.rst:532 msgid "" "When inheriting from generic classes, some type parameters could be fixed::" msgstr "" -#: library/typing.rst:537 +#: library/typing.rst:539 msgid "In this case ``MyDict`` has a single parameter, ``T``." msgstr "" -#: library/typing.rst:539 +#: library/typing.rst:541 msgid "" "Using a generic class without specifying type parameters assumes :data:`Any` " "for each position. In the following example, ``MyIterable`` is not generic " "but implicitly inherits from ``Iterable[Any]``:" msgstr "" -#: library/typing.rst:550 +#: library/typing.rst:552 msgid "User-defined generic type aliases are also supported. Examples::" msgstr "" -#: library/typing.rst:565 +#: library/typing.rst:567 msgid "" "For backward compatibility, generic type aliases can also be created through " "a simple assignment::" msgstr "" -#: library/typing.rst:574 +#: library/typing.rst:576 msgid ":class:`Generic` no longer has a custom metaclass." msgstr "" -#: library/typing.rst:577 +#: library/typing.rst:579 msgid "" "Syntactic support for generics and type aliases is new in version 3.12. " "Previously, generic classes had to explicitly inherit from :class:`Generic` " "or contain a type variable in one of their bases." msgstr "" -#: library/typing.rst:582 +#: library/typing.rst:584 msgid "" "User-defined generics for parameter expressions are also supported via " "parameter specification variables in the form ``[**P]``. The behavior is " @@ -461,13 +461,13 @@ msgid "" "a :class:`ParamSpec`::" msgstr "" -#: library/typing.rst:593 +#: library/typing.rst:595 msgid "" "Classes generic over a :class:`ParamSpec` can also be created using explicit " "inheritance from :class:`Generic`. In this case, ``**`` is not used::" msgstr "" -#: library/typing.rst:603 +#: library/typing.rst:605 msgid "" "Another difference between :class:`TypeVar` and :class:`ParamSpec` is that a " "generic with only one parameter specification variable will accept parameter " @@ -476,20 +476,20 @@ msgid "" "the former, so the following are equivalent::" msgstr "" -#: library/typing.rst:616 +#: library/typing.rst:618 msgid "" "Note that generics with :class:`ParamSpec` may not have correct " "``__parameters__`` after substitution in some cases because they are " "intended primarily for static type checking." msgstr "" -#: library/typing.rst:620 +#: library/typing.rst:622 msgid "" ":class:`Generic` can now be parameterized over parameter expressions. See :" "class:`ParamSpec` and :pep:`612` for more details." msgstr "" -#: library/typing.rst:624 +#: library/typing.rst:626 msgid "" "A user-defined generic class can have ABCs as base classes without a " "metaclass conflict. Generic metaclasses are not supported. The outcome of " @@ -497,24 +497,24 @@ msgid "" "term:`hashable` and comparable for equality." msgstr "" -#: library/typing.rst:631 +#: library/typing.rst:633 msgid "The :data:`Any` type" msgstr "" -#: library/typing.rst:633 +#: library/typing.rst:635 msgid "" "A special kind of type is :data:`Any`. A static type checker will treat " "every type as being compatible with :data:`Any` and :data:`Any` as being " "compatible with every type." msgstr "" -#: library/typing.rst:637 +#: library/typing.rst:639 msgid "" "This means that it is possible to perform any operation or method call on a " "value of type :data:`Any` and assign it to any variable::" msgstr "" -#: library/typing.rst:655 +#: library/typing.rst:657 msgid "" "Notice that no type checking is performed when assigning a value of type :" "data:`Any` to a more precise type. For example, the static type checker did " @@ -523,19 +523,19 @@ msgid "" "runtime!" msgstr "" -#: library/typing.rst:661 +#: library/typing.rst:663 msgid "" "Furthermore, all functions without a return type or parameter types will " "implicitly default to using :data:`Any`::" msgstr "" -#: library/typing.rst:674 +#: library/typing.rst:676 msgid "" "This behavior allows :data:`Any` to be used as an *escape hatch* when you " "need to mix dynamically and statically typed code." msgstr "" -#: library/typing.rst:677 +#: library/typing.rst:679 msgid "" "Contrast the behavior of :data:`Any` with the behavior of :class:`object`. " "Similar to :data:`Any`, every type is a subtype of :class:`object`. However, " @@ -543,7 +543,7 @@ msgid "" "subtype of every other type." msgstr "" -#: library/typing.rst:682 +#: library/typing.rst:684 msgid "" "That means when the type of a value is :class:`object`, a type checker will " "reject almost all operations on it, and assigning it to a variable (or using " @@ -551,24 +551,24 @@ msgid "" "example::" msgstr "" -#: library/typing.rst:704 +#: library/typing.rst:706 msgid "" "Use :class:`object` to indicate that a value could be any type in a typesafe " "manner. Use :data:`Any` to indicate that a value is dynamically typed." msgstr "" -#: library/typing.rst:709 +#: library/typing.rst:711 msgid "Nominal vs structural subtyping" msgstr "" -#: library/typing.rst:711 +#: library/typing.rst:713 msgid "" "Initially :pep:`484` defined the Python static type system as using *nominal " "subtyping*. This means that a class ``A`` is allowed where a class ``B`` is " "expected if and only if ``A`` is a subclass of ``B``." msgstr "" -#: library/typing.rst:715 +#: library/typing.rst:717 msgid "" "This requirement previously also applied to abstract base classes, such as :" "class:`~collections.abc.Iterable`. The problem with this approach is that a " @@ -577,7 +577,7 @@ msgid "" "code. For example, this conforms to :pep:`484`::" msgstr "" -#: library/typing.rst:728 +#: library/typing.rst:730 msgid "" ":pep:`544` allows to solve this problem by allowing users to write the above " "code without explicit base classes in the class definition, allowing " @@ -586,87 +586,87 @@ msgid "" "subtyping* (or static duck-typing)::" msgstr "" -#: library/typing.rst:744 +#: library/typing.rst:746 msgid "" "Moreover, by subclassing a special class :class:`Protocol`, a user can " "define new custom protocols to fully enjoy structural subtyping (see " "examples below)." msgstr "" -#: library/typing.rst:749 +#: library/typing.rst:751 msgid "Module contents" msgstr "" -#: library/typing.rst:751 +#: library/typing.rst:753 msgid "" "The ``typing`` module defines the following classes, functions and " "decorators." msgstr "" -#: library/typing.rst:754 +#: library/typing.rst:756 msgid "Special typing primitives" msgstr "" -#: library/typing.rst:757 +#: library/typing.rst:759 msgid "Special types" msgstr "" -#: library/typing.rst:759 +#: library/typing.rst:761 msgid "" "These can be used as types in annotations. They do not support subscription " "using ``[]``." msgstr "" -#: library/typing.rst:764 +#: library/typing.rst:766 msgid "Special type indicating an unconstrained type." msgstr "" -#: library/typing.rst:766 +#: library/typing.rst:768 msgid "Every type is compatible with :data:`Any`." msgstr "" -#: library/typing.rst:767 +#: library/typing.rst:769 msgid ":data:`Any` is compatible with every type." msgstr "" -#: library/typing.rst:769 +#: library/typing.rst:771 msgid "" ":data:`Any` can now be used as a base class. This can be useful for avoiding " "type checker errors with classes that can duck type anywhere or are highly " "dynamic." msgstr "" -#: library/typing.rst:776 +#: library/typing.rst:778 msgid "A :ref:`constrained type variable `." msgstr "" -#: library/typing.rst:778 +#: library/typing.rst:780 msgid "Definition::" msgstr "" -#: library/typing.rst:782 +#: library/typing.rst:784 msgid "" "``AnyStr`` is meant to be used for functions that may accept :class:`str` " "or :class:`bytes` arguments but cannot allow the two to mix." msgstr "" -#: library/typing.rst:893 library/typing.rst:1116 library/typing.rst:1382 -#: library/typing.rst:2769 +#: library/typing.rst:895 library/typing.rst:1118 library/typing.rst:1384 +#: library/typing.rst:2771 msgid "For example::" msgstr "" -#: library/typing.rst:794 +#: library/typing.rst:796 msgid "" "Note that, despite its name, ``AnyStr`` has nothing to do with the :class:" "`Any` type, nor does it mean \"any string\". In particular, ``AnyStr`` and " "``str | bytes`` are different from each other and have different use cases::" msgstr "" -#: library/typing.rst:811 +#: library/typing.rst:813 msgid "Special type that includes only literal strings." msgstr "" -#: library/typing.rst:813 +#: library/typing.rst:815 msgid "" "Any string literal is compatible with ``LiteralString``, as is another " "``LiteralString``. However, an object typed as just ``str`` is not. A string " @@ -674,11 +674,11 @@ msgid "" "``LiteralString``." msgstr "" -#: library/typing.rst:1897 +#: library/typing.rst:1899 msgid "Example:" msgstr "" -#: library/typing.rst:835 +#: library/typing.rst:837 msgid "" "``LiteralString`` is useful for sensitive APIs where arbitrary user-" "generated strings could generate problems. For example, the two cases above " @@ -686,53 +686,53 @@ msgid "" "attack." msgstr "" -#: library/typing.rst:840 +#: library/typing.rst:842 msgid "See :pep:`675` for more details." msgstr "" -#: library/typing.rst:847 +#: library/typing.rst:849 msgid "" ":data:`!Never` and :data:`!NoReturn` represent the `bottom type `_, a type that has no members." msgstr "" -#: library/typing.rst:851 +#: library/typing.rst:853 msgid "" "They can be used to indicate that a function never returns, such as :func:" "`sys.exit`::" msgstr "" -#: library/typing.rst:859 +#: library/typing.rst:861 msgid "" "Or to define a function that should never be called, as there are no valid " "arguments, such as :func:`assert_never`::" msgstr "" -#: library/typing.rst:878 +#: library/typing.rst:880 msgid "" ":data:`!Never` and :data:`!NoReturn` have the same meaning in the type " "system and static type checkers treat both equivalently." msgstr "" -#: library/typing.rst:883 +#: library/typing.rst:885 msgid "Added :data:`NoReturn`." msgstr "" -#: library/typing.rst:887 +#: library/typing.rst:889 msgid "Added :data:`Never`." msgstr "" -#: library/typing.rst:891 +#: library/typing.rst:893 msgid "Special type to represent the current enclosed class." msgstr "" -#: library/typing.rst:907 +#: library/typing.rst:909 msgid "" "This annotation is semantically equivalent to the following, albeit in a " "more succinct fashion::" msgstr "" -#: library/typing.rst:919 +#: library/typing.rst:921 msgid "" "In general, if something returns ``self``, as in the above examples, you " "should use ``Self`` as the return annotation. If ``Foo.return_self`` was " @@ -741,48 +741,48 @@ msgid "" "rather than ``SubclassOfFoo``." msgstr "" -#: library/typing.rst:925 +#: library/typing.rst:927 msgid "Other common use cases include:" msgstr "" -#: library/typing.rst:927 +#: library/typing.rst:929 msgid "" ":class:`classmethod`\\s that are used as alternative constructors and return " "instances of the ``cls`` parameter." msgstr "" -#: library/typing.rst:929 +#: library/typing.rst:931 msgid "Annotating an :meth:`~object.__enter__` method which returns self." msgstr "" -#: library/typing.rst:931 +#: library/typing.rst:933 msgid "" "You should not use ``Self`` as the return annotation if the method is not " "guaranteed to return an instance of a subclass when the class is subclassed::" msgstr "" -#: library/typing.rst:942 +#: library/typing.rst:944 msgid "See :pep:`673` for more details." msgstr "" -#: library/typing.rst:948 +#: library/typing.rst:950 msgid "" "Special annotation for explicitly declaring a :ref:`type alias `." msgstr "" -#: library/typing.rst:956 +#: library/typing.rst:958 msgid "" "``TypeAlias`` is particularly useful on older Python versions for annotating " "aliases that make use of forward references, as it can be hard for type " "checkers to distinguish these from normal variable assignments:" msgstr "" -#: library/typing.rst:976 +#: library/typing.rst:978 msgid "See :pep:`613` for more details." msgstr "" -#: library/typing.rst:980 +#: library/typing.rst:982 msgid "" ":data:`TypeAlias` is deprecated in favor of the :keyword:`type` statement, " "which creates instances of :class:`TypeAliasType` and which natively " @@ -793,71 +793,71 @@ msgid "" "to :keyword:`type` statements." msgstr "" -#: library/typing.rst:991 +#: library/typing.rst:993 msgid "Special forms" msgstr "" -#: library/typing.rst:993 +#: library/typing.rst:995 msgid "" "These can be used as types in annotations. They all support subscription " "using ``[]``, but each has a unique syntax." msgstr "" -#: library/typing.rst:998 +#: library/typing.rst:1000 msgid "" "Union type; ``Union[X, Y]`` is equivalent to ``X | Y`` and means either X or " "Y." msgstr "" -#: library/typing.rst:1000 +#: library/typing.rst:1002 msgid "" "To define a union, use e.g. ``Union[int, str]`` or the shorthand ``int | " "str``. Using that shorthand is recommended. Details:" msgstr "" -#: library/typing.rst:1002 +#: library/typing.rst:1004 msgid "The arguments must be types and there must be at least one." msgstr "" -#: library/typing.rst:1004 +#: library/typing.rst:1006 msgid "Unions of unions are flattened, e.g.::" msgstr "" -#: library/typing.rst:1008 +#: library/typing.rst:1010 msgid "Unions of a single argument vanish, e.g.::" msgstr "" -#: library/typing.rst:1012 +#: library/typing.rst:1014 msgid "Redundant arguments are skipped, e.g.::" msgstr "" -#: library/typing.rst:1016 +#: library/typing.rst:1018 msgid "When comparing unions, the argument order is ignored, e.g.::" msgstr "" -#: library/typing.rst:1020 +#: library/typing.rst:1022 msgid "You cannot subclass or instantiate a ``Union``." msgstr "" -#: library/typing.rst:1022 +#: library/typing.rst:1024 msgid "You cannot write ``Union[X][Y]``." msgstr "" -#: library/typing.rst:1024 +#: library/typing.rst:1026 msgid "Don't remove explicit subclasses from unions at runtime." msgstr "" -#: library/typing.rst:1027 +#: library/typing.rst:1029 msgid "" "Unions can now be written as ``X | Y``. See :ref:`union type " "expressions`." msgstr "" -#: library/typing.rst:1033 +#: library/typing.rst:1035 msgid "``Optional[X]`` is equivalent to ``X | None`` (or ``Union[X, None]``)." msgstr "" -#: library/typing.rst:1035 +#: library/typing.rst:1037 msgid "" "Note that this is not the same concept as an optional argument, which is one " "that has a default. An optional argument with a default does not require " @@ -865,24 +865,24 @@ msgid "" "optional. For example::" msgstr "" -#: library/typing.rst:1043 +#: library/typing.rst:1045 msgid "" "On the other hand, if an explicit value of ``None`` is allowed, the use of " "``Optional`` is appropriate, whether the argument is optional or not. For " "example::" msgstr "" -#: library/typing.rst:1050 +#: library/typing.rst:1052 msgid "" "Optional can now be written as ``X | None``. See :ref:`union type " "expressions`." msgstr "" -#: library/typing.rst:1056 +#: library/typing.rst:1058 msgid "Special form for annotating higher-order functions." msgstr "" -#: library/typing.rst:1058 +#: library/typing.rst:1060 msgid "" "``Concatenate`` can be used in conjunction with :ref:`Callable ` and :class:`ParamSpec` to annotate a higher-order callable which " @@ -893,7 +893,7 @@ msgid "" "``Concatenate`` must be a :class:`ParamSpec` or ellipsis (``...``)." msgstr "" -#: library/typing.rst:1067 +#: library/typing.rst:1069 msgid "" "For example, to annotate a decorator ``with_lock`` which provides a :class:" "`threading.Lock` to the decorated function, ``Concatenate`` can be used to " @@ -904,38 +904,38 @@ msgid "" "passed in::" msgstr "" -#: library/typing.rst:1865 +#: library/typing.rst:1867 msgid "" ":pep:`612` -- Parameter Specification Variables (the PEP which introduced " "``ParamSpec`` and ``Concatenate``)" msgstr "" -#: library/typing.rst:1105 +#: library/typing.rst:1107 msgid ":class:`ParamSpec`" msgstr "" -#: library/typing.rst:1868 +#: library/typing.rst:1870 msgid ":ref:`annotating-callables`" msgstr "" -#: library/typing.rst:1110 +#: library/typing.rst:1112 msgid "Special typing form to define \"literal types\"." msgstr "" -#: library/typing.rst:1112 +#: library/typing.rst:1114 msgid "" "``Literal`` can be used to indicate to type checkers that the annotated " "object has a value equivalent to one of the provided literals." msgstr "" -#: library/typing.rst:1128 +#: library/typing.rst:1130 msgid "" "``Literal[...]`` cannot be subclassed. At runtime, an arbitrary value is " "allowed as type argument to ``Literal[...]``, but type checkers may impose " "restrictions. See :pep:`586` for more details about literal types." msgstr "" -#: library/typing.rst:1134 +#: library/typing.rst:1136 msgid "" "``Literal`` now de-duplicates parameters. Equality comparisons of " "``Literal`` objects are no longer order dependent. ``Literal`` objects will " @@ -943,22 +943,22 @@ msgid "" "their parameters are not :term:`hashable`." msgstr "" -#: library/typing.rst:1142 +#: library/typing.rst:1144 msgid "Special type construct to mark class variables." msgstr "" -#: library/typing.rst:1144 +#: library/typing.rst:1146 msgid "" "As introduced in :pep:`526`, a variable annotation wrapped in ClassVar " "indicates that a given attribute is intended to be used as a class variable " "and should not be set on instances of that class. Usage::" msgstr "" -#: library/typing.rst:1152 +#: library/typing.rst:1154 msgid ":data:`ClassVar` accepts only types and cannot be further subscribed." msgstr "" -#: library/typing.rst:1154 +#: library/typing.rst:1156 msgid "" ":data:`ClassVar` is not a class itself, and should not be used with :func:" "`isinstance` or :func:`issubclass`. :data:`ClassVar` does not change Python " @@ -966,47 +966,47 @@ msgid "" "example, a type checker might flag the following code as an error::" msgstr "" -#: library/typing.rst:1168 +#: library/typing.rst:1170 msgid "Special typing construct to indicate final names to type checkers." msgstr "" -#: library/typing.rst:1170 +#: library/typing.rst:1172 msgid "" "Final names cannot be reassigned in any scope. Final names declared in class " "scopes cannot be overridden in subclasses." msgstr "" -#: library/typing.rst:2785 +#: library/typing.rst:2787 msgid "" "There is no runtime checking of these properties. See :pep:`591` for more " "details." msgstr "" -#: library/typing.rst:1191 +#: library/typing.rst:1193 msgid "Special typing construct to mark a :class:`TypedDict` key as required." msgstr "" -#: library/typing.rst:1193 +#: library/typing.rst:1195 msgid "" "This is mainly useful for ``total=False`` TypedDicts. See :class:`TypedDict` " "and :pep:`655` for more details." msgstr "" -#: library/typing.rst:1200 +#: library/typing.rst:1202 msgid "" "Special typing construct to mark a :class:`TypedDict` key as potentially " "missing." msgstr "" -#: library/typing.rst:1203 +#: library/typing.rst:1205 msgid "See :class:`TypedDict` and :pep:`655` for more details." msgstr "" -#: library/typing.rst:1209 +#: library/typing.rst:1211 msgid "Special typing form to add context-specific metadata to an annotation." msgstr "" -#: library/typing.rst:1211 +#: library/typing.rst:1213 msgid "" "Add metadata ``x`` to a given type ``T`` by using the annotation " "``Annotated[T, x]``. Metadata added using ``Annotated`` can be used by " @@ -1014,7 +1014,7 @@ msgid "" "a :attr:`!__metadata__` attribute." msgstr "" -#: library/typing.rst:1216 +#: library/typing.rst:1218 msgid "" "If a library or tool encounters an annotation ``Annotated[T, x]`` and has no " "special logic for the metadata, it should ignore the metadata and simply " @@ -1023,7 +1023,7 @@ msgid "" "system." msgstr "" -#: library/typing.rst:1222 +#: library/typing.rst:1224 msgid "" "Using ``Annotated[T, x]`` as an annotation still allows for static " "typechecking of ``T``, as type checkers will simply ignore the metadata " @@ -1033,7 +1033,7 @@ msgid "" "for a function or class." msgstr "" -#: library/typing.rst:1229 +#: library/typing.rst:1231 msgid "" "The responsibility of how to interpret the metadata lies with the tool or " "library encountering an ``Annotated`` annotation. A tool or library " @@ -1041,105 +1041,105 @@ msgid "" "determine if they are of interest (e.g., using :func:`isinstance`)." msgstr "" -#: library/typing.rst:1237 +#: library/typing.rst:1239 msgid "" "Here is an example of how you might use ``Annotated`` to add metadata to " "type annotations if you were doing range analysis:" msgstr "" -#: library/typing.rst:1250 +#: library/typing.rst:1252 msgid "Details of the syntax:" msgstr "" -#: library/typing.rst:1252 +#: library/typing.rst:1254 msgid "The first argument to ``Annotated`` must be a valid type" msgstr "" -#: library/typing.rst:1254 +#: library/typing.rst:1256 msgid "" "Multiple metadata elements can be supplied (``Annotated`` supports variadic " "arguments)::" msgstr "" -#: library/typing.rst:1263 +#: library/typing.rst:1265 msgid "" "It is up to the tool consuming the annotations to decide whether the client " "is allowed to add multiple metadata elements to one annotation and how to " "merge those annotations." msgstr "" -#: library/typing.rst:1267 +#: library/typing.rst:1269 msgid "" "``Annotated`` must be subscripted with at least two arguments " "( ``Annotated[int]`` is not valid)" msgstr "" -#: library/typing.rst:1270 +#: library/typing.rst:1272 msgid "" "The order of the metadata elements is preserved and matters for equality " "checks::" msgstr "" -#: library/typing.rst:1277 +#: library/typing.rst:1279 msgid "" "Nested ``Annotated`` types are flattened. The order of the metadata elements " "starts with the innermost annotation::" msgstr "" -#: library/typing.rst:1284 +#: library/typing.rst:1286 msgid "Duplicated metadata elements are not removed::" msgstr "" -#: library/typing.rst:1290 +#: library/typing.rst:1292 msgid "``Annotated`` can be used with nested and generic aliases:" msgstr "" -#: library/typing.rst:1304 +#: library/typing.rst:1306 msgid "``Annotated`` cannot be used with an unpacked :class:`TypeVarTuple`::" msgstr "" -#: library/typing.rst:1308 +#: library/typing.rst:1310 msgid "This would be equivalent to::" msgstr "" -#: library/typing.rst:1312 +#: library/typing.rst:1314 msgid "" "where ``T1``, ``T2``, etc. are :class:`TypeVars `. This would be " "invalid: only one type should be passed to Annotated." msgstr "" -#: library/typing.rst:1315 +#: library/typing.rst:1317 msgid "" "By default, :func:`get_type_hints` strips the metadata from annotations. " "Pass ``include_extras=True`` to have the metadata preserved:" msgstr "" -#: library/typing.rst:1328 +#: library/typing.rst:1330 msgid "" "At runtime, the metadata associated with an ``Annotated`` type can be " "retrieved via the :attr:`!__metadata__` attribute:" msgstr "" -#: library/typing.rst:1342 +#: library/typing.rst:1344 msgid ":pep:`593` - Flexible function and variable annotations" msgstr "" -#: library/typing.rst:1343 +#: library/typing.rst:1345 msgid "The PEP introducing ``Annotated`` to the standard library." msgstr "" -#: library/typing.rst:1350 +#: library/typing.rst:1352 msgid "Special typing construct for marking user-defined type guard functions." msgstr "" -#: library/typing.rst:1352 +#: library/typing.rst:1354 msgid "" "``TypeGuard`` can be used to annotate the return type of a user-defined type " "guard function. ``TypeGuard`` only accepts a single type argument. At " "runtime, functions marked this way should return a boolean." msgstr "" -#: library/typing.rst:1356 +#: library/typing.rst:1358 msgid "" "``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static " "type checkers to determine a more precise type of an expression within a " @@ -1148,44 +1148,44 @@ msgid "" "conditional expression here is sometimes referred to as a \"type guard\"::" msgstr "" -#: library/typing.rst:1371 +#: library/typing.rst:1373 msgid "" "Sometimes it would be convenient to use a user-defined boolean function as a " "type guard. Such a function should use ``TypeGuard[...]`` as its return " "type to alert static type checkers to this intention." msgstr "" -#: library/typing.rst:1375 +#: library/typing.rst:1377 msgid "" "Using ``-> TypeGuard`` tells the static type checker that for a given " "function:" msgstr "" -#: library/typing.rst:1378 +#: library/typing.rst:1380 msgid "The return value is a boolean." msgstr "" -#: library/typing.rst:1379 +#: library/typing.rst:1381 msgid "" "If the return value is ``True``, the type of its argument is the type inside " "``TypeGuard``." msgstr "" -#: library/typing.rst:1396 +#: library/typing.rst:1398 msgid "" "If ``is_str_list`` is a class or instance method, then the type in " -"``TypeGuard`` maps to the type of the second parameter after ``cls`` or " -"``self``." +"``TypeGuard`` maps to the type of the second parameter (after ``cls`` or " +"``self``)." msgstr "" -#: library/typing.rst:1400 +#: library/typing.rst:1402 msgid "" "In short, the form ``def foo(arg: TypeA) -> TypeGuard[TypeB]: ...``, means " "that if ``foo(arg)`` returns ``True``, then ``arg`` narrows from ``TypeA`` " "to ``TypeB``." msgstr "" -#: library/typing.rst:1406 +#: library/typing.rst:1408 msgid "" "``TypeB`` need not be a narrower form of ``TypeA`` -- it can even be a wider " "form. The main reason is to allow for things like narrowing ``list[object]`` " @@ -1194,24 +1194,24 @@ msgid "" "guards is left to the user." msgstr "" -#: library/typing.rst:1412 +#: library/typing.rst:1414 msgid "" "``TypeGuard`` also works with type variables. See :pep:`647` for more " "details." msgstr "" -#: library/typing.rst:1419 +#: library/typing.rst:1421 msgid "Typing operator to conceptually mark an object as having been unpacked." msgstr "" -#: library/typing.rst:1421 +#: library/typing.rst:1423 msgid "" "For example, using the unpack operator ``*`` on a :ref:`type variable tuple " "` is equivalent to using ``Unpack`` to mark the type variable " "tuple as having been unpacked::" msgstr "" -#: library/typing.rst:1430 +#: library/typing.rst:1432 msgid "" "In fact, ``Unpack`` can be used interchangeably with ``*`` in the context " "of :class:`typing.TypeVarTuple ` and :class:`builtins.tuple " @@ -1219,29 +1219,29 @@ msgid "" "versions of Python, where ``*`` couldn't be used in certain places::" msgstr "" -#: library/typing.rst:1444 +#: library/typing.rst:1446 msgid "" "``Unpack`` can also be used along with :class:`typing.TypedDict` for typing " "``**kwargs`` in a function signature::" msgstr "" -#: library/typing.rst:1457 +#: library/typing.rst:1459 msgid "" "See :pep:`692` for more details on using ``Unpack`` for ``**kwargs`` typing." msgstr "" -#: library/typing.rst:1462 +#: library/typing.rst:1464 msgid "Building generic types and type aliases" msgstr "" -#: library/typing.rst:1464 +#: library/typing.rst:1466 msgid "" "The following classes should not be used directly as annotations. Their " "intended purpose is to be building blocks for creating generic types and " "type aliases." msgstr "" -#: library/typing.rst:1468 +#: library/typing.rst:1470 msgid "" "These objects can be created through special syntax (:ref:`type parameter " "lists ` and the :keyword:`type` statement). For compatibility " @@ -1249,62 +1249,62 @@ msgid "" "syntax, as documented below." msgstr "" -#: library/typing.rst:1475 +#: library/typing.rst:1477 msgid "Abstract base class for generic types." msgstr "" -#: library/typing.rst:1477 +#: library/typing.rst:1479 msgid "" "A generic type is typically declared by adding a list of type parameters " "after the class name::" msgstr "" -#: library/typing.rst:1485 +#: library/typing.rst:1487 msgid "" "Such a class implicitly inherits from ``Generic``. The runtime semantics of " "this syntax are discussed in the :ref:`Language Reference `." msgstr "" -#: library/typing.rst:1489 +#: library/typing.rst:1491 msgid "This class can then be used as follows::" msgstr "" -#: library/typing.rst:1497 +#: library/typing.rst:1499 msgid "" "Here the brackets after the function name indicate a :ref:`generic function " "`." msgstr "" -#: library/typing.rst:1500 +#: library/typing.rst:1502 msgid "" "For backwards compatibility, generic classes can also be declared by " "explicitly inheriting from ``Generic``. In this case, the type parameters " "must be declared separately::" msgstr "" -#: library/typing.rst:1517 +#: library/typing.rst:1519 msgid "Type variable." msgstr "" -#: library/typing.rst:1519 +#: library/typing.rst:1521 msgid "" "The preferred way to construct a type variable is via the dedicated syntax " "for :ref:`generic functions `, :ref:`generic classes " "`, and :ref:`generic type aliases `::" msgstr "" -#: library/typing.rst:1527 +#: library/typing.rst:1529 msgid "" "This syntax can also be used to create bound and constrained type variables::" msgstr "" -#: library/typing.rst:1537 +#: library/typing.rst:1539 msgid "" "However, if desired, reusable type variables can also be constructed " "manually, like so::" msgstr "" -#: library/typing.rst:1543 +#: library/typing.rst:1545 msgid "" "Type variables exist primarily for the benefit of static type checkers. " "They serve as the parameters for generic types as well as for generic " @@ -1312,13 +1312,13 @@ msgid "" "information on generic types. Generic functions work as follows::" msgstr "" -#: library/typing.rst:1564 +#: library/typing.rst:1566 msgid "" "Note that type variables can be *bound*, *constrained*, or neither, but " "cannot be both bound *and* constrained." msgstr "" -#: library/typing.rst:1567 +#: library/typing.rst:1569 msgid "" "The variance of type variables is inferred by type checkers when they are " "created through the :ref:`type parameter syntax ` or when " @@ -1328,92 +1328,92 @@ msgid "" "invariant. See :pep:`484` and :pep:`695` for more details." msgstr "" -#: library/typing.rst:1575 +#: library/typing.rst:1577 msgid "" "Bound type variables and constrained type variables have different semantics " "in several important ways. Using a *bound* type variable means that the " "``TypeVar`` will be solved using the most specific type possible::" msgstr "" -#: library/typing.rst:1590 +#: library/typing.rst:1592 msgid "" "Type variables can be bound to concrete types, abstract types (ABCs or " "protocols), and even unions of types::" msgstr "" -#: library/typing.rst:1602 +#: library/typing.rst:1604 msgid "" "Using a *constrained* type variable, however, means that the ``TypeVar`` can " "only ever be solved as being exactly one of the constraints given::" msgstr "" -#: library/typing.rst:1613 +#: library/typing.rst:1615 msgid "At runtime, ``isinstance(x, T)`` will raise :exc:`TypeError`." msgstr "" -#: library/typing.rst:1617 +#: library/typing.rst:1619 msgid "The name of the type variable." msgstr "" -#: library/typing.rst:1621 +#: library/typing.rst:1623 msgid "Whether the type var has been explicitly marked as covariant." msgstr "" -#: library/typing.rst:1625 +#: library/typing.rst:1627 msgid "Whether the type var has been explicitly marked as contravariant." msgstr "" -#: library/typing.rst:1629 +#: library/typing.rst:1631 msgid "" "Whether the type variable's variance should be inferred by type checkers." msgstr "" -#: library/typing.rst:1635 +#: library/typing.rst:1637 msgid "The bound of the type variable, if any." msgstr "" -#: library/typing.rst:1639 +#: library/typing.rst:1641 msgid "" "For type variables created through :ref:`type parameter syntax `, the bound is evaluated only when the attribute is accessed, not " "when the type variable is created (see :ref:`lazy-evaluation`)." msgstr "" -#: library/typing.rst:1645 +#: library/typing.rst:1647 msgid "A tuple containing the constraints of the type variable, if any." msgstr "" -#: library/typing.rst:1649 +#: library/typing.rst:1651 msgid "" "For type variables created through :ref:`type parameter syntax `, the constraints are evaluated only when the attribute is accessed, " "not when the type variable is created (see :ref:`lazy-evaluation`)." msgstr "" -#: library/typing.rst:1655 +#: library/typing.rst:1657 msgid "" "Type variables can now be declared using the :ref:`type parameter ` syntax introduced by :pep:`695`. The ``infer_variance`` parameter " "was added." msgstr "" -#: library/typing.rst:1663 +#: library/typing.rst:1665 msgid "" "Type variable tuple. A specialized form of :ref:`type variable ` " "that enables *variadic* generics." msgstr "" -#: library/typing.rst:1666 +#: library/typing.rst:1668 msgid "" "Type variable tuples can be declared in :ref:`type parameter lists ` using a single asterisk (``*``) before the name::" msgstr "" -#: library/typing.rst:1672 +#: library/typing.rst:1674 msgid "Or by explicitly invoking the ``TypeVarTuple`` constructor::" msgstr "" -#: library/typing.rst:1680 +#: library/typing.rst:1682 msgid "" "A normal type variable enables parameterization with a single type. A type " "variable tuple, in contrast, allows parameterization with an *arbitrary* " @@ -1421,7 +1421,7 @@ msgid "" "wrapped in a tuple. For example::" msgstr "" -#: library/typing.rst:1702 +#: library/typing.rst:1704 msgid "" "Note the use of the unpacking operator ``*`` in ``tuple[T, *Ts]``. " "Conceptually, you can think of ``Ts`` as a tuple of type variables ``(T1, " @@ -1431,36 +1431,36 @@ msgid "" "` instead, as ``Unpack[Ts]``.)" msgstr "" -#: library/typing.rst:1710 +#: library/typing.rst:1712 msgid "" "Type variable tuples must *always* be unpacked. This helps distinguish type " "variable tuples from normal type variables::" msgstr "" -#: library/typing.rst:1717 +#: library/typing.rst:1719 msgid "" "Type variable tuples can be used in the same contexts as normal type " "variables. For example, in class definitions, arguments, and return types::" msgstr "" -#: library/typing.rst:1725 +#: library/typing.rst:1727 msgid "" "Type variable tuples can be happily combined with normal type variables:" msgstr "" -#: library/typing.rst:1741 +#: library/typing.rst:1743 msgid "" "However, note that at most one type variable tuple may appear in a single " "list of type arguments or type parameters::" msgstr "" -#: library/typing.rst:1748 +#: library/typing.rst:1750 msgid "" "Finally, an unpacked type variable tuple can be used as the type annotation " "of ``*args``::" msgstr "" -#: library/typing.rst:1758 +#: library/typing.rst:1760 msgid "" "In contrast to non-unpacked annotations of ``*args`` - e.g. ``*args: int``, " "which would specify that *all* arguments are ``int`` - ``*args: *Ts`` " @@ -1469,39 +1469,39 @@ msgid "" "``call_soon`` match the types of the (positional) arguments of ``callback``." msgstr "" -#: library/typing.rst:1765 +#: library/typing.rst:1767 msgid "See :pep:`646` for more details on type variable tuples." msgstr "" -#: library/typing.rst:1769 +#: library/typing.rst:1771 msgid "The name of the type variable tuple." msgstr "" -#: library/typing.rst:1775 +#: library/typing.rst:1777 msgid "" "Type variable tuples can now be declared using the :ref:`type parameter " "` syntax introduced by :pep:`695`." msgstr "" -#: library/typing.rst:1780 +#: library/typing.rst:1782 msgid "" "Parameter specification variable. A specialized version of :ref:`type " "variables `." msgstr "" -#: library/typing.rst:1783 +#: library/typing.rst:1785 msgid "" "In :ref:`type parameter lists `, parameter specifications can " "be declared with two asterisks (``**``)::" msgstr "" -#: library/typing.rst:1788 +#: library/typing.rst:1790 msgid "" "For compatibility with Python 3.11 and earlier, ``ParamSpec`` objects can " "also be created as follows::" msgstr "" -#: library/typing.rst:1793 +#: library/typing.rst:1795 msgid "" "Parameter specification variables exist primarily for the benefit of static " "type checkers. They are used to forward the parameter types of one callable " @@ -1511,7 +1511,7 @@ msgid "" "See :class:`Generic` for more information on generic types." msgstr "" -#: library/typing.rst:1800 +#: library/typing.rst:1802 msgid "" "For example, to add basic logging to a function, one can create a decorator " "``add_logging`` to log function calls. The parameter specification variable " @@ -1519,27 +1519,27 @@ msgid "" "new callable returned by it have inter-dependent type parameters::" msgstr "" -#: library/typing.rst:1820 +#: library/typing.rst:1822 msgid "" "Without ``ParamSpec``, the simplest way to annotate this previously was to " "use a :class:`TypeVar` with bound ``Callable[..., Any]``. However this " "causes two problems:" msgstr "" -#: library/typing.rst:1824 +#: library/typing.rst:1826 msgid "" "The type checker can't type check the ``inner`` function because ``*args`` " "and ``**kwargs`` have to be typed :data:`Any`." msgstr "" -#: library/typing.rst:1826 +#: library/typing.rst:1828 msgid "" ":func:`~cast` may be required in the body of the ``add_logging`` decorator " "when returning the ``inner`` function, or the static type checker must be " "told to ignore the ``return inner``." msgstr "" -#: library/typing.rst:1833 +#: library/typing.rst:1835 msgid "" "Since ``ParamSpec`` captures both positional and keyword parameters, ``P." "args`` and ``P.kwargs`` can be used to split a ``ParamSpec`` into its " @@ -1552,11 +1552,11 @@ msgid "" "`ParamSpecKwargs`." msgstr "" -#: library/typing.rst:1845 +#: library/typing.rst:1847 msgid "The name of the parameter specification." msgstr "" -#: library/typing.rst:1847 +#: library/typing.rst:1849 msgid "" "Parameter specification variables created with ``covariant=True`` or " "``contravariant=True`` can be used to declare covariant or contravariant " @@ -1565,23 +1565,23 @@ msgid "" "decided." msgstr "" -#: library/typing.rst:1857 +#: library/typing.rst:1859 msgid "" "Parameter specifications can now be declared using the :ref:`type parameter " "` syntax introduced by :pep:`695`." msgstr "" -#: library/typing.rst:1861 +#: library/typing.rst:1863 msgid "" "Only parameter specification variables defined in global scope can be " "pickled." msgstr "" -#: library/typing.rst:1867 +#: library/typing.rst:1869 msgid ":data:`Concatenate`" msgstr "" -#: library/typing.rst:1873 +#: library/typing.rst:1875 msgid "" "Arguments and keyword arguments attributes of a :class:`ParamSpec`. The ``P." "args`` attribute of a ``ParamSpec`` is an instance of ``ParamSpecArgs``, and " @@ -1589,71 +1589,71 @@ msgid "" "runtime introspection and have no special meaning to static type checkers." msgstr "" -#: library/typing.rst:1878 +#: library/typing.rst:1880 msgid "" "Calling :func:`get_origin` on either of these objects will return the " "original ``ParamSpec``:" msgstr "" -#: library/typing.rst:1895 +#: library/typing.rst:1897 msgid "The type of type aliases created through the :keyword:`type` statement." msgstr "" -#: library/typing.rst:1909 +#: library/typing.rst:1911 msgid "The name of the type alias:" msgstr "" -#: library/typing.rst:1919 +#: library/typing.rst:1921 msgid "The module in which the type alias was defined::" msgstr "" -#: library/typing.rst:1927 +#: library/typing.rst:1929 msgid "" "The type parameters of the type alias, or an empty tuple if the alias is not " "generic:" msgstr "" -#: library/typing.rst:1941 +#: library/typing.rst:1943 msgid "" "The type alias's value. This is :ref:`lazily evaluated `, " "so names used in the definition of the alias are not resolved until the " "``__value__`` attribute is accessed:" msgstr "" -#: library/typing.rst:1959 +#: library/typing.rst:1961 msgid "Other special directives" msgstr "" -#: library/typing.rst:1961 +#: library/typing.rst:1963 msgid "" "These functions and classes should not be used directly as annotations. " "Their intended purpose is to be building blocks for creating and declaring " "types." msgstr "" -#: library/typing.rst:1967 +#: library/typing.rst:1969 msgid "Typed version of :func:`collections.namedtuple`." msgstr "" -#: library/typing.rst:2046 library/typing.rst:3013 +#: library/typing.rst:2048 library/typing.rst:3017 msgid "Usage::" msgstr "" -#: library/typing.rst:1975 +#: library/typing.rst:1977 msgid "This is equivalent to::" msgstr "" -#: library/typing.rst:1979 +#: library/typing.rst:1981 msgid "" "To give a field a default value, you can assign to it in the class body::" msgstr "" -#: library/typing.rst:1988 +#: library/typing.rst:1990 msgid "" "Fields with a default value must come after any fields without a default." msgstr "" -#: library/typing.rst:1990 +#: library/typing.rst:1992 msgid "" "The resulting class has an extra attribute ``__annotations__`` giving a dict " "that maps the field names to the field types. (The field names are in the " @@ -1662,83 +1662,83 @@ msgid "" "API.)" msgstr "" -#: library/typing.rst:1996 +#: library/typing.rst:1998 msgid "``NamedTuple`` subclasses can also have docstrings and methods::" msgstr "" -#: library/typing.rst:2006 +#: library/typing.rst:2008 msgid "``NamedTuple`` subclasses can be generic::" msgstr "" -#: library/typing.rst:2012 +#: library/typing.rst:2014 msgid "Backward-compatible usage::" msgstr "" -#: library/typing.rst:2022 +#: library/typing.rst:2024 msgid "Added support for :pep:`526` variable annotation syntax." msgstr "" -#: library/typing.rst:2025 +#: library/typing.rst:2027 msgid "Added support for default values, methods, and docstrings." msgstr "" -#: library/typing.rst:2028 +#: library/typing.rst:2030 msgid "" "The ``_field_types`` and ``__annotations__`` attributes are now regular " "dictionaries instead of instances of ``OrderedDict``." msgstr "" -#: library/typing.rst:2032 +#: library/typing.rst:2034 msgid "" "Removed the ``_field_types`` attribute in favor of the more standard " "``__annotations__`` attribute which has the same information." msgstr "" -#: library/typing.rst:2036 +#: library/typing.rst:2038 msgid "Added support for generic namedtuples." msgstr "" -#: library/typing.rst:2041 +#: library/typing.rst:2043 msgid "Helper class to create low-overhead :ref:`distinct types `." msgstr "" -#: library/typing.rst:2043 +#: library/typing.rst:2045 msgid "" "A ``NewType`` is considered a distinct type by a typechecker. At runtime, " "however, calling a ``NewType`` returns its argument unchanged." msgstr "" -#: library/typing.rst:2053 +#: library/typing.rst:2055 msgid "The module in which the new type is defined." msgstr "" -#: library/typing.rst:2057 +#: library/typing.rst:2059 msgid "The name of the new type." msgstr "" -#: library/typing.rst:2061 +#: library/typing.rst:2063 msgid "The type that the new type is based on." msgstr "" -#: library/typing.rst:2065 +#: library/typing.rst:2067 msgid "``NewType`` is now a class rather than a function." msgstr "" -#: library/typing.rst:2070 +#: library/typing.rst:2072 msgid "Base class for protocol classes." msgstr "" -#: library/typing.rst:2072 +#: library/typing.rst:2074 msgid "Protocol classes are defined like this::" msgstr "" -#: library/typing.rst:2078 +#: library/typing.rst:2080 msgid "" "Such classes are primarily used with static type checkers that recognize " "structural subtyping (static duck-typing), for example::" msgstr "" -#: library/typing.rst:2090 +#: library/typing.rst:2092 msgid "" "See :pep:`544` for more details. Protocol classes decorated with :func:" "`runtime_checkable` (described later) act as simple-minded runtime protocols " @@ -1746,21 +1746,21 @@ msgid "" "signatures." msgstr "" -#: library/typing.rst:2095 +#: library/typing.rst:2097 msgid "Protocol classes can be generic, for example::" msgstr "" -#: library/typing.rst:2101 +#: library/typing.rst:2103 msgid "" "In code that needs to be compatible with Python 3.11 or older, generic " "Protocols can be written as follows::" msgstr "" -#: library/typing.rst:2114 +#: library/typing.rst:2116 msgid "Mark a protocol class as a runtime protocol." msgstr "" -#: library/typing.rst:2116 +#: library/typing.rst:2118 msgid "" "Such a protocol can be used with :func:`isinstance` and :func:`issubclass`. " "This raises :exc:`TypeError` when applied to a non-protocol class. This " @@ -1769,7 +1769,7 @@ msgid "" "Iterable`. For example::" msgstr "" -#: library/typing.rst:2136 +#: library/typing.rst:2138 msgid "" ":func:`!runtime_checkable` will check only the presence of the required " "methods or attributes, not their type signatures or types. For example, :" @@ -1780,7 +1780,7 @@ msgid "" "(instantiate) :class:`ssl.SSLObject`." msgstr "" -#: library/typing.rst:2147 +#: library/typing.rst:2149 msgid "" "An :func:`isinstance` check against a runtime-checkable protocol can be " "surprisingly slow compared to an ``isinstance()`` check against a non-" @@ -1788,7 +1788,7 @@ msgid "" "calls for structural checks in performance-sensitive code." msgstr "" -#: library/typing.rst:2155 +#: library/typing.rst:2157 msgid "" "The internal implementation of :func:`isinstance` checks against runtime-" "checkable protocols now uses :func:`inspect.getattr_static` to look up " @@ -1798,7 +1798,7 @@ msgid "" "versa. Most users are unlikely to be affected by this change." msgstr "" -#: library/typing.rst:2164 +#: library/typing.rst:2166 msgid "" "The members of a runtime-checkable protocol are now considered \"frozen\" at " "runtime as soon as the class has been created. Monkey-patching attributes " @@ -1807,13 +1807,13 @@ msgid "" "`\"What's new in Python 3.12\" ` for more details." msgstr "" -#: library/typing.rst:2175 +#: library/typing.rst:2177 msgid "" "Special construct to add type hints to a dictionary. At runtime it is a " "plain :class:`dict`." msgstr "" -#: library/typing.rst:2178 +#: library/typing.rst:2180 msgid "" "``TypedDict`` declares a dictionary type that expects all of its instances " "to have a certain set of keys, where each key is associated with a value of " @@ -1821,53 +1821,53 @@ msgid "" "enforced by type checkers. Usage::" msgstr "" -#: library/typing.rst:2194 +#: library/typing.rst:2196 msgid "" "To allow using this feature with older versions of Python that do not " "support :pep:`526`, ``TypedDict`` supports two additional equivalent " "syntactic forms:" msgstr "" -#: library/typing.rst:2198 +#: library/typing.rst:2200 msgid "Using a literal :class:`dict` as the second argument::" msgstr "" -#: library/typing.rst:2202 +#: library/typing.rst:2204 msgid "Using keyword arguments::" msgstr "" -#: library/typing.rst:2209 +#: library/typing.rst:2208 msgid "" "The keyword-argument syntax is deprecated in 3.11 and will be removed in " "3.13. It may also be unsupported by static type checkers." msgstr "" -#: library/typing.rst:2210 +#: library/typing.rst:2212 msgid "" "The functional syntax should also be used when any of the keys are not " "valid :ref:`identifiers `, for example because they are " "keywords or contain hyphens. Example::" msgstr "" -#: library/typing.rst:2222 +#: library/typing.rst:2224 msgid "" "By default, all keys must be present in a ``TypedDict``. It is possible to " "mark individual keys as non-required using :data:`NotRequired`::" msgstr "" -#: library/typing.rst:2233 +#: library/typing.rst:2235 msgid "" "This means that a ``Point2D`` ``TypedDict`` can have the ``label`` key " "omitted." msgstr "" -#: library/typing.rst:2236 +#: library/typing.rst:2238 msgid "" "It is also possible to mark all keys as non-required by default by " "specifying a totality of ``False``::" msgstr "" -#: library/typing.rst:2246 +#: library/typing.rst:2248 msgid "" "This means that a ``Point2D`` ``TypedDict`` can have any of the keys " "omitted. A type checker is only expected to support a literal ``False`` or " @@ -1875,53 +1875,53 @@ msgid "" "and makes all items defined in the class body required." msgstr "" -#: library/typing.rst:2251 +#: library/typing.rst:2253 msgid "" "Individual keys of a ``total=False`` ``TypedDict`` can be marked as required " "using :data:`Required`::" msgstr "" -#: library/typing.rst:2266 +#: library/typing.rst:2268 msgid "" "It is possible for a ``TypedDict`` type to inherit from one or more other " "``TypedDict`` types using the class-based syntax. Usage::" msgstr "" -#: library/typing.rst:2273 +#: library/typing.rst:2275 msgid "" "``Point3D`` has three items: ``x``, ``y`` and ``z``. It is equivalent to " "this definition::" msgstr "" -#: library/typing.rst:2281 +#: library/typing.rst:2283 msgid "" "A ``TypedDict`` cannot inherit from a non-\\ ``TypedDict`` class, except " "for :class:`Generic`. For example::" msgstr "" -#: library/typing.rst:2296 +#: library/typing.rst:2298 msgid "A ``TypedDict`` can be generic::" msgstr "" -#: library/typing.rst:2302 +#: library/typing.rst:2304 msgid "" "To create a generic ``TypedDict`` that is compatible with Python 3.11 or " "lower, inherit from :class:`Generic` explicitly:" msgstr "" -#: library/typing.rst:2313 +#: library/typing.rst:2315 msgid "" "A ``TypedDict`` can be introspected via annotations dicts (see :ref:" "`annotations-howto` for more information on annotations best practices), :" "attr:`__total__`, :attr:`__required_keys__`, and :attr:`__optional_keys__`." msgstr "" -#: library/typing.rst:2319 +#: library/typing.rst:2321 msgid "" "``Point2D.__total__`` gives the value of the ``total`` argument. Example:" msgstr "" -#: library/typing.rst:2335 +#: library/typing.rst:2337 msgid "" "This attribute reflects *only* the value of the ``total`` argument to the " "current ``TypedDict`` class, not whether the class is semantically total. " @@ -1932,21 +1932,21 @@ msgid "" "introspection." msgstr "" -#: library/typing.rst:2348 +#: library/typing.rst:2350 msgid "" "``Point2D.__required_keys__`` and ``Point2D.__optional_keys__`` return :" "class:`frozenset` objects containing required and non-required keys, " "respectively." msgstr "" -#: library/typing.rst:2351 +#: library/typing.rst:2353 msgid "" "Keys marked with :data:`Required` will always appear in " "``__required_keys__`` and keys marked with :data:`NotRequired` will always " "appear in ``__optional_keys__``." msgstr "" -#: library/typing.rst:2354 +#: library/typing.rst:2356 msgid "" "For backwards compatibility with Python 3.10 and below, it is also possible " "to use inheritance to declare both required and non-required keys in the " @@ -1955,7 +1955,7 @@ msgid "" "``TypedDict`` with a different value for ``total``:" msgstr "" -#: library/typing.rst:2379 +#: library/typing.rst:2381 msgid "" "If ``from __future__ import annotations`` is used or if annotations are " "given as strings, annotations are not evaluated when the ``TypedDict`` is " @@ -1964,130 +1964,130 @@ msgid "" "attributes may be incorrect." msgstr "" -#: library/typing.rst:2385 +#: library/typing.rst:2387 msgid "" "See :pep:`589` for more examples and detailed rules of using ``TypedDict``." msgstr "" -#: library/typing.rst:2389 +#: library/typing.rst:2391 msgid "" "Added support for marking individual keys as :data:`Required` or :data:" "`NotRequired`. See :pep:`655`." msgstr "" -#: library/typing.rst:2393 +#: library/typing.rst:2395 msgid "Added support for generic ``TypedDict``\\ s." msgstr "" -#: library/typing.rst:2397 +#: library/typing.rst:2399 msgid "Protocols" msgstr "" -#: library/typing.rst:2399 +#: library/typing.rst:2401 msgid "" "The following protocols are provided by the typing module. All are decorated " "with :func:`@runtime_checkable `." msgstr "" -#: library/typing.rst:2404 +#: library/typing.rst:2406 msgid "" "An ABC with one abstract method ``__abs__`` that is covariant in its return " "type." msgstr "" -#: library/typing.rst:2409 +#: library/typing.rst:2411 msgid "An ABC with one abstract method ``__bytes__``." msgstr "" -#: library/typing.rst:2413 +#: library/typing.rst:2415 msgid "An ABC with one abstract method ``__complex__``." msgstr "" -#: library/typing.rst:2417 +#: library/typing.rst:2419 msgid "An ABC with one abstract method ``__float__``." msgstr "" -#: library/typing.rst:2421 +#: library/typing.rst:2423 msgid "An ABC with one abstract method ``__index__``." msgstr "" -#: library/typing.rst:2427 +#: library/typing.rst:2429 msgid "An ABC with one abstract method ``__int__``." msgstr "" -#: library/typing.rst:2431 +#: library/typing.rst:2433 msgid "" "An ABC with one abstract method ``__round__`` that is covariant in its " "return type." msgstr "" -#: library/typing.rst:2435 +#: library/typing.rst:2437 msgid "ABCs for working with IO" msgstr "" -#: library/typing.rst:2441 +#: library/typing.rst:2443 msgid "" "Generic type ``IO[AnyStr]`` and its subclasses ``TextIO(IO[str])`` and " "``BinaryIO(IO[bytes])`` represent the types of I/O streams such as returned " "by :func:`open`." msgstr "" -#: library/typing.rst:2447 +#: library/typing.rst:2449 msgid "Functions and decorators" msgstr "" -#: library/typing.rst:2451 +#: library/typing.rst:2453 msgid "Cast a value to a type." msgstr "" -#: library/typing.rst:2453 +#: library/typing.rst:2455 msgid "" "This returns the value unchanged. To the type checker this signals that the " "return value has the designated type, but at runtime we intentionally don't " "check anything (we want this to be as fast as possible)." msgstr "" -#: library/typing.rst:2460 +#: library/typing.rst:2462 msgid "" "Ask a static type checker to confirm that *val* has an inferred type of " "*typ*." msgstr "" -#: library/typing.rst:2462 +#: library/typing.rst:2464 msgid "" "At runtime this does nothing: it returns the first argument unchanged with " "no checks or side effects, no matter the actual type of the argument." msgstr "" -#: library/typing.rst:2465 +#: library/typing.rst:2467 msgid "" "When a static type checker encounters a call to ``assert_type()``, it emits " "an error if the value is not of the specified type::" msgstr "" -#: library/typing.rst:2472 +#: library/typing.rst:2474 msgid "" "This function is useful for ensuring the type checker's understanding of a " "script is in line with the developer's intentions::" msgstr "" -#: library/typing.rst:2486 +#: library/typing.rst:2488 msgid "" "Ask a static type checker to confirm that a line of code is unreachable." msgstr "" -#: library/typing.rst:2488 +#: library/typing.rst:2490 msgid "Example::" msgstr "" -#: library/typing.rst:2499 +#: library/typing.rst:2501 msgid "" "Here, the annotations allow the type checker to infer that the last case can " "never execute, because ``arg`` is either an :class:`int` or a :class:`str`, " "and both options are covered by earlier cases." msgstr "" -#: library/typing.rst:2504 +#: library/typing.rst:2506 msgid "" "If a type checker finds that a call to ``assert_never()`` is reachable, it " "will emit an error. For example, if the type annotation for ``arg`` was " @@ -2097,47 +2097,47 @@ msgid "" "passed in must be the bottom type, :data:`Never`, and nothing else." msgstr "" -#: library/typing.rst:2512 +#: library/typing.rst:2514 msgid "At runtime, this throws an exception when called." msgstr "" -#: library/typing.rst:2515 +#: library/typing.rst:2517 msgid "" "`Unreachable Code and Exhaustiveness Checking `__ has more information about " "exhaustiveness checking with static typing." msgstr "" -#: library/typing.rst:2523 +#: library/typing.rst:2525 msgid "Ask a static type checker to reveal the inferred type of an expression." msgstr "" -#: library/typing.rst:2525 +#: library/typing.rst:2527 msgid "" "When a static type checker encounters a call to this function, it emits a " "diagnostic with the inferred type of the argument. For example::" msgstr "" -#: library/typing.rst:2531 +#: library/typing.rst:2533 msgid "" "This can be useful when you want to debug how your type checker handles a " "particular piece of code." msgstr "" -#: library/typing.rst:2534 +#: library/typing.rst:2536 msgid "" "At runtime, this function prints the runtime type of its argument to :data:" "`sys.stderr` and returns the argument unchanged (allowing the call to be " "used within an expression)::" msgstr "" -#: library/typing.rst:2541 +#: library/typing.rst:2543 msgid "" "Note that the runtime type may be different from (more or less specific " "than) the type statically inferred by a type checker." msgstr "" -#: library/typing.rst:2544 +#: library/typing.rst:2546 msgid "" "Most type checkers support ``reveal_type()`` anywhere, even if the name is " "not imported from ``typing``. Importing the name from ``typing``, however, " @@ -2145,13 +2145,13 @@ msgid "" "clearly." msgstr "" -#: library/typing.rst:2555 +#: library/typing.rst:2557 msgid "" "Decorator to mark an object as providing :func:`dataclass `-like behavior." msgstr "" -#: library/typing.rst:2558 +#: library/typing.rst:2560 msgid "" "``dataclass_transform`` may be used to decorate a class, metaclass, or a " "function that is itself a decorator. The presence of " @@ -2160,19 +2160,19 @@ msgid "" "to :func:`@dataclasses.dataclass `." msgstr "" -#: library/typing.rst:2565 +#: library/typing.rst:2567 msgid "Example usage with a decorator function:" msgstr "" -#: library/typing.rst:2579 +#: library/typing.rst:2581 msgid "On a base class::" msgstr "" -#: library/typing.rst:2588 +#: library/typing.rst:2590 msgid "On a metaclass::" msgstr "" -#: library/typing.rst:2599 +#: library/typing.rst:2601 msgid "" "The ``CustomerModel`` classes defined above will be treated by type checkers " "similarly to classes created with :func:`@dataclasses.dataclass `-decorated definitions for " "*func*." msgstr "" -#: library/typing.rst:2739 +#: library/typing.rst:2741 msgid "" "*func* is the function object for the implementation of the overloaded " "function. For example, given the definition of ``process`` in the " @@ -2390,32 +2390,32 @@ msgid "" "returns an empty sequence." msgstr "" -#: library/typing.rst:2746 +#: library/typing.rst:2748 msgid "" "``get_overloads()`` can be used for introspecting an overloaded function at " "runtime." msgstr "" -#: library/typing.rst:2754 +#: library/typing.rst:2756 msgid "Clear all registered overloads in the internal registry." msgstr "" -#: library/typing.rst:2756 +#: library/typing.rst:2758 msgid "This can be used to reclaim the memory used by the registry." msgstr "" -#: library/typing.rst:2763 +#: library/typing.rst:2765 msgid "Decorator to indicate final methods and final classes." msgstr "" -#: library/typing.rst:2765 +#: library/typing.rst:2767 msgid "" "Decorating a method with ``@final`` indicates to a type checker that the " "method cannot be overridden in a subclass. Decorating a class with " "``@final`` indicates that it cannot be subclassed." msgstr "" -#: library/typing.rst:2790 +#: library/typing.rst:2792 msgid "" "The decorator will now attempt to set a ``__final__`` attribute to ``True`` " "on the decorated object. Thus, a check like ``if getattr(obj, \"__final__\", " @@ -2425,11 +2425,11 @@ msgid "" "exception." msgstr "" -#: library/typing.rst:2801 +#: library/typing.rst:2803 msgid "Decorator to indicate that annotations are not type hints." msgstr "" -#: library/typing.rst:2803 +#: library/typing.rst:2805 msgid "" "This works as a class or function :term:`decorator`. With a class, it " "applies recursively to all methods and classes defined in that class (but " @@ -2437,38 +2437,38 @@ msgid "" "will ignore all annotations in a function or class with this decorator." msgstr "" -#: library/typing.rst:2809 +#: library/typing.rst:2811 msgid "``@no_type_check`` mutates the decorated object in place." msgstr "" -#: library/typing.rst:2813 +#: library/typing.rst:2815 msgid "Decorator to give another decorator the :func:`no_type_check` effect." msgstr "" -#: library/typing.rst:2815 +#: library/typing.rst:2817 msgid "" "This wraps the decorator with something that wraps the decorated function " "in :func:`no_type_check`." msgstr "" -#: library/typing.rst:2821 +#: library/typing.rst:2823 msgid "" "Decorator to indicate that a method in a subclass is intended to override a " "method or attribute in a superclass." msgstr "" -#: library/typing.rst:2824 +#: library/typing.rst:2826 msgid "" "Type checkers should emit an error if a method decorated with ``@override`` " "does not, in fact, override anything. This helps prevent bugs that may occur " "when a base class is changed without an equivalent change to a child class." msgstr "" -#: library/typing.rst:2846 +#: library/typing.rst:2848 msgid "There is no runtime checking of this property." msgstr "" -#: library/typing.rst:2848 +#: library/typing.rst:2850 msgid "" "The decorator will attempt to set an ``__override__`` attribute to ``True`` " "on the decorated object. Thus, a check like ``if getattr(obj, " @@ -2478,80 +2478,114 @@ msgid "" "without raising an exception." msgstr "" -#: library/typing.rst:2855 +#: library/typing.rst:2857 msgid "See :pep:`698` for more details." msgstr "" -#: library/typing.rst:2862 +#: library/typing.rst:2864 msgid "Decorator to mark a class or function as unavailable at runtime." msgstr "" -#: library/typing.rst:2864 +#: library/typing.rst:2866 msgid "" "This decorator is itself not available at runtime. It is mainly intended to " "mark classes that are defined in type stub files if an implementation " "returns an instance of a private class::" msgstr "" -#: library/typing.rst:2875 +#: library/typing.rst:2877 msgid "" "Note that returning instances of private classes is not recommended. It is " "usually preferable to make such classes public." msgstr "" -#: library/typing.rst:2879 +#: library/typing.rst:2881 msgid "Introspection helpers" msgstr "" -#: library/typing.rst:2883 +#: library/typing.rst:2885 msgid "" "Return a dictionary containing type hints for a function, method, module or " "class object." msgstr "" -#: library/typing.rst:2886 +#: library/typing.rst:2888 msgid "" -"This is often the same as ``obj.__annotations__``. In addition, forward " -"references encoded as string literals are handled by evaluating them in " -"``globals``, ``locals`` and (where applicable) :ref:`type parameter ` namespaces. For a class ``C``, return a dictionary constructed by " -"merging all the ``__annotations__`` along ``C.__mro__`` in reverse order." +"This is often the same as ``obj.__annotations__``, but this function makes " +"the following changes to the annotations dictionary:" msgstr "" -#: library/typing.rst:2894 +#: library/typing.rst:2891 msgid "" -"The function recursively replaces all ``Annotated[T, ...]`` with ``T``, " -"unless ``include_extras`` is set to ``True`` (see :class:`Annotated` for " -"more information). For example:" +"Forward references encoded as string literals or :class:`ForwardRef` objects " +"are handled by evaluating them in *globalns*, *localns*, and (where " +"applicable) *obj*'s :ref:`type parameter ` namespace. If " +"*globalns* or *localns* is not given, appropriate namespace dictionaries are " +"inferred from *obj*." +msgstr "" + +#: library/typing.rst:2896 +msgid "``None`` is replaced with :class:`types.NoneType`." msgstr "" -#: library/typing.rst:2911 +#: library/typing.rst:2897 msgid "" -":func:`get_type_hints` does not work with imported :ref:`type aliases ` that include forward references. Enabling postponed evaluation of " -"annotations (:pep:`563`) may remove the need for most forward references." +"If :func:`@no_type_check ` has been applied to *obj*, an " +"empty dictionary is returned." msgstr "" -#: library/typing.rst:2916 +#: library/typing.rst:2899 +msgid "" +"If *obj* is a class ``C``, the function returns a dictionary that merges " +"annotations from ``C``'s base classes with those on ``C`` directly. This is " +"done by traversing ``C.__mro__`` and iteratively combining " +"``__annotations__`` dictionaries. Annotations on classes appearing earlier " +"in the :term:`method resolution order` always take precedence over " +"annotations on classes appearing later in the method resolution order." +msgstr "" + +#: library/typing.rst:2905 +msgid "" +"The function recursively replaces all occurrences of ``Annotated[T, ...]`` " +"with ``T``, unless *include_extras* is set to ``True`` (see :class:" +"`Annotated` for more information)." +msgstr "" + +#: library/typing.rst:2909 +msgid "" +"See also :func:`inspect.get_annotations`, a lower-level function that " +"returns annotations more directly." +msgstr "" + +#: library/typing.rst:2914 +msgid "" +"If any forward references in the annotations of *obj* are not resolvable or " +"are not valid Python code, this function will raise an exception such as :" +"exc:`NameError`. For example, this can happen with imported :ref:`type " +"aliases ` that include forward references, or with names " +"imported under :data:`if TYPE_CHECKING `." +msgstr "" + +#: library/typing.rst:2920 msgid "" "Added ``include_extras`` parameter as part of :pep:`593`. See the " "documentation on :data:`Annotated` for more information." msgstr "" -#: library/typing.rst:2920 +#: library/typing.rst:2924 msgid "" "Previously, ``Optional[t]`` was added for function and method annotations if " "a default value equal to ``None`` was set. Now the annotation is returned " "unchanged." msgstr "" -#: library/typing.rst:2927 +#: library/typing.rst:2931 msgid "" "Get the unsubscripted version of a type: for a typing object of the form " "``X[Y, Z, ...]`` return ``X``." msgstr "" -#: library/typing.rst:2930 +#: library/typing.rst:2934 msgid "" "If ``X`` is a typing-module alias for a builtin or :mod:`collections` class, " "it will be normalized to the original class. If ``X`` is an instance of :" @@ -2559,17 +2593,17 @@ msgid "" "class:`ParamSpec`. Return ``None`` for unsupported objects." msgstr "" -#: library/typing.rst:2959 +#: library/typing.rst:2963 msgid "Examples:" msgstr "" -#: library/typing.rst:2951 +#: library/typing.rst:2955 msgid "" "Get type arguments with all substitutions performed: for a typing object of " "the form ``X[Y, Z, ...]`` return ``(Y, Z, ...)``." msgstr "" -#: library/typing.rst:2954 +#: library/typing.rst:2958 msgid "" "If ``X`` is a union or :class:`Literal` contained in another generic type, " "the order of ``(Y, Z, ...)`` may be different from the order of the original " @@ -2577,40 +2611,40 @@ msgid "" "objects." msgstr "" -#: library/typing.rst:2971 +#: library/typing.rst:2975 msgid "Check if a type is a :class:`TypedDict`." msgstr "" -#: library/typing.rst:2992 +#: library/typing.rst:2996 msgid "" "Class used for internal typing representation of string forward references." msgstr "" -#: library/typing.rst:2994 +#: library/typing.rst:2998 msgid "" "For example, ``List[\"SomeClass\"]`` is implicitly transformed into " "``List[ForwardRef(\"SomeClass\")]``. ``ForwardRef`` should not be " "instantiated by a user, but may be used by introspection tools." msgstr "" -#: library/typing.rst:2999 +#: library/typing.rst:3003 msgid "" ":pep:`585` generic types such as ``list[\"SomeClass\"]`` will not be " "implicitly transformed into ``list[ForwardRef(\"SomeClass\")]`` and thus " "will not automatically resolve to ``list[SomeClass]``." msgstr "" -#: library/typing.rst:3006 +#: library/typing.rst:3010 msgid "Constant" msgstr "" -#: library/typing.rst:3010 +#: library/typing.rst:3014 msgid "" "A special constant that is assumed to be ``True`` by 3rd party static type " "checkers. It is ``False`` at runtime." msgstr "" -#: library/typing.rst:3021 +#: library/typing.rst:3025 msgid "" "The first type annotation must be enclosed in quotes, making it a \"forward " "reference\", to hide the ``expensive_mod`` reference from the interpreter " @@ -2618,7 +2652,7 @@ msgid "" "second annotation does not need to be enclosed in quotes." msgstr "" -#: library/typing.rst:3028 +#: library/typing.rst:3032 msgid "" "If ``from __future__ import annotations`` is used, annotations are not " "evaluated at function definition time. Instead, they are stored as strings " @@ -2626,11 +2660,11 @@ msgid "" "annotation (see :pep:`563`)." msgstr "" -#: library/typing.rst:3040 +#: library/typing.rst:3044 msgid "Deprecated aliases" msgstr "" -#: library/typing.rst:3042 +#: library/typing.rst:3046 msgid "" "This module defines several deprecated aliases to pre-existing standard " "library classes. These were originally included in the typing module in " @@ -2639,7 +2673,7 @@ msgid "" "existing classes were enhanced to support ``[]`` (see :pep:`585`)." msgstr "" -#: library/typing.rst:3049 +#: library/typing.rst:3053 msgid "" "The redundant types are deprecated as of Python 3.9. However, while the " "aliases may be removed at some point, removal of these aliases is not " @@ -2647,7 +2681,7 @@ msgid "" "the interpreter for these aliases." msgstr "" -#: library/typing.rst:3054 +#: library/typing.rst:3058 msgid "" "If at some point it is decided to remove these deprecated aliases, a " "deprecation warning will be issued by the interpreter for at least two " @@ -2655,188 +2689,188 @@ msgid "" "typing module without deprecation warnings until at least Python 3.14." msgstr "" -#: library/typing.rst:3059 +#: library/typing.rst:3063 msgid "" "Type checkers are encouraged to flag uses of the deprecated types if the " "program they are checking targets a minimum Python version of 3.9 or newer." msgstr "" -#: library/typing.rst:3065 +#: library/typing.rst:3069 msgid "Aliases to built-in types" msgstr "" -#: library/typing.rst:3069 +#: library/typing.rst:3073 msgid "Deprecated alias to :class:`dict`." msgstr "" -#: library/typing.rst:3071 +#: library/typing.rst:3075 msgid "" "Note that to annotate arguments, it is preferred to use an abstract " "collection type such as :class:`Mapping` rather than to use :class:`dict` " "or :class:`!typing.Dict`." msgstr "" -#: library/typing.rst:3314 +#: library/typing.rst:3318 msgid "This type can be used as follows::" msgstr "" -#: library/typing.rst:3080 +#: library/typing.rst:3084 msgid "" ":class:`builtins.dict ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3086 +#: library/typing.rst:3090 msgid "Deprecated alias to :class:`list`." msgstr "" -#: library/typing.rst:3088 +#: library/typing.rst:3092 msgid "" "Note that to annotate arguments, it is preferred to use an abstract " "collection type such as :class:`Sequence` or :class:`Iterable` rather than " "to use :class:`list` or :class:`!typing.List`." msgstr "" -#: library/typing.rst:3092 +#: library/typing.rst:3096 msgid "This type may be used as follows::" msgstr "" -#: library/typing.rst:3100 +#: library/typing.rst:3104 msgid "" ":class:`builtins.list ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3106 +#: library/typing.rst:3110 msgid "Deprecated alias to :class:`builtins.set `." msgstr "" -#: library/typing.rst:3108 +#: library/typing.rst:3112 msgid "" "Note that to annotate arguments, it is preferred to use an abstract " "collection type such as :class:`AbstractSet` rather than to use :class:`set` " "or :class:`!typing.Set`." msgstr "" -#: library/typing.rst:3112 +#: library/typing.rst:3116 msgid "" ":class:`builtins.set ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3118 +#: library/typing.rst:3122 msgid "Deprecated alias to :class:`builtins.frozenset `." msgstr "" -#: library/typing.rst:3120 +#: library/typing.rst:3124 msgid "" ":class:`builtins.frozenset ` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3127 +#: library/typing.rst:3131 msgid "Deprecated alias for :class:`tuple`." msgstr "" -#: library/typing.rst:3129 +#: library/typing.rst:3133 msgid "" ":class:`tuple` and ``Tuple`` are special-cased in the type system; see :ref:" "`annotating-tuples` for more details." msgstr "" -#: library/typing.rst:3132 +#: library/typing.rst:3136 msgid "" ":class:`builtins.tuple ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3138 +#: library/typing.rst:3142 msgid "Deprecated alias to :class:`type`." msgstr "" -#: library/typing.rst:3140 +#: library/typing.rst:3144 msgid "" "See :ref:`type-of-class-objects` for details on using :class:`type` or " "``typing.Type`` in type annotations." msgstr "" -#: library/typing.rst:3145 +#: library/typing.rst:3149 msgid "" ":class:`builtins.type ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3152 +#: library/typing.rst:3156 msgid "Aliases to types in :mod:`collections`" msgstr "" -#: library/typing.rst:3156 +#: library/typing.rst:3160 msgid "Deprecated alias to :class:`collections.defaultdict`." msgstr "" -#: library/typing.rst:3160 +#: library/typing.rst:3164 msgid "" ":class:`collections.defaultdict` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3166 +#: library/typing.rst:3170 msgid "Deprecated alias to :class:`collections.OrderedDict`." msgstr "" -#: library/typing.rst:3170 +#: library/typing.rst:3174 msgid "" ":class:`collections.OrderedDict` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3176 +#: library/typing.rst:3180 msgid "Deprecated alias to :class:`collections.ChainMap`." msgstr "" -#: library/typing.rst:3180 +#: library/typing.rst:3184 msgid "" ":class:`collections.ChainMap` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3186 +#: library/typing.rst:3190 msgid "Deprecated alias to :class:`collections.Counter`." msgstr "" -#: library/typing.rst:3190 +#: library/typing.rst:3194 msgid "" ":class:`collections.Counter` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3196 +#: library/typing.rst:3200 msgid "Deprecated alias to :class:`collections.deque`." msgstr "" -#: library/typing.rst:3200 +#: library/typing.rst:3204 msgid "" ":class:`collections.deque` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3207 +#: library/typing.rst:3211 msgid "Aliases to other concrete types" msgstr "" -#: library/typing.rst:3212 +#: library/typing.rst:3213 msgid "" "The ``typing.io`` namespace is deprecated and will be removed. These types " "should be directly imported from ``typing`` instead." msgstr "" -#: library/typing.rst:3216 +#: library/typing.rst:3220 msgid "" "Deprecated aliases corresponding to the return types from :func:`re.compile` " "and :func:`re.match`." msgstr "" -#: library/typing.rst:3219 +#: library/typing.rst:3223 msgid "" "These types (and the corresponding functions) are generic over :data:" "`AnyStr`. ``Pattern`` can be specialised as ``Pattern[str]`` or " @@ -2844,391 +2878,391 @@ msgid "" "``Match[bytes]``." msgstr "" -#: library/typing.rst:3227 +#: library/typing.rst:3228 msgid "" "The ``typing.re`` namespace is deprecated and will be removed. These types " "should be directly imported from ``typing`` instead." msgstr "" -#: library/typing.rst:3228 +#: library/typing.rst:3232 msgid "" "Classes ``Pattern`` and ``Match`` from :mod:`re` now support ``[]``. See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3234 +#: library/typing.rst:3238 msgid "Deprecated alias for :class:`str`." msgstr "" -#: library/typing.rst:3236 +#: library/typing.rst:3240 msgid "" "``Text`` is provided to supply a forward compatible path for Python 2 code: " "in Python 2, ``Text`` is an alias for ``unicode``." msgstr "" -#: library/typing.rst:3240 +#: library/typing.rst:3244 msgid "" "Use ``Text`` to indicate that a value must contain a unicode string in a " "manner that is compatible with both Python 2 and Python 3::" msgstr "" -#: library/typing.rst:3248 +#: library/typing.rst:3252 msgid "" "Python 2 is no longer supported, and most type checkers also no longer " "support type checking Python 2 code. Removal of the alias is not currently " "planned, but users are encouraged to use :class:`str` instead of ``Text``." msgstr "" -#: library/typing.rst:3258 +#: library/typing.rst:3262 msgid "Aliases to container ABCs in :mod:`collections.abc`" msgstr "" -#: library/typing.rst:3262 +#: library/typing.rst:3266 msgid "Deprecated alias to :class:`collections.abc.Set`." msgstr "" -#: library/typing.rst:3264 +#: library/typing.rst:3268 msgid "" ":class:`collections.abc.Set` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3270 +#: library/typing.rst:3274 msgid "" "This type represents the types :class:`bytes`, :class:`bytearray`, and :" "class:`memoryview` of byte sequences." msgstr "" -#: library/typing.rst:3274 +#: library/typing.rst:3277 msgid "" "Prefer :class:`collections.abc.Buffer`, or a union like ``bytes | bytearray " "| memoryview``." msgstr "" -#: library/typing.rst:3278 +#: library/typing.rst:3282 msgid "Deprecated alias to :class:`collections.abc.Collection`." msgstr "" -#: library/typing.rst:3282 +#: library/typing.rst:3286 msgid "" ":class:`collections.abc.Collection` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3288 +#: library/typing.rst:3292 msgid "Deprecated alias to :class:`collections.abc.Container`." msgstr "" -#: library/typing.rst:3290 +#: library/typing.rst:3294 msgid "" ":class:`collections.abc.Container` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3296 +#: library/typing.rst:3300 msgid "Deprecated alias to :class:`collections.abc.ItemsView`." msgstr "" -#: library/typing.rst:3298 +#: library/typing.rst:3302 msgid "" ":class:`collections.abc.ItemsView` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3304 +#: library/typing.rst:3308 msgid "Deprecated alias to :class:`collections.abc.KeysView`." msgstr "" -#: library/typing.rst:3306 +#: library/typing.rst:3310 msgid "" ":class:`collections.abc.KeysView` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3312 +#: library/typing.rst:3316 msgid "Deprecated alias to :class:`collections.abc.Mapping`." msgstr "" -#: library/typing.rst:3319 +#: library/typing.rst:3323 msgid "" ":class:`collections.abc.Mapping` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3325 +#: library/typing.rst:3329 msgid "Deprecated alias to :class:`collections.abc.MappingView`." msgstr "" -#: library/typing.rst:3327 +#: library/typing.rst:3331 msgid "" ":class:`collections.abc.MappingView` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3333 +#: library/typing.rst:3337 msgid "Deprecated alias to :class:`collections.abc.MutableMapping`." msgstr "" -#: library/typing.rst:3335 +#: library/typing.rst:3339 msgid "" ":class:`collections.abc.MutableMapping` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3342 +#: library/typing.rst:3346 msgid "Deprecated alias to :class:`collections.abc.MutableSequence`." msgstr "" -#: library/typing.rst:3344 +#: library/typing.rst:3348 msgid "" ":class:`collections.abc.MutableSequence` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3351 +#: library/typing.rst:3355 msgid "Deprecated alias to :class:`collections.abc.MutableSet`." msgstr "" -#: library/typing.rst:3353 +#: library/typing.rst:3357 msgid "" ":class:`collections.abc.MutableSet` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3359 +#: library/typing.rst:3363 msgid "Deprecated alias to :class:`collections.abc.Sequence`." msgstr "" -#: library/typing.rst:3361 +#: library/typing.rst:3365 msgid "" ":class:`collections.abc.Sequence` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3367 +#: library/typing.rst:3371 msgid "Deprecated alias to :class:`collections.abc.ValuesView`." msgstr "" -#: library/typing.rst:3369 +#: library/typing.rst:3373 msgid "" ":class:`collections.abc.ValuesView` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3376 +#: library/typing.rst:3380 msgid "Aliases to asynchronous ABCs in :mod:`collections.abc`" msgstr "" -#: library/typing.rst:3380 +#: library/typing.rst:3384 msgid "Deprecated alias to :class:`collections.abc.Coroutine`." msgstr "" -#: library/typing.rst:3382 +#: library/typing.rst:3386 msgid "" "The variance and order of type variables correspond to those of :class:" "`Generator`, for example::" msgstr "" -#: library/typing.rst:3393 +#: library/typing.rst:3397 msgid "" ":class:`collections.abc.Coroutine` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3399 +#: library/typing.rst:3403 msgid "Deprecated alias to :class:`collections.abc.AsyncGenerator`." msgstr "" -#: library/typing.rst:3401 +#: library/typing.rst:3405 msgid "" "An async generator can be annotated by the generic type " "``AsyncGenerator[YieldType, SendType]``. For example::" msgstr "" -#: library/typing.rst:3410 +#: library/typing.rst:3414 msgid "" "Unlike normal generators, async generators cannot return a value, so there " "is no ``ReturnType`` type parameter. As with :class:`Generator`, the " "``SendType`` behaves contravariantly." msgstr "" -#: library/typing.rst:3414 +#: library/typing.rst:3418 msgid "" "If your generator will only yield values, set the ``SendType`` to ``None``::" msgstr "" -#: library/typing.rst:3422 +#: library/typing.rst:3426 msgid "" "Alternatively, annotate your generator as having a return type of either " "``AsyncIterable[YieldType]`` or ``AsyncIterator[YieldType]``::" msgstr "" -#: library/typing.rst:3432 +#: library/typing.rst:3436 msgid "" ":class:`collections.abc.AsyncGenerator` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3439 +#: library/typing.rst:3443 msgid "Deprecated alias to :class:`collections.abc.AsyncIterable`." msgstr "" -#: library/typing.rst:3443 +#: library/typing.rst:3447 msgid "" ":class:`collections.abc.AsyncIterable` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3449 +#: library/typing.rst:3453 msgid "Deprecated alias to :class:`collections.abc.AsyncIterator`." msgstr "" -#: library/typing.rst:3453 +#: library/typing.rst:3457 msgid "" ":class:`collections.abc.AsyncIterator` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3459 +#: library/typing.rst:3463 msgid "Deprecated alias to :class:`collections.abc.Awaitable`." msgstr "" -#: library/typing.rst:3463 +#: library/typing.rst:3467 msgid "" ":class:`collections.abc.Awaitable` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3470 +#: library/typing.rst:3474 msgid "Aliases to other ABCs in :mod:`collections.abc`" msgstr "" -#: library/typing.rst:3474 +#: library/typing.rst:3478 msgid "Deprecated alias to :class:`collections.abc.Iterable`." msgstr "" -#: library/typing.rst:3476 +#: library/typing.rst:3480 msgid "" ":class:`collections.abc.Iterable` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3482 +#: library/typing.rst:3486 msgid "Deprecated alias to :class:`collections.abc.Iterator`." msgstr "" -#: library/typing.rst:3484 +#: library/typing.rst:3488 msgid "" ":class:`collections.abc.Iterator` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3490 +#: library/typing.rst:3494 msgid "Deprecated alias to :class:`collections.abc.Callable`." msgstr "" -#: library/typing.rst:3492 +#: library/typing.rst:3496 msgid "" "See :ref:`annotating-callables` for details on how to use :class:" "`collections.abc.Callable` and ``typing.Callable`` in type annotations." msgstr "" -#: library/typing.rst:3495 +#: library/typing.rst:3499 msgid "" ":class:`collections.abc.Callable` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3505 +#: library/typing.rst:3509 msgid "Deprecated alias to :class:`collections.abc.Generator`." msgstr "" -#: library/typing.rst:3507 +#: library/typing.rst:3511 msgid "" "A generator can be annotated by the generic type ``Generator[YieldType, " "SendType, ReturnType]``. For example::" msgstr "" -#: library/typing.rst:3516 +#: library/typing.rst:3520 msgid "" "Note that unlike many other generics in the typing module, the ``SendType`` " "of :class:`Generator` behaves contravariantly, not covariantly or " "invariantly." msgstr "" -#: library/typing.rst:3520 +#: library/typing.rst:3524 msgid "" "If your generator will only yield values, set the ``SendType`` and " "``ReturnType`` to ``None``::" msgstr "" -#: library/typing.rst:3528 +#: library/typing.rst:3532 msgid "" "Alternatively, annotate your generator as having a return type of either " "``Iterable[YieldType]`` or ``Iterator[YieldType]``::" msgstr "" -#: library/typing.rst:3536 +#: library/typing.rst:3540 msgid "" ":class:`collections.abc.Generator` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3542 +#: library/typing.rst:3546 msgid "Deprecated alias to :class:`collections.abc.Hashable`." msgstr "" -#: library/typing.rst:3544 +#: library/typing.rst:3548 msgid "Use :class:`collections.abc.Hashable` directly instead." msgstr "" -#: library/typing.rst:3549 +#: library/typing.rst:3553 msgid "Deprecated alias to :class:`collections.abc.Reversible`." msgstr "" -#: library/typing.rst:3551 +#: library/typing.rst:3555 msgid "" ":class:`collections.abc.Reversible` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3557 +#: library/typing.rst:3561 msgid "Deprecated alias to :class:`collections.abc.Sized`." msgstr "" -#: library/typing.rst:3559 +#: library/typing.rst:3563 msgid "Use :class:`collections.abc.Sized` directly instead." msgstr "" -#: library/typing.rst:3565 +#: library/typing.rst:3569 msgid "Aliases to :mod:`contextlib` ABCs" msgstr "" -#: library/typing.rst:3569 +#: library/typing.rst:3573 msgid "Deprecated alias to :class:`contextlib.AbstractContextManager`." msgstr "" -#: library/typing.rst:3573 +#: library/typing.rst:3577 msgid "" ":class:`contextlib.AbstractContextManager` now supports subscripting " "(``[]``). See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3580 +#: library/typing.rst:3584 msgid "Deprecated alias to :class:`contextlib.AbstractAsyncContextManager`." msgstr "" -#: library/typing.rst:3584 +#: library/typing.rst:3588 msgid "" ":class:`contextlib.AbstractAsyncContextManager` now supports subscripting " "(``[]``). See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3590 +#: library/typing.rst:3594 msgid "Deprecation Timeline of Major Features" msgstr "" -#: library/typing.rst:3592 +#: library/typing.rst:3596 msgid "" "Certain features in ``typing`` are deprecated and may be removed in a future " "version of Python. The following table summarizes major deprecations for " @@ -3236,98 +3270,98 @@ msgid "" "listed." msgstr "" -#: library/typing.rst:3599 +#: library/typing.rst:3603 msgid "Feature" msgstr "" -#: library/typing.rst:3600 +#: library/typing.rst:3604 msgid "Deprecated in" msgstr "" -#: library/typing.rst:3601 +#: library/typing.rst:3605 msgid "Projected removal" msgstr "" -#: library/typing.rst:3602 +#: library/typing.rst:3606 msgid "PEP/issue" msgstr "" -#: library/typing.rst:3603 +#: library/typing.rst:3607 msgid "``typing.io`` and ``typing.re`` submodules" msgstr "" -#: library/typing.rst:3604 +#: library/typing.rst:3608 msgid "3.8" msgstr "" -#: library/typing.rst:3605 +#: library/typing.rst:3609 msgid "3.13" msgstr "" -#: library/typing.rst:3606 +#: library/typing.rst:3610 msgid ":issue:`38291`" msgstr "" -#: library/typing.rst:3607 +#: library/typing.rst:3611 msgid "``typing`` versions of standard collections" msgstr "" -#: library/typing.rst:3612 +#: library/typing.rst:3616 msgid "3.9" msgstr "" -#: library/typing.rst:3609 +#: library/typing.rst:3613 msgid "Undecided (see :ref:`deprecated-aliases` for more information)" msgstr "" -#: library/typing.rst:3610 +#: library/typing.rst:3614 msgid ":pep:`585`" msgstr "" -#: library/typing.rst:3611 +#: library/typing.rst:3615 msgid ":class:`typing.ByteString`" msgstr "" -#: library/typing.rst:3613 +#: library/typing.rst:3617 msgid "3.14" msgstr "" -#: library/typing.rst:3614 +#: library/typing.rst:3618 msgid ":gh:`91896`" msgstr "" -#: library/typing.rst:3615 +#: library/typing.rst:3619 msgid ":data:`typing.Text`" msgstr "" -#: library/typing.rst:3616 +#: library/typing.rst:3620 msgid "3.11" msgstr "" -#: library/typing.rst:3621 library/typing.rst:3625 +#: library/typing.rst:3625 library/typing.rst:3629 msgid "Undecided" msgstr "" -#: library/typing.rst:3618 +#: library/typing.rst:3622 msgid ":gh:`92332`" msgstr "" -#: library/typing.rst:3619 +#: library/typing.rst:3623 msgid ":class:`typing.Hashable` and :class:`typing.Sized`" msgstr "" -#: library/typing.rst:3624 +#: library/typing.rst:3628 msgid "3.12" msgstr "" -#: library/typing.rst:3622 +#: library/typing.rst:3626 msgid ":gh:`94309`" msgstr "" -#: library/typing.rst:3623 +#: library/typing.rst:3627 msgid ":data:`typing.TypeAlias`" msgstr "" -#: library/typing.rst:3626 +#: library/typing.rst:3630 msgid ":pep:`695`" msgstr "" diff --git a/library/unittest.mock.po b/library/unittest.mock.po index db7d08478..57a6386d9 100644 --- a/library/unittest.mock.po +++ b/library/unittest.mock.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -665,52 +665,63 @@ msgid "" "type object::" msgstr "" -#: library/unittest.mock.rst:862 +#: library/unittest.mock.rst:861 +msgid "" +"If an :exc:`AttributeError` is raised by :class:`PropertyMock`, it will be " +"interpreted as a missing descriptor and :meth:`~object.__getattr__` will be " +"called on the parent mock::" +msgstr "" + +#: library/unittest.mock.rst:871 +msgid "See :meth:`~object.__getattr__` for details." +msgstr "" + +#: library/unittest.mock.rst:876 msgid "" "An asynchronous version of :class:`MagicMock`. The :class:`AsyncMock` object " "will behave so the object is recognized as an async function, and the result " "of a call is an awaitable." msgstr "" -#: library/unittest.mock.rst:872 +#: library/unittest.mock.rst:886 msgid "" "The result of ``mock()`` is an async function which will have the outcome of " "``side_effect`` or ``return_value`` after it has been awaited:" msgstr "" -#: library/unittest.mock.rst:875 +#: library/unittest.mock.rst:889 msgid "" "if ``side_effect`` is a function, the async function will return the result " "of that function," msgstr "" -#: library/unittest.mock.rst:877 +#: library/unittest.mock.rst:891 msgid "" "if ``side_effect`` is an exception, the async function will raise the " "exception," msgstr "" -#: library/unittest.mock.rst:879 +#: library/unittest.mock.rst:893 msgid "" "if ``side_effect`` is an iterable, the async function will return the next " "value of the iterable, however, if the sequence of result is exhausted, " "``StopAsyncIteration`` is raised immediately," msgstr "" -#: library/unittest.mock.rst:882 +#: library/unittest.mock.rst:896 msgid "" "if ``side_effect`` is not defined, the async function will return the value " "defined by ``return_value``, hence, by default, the async function returns a " "new :class:`AsyncMock` object." msgstr "" -#: library/unittest.mock.rst:887 +#: library/unittest.mock.rst:901 msgid "" "Setting the *spec* of a :class:`Mock` or :class:`MagicMock` to an async " "function will result in a coroutine object being returned after calling." msgstr "" -#: library/unittest.mock.rst:899 +#: library/unittest.mock.rst:913 msgid "" "Setting the *spec* of a :class:`Mock`, :class:`MagicMock`, or :class:" "`AsyncMock` to a class with asynchronous and synchronous functions will " @@ -720,82 +731,82 @@ msgid "" "functions will be :class:`AsyncMock`." msgstr "" -#: library/unittest.mock.rst:927 +#: library/unittest.mock.rst:941 msgid "" "Assert that the mock was awaited at least once. Note that this is separate " "from the object having been called, the ``await`` keyword must be used:" msgstr "" -#: library/unittest.mock.rst:946 +#: library/unittest.mock.rst:960 msgid "Assert that the mock was awaited exactly once." msgstr "" -#: library/unittest.mock.rst:962 +#: library/unittest.mock.rst:976 msgid "Assert that the last await was with the specified arguments." msgstr "" -#: library/unittest.mock.rst:979 +#: library/unittest.mock.rst:993 msgid "" "Assert that the mock was awaited exactly once and with the specified " "arguments." msgstr "" -#: library/unittest.mock.rst:996 +#: library/unittest.mock.rst:1010 msgid "Assert the mock has ever been awaited with the specified arguments." msgstr "" -#: library/unittest.mock.rst:1012 +#: library/unittest.mock.rst:1026 msgid "" "Assert the mock has been awaited with the specified calls. The :attr:" "`await_args_list` list is checked for the awaits." msgstr "" -#: library/unittest.mock.rst:1015 +#: library/unittest.mock.rst:1029 msgid "" "If *any_order* is false then the awaits must be sequential. There can be " "extra calls before or after the specified awaits." msgstr "" -#: library/unittest.mock.rst:1019 +#: library/unittest.mock.rst:1033 msgid "" "If *any_order* is true then the awaits can be in any order, but they must " "all appear in :attr:`await_args_list`." msgstr "" -#: library/unittest.mock.rst:1039 +#: library/unittest.mock.rst:1053 msgid "Assert that the mock was never awaited." msgstr "" -#: library/unittest.mock.rst:1046 +#: library/unittest.mock.rst:1060 msgid "" "See :func:`Mock.reset_mock`. Also sets :attr:`await_count` to 0, :attr:" "`await_args` to None, and clears the :attr:`await_args_list`." msgstr "" -#: library/unittest.mock.rst:1051 +#: library/unittest.mock.rst:1065 msgid "" "An integer keeping track of how many times the mock object has been awaited." msgstr "" -#: library/unittest.mock.rst:1066 +#: library/unittest.mock.rst:1080 msgid "" "This is either ``None`` (if the mock hasn’t been awaited), or the arguments " "that the mock was last awaited with. Functions the same as :attr:`Mock." "call_args`." msgstr "" -#: library/unittest.mock.rst:1084 +#: library/unittest.mock.rst:1098 msgid "" "This is a list of all the awaits made to the mock object in sequence (so the " "length of the list is the number of times it has been awaited). Before any " "awaits have been made it is an empty list." msgstr "" -#: library/unittest.mock.rst:1103 +#: library/unittest.mock.rst:1117 msgid "Calling" msgstr "" -#: library/unittest.mock.rst:1105 +#: library/unittest.mock.rst:1119 msgid "" "Mock objects are callable. The call will return the value set as the :attr:" "`~Mock.return_value` attribute. The default return value is a new Mock " @@ -804,26 +815,26 @@ msgid "" "returned each time." msgstr "" -#: library/unittest.mock.rst:1111 +#: library/unittest.mock.rst:1125 msgid "" "Calls made to the object will be recorded in the attributes like :attr:" "`~Mock.call_args` and :attr:`~Mock.call_args_list`." msgstr "" -#: library/unittest.mock.rst:1114 +#: library/unittest.mock.rst:1128 msgid "" "If :attr:`~Mock.side_effect` is set then it will be called after the call " "has been recorded, so if :attr:`side_effect` raises an exception the call is " "still recorded." msgstr "" -#: library/unittest.mock.rst:1118 +#: library/unittest.mock.rst:1132 msgid "" "The simplest way to make a mock raise an exception when called is to make :" "attr:`~Mock.side_effect` an exception class or instance:" msgstr "" -#: library/unittest.mock.rst:1136 +#: library/unittest.mock.rst:1150 msgid "" "If :attr:`side_effect` is a function then whatever that function returns is " "what calls to the mock return. The :attr:`side_effect` function is called " @@ -831,7 +842,7 @@ msgid "" "value of the call dynamically, based on the input:" msgstr "" -#: library/unittest.mock.rst:1152 +#: library/unittest.mock.rst:1166 msgid "" "If you want the mock to still return the default return value (a new mock), " "or any set return value, then there are two ways of doing this. Either " @@ -839,36 +850,36 @@ msgid "" "data:`DEFAULT`:" msgstr "" -#: library/unittest.mock.rst:1171 +#: library/unittest.mock.rst:1185 msgid "" "To remove a :attr:`side_effect`, and return to the default behaviour, set " "the :attr:`side_effect` to ``None``:" msgstr "" -#: library/unittest.mock.rst:1185 +#: library/unittest.mock.rst:1199 msgid "" "The :attr:`side_effect` can also be any iterable object. Repeated calls to " "the mock will return values from the iterable (until the iterable is " "exhausted and a :exc:`StopIteration` is raised):" msgstr "" -#: library/unittest.mock.rst:1201 +#: library/unittest.mock.rst:1215 msgid "" "If any members of the iterable are exceptions they will be raised instead of " "returned::" msgstr "" -#: library/unittest.mock.rst:1219 +#: library/unittest.mock.rst:1233 msgid "Deleting Attributes" msgstr "" -#: library/unittest.mock.rst:1221 +#: library/unittest.mock.rst:1235 msgid "" "Mock objects create attributes on demand. This allows them to pretend to be " "objects of any type." msgstr "" -#: library/unittest.mock.rst:1224 +#: library/unittest.mock.rst:1238 msgid "" "You may want a mock object to return ``False`` to a :func:`hasattr` call, or " "raise an :exc:`AttributeError` when an attribute is fetched. You can do this " @@ -876,17 +887,17 @@ msgid "" "convenient." msgstr "" -#: library/unittest.mock.rst:1228 +#: library/unittest.mock.rst:1242 msgid "" "You \"block\" attributes by deleting them. Once deleted, accessing an " "attribute will raise an :exc:`AttributeError`." msgstr "" -#: library/unittest.mock.rst:1245 +#: library/unittest.mock.rst:1259 msgid "Mock names and the name attribute" msgstr "" -#: library/unittest.mock.rst:1247 +#: library/unittest.mock.rst:1261 msgid "" "Since \"name\" is an argument to the :class:`Mock` constructor, if you want " "your mock object to have a \"name\" attribute you can't just pass it in at " @@ -894,17 +905,17 @@ msgid "" "configure_mock`::" msgstr "" -#: library/unittest.mock.rst:1257 +#: library/unittest.mock.rst:1271 msgid "" "A simpler option is to simply set the \"name\" attribute after mock " "creation::" msgstr "" -#: library/unittest.mock.rst:1264 +#: library/unittest.mock.rst:1278 msgid "Attaching Mocks as Attributes" msgstr "" -#: library/unittest.mock.rst:1266 +#: library/unittest.mock.rst:1280 msgid "" "When you attach a mock as an attribute of another mock (or as the return " "value) it becomes a \"child\" of that mock. Calls to the child are recorded " @@ -915,20 +926,20 @@ msgid "" "calls between mocks:" msgstr "" -#: library/unittest.mock.rst:1284 +#: library/unittest.mock.rst:1298 msgid "" "The exception to this is if the mock has a name. This allows you to prevent " "the \"parenting\" if for some reason you don't want it to happen." msgstr "" -#: library/unittest.mock.rst:1295 +#: library/unittest.mock.rst:1309 msgid "" "Mocks created for you by :func:`patch` are automatically given names. To " "attach mocks that have names to a parent you use the :meth:`~Mock." "attach_mock` method::" msgstr "" -#: library/unittest.mock.rst:1313 +#: library/unittest.mock.rst:1327 msgid "" "The only exceptions are magic methods and attributes (those that have " "leading and trailing double underscores). Mock doesn't create these but " @@ -938,11 +949,11 @@ msgid "" "support see :ref:`magic methods `." msgstr "" -#: library/unittest.mock.rst:1322 +#: library/unittest.mock.rst:1336 msgid "The patchers" msgstr "" -#: library/unittest.mock.rst:1324 +#: library/unittest.mock.rst:1338 msgid "" "The patch decorators are used for patching objects only within the scope of " "the function they decorate. They automatically handle the unpatching for " @@ -950,17 +961,17 @@ msgid "" "in with statements or as class decorators." msgstr "" -#: library/unittest.mock.rst:1331 +#: library/unittest.mock.rst:1345 msgid "patch" msgstr "" -#: library/unittest.mock.rst:1335 +#: library/unittest.mock.rst:1349 msgid "" "The key is to do the patching in the right namespace. See the section `where " "to patch`_." msgstr "" -#: library/unittest.mock.rst:1339 +#: library/unittest.mock.rst:1353 msgid "" ":func:`patch` acts as a function decorator, class decorator or a context " "manager. Inside the body of the function or with statement, the *target* is " @@ -968,7 +979,7 @@ msgid "" "patch is undone." msgstr "" -#: library/unittest.mock.rst:1344 +#: library/unittest.mock.rst:1358 msgid "" "If *new* is omitted, then the target is replaced with an :class:`AsyncMock` " "if the patched object is an async function or a :class:`MagicMock` " @@ -978,7 +989,7 @@ msgid "" "by the context manager." msgstr "" -#: library/unittest.mock.rst:1352 +#: library/unittest.mock.rst:1366 msgid "" "*target* should be a string in the form ``'package.module.ClassName'``. The " "*target* is imported and the specified object replaced with the *new* " @@ -987,26 +998,26 @@ msgid "" "function is executed, not at decoration time." msgstr "" -#: library/unittest.mock.rst:1358 +#: library/unittest.mock.rst:1372 msgid "" "The *spec* and *spec_set* keyword arguments are passed to the :class:" "`MagicMock` if patch is creating one for you." msgstr "" -#: library/unittest.mock.rst:1361 +#: library/unittest.mock.rst:1375 msgid "" "In addition you can pass ``spec=True`` or ``spec_set=True``, which causes " "patch to pass in the object being mocked as the spec/spec_set object." msgstr "" -#: library/unittest.mock.rst:1364 +#: library/unittest.mock.rst:1378 msgid "" "*new_callable* allows you to specify a different class, or callable object, " "that will be called to create the *new* object. By default :class:" "`AsyncMock` is used for async functions and :class:`MagicMock` for the rest." msgstr "" -#: library/unittest.mock.rst:1368 +#: library/unittest.mock.rst:1382 msgid "" "A more powerful form of *spec* is *autospec*. If you set ``autospec=True`` " "then the mock will be created with a spec from the object being replaced. " @@ -1018,13 +1029,13 @@ msgid "" "func:`create_autospec` function and :ref:`auto-speccing`." msgstr "" -#: library/unittest.mock.rst:1378 +#: library/unittest.mock.rst:1392 msgid "" "Instead of ``autospec=True`` you can pass ``autospec=some_object`` to use an " "arbitrary object as the spec instead of the one being replaced." msgstr "" -#: library/unittest.mock.rst:1381 +#: library/unittest.mock.rst:1395 msgid "" "By default :func:`patch` will fail to replace attributes that don't exist. " "If you pass in ``create=True``, and the attribute doesn't exist, patch will " @@ -1035,13 +1046,13 @@ msgid "" "write passing tests against APIs that don't actually exist!" msgstr "" -#: library/unittest.mock.rst:1391 +#: library/unittest.mock.rst:1405 msgid "" "If you are patching builtins in a module then you don't need to pass " "``create=True``, it will be added by default." msgstr "" -#: library/unittest.mock.rst:1395 +#: library/unittest.mock.rst:1409 msgid "" "Patch can be used as a :class:`TestCase` class decorator. It works by " "decorating each test method in the class. This reduces the boilerplate code " @@ -1052,7 +1063,7 @@ msgid "" "TEST_PREFIX``." msgstr "" -#: library/unittest.mock.rst:1402 +#: library/unittest.mock.rst:1416 msgid "" "Patch can be used as a context manager, with the with statement. Here the " "patching applies to the indented block after the with statement. If you use " @@ -1060,65 +1071,65 @@ msgid "" "very useful if :func:`patch` is creating a mock object for you." msgstr "" -#: library/unittest.mock.rst:1407 +#: library/unittest.mock.rst:1421 msgid "" ":func:`patch` takes arbitrary keyword arguments. These will be passed to :" "class:`AsyncMock` if the patched object is asynchronous, to :class:" "`MagicMock` otherwise or to *new_callable* if specified." msgstr "" -#: library/unittest.mock.rst:1411 +#: library/unittest.mock.rst:1425 msgid "" "``patch.dict(...)``, ``patch.multiple(...)`` and ``patch.object(...)`` are " "available for alternate use-cases." msgstr "" -#: library/unittest.mock.rst:1414 +#: library/unittest.mock.rst:1428 msgid "" ":func:`patch` as function decorator, creating the mock for you and passing " "it into the decorated function::" msgstr "" -#: library/unittest.mock.rst:1424 +#: library/unittest.mock.rst:1438 msgid "" "Patching a class replaces the class with a :class:`MagicMock` *instance*. If " "the class is instantiated in the code under test then it will be the :attr:" "`~Mock.return_value` of the mock that will be used." msgstr "" -#: library/unittest.mock.rst:1428 +#: library/unittest.mock.rst:1442 msgid "" "If the class is instantiated multiple times you could use :attr:`~Mock." "side_effect` to return a new mock each time. Alternatively you can set the " "*return_value* to be anything you want." msgstr "" -#: library/unittest.mock.rst:1432 +#: library/unittest.mock.rst:1446 msgid "" "To configure return values on methods of *instances* on the patched class " "you must do this on the :attr:`return_value`. For example::" msgstr "" -#: library/unittest.mock.rst:1446 +#: library/unittest.mock.rst:1460 msgid "" "If you use *spec* or *spec_set* and :func:`patch` is replacing a *class*, " "then the return value of the created mock will have the same spec. ::" msgstr "" -#: library/unittest.mock.rst:1456 +#: library/unittest.mock.rst:1470 msgid "" "The *new_callable* argument is useful where you want to use an alternative " "class to the default :class:`MagicMock` for the created mock. For example, " "if you wanted a :class:`NonCallableMock` to be used::" msgstr "" -#: library/unittest.mock.rst:1469 +#: library/unittest.mock.rst:1483 msgid "" "Another use case might be to replace an object with an :class:`io.StringIO` " "instance::" msgstr "" -#: library/unittest.mock.rst:1482 +#: library/unittest.mock.rst:1496 msgid "" "When :func:`patch` is creating a mock for you, it is common that the first " "thing you need to do is to configure the mock. Some of that configuration " @@ -1126,7 +1137,7 @@ msgid "" "call will be used to set attributes on the created mock::" msgstr "" -#: library/unittest.mock.rst:1494 +#: library/unittest.mock.rst:1508 msgid "" "As well as attributes on the created mock attributes, like the :attr:`~Mock." "return_value` and :attr:`~Mock.side_effect`, of child mocks can also be " @@ -1135,36 +1146,36 @@ msgid "" "func:`patch` call using ``**``::" msgstr "" -#: library/unittest.mock.rst:1510 +#: library/unittest.mock.rst:1524 msgid "" "By default, attempting to patch a function in a module (or a method or an " "attribute in a class) that does not exist will fail with :exc:" "`AttributeError`::" msgstr "" -#: library/unittest.mock.rst:1522 +#: library/unittest.mock.rst:1536 msgid "" "but adding ``create=True`` in the call to :func:`patch` will make the " "previous example work as expected::" msgstr "" -#: library/unittest.mock.rst:1533 +#: library/unittest.mock.rst:1547 msgid "" ":func:`patch` now returns an :class:`AsyncMock` if the target is an async " "function." msgstr "" -#: library/unittest.mock.rst:1537 +#: library/unittest.mock.rst:1551 msgid "patch.object" msgstr "" -#: library/unittest.mock.rst:1541 +#: library/unittest.mock.rst:1555 msgid "" "patch the named member (*attribute*) on an object (*target*) with a mock " "object." msgstr "" -#: library/unittest.mock.rst:1544 +#: library/unittest.mock.rst:1558 msgid "" ":func:`patch.object` can be used as a decorator, class decorator or a " "context manager. Arguments *new*, *spec*, *create*, *spec_set*, *autospec* " @@ -1173,112 +1184,112 @@ msgid "" "configuring the mock object it creates." msgstr "" -#: library/unittest.mock.rst:1550 +#: library/unittest.mock.rst:1564 msgid "" "When used as a class decorator :func:`patch.object` honours ``patch." "TEST_PREFIX`` for choosing which methods to wrap." msgstr "" -#: library/unittest.mock.rst:1553 +#: library/unittest.mock.rst:1567 msgid "" "You can either call :func:`patch.object` with three arguments or two " "arguments. The three argument form takes the object to be patched, the " "attribute name and the object to replace the attribute with." msgstr "" -#: library/unittest.mock.rst:1557 +#: library/unittest.mock.rst:1571 msgid "" "When calling with the two argument form you omit the replacement object, and " "a mock is created for you and passed in as an extra argument to the " "decorated function:" msgstr "" -#: library/unittest.mock.rst:1568 +#: library/unittest.mock.rst:1582 msgid "" "*spec*, *create* and the other arguments to :func:`patch.object` have the " "same meaning as they do for :func:`patch`." msgstr "" -#: library/unittest.mock.rst:1573 +#: library/unittest.mock.rst:1587 msgid "patch.dict" msgstr "" -#: library/unittest.mock.rst:1577 +#: library/unittest.mock.rst:1591 msgid "" "Patch a dictionary, or dictionary like object, and restore the dictionary to " "its original state after the test." msgstr "" -#: library/unittest.mock.rst:1580 +#: library/unittest.mock.rst:1594 msgid "" "*in_dict* can be a dictionary or a mapping like container. If it is a " "mapping then it must at least support getting, setting and deleting items " "plus iterating over keys." msgstr "" -#: library/unittest.mock.rst:1584 +#: library/unittest.mock.rst:1598 msgid "" "*in_dict* can also be a string specifying the name of the dictionary, which " "will then be fetched by importing it." msgstr "" -#: library/unittest.mock.rst:1587 +#: library/unittest.mock.rst:1601 msgid "" "*values* can be a dictionary of values to set in the dictionary. *values* " "can also be an iterable of ``(key, value)`` pairs." msgstr "" -#: library/unittest.mock.rst:1590 +#: library/unittest.mock.rst:1604 msgid "" "If *clear* is true then the dictionary will be cleared before the new values " "are set." msgstr "" -#: library/unittest.mock.rst:1593 +#: library/unittest.mock.rst:1607 msgid "" ":func:`patch.dict` can also be called with arbitrary keyword arguments to " "set values in the dictionary." msgstr "" -#: library/unittest.mock.rst:1598 +#: library/unittest.mock.rst:1612 msgid "" ":func:`patch.dict` now returns the patched dictionary when used as a context " "manager." msgstr "" -#: library/unittest.mock.rst:1601 +#: library/unittest.mock.rst:1615 msgid "" ":func:`patch.dict` can be used as a context manager, decorator or class " "decorator:" msgstr "" -#: library/unittest.mock.rst:1612 +#: library/unittest.mock.rst:1626 msgid "" "When used as a class decorator :func:`patch.dict` honours ``patch." "TEST_PREFIX`` (default to ``'test'``) for choosing which methods to wrap:" msgstr "" -#: library/unittest.mock.rst:1623 +#: library/unittest.mock.rst:1637 msgid "" "If you want to use a different prefix for your test, you can inform the " "patchers of the different prefix by setting ``patch.TEST_PREFIX``. For more " "details about how to change the value of see :ref:`test-prefix`." msgstr "" -#: library/unittest.mock.rst:1627 +#: library/unittest.mock.rst:1641 msgid "" ":func:`patch.dict` can be used to add members to a dictionary, or simply let " "a test change a dictionary, and ensure the dictionary is restored when the " "test ends." msgstr "" -#: library/unittest.mock.rst:1648 +#: library/unittest.mock.rst:1662 msgid "" "Keywords can be used in the :func:`patch.dict` call to set values in the " "dictionary:" msgstr "" -#: library/unittest.mock.rst:1658 +#: library/unittest.mock.rst:1672 msgid "" ":func:`patch.dict` can be used with dictionary like objects that aren't " "actually dictionaries. At the very minimum they must support item getting, " @@ -1288,18 +1299,18 @@ msgid "" "__iter__` or :meth:`~object.__contains__`." msgstr "" -#: library/unittest.mock.rst:1688 +#: library/unittest.mock.rst:1702 msgid "patch.multiple" msgstr "" -#: library/unittest.mock.rst:1692 +#: library/unittest.mock.rst:1706 msgid "" "Perform multiple patches in a single call. It takes the object to be patched " "(either as an object or a string to fetch the object by importing) and " "keyword arguments for the patches::" msgstr "" -#: library/unittest.mock.rst:1699 +#: library/unittest.mock.rst:1713 msgid "" "Use :data:`DEFAULT` as the value if you want :func:`patch.multiple` to " "create mocks for you. In this case the created mocks are passed into a " @@ -1307,7 +1318,7 @@ msgid "" "`patch.multiple` is used as a context manager." msgstr "" -#: library/unittest.mock.rst:1704 +#: library/unittest.mock.rst:1718 msgid "" ":func:`patch.multiple` can be used as a decorator, class decorator or a " "context manager. The arguments *spec*, *spec_set*, *create*, *autospec* and " @@ -1315,13 +1326,13 @@ msgid "" "will be applied to *all* patches done by :func:`patch.multiple`." msgstr "" -#: library/unittest.mock.rst:1709 +#: library/unittest.mock.rst:1723 msgid "" "When used as a class decorator :func:`patch.multiple` honours ``patch." "TEST_PREFIX`` for choosing which methods to wrap." msgstr "" -#: library/unittest.mock.rst:1712 +#: library/unittest.mock.rst:1726 msgid "" "If you want :func:`patch.multiple` to create mocks for you, then you can " "use :data:`DEFAULT` as the value. If you use :func:`patch.multiple` as a " @@ -1329,32 +1340,32 @@ msgid "" "keyword. ::" msgstr "" -#: library/unittest.mock.rst:1726 +#: library/unittest.mock.rst:1740 msgid "" ":func:`patch.multiple` can be nested with other ``patch`` decorators, but " "put arguments passed by keyword *after* any of the standard arguments " "created by :func:`patch`::" msgstr "" -#: library/unittest.mock.rst:1738 +#: library/unittest.mock.rst:1752 msgid "" "If :func:`patch.multiple` is used as a context manager, the value returned " "by the context manager is a dictionary where created mocks are keyed by " "name::" msgstr "" -#: library/unittest.mock.rst:1752 +#: library/unittest.mock.rst:1766 msgid "patch methods: start and stop" msgstr "" -#: library/unittest.mock.rst:1754 +#: library/unittest.mock.rst:1768 msgid "" "All the patchers have :meth:`start` and :meth:`stop` methods. These make it " "simpler to do patching in ``setUp`` methods or where you want to do multiple " "patches without nesting decorators or with statements." msgstr "" -#: library/unittest.mock.rst:1758 +#: library/unittest.mock.rst:1772 msgid "" "To use them call :func:`patch`, :func:`patch.object` or :func:`patch.dict` " "as normal and keep a reference to the returned ``patcher`` object. You can " @@ -1362,19 +1373,19 @@ msgid "" "it." msgstr "" -#: library/unittest.mock.rst:1762 +#: library/unittest.mock.rst:1776 msgid "" "If you are using :func:`patch` to create a mock for you then it will be " "returned by the call to ``patcher.start``. ::" msgstr "" -#: library/unittest.mock.rst:1776 +#: library/unittest.mock.rst:1790 msgid "" "A typical use case for this might be for doing multiple patches in the " "``setUp`` method of a :class:`TestCase`::" msgstr "" -#: library/unittest.mock.rst:1798 +#: library/unittest.mock.rst:1812 msgid "" "If you use this technique you must ensure that the patching is \"undone\" by " "calling ``stop``. This can be fiddlier than you might think, because if an " @@ -1382,37 +1393,37 @@ msgid "" "`unittest.TestCase.addCleanup` makes this easier::" msgstr "" -#: library/unittest.mock.rst:1813 +#: library/unittest.mock.rst:1827 msgid "" "As an added bonus you no longer need to keep a reference to the ``patcher`` " "object." msgstr "" -#: library/unittest.mock.rst:1816 +#: library/unittest.mock.rst:1830 msgid "" "It is also possible to stop all patches which have been started by using :" "func:`patch.stopall`." msgstr "" -#: library/unittest.mock.rst:1821 +#: library/unittest.mock.rst:1835 msgid "Stop all active patches. Only stops patches started with ``start``." msgstr "" -#: library/unittest.mock.rst:1827 +#: library/unittest.mock.rst:1841 msgid "patch builtins" msgstr "" -#: library/unittest.mock.rst:1828 +#: library/unittest.mock.rst:1842 msgid "" "You can patch any builtins within a module. The following example patches " "builtin :func:`ord`::" msgstr "" -#: library/unittest.mock.rst:1843 +#: library/unittest.mock.rst:1857 msgid "TEST_PREFIX" msgstr "" -#: library/unittest.mock.rst:1845 +#: library/unittest.mock.rst:1859 msgid "" "All of the patchers can be used as class decorators. When used in this way " "they wrap every test method on the class. The patchers recognise methods " @@ -1420,39 +1431,39 @@ msgid "" "the :class:`unittest.TestLoader` finds test methods by default." msgstr "" -#: library/unittest.mock.rst:1850 +#: library/unittest.mock.rst:1864 msgid "" "It is possible that you want to use a different prefix for your tests. You " "can inform the patchers of the different prefix by setting ``patch." "TEST_PREFIX``::" msgstr "" -#: library/unittest.mock.rst:1873 +#: library/unittest.mock.rst:1887 msgid "Nesting Patch Decorators" msgstr "" -#: library/unittest.mock.rst:1875 +#: library/unittest.mock.rst:1889 msgid "" "If you want to perform multiple patches then you can simply stack up the " "decorators." msgstr "" -#: library/unittest.mock.rst:1878 +#: library/unittest.mock.rst:1892 msgid "You can stack up multiple patch decorators using this pattern:" msgstr "" -#: library/unittest.mock.rst:1894 +#: library/unittest.mock.rst:1908 msgid "" "Note that the decorators are applied from the bottom upwards. This is the " "standard way that Python applies decorators. The order of the created mocks " "passed into your test function matches this order." msgstr "" -#: library/unittest.mock.rst:1902 +#: library/unittest.mock.rst:1916 msgid "Where to patch" msgstr "" -#: library/unittest.mock.rst:1904 +#: library/unittest.mock.rst:1918 msgid "" ":func:`patch` works by (temporarily) changing the object that a *name* " "points to with another one. There can be many names pointing to any " @@ -1460,19 +1471,19 @@ msgid "" "the name used by the system under test." msgstr "" -#: library/unittest.mock.rst:1909 +#: library/unittest.mock.rst:1923 msgid "" "The basic principle is that you patch where an object is *looked up*, which " "is not necessarily the same place as where it is defined. A couple of " "examples will help to clarify this." msgstr "" -#: library/unittest.mock.rst:1913 +#: library/unittest.mock.rst:1927 msgid "" "Imagine we have a project that we want to test with the following structure::" msgstr "" -#: library/unittest.mock.rst:1922 +#: library/unittest.mock.rst:1936 msgid "" "Now we want to test ``some_function`` but we want to mock out ``SomeClass`` " "using :func:`patch`. The problem is that when we import module b, which we " @@ -1482,7 +1493,7 @@ msgid "" "like our patching had no effect." msgstr "" -#: library/unittest.mock.rst:1929 +#: library/unittest.mock.rst:1943 msgid "" "The key is to patch out ``SomeClass`` where it is used (or where it is " "looked up). In this case ``some_function`` will actually look up " @@ -1490,7 +1501,7 @@ msgid "" "look like::" msgstr "" -#: library/unittest.mock.rst:1935 +#: library/unittest.mock.rst:1949 msgid "" "However, consider the alternative scenario where instead of ``from a import " "SomeClass`` module b does ``import a`` and ``some_function`` uses ``a." @@ -1499,11 +1510,11 @@ msgid "" "``a.SomeClass`` instead::" msgstr "" -#: library/unittest.mock.rst:1944 +#: library/unittest.mock.rst:1958 msgid "Patching Descriptors and Proxy Objects" msgstr "" -#: library/unittest.mock.rst:1946 +#: library/unittest.mock.rst:1960 msgid "" "Both patch_ and patch.object_ correctly patch and restore descriptors: class " "methods, static methods and properties. You should patch these on the " @@ -1513,22 +1524,22 @@ msgid "" "arch_d7_2010_12_04.shtml#e1198>`_." msgstr "" -#: library/unittest.mock.rst:1954 +#: library/unittest.mock.rst:1968 msgid "MagicMock and magic method support" msgstr "" -#: library/unittest.mock.rst:1959 +#: library/unittest.mock.rst:1973 msgid "Mocking Magic Methods" msgstr "" -#: library/unittest.mock.rst:1961 +#: library/unittest.mock.rst:1975 msgid "" ":class:`Mock` supports mocking the Python protocol methods, also known as :" "term:`\"magic methods\" `. This allows mock objects to replace " "containers or other objects that implement Python protocols." msgstr "" -#: library/unittest.mock.rst:1965 +#: library/unittest.mock.rst:1979 msgid "" "Because magic methods are looked up differently from normal methods [#]_, " "this support has been specially implemented. This means that only specific " @@ -1536,72 +1547,72 @@ msgid "" "them. If there are any missing that you need please let us know." msgstr "" -#: library/unittest.mock.rst:1970 +#: library/unittest.mock.rst:1984 msgid "" "You mock magic methods by setting the method you are interested in to a " "function or a mock instance. If you are using a function then it *must* take " "``self`` as the first argument [#]_." msgstr "" -#: library/unittest.mock.rst:1993 +#: library/unittest.mock.rst:2007 msgid "" "One use case for this is for mocking objects used as context managers in a :" "keyword:`with` statement:" msgstr "" -#: library/unittest.mock.rst:2005 +#: library/unittest.mock.rst:2019 msgid "" "Calls to magic methods do not appear in :attr:`~Mock.method_calls`, but they " "are recorded in :attr:`~Mock.mock_calls`." msgstr "" -#: library/unittest.mock.rst:2010 +#: library/unittest.mock.rst:2024 msgid "" "If you use the *spec* keyword argument to create a mock then attempting to " "set a magic method that isn't in the spec will raise an :exc:" "`AttributeError`." msgstr "" -#: library/unittest.mock.rst:2013 +#: library/unittest.mock.rst:2027 msgid "The full list of supported magic methods is:" msgstr "" -#: library/unittest.mock.rst:2015 +#: library/unittest.mock.rst:2029 msgid "``__hash__``, ``__sizeof__``, ``__repr__`` and ``__str__``" msgstr "" -#: library/unittest.mock.rst:2016 +#: library/unittest.mock.rst:2030 msgid "``__dir__``, ``__format__`` and ``__subclasses__``" msgstr "" -#: library/unittest.mock.rst:2017 +#: library/unittest.mock.rst:2031 msgid "``__round__``, ``__floor__``, ``__trunc__`` and ``__ceil__``" msgstr "" -#: library/unittest.mock.rst:2018 +#: library/unittest.mock.rst:2032 msgid "" "Comparisons: ``__lt__``, ``__gt__``, ``__le__``, ``__ge__``, ``__eq__`` and " "``__ne__``" msgstr "" -#: library/unittest.mock.rst:2020 +#: library/unittest.mock.rst:2034 msgid "" "Container methods: ``__getitem__``, ``__setitem__``, ``__delitem__``, " "``__contains__``, ``__len__``, ``__iter__``, ``__reversed__`` and " "``__missing__``" msgstr "" -#: library/unittest.mock.rst:2023 +#: library/unittest.mock.rst:2037 msgid "" "Context manager: ``__enter__``, ``__exit__``, ``__aenter__`` and " "``__aexit__``" msgstr "" -#: library/unittest.mock.rst:2024 +#: library/unittest.mock.rst:2038 msgid "Unary numeric methods: ``__neg__``, ``__pos__`` and ``__invert__``" msgstr "" -#: library/unittest.mock.rst:2025 +#: library/unittest.mock.rst:2039 msgid "" "The numeric methods (including right hand and in-place variants): " "``__add__``, ``__sub__``, ``__mul__``, ``__matmul__``, ``__truediv__``, " @@ -1609,100 +1620,100 @@ msgid "" "``__rshift__``, ``__and__``, ``__xor__``, ``__or__``, and ``__pow__``" msgstr "" -#: library/unittest.mock.rst:2029 +#: library/unittest.mock.rst:2043 msgid "" "Numeric conversion methods: ``__complex__``, ``__int__``, ``__float__`` and " "``__index__``" msgstr "" -#: library/unittest.mock.rst:2031 +#: library/unittest.mock.rst:2045 msgid "Descriptor methods: ``__get__``, ``__set__`` and ``__delete__``" msgstr "" -#: library/unittest.mock.rst:2032 +#: library/unittest.mock.rst:2046 msgid "" "Pickling: ``__reduce__``, ``__reduce_ex__``, ``__getinitargs__``, " "``__getnewargs__``, ``__getstate__`` and ``__setstate__``" msgstr "" -#: library/unittest.mock.rst:2034 +#: library/unittest.mock.rst:2048 msgid "File system path representation: ``__fspath__``" msgstr "" -#: library/unittest.mock.rst:2035 +#: library/unittest.mock.rst:2049 msgid "Asynchronous iteration methods: ``__aiter__`` and ``__anext__``" msgstr "" -#: library/unittest.mock.rst:2037 +#: library/unittest.mock.rst:2051 msgid "Added support for :func:`os.PathLike.__fspath__`." msgstr "" -#: library/unittest.mock.rst:2040 +#: library/unittest.mock.rst:2054 msgid "" "Added support for ``__aenter__``, ``__aexit__``, ``__aiter__`` and " "``__anext__``." msgstr "" -#: library/unittest.mock.rst:2044 +#: library/unittest.mock.rst:2058 msgid "" "The following methods exist but are *not* supported as they are either in " "use by mock, can't be set dynamically, or can cause problems:" msgstr "" -#: library/unittest.mock.rst:2047 +#: library/unittest.mock.rst:2061 msgid "``__getattr__``, ``__setattr__``, ``__init__`` and ``__new__``" msgstr "" -#: library/unittest.mock.rst:2048 +#: library/unittest.mock.rst:2062 msgid "" "``__prepare__``, ``__instancecheck__``, ``__subclasscheck__``, ``__del__``" msgstr "" -#: library/unittest.mock.rst:2053 +#: library/unittest.mock.rst:2067 msgid "Magic Mock" msgstr "" -#: library/unittest.mock.rst:2055 +#: library/unittest.mock.rst:2069 msgid "" "There are two ``MagicMock`` variants: :class:`MagicMock` and :class:" "`NonCallableMagicMock`." msgstr "" -#: library/unittest.mock.rst:2060 +#: library/unittest.mock.rst:2074 msgid "" "``MagicMock`` is a subclass of :class:`Mock` with default implementations of " "most of the :term:`magic methods `. You can use ``MagicMock`` " "without having to configure the magic methods yourself." msgstr "" -#: library/unittest.mock.rst:2064 +#: library/unittest.mock.rst:2078 msgid "The constructor parameters have the same meaning as for :class:`Mock`." msgstr "" -#: library/unittest.mock.rst:2066 +#: library/unittest.mock.rst:2080 msgid "" "If you use the *spec* or *spec_set* arguments then *only* magic methods that " "exist in the spec will be created." msgstr "" -#: library/unittest.mock.rst:2072 +#: library/unittest.mock.rst:2086 msgid "A non-callable version of :class:`MagicMock`." msgstr "" -#: library/unittest.mock.rst:2074 +#: library/unittest.mock.rst:2088 msgid "" "The constructor parameters have the same meaning as for :class:`MagicMock`, " "with the exception of *return_value* and *side_effect* which have no meaning " "on a non-callable mock." msgstr "" -#: library/unittest.mock.rst:2078 +#: library/unittest.mock.rst:2092 msgid "" "The magic methods are setup with :class:`MagicMock` objects, so you can " "configure them and use them in the usual way:" msgstr "" -#: library/unittest.mock.rst:2088 +#: library/unittest.mock.rst:2102 msgid "" "By default many of the protocol methods are required to return objects of a " "specific type. These methods are preconfigured with a default return value, " @@ -1711,83 +1722,83 @@ msgid "" "manually if you want to change the default." msgstr "" -#: library/unittest.mock.rst:2094 +#: library/unittest.mock.rst:2108 msgid "Methods and their defaults:" msgstr "" -#: library/unittest.mock.rst:2096 +#: library/unittest.mock.rst:2110 msgid "``__lt__``: :data:`NotImplemented`" msgstr "" -#: library/unittest.mock.rst:2097 +#: library/unittest.mock.rst:2111 msgid "``__gt__``: :data:`!NotImplemented`" msgstr "" -#: library/unittest.mock.rst:2098 +#: library/unittest.mock.rst:2112 msgid "``__le__``: :data:`!NotImplemented`" msgstr "" -#: library/unittest.mock.rst:2099 +#: library/unittest.mock.rst:2113 msgid "``__ge__``: :data:`!NotImplemented`" msgstr "" -#: library/unittest.mock.rst:2100 +#: library/unittest.mock.rst:2114 msgid "``__int__``: ``1``" msgstr "" -#: library/unittest.mock.rst:2101 +#: library/unittest.mock.rst:2115 msgid "``__contains__``: ``False``" msgstr "" -#: library/unittest.mock.rst:2102 +#: library/unittest.mock.rst:2116 msgid "``__len__``: ``0``" msgstr "" -#: library/unittest.mock.rst:2103 +#: library/unittest.mock.rst:2117 msgid "``__iter__``: ``iter([])``" msgstr "" -#: library/unittest.mock.rst:2104 +#: library/unittest.mock.rst:2118 msgid "``__exit__``: ``False``" msgstr "" -#: library/unittest.mock.rst:2105 +#: library/unittest.mock.rst:2119 msgid "``__aexit__``: ``False``" msgstr "" -#: library/unittest.mock.rst:2106 +#: library/unittest.mock.rst:2120 msgid "``__complex__``: ``1j``" msgstr "" -#: library/unittest.mock.rst:2107 +#: library/unittest.mock.rst:2121 msgid "``__float__``: ``1.0``" msgstr "" -#: library/unittest.mock.rst:2108 +#: library/unittest.mock.rst:2122 msgid "``__bool__``: ``True``" msgstr "" -#: library/unittest.mock.rst:2109 +#: library/unittest.mock.rst:2123 msgid "``__index__``: ``1``" msgstr "" -#: library/unittest.mock.rst:2110 +#: library/unittest.mock.rst:2124 msgid "``__hash__``: default hash for the mock" msgstr "" -#: library/unittest.mock.rst:2111 +#: library/unittest.mock.rst:2125 msgid "``__str__``: default str for the mock" msgstr "" -#: library/unittest.mock.rst:2112 +#: library/unittest.mock.rst:2126 msgid "``__sizeof__``: default sizeof for the mock" msgstr "" -#: library/unittest.mock.rst:2114 +#: library/unittest.mock.rst:2128 msgid "For example:" msgstr "" -#: library/unittest.mock.rst:2126 +#: library/unittest.mock.rst:2140 msgid "" "The two equality methods, :meth:`!__eq__` and :meth:`!__ne__`, are special. " "They do the default equality comparison on identity, using the :attr:`~Mock." @@ -1795,102 +1806,102 @@ msgid "" "something else::" msgstr "" -#: library/unittest.mock.rst:2140 +#: library/unittest.mock.rst:2154 msgid "" "The return value of :meth:`MagicMock.__iter__` can be any iterable object " "and isn't required to be an iterator:" msgstr "" -#: library/unittest.mock.rst:2150 +#: library/unittest.mock.rst:2164 msgid "" "If the return value *is* an iterator, then iterating over it once will " "consume it and subsequent iterations will result in an empty list:" msgstr "" -#: library/unittest.mock.rst:2159 +#: library/unittest.mock.rst:2173 msgid "" "``MagicMock`` has all of the supported magic methods configured except for " "some of the obscure and obsolete ones. You can still set these up if you " "want." msgstr "" -#: library/unittest.mock.rst:2162 +#: library/unittest.mock.rst:2176 msgid "" "Magic methods that are supported but not setup by default in ``MagicMock`` " "are:" msgstr "" -#: library/unittest.mock.rst:2164 +#: library/unittest.mock.rst:2178 msgid "``__subclasses__``" msgstr "" -#: library/unittest.mock.rst:2165 +#: library/unittest.mock.rst:2179 msgid "``__dir__``" msgstr "" -#: library/unittest.mock.rst:2166 +#: library/unittest.mock.rst:2180 msgid "``__format__``" msgstr "" -#: library/unittest.mock.rst:2167 +#: library/unittest.mock.rst:2181 msgid "``__get__``, ``__set__`` and ``__delete__``" msgstr "" -#: library/unittest.mock.rst:2168 +#: library/unittest.mock.rst:2182 msgid "``__reversed__`` and ``__missing__``" msgstr "" -#: library/unittest.mock.rst:2169 +#: library/unittest.mock.rst:2183 msgid "" "``__reduce__``, ``__reduce_ex__``, ``__getinitargs__``, ``__getnewargs__``, " "``__getstate__`` and ``__setstate__``" msgstr "" -#: library/unittest.mock.rst:2171 +#: library/unittest.mock.rst:2185 msgid "``__getformat__``" msgstr "" -#: library/unittest.mock.rst:2175 +#: library/unittest.mock.rst:2189 msgid "" "Magic methods *should* be looked up on the class rather than the instance. " "Different versions of Python are inconsistent about applying this rule. The " "supported protocol methods should work with all supported versions of Python." msgstr "" -#: library/unittest.mock.rst:2179 +#: library/unittest.mock.rst:2193 msgid "" "The function is basically hooked up to the class, but each ``Mock`` instance " "is kept isolated from the others." msgstr "" -#: library/unittest.mock.rst:2184 +#: library/unittest.mock.rst:2198 msgid "Helpers" msgstr "" -#: library/unittest.mock.rst:2187 +#: library/unittest.mock.rst:2201 msgid "sentinel" msgstr "" -#: library/unittest.mock.rst:2191 +#: library/unittest.mock.rst:2205 msgid "" "The ``sentinel`` object provides a convenient way of providing unique " "objects for your tests." msgstr "" -#: library/unittest.mock.rst:2194 +#: library/unittest.mock.rst:2208 msgid "" "Attributes are created on demand when you access them by name. Accessing the " "same attribute will always return the same object. The objects returned have " "a sensible repr so that test failure messages are readable." msgstr "" -#: library/unittest.mock.rst:2198 +#: library/unittest.mock.rst:2212 msgid "" "The ``sentinel`` attributes now preserve their identity when they are :mod:" "`copied ` or :mod:`pickled `." msgstr "" -#: library/unittest.mock.rst:2202 +#: library/unittest.mock.rst:2216 msgid "" "Sometimes when testing you need to test that a specific object is passed as " "an argument to another method, or returned. It can be common to create named " @@ -1898,28 +1909,28 @@ msgid "" "creating and testing the identity of objects like this." msgstr "" -#: library/unittest.mock.rst:2207 +#: library/unittest.mock.rst:2221 msgid "" "In this example we monkey patch ``method`` to return ``sentinel." "some_object``:" msgstr "" -#: library/unittest.mock.rst:2219 +#: library/unittest.mock.rst:2233 msgid "DEFAULT" msgstr "" -#: library/unittest.mock.rst:2224 +#: library/unittest.mock.rst:2238 msgid "" "The :data:`DEFAULT` object is a pre-created sentinel (actually ``sentinel." "DEFAULT``). It can be used by :attr:`~Mock.side_effect` functions to " "indicate that the normal return value should be used." msgstr "" -#: library/unittest.mock.rst:2230 +#: library/unittest.mock.rst:2244 msgid "call" msgstr "" -#: library/unittest.mock.rst:2234 +#: library/unittest.mock.rst:2248 msgid "" ":func:`call` is a helper object for making simpler assertions, for comparing " "with :attr:`~Mock.call_args`, :attr:`~Mock.call_args_list`, :attr:`~Mock." @@ -1927,13 +1938,13 @@ msgid "" "with :meth:`~Mock.assert_has_calls`." msgstr "" -#: library/unittest.mock.rst:2247 +#: library/unittest.mock.rst:2261 msgid "" "For a call object that represents multiple calls, :meth:`call_list` returns " "a list of all the intermediate calls as well as the final call." msgstr "" -#: library/unittest.mock.rst:2251 +#: library/unittest.mock.rst:2265 msgid "" "``call_list`` is particularly useful for making assertions on \"chained " "calls\". A chained call is multiple calls on a single line of code. This " @@ -1941,13 +1952,13 @@ msgid "" "constructing the sequence of calls can be tedious." msgstr "" -#: library/unittest.mock.rst:2256 +#: library/unittest.mock.rst:2270 msgid "" ":meth:`~call.call_list` can construct the sequence of calls from the same " "chained call:" msgstr "" -#: library/unittest.mock.rst:2273 +#: library/unittest.mock.rst:2287 msgid "" "A ``call`` object is either a tuple of (positional args, keyword args) or " "(name, positional args, keyword args) depending on how it was constructed. " @@ -1957,7 +1968,7 @@ msgid "" "to get at the individual arguments they contain." msgstr "" -#: library/unittest.mock.rst:2280 +#: library/unittest.mock.rst:2294 msgid "" "The ``call`` objects in :attr:`Mock.call_args` and :attr:`Mock." "call_args_list` are two-tuples of (positional args, keyword args) whereas " @@ -1966,7 +1977,7 @@ msgid "" "args)." msgstr "" -#: library/unittest.mock.rst:2285 +#: library/unittest.mock.rst:2299 msgid "" "You can use their \"tupleness\" to pull out the individual arguments for " "more complex introspection and assertions. The positional arguments are a " @@ -1974,29 +1985,29 @@ msgid "" "arguments are a dictionary:" msgstr "" -#: library/unittest.mock.rst:2318 +#: library/unittest.mock.rst:2332 msgid "create_autospec" msgstr "" -#: library/unittest.mock.rst:2322 +#: library/unittest.mock.rst:2336 msgid "" "Create a mock object using another object as a spec. Attributes on the mock " "will use the corresponding attribute on the *spec* object as their spec." msgstr "" -#: library/unittest.mock.rst:2326 +#: library/unittest.mock.rst:2340 msgid "" "Functions or methods being mocked will have their arguments checked to " "ensure that they are called with the correct signature." msgstr "" -#: library/unittest.mock.rst:2329 +#: library/unittest.mock.rst:2343 msgid "" "If *spec_set* is ``True`` then attempting to set attributes that don't exist " "on the spec object will raise an :exc:`AttributeError`." msgstr "" -#: library/unittest.mock.rst:2332 +#: library/unittest.mock.rst:2346 msgid "" "If a class is used as a spec then the return value of the mock (the instance " "of the class) will have the same spec. You can use a class as the spec for " @@ -2004,29 +2015,29 @@ msgid "" "be callable if instances of the mock are callable." msgstr "" -#: library/unittest.mock.rst:2337 +#: library/unittest.mock.rst:2351 msgid "" ":func:`create_autospec` also takes arbitrary keyword arguments that are " "passed to the constructor of the created mock." msgstr "" -#: library/unittest.mock.rst:2340 +#: library/unittest.mock.rst:2354 msgid "" "See :ref:`auto-speccing` for examples of how to use auto-speccing with :func:" "`create_autospec` and the *autospec* argument to :func:`patch`." msgstr "" -#: library/unittest.mock.rst:2346 +#: library/unittest.mock.rst:2360 msgid "" ":func:`create_autospec` now returns an :class:`AsyncMock` if the target is " "an async function." msgstr "" -#: library/unittest.mock.rst:2351 +#: library/unittest.mock.rst:2365 msgid "ANY" msgstr "" -#: library/unittest.mock.rst:2355 +#: library/unittest.mock.rst:2369 msgid "" "Sometimes you may need to make assertions about *some* of the arguments in a " "call to mock, but either not care about some of the arguments or want to " @@ -2034,30 +2045,30 @@ msgid "" "assertions on them." msgstr "" -#: library/unittest.mock.rst:2360 +#: library/unittest.mock.rst:2374 msgid "" "To ignore certain arguments you can pass in objects that compare equal to " "*everything*. Calls to :meth:`~Mock.assert_called_with` and :meth:`~Mock." "assert_called_once_with` will then succeed no matter what was passed in." msgstr "" -#: library/unittest.mock.rst:2369 +#: library/unittest.mock.rst:2383 msgid "" ":data:`ANY` can also be used in comparisons with call lists like :attr:" "`~Mock.mock_calls`:" msgstr "" -#: library/unittest.mock.rst:2379 +#: library/unittest.mock.rst:2393 msgid "" ":data:`ANY` is not limited to comparisons with call objects and so can also " "be used in test assertions::" msgstr "" -#: library/unittest.mock.rst:2390 +#: library/unittest.mock.rst:2404 msgid "FILTER_DIR" msgstr "" -#: library/unittest.mock.rst:2394 +#: library/unittest.mock.rst:2408 msgid "" ":data:`FILTER_DIR` is a module level variable that controls the way mock " "objects respond to :func:`dir`. The default is ``True``, which uses the " @@ -2066,7 +2077,7 @@ msgid "" "FILTER_DIR = False``." msgstr "" -#: library/unittest.mock.rst:2400 +#: library/unittest.mock.rst:2414 msgid "" "With filtering on, ``dir(some_mock)`` shows only useful attributes and will " "include any dynamically created attributes that wouldn't normally be shown. " @@ -2075,7 +2086,7 @@ msgid "" "yet:" msgstr "" -#: library/unittest.mock.rst:2427 +#: library/unittest.mock.rst:2441 msgid "" "Many of the not-very-useful (private to :class:`Mock` rather than the thing " "being mocked) underscore and double underscore prefixed attributes have been " @@ -2084,31 +2095,31 @@ msgid "" "switch :data:`FILTER_DIR`:" msgstr "" -#: library/unittest.mock.rst:2448 +#: library/unittest.mock.rst:2462 msgid "" "Alternatively you can just use ``vars(my_mock)`` (instance members) and " "``dir(type(my_mock))`` (type members) to bypass the filtering irrespective " "of :const:`mock.FILTER_DIR`." msgstr "" -#: library/unittest.mock.rst:2454 +#: library/unittest.mock.rst:2468 msgid "mock_open" msgstr "" -#: library/unittest.mock.rst:2458 +#: library/unittest.mock.rst:2472 msgid "" "A helper function to create a mock to replace the use of :func:`open`. It " "works for :func:`open` called directly or used as a context manager." msgstr "" -#: library/unittest.mock.rst:2461 +#: library/unittest.mock.rst:2475 msgid "" "The *mock* argument is the mock object to configure. If ``None`` (the " "default) then a :class:`MagicMock` will be created for you, with the API " "limited to methods or attributes available on standard file handles." msgstr "" -#: library/unittest.mock.rst:2465 +#: library/unittest.mock.rst:2479 msgid "" "*read_data* is a string for the :meth:`~io.IOBase.read`, :meth:`~io.IOBase." "readline`, and :meth:`~io.IOBase.readlines` methods of the file handle to " @@ -2121,51 +2132,51 @@ msgid "" "realistic filesystem for testing." msgstr "" -#: library/unittest.mock.rst:2475 +#: library/unittest.mock.rst:2489 msgid "" "Added :meth:`~io.IOBase.readline` and :meth:`~io.IOBase.readlines` support. " "The mock of :meth:`~io.IOBase.read` changed to consume *read_data* rather " "than returning it on each call." msgstr "" -#: library/unittest.mock.rst:2480 +#: library/unittest.mock.rst:2494 msgid "*read_data* is now reset on each call to the *mock*." msgstr "" -#: library/unittest.mock.rst:2483 +#: library/unittest.mock.rst:2497 msgid "" "Added :meth:`~container.__iter__` to implementation so that iteration (such " "as in for loops) correctly consumes *read_data*." msgstr "" -#: library/unittest.mock.rst:2487 +#: library/unittest.mock.rst:2501 msgid "" "Using :func:`open` as a context manager is a great way to ensure your file " "handles are closed properly and is becoming common::" msgstr "" -#: library/unittest.mock.rst:2493 +#: library/unittest.mock.rst:2507 msgid "" "The issue is that even if you mock out the call to :func:`open` it is the " "*returned object* that is used as a context manager (and has :meth:`~object." "__enter__` and :meth:`~object.__exit__` called)." msgstr "" -#: library/unittest.mock.rst:2497 +#: library/unittest.mock.rst:2511 msgid "" "Mocking context managers with a :class:`MagicMock` is common enough and " "fiddly enough that a helper function is useful. ::" msgstr "" -#: library/unittest.mock.rst:2514 +#: library/unittest.mock.rst:2528 msgid "And for reading files::" msgstr "" -#: library/unittest.mock.rst:2527 +#: library/unittest.mock.rst:2541 msgid "Autospeccing" msgstr "" -#: library/unittest.mock.rst:2529 +#: library/unittest.mock.rst:2543 msgid "" "Autospeccing is based on the existing :attr:`spec` feature of mock. It " "limits the api of mocks to the api of an original object (the spec), but it " @@ -2175,11 +2186,11 @@ msgid "" "`TypeError` if they are called incorrectly." msgstr "" -#: library/unittest.mock.rst:2536 +#: library/unittest.mock.rst:2550 msgid "Before I explain how auto-speccing works, here's why it is needed." msgstr "" -#: library/unittest.mock.rst:2538 +#: library/unittest.mock.rst:2552 msgid "" ":class:`Mock` is a very powerful and flexible object, but it suffers from a " "flaw which is general to mocking. If you refactor some of your code, rename " @@ -2188,14 +2199,14 @@ msgid "" "tests can all pass even though your code is broken." msgstr "" -#: library/unittest.mock.rst:2546 +#: library/unittest.mock.rst:2560 msgid "" "Before 3.5, tests with a typo in the word assert would silently pass when " "they should raise an error. You can still achieve this behavior by passing " "``unsafe=True`` to Mock." msgstr "" -#: library/unittest.mock.rst:2549 +#: library/unittest.mock.rst:2563 msgid "" "Note that this is another reason why you need integration tests as well as " "unit tests. Testing everything in isolation is all fine and dandy, but if " @@ -2203,20 +2214,20 @@ msgid "" "room for bugs that tests might have caught." msgstr "" -#: library/unittest.mock.rst:2554 +#: library/unittest.mock.rst:2568 msgid "" ":mod:`mock` already provides a feature to help with this, called speccing. " "If you use a class or instance as the :attr:`spec` for a mock then you can " "only access attributes on the mock that exist on the real class:" msgstr "" -#: library/unittest.mock.rst:2565 +#: library/unittest.mock.rst:2579 msgid "" "The spec only applies to the mock itself, so we still have the same issue " "with any methods on the mock:" msgstr "" -#: library/unittest.mock.rst:2574 +#: library/unittest.mock.rst:2588 msgid "" "Auto-speccing solves this problem. You can either pass ``autospec=True`` to :" "func:`patch` / :func:`patch.object` or use the :func:`create_autospec` " @@ -2228,24 +2239,24 @@ msgid "" "import modules) without a big performance hit." msgstr "" -#: library/unittest.mock.rst:2583 +#: library/unittest.mock.rst:2597 msgid "Here's an example of it in use::" msgstr "" -#: library/unittest.mock.rst:2593 +#: library/unittest.mock.rst:2607 msgid "" "You can see that :class:`request.Request` has a spec. :class:`request." "Request` takes two arguments in the constructor (one of which is *self*). " "Here's what happens if we try to call it incorrectly::" msgstr "" -#: library/unittest.mock.rst:2602 +#: library/unittest.mock.rst:2616 msgid "" "The spec also applies to instantiated classes (i.e. the return value of " "specced mocks)::" msgstr "" -#: library/unittest.mock.rst:2609 +#: library/unittest.mock.rst:2623 msgid "" ":class:`Request` objects are not callable, so the return value of " "instantiating our mocked out :class:`request.Request` is a non-callable " @@ -2253,20 +2264,20 @@ msgid "" "error::" msgstr "" -#: library/unittest.mock.rst:2621 +#: library/unittest.mock.rst:2635 msgid "" "In many cases you will just be able to add ``autospec=True`` to your " "existing :func:`patch` calls and then be protected against bugs due to typos " "and api changes." msgstr "" -#: library/unittest.mock.rst:2625 +#: library/unittest.mock.rst:2639 msgid "" "As well as using *autospec* through :func:`patch` there is a :func:" "`create_autospec` for creating autospecced mocks directly:" msgstr "" -#: library/unittest.mock.rst:2633 +#: library/unittest.mock.rst:2647 msgid "" "This isn't without caveats and limitations however, which is why it is not " "the default behaviour. In order to know what attributes are available on the " @@ -2278,7 +2289,7 @@ msgid "" "objects so that introspection is safe [#]_." msgstr "" -#: library/unittest.mock.rst:2642 +#: library/unittest.mock.rst:2656 msgid "" "A more serious problem is that it is common for instance attributes to be " "created in the :meth:`~object.__init__` method and not to exist on the class " @@ -2286,7 +2297,7 @@ msgid "" "restricts the api to visible attributes. ::" msgstr "" -#: library/unittest.mock.rst:2659 +#: library/unittest.mock.rst:2673 msgid "" "There are a few different ways of resolving this problem. The easiest, but " "not necessarily the least annoying, way is to simply set the required " @@ -2295,7 +2306,7 @@ msgid "" "setting them::" msgstr "" -#: library/unittest.mock.rst:2670 +#: library/unittest.mock.rst:2684 msgid "" "There is a more aggressive version of both *spec* and *autospec* that *does* " "prevent you setting non-existent attributes. This is useful if you want to " @@ -2303,7 +2314,7 @@ msgid "" "this particular scenario:" msgstr "" -#: library/unittest.mock.rst:2683 +#: library/unittest.mock.rst:2697 msgid "" "Probably the best way of solving the problem is to add class attributes as " "default values for instance members initialised in :meth:`~object.__init__`. " @@ -2312,7 +2323,7 @@ msgid "" "course) is faster too. e.g." msgstr "" -#: library/unittest.mock.rst:2694 +#: library/unittest.mock.rst:2708 msgid "" "This brings up another issue. It is relatively common to provide a default " "value of ``None`` for members that will later be an object of a different " @@ -2323,7 +2334,7 @@ msgid "" "These will just be ordinary mocks (well - MagicMocks):" msgstr "" -#: library/unittest.mock.rst:2709 +#: library/unittest.mock.rst:2723 msgid "" "If modifying your production classes to add defaults isn't to your liking " "then there are more options. One of these is simply to use an instance as " @@ -2334,53 +2345,53 @@ msgid "" "alternative object as the *autospec* argument::" msgstr "" -#: library/unittest.mock.rst:2730 +#: library/unittest.mock.rst:2744 msgid "" "This only applies to classes or already instantiated objects. Calling a " "mocked class to create a mock instance *does not* create a real instance. It " "is only attribute lookups - along with calls to :func:`dir` - that are done." msgstr "" -#: library/unittest.mock.rst:2735 +#: library/unittest.mock.rst:2749 msgid "Sealing mocks" msgstr "" -#: library/unittest.mock.rst:2744 +#: library/unittest.mock.rst:2758 msgid "" "Seal will disable the automatic creation of mocks when accessing an " "attribute of the mock being sealed or any of its attributes that are already " "mocks recursively." msgstr "" -#: library/unittest.mock.rst:2747 +#: library/unittest.mock.rst:2761 msgid "" "If a mock instance with a name or a spec is assigned to an attribute it " "won't be considered in the sealing chain. This allows one to prevent seal " "from fixing part of the mock object. ::" msgstr "" -#: library/unittest.mock.rst:2763 +#: library/unittest.mock.rst:2777 msgid "" "Order of precedence of :attr:`side_effect`, :attr:`return_value` and *wraps*" msgstr "" -#: library/unittest.mock.rst:2765 +#: library/unittest.mock.rst:2779 msgid "The order of their precedence is:" msgstr "" -#: library/unittest.mock.rst:2767 +#: library/unittest.mock.rst:2781 msgid ":attr:`~Mock.side_effect`" msgstr "" -#: library/unittest.mock.rst:2768 +#: library/unittest.mock.rst:2782 msgid ":attr:`~Mock.return_value`" msgstr "" -#: library/unittest.mock.rst:2769 +#: library/unittest.mock.rst:2783 msgid "*wraps*" msgstr "" -#: library/unittest.mock.rst:2771 +#: library/unittest.mock.rst:2785 msgid "" "If all three are set, mock will return the value from :attr:`~Mock." "side_effect`, ignoring :attr:`~Mock.return_value` and the wrapped object " @@ -2389,7 +2400,7 @@ msgid "" "of precedence remains unchanged." msgstr "" -#: library/unittest.mock.rst:2789 +#: library/unittest.mock.rst:2803 msgid "" "As ``None`` is the default value of :attr:`~Mock.side_effect`, if you " "reassign its value back to ``None``, the order of precedence will be checked " @@ -2397,46 +2408,46 @@ msgid "" "`~Mock.side_effect`." msgstr "" -#: library/unittest.mock.rst:2798 +#: library/unittest.mock.rst:2812 msgid "" "If the value being returned by :attr:`~Mock.side_effect` is :data:`DEFAULT`, " "it is ignored and the order of precedence moves to the successor to obtain " "the value to return." msgstr "" -#: library/unittest.mock.rst:2807 +#: library/unittest.mock.rst:2821 msgid "" "When :class:`Mock` wraps an object, the default value of :attr:`~Mock." "return_value` will be :data:`DEFAULT`." msgstr "" -#: library/unittest.mock.rst:2816 +#: library/unittest.mock.rst:2830 msgid "" "The order of precedence will ignore this value and it will move to the last " "successor which is the wrapped object." msgstr "" -#: library/unittest.mock.rst:2819 +#: library/unittest.mock.rst:2833 msgid "" "As the real call is being made to the wrapped object, creating an instance " "of this mock will return the real instance of the class. The positional " "arguments, if any, required by the wrapped object must be passed." msgstr "" -#: library/unittest.mock.rst:2837 +#: library/unittest.mock.rst:2851 msgid "" "But if you assign ``None`` to it, this will not be ignored as it is an " "explicit assignment. So, the order of precedence will not move to the " "wrapped object." msgstr "" -#: library/unittest.mock.rst:2845 +#: library/unittest.mock.rst:2859 msgid "" "Even if you set all three at once when initializing the mock, the order of " "precedence remains the same:" msgstr "" -#: library/unittest.mock.rst:2862 +#: library/unittest.mock.rst:2876 msgid "" "If :attr:`~Mock.side_effect` is exhausted, the order of precedence will not " "cause a value to be obtained from the successors. Instead, ``StopIteration`` " diff --git a/library/unittest.po b/library/unittest.po index 30c2fc423..7f23f0e36 100644 --- a/library/unittest.po +++ b/library/unittest.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2648,8 +2648,8 @@ msgstr "" #: library/unittest.rst:2311 msgid "" -"Calling ``main`` actually returns an instance of the ``TestProgram`` class. " -"This stores the result of the tests run as the ``result`` attribute." +"Calling ``main`` returns an object with the ``result`` attribute that " +"contains the result of the tests run as a :class:`unittest.TestResult`." msgstr "" #: library/unittest.rst:2314 diff --git a/library/urllib.parse.po b/library/urllib.parse.po index 7c4c65876..1b30f0ccc 100644 --- a/library/urllib.parse.po +++ b/library/urllib.parse.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -283,7 +283,7 @@ msgstr "" #: library/urllib.parse.rst:175 msgid "" -"The fragment is now parsed for all URL schemes (unless *allow_fragment* is " +"The fragment is now parsed for all URL schemes (unless *allow_fragments* is " "false), in accordance with :rfc:`3986`. Previously, an allowlist of schemes " "that support fragments existed." msgstr "" diff --git a/library/urllib.request.po b/library/urllib.request.po index 28bfcc117..2eb9bd397 100644 --- a/library/urllib.request.po +++ b/library/urllib.request.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -159,10 +159,10 @@ msgid "" "`ProxyHandler` objects." msgstr "" -#: library/urllib.request.rst:110 +#: library/urllib.request.rst:99 msgid "" -"Raises an :ref:`auditing event ` ``urllib.Request`` with arguments " -"``fullurl``, ``data``, ``headers``, ``method``." +"The default opener raises an auditing event urllib.Request with arguments " +"fullurl, data, headers, method taken from the request object." msgstr "" #: library/urllib.request.rst:101 @@ -1255,7 +1255,7 @@ msgstr "" #: library/urllib.request.rst:1104 msgid "" "This method is applicable only for local hostnames. When a remote hostname " -"is given, an :exc:`~urllib.error.URLError` is raised." +"is given, a :exc:`~urllib.error.URLError` is raised." msgstr "" #: library/urllib.request.rst:1112 @@ -1269,7 +1269,7 @@ msgid "" "ignores white spaces in base64 encoded data URLs so the URL may be wrapped " "in whatever source file it comes from. But even though some browsers don't " "mind about a missing padding at the end of a base64 encoded data URL, this " -"implementation will raise an :exc:`ValueError` in that case." +"implementation will raise a :exc:`ValueError` in that case." msgstr "" #: library/urllib.request.rst:1127 diff --git a/library/uu.po b/library/uu.po index 436409ffa..2abc07140 100644 --- a/library/uu.po +++ b/library/uu.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/uu.py`" msgstr "" -#: library/uu.rst:16 +#: library/uu.rst:12 msgid "" "The :mod:`uu` module is deprecated (see :pep:`PEP 594 <594#uu-and-the-uu-" "encoding>` for details). :mod:`base64` is a modern alternative." diff --git a/library/webbrowser.po b/library/webbrowser.po index bcb155e6a..4c2290f10 100644 --- a/library/webbrowser.po +++ b/library/webbrowser.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -107,10 +107,8 @@ msgid "" "is neither supported nor portable." msgstr "" -#: library/webbrowser.rst:80 -msgid "" -"Raises an :ref:`auditing event ` ``webbrowser.open`` with argument " -"``url``." +#: library/webbrowser.rst:69 +msgid "Raises an auditing event webbrowser.open with argument url." msgstr "" #: library/webbrowser.rst:74 @@ -350,7 +348,7 @@ msgid "" "versions 35 and below." msgstr "" -#: library/webbrowser.rst:176 +#: library/webbrowser.rst:174 msgid ":class:`MacOSX` is deprecated, use :class:`MacOSXOSAScript` instead." msgstr "" diff --git a/library/winreg.po b/library/winreg.po index bb494305c..ed4b8a4b9 100644 --- a/library/winreg.po +++ b/library/winreg.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -78,8 +78,8 @@ msgstr "" #: library/winreg.rst:56 msgid "" -"Raises an :ref:`auditing event ` ``winreg.ConnectRegistry`` with " -"arguments ``computer_name``, ``key``." +"Raises an auditing event winreg.ConnectRegistry with arguments " +"computer_name, key." msgstr "" #: library/winreg.rst:84 library/winreg.rst:139 library/winreg.rst:203 @@ -117,14 +117,12 @@ msgstr "" #: library/winreg.rst:112 msgid "" -"Raises an :ref:`auditing event ` ``winreg.CreateKey`` with " -"arguments ``key``, ``sub_key``, ``access``." +"Raises an auditing event winreg.CreateKey with arguments key, sub_key, " +"access." msgstr "" #: library/winreg.rst:114 library/winreg.rst:324 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.OpenKey/result`` with " -"argument ``key``." +msgid "Raises an auditing event winreg.OpenKey/result with argument key." msgstr "" #: library/winreg.rst:154 @@ -162,8 +160,8 @@ msgstr "" #: library/winreg.rst:168 msgid "" -"Raises an :ref:`auditing event ` ``winreg.DeleteKey`` with " -"arguments ``key``, ``sub_key``, ``access``." +"Raises an auditing event winreg.DeleteKey with arguments key, sub_key, " +"access." msgstr "" #: library/winreg.rst:150 @@ -194,9 +192,7 @@ msgid "*value* is a string that identifies the value to remove." msgstr "" #: library/winreg.rst:185 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.DeleteValue`` with " -"arguments ``key``, ``value``." +msgid "Raises an auditing event winreg.DeleteValue with arguments key, value." msgstr "" #: library/winreg.rst:190 @@ -215,9 +211,7 @@ msgid "" msgstr "" #: library/winreg.rst:201 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.EnumKey`` with arguments " -"``key``, ``index``." +msgid "Raises an auditing event winreg.EnumKey with arguments key, index." msgstr "" #: library/winreg.rst:209 @@ -277,9 +271,7 @@ msgid "" msgstr "" #: library/winreg.rst:236 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.EnumValue`` with " -"arguments ``key``, ``index``." +msgid "Raises an auditing event winreg.EnumValue with arguments key, index." msgstr "" #: library/winreg.rst:247 @@ -290,8 +282,7 @@ msgstr "" #: library/winreg.rst:253 msgid "" -"Raises an :ref:`auditing event ` ``winreg." -"ExpandEnvironmentStrings`` with argument ``str``." +"Raises an auditing event winreg.ExpandEnvironmentStrings with argument str." msgstr "" #: library/winreg.rst:258 @@ -354,8 +345,8 @@ msgstr "" #: library/winreg.rst:299 msgid "" -"Raises an :ref:`auditing event ` ``winreg.LoadKey`` with arguments " -"``key``, ``sub_key``, ``file_name``." +"Raises an auditing event winreg.LoadKey with arguments key, sub_key, " +"file_name." msgstr "" #: library/winreg.rst:305 @@ -389,8 +380,7 @@ msgstr "" #: library/winreg.rst:322 msgid "" -"Raises an :ref:`auditing event ` ``winreg.OpenKey`` with arguments " -"``key``, ``sub_key``, ``access``." +"Raises an auditing event winreg.OpenKey with arguments key, sub_key, access." msgstr "" #: library/winreg.rst:326 @@ -416,9 +406,7 @@ msgid "" msgstr "" #: library/winreg.rst:356 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.QueryInfoKey`` with " -"argument ``key``." +msgid "Raises an auditing event winreg.QueryInfoKey with argument key." msgstr "" #: library/winreg.rst:361 @@ -443,8 +431,8 @@ msgstr "" #: library/winreg.rst:400 msgid "" -"Raises an :ref:`auditing event ` ``winreg.QueryValue`` with " -"arguments ``key``, ``sub_key``, ``value_name``." +"Raises an auditing event winreg.QueryValue with arguments key, sub_key, " +"value_name." msgstr "" #: library/winreg.rst:380 @@ -498,9 +486,7 @@ msgid "This function passes ``NULL`` for *security_attributes* to the API." msgstr "" #: library/winreg.rst:425 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.SaveKey`` with arguments " -"``key``, ``file_name``." +msgid "Raises an auditing event winreg.SaveKey with arguments key, file_name." msgstr "" #: library/winreg.rst:430 @@ -545,8 +531,8 @@ msgstr "" #: library/winreg.rst:483 msgid "" -"Raises an :ref:`auditing event ` ``winreg.SetValue`` with " -"arguments ``key``, ``sub_key``, ``type``, ``value``." +"Raises an auditing event winreg.SetValue with arguments key, sub_key, type, " +"value." msgstr "" #: library/winreg.rst:458 @@ -600,9 +586,7 @@ msgid "" msgstr "" #: library/winreg.rst:501 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.DisableReflectionKey`` " -"with argument ``key``." +msgid "Raises an auditing event winreg.DisableReflectionKey with argument key." msgstr "" #: library/winreg.rst:506 @@ -615,9 +599,7 @@ msgid "" msgstr "" #: library/winreg.rst:516 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.EnableReflectionKey`` " -"with argument ``key``." +msgid "Raises an auditing event winreg.EnableReflectionKey with argument key." msgstr "" #: library/winreg.rst:521 @@ -629,9 +611,7 @@ msgid "Returns ``True`` if reflection is disabled." msgstr "" #: library/winreg.rst:531 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.QueryReflectionKey`` " -"with argument ``key``." +msgid "Raises an auditing event winreg.QueryReflectionKey with argument key." msgstr "" #: library/winreg.rst:537 @@ -921,9 +901,7 @@ msgid "" msgstr "" #: library/winreg.rst:784 -msgid "" -"Raises an :ref:`auditing event ` ``winreg.PyHKEY.Detach`` with " -"argument ``key``." +msgid "Raises an auditing event winreg.PyHKEY.Detach with argument key." msgstr "" #: library/winreg.rst:790 diff --git a/library/xdrlib.po b/library/xdrlib.po index 007d42920..88af951e0 100644 --- a/library/xdrlib.po +++ b/library/xdrlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,7 +24,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/xdrlib.py`" msgstr "" -#: library/xdrlib.rst:17 +#: library/xdrlib.rst:14 msgid "" "The :mod:`xdrlib` module is deprecated (see :pep:`PEP 594 <594#xdrlib>` for " "details)." diff --git a/library/xml.etree.elementtree.po b/library/xml.etree.elementtree.po index e83ea6b6f..765d8ff26 100644 --- a/library/xml.etree.elementtree.po +++ b/library/xml.etree.elementtree.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -494,7 +494,7 @@ msgstr "" #: library/xml.etree.elementtree.rst:510 msgid "" "Canonicalization is a way to normalise XML output in a way that allows byte-" -"by-byte comparisons and digital signatures. It reduced the freedom that XML " +"by-byte comparisons and digital signatures. It reduces the freedom that XML " "serializers have and instead generates a more constrained XML " "representation. The main restrictions regard the placement of namespace " "declarations, the ordering of attributes, and ignorable whitespace." @@ -668,7 +668,7 @@ msgid "" "present." msgstr "" -#: library/xml.etree.elementtree.rst:647 library/xml.etree.elementtree.rst:1515 +#: library/xml.etree.elementtree.rst:647 library/xml.etree.elementtree.rst:1516 msgid "If you need a fully populated element, look for \"end\" events instead." msgstr "" @@ -676,7 +676,7 @@ msgstr "" msgid "The *parser* argument." msgstr "" -#: library/xml.etree.elementtree.rst:652 library/xml.etree.elementtree.rst:1519 +#: library/xml.etree.elementtree.rst:652 library/xml.etree.elementtree.rst:1520 msgid "The ``comment`` and ``pi`` events were added." msgstr "" @@ -741,7 +741,7 @@ msgid "" msgstr "" #: library/xml.etree.elementtree.rst:713 library/xml.etree.elementtree.rst:740 -#: library/xml.etree.elementtree.rst:1192 +#: library/xml.etree.elementtree.rst:1193 msgid "Added the *short_empty_elements* parameter." msgstr "" @@ -880,13 +880,13 @@ msgstr "" msgid "Element Objects" msgstr "" -#: library/xml.etree.elementtree.rst:875 +#: library/xml.etree.elementtree.rst:876 msgid "" "Element class. This class defines the Element interface, and provides a " "reference implementation of this interface." msgstr "" -#: library/xml.etree.elementtree.rst:878 +#: library/xml.etree.elementtree.rst:879 msgid "" "The element name, attribute names, and attribute values can be either " "bytestrings or Unicode strings. *tag* is the element name. *attrib* is an " @@ -894,13 +894,13 @@ msgid "" "additional attributes, given as keyword arguments." msgstr "" -#: library/xml.etree.elementtree.rst:886 +#: library/xml.etree.elementtree.rst:887 msgid "" "A string identifying what kind of data this element represents (the element " "type, in other words)." msgstr "" -#: library/xml.etree.elementtree.rst:893 +#: library/xml.etree.elementtree.rst:894 msgid "" "These attributes can be used to hold additional data associated with the " "element. Their values are usually strings but may be any application-" @@ -911,7 +911,7 @@ msgid "" "the XML data" msgstr "" -#: library/xml.etree.elementtree.rst:905 +#: library/xml.etree.elementtree.rst:906 msgid "" "the *a* element has ``None`` for both *text* and *tail* attributes, the *b* " "element has *text* ``\"1\"`` and *tail* ``\"4\"``, the *c* element has " @@ -919,17 +919,17 @@ msgid "" "``None`` and *tail* ``\"3\"``." msgstr "" -#: library/xml.etree.elementtree.rst:910 +#: library/xml.etree.elementtree.rst:911 msgid "" "To collect the inner text of an element, see :meth:`itertext`, for example " "``\"\".join(element.itertext())``." msgstr "" -#: library/xml.etree.elementtree.rst:913 +#: library/xml.etree.elementtree.rst:914 msgid "Applications may store arbitrary objects in these attributes." msgstr "" -#: library/xml.etree.elementtree.rst:918 +#: library/xml.etree.elementtree.rst:919 msgid "" "A dictionary containing the element's attributes. Note that while the " "*attrib* value is always a real mutable Python dictionary, an ElementTree " @@ -938,59 +938,59 @@ msgid "" "implementations, use the dictionary methods below whenever possible." msgstr "" -#: library/xml.etree.elementtree.rst:924 +#: library/xml.etree.elementtree.rst:925 msgid "The following dictionary-like methods work on the element attributes." msgstr "" -#: library/xml.etree.elementtree.rst:929 +#: library/xml.etree.elementtree.rst:930 msgid "" "Resets an element. This function removes all subelements, clears all " "attributes, and sets the text and tail attributes to ``None``." msgstr "" -#: library/xml.etree.elementtree.rst:935 +#: library/xml.etree.elementtree.rst:936 msgid "Gets the element attribute named *key*." msgstr "" -#: library/xml.etree.elementtree.rst:937 +#: library/xml.etree.elementtree.rst:938 msgid "" "Returns the attribute value, or *default* if the attribute was not found." msgstr "" -#: library/xml.etree.elementtree.rst:942 +#: library/xml.etree.elementtree.rst:943 msgid "" "Returns the element attributes as a sequence of (name, value) pairs. The " "attributes are returned in an arbitrary order." msgstr "" -#: library/xml.etree.elementtree.rst:948 +#: library/xml.etree.elementtree.rst:949 msgid "" "Returns the elements attribute names as a list. The names are returned in " "an arbitrary order." msgstr "" -#: library/xml.etree.elementtree.rst:954 +#: library/xml.etree.elementtree.rst:955 msgid "Set the attribute *key* on the element to *value*." msgstr "" -#: library/xml.etree.elementtree.rst:956 +#: library/xml.etree.elementtree.rst:957 msgid "The following methods work on the element's children (subelements)." msgstr "" -#: library/xml.etree.elementtree.rst:961 +#: library/xml.etree.elementtree.rst:962 msgid "" "Adds the element *subelement* to the end of this element's internal list of " "subelements. Raises :exc:`TypeError` if *subelement* is not an :class:" "`Element`." msgstr "" -#: library/xml.etree.elementtree.rst:968 +#: library/xml.etree.elementtree.rst:969 msgid "" "Appends *subelements* from a sequence object with zero or more elements. " "Raises :exc:`TypeError` if a subelement is not an :class:`Element`." msgstr "" -#: library/xml.etree.elementtree.rst:976 +#: library/xml.etree.elementtree.rst:977 msgid "" "Finds the first subelement matching *match*. *match* may be a tag name or " "a :ref:`path `. Returns an element instance or " @@ -999,7 +999,7 @@ msgid "" "expression into the given namespace." msgstr "" -#: library/xml.etree.elementtree.rst:985 +#: library/xml.etree.elementtree.rst:986 msgid "" "Finds all matching subelements, by tag name or :ref:`path `. Returns a list containing all matching elements in document " @@ -1008,7 +1008,7 @@ msgid "" "expression into the given namespace." msgstr "" -#: library/xml.etree.elementtree.rst:994 +#: library/xml.etree.elementtree.rst:995 msgid "" "Finds text for the first subelement matching *match*. *match* may be a tag " "name or a :ref:`path `. Returns the text content of the " @@ -1019,13 +1019,13 @@ msgid "" "into the given namespace." msgstr "" -#: library/xml.etree.elementtree.rst:1005 +#: library/xml.etree.elementtree.rst:1006 msgid "" "Inserts *subelement* at the given position in this element. Raises :exc:" "`TypeError` if *subelement* is not an :class:`Element`." msgstr "" -#: library/xml.etree.elementtree.rst:1011 +#: library/xml.etree.elementtree.rst:1012 msgid "" "Creates a tree :term:`iterator` with the current element as the root. The " "iterator iterates over this element and all elements below it, in document " @@ -1034,7 +1034,7 @@ msgid "" "structure is modified during iteration, the result is undefined." msgstr "" -#: library/xml.etree.elementtree.rst:1022 +#: library/xml.etree.elementtree.rst:1023 msgid "" "Finds all matching subelements, by tag name or :ref:`path `. Returns an iterable yielding all matching elements in document " @@ -1042,44 +1042,44 @@ msgid "" "name." msgstr "" -#: library/xml.etree.elementtree.rst:1033 +#: library/xml.etree.elementtree.rst:1034 msgid "" "Creates a text iterator. The iterator loops over this element and all " "subelements, in document order, and returns all inner text." msgstr "" -#: library/xml.etree.elementtree.rst:1041 +#: library/xml.etree.elementtree.rst:1042 msgid "" "Creates a new element object of the same type as this element. Do not call " "this method, use the :func:`SubElement` factory function instead." msgstr "" -#: library/xml.etree.elementtree.rst:1047 +#: library/xml.etree.elementtree.rst:1048 msgid "" "Removes *subelement* from the element. Unlike the find\\* methods this " "method compares elements based on the instance identity, not on tag value or " "contents." msgstr "" -#: library/xml.etree.elementtree.rst:1051 +#: library/xml.etree.elementtree.rst:1052 msgid "" ":class:`Element` objects also support the following sequence type methods " "for working with subelements: :meth:`~object.__delitem__`, :meth:`~object." "__getitem__`, :meth:`~object.__setitem__`, :meth:`~object.__len__`." msgstr "" -#: library/xml.etree.elementtree.rst:1056 +#: library/xml.etree.elementtree.rst:1057 msgid "" "Caution: Elements with no subelements will test as ``False``. Testing the " "truth value of an Element is deprecated and will raise an exception in " "Python 3.14. Use specific ``len(elem)`` or ``elem is None`` test instead.::" msgstr "" -#: library/xml.etree.elementtree.rst:1068 +#: library/xml.etree.elementtree.rst:1069 msgid "Testing the truth value of an Element emits :exc:`DeprecationWarning`." msgstr "" -#: library/xml.etree.elementtree.rst:1071 +#: library/xml.etree.elementtree.rst:1072 msgid "" "Prior to Python 3.8, the serialisation order of the XML attributes of " "elements was artificially made predictable by sorting the attributes by " @@ -1088,7 +1088,7 @@ msgid "" "attributes were originally parsed or created by user code." msgstr "" -#: library/xml.etree.elementtree.rst:1077 +#: library/xml.etree.elementtree.rst:1078 msgid "" "In general, user code should try not to depend on a specific ordering of " "attributes, given that the `XML Information Set `_ writer. Arguments are the " "same as for the :func:`canonicalize` function. This class does not build a " @@ -1324,11 +1324,11 @@ msgid "" "using the *write* function." msgstr "" -#: library/xml.etree.elementtree.rst:1356 +#: library/xml.etree.elementtree.rst:1357 msgid "XMLParser Objects" msgstr "" -#: library/xml.etree.elementtree.rst:1361 +#: library/xml.etree.elementtree.rst:1362 msgid "" "This class is the low-level building block of the module. It uses :mod:`xml." "parsers.expat` for efficient, event-based parsing of XML. It can be fed XML " @@ -1339,25 +1339,25 @@ msgid "" "XML file." msgstr "" -#: library/xml.etree.elementtree.rst:1369 +#: library/xml.etree.elementtree.rst:1370 msgid "" "Parameters are now :ref:`keyword-only `. The *html* " "argument no longer supported." msgstr "" -#: library/xml.etree.elementtree.rst:1376 +#: library/xml.etree.elementtree.rst:1377 msgid "" "Finishes feeding data to the parser. Returns the result of calling the " "``close()`` method of the *target* passed during construction; by default, " "this is the toplevel document element." msgstr "" -#: library/xml.etree.elementtree.rst:1383 +#: library/xml.etree.elementtree.rst:1384 msgid "Feeds data to the parser. *data* is encoded data." msgstr "" -#: library/xml.etree.elementtree.rst:1388 -#: library/xml.etree.elementtree.rst:1466 +#: library/xml.etree.elementtree.rst:1389 +#: library/xml.etree.elementtree.rst:1467 msgid "" "Triggers parsing of any previously fed unparsed data, which can be used to " "ensure more immediate feedback, in particular with Expat >=2.6.0. The " @@ -1367,15 +1367,15 @@ msgid "" "xmlparser.SetReparseDeferralEnabled` for details." msgstr "" -#: library/xml.etree.elementtree.rst:1395 -#: library/xml.etree.elementtree.rst:1473 +#: library/xml.etree.elementtree.rst:1396 +#: library/xml.etree.elementtree.rst:1474 msgid "" "Note that :meth:`flush` has been backported to some prior releases of " "CPython as a security fix. Check for availability of :meth:`flush` using :" "func:`hasattr` if used in code running across a variety of Python versions." msgstr "" -#: library/xml.etree.elementtree.rst:1403 +#: library/xml.etree.elementtree.rst:1404 msgid "" ":meth:`XMLParser.feed` calls *target*\\'s ``start(tag, attrs_dict)`` method " "for each opening tag, its ``end(tag)`` method for each closing tag, and data " @@ -1386,11 +1386,11 @@ msgid "" "of an XML file::" msgstr "" -#: library/xml.etree.elementtree.rst:1447 +#: library/xml.etree.elementtree.rst:1448 msgid "XMLPullParser Objects" msgstr "" -#: library/xml.etree.elementtree.rst:1451 +#: library/xml.etree.elementtree.rst:1452 msgid "" "A pull parser suitable for non-blocking applications. Its input-side API is " "similar to that of :class:`XMLParser`, but instead of pushing calls to a " @@ -1402,11 +1402,11 @@ msgid "" "If *events* is omitted, only ``\"end\"`` events are reported." msgstr "" -#: library/xml.etree.elementtree.rst:1462 +#: library/xml.etree.elementtree.rst:1463 msgid "Feed the given bytes data to the parser." msgstr "" -#: library/xml.etree.elementtree.rst:1482 +#: library/xml.etree.elementtree.rst:1483 msgid "" "Signal the parser that the data stream is terminated. Unlike :meth:" "`XMLParser.close`, this method always returns :const:`None`. Any events not " @@ -1414,7 +1414,7 @@ msgid "" "`read_events`." msgstr "" -#: library/xml.etree.elementtree.rst:1489 +#: library/xml.etree.elementtree.rst:1490 msgid "" "Return an iterator over the events which have been encountered in the data " "fed to the parser. The iterator yields ``(event, elem)`` pairs, where " @@ -1423,25 +1423,25 @@ msgid "" "follows." msgstr "" -#: library/xml.etree.elementtree.rst:1495 +#: library/xml.etree.elementtree.rst:1496 msgid "``start``, ``end``: the current Element." msgstr "" -#: library/xml.etree.elementtree.rst:1496 +#: library/xml.etree.elementtree.rst:1497 msgid "``comment``, ``pi``: the current comment / processing instruction" msgstr "" -#: library/xml.etree.elementtree.rst:1497 +#: library/xml.etree.elementtree.rst:1498 msgid "" "``start-ns``: a tuple ``(prefix, uri)`` naming the declared namespace " "mapping." msgstr "" -#: library/xml.etree.elementtree.rst:1499 +#: library/xml.etree.elementtree.rst:1500 msgid "``end-ns``: :const:`None` (this may change in a future version)" msgstr "" -#: library/xml.etree.elementtree.rst:1501 +#: library/xml.etree.elementtree.rst:1502 msgid "" "Events provided in a previous call to :meth:`read_events` will not be " "yielded again. Events are consumed from the internal queue only when they " @@ -1450,7 +1450,7 @@ msgid "" "results." msgstr "" -#: library/xml.etree.elementtree.rst:1509 +#: library/xml.etree.elementtree.rst:1510 msgid "" ":class:`XMLPullParser` only guarantees that it has seen the \">\" character " "of a starting tag when it emits a \"start\" event, so the attributes are " @@ -1459,11 +1459,11 @@ msgid "" "be present." msgstr "" -#: library/xml.etree.elementtree.rst:1524 +#: library/xml.etree.elementtree.rst:1525 msgid "Exceptions" msgstr "" -#: library/xml.etree.elementtree.rst:1528 +#: library/xml.etree.elementtree.rst:1529 msgid "" "XML parse error, raised by the various parsing methods in this module when " "parsing fails. The string representation of an instance of this exception " @@ -1471,22 +1471,22 @@ msgid "" "following attributes available:" msgstr "" -#: library/xml.etree.elementtree.rst:1535 +#: library/xml.etree.elementtree.rst:1536 msgid "" "A numeric error code from the expat parser. See the documentation of :mod:" "`xml.parsers.expat` for the list of error codes and their meanings." msgstr "" -#: library/xml.etree.elementtree.rst:1540 +#: library/xml.etree.elementtree.rst:1541 msgid "" "A tuple of *line*, *column* numbers, specifying where the error occurred." msgstr "" -#: library/xml.etree.elementtree.rst:1543 +#: library/xml.etree.elementtree.rst:1544 msgid "Footnotes" msgstr "" -#: library/xml.etree.elementtree.rst:1544 +#: library/xml.etree.elementtree.rst:1545 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 " diff --git a/reference/compound_stmts.po b/reference/compound_stmts.po index b23cacf1a..574aa14c8 100644 --- a/reference/compound_stmts.po +++ b/reference/compound_stmts.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -202,23 +202,26 @@ msgid "" "for an exception handler is started. This search inspects the :keyword:`!" "except` clauses in turn until one is found that matches the exception. An " "expression-less :keyword:`!except` clause, if present, must be last; it " -"matches any exception. For an :keyword:`!except` clause with an expression, " -"that expression is evaluated, and the clause matches the exception if the " -"resulting object is \"compatible\" with the exception. An object is " -"compatible with an exception if the object is the class or a :term:`non-" -"virtual base class ` of the exception object, or a " -"tuple containing an item that is the class or a non-virtual base class of " -"the exception object." +"matches any exception." msgstr "" -#: reference/compound_stmts.rst:256 +#: reference/compound_stmts.rst:249 +msgid "" +"For an :keyword:`!except` clause with an expression, the expression must " +"evaluate to an exception type or a tuple of exception types. The raised " +"exception matches an :keyword:`!except` clause whose expression evaluates to " +"the class or a :term:`non-virtual base class ` of the " +"exception object, or to a tuple that contains such a class." +msgstr "" + +#: reference/compound_stmts.rst:255 msgid "" "If no :keyword:`!except` clause matches the exception, the search for an " "exception handler continues in the surrounding code and on the invocation " "stack. [#]_" msgstr "" -#: reference/compound_stmts.rst:260 +#: reference/compound_stmts.rst:259 msgid "" "If the evaluation of an expression in the header of an :keyword:`!except` " "clause raises an exception, the original search for a handler is canceled " @@ -227,7 +230,7 @@ msgid "" "the exception)." msgstr "" -#: reference/compound_stmts.rst:268 +#: reference/compound_stmts.rst:267 msgid "" "When a matching :keyword:`!except` clause is found, the exception is " "assigned to the target specified after the :keyword:`!as` keyword in that :" @@ -240,17 +243,17 @@ msgid "" "handle the exception.)" msgstr "" -#: reference/compound_stmts.rst:279 +#: reference/compound_stmts.rst:278 msgid "" "When an exception has been assigned using ``as target``, it is cleared at " "the end of the :keyword:`!except` clause. This is as if ::" msgstr "" -#: reference/compound_stmts.rst:285 +#: reference/compound_stmts.rst:284 msgid "was translated to ::" msgstr "" -#: reference/compound_stmts.rst:293 +#: reference/compound_stmts.rst:292 msgid "" "This means the exception must be assigned to a different name to be able to " "refer to it after the :keyword:`!except` clause. Exceptions are cleared " @@ -259,7 +262,7 @@ msgid "" "garbage collection occurs." msgstr "" -#: reference/compound_stmts.rst:303 +#: reference/compound_stmts.rst:302 msgid "" "Before an :keyword:`!except` clause's suite is executed, the exception is " "stored in the :mod:`sys` module, where it can be accessed from within the " @@ -268,11 +271,11 @@ msgid "" "is reset to its previous value::" msgstr "" -#: reference/compound_stmts.rst:334 +#: reference/compound_stmts.rst:333 msgid ":keyword:`!except*` clause" msgstr "" -#: reference/compound_stmts.rst:336 +#: reference/compound_stmts.rst:335 msgid "" "The :keyword:`!except*` clause(s) are used for handling :exc:" "`ExceptionGroup`\\s. The exception type for matching is interpreted as in " @@ -285,7 +288,7 @@ msgid "" "that matches it. ::" msgstr "" -#: reference/compound_stmts.rst:364 +#: reference/compound_stmts.rst:363 msgid "" "Any remaining exceptions that were not handled by any :keyword:`!except*` " "clause are re-raised at the end, along with all exceptions that were raised " @@ -293,27 +296,32 @@ msgid "" "one exception to reraise, they are combined into an exception group." msgstr "" -#: reference/compound_stmts.rst:370 +#: reference/compound_stmts.rst:369 msgid "" "If the raised exception is not an exception group and its type matches one " "of the :keyword:`!except*` clauses, it is caught and wrapped by an exception " "group with an empty message string. ::" msgstr "" -#: reference/compound_stmts.rst:381 +#: reference/compound_stmts.rst:380 +msgid "" +"An :keyword:`!except*` clause must have a matching expression; it cannot be " +"``except*:``. Furthermore, this expression cannot contain exception group " +"types, because that would have ambiguous semantics." +msgstr "" + +#: reference/compound_stmts.rst:384 msgid "" -"An :keyword:`!except*` clause must have a matching type, and this type " -"cannot be a subclass of :exc:`BaseExceptionGroup`. It is not possible to " -"mix :keyword:`except` and :keyword:`!except*` in the same :keyword:`try`. :" -"keyword:`break`, :keyword:`continue` and :keyword:`return` cannot appear in " -"an :keyword:`!except*` clause." +"It is not possible to mix :keyword:`except` and :keyword:`!except*` in the " +"same :keyword:`try`. :keyword:`break`, :keyword:`continue` and :keyword:" +"`return` cannot appear in an :keyword:`!except*` clause." msgstr "" -#: reference/compound_stmts.rst:398 +#: reference/compound_stmts.rst:399 msgid ":keyword:`!else` clause" msgstr "" -#: reference/compound_stmts.rst:400 +#: reference/compound_stmts.rst:401 msgid "" "The optional :keyword:`!else` clause is executed if the control flow leaves " "the :keyword:`try` suite, no exception was raised, and no :keyword:" @@ -322,11 +330,11 @@ msgid "" "keyword:`except` clauses." msgstr "" -#: reference/compound_stmts.rst:412 +#: reference/compound_stmts.rst:413 msgid ":keyword:`!finally` clause" msgstr "" -#: reference/compound_stmts.rst:414 +#: reference/compound_stmts.rst:415 msgid "" "If :keyword:`!finally` is present, it specifies a 'cleanup' handler. The :" "keyword:`try` clause is executed, including any :keyword:`except` and :" @@ -340,13 +348,13 @@ msgid "" "exception is discarded::" msgstr "" -#: reference/compound_stmts.rst:433 +#: reference/compound_stmts.rst:434 msgid "" "The exception information is not available to the program during execution " "of the :keyword:`!finally` clause." msgstr "" -#: reference/compound_stmts.rst:441 +#: reference/compound_stmts.rst:442 msgid "" "When a :keyword:`return`, :keyword:`break` or :keyword:`continue` statement " "is executed in the :keyword:`try` suite of a :keyword:`!try`...\\ :keyword:`!" @@ -354,7 +362,7 @@ msgid "" "way out.'" msgstr "" -#: reference/compound_stmts.rst:445 +#: reference/compound_stmts.rst:446 msgid "" "The return value of a function is determined by the last :keyword:`return` " "statement executed. Since the :keyword:`!finally` clause always executes, " @@ -362,17 +370,17 @@ msgid "" "will always be the last one executed::" msgstr "" -#: reference/compound_stmts.rst:459 +#: reference/compound_stmts.rst:460 msgid "" "Prior to Python 3.8, a :keyword:`continue` statement was illegal in the :" "keyword:`!finally` clause due to a problem with the implementation." msgstr "" -#: reference/compound_stmts.rst:468 +#: reference/compound_stmts.rst:469 msgid "The :keyword:`!with` statement" msgstr "" -#: reference/compound_stmts.rst:477 +#: reference/compound_stmts.rst:478 msgid "" "The :keyword:`with` statement is used to wrap the execution of a block with " "methods defined by a context manager (see section :ref:`context-managers`). " @@ -380,38 +388,38 @@ msgid "" "`finally` usage patterns to be encapsulated for convenient reuse." msgstr "" -#: reference/compound_stmts.rst:487 +#: reference/compound_stmts.rst:488 msgid "" "The execution of the :keyword:`with` statement with one \"item\" proceeds as " "follows:" msgstr "" -#: reference/compound_stmts.rst:489 +#: reference/compound_stmts.rst:490 msgid "" "The context expression (the expression given in the :token:`~python-grammar:" "with_item`) is evaluated to obtain a context manager." msgstr "" -#: reference/compound_stmts.rst:492 +#: reference/compound_stmts.rst:493 msgid "" "The context manager's :meth:`~object.__enter__` is loaded for later use." msgstr "" -#: reference/compound_stmts.rst:494 +#: reference/compound_stmts.rst:495 msgid "The context manager's :meth:`~object.__exit__` is loaded for later use." msgstr "" -#: reference/compound_stmts.rst:496 +#: reference/compound_stmts.rst:497 msgid "The context manager's :meth:`~object.__enter__` method is invoked." msgstr "" -#: reference/compound_stmts.rst:498 +#: reference/compound_stmts.rst:499 msgid "" "If a target was included in the :keyword:`with` statement, the return value " "from :meth:`~object.__enter__` is assigned to it." msgstr "" -#: reference/compound_stmts.rst:503 +#: reference/compound_stmts.rst:504 msgid "" "The :keyword:`with` statement guarantees that if the :meth:`~object." "__enter__` method returns without an error, then :meth:`~object.__exit__` " @@ -420,11 +428,11 @@ msgid "" "suite would be. See step 7 below." msgstr "" -#: reference/compound_stmts.rst:509 +#: reference/compound_stmts.rst:510 msgid "The suite is executed." msgstr "" -#: reference/compound_stmts.rst:511 +#: reference/compound_stmts.rst:512 msgid "" "The context manager's :meth:`~object.__exit__` method is invoked. If an " "exception caused the suite to be exited, its type, value, and traceback are " @@ -432,7 +440,7 @@ msgid "" "`None` arguments are supplied." msgstr "" -#: reference/compound_stmts.rst:516 +#: reference/compound_stmts.rst:517 msgid "" "If the suite was exited due to an exception, and the return value from the :" "meth:`~object.__exit__` method was false, the exception is reraised. If the " @@ -440,115 +448,115 @@ msgid "" "with the statement following the :keyword:`with` statement." msgstr "" -#: reference/compound_stmts.rst:521 +#: reference/compound_stmts.rst:522 msgid "" "If the suite was exited for any reason other than an exception, the return " "value from :meth:`~object.__exit__` is ignored, and execution proceeds at " "the normal location for the kind of exit that was taken." msgstr "" -#: reference/compound_stmts.rst:525 reference/compound_stmts.rst:1540 -#: reference/compound_stmts.rst:1581 +#: reference/compound_stmts.rst:526 reference/compound_stmts.rst:1541 +#: reference/compound_stmts.rst:1582 msgid "The following code::" msgstr "" -#: reference/compound_stmts.rst:530 reference/compound_stmts.rst:555 -#: reference/compound_stmts.rst:1586 +#: reference/compound_stmts.rst:531 reference/compound_stmts.rst:556 +#: reference/compound_stmts.rst:1587 msgid "is semantically equivalent to::" msgstr "" -#: reference/compound_stmts.rst:549 +#: reference/compound_stmts.rst:550 msgid "" "With more than one item, the context managers are processed as if multiple :" "keyword:`with` statements were nested::" msgstr "" -#: reference/compound_stmts.rst:561 +#: reference/compound_stmts.rst:562 msgid "" "You can also write multi-item context managers in multiple lines if the " "items are surrounded by parentheses. For example::" msgstr "" -#: reference/compound_stmts.rst:570 +#: reference/compound_stmts.rst:571 msgid "Support for multiple context expressions." msgstr "" -#: reference/compound_stmts.rst:573 +#: reference/compound_stmts.rst:574 msgid "" "Support for using grouping parentheses to break the statement in multiple " "lines." msgstr "" -#: reference/compound_stmts.rst:578 +#: reference/compound_stmts.rst:579 msgid ":pep:`343` - The \"with\" statement" msgstr "" -#: reference/compound_stmts.rst:579 +#: reference/compound_stmts.rst:580 msgid "" "The specification, background, and examples for the Python :keyword:`with` " "statement." msgstr "" -#: reference/compound_stmts.rst:585 +#: reference/compound_stmts.rst:586 msgid "The :keyword:`!match` statement" msgstr "" -#: reference/compound_stmts.rst:599 +#: reference/compound_stmts.rst:600 msgid "The match statement is used for pattern matching. Syntax:" msgstr "" -#: reference/compound_stmts.rst:608 +#: reference/compound_stmts.rst:609 msgid "" "This section uses single quotes to denote :ref:`soft keywords `." msgstr "" -#: reference/compound_stmts.rst:611 +#: reference/compound_stmts.rst:612 msgid "" "Pattern matching takes a pattern as input (following ``case``) and a subject " "value (following ``match``). The pattern (which may contain subpatterns) is " "matched against the subject value. The outcomes are:" msgstr "" -#: reference/compound_stmts.rst:615 +#: reference/compound_stmts.rst:616 msgid "A match success or failure (also termed a pattern success or failure)." msgstr "" -#: reference/compound_stmts.rst:617 +#: reference/compound_stmts.rst:618 msgid "" "Possible binding of matched values to a name. The prerequisites for this " "are further discussed below." msgstr "" -#: reference/compound_stmts.rst:620 +#: reference/compound_stmts.rst:621 msgid "" "The ``match`` and ``case`` keywords are :ref:`soft keywords `." msgstr "" -#: reference/compound_stmts.rst:624 reference/compound_stmts.rst:1181 +#: reference/compound_stmts.rst:625 reference/compound_stmts.rst:1182 msgid ":pep:`634` -- Structural Pattern Matching: Specification" msgstr "" -#: reference/compound_stmts.rst:625 reference/compound_stmts.rst:1182 +#: reference/compound_stmts.rst:626 reference/compound_stmts.rst:1183 msgid ":pep:`636` -- Structural Pattern Matching: Tutorial" msgstr "" -#: reference/compound_stmts.rst:629 +#: reference/compound_stmts.rst:630 msgid "Overview" msgstr "" -#: reference/compound_stmts.rst:631 +#: reference/compound_stmts.rst:632 msgid "Here's an overview of the logical flow of a match statement:" msgstr "" -#: reference/compound_stmts.rst:634 +#: reference/compound_stmts.rst:635 msgid "" "The subject expression ``subject_expr`` is evaluated and a resulting subject " "value obtained. If the subject expression contains a comma, a tuple is " "constructed using :ref:`the standard rules `." msgstr "" -#: reference/compound_stmts.rst:638 +#: reference/compound_stmts.rst:639 msgid "" "Each pattern in a ``case_block`` is attempted to match with the subject " "value. The specific rules for success or failure are described below. The " @@ -558,7 +566,7 @@ msgid "" "outlive the executed block and can be used after the match statement**." msgstr "" -#: reference/compound_stmts.rst:647 +#: reference/compound_stmts.rst:648 msgid "" "During failed pattern matches, some subpatterns may succeed. Do not rely on " "bindings being made for a failed match. Conversely, do not rely on " @@ -567,87 +575,87 @@ msgid "" "made to allow different implementations to add optimizations." msgstr "" -#: reference/compound_stmts.rst:654 +#: reference/compound_stmts.rst:655 msgid "" "If the pattern succeeds, the corresponding guard (if present) is evaluated. " "In this case all name bindings are guaranteed to have happened." msgstr "" -#: reference/compound_stmts.rst:657 +#: reference/compound_stmts.rst:658 msgid "" "If the guard evaluates as true or is missing, the ``block`` inside " "``case_block`` is executed." msgstr "" -#: reference/compound_stmts.rst:660 +#: reference/compound_stmts.rst:661 msgid "Otherwise, the next ``case_block`` is attempted as described above." msgstr "" -#: reference/compound_stmts.rst:662 +#: reference/compound_stmts.rst:663 msgid "If there are no further case blocks, the match statement is completed." msgstr "" -#: reference/compound_stmts.rst:666 +#: reference/compound_stmts.rst:667 msgid "" "Users should generally never rely on a pattern being evaluated. Depending " "on implementation, the interpreter may cache values or use other " "optimizations which skip repeated evaluations." msgstr "" -#: reference/compound_stmts.rst:670 +#: reference/compound_stmts.rst:671 msgid "A sample match statement::" msgstr "" -#: reference/compound_stmts.rst:686 +#: reference/compound_stmts.rst:687 msgid "" "In this case, ``if flag`` is a guard. Read more about that in the next " "section." msgstr "" -#: reference/compound_stmts.rst:689 +#: reference/compound_stmts.rst:690 msgid "Guards" msgstr "" -#: reference/compound_stmts.rst:696 +#: reference/compound_stmts.rst:697 msgid "" "A ``guard`` (which is part of the ``case``) must succeed for code inside the " "``case`` block to execute. It takes the form: :keyword:`if` followed by an " "expression." msgstr "" -#: reference/compound_stmts.rst:701 +#: reference/compound_stmts.rst:702 msgid "The logical flow of a ``case`` block with a ``guard`` follows:" msgstr "" -#: reference/compound_stmts.rst:703 +#: reference/compound_stmts.rst:704 msgid "" "Check that the pattern in the ``case`` block succeeded. If the pattern " "failed, the ``guard`` is not evaluated and the next ``case`` block is " "checked." msgstr "" -#: reference/compound_stmts.rst:707 +#: reference/compound_stmts.rst:708 msgid "If the pattern succeeded, evaluate the ``guard``." msgstr "" -#: reference/compound_stmts.rst:709 +#: reference/compound_stmts.rst:710 msgid "" "If the ``guard`` condition evaluates as true, the case block is selected." msgstr "" -#: reference/compound_stmts.rst:712 +#: reference/compound_stmts.rst:713 msgid "" "If the ``guard`` condition evaluates as false, the case block is not " "selected." msgstr "" -#: reference/compound_stmts.rst:715 +#: reference/compound_stmts.rst:716 msgid "" "If the ``guard`` raises an exception during evaluation, the exception " "bubbles up." msgstr "" -#: reference/compound_stmts.rst:718 +#: reference/compound_stmts.rst:719 msgid "" "Guards are allowed to have side effects as they are expressions. Guard " "evaluation must proceed from the first to the last case block, one at a " @@ -656,17 +664,17 @@ msgid "" "block is selected." msgstr "" -#: reference/compound_stmts.rst:728 +#: reference/compound_stmts.rst:729 msgid "Irrefutable Case Blocks" msgstr "" -#: reference/compound_stmts.rst:732 +#: reference/compound_stmts.rst:733 msgid "" "An irrefutable case block is a match-all case block. A match statement may " "have at most one irrefutable case block, and it must be last." msgstr "" -#: reference/compound_stmts.rst:735 +#: reference/compound_stmts.rst:736 msgid "" "A case block is considered irrefutable if it has no guard and its pattern is " "irrefutable. A pattern is considered irrefutable if we can prove from its " @@ -674,47 +682,47 @@ msgid "" "irrefutable:" msgstr "" -#: reference/compound_stmts.rst:740 +#: reference/compound_stmts.rst:741 msgid ":ref:`as-patterns` whose left-hand side is irrefutable" msgstr "" -#: reference/compound_stmts.rst:742 +#: reference/compound_stmts.rst:743 msgid ":ref:`or-patterns` containing at least one irrefutable pattern" msgstr "" -#: reference/compound_stmts.rst:744 +#: reference/compound_stmts.rst:745 msgid ":ref:`capture-patterns`" msgstr "" -#: reference/compound_stmts.rst:746 +#: reference/compound_stmts.rst:747 msgid ":ref:`wildcard-patterns`" msgstr "" -#: reference/compound_stmts.rst:748 +#: reference/compound_stmts.rst:749 msgid "parenthesized irrefutable patterns" msgstr "" -#: reference/compound_stmts.rst:752 +#: reference/compound_stmts.rst:753 msgid "Patterns" msgstr "" -#: reference/compound_stmts.rst:759 +#: reference/compound_stmts.rst:760 msgid "This section uses grammar notations beyond standard EBNF:" msgstr "" -#: reference/compound_stmts.rst:761 +#: reference/compound_stmts.rst:762 msgid "the notation ``SEP.RULE+`` is shorthand for ``RULE (SEP RULE)*``" msgstr "" -#: reference/compound_stmts.rst:763 +#: reference/compound_stmts.rst:764 msgid "the notation ``!RULE`` is shorthand for a negative lookahead assertion" msgstr "" -#: reference/compound_stmts.rst:766 +#: reference/compound_stmts.rst:767 msgid "The top-level syntax for ``patterns`` is:" msgstr "" -#: reference/compound_stmts.rst:780 +#: reference/compound_stmts.rst:781 msgid "" "The descriptions below will include a description \"in simple terms\" of " "what a pattern does for illustration purposes (credits to Raymond Hettinger " @@ -724,70 +732,70 @@ msgid "" "forms." msgstr "" -#: reference/compound_stmts.rst:790 +#: reference/compound_stmts.rst:791 msgid "OR Patterns" msgstr "" -#: reference/compound_stmts.rst:792 +#: reference/compound_stmts.rst:793 msgid "" "An OR pattern is two or more patterns separated by vertical bars ``|``. " "Syntax:" msgstr "" -#: reference/compound_stmts.rst:798 +#: reference/compound_stmts.rst:799 msgid "" "Only the final subpattern may be :ref:`irrefutable `, and " "each subpattern must bind the same set of names to avoid ambiguity." msgstr "" -#: reference/compound_stmts.rst:801 +#: reference/compound_stmts.rst:802 msgid "" "An OR pattern matches each of its subpatterns in turn to the subject value, " "until one succeeds. The OR pattern is then considered successful. " "Otherwise, if none of the subpatterns succeed, the OR pattern fails." msgstr "" -#: reference/compound_stmts.rst:805 +#: reference/compound_stmts.rst:806 msgid "" "In simple terms, ``P1 | P2 | ...`` will try to match ``P1``, if it fails it " "will try to match ``P2``, succeeding immediately if any succeeds, failing " "otherwise." msgstr "" -#: reference/compound_stmts.rst:811 +#: reference/compound_stmts.rst:812 msgid "AS Patterns" msgstr "" -#: reference/compound_stmts.rst:813 +#: reference/compound_stmts.rst:814 msgid "" "An AS pattern matches an OR pattern on the left of the :keyword:`as` keyword " "against a subject. Syntax:" msgstr "" -#: reference/compound_stmts.rst:819 +#: reference/compound_stmts.rst:820 msgid "" "If the OR pattern fails, the AS pattern fails. Otherwise, the AS pattern " "binds the subject to the name on the right of the as keyword and succeeds. " "``capture_pattern`` cannot be a ``_``." msgstr "" -#: reference/compound_stmts.rst:823 +#: reference/compound_stmts.rst:824 msgid "" "In simple terms ``P as NAME`` will match with ``P``, and on success it will " "set ``NAME = ``." msgstr "" -#: reference/compound_stmts.rst:830 +#: reference/compound_stmts.rst:831 msgid "Literal Patterns" msgstr "" -#: reference/compound_stmts.rst:832 +#: reference/compound_stmts.rst:833 msgid "" "A literal pattern corresponds to most :ref:`literals ` in Python. " "Syntax:" msgstr "" -#: reference/compound_stmts.rst:845 +#: reference/compound_stmts.rst:846 msgid "" "The rule ``strings`` and the token ``NUMBER`` are defined in the :doc:" "`standard Python grammar <./grammar>`. Triple-quoted strings are " @@ -795,42 +803,42 @@ msgid "" "are not supported." msgstr "" -#: reference/compound_stmts.rst:850 +#: reference/compound_stmts.rst:851 msgid "" "The forms ``signed_number '+' NUMBER`` and ``signed_number '-' NUMBER`` are " "for expressing :ref:`complex numbers `; they require a real " "number on the left and an imaginary number on the right. E.g. ``3 + 4j``." msgstr "" -#: reference/compound_stmts.rst:854 +#: reference/compound_stmts.rst:855 msgid "" "In simple terms, ``LITERAL`` will succeed only if `` == LITERAL``. " "For the singletons ``None``, ``True`` and ``False``, the :keyword:`is` " "operator is used." msgstr "" -#: reference/compound_stmts.rst:860 +#: reference/compound_stmts.rst:861 msgid "Capture Patterns" msgstr "" -#: reference/compound_stmts.rst:862 +#: reference/compound_stmts.rst:863 msgid "A capture pattern binds the subject value to a name. Syntax:" msgstr "" -#: reference/compound_stmts.rst:868 +#: reference/compound_stmts.rst:869 msgid "" "A single underscore ``_`` is not a capture pattern (this is what ``!'_'`` " "expresses). It is instead treated as a :token:`~python-grammar:" "wildcard_pattern`." msgstr "" -#: reference/compound_stmts.rst:872 +#: reference/compound_stmts.rst:873 msgid "" "In a given pattern, a given name can only be bound once. E.g. ``case x, " "x: ...`` is invalid while ``case [x] | x: ...`` is allowed." msgstr "" -#: reference/compound_stmts.rst:875 +#: reference/compound_stmts.rst:876 msgid "" "Capture patterns always succeed. The binding follows scoping rules " "established by the assignment expression operator in :pep:`572`; the name " @@ -838,55 +846,55 @@ msgid "" "there's an applicable :keyword:`global` or :keyword:`nonlocal` statement." msgstr "" -#: reference/compound_stmts.rst:880 +#: reference/compound_stmts.rst:881 msgid "" "In simple terms ``NAME`` will always succeed and it will set ``NAME = " "``." msgstr "" -#: reference/compound_stmts.rst:885 +#: reference/compound_stmts.rst:886 msgid "Wildcard Patterns" msgstr "" -#: reference/compound_stmts.rst:887 +#: reference/compound_stmts.rst:888 msgid "" "A wildcard pattern always succeeds (matches anything) and binds no name. " "Syntax:" msgstr "" -#: reference/compound_stmts.rst:893 +#: reference/compound_stmts.rst:894 msgid "" "``_`` is a :ref:`soft keyword ` within any pattern, but only " "within patterns. It is an identifier, as usual, even within ``match`` " "subject expressions, ``guard``\\ s, and ``case`` blocks." msgstr "" -#: reference/compound_stmts.rst:897 +#: reference/compound_stmts.rst:898 msgid "In simple terms, ``_`` will always succeed." msgstr "" -#: reference/compound_stmts.rst:902 +#: reference/compound_stmts.rst:903 msgid "Value Patterns" msgstr "" -#: reference/compound_stmts.rst:904 +#: reference/compound_stmts.rst:905 msgid "A value pattern represents a named value in Python. Syntax:" msgstr "" -#: reference/compound_stmts.rst:912 +#: reference/compound_stmts.rst:913 msgid "" "The dotted name in the pattern is looked up using standard Python :ref:`name " "resolution rules `. The pattern succeeds if the value found " "compares equal to the subject value (using the ``==`` equality operator)." msgstr "" -#: reference/compound_stmts.rst:917 +#: reference/compound_stmts.rst:918 msgid "" "In simple terms ``NAME1.NAME2`` will succeed only if `` == NAME1." "NAME2``" msgstr "" -#: reference/compound_stmts.rst:921 +#: reference/compound_stmts.rst:922 msgid "" "If the same value occurs multiple times in the same match statement, the " "interpreter may cache the first value found and reuse it rather than repeat " @@ -894,44 +902,44 @@ msgid "" "given match statement." msgstr "" -#: reference/compound_stmts.rst:929 +#: reference/compound_stmts.rst:930 msgid "Group Patterns" msgstr "" -#: reference/compound_stmts.rst:931 +#: reference/compound_stmts.rst:932 msgid "" "A group pattern allows users to add parentheses around patterns to emphasize " "the intended grouping. Otherwise, it has no additional syntax. Syntax:" msgstr "" -#: reference/compound_stmts.rst:938 +#: reference/compound_stmts.rst:939 msgid "In simple terms ``(P)`` has the same effect as ``P``." msgstr "" -#: reference/compound_stmts.rst:943 +#: reference/compound_stmts.rst:944 msgid "Sequence Patterns" msgstr "" -#: reference/compound_stmts.rst:945 +#: reference/compound_stmts.rst:946 msgid "" "A sequence pattern contains several subpatterns to be matched against " "sequence elements. The syntax is similar to the unpacking of a list or tuple." msgstr "" -#: reference/compound_stmts.rst:956 +#: reference/compound_stmts.rst:957 msgid "" "There is no difference if parentheses or square brackets are used for " "sequence patterns (i.e. ``(...)`` vs ``[...]`` )." msgstr "" -#: reference/compound_stmts.rst:960 +#: reference/compound_stmts.rst:961 msgid "" "A single pattern enclosed in parentheses without a trailing comma (e.g. ``(3 " "| 4)``) is a :ref:`group pattern `. While a single pattern " "enclosed in square brackets (e.g. ``[3 | 4]``) is still a sequence pattern." msgstr "" -#: reference/compound_stmts.rst:965 +#: reference/compound_stmts.rst:966 msgid "" "At most one star subpattern may be in a sequence pattern. The star " "subpattern may occur in any position. If no star subpattern is present, the " @@ -939,40 +947,40 @@ msgid "" "variable-length sequence pattern." msgstr "" -#: reference/compound_stmts.rst:970 +#: reference/compound_stmts.rst:971 msgid "" "The following is the logical flow for matching a sequence pattern against a " "subject value:" msgstr "" -#: reference/compound_stmts.rst:973 +#: reference/compound_stmts.rst:974 msgid "" "If the subject value is not a sequence [#]_, the sequence pattern fails." msgstr "" -#: reference/compound_stmts.rst:976 +#: reference/compound_stmts.rst:977 msgid "" "If the subject value is an instance of ``str``, ``bytes`` or ``bytearray`` " "the sequence pattern fails." msgstr "" -#: reference/compound_stmts.rst:979 +#: reference/compound_stmts.rst:980 msgid "" "The subsequent steps depend on whether the sequence pattern is fixed or " "variable-length." msgstr "" -#: reference/compound_stmts.rst:982 +#: reference/compound_stmts.rst:983 msgid "If the sequence pattern is fixed-length:" msgstr "" -#: reference/compound_stmts.rst:984 +#: reference/compound_stmts.rst:985 msgid "" "If the length of the subject sequence is not equal to the number of " "subpatterns, the sequence pattern fails" msgstr "" -#: reference/compound_stmts.rst:987 +#: reference/compound_stmts.rst:988 msgid "" "Subpatterns in the sequence pattern are matched to their corresponding items " "in the subject sequence from left to right. Matching stops as soon as a " @@ -980,118 +988,118 @@ msgid "" "corresponding item, the sequence pattern succeeds." msgstr "" -#: reference/compound_stmts.rst:992 +#: reference/compound_stmts.rst:993 msgid "Otherwise, if the sequence pattern is variable-length:" msgstr "" -#: reference/compound_stmts.rst:994 +#: reference/compound_stmts.rst:995 msgid "" "If the length of the subject sequence is less than the number of non-star " "subpatterns, the sequence pattern fails." msgstr "" -#: reference/compound_stmts.rst:997 +#: reference/compound_stmts.rst:998 msgid "" "The leading non-star subpatterns are matched to their corresponding items as " "for fixed-length sequences." msgstr "" -#: reference/compound_stmts.rst:1000 +#: reference/compound_stmts.rst:1001 msgid "" "If the previous step succeeds, the star subpattern matches a list formed of " "the remaining subject items, excluding the remaining items corresponding to " "non-star subpatterns following the star subpattern." msgstr "" -#: reference/compound_stmts.rst:1004 +#: reference/compound_stmts.rst:1005 msgid "" "Remaining non-star subpatterns are matched to their corresponding subject " "items, as for a fixed-length sequence." msgstr "" -#: reference/compound_stmts.rst:1007 +#: reference/compound_stmts.rst:1008 msgid "" "The length of the subject sequence is obtained via :func:`len` (i.e. via " "the :meth:`__len__` protocol). This length may be cached by the interpreter " "in a similar manner as :ref:`value patterns `." msgstr "" -#: reference/compound_stmts.rst:1013 +#: reference/compound_stmts.rst:1014 msgid "" "In simple terms ``[P1, P2, P3,`` ... ``, P]`` matches only if all the " "following happens:" msgstr "" -#: reference/compound_stmts.rst:1016 +#: reference/compound_stmts.rst:1017 msgid "check ```` is a sequence" msgstr "" -#: reference/compound_stmts.rst:1017 +#: reference/compound_stmts.rst:1018 msgid "``len(subject) == ``" msgstr "" -#: reference/compound_stmts.rst:1018 +#: reference/compound_stmts.rst:1019 msgid "" "``P1`` matches ``[0]`` (note that this match can also bind names)" msgstr "" -#: reference/compound_stmts.rst:1019 +#: reference/compound_stmts.rst:1020 msgid "" "``P2`` matches ``[1]`` (note that this match can also bind names)" msgstr "" -#: reference/compound_stmts.rst:1020 +#: reference/compound_stmts.rst:1021 msgid "... and so on for the corresponding pattern/element." msgstr "" -#: reference/compound_stmts.rst:1025 +#: reference/compound_stmts.rst:1026 msgid "Mapping Patterns" msgstr "" -#: reference/compound_stmts.rst:1027 +#: reference/compound_stmts.rst:1028 msgid "" "A mapping pattern contains one or more key-value patterns. The syntax is " "similar to the construction of a dictionary. Syntax:" msgstr "" -#: reference/compound_stmts.rst:1038 +#: reference/compound_stmts.rst:1039 msgid "" "At most one double star pattern may be in a mapping pattern. The double " "star pattern must be the last subpattern in the mapping pattern." msgstr "" -#: reference/compound_stmts.rst:1041 +#: reference/compound_stmts.rst:1042 msgid "" "Duplicate keys in mapping patterns are disallowed. Duplicate literal keys " "will raise a :exc:`SyntaxError`. Two keys that otherwise have the same value " "will raise a :exc:`ValueError` at runtime." msgstr "" -#: reference/compound_stmts.rst:1045 +#: reference/compound_stmts.rst:1046 msgid "" "The following is the logical flow for matching a mapping pattern against a " "subject value:" msgstr "" -#: reference/compound_stmts.rst:1048 +#: reference/compound_stmts.rst:1049 msgid "If the subject value is not a mapping [#]_,the mapping pattern fails." msgstr "" -#: reference/compound_stmts.rst:1050 +#: reference/compound_stmts.rst:1051 msgid "" "If every key given in the mapping pattern is present in the subject mapping, " "and the pattern for each key matches the corresponding item of the subject " "mapping, the mapping pattern succeeds." msgstr "" -#: reference/compound_stmts.rst:1054 +#: reference/compound_stmts.rst:1055 msgid "" "If duplicate keys are detected in the mapping pattern, the pattern is " "considered invalid. A :exc:`SyntaxError` is raised for duplicate literal " "values; or a :exc:`ValueError` for named keys of the same value." msgstr "" -#: reference/compound_stmts.rst:1058 +#: reference/compound_stmts.rst:1059 msgid "" "Key-value pairs are matched using the two-argument form of the mapping " "subject's ``get()`` method. Matched key-value pairs must already be present " @@ -1099,254 +1107,254 @@ msgid "" "`~object.__getitem__`." msgstr "" -#: reference/compound_stmts.rst:1063 +#: reference/compound_stmts.rst:1064 msgid "" "In simple terms ``{KEY1: P1, KEY2: P2, ... }`` matches only if all the " "following happens:" msgstr "" -#: reference/compound_stmts.rst:1066 +#: reference/compound_stmts.rst:1067 msgid "check ```` is a mapping" msgstr "" -#: reference/compound_stmts.rst:1067 +#: reference/compound_stmts.rst:1068 msgid "``KEY1 in ``" msgstr "" -#: reference/compound_stmts.rst:1068 +#: reference/compound_stmts.rst:1069 msgid "``P1`` matches ``[KEY1]``" msgstr "" -#: reference/compound_stmts.rst:1069 +#: reference/compound_stmts.rst:1070 msgid "... and so on for the corresponding KEY/pattern pair." msgstr "" -#: reference/compound_stmts.rst:1075 +#: reference/compound_stmts.rst:1076 msgid "Class Patterns" msgstr "" -#: reference/compound_stmts.rst:1077 +#: reference/compound_stmts.rst:1078 msgid "" "A class pattern represents a class and its positional and keyword arguments " "(if any). Syntax:" msgstr "" -#: reference/compound_stmts.rst:1088 +#: reference/compound_stmts.rst:1089 msgid "The same keyword should not be repeated in class patterns." msgstr "" -#: reference/compound_stmts.rst:1090 +#: reference/compound_stmts.rst:1091 msgid "" "The following is the logical flow for matching a class pattern against a " "subject value:" msgstr "" -#: reference/compound_stmts.rst:1093 +#: reference/compound_stmts.rst:1094 msgid "" "If ``name_or_attr`` is not an instance of the builtin :class:`type` , raise :" "exc:`TypeError`." msgstr "" -#: reference/compound_stmts.rst:1096 +#: reference/compound_stmts.rst:1097 msgid "" "If the subject value is not an instance of ``name_or_attr`` (tested via :" "func:`isinstance`), the class pattern fails." msgstr "" -#: reference/compound_stmts.rst:1099 +#: reference/compound_stmts.rst:1100 msgid "" "If no pattern arguments are present, the pattern succeeds. Otherwise, the " "subsequent steps depend on whether keyword or positional argument patterns " "are present." msgstr "" -#: reference/compound_stmts.rst:1103 +#: reference/compound_stmts.rst:1104 msgid "" "For a number of built-in types (specified below), a single positional " "subpattern is accepted which will match the entire subject; for these types " "keyword patterns also work as for other types." msgstr "" -#: reference/compound_stmts.rst:1107 +#: reference/compound_stmts.rst:1108 msgid "" "If only keyword patterns are present, they are processed as follows, one by " "one:" msgstr "" -#: reference/compound_stmts.rst:1110 +#: reference/compound_stmts.rst:1111 msgid "I. The keyword is looked up as an attribute on the subject." msgstr "" -#: reference/compound_stmts.rst:1112 +#: reference/compound_stmts.rst:1113 msgid "" "If this raises an exception other than :exc:`AttributeError`, the exception " "bubbles up." msgstr "" -#: reference/compound_stmts.rst:1115 +#: reference/compound_stmts.rst:1116 msgid "If this raises :exc:`AttributeError`, the class pattern has failed." msgstr "" -#: reference/compound_stmts.rst:1117 +#: reference/compound_stmts.rst:1118 msgid "" "Else, the subpattern associated with the keyword pattern is matched against " "the subject's attribute value. If this fails, the class pattern fails; if " "this succeeds, the match proceeds to the next keyword." msgstr "" -#: reference/compound_stmts.rst:1122 +#: reference/compound_stmts.rst:1123 msgid "II. If all keyword patterns succeed, the class pattern succeeds." msgstr "" -#: reference/compound_stmts.rst:1124 +#: reference/compound_stmts.rst:1125 msgid "" "If any positional patterns are present, they are converted to keyword " "patterns using the :data:`~object.__match_args__` attribute on the class " "``name_or_attr`` before matching:" msgstr "" -#: reference/compound_stmts.rst:1128 +#: reference/compound_stmts.rst:1129 msgid "" "I. The equivalent of ``getattr(cls, \"__match_args__\", ())`` is called." msgstr "" -#: reference/compound_stmts.rst:1130 +#: reference/compound_stmts.rst:1131 msgid "If this raises an exception, the exception bubbles up." msgstr "" -#: reference/compound_stmts.rst:1132 +#: reference/compound_stmts.rst:1133 msgid "" "If the returned value is not a tuple, the conversion fails and :exc:" "`TypeError` is raised." msgstr "" -#: reference/compound_stmts.rst:1135 +#: reference/compound_stmts.rst:1136 msgid "" "If there are more positional patterns than ``len(cls.__match_args__)``, :exc:" "`TypeError` is raised." msgstr "" -#: reference/compound_stmts.rst:1138 +#: reference/compound_stmts.rst:1139 msgid "" "Otherwise, positional pattern ``i`` is converted to a keyword pattern using " "``__match_args__[i]`` as the keyword. ``__match_args__[i]`` must be a " "string; if not :exc:`TypeError` is raised." msgstr "" -#: reference/compound_stmts.rst:1142 +#: reference/compound_stmts.rst:1143 msgid "If there are duplicate keywords, :exc:`TypeError` is raised." msgstr "" -#: reference/compound_stmts.rst:1144 +#: reference/compound_stmts.rst:1145 msgid ":ref:`class-pattern-matching`" msgstr "" -#: reference/compound_stmts.rst:1146 +#: reference/compound_stmts.rst:1147 msgid "" "II. Once all positional patterns have been converted to keyword patterns," msgstr "" -#: reference/compound_stmts.rst:1147 +#: reference/compound_stmts.rst:1148 msgid "the match proceeds as if there were only keyword patterns." msgstr "" -#: reference/compound_stmts.rst:1149 +#: reference/compound_stmts.rst:1150 msgid "" "For the following built-in types the handling of positional subpatterns is " "different:" msgstr "" -#: reference/compound_stmts.rst:1152 +#: reference/compound_stmts.rst:1153 msgid ":class:`bool`" msgstr "" -#: reference/compound_stmts.rst:1153 +#: reference/compound_stmts.rst:1154 msgid ":class:`bytearray`" msgstr "" -#: reference/compound_stmts.rst:1154 +#: reference/compound_stmts.rst:1155 msgid ":class:`bytes`" msgstr "" -#: reference/compound_stmts.rst:1155 +#: reference/compound_stmts.rst:1156 msgid ":class:`dict`" msgstr "" -#: reference/compound_stmts.rst:1156 +#: reference/compound_stmts.rst:1157 msgid ":class:`float`" msgstr "" -#: reference/compound_stmts.rst:1157 +#: reference/compound_stmts.rst:1158 msgid ":class:`frozenset`" msgstr "" -#: reference/compound_stmts.rst:1158 +#: reference/compound_stmts.rst:1159 msgid ":class:`int`" msgstr "" -#: reference/compound_stmts.rst:1159 reference/compound_stmts.rst:1856 +#: reference/compound_stmts.rst:1160 reference/compound_stmts.rst:1857 msgid ":class:`list`" msgstr "" -#: reference/compound_stmts.rst:1160 +#: reference/compound_stmts.rst:1161 msgid ":class:`set`" msgstr "" -#: reference/compound_stmts.rst:1161 +#: reference/compound_stmts.rst:1162 msgid ":class:`str`" msgstr "" -#: reference/compound_stmts.rst:1162 reference/compound_stmts.rst:1859 +#: reference/compound_stmts.rst:1163 reference/compound_stmts.rst:1860 msgid ":class:`tuple`" msgstr "" -#: reference/compound_stmts.rst:1164 +#: reference/compound_stmts.rst:1165 msgid "" "These classes accept a single positional argument, and the pattern there is " "matched against the whole object rather than an attribute. For example " "``int(0|1)`` matches the value ``0``, but not the value ``0.0``." msgstr "" -#: reference/compound_stmts.rst:1168 +#: reference/compound_stmts.rst:1169 msgid "" "In simple terms ``CLS(P1, attr=P2)`` matches only if the following happens:" msgstr "" -#: reference/compound_stmts.rst:1170 +#: reference/compound_stmts.rst:1171 msgid "``isinstance(, CLS)``" msgstr "" -#: reference/compound_stmts.rst:1171 +#: reference/compound_stmts.rst:1172 msgid "convert ``P1`` to a keyword pattern using ``CLS.__match_args__``" msgstr "" -#: reference/compound_stmts.rst:1172 +#: reference/compound_stmts.rst:1173 msgid "For each keyword argument ``attr=P2``:" msgstr "" -#: reference/compound_stmts.rst:1174 +#: reference/compound_stmts.rst:1175 msgid "``hasattr(, \"attr\")``" msgstr "" -#: reference/compound_stmts.rst:1175 +#: reference/compound_stmts.rst:1176 msgid "``P2`` matches ``.attr``" msgstr "" -#: reference/compound_stmts.rst:1177 +#: reference/compound_stmts.rst:1178 msgid "... and so on for the corresponding keyword argument/pattern pair." msgstr "" -#: reference/compound_stmts.rst:1192 +#: reference/compound_stmts.rst:1193 msgid "Function definitions" msgstr "" -#: reference/compound_stmts.rst:1207 +#: reference/compound_stmts.rst:1208 msgid "" "A function definition defines a user-defined function object (see section :" "ref:`types`):" msgstr "" -#: reference/compound_stmts.rst:1226 +#: reference/compound_stmts.rst:1227 msgid "" "A function definition is an executable statement. Its execution binds the " "function name in the current local namespace to a function object (a wrapper " @@ -1355,13 +1363,13 @@ msgid "" "used when the function is called." msgstr "" -#: reference/compound_stmts.rst:1232 +#: reference/compound_stmts.rst:1233 msgid "" "The function definition does not execute the function body; this gets " "executed only when the function is called. [#]_" msgstr "" -#: reference/compound_stmts.rst:1238 +#: reference/compound_stmts.rst:1239 msgid "" "A function definition may be wrapped by one or more :term:`decorator` " "expressions. Decorator expressions are evaluated when the function is " @@ -1372,24 +1380,24 @@ msgid "" "example, the following code ::" msgstr "" -#: reference/compound_stmts.rst:1249 reference/compound_stmts.rst:1439 +#: reference/compound_stmts.rst:1250 reference/compound_stmts.rst:1440 msgid "is roughly equivalent to ::" msgstr "" -#: reference/compound_stmts.rst:1254 +#: reference/compound_stmts.rst:1255 msgid "" "except that the original function is not temporarily bound to the name " "``func``." msgstr "" -#: reference/compound_stmts.rst:1256 +#: reference/compound_stmts.rst:1257 msgid "" "Functions may be decorated with any valid :token:`~python-grammar:" "assignment_expression`. Previously, the grammar was much more restrictive; " "see :pep:`614` for details." msgstr "" -#: reference/compound_stmts.rst:1261 +#: reference/compound_stmts.rst:1262 msgid "" "A list of :ref:`type parameters ` may be given in square " "brackets between the function's name and the opening parenthesis for its " @@ -1399,11 +1407,11 @@ msgid "" "functions` for more." msgstr "" -#: reference/compound_stmts.rst:1268 reference/compound_stmts.rst:1458 +#: reference/compound_stmts.rst:1269 reference/compound_stmts.rst:1459 msgid "Type parameter lists are new in Python 3.12." msgstr "" -#: reference/compound_stmts.rst:1276 +#: reference/compound_stmts.rst:1277 msgid "" "When one or more :term:`parameters ` have the form *parameter* " "``=`` *expression*, the function is said to have \"default parameter values." @@ -1414,7 +1422,7 @@ msgid "" "syntactic restriction that is not expressed by the grammar." msgstr "" -#: reference/compound_stmts.rst:1284 +#: reference/compound_stmts.rst:1285 msgid "" "**Default parameter values are evaluated from left to right when the " "function definition is executed.** This means that the expression is " @@ -1427,7 +1435,7 @@ msgid "" "the default, and explicitly test for it in the body of the function, e.g.::" msgstr "" -#: reference/compound_stmts.rst:1305 +#: reference/compound_stmts.rst:1306 msgid "" "Function call semantics are described in more detail in section :ref:" "`calls`. A function call always assigns values to all parameters mentioned " @@ -1443,13 +1451,13 @@ msgid "" "positional arguments." msgstr "" -#: reference/compound_stmts.rst:1317 +#: reference/compound_stmts.rst:1318 msgid "" "The ``/`` function parameter syntax may be used to indicate positional-only " "parameters. See :pep:`570` for details." msgstr "" -#: reference/compound_stmts.rst:1326 +#: reference/compound_stmts.rst:1327 msgid "" "Parameters may have an :term:`annotation ` of the form " "\"``: expression``\" following the parameter name. Any parameter may have " @@ -1466,7 +1474,7 @@ msgid "" "different order than they appear in the source code." msgstr "" -#: reference/compound_stmts.rst:1341 +#: reference/compound_stmts.rst:1342 msgid "" "It is also possible to create anonymous functions (functions not bound to a " "name), for immediate use in expressions. This uses lambda expressions, " @@ -1478,7 +1486,7 @@ msgid "" "execution of multiple statements and annotations." msgstr "" -#: reference/compound_stmts.rst:1349 +#: reference/compound_stmts.rst:1350 msgid "" "**Programmer's note:** Functions are first-class objects. A \"``def``\" " "statement executed inside a function definition defines a local function " @@ -1487,61 +1495,61 @@ msgid "" "See section :ref:`naming` for details." msgstr "" -#: reference/compound_stmts.rst:1357 +#: reference/compound_stmts.rst:1358 msgid ":pep:`3107` - Function Annotations" msgstr "" -#: reference/compound_stmts.rst:1358 +#: reference/compound_stmts.rst:1359 msgid "The original specification for function annotations." msgstr "" -#: reference/compound_stmts.rst:1360 +#: reference/compound_stmts.rst:1361 msgid ":pep:`484` - Type Hints" msgstr "" -#: reference/compound_stmts.rst:1361 +#: reference/compound_stmts.rst:1362 msgid "Definition of a standard meaning for annotations: type hints." msgstr "" -#: reference/compound_stmts.rst:1363 +#: reference/compound_stmts.rst:1364 msgid ":pep:`526` - Syntax for Variable Annotations" msgstr "" -#: reference/compound_stmts.rst:1364 +#: reference/compound_stmts.rst:1365 msgid "" "Ability to type hint variable declarations, including class variables and " "instance variables." msgstr "" -#: reference/compound_stmts.rst:1367 +#: reference/compound_stmts.rst:1368 msgid ":pep:`563` - Postponed Evaluation of Annotations" msgstr "" -#: reference/compound_stmts.rst:1368 +#: reference/compound_stmts.rst:1369 msgid "" "Support for forward references within annotations by preserving annotations " "in a string form at runtime instead of eager evaluation." msgstr "" -#: reference/compound_stmts.rst:1371 +#: reference/compound_stmts.rst:1372 msgid ":pep:`318` - Decorators for Functions and Methods" msgstr "" -#: reference/compound_stmts.rst:1372 +#: reference/compound_stmts.rst:1373 msgid "" "Function and method decorators were introduced. Class decorators were " "introduced in :pep:`3129`." msgstr "" -#: reference/compound_stmts.rst:1378 +#: reference/compound_stmts.rst:1379 msgid "Class definitions" msgstr "" -#: reference/compound_stmts.rst:1393 +#: reference/compound_stmts.rst:1394 msgid "A class definition defines a class object (see section :ref:`types`):" msgstr "" -#: reference/compound_stmts.rst:1400 +#: reference/compound_stmts.rst:1401 msgid "" "A class definition is an executable statement. The inheritance list usually " "gives a list of base classes (see :ref:`metaclasses` for more advanced " @@ -1550,11 +1558,11 @@ msgid "" "default, from the base class :class:`object`; hence, ::" msgstr "" -#: reference/compound_stmts.rst:1409 +#: reference/compound_stmts.rst:1410 msgid "is equivalent to ::" msgstr "" -#: reference/compound_stmts.rst:1414 +#: reference/compound_stmts.rst:1415 msgid "" "The class's suite is then executed in a new execution frame (see :ref:" "`naming`), using a newly created local namespace and the original global " @@ -1566,7 +1574,7 @@ msgid "" "original local namespace." msgstr "" -#: reference/compound_stmts.rst:1423 +#: reference/compound_stmts.rst:1424 msgid "" "The order in which attributes are defined in the class body is preserved in " "the new class's ``__dict__``. Note that this is reliable only right after " @@ -1574,30 +1582,30 @@ msgid "" "definition syntax." msgstr "" -#: reference/compound_stmts.rst:1428 +#: reference/compound_stmts.rst:1429 msgid "" "Class creation can be customized heavily using :ref:`metaclasses " "`." msgstr "" -#: reference/compound_stmts.rst:1433 +#: reference/compound_stmts.rst:1434 msgid "Classes can also be decorated: just like when decorating functions, ::" msgstr "" -#: reference/compound_stmts.rst:1444 +#: reference/compound_stmts.rst:1445 msgid "" "The evaluation rules for the decorator expressions are the same as for " "function decorators. The result is then bound to the class name." msgstr "" -#: reference/compound_stmts.rst:1447 +#: reference/compound_stmts.rst:1448 msgid "" "Classes may be decorated with any valid :token:`~python-grammar:" "assignment_expression`. Previously, the grammar was much more restrictive; " "see :pep:`614` for details." msgstr "" -#: reference/compound_stmts.rst:1452 +#: reference/compound_stmts.rst:1453 msgid "" "A list of :ref:`type parameters ` may be given in square " "brackets immediately after the class's name. This indicates to static type " @@ -1606,7 +1614,7 @@ msgid "" "classes` for more." msgstr "" -#: reference/compound_stmts.rst:1461 +#: reference/compound_stmts.rst:1462 msgid "" "**Programmer's note:** Variables defined in the class definition are class " "attributes; they are shared by instances. Instance attributes can be set in " @@ -1619,35 +1627,35 @@ msgid "" "implementation details." msgstr "" -#: reference/compound_stmts.rst:1473 +#: reference/compound_stmts.rst:1474 msgid ":pep:`3115` - Metaclasses in Python 3000" msgstr "" -#: reference/compound_stmts.rst:1474 +#: reference/compound_stmts.rst:1475 msgid "" "The proposal that changed the declaration of metaclasses to the current " "syntax, and the semantics for how classes with metaclasses are constructed." msgstr "" -#: reference/compound_stmts.rst:1478 +#: reference/compound_stmts.rst:1479 msgid ":pep:`3129` - Class Decorators" msgstr "" -#: reference/compound_stmts.rst:1479 +#: reference/compound_stmts.rst:1480 msgid "" "The proposal that added class decorators. Function and method decorators " "were introduced in :pep:`318`." msgstr "" -#: reference/compound_stmts.rst:1486 +#: reference/compound_stmts.rst:1487 msgid "Coroutines" msgstr "" -#: reference/compound_stmts.rst:1494 +#: reference/compound_stmts.rst:1495 msgid "Coroutine function definition" msgstr "" -#: reference/compound_stmts.rst:1504 +#: reference/compound_stmts.rst:1505 msgid "" "Execution of Python coroutines can be suspended and resumed at many points " "(see :term:`coroutine`). :keyword:`await` expressions, :keyword:`async for` " @@ -1655,104 +1663,104 @@ msgid "" "function." msgstr "" -#: reference/compound_stmts.rst:1508 +#: reference/compound_stmts.rst:1509 msgid "" "Functions defined with ``async def`` syntax are always coroutine functions, " "even if they do not contain ``await`` or ``async`` keywords." msgstr "" -#: reference/compound_stmts.rst:1511 +#: reference/compound_stmts.rst:1512 msgid "" "It is a :exc:`SyntaxError` to use a ``yield from`` expression inside the " "body of a coroutine function." msgstr "" -#: reference/compound_stmts.rst:1514 +#: reference/compound_stmts.rst:1515 msgid "An example of a coroutine function::" msgstr "" -#: reference/compound_stmts.rst:1520 +#: reference/compound_stmts.rst:1521 msgid "" "``await`` and ``async`` are now keywords; previously they were only treated " "as such inside the body of a coroutine function." msgstr "" -#: reference/compound_stmts.rst:1528 +#: reference/compound_stmts.rst:1529 msgid "The :keyword:`!async for` statement" msgstr "" -#: reference/compound_stmts.rst:1533 +#: reference/compound_stmts.rst:1534 msgid "" "An :term:`asynchronous iterable` provides an ``__aiter__`` method that " "directly returns an :term:`asynchronous iterator`, which can call " "asynchronous code in its ``__anext__`` method." msgstr "" -#: reference/compound_stmts.rst:1537 +#: reference/compound_stmts.rst:1538 msgid "" "The ``async for`` statement allows convenient iteration over asynchronous " "iterables." msgstr "" -#: reference/compound_stmts.rst:1547 +#: reference/compound_stmts.rst:1548 msgid "Is semantically equivalent to::" msgstr "" -#: reference/compound_stmts.rst:1563 +#: reference/compound_stmts.rst:1564 msgid "" "See also :meth:`~object.__aiter__` and :meth:`~object.__anext__` for details." msgstr "" -#: reference/compound_stmts.rst:1565 +#: reference/compound_stmts.rst:1566 msgid "" "It is a :exc:`SyntaxError` to use an ``async for`` statement outside the " "body of a coroutine function." msgstr "" -#: reference/compound_stmts.rst:1573 +#: reference/compound_stmts.rst:1574 msgid "The :keyword:`!async with` statement" msgstr "" -#: reference/compound_stmts.rst:1578 +#: reference/compound_stmts.rst:1579 msgid "" "An :term:`asynchronous context manager` is a :term:`context manager` that is " "able to suspend execution in its *enter* and *exit* methods." msgstr "" -#: reference/compound_stmts.rst:1605 +#: reference/compound_stmts.rst:1606 msgid "" "See also :meth:`~object.__aenter__` and :meth:`~object.__aexit__` for " "details." msgstr "" -#: reference/compound_stmts.rst:1607 +#: reference/compound_stmts.rst:1608 msgid "" "It is a :exc:`SyntaxError` to use an ``async with`` statement outside the " "body of a coroutine function." msgstr "" -#: reference/compound_stmts.rst:1612 +#: reference/compound_stmts.rst:1613 msgid ":pep:`492` - Coroutines with async and await syntax" msgstr "" -#: reference/compound_stmts.rst:1613 +#: reference/compound_stmts.rst:1614 msgid "" "The proposal that made coroutines a proper standalone concept in Python, and " "added supporting syntax." msgstr "" -#: reference/compound_stmts.rst:1619 +#: reference/compound_stmts.rst:1620 msgid "Type parameter lists" msgstr "" -#: reference/compound_stmts.rst:1633 +#: reference/compound_stmts.rst:1634 msgid "" ":ref:`Functions ` (including :ref:`coroutines `), :ref:" "`classes ` and :ref:`type aliases ` may contain a type " "parameter list::" msgstr "" -#: reference/compound_stmts.rst:1652 +#: reference/compound_stmts.rst:1653 msgid "" "Semantically, this indicates that the function, class, or type alias is " "generic over a type variable. This information is primarily used by static " @@ -1760,7 +1768,7 @@ msgid "" "generic counterparts." msgstr "" -#: reference/compound_stmts.rst:1657 +#: reference/compound_stmts.rst:1658 msgid "" "Type parameters are declared in square brackets (``[]``) immediately after " "the name of the function, class, or type alias. The type parameters are " @@ -1772,36 +1780,36 @@ msgid "" "wraps the creation of the generic object." msgstr "" -#: reference/compound_stmts.rst:1666 +#: reference/compound_stmts.rst:1667 msgid "" "Generic functions, classes, and type aliases have a :attr:`!__type_params__` " "attribute listing their type parameters." msgstr "" -#: reference/compound_stmts.rst:1669 +#: reference/compound_stmts.rst:1670 msgid "Type parameters come in three kinds:" msgstr "" -#: reference/compound_stmts.rst:1671 +#: reference/compound_stmts.rst:1672 msgid "" ":data:`typing.TypeVar`, introduced by a plain name (e.g., ``T``). " "Semantically, this represents a single type to a type checker." msgstr "" -#: reference/compound_stmts.rst:1673 +#: reference/compound_stmts.rst:1674 msgid "" ":data:`typing.TypeVarTuple`, introduced by a name prefixed with a single " "asterisk (e.g., ``*Ts``). Semantically, this stands for a tuple of any " "number of types." msgstr "" -#: reference/compound_stmts.rst:1676 +#: reference/compound_stmts.rst:1677 msgid "" ":data:`typing.ParamSpec`, introduced by a name prefixed with two asterisks " "(e.g., ``**P``). Semantically, this stands for the parameters of a callable." msgstr "" -#: reference/compound_stmts.rst:1679 +#: reference/compound_stmts.rst:1680 msgid "" ":data:`typing.TypeVar` declarations can define *bounds* and *constraints* " "with a colon (``:``) followed by an expression. A single expression after " @@ -1813,7 +1821,7 @@ msgid "" "variables can only take on one of the types in the list of constraints." msgstr "" -#: reference/compound_stmts.rst:1688 +#: reference/compound_stmts.rst:1689 msgid "" "For :data:`!typing.TypeVar`\\ s declared using the type parameter list " "syntax, the bound and constraints are not evaluated when the generic object " @@ -1823,31 +1831,31 @@ msgid "" "`." msgstr "" -#: reference/compound_stmts.rst:1694 +#: reference/compound_stmts.rst:1695 msgid "" ":data:`typing.TypeVarTuple`\\ s and :data:`typing.ParamSpec`\\ s cannot have " "bounds or constraints." msgstr "" -#: reference/compound_stmts.rst:1697 +#: reference/compound_stmts.rst:1698 msgid "" "The following example indicates the full set of allowed type parameter " "declarations::" msgstr "" -#: reference/compound_stmts.rst:1715 +#: reference/compound_stmts.rst:1716 msgid "Generic functions" msgstr "" -#: reference/compound_stmts.rst:1717 +#: reference/compound_stmts.rst:1718 msgid "Generic functions are declared as follows::" msgstr "" -#: reference/compound_stmts.rst:1721 reference/compound_stmts.rst:1781 +#: reference/compound_stmts.rst:1722 reference/compound_stmts.rst:1782 msgid "This syntax is equivalent to::" msgstr "" -#: reference/compound_stmts.rst:1730 +#: reference/compound_stmts.rst:1731 msgid "" "Here ``annotation-def`` indicates an :ref:`annotation scope `, which is not actually bound to any name at runtime. (One other " @@ -1856,47 +1864,47 @@ msgid "" "data:`typing.TypeVar` directly.)" msgstr "" -#: reference/compound_stmts.rst:1736 +#: reference/compound_stmts.rst:1737 msgid "" "The annotations of generic functions are evaluated within the annotation " "scope used for declaring the type parameters, but the function's defaults " "and decorators are not." msgstr "" -#: reference/compound_stmts.rst:1740 +#: reference/compound_stmts.rst:1741 msgid "" "The following example illustrates the scoping rules for these cases, as well " "as for additional flavors of type parameters::" msgstr "" -#: reference/compound_stmts.rst:1747 +#: reference/compound_stmts.rst:1748 msgid "" "Except for the :ref:`lazy evaluation ` of the :class:" "`~typing.TypeVar` bound, this is equivalent to::" msgstr "" -#: reference/compound_stmts.rst:1769 +#: reference/compound_stmts.rst:1770 msgid "" "The capitalized names like ``DEFAULT_OF_arg`` are not actually bound at " "runtime." msgstr "" -#: reference/compound_stmts.rst:1775 +#: reference/compound_stmts.rst:1776 msgid "Generic classes" msgstr "" -#: reference/compound_stmts.rst:1777 +#: reference/compound_stmts.rst:1778 msgid "Generic classes are declared as follows::" msgstr "" -#: reference/compound_stmts.rst:1791 +#: reference/compound_stmts.rst:1792 msgid "" "Here again ``annotation-def`` (not a real keyword) indicates an :ref:" "`annotation scope `, and the name ``TYPE_PARAMS_OF_Bag`` " "is not actually bound at runtime." msgstr "" -#: reference/compound_stmts.rst:1795 +#: reference/compound_stmts.rst:1796 msgid "" "Generic classes implicitly inherit from :data:`typing.Generic`. The base " "classes and keyword arguments of generic classes are evaluated within the " @@ -1904,124 +1912,124 @@ msgid "" "that scope. This is illustrated by this example::" msgstr "" -#: reference/compound_stmts.rst:1804 +#: reference/compound_stmts.rst:1805 msgid "This is equivalent to::" msgstr "" -#: reference/compound_stmts.rst:1817 +#: reference/compound_stmts.rst:1818 msgid "Generic type aliases" msgstr "" -#: reference/compound_stmts.rst:1819 +#: reference/compound_stmts.rst:1820 msgid "" "The :keyword:`type` statement can also be used to create a generic type " "alias::" msgstr "" -#: reference/compound_stmts.rst:1823 +#: reference/compound_stmts.rst:1824 msgid "" "Except for the :ref:`lazy evaluation ` of the value, this " "is equivalent to::" msgstr "" -#: reference/compound_stmts.rst:1835 +#: reference/compound_stmts.rst:1836 msgid "" "Here, ``annotation-def`` (not a real keyword) indicates an :ref:`annotation " "scope `. The capitalized names like " "``TYPE_PARAMS_OF_ListOrSet`` are not actually bound at runtime." msgstr "" -#: reference/compound_stmts.rst:1840 +#: reference/compound_stmts.rst:1841 msgid "Footnotes" msgstr "" -#: reference/compound_stmts.rst:1841 +#: reference/compound_stmts.rst:1842 msgid "" "The exception is propagated to the invocation stack unless there is a :" "keyword:`finally` clause which happens to raise another exception. That new " "exception causes the old one to be lost." msgstr "" -#: reference/compound_stmts.rst:1845 +#: reference/compound_stmts.rst:1846 msgid "In pattern matching, a sequence is defined as one of the following:" msgstr "" -#: reference/compound_stmts.rst:1847 +#: reference/compound_stmts.rst:1848 msgid "a class that inherits from :class:`collections.abc.Sequence`" msgstr "" -#: reference/compound_stmts.rst:1848 +#: reference/compound_stmts.rst:1849 msgid "" "a Python class that has been registered as :class:`collections.abc.Sequence`" msgstr "" -#: reference/compound_stmts.rst:1849 +#: reference/compound_stmts.rst:1850 msgid "" "a builtin class that has its (CPython) :c:macro:`Py_TPFLAGS_SEQUENCE` bit set" msgstr "" -#: reference/compound_stmts.rst:1850 reference/compound_stmts.rst:1869 +#: reference/compound_stmts.rst:1851 reference/compound_stmts.rst:1870 msgid "a class that inherits from any of the above" msgstr "" -#: reference/compound_stmts.rst:1852 +#: reference/compound_stmts.rst:1853 msgid "The following standard library classes are sequences:" msgstr "" -#: reference/compound_stmts.rst:1854 +#: reference/compound_stmts.rst:1855 msgid ":class:`array.array`" msgstr "" -#: reference/compound_stmts.rst:1855 +#: reference/compound_stmts.rst:1856 msgid ":class:`collections.deque`" msgstr "" -#: reference/compound_stmts.rst:1857 +#: reference/compound_stmts.rst:1858 msgid ":class:`memoryview`" msgstr "" -#: reference/compound_stmts.rst:1858 +#: reference/compound_stmts.rst:1859 msgid ":class:`range`" msgstr "" -#: reference/compound_stmts.rst:1861 +#: reference/compound_stmts.rst:1862 msgid "" "Subject values of type ``str``, ``bytes``, and ``bytearray`` do not match " "sequence patterns." msgstr "" -#: reference/compound_stmts.rst:1864 +#: reference/compound_stmts.rst:1865 msgid "In pattern matching, a mapping is defined as one of the following:" msgstr "" -#: reference/compound_stmts.rst:1866 +#: reference/compound_stmts.rst:1867 msgid "a class that inherits from :class:`collections.abc.Mapping`" msgstr "" -#: reference/compound_stmts.rst:1867 +#: reference/compound_stmts.rst:1868 msgid "" "a Python class that has been registered as :class:`collections.abc.Mapping`" msgstr "" -#: reference/compound_stmts.rst:1868 +#: reference/compound_stmts.rst:1869 msgid "" "a builtin class that has its (CPython) :c:macro:`Py_TPFLAGS_MAPPING` bit set" msgstr "" -#: reference/compound_stmts.rst:1871 +#: reference/compound_stmts.rst:1872 msgid "" "The standard library classes :class:`dict` and :class:`types." "MappingProxyType` are mappings." msgstr "" -#: reference/compound_stmts.rst:1874 +#: reference/compound_stmts.rst:1875 msgid "" "A string literal appearing as the first statement in the function body is " "transformed into the function's :attr:`~function.__doc__` attribute and " "therefore the function's :term:`docstring`." msgstr "" -#: reference/compound_stmts.rst:1878 +#: reference/compound_stmts.rst:1879 msgid "" "A string literal appearing as the first statement in the class body is " "transformed into the namespace's ``__doc__`` item and therefore the class's :" @@ -2035,11 +2043,11 @@ msgstr "" #: reference/compound_stmts.rst:86 reference/compound_stmts.rst:111 #: reference/compound_stmts.rst:129 reference/compound_stmts.rst:144 #: reference/compound_stmts.rst:169 reference/compound_stmts.rst:207 -#: reference/compound_stmts.rst:389 reference/compound_stmts.rst:436 -#: reference/compound_stmts.rst:470 reference/compound_stmts.rst:587 -#: reference/compound_stmts.rst:1194 reference/compound_stmts.rst:1380 -#: reference/compound_stmts.rst:1490 reference/compound_stmts.rst:1524 -#: reference/compound_stmts.rst:1569 +#: reference/compound_stmts.rst:390 reference/compound_stmts.rst:437 +#: reference/compound_stmts.rst:471 reference/compound_stmts.rst:588 +#: reference/compound_stmts.rst:1195 reference/compound_stmts.rst:1381 +#: reference/compound_stmts.rst:1491 reference/compound_stmts.rst:1525 +#: reference/compound_stmts.rst:1570 msgid "statement" msgstr "" @@ -2069,19 +2077,19 @@ msgstr "" #: reference/compound_stmts.rst:64 reference/compound_stmts.rst:86 #: reference/compound_stmts.rst:111 reference/compound_stmts.rst:144 -#: reference/compound_stmts.rst:207 reference/compound_stmts.rst:389 +#: reference/compound_stmts.rst:207 reference/compound_stmts.rst:390 msgid "else" msgstr "" -#: reference/compound_stmts.rst:86 reference/compound_stmts.rst:587 +#: reference/compound_stmts.rst:86 reference/compound_stmts.rst:588 msgid "if" msgstr "" #: reference/compound_stmts.rst:86 reference/compound_stmts.rst:111 #: reference/compound_stmts.rst:144 reference/compound_stmts.rst:207 -#: reference/compound_stmts.rst:328 reference/compound_stmts.rst:389 -#: reference/compound_stmts.rst:407 reference/compound_stmts.rst:470 -#: reference/compound_stmts.rst:587 reference/compound_stmts.rst:1500 +#: reference/compound_stmts.rst:327 reference/compound_stmts.rst:390 +#: reference/compound_stmts.rst:408 reference/compound_stmts.rst:471 +#: reference/compound_stmts.rst:588 reference/compound_stmts.rst:1501 msgid "keyword" msgstr "" @@ -2091,16 +2099,16 @@ msgstr "" #: reference/compound_stmts.rst:86 reference/compound_stmts.rst:111 #: reference/compound_stmts.rst:144 reference/compound_stmts.rst:207 -#: reference/compound_stmts.rst:470 reference/compound_stmts.rst:587 -#: reference/compound_stmts.rst:1194 reference/compound_stmts.rst:1321 -#: reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:471 reference/compound_stmts.rst:588 +#: reference/compound_stmts.rst:1195 reference/compound_stmts.rst:1322 +#: reference/compound_stmts.rst:1381 msgid ": (colon)" msgstr "" #: reference/compound_stmts.rst:86 reference/compound_stmts.rst:111 #: reference/compound_stmts.rst:144 reference/compound_stmts.rst:207 -#: reference/compound_stmts.rst:470 reference/compound_stmts.rst:587 -#: reference/compound_stmts.rst:1194 reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:471 reference/compound_stmts.rst:588 +#: reference/compound_stmts.rst:1195 reference/compound_stmts.rst:1381 msgid "compound statement" msgstr "" @@ -2113,12 +2121,12 @@ msgid "loop" msgstr "" #: reference/compound_stmts.rst:129 reference/compound_stmts.rst:169 -#: reference/compound_stmts.rst:389 reference/compound_stmts.rst:436 +#: reference/compound_stmts.rst:390 reference/compound_stmts.rst:437 msgid "break" msgstr "" #: reference/compound_stmts.rst:129 reference/compound_stmts.rst:169 -#: reference/compound_stmts.rst:389 reference/compound_stmts.rst:436 +#: reference/compound_stmts.rst:390 reference/compound_stmts.rst:437 msgid "continue" msgstr "" @@ -2138,8 +2146,8 @@ msgstr "" msgid "list" msgstr "" -#: reference/compound_stmts.rst:144 reference/compound_stmts.rst:299 -#: reference/compound_stmts.rst:1194 reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:144 reference/compound_stmts.rst:298 +#: reference/compound_stmts.rst:1195 reference/compound_stmts.rst:1381 msgid "object" msgstr "" @@ -2163,230 +2171,230 @@ msgstr "" msgid "except" msgstr "" -#: reference/compound_stmts.rst:207 reference/compound_stmts.rst:407 +#: reference/compound_stmts.rst:207 reference/compound_stmts.rst:408 msgid "finally" msgstr "" -#: reference/compound_stmts.rst:207 reference/compound_stmts.rst:266 -#: reference/compound_stmts.rst:470 reference/compound_stmts.rst:587 +#: reference/compound_stmts.rst:207 reference/compound_stmts.rst:265 +#: reference/compound_stmts.rst:471 reference/compound_stmts.rst:588 msgid "as" msgstr "" -#: reference/compound_stmts.rst:266 +#: reference/compound_stmts.rst:265 msgid "except clause" msgstr "" -#: reference/compound_stmts.rst:299 +#: reference/compound_stmts.rst:298 msgid "module" msgstr "" -#: reference/compound_stmts.rst:299 +#: reference/compound_stmts.rst:298 msgid "sys" msgstr "" -#: reference/compound_stmts.rst:299 +#: reference/compound_stmts.rst:298 msgid "traceback" msgstr "" -#: reference/compound_stmts.rst:328 +#: reference/compound_stmts.rst:327 msgid "except_star" msgstr "" -#: reference/compound_stmts.rst:389 reference/compound_stmts.rst:436 +#: reference/compound_stmts.rst:390 reference/compound_stmts.rst:437 msgid "return" msgstr "" -#: reference/compound_stmts.rst:470 +#: reference/compound_stmts.rst:471 msgid "with" msgstr "" -#: reference/compound_stmts.rst:470 +#: reference/compound_stmts.rst:471 msgid "with statement" msgstr "" -#: reference/compound_stmts.rst:470 reference/compound_stmts.rst:1194 -#: reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:471 reference/compound_stmts.rst:1195 +#: reference/compound_stmts.rst:1381 msgid ", (comma)" msgstr "" -#: reference/compound_stmts.rst:587 +#: reference/compound_stmts.rst:588 msgid "match" msgstr "" -#: reference/compound_stmts.rst:587 +#: reference/compound_stmts.rst:588 msgid "case" msgstr "" -#: reference/compound_stmts.rst:587 +#: reference/compound_stmts.rst:588 msgid "pattern matching" msgstr "" -#: reference/compound_stmts.rst:587 +#: reference/compound_stmts.rst:588 msgid "match statement" msgstr "" -#: reference/compound_stmts.rst:691 +#: reference/compound_stmts.rst:692 msgid "guard" msgstr "" -#: reference/compound_stmts.rst:730 +#: reference/compound_stmts.rst:731 msgid "irrefutable case block" msgstr "" -#: reference/compound_stmts.rst:730 +#: reference/compound_stmts.rst:731 msgid "case block" msgstr "" -#: reference/compound_stmts.rst:754 +#: reference/compound_stmts.rst:755 msgid "! patterns" msgstr "" -#: reference/compound_stmts.rst:754 +#: reference/compound_stmts.rst:755 msgid "AS pattern, OR pattern, capture pattern, wildcard pattern" msgstr "" -#: reference/compound_stmts.rst:1185 reference/compound_stmts.rst:1271 +#: reference/compound_stmts.rst:1186 reference/compound_stmts.rst:1272 msgid "parameter" msgstr "" -#: reference/compound_stmts.rst:1185 reference/compound_stmts.rst:1194 -#: reference/compound_stmts.rst:1235 reference/compound_stmts.rst:1271 -#: reference/compound_stmts.rst:1300 +#: reference/compound_stmts.rst:1186 reference/compound_stmts.rst:1195 +#: reference/compound_stmts.rst:1236 reference/compound_stmts.rst:1272 +#: reference/compound_stmts.rst:1301 msgid "function definition" msgstr "" -#: reference/compound_stmts.rst:1194 +#: reference/compound_stmts.rst:1195 msgid "def" msgstr "" -#: reference/compound_stmts.rst:1194 reference/compound_stmts.rst:1321 +#: reference/compound_stmts.rst:1195 reference/compound_stmts.rst:1322 msgid "function" msgstr "" -#: reference/compound_stmts.rst:1194 reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:1195 reference/compound_stmts.rst:1381 msgid "definition" msgstr "" -#: reference/compound_stmts.rst:1194 reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:1195 reference/compound_stmts.rst:1381 msgid "name" msgstr "" -#: reference/compound_stmts.rst:1194 reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:1195 reference/compound_stmts.rst:1381 msgid "binding" msgstr "" -#: reference/compound_stmts.rst:1194 +#: reference/compound_stmts.rst:1195 msgid "user-defined function" msgstr "" -#: reference/compound_stmts.rst:1194 reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:1195 reference/compound_stmts.rst:1381 msgid "() (parentheses)" msgstr "" -#: reference/compound_stmts.rst:1194 +#: reference/compound_stmts.rst:1195 msgid "parameter list" msgstr "" -#: reference/compound_stmts.rst:1235 reference/compound_stmts.rst:1430 +#: reference/compound_stmts.rst:1236 reference/compound_stmts.rst:1431 msgid "@ (at)" msgstr "" -#: reference/compound_stmts.rst:1271 +#: reference/compound_stmts.rst:1272 msgid "default" msgstr "" -#: reference/compound_stmts.rst:1271 +#: reference/compound_stmts.rst:1272 msgid "value" msgstr "" -#: reference/compound_stmts.rst:1271 +#: reference/compound_stmts.rst:1272 msgid "argument" msgstr "" -#: reference/compound_stmts.rst:1271 +#: reference/compound_stmts.rst:1272 msgid "= (equals)" msgstr "" -#: reference/compound_stmts.rst:1300 +#: reference/compound_stmts.rst:1301 msgid "/ (slash)" msgstr "" -#: reference/compound_stmts.rst:1300 +#: reference/compound_stmts.rst:1301 msgid "* (asterisk)" msgstr "" -#: reference/compound_stmts.rst:1300 +#: reference/compound_stmts.rst:1301 msgid "**" msgstr "" -#: reference/compound_stmts.rst:1321 +#: reference/compound_stmts.rst:1322 msgid "annotations" msgstr "" -#: reference/compound_stmts.rst:1321 +#: reference/compound_stmts.rst:1322 msgid "->" msgstr "" -#: reference/compound_stmts.rst:1321 +#: reference/compound_stmts.rst:1322 msgid "function annotations" msgstr "" -#: reference/compound_stmts.rst:1339 +#: reference/compound_stmts.rst:1340 msgid "lambda" msgstr "" -#: reference/compound_stmts.rst:1339 +#: reference/compound_stmts.rst:1340 msgid "expression" msgstr "" -#: reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:1381 msgid "class" msgstr "" -#: reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:1381 msgid "execution" msgstr "" -#: reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:1381 msgid "frame" msgstr "" -#: reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:1381 msgid "inheritance" msgstr "" -#: reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:1381 msgid "docstring" msgstr "" -#: reference/compound_stmts.rst:1380 reference/compound_stmts.rst:1430 +#: reference/compound_stmts.rst:1381 reference/compound_stmts.rst:1431 msgid "class definition" msgstr "" -#: reference/compound_stmts.rst:1380 +#: reference/compound_stmts.rst:1381 msgid "expression list" msgstr "" -#: reference/compound_stmts.rst:1490 +#: reference/compound_stmts.rst:1491 msgid "async def" msgstr "" -#: reference/compound_stmts.rst:1500 +#: reference/compound_stmts.rst:1501 msgid "async" msgstr "" -#: reference/compound_stmts.rst:1500 +#: reference/compound_stmts.rst:1501 msgid "await" msgstr "" -#: reference/compound_stmts.rst:1524 +#: reference/compound_stmts.rst:1525 msgid "async for" msgstr "" -#: reference/compound_stmts.rst:1569 +#: reference/compound_stmts.rst:1570 msgid "async with" msgstr "" -#: reference/compound_stmts.rst:1623 +#: reference/compound_stmts.rst:1624 msgid "type parameters" msgstr "" diff --git a/reference/datamodel.po b/reference/datamodel.po index bd9b0ec52..06b6a9654 100644 --- a/reference/datamodel.po +++ b/reference/datamodel.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -252,7 +252,7 @@ msgstr "" #: reference/datamodel.rst:218 msgid "" -"Python distinguishes between integers, floating point numbers, and complex " +"Python distinguishes between integers, floating-point numbers, and complex " "numbers:" msgstr "" @@ -310,13 +310,13 @@ msgstr "" #: reference/datamodel.rst:267 msgid "" -"These represent machine-level double precision floating point numbers. You " +"These represent machine-level double precision floating-point numbers. You " "are at the mercy of the underlying machine architecture (and C or Java " "implementation) for the accepted range and handling of overflow. Python does " -"not support single-precision floating point numbers; the savings in " +"not support single-precision floating-point numbers; the savings in " "processor and memory usage that are usually the reason for using these are " "dwarfed by the overhead of using objects in Python, so there is no reason to " -"complicate the language with two kinds of floating point numbers." +"complicate the language with two kinds of floating-point numbers." msgstr "" #: reference/datamodel.rst:277 @@ -326,7 +326,7 @@ msgstr "" #: reference/datamodel.rst:283 msgid "" "These represent complex numbers as a pair of machine-level double precision " -"floating point numbers. The same caveats apply as for floating point " +"floating-point numbers. The same caveats apply as for floating-point " "numbers. The real and imaginary parts of a complex number ``z`` can be " "retrieved through the read-only attributes ``z.real`` and ``z.imag``." msgstr "" @@ -599,7 +599,7 @@ msgid "" "containing the same number of items as the function's formal parameter list." msgstr "" -#: reference/datamodel.rst:1127 reference/datamodel.rst:1322 +#: reference/datamodel.rst:1120 reference/datamodel.rst:1315 msgid "Special read-only attributes" msgstr "" @@ -630,7 +630,7 @@ msgid "" "the value of the cell, as well as set the value." msgstr "" -#: reference/datamodel.rst:1359 +#: reference/datamodel.rst:1352 msgid "Special writable attributes" msgstr "" @@ -732,7 +732,7 @@ msgid "" "callable object (normally a user-defined function)." msgstr "" -#: reference/datamodel.rst:1450 +#: reference/datamodel.rst:1443 msgid "Special read-only attributes:" msgstr "" @@ -816,22 +816,16 @@ msgstr "" #: reference/datamodel.rst:730 msgid "" -"Note that the transformation from :ref:`function object ` to instance method object happens each time the attribute is " -"retrieved from the instance. In some cases, a fruitful optimization is to " -"assign the attribute to a local variable and call that local variable. Also " -"notice that this transformation only happens for user-defined functions; " -"other callable objects (and all non-callable objects) are retrieved without " -"transformation. It is also important to note that user-defined functions " -"which are attributes of a class instance are not converted to bound methods; " -"this *only* happens when the function is an attribute of the class." +"It is important to note that user-defined functions which are attributes of " +"a class instance are not converted to bound methods; this *only* happens " +"when the function is an attribute of the class." msgstr "" -#: reference/datamodel.rst:744 +#: reference/datamodel.rst:737 msgid "Generator functions" msgstr "" -#: reference/datamodel.rst:750 +#: reference/datamodel.rst:743 msgid "" "A function or method which uses the :keyword:`yield` statement (see section :" "ref:`yield`) is called a :dfn:`generator function`. Such a function, when " @@ -844,11 +838,11 @@ msgid "" "values to be returned." msgstr "" -#: reference/datamodel.rst:762 +#: reference/datamodel.rst:755 msgid "Coroutine functions" msgstr "" -#: reference/datamodel.rst:767 +#: reference/datamodel.rst:760 msgid "" "A function or method which is defined using :keyword:`async def` is called " "a :dfn:`coroutine function`. Such a function, when called, returns a :term:" @@ -857,11 +851,11 @@ msgid "" "ref:`coroutine-objects` section." msgstr "" -#: reference/datamodel.rst:775 +#: reference/datamodel.rst:768 msgid "Asynchronous generator functions" msgstr "" -#: reference/datamodel.rst:781 +#: reference/datamodel.rst:774 msgid "" "A function or method which is defined using :keyword:`async def` and which " "uses the :keyword:`yield` statement is called a :dfn:`asynchronous generator " @@ -870,7 +864,7 @@ msgid "" "execute the body of the function." msgstr "" -#: reference/datamodel.rst:787 +#: reference/datamodel.rst:780 msgid "" "Calling the asynchronous iterator's :meth:`aiterator.__anext__ ` method will return an :term:`awaitable` which when awaited will " @@ -881,11 +875,11 @@ msgid "" "yielded." msgstr "" -#: reference/datamodel.rst:800 +#: reference/datamodel.rst:793 msgid "Built-in functions" msgstr "" -#: reference/datamodel.rst:807 +#: reference/datamodel.rst:800 msgid "" "A built-in function object is a wrapper around a C function. Examples of " "built-in functions are :func:`len` and :func:`math.sin` (:mod:`math` is a " @@ -893,32 +887,32 @@ msgid "" "determined by the C function. Special read-only attributes:" msgstr "" -#: reference/datamodel.rst:812 +#: reference/datamodel.rst:805 msgid "" ":attr:`!__doc__` is the function's documentation string, or ``None`` if " "unavailable. See :attr:`function.__doc__`." msgstr "" -#: reference/datamodel.rst:814 +#: reference/datamodel.rst:807 msgid "" ":attr:`!__name__` is the function's name. See :attr:`function.__name__`." msgstr "" -#: reference/datamodel.rst:815 +#: reference/datamodel.rst:808 msgid ":attr:`!__self__` is set to ``None`` (but see the next item)." msgstr "" -#: reference/datamodel.rst:816 +#: reference/datamodel.rst:809 msgid "" ":attr:`!__module__` is the name of the module the function was defined in or " "``None`` if unavailable. See :attr:`function.__module__`." msgstr "" -#: reference/datamodel.rst:824 +#: reference/datamodel.rst:817 msgid "Built-in methods" msgstr "" -#: reference/datamodel.rst:831 +#: reference/datamodel.rst:824 msgid "" "This is really a different disguise of a built-in function, this time " "containing an object passed to the C function as an implicit extra " @@ -929,11 +923,11 @@ msgid "" "__self__>`.)" msgstr "" -#: reference/datamodel.rst:840 +#: reference/datamodel.rst:833 msgid "Classes" msgstr "" -#: reference/datamodel.rst:842 +#: reference/datamodel.rst:835 msgid "" "Classes are callable. These objects normally act as factories for new " "instances of themselves, but variations are possible for class types that " @@ -942,21 +936,21 @@ msgid "" "initialize the new instance." msgstr "" -#: reference/datamodel.rst:850 +#: reference/datamodel.rst:843 msgid "Class Instances" msgstr "" -#: reference/datamodel.rst:852 +#: reference/datamodel.rst:845 msgid "" "Instances of arbitrary classes can be made callable by defining a :meth:" "`~object.__call__` method in their class." msgstr "" -#: reference/datamodel.rst:857 +#: reference/datamodel.rst:850 msgid "Modules" msgstr "" -#: reference/datamodel.rst:863 +#: reference/datamodel.rst:856 msgid "" "Modules are a basic organizational unit of Python code, and are created by " "the :ref:`import system ` as invoked either by the :keyword:" @@ -971,37 +965,37 @@ msgid "" "done)." msgstr "" -#: reference/datamodel.rst:876 +#: reference/datamodel.rst:869 msgid "" "Attribute assignment updates the module's namespace dictionary, e.g., ``m.x " "= 1`` is equivalent to ``m.__dict__[\"x\"] = 1``." msgstr "" -#: reference/datamodel.rst:886 +#: reference/datamodel.rst:879 msgid "Predefined (writable) attributes:" msgstr "" -#: reference/datamodel.rst:888 +#: reference/datamodel.rst:881 msgid ":attr:`__name__`" msgstr "" -#: reference/datamodel.rst:889 +#: reference/datamodel.rst:882 msgid "The module's name." msgstr "" -#: reference/datamodel.rst:989 +#: reference/datamodel.rst:982 msgid ":attr:`__doc__`" msgstr "" -#: reference/datamodel.rst:892 +#: reference/datamodel.rst:885 msgid "The module's documentation string, or ``None`` if unavailable." msgstr "" -#: reference/datamodel.rst:895 +#: reference/datamodel.rst:888 msgid ":attr:`__file__`" msgstr "" -#: reference/datamodel.rst:896 +#: reference/datamodel.rst:889 msgid "" "The pathname of the file from which the module was loaded, if it was loaded " "from a file. The :attr:`__file__` attribute may be missing for certain types " @@ -1010,24 +1004,24 @@ msgid "" "library, it's the pathname of the shared library file." msgstr "" -#: reference/datamodel.rst:992 +#: reference/datamodel.rst:985 msgid ":attr:`__annotations__`" msgstr "" -#: reference/datamodel.rst:905 +#: reference/datamodel.rst:898 msgid "" "A dictionary containing :term:`variable annotations ` " "collected during module body execution. For best practices on working with :" "attr:`__annotations__`, please see :ref:`annotations-howto`." msgstr "" -#: reference/datamodel.rst:912 +#: reference/datamodel.rst:905 msgid "" "Special read-only attribute: :attr:`~object.__dict__` is the module's " "namespace as a dictionary object." msgstr "" -#: reference/datamodel.rst:917 +#: reference/datamodel.rst:910 msgid "" "Because of the way CPython clears module dictionaries, the module dictionary " "will be cleared when the module falls out of scope even if the dictionary " @@ -1035,11 +1029,11 @@ msgid "" "module around while using its dictionary directly." msgstr "" -#: reference/datamodel.rst:924 +#: reference/datamodel.rst:917 msgid "Custom classes" msgstr "" -#: reference/datamodel.rst:926 +#: reference/datamodel.rst:919 msgid "" "Custom class types are typically created by class definitions (see section :" "ref:`class`). A class has a namespace implemented by a dictionary object. " @@ -1054,7 +1048,7 @@ msgid "" "found at :ref:`python_2.3_mro`." msgstr "" -#: reference/datamodel.rst:947 +#: reference/datamodel.rst:940 msgid "" "When a class attribute reference (for class :class:`!C`, say) would yield a " "class method object, it is transformed into an instance method object whose :" @@ -1065,82 +1059,82 @@ msgid "" "contained in its :attr:`~object.__dict__`." msgstr "" -#: reference/datamodel.rst:958 +#: reference/datamodel.rst:951 msgid "" "Class attribute assignments update the class's dictionary, never the " "dictionary of a base class." msgstr "" -#: reference/datamodel.rst:963 +#: reference/datamodel.rst:956 msgid "" "A class object can be called (see above) to yield a class instance (see " "below)." msgstr "" -#: reference/datamodel.rst:974 +#: reference/datamodel.rst:967 msgid "Special attributes:" msgstr "" -#: reference/datamodel.rst:976 +#: reference/datamodel.rst:969 msgid ":attr:`~definition.__name__`" msgstr "" -#: reference/datamodel.rst:977 +#: reference/datamodel.rst:970 msgid "The class name." msgstr "" -#: reference/datamodel.rst:979 +#: reference/datamodel.rst:972 msgid ":attr:`__module__`" msgstr "" -#: reference/datamodel.rst:980 +#: reference/datamodel.rst:973 msgid "The name of the module in which the class was defined." msgstr "" -#: reference/datamodel.rst:982 +#: reference/datamodel.rst:975 msgid ":attr:`~object.__dict__`" msgstr "" -#: reference/datamodel.rst:983 +#: reference/datamodel.rst:976 msgid "The dictionary containing the class's namespace." msgstr "" -#: reference/datamodel.rst:985 +#: reference/datamodel.rst:978 msgid ":attr:`~class.__bases__`" msgstr "" -#: reference/datamodel.rst:986 +#: reference/datamodel.rst:979 msgid "" "A tuple containing the base classes, in the order of their occurrence in the " "base class list." msgstr "" -#: reference/datamodel.rst:990 +#: reference/datamodel.rst:983 msgid "The class's documentation string, or ``None`` if undefined." msgstr "" -#: reference/datamodel.rst:993 +#: reference/datamodel.rst:986 msgid "" "A dictionary containing :term:`variable annotations ` " "collected during class body execution. For best practices on working with :" "attr:`__annotations__`, please see :ref:`annotations-howto`." msgstr "" -#: reference/datamodel.rst:999 +#: reference/datamodel.rst:992 msgid ":attr:`__type_params__`" msgstr "" -#: reference/datamodel.rst:1000 +#: reference/datamodel.rst:993 msgid "" "A tuple containing the :ref:`type parameters ` of a :ref:" "`generic class `." msgstr "" -#: reference/datamodel.rst:1005 +#: reference/datamodel.rst:998 msgid "Class instances" msgstr "" -#: reference/datamodel.rst:1013 +#: reference/datamodel.rst:1006 msgid "" "A class instance is created by calling a class object (see above). A class " "instance has a namespace implemented as a dictionary which is the first " @@ -1157,7 +1151,7 @@ msgid "" "__getattr__` method, that is called to satisfy the lookup." msgstr "" -#: reference/datamodel.rst:1029 +#: reference/datamodel.rst:1022 msgid "" "Attribute assignments and deletions update the instance's dictionary, never " "a class's dictionary. If the class has a :meth:`~object.__setattr__` or :" @@ -1165,23 +1159,23 @@ msgid "" "instance dictionary directly." msgstr "" -#: reference/datamodel.rst:1039 +#: reference/datamodel.rst:1032 msgid "" "Class instances can pretend to be numbers, sequences, or mappings if they " "have methods with certain special names. See section :ref:`specialnames`." msgstr "" -#: reference/datamodel.rst:1046 +#: reference/datamodel.rst:1039 msgid "" "Special attributes: :attr:`~object.__dict__` is the attribute dictionary; :" "attr:`~instance.__class__` is the instance's class." msgstr "" -#: reference/datamodel.rst:1051 +#: reference/datamodel.rst:1044 msgid "I/O objects (also known as file objects)" msgstr "" -#: reference/datamodel.rst:1066 +#: reference/datamodel.rst:1059 msgid "" "A :term:`file object` represents an open file. Various shortcuts are " "available to create file objects: the :func:`open` built-in function, and " @@ -1190,7 +1184,7 @@ msgid "" "methods provided by extension modules)." msgstr "" -#: reference/datamodel.rst:1072 +#: reference/datamodel.rst:1065 msgid "" "The objects ``sys.stdin``, ``sys.stdout`` and ``sys.stderr`` are initialized " "to file objects corresponding to the interpreter's standard input, output " @@ -1198,22 +1192,22 @@ msgid "" "interface defined by the :class:`io.TextIOBase` abstract class." msgstr "" -#: reference/datamodel.rst:1080 +#: reference/datamodel.rst:1073 msgid "Internal types" msgstr "" -#: reference/datamodel.rst:1086 +#: reference/datamodel.rst:1079 msgid "" "A few types used internally by the interpreter are exposed to the user. " "Their definitions may change with future versions of the interpreter, but " "they are mentioned here for completeness." msgstr "" -#: reference/datamodel.rst:1094 +#: reference/datamodel.rst:1087 msgid "Code objects" msgstr "" -#: reference/datamodel.rst:1098 +#: reference/datamodel.rst:1091 msgid "" "Code objects represent *byte-compiled* executable Python code, or :term:" "`bytecode`. The difference between a code object and a function object is " @@ -1225,103 +1219,103 @@ msgid "" "no references (directly or indirectly) to mutable objects." msgstr "" -#: reference/datamodel.rst:1132 +#: reference/datamodel.rst:1125 msgid "The function name" msgstr "" -#: reference/datamodel.rst:1135 +#: reference/datamodel.rst:1128 msgid "The fully qualified function name" msgstr "" -#: reference/datamodel.rst:1140 +#: reference/datamodel.rst:1133 msgid "" "The total number of positional :term:`parameters ` (including " "positional-only parameters and parameters with default values) that the " "function has" msgstr "" -#: reference/datamodel.rst:1145 +#: reference/datamodel.rst:1138 msgid "" "The number of positional-only :term:`parameters ` (including " "arguments with default values) that the function has" msgstr "" -#: reference/datamodel.rst:1149 +#: reference/datamodel.rst:1142 msgid "" "The number of keyword-only :term:`parameters ` (including " "arguments with default values) that the function has" msgstr "" -#: reference/datamodel.rst:1153 +#: reference/datamodel.rst:1146 msgid "" "The number of :ref:`local variables ` used by the function " "(including parameters)" msgstr "" -#: reference/datamodel.rst:1157 +#: reference/datamodel.rst:1150 msgid "" "A :class:`tuple` containing the names of the local variables in the function " "(starting with the parameter names)" msgstr "" -#: reference/datamodel.rst:1161 +#: reference/datamodel.rst:1154 msgid "" "A :class:`tuple` containing the names of :ref:`local variables ` " "that are referenced by nested functions inside the function" msgstr "" -#: reference/datamodel.rst:1165 +#: reference/datamodel.rst:1158 msgid "A :class:`tuple` containing the names of free variables in the function" msgstr "" -#: reference/datamodel.rst:1168 +#: reference/datamodel.rst:1161 msgid "" "A string representing the sequence of :term:`bytecode` instructions in the " "function" msgstr "" -#: reference/datamodel.rst:1172 +#: reference/datamodel.rst:1165 msgid "" "A :class:`tuple` containing the literals used by the :term:`bytecode` in the " "function" msgstr "" -#: reference/datamodel.rst:1176 +#: reference/datamodel.rst:1169 msgid "" "A :class:`tuple` containing the names used by the :term:`bytecode` in the " "function" msgstr "" -#: reference/datamodel.rst:1180 +#: reference/datamodel.rst:1173 msgid "The name of the file from which the code was compiled" msgstr "" -#: reference/datamodel.rst:1183 +#: reference/datamodel.rst:1176 msgid "The line number of the first line of the function" msgstr "" -#: reference/datamodel.rst:1186 +#: reference/datamodel.rst:1179 msgid "" "A string encoding the mapping from :term:`bytecode` offsets to line numbers. " "For details, see the source code of the interpreter." msgstr "" -#: reference/datamodel.rst:1189 +#: reference/datamodel.rst:1182 msgid "" "This attribute of code objects is deprecated, and may be removed in Python " "3.14." msgstr "" -#: reference/datamodel.rst:1194 +#: reference/datamodel.rst:1187 msgid "The required stack size of the code object" msgstr "" -#: reference/datamodel.rst:1197 +#: reference/datamodel.rst:1190 msgid "" "An :class:`integer ` encoding a number of flags for the interpreter." msgstr "" -#: reference/datamodel.rst:1202 +#: reference/datamodel.rst:1195 msgid "" "The following flag bits are defined for :attr:`~codeobject.co_flags`: bit " "``0x04`` is set if the function uses the ``*arguments`` syntax to accept an " @@ -1332,7 +1326,7 @@ msgid "" "might be present." msgstr "" -#: reference/datamodel.rst:1210 +#: reference/datamodel.rst:1203 msgid "" "Future feature declarations (``from __future__ import division``) also use " "bits in :attr:`~codeobject.co_flags` to indicate whether a code object was " @@ -1341,29 +1335,29 @@ msgid "" "``0x1000`` were used in earlier versions of Python." msgstr "" -#: reference/datamodel.rst:1216 +#: reference/datamodel.rst:1209 msgid "" "Other bits in :attr:`~codeobject.co_flags` are reserved for internal use." msgstr "" -#: reference/datamodel.rst:1220 +#: reference/datamodel.rst:1213 msgid "" "If a code object represents a function, the first item in :attr:`~codeobject." "co_consts` is the documentation string of the function, or ``None`` if " "undefined." msgstr "" -#: reference/datamodel.rst:1225 +#: reference/datamodel.rst:1218 msgid "Methods on code objects" msgstr "" -#: reference/datamodel.rst:1229 +#: reference/datamodel.rst:1222 msgid "" "Returns an iterable over the source code positions of each :term:`bytecode` " "instruction in the code object." msgstr "" -#: reference/datamodel.rst:1232 +#: reference/datamodel.rst:1225 msgid "" "The iterator returns :class:`tuple`\\s containing the ``(start_line, " "end_line, start_column, end_column)``. The *i-th* tuple corresponds to the " @@ -1371,37 +1365,37 @@ msgid "" "information is 0-indexed utf-8 byte offsets on the given source line." msgstr "" -#: reference/datamodel.rst:1238 +#: reference/datamodel.rst:1231 msgid "" "This positional information can be missing. A non-exhaustive lists of cases " "where this may happen:" msgstr "" -#: reference/datamodel.rst:1241 +#: reference/datamodel.rst:1234 msgid "Running the interpreter with :option:`-X` ``no_debug_ranges``." msgstr "" -#: reference/datamodel.rst:1242 +#: reference/datamodel.rst:1235 msgid "" "Loading a pyc file compiled while using :option:`-X` ``no_debug_ranges``." msgstr "" -#: reference/datamodel.rst:1243 +#: reference/datamodel.rst:1236 msgid "Position tuples corresponding to artificial instructions." msgstr "" -#: reference/datamodel.rst:1244 +#: reference/datamodel.rst:1237 msgid "" "Line and column numbers that can't be represented due to implementation " "specific limitations." msgstr "" -#: reference/datamodel.rst:1247 +#: reference/datamodel.rst:1240 msgid "" "When this occurs, some or all of the tuple elements can be :const:`None`." msgstr "" -#: reference/datamodel.rst:1253 +#: reference/datamodel.rst:1246 msgid "" "This feature requires storing column positions in code objects which may " "result in a small increase of disk usage of compiled Python files or " @@ -1411,144 +1405,144 @@ msgid "" "environment variable can be used." msgstr "" -#: reference/datamodel.rst:1262 +#: reference/datamodel.rst:1255 msgid "" "Returns an iterator that yields information about successive ranges of :term:" "`bytecode`\\s. Each item yielded is a ``(start, end, lineno)`` :class:" "`tuple`:" msgstr "" -#: reference/datamodel.rst:1266 +#: reference/datamodel.rst:1259 msgid "" "``start`` (an :class:`int`) represents the offset (inclusive) of the start " "of the :term:`bytecode` range" msgstr "" -#: reference/datamodel.rst:1268 +#: reference/datamodel.rst:1261 msgid "" "``end`` (an :class:`int`) represents the offset (exclusive) of the end of " "the :term:`bytecode` range" msgstr "" -#: reference/datamodel.rst:1270 +#: reference/datamodel.rst:1263 msgid "" "``lineno`` is an :class:`int` representing the line number of the :term:" "`bytecode` range, or ``None`` if the bytecodes in the given range have no " "line number" msgstr "" -#: reference/datamodel.rst:1274 +#: reference/datamodel.rst:1267 msgid "The items yielded will have the following properties:" msgstr "" -#: reference/datamodel.rst:1276 +#: reference/datamodel.rst:1269 msgid "The first range yielded will have a ``start`` of 0." msgstr "" -#: reference/datamodel.rst:1277 +#: reference/datamodel.rst:1270 msgid "" "The ``(start, end)`` ranges will be non-decreasing and consecutive. That is, " "for any pair of :class:`tuple`\\s, the ``start`` of the second will be equal " "to the ``end`` of the first." msgstr "" -#: reference/datamodel.rst:1280 +#: reference/datamodel.rst:1273 msgid "No range will be backwards: ``end >= start`` for all triples." msgstr "" -#: reference/datamodel.rst:1281 +#: reference/datamodel.rst:1274 msgid "" "The last :class:`tuple` yielded will have ``end`` equal to the size of the :" "term:`bytecode`." msgstr "" -#: reference/datamodel.rst:1284 +#: reference/datamodel.rst:1277 msgid "" "Zero-width ranges, where ``start == end``, are allowed. Zero-width ranges " "are used for lines that are present in the source code, but have been " "eliminated by the :term:`bytecode` compiler." msgstr "" -#: reference/datamodel.rst:1292 +#: reference/datamodel.rst:1285 msgid ":pep:`626` - Precise line numbers for debugging and other tools." msgstr "" -#: reference/datamodel.rst:1293 +#: reference/datamodel.rst:1286 msgid "The PEP that introduced the :meth:`!co_lines` method." msgstr "" -#: reference/datamodel.rst:1297 +#: reference/datamodel.rst:1290 msgid "" "Return a copy of the code object with new values for the specified fields." msgstr "" -#: reference/datamodel.rst:1305 +#: reference/datamodel.rst:1298 msgid "Frame objects" msgstr "" -#: reference/datamodel.rst:1309 +#: reference/datamodel.rst:1302 msgid "" "Frame objects represent execution frames. They may occur in :ref:`traceback " "objects `, and are also passed to registered trace " "functions." msgstr "" -#: reference/datamodel.rst:1327 +#: reference/datamodel.rst:1320 msgid "" "Points to the previous stack frame (towards the caller), or ``None`` if this " "is the bottom stack frame" msgstr "" -#: reference/datamodel.rst:1331 +#: reference/datamodel.rst:1324 msgid "" "The :ref:`code object ` being executed in this frame. " "Accessing this attribute raises an :ref:`auditing event ` ``object." "__getattr__`` with arguments ``obj`` and ``\"f_code\"``." msgstr "" -#: reference/datamodel.rst:1336 +#: reference/datamodel.rst:1329 msgid "" "The dictionary used by the frame to look up :ref:`local variables `" msgstr "" -#: reference/datamodel.rst:1340 +#: reference/datamodel.rst:1333 msgid "" "The dictionary used by the frame to look up :ref:`global variables `" msgstr "" -#: reference/datamodel.rst:1344 +#: reference/datamodel.rst:1337 msgid "" "The dictionary used by the frame to look up :ref:`built-in (intrinsic) names " "`" msgstr "" -#: reference/datamodel.rst:1348 +#: reference/datamodel.rst:1341 msgid "" "The \"precise instruction\" of the frame object (this is an index into the :" "term:`bytecode` string of the :ref:`code object `)" msgstr "" -#: reference/datamodel.rst:1364 +#: reference/datamodel.rst:1357 msgid "" "If not ``None``, this is a function called for various events during code " "execution (this is used by debuggers). Normally an event is triggered for " "each new source line (see :attr:`~frame.f_trace_lines`)." msgstr "" -#: reference/datamodel.rst:1369 +#: reference/datamodel.rst:1362 msgid "" "Set this attribute to :const:`False` to disable triggering a tracing event " "for each source line." msgstr "" -#: reference/datamodel.rst:1373 +#: reference/datamodel.rst:1366 msgid "" "Set this attribute to :const:`True` to allow per-opcode events to be " "requested. Note that this may lead to undefined interpreter behaviour if " "exceptions raised by the trace function escape to the function being traced." msgstr "" -#: reference/datamodel.rst:1379 +#: reference/datamodel.rst:1372 msgid "" "The current line number of the frame -- writing to this from within a trace " "function jumps to the given line (only for the bottom-most frame). A " @@ -1556,15 +1550,15 @@ msgid "" "this attribute." msgstr "" -#: reference/datamodel.rst:1385 +#: reference/datamodel.rst:1378 msgid "Frame object methods" msgstr "" -#: reference/datamodel.rst:1387 +#: reference/datamodel.rst:1380 msgid "Frame objects support one method:" msgstr "" -#: reference/datamodel.rst:1391 +#: reference/datamodel.rst:1384 msgid "" "This method clears all references to :ref:`local variables ` held by " "the frame. Also, if the frame belonged to a :term:`generator`, the " @@ -1573,26 +1567,26 @@ msgid "" "and storing its :ref:`traceback ` for later use)." msgstr "" -#: reference/datamodel.rst:1397 +#: reference/datamodel.rst:1390 msgid ":exc:`RuntimeError` is raised if the frame is currently executing." msgstr "" -#: reference/datamodel.rst:1405 +#: reference/datamodel.rst:1398 msgid "Traceback objects" msgstr "" -#: reference/datamodel.rst:1418 +#: reference/datamodel.rst:1411 msgid "" "Traceback objects represent the stack trace of an :ref:`exception `. A traceback object is implicitly created when an exception occurs, " "and may also be explicitly created by calling :class:`types.TracebackType`." msgstr "" -#: reference/datamodel.rst:1423 +#: reference/datamodel.rst:1416 msgid "Traceback objects can now be explicitly instantiated from Python code." msgstr "" -#: reference/datamodel.rst:1426 +#: reference/datamodel.rst:1419 msgid "" "For implicitly created tracebacks, when the search for an exception handler " "unwinds the execution stack, at each unwound level a traceback object is " @@ -1603,7 +1597,7 @@ msgid "" "the caught exception." msgstr "" -#: reference/datamodel.rst:1435 +#: reference/datamodel.rst:1428 msgid "" "When the program contains no suitable handler, the stack trace is written " "(nicely formatted) to the standard error stream; if the interpreter is " @@ -1611,33 +1605,33 @@ msgid "" "last_traceback`." msgstr "" -#: reference/datamodel.rst:1440 +#: reference/datamodel.rst:1433 msgid "" "For explicitly created tracebacks, it is up to the creator of the traceback " "to determine how the :attr:`~traceback.tb_next` attributes should be linked " "to form a full stack trace." msgstr "" -#: reference/datamodel.rst:1455 +#: reference/datamodel.rst:1448 msgid "" "Points to the execution :ref:`frame ` of the current level." msgstr "" -#: reference/datamodel.rst:1458 +#: reference/datamodel.rst:1451 msgid "" "Accessing this attribute raises an :ref:`auditing event ` ``object." "__getattr__`` with arguments ``obj`` and ``\"tb_frame\"``." msgstr "" -#: reference/datamodel.rst:1463 +#: reference/datamodel.rst:1456 msgid "Gives the line number where the exception occurred" msgstr "" -#: reference/datamodel.rst:1466 +#: reference/datamodel.rst:1459 msgid "Indicates the \"precise instruction\"." msgstr "" -#: reference/datamodel.rst:1468 +#: reference/datamodel.rst:1461 msgid "" "The line number and last instruction in the traceback may differ from the " "line number of its :ref:`frame object ` if the exception " @@ -1645,39 +1639,39 @@ msgid "" "with a :keyword:`finally` clause." msgstr "" -#: reference/datamodel.rst:1479 +#: reference/datamodel.rst:1472 msgid "" "The special writable attribute :attr:`!tb_next` is the next level in the " "stack trace (towards the frame where the exception occurred), or ``None`` if " "there is no next level." msgstr "" -#: reference/datamodel.rst:1483 +#: reference/datamodel.rst:1476 msgid "This attribute is now writable" msgstr "" -#: reference/datamodel.rst:1488 +#: reference/datamodel.rst:1481 msgid "Slice objects" msgstr "" -#: reference/datamodel.rst:1492 +#: reference/datamodel.rst:1485 msgid "" "Slice objects are used to represent slices for :meth:`~object.__getitem__` " "methods. They are also created by the built-in :func:`slice` function." msgstr "" -#: reference/datamodel.rst:1501 +#: reference/datamodel.rst:1494 msgid "" "Special read-only attributes: :attr:`~slice.start` is the lower bound; :attr:" "`~slice.stop` is the upper bound; :attr:`~slice.step` is the step value; " "each is ``None`` if omitted. These attributes can have any type." msgstr "" -#: reference/datamodel.rst:1505 +#: reference/datamodel.rst:1498 msgid "Slice objects support one method:" msgstr "" -#: reference/datamodel.rst:1509 +#: reference/datamodel.rst:1502 msgid "" "This method takes a single integer argument *length* and computes " "information about the slice that the slice object would describe if applied " @@ -1687,11 +1681,11 @@ msgid "" "a manner consistent with regular slices." msgstr "" -#: reference/datamodel.rst:1518 +#: reference/datamodel.rst:1511 msgid "Static method objects" msgstr "" -#: reference/datamodel.rst:1520 +#: reference/datamodel.rst:1513 msgid "" "Static method objects provide a way of defeating the transformation of " "function objects to method objects described above. A static method object " @@ -1702,11 +1696,11 @@ msgid "" "method objects are created by the built-in :func:`staticmethod` constructor." msgstr "" -#: reference/datamodel.rst:1530 +#: reference/datamodel.rst:1523 msgid "Class method objects" msgstr "" -#: reference/datamodel.rst:1532 +#: reference/datamodel.rst:1525 msgid "" "A class method object, like a static method object, is a wrapper around " "another object that alters the way in which that object is retrieved from " @@ -1716,11 +1710,11 @@ msgid "" "`classmethod` constructor." msgstr "" -#: reference/datamodel.rst:1542 +#: reference/datamodel.rst:1535 msgid "Special method names" msgstr "" -#: reference/datamodel.rst:1548 +#: reference/datamodel.rst:1541 msgid "" "A class can implement certain operations that are invoked by special syntax " "(such as arithmetic operations or subscripting and slicing) by defining " @@ -1734,7 +1728,7 @@ msgid "" "`TypeError`)." msgstr "" -#: reference/datamodel.rst:1559 +#: reference/datamodel.rst:1552 msgid "" "Setting a special method to ``None`` indicates that the corresponding " "operation is not available. For example, if a class sets :meth:`~object." @@ -1743,7 +1737,7 @@ msgid "" "`~object.__getitem__`). [#]_" msgstr "" -#: reference/datamodel.rst:1565 +#: reference/datamodel.rst:1558 msgid "" "When implementing a class that emulates any built-in type, it is important " "that the emulation only be implemented to the degree that it makes sense for " @@ -1753,11 +1747,11 @@ msgid "" "the W3C's Document Object Model.)" msgstr "" -#: reference/datamodel.rst:1576 +#: reference/datamodel.rst:1569 msgid "Basic customization" msgstr "" -#: reference/datamodel.rst:1582 +#: reference/datamodel.rst:1575 msgid "" "Called to create a new instance of class *cls*. :meth:`__new__` is a static " "method (special-cased so you need not declare it as such) that takes the " @@ -1767,7 +1761,7 @@ msgid "" "new object instance (usually an instance of *cls*)." msgstr "" -#: reference/datamodel.rst:1589 +#: reference/datamodel.rst:1582 msgid "" "Typical implementations create a new instance of the class by invoking the " "superclass's :meth:`__new__` method using ``super().__new__(cls[, ...])`` " @@ -1775,7 +1769,7 @@ msgid "" "necessary before returning it." msgstr "" -#: reference/datamodel.rst:1594 +#: reference/datamodel.rst:1587 msgid "" "If :meth:`__new__` is invoked during object construction and it returns an " "instance of *cls*, then the new instance’s :meth:`__init__` method will be " @@ -1784,13 +1778,13 @@ msgid "" "constructor." msgstr "" -#: reference/datamodel.rst:1599 +#: reference/datamodel.rst:1592 msgid "" "If :meth:`__new__` does not return an instance of *cls*, then the new " "instance's :meth:`__init__` method will not be invoked." msgstr "" -#: reference/datamodel.rst:1602 +#: reference/datamodel.rst:1595 msgid "" ":meth:`__new__` is intended mainly to allow subclasses of immutable types " "(like int, str, or tuple) to customize instance creation. It is also " @@ -1798,7 +1792,7 @@ msgid "" "creation." msgstr "" -#: reference/datamodel.rst:1611 +#: reference/datamodel.rst:1604 msgid "" "Called after the instance has been created (by :meth:`__new__`), but before " "it is returned to the caller. The arguments are those passed to the class " @@ -1808,7 +1802,7 @@ msgid "" "example: ``super().__init__([args...])``." msgstr "" -#: reference/datamodel.rst:1618 +#: reference/datamodel.rst:1611 msgid "" "Because :meth:`__new__` and :meth:`__init__` work together in constructing " "objects (:meth:`__new__` to create it, and :meth:`__init__` to customize " @@ -1816,7 +1810,7 @@ msgid "" "will cause a :exc:`TypeError` to be raised at runtime." msgstr "" -#: reference/datamodel.rst:1631 +#: reference/datamodel.rst:1624 msgid "" "Called when the instance is about to be destroyed. This is also called a " "finalizer or (improperly) a destructor. If a base class has a :meth:" @@ -1825,7 +1819,7 @@ msgid "" "instance." msgstr "" -#: reference/datamodel.rst:1637 +#: reference/datamodel.rst:1630 msgid "" "It is possible (though not recommended!) for the :meth:`__del__` method to " "postpone destruction of the instance by creating a new reference to it. " @@ -1835,20 +1829,22 @@ msgid "" "it once." msgstr "" -#: reference/datamodel.rst:1644 +#: reference/datamodel.rst:1637 msgid "" "It is not guaranteed that :meth:`__del__` methods are called for objects " -"that still exist when the interpreter exits." +"that still exist when the interpreter exits. :class:`weakref.finalize` " +"provides a straightforward way to register a cleanup function to be called " +"when an object is garbage collected." msgstr "" -#: reference/datamodel.rst:1649 +#: reference/datamodel.rst:1644 msgid "" "``del x`` doesn't directly call ``x.__del__()`` --- the former decrements " "the reference count for ``x`` by one, and the latter is only called when " "``x``'s reference count reaches zero." msgstr "" -#: reference/datamodel.rst:1654 +#: reference/datamodel.rst:1649 msgid "" "It is possible for a reference cycle to prevent the reference count of an " "object from going to zero. In this case, the cycle will be later detected " @@ -1859,18 +1855,18 @@ msgid "" "caught in the traceback." msgstr "" -#: reference/datamodel.rst:1664 +#: reference/datamodel.rst:1659 msgid "Documentation for the :mod:`gc` module." msgstr "" -#: reference/datamodel.rst:1668 +#: reference/datamodel.rst:1663 msgid "" "Due to the precarious circumstances under which :meth:`__del__` methods are " "invoked, exceptions that occur during their execution are ignored, and a " "warning is printed to ``sys.stderr`` instead. In particular:" msgstr "" -#: reference/datamodel.rst:1672 +#: reference/datamodel.rst:1667 msgid "" ":meth:`__del__` can be invoked when arbitrary code is being executed, " "including from any arbitrary thread. If :meth:`__del__` needs to take a " @@ -1879,7 +1875,7 @@ msgid "" "`__del__`." msgstr "" -#: reference/datamodel.rst:1678 +#: reference/datamodel.rst:1673 msgid "" ":meth:`__del__` can be executed during interpreter shutdown. As a " "consequence, the global variables it needs to access (including other " @@ -1890,7 +1886,7 @@ msgid "" "still available at the time when the :meth:`__del__` method is called." msgstr "" -#: reference/datamodel.rst:1693 +#: reference/datamodel.rst:1688 msgid "" "Called by the :func:`repr` built-in function to compute the \"official\" " "string representation of an object. If at all possible, this should look " @@ -1902,13 +1898,13 @@ msgid "" "an \"informal\" string representation of instances of that class is required." msgstr "" -#: reference/datamodel.rst:1702 +#: reference/datamodel.rst:1697 msgid "" "This is typically used for debugging, so it is important that the " "representation is information-rich and unambiguous." msgstr "" -#: reference/datamodel.rst:1713 +#: reference/datamodel.rst:1708 msgid "" "Called by :func:`str(object) ` and the built-in functions :func:" "`format` and :func:`print` to compute the \"informal\" or nicely printable " @@ -1916,26 +1912,26 @@ msgid "" "` object." msgstr "" -#: reference/datamodel.rst:1718 +#: reference/datamodel.rst:1713 msgid "" "This method differs from :meth:`object.__repr__` in that there is no " "expectation that :meth:`__str__` return a valid Python expression: a more " "convenient or concise representation can be used." msgstr "" -#: reference/datamodel.rst:1722 +#: reference/datamodel.rst:1717 msgid "" "The default implementation defined by the built-in type :class:`object` " "calls :meth:`object.__repr__`." msgstr "" -#: reference/datamodel.rst:1732 +#: reference/datamodel.rst:1727 msgid "" "Called by :ref:`bytes ` to compute a byte-string representation " "of an object. This should return a :class:`bytes` object." msgstr "" -#: reference/datamodel.rst:1743 +#: reference/datamodel.rst:1738 msgid "" "Called by the :func:`format` built-in function, and by extension, evaluation " "of :ref:`formatted string literals ` and the :meth:`str.format` " @@ -1947,28 +1943,28 @@ msgid "" "formatting option syntax." msgstr "" -#: reference/datamodel.rst:1753 +#: reference/datamodel.rst:1748 msgid "" "See :ref:`formatspec` for a description of the standard formatting syntax." msgstr "" -#: reference/datamodel.rst:1755 +#: reference/datamodel.rst:1750 msgid "The return value must be a string object." msgstr "" -#: reference/datamodel.rst:1757 +#: reference/datamodel.rst:1752 msgid "" "The __format__ method of ``object`` itself raises a :exc:`TypeError` if " "passed any non-empty string." msgstr "" -#: reference/datamodel.rst:1761 +#: reference/datamodel.rst:1756 msgid "" "``object.__format__(x, '')`` is now equivalent to ``str(x)`` rather than " "``format(str(x), '')``." msgstr "" -#: reference/datamodel.rst:1777 +#: reference/datamodel.rst:1772 msgid "" "These are the so-called \"rich comparison\" methods. The correspondence " "between operator symbols and method names is as follows: ``x.__hash__``." msgstr "" -#: reference/datamodel.rst:1869 +#: reference/datamodel.rst:1864 msgid "" "If a class that does not override :meth:`__eq__` wishes to suppress hash " "support, it should include ``__hash__ = None`` in the class definition. A " @@ -2094,7 +2090,7 @@ msgid "" "``isinstance(obj, collections.abc.Hashable)`` call." msgstr "" -#: reference/datamodel.rst:1878 +#: reference/datamodel.rst:1873 msgid "" "By default, the :meth:`__hash__` values of str and bytes objects are " "\"salted\" with an unpredictable random value. Although they remain " @@ -2102,7 +2098,7 @@ msgid "" "between repeated invocations of Python." msgstr "" -#: reference/datamodel.rst:1883 +#: reference/datamodel.rst:1878 msgid "" "This is intended to provide protection against a denial-of-service caused by " "carefully chosen inputs that exploit the worst case performance of a dict " @@ -2110,22 +2106,22 @@ msgid "" "advisories/ocert-2011-003.html for details." msgstr "" -#: reference/datamodel.rst:1888 +#: reference/datamodel.rst:1883 msgid "" "Changing hash values affects the iteration order of sets. Python has never " "made guarantees about this ordering (and it typically varies between 32-bit " "and 64-bit builds)." msgstr "" -#: reference/datamodel.rst:1892 +#: reference/datamodel.rst:1887 msgid "See also :envvar:`PYTHONHASHSEED`." msgstr "" -#: reference/datamodel.rst:1894 +#: reference/datamodel.rst:1889 msgid "Hash randomization is enabled by default." msgstr "" -#: reference/datamodel.rst:1902 +#: reference/datamodel.rst:1897 msgid "" "Called to implement truth value testing and the built-in operation " "``bool()``; should return ``False`` or ``True``. When this method is not " @@ -2134,18 +2130,18 @@ msgid "" "meth:`!__len__` nor :meth:`!__bool__`, all its instances are considered true." msgstr "" -#: reference/datamodel.rst:1913 +#: reference/datamodel.rst:1908 msgid "Customizing attribute access" msgstr "" -#: reference/datamodel.rst:1915 +#: reference/datamodel.rst:1910 msgid "" "The following methods can be defined to customize the meaning of attribute " "access (use of, assignment to, or deletion of ``x.name``) for class " "instances." msgstr "" -#: reference/datamodel.rst:1923 +#: reference/datamodel.rst:1918 msgid "" "Called when the default attribute access fails with an :exc:`AttributeError` " "(either :meth:`__getattribute__` raises an :exc:`AttributeError` because " @@ -2155,7 +2151,7 @@ msgid "" "attribute value or raise an :exc:`AttributeError` exception." msgstr "" -#: reference/datamodel.rst:1930 +#: reference/datamodel.rst:1925 msgid "" "Note that if the attribute is found through the normal mechanism, :meth:" "`__getattr__` is not called. (This is an intentional asymmetry between :" @@ -2168,7 +2164,7 @@ msgid "" "actually get total control over attribute access." msgstr "" -#: reference/datamodel.rst:1943 +#: reference/datamodel.rst:1938 msgid "" "Called unconditionally to implement attribute accesses for instances of the " "class. If the class also defines :meth:`__getattr__`, the latter will not be " @@ -2180,82 +2176,82 @@ msgid "" "example, ``object.__getattribute__(self, name)``." msgstr "" -#: reference/datamodel.rst:1954 +#: reference/datamodel.rst:1949 msgid "" "This method may still be bypassed when looking up special methods as the " "result of implicit invocation via language syntax or :ref:`built-in " "functions `. See :ref:`special-lookup`." msgstr "" -#: reference/datamodel.rst:1959 +#: reference/datamodel.rst:1954 msgid "" -"Raises an :ref:`auditing event ` ``object.__getattr__`` with " -"arguments ``obj``, ``name``." +"For certain sensitive attribute accesses, raises an auditing event object." +"__getattr__ with arguments obj and name." msgstr "" -#: reference/datamodel.rst:1961 +#: reference/datamodel.rst:1956 msgid "" "For certain sensitive attribute accesses, raises an :ref:`auditing event " "` ``object.__getattr__`` with arguments ``obj`` and ``name``." msgstr "" -#: reference/datamodel.rst:1968 +#: reference/datamodel.rst:1963 msgid "" "Called when an attribute assignment is attempted. This is called instead of " "the normal mechanism (i.e. store the value in the instance dictionary). " "*name* is the attribute name, *value* is the value to be assigned to it." msgstr "" -#: reference/datamodel.rst:1972 +#: reference/datamodel.rst:1967 msgid "" "If :meth:`__setattr__` wants to assign to an instance attribute, it should " "call the base class method with the same name, for example, ``object." "__setattr__(self, name, value)``." msgstr "" -#: reference/datamodel.rst:1976 +#: reference/datamodel.rst:1971 msgid "" -"Raises an :ref:`auditing event ` ``object.__setattr__`` with " -"arguments ``obj``, ``name``, ``value``." +"For certain sensitive attribute assignments, raises an auditing event object." +"__setattr__ with arguments obj, name, value." msgstr "" -#: reference/datamodel.rst:1978 +#: reference/datamodel.rst:1973 msgid "" "For certain sensitive attribute assignments, raises an :ref:`auditing event " "` ``object.__setattr__`` with arguments ``obj``, ``name``, " "``value``." msgstr "" -#: reference/datamodel.rst:1985 +#: reference/datamodel.rst:1980 msgid "" "Like :meth:`__setattr__` but for attribute deletion instead of assignment. " "This should only be implemented if ``del obj.name`` is meaningful for the " "object." msgstr "" -#: reference/datamodel.rst:1988 +#: reference/datamodel.rst:1983 msgid "" -"Raises an :ref:`auditing event ` ``object.__delattr__`` with " -"arguments ``obj``, ``name``." +"For certain sensitive attribute deletions, raises an auditing event object." +"__delattr__ with arguments obj and name." msgstr "" -#: reference/datamodel.rst:1990 +#: reference/datamodel.rst:1985 msgid "" "For certain sensitive attribute deletions, raises an :ref:`auditing event " "` ``object.__delattr__`` with arguments ``obj`` and ``name``." msgstr "" -#: reference/datamodel.rst:1997 +#: reference/datamodel.rst:1992 msgid "" "Called when :func:`dir` is called on the object. An iterable must be " "returned. :func:`dir` converts the returned iterable to a list and sorts it." msgstr "" -#: reference/datamodel.rst:2002 +#: reference/datamodel.rst:1997 msgid "Customizing module attribute access" msgstr "" -#: reference/datamodel.rst:2009 +#: reference/datamodel.rst:2004 msgid "" "Special names ``__getattr__`` and ``__dir__`` can be also used to customize " "access to module attributes. The ``__getattr__`` function at the module " @@ -2267,21 +2263,21 @@ msgid "" "with the attribute name and the result is returned." msgstr "" -#: reference/datamodel.rst:2018 +#: reference/datamodel.rst:2013 msgid "" "The ``__dir__`` function should accept no arguments, and return an iterable " "of strings that represents the names accessible on module. If present, this " "function overrides the standard :func:`dir` search on a module." msgstr "" -#: reference/datamodel.rst:2022 +#: reference/datamodel.rst:2017 msgid "" "For a more fine grained customization of the module behavior (setting " "attributes, properties, etc.), one can set the ``__class__`` attribute of a " "module object to a subclass of :class:`types.ModuleType`. For example::" msgstr "" -#: reference/datamodel.rst:2040 +#: reference/datamodel.rst:2035 msgid "" "Defining module ``__getattr__`` and setting module ``__class__`` only affect " "lookups made using the attribute access syntax -- directly accessing the " @@ -2289,27 +2285,27 @@ msgid "" "module's globals dictionary) is unaffected." msgstr "" -#: reference/datamodel.rst:2045 +#: reference/datamodel.rst:2040 msgid "``__class__`` module attribute is now writable." msgstr "" -#: reference/datamodel.rst:2048 +#: reference/datamodel.rst:2043 msgid "``__getattr__`` and ``__dir__`` module attributes." msgstr "" -#: reference/datamodel.rst:2053 +#: reference/datamodel.rst:2048 msgid ":pep:`562` - Module __getattr__ and __dir__" msgstr "" -#: reference/datamodel.rst:2054 +#: reference/datamodel.rst:2049 msgid "Describes the ``__getattr__`` and ``__dir__`` functions on modules." msgstr "" -#: reference/datamodel.rst:2060 +#: reference/datamodel.rst:2055 msgid "Implementing Descriptors" msgstr "" -#: reference/datamodel.rst:2062 +#: reference/datamodel.rst:2057 msgid "" "The following methods only apply when an instance of the class containing " "the method (a so-called *descriptor* class) appears in an *owner* class (the " @@ -2319,7 +2315,7 @@ msgid "" "the owner class' :attr:`~object.__dict__`." msgstr "" -#: reference/datamodel.rst:2072 +#: reference/datamodel.rst:2067 msgid "" "Called to get the attribute of the owner class (class attribute access) or " "of an instance of that class (instance attribute access). The optional " @@ -2328,13 +2324,13 @@ msgid "" "accessed through the *owner*." msgstr "" -#: reference/datamodel.rst:2078 +#: reference/datamodel.rst:2073 msgid "" "This method should return the computed attribute value or raise an :exc:" "`AttributeError` exception." msgstr "" -#: reference/datamodel.rst:2081 +#: reference/datamodel.rst:2076 msgid "" ":PEP:`252` specifies that :meth:`__get__` is callable with one or two " "arguments. Python's own built-in descriptors support this specification; " @@ -2344,31 +2340,31 @@ msgid "" "not." msgstr "" -#: reference/datamodel.rst:2090 +#: reference/datamodel.rst:2085 msgid "" "Called to set the attribute on an instance *instance* of the owner class to " "a new value, *value*." msgstr "" -#: reference/datamodel.rst:2093 +#: reference/datamodel.rst:2088 msgid "" "Note, adding :meth:`__set__` or :meth:`__delete__` changes the kind of " "descriptor to a \"data descriptor\". See :ref:`descriptor-invocation` for " "more details." msgstr "" -#: reference/datamodel.rst:2099 +#: reference/datamodel.rst:2094 msgid "" "Called to delete the attribute on an instance *instance* of the owner class." msgstr "" -#: reference/datamodel.rst:2101 +#: reference/datamodel.rst:2096 msgid "" "Instances of descriptors may also have the :attr:`!__objclass__` attribute " "present:" msgstr "" -#: reference/datamodel.rst:2106 +#: reference/datamodel.rst:2101 msgid "" "The attribute :attr:`!__objclass__` is interpreted by the :mod:`inspect` " "module as specifying the class where this object was defined (setting this " @@ -2379,11 +2375,11 @@ msgid "" "are implemented in C)." msgstr "" -#: reference/datamodel.rst:2117 +#: reference/datamodel.rst:2112 msgid "Invoking Descriptors" msgstr "" -#: reference/datamodel.rst:2119 +#: reference/datamodel.rst:2114 msgid "" "In general, a descriptor is an object attribute with \"binding behavior\", " "one whose attribute access has been overridden by methods in the descriptor " @@ -2392,7 +2388,7 @@ msgid "" "is said to be a descriptor." msgstr "" -#: reference/datamodel.rst:2125 +#: reference/datamodel.rst:2120 msgid "" "The default behavior for attribute access is to get, set, or delete the " "attribute from an object's dictionary. For instance, ``a.x`` has a lookup " @@ -2400,7 +2396,7 @@ msgid "" "continuing through the base classes of ``type(a)`` excluding metaclasses." msgstr "" -#: reference/datamodel.rst:2130 +#: reference/datamodel.rst:2125 msgid "" "However, if the looked-up value is an object defining one of the descriptor " "methods, then Python may override the default behavior and invoke the " @@ -2408,54 +2404,54 @@ msgid "" "depends on which descriptor methods were defined and how they were called." msgstr "" -#: reference/datamodel.rst:2135 +#: reference/datamodel.rst:2130 msgid "" "The starting point for descriptor invocation is a binding, ``a.x``. How the " "arguments are assembled depends on ``a``:" msgstr "" -#: reference/datamodel.rst:2138 +#: reference/datamodel.rst:2133 msgid "Direct Call" msgstr "" -#: reference/datamodel.rst:2139 +#: reference/datamodel.rst:2134 msgid "" "The simplest and least common call is when user code directly invokes a " "descriptor method: ``x.__get__(a)``." msgstr "" -#: reference/datamodel.rst:2142 +#: reference/datamodel.rst:2137 msgid "Instance Binding" msgstr "" -#: reference/datamodel.rst:2143 +#: reference/datamodel.rst:2138 msgid "" "If binding to an object instance, ``a.x`` is transformed into the call: " "``type(a).__dict__['x'].__get__(a, type(a))``." msgstr "" -#: reference/datamodel.rst:2146 +#: reference/datamodel.rst:2141 msgid "Class Binding" msgstr "" -#: reference/datamodel.rst:2147 +#: reference/datamodel.rst:2142 msgid "" "If binding to a class, ``A.x`` is transformed into the call: ``A." "__dict__['x'].__get__(None, A)``." msgstr "" -#: reference/datamodel.rst:2150 +#: reference/datamodel.rst:2145 msgid "Super Binding" msgstr "" -#: reference/datamodel.rst:2151 +#: reference/datamodel.rst:2146 msgid "" "A dotted lookup such as ``super(A, a).x`` searches ``a.__class__.__mro__`` " "for a base class ``B`` following ``A`` and then returns ``B.__dict__['x']." "__get__(a, A)``. If not a descriptor, ``x`` is returned unchanged." msgstr "" -#: reference/datamodel.rst:2188 +#: reference/datamodel.rst:2183 msgid "" "For instance bindings, the precedence of descriptor invocation depends on " "which descriptor methods are defined. A descriptor can define any " @@ -2473,7 +2469,7 @@ msgid "" "instances." msgstr "" -#: reference/datamodel.rst:2203 +#: reference/datamodel.rst:2198 msgid "" "Python methods (including those decorated with :func:`@staticmethod " "` and :func:`@classmethod `) are implemented as " @@ -2482,30 +2478,30 @@ msgid "" "from other instances of the same class." msgstr "" -#: reference/datamodel.rst:2209 +#: reference/datamodel.rst:2204 msgid "" "The :func:`property` function is implemented as a data descriptor. " "Accordingly, instances cannot override the behavior of a property." msgstr "" -#: reference/datamodel.rst:2216 +#: reference/datamodel.rst:2211 msgid "__slots__" msgstr "" -#: reference/datamodel.rst:2218 +#: reference/datamodel.rst:2213 msgid "" "*__slots__* allow us to explicitly declare data members (like properties) " "and deny the creation of :attr:`~object.__dict__` and *__weakref__* (unless " "explicitly declared in *__slots__* or available in a parent.)" msgstr "" -#: reference/datamodel.rst:2222 +#: reference/datamodel.rst:2217 msgid "" "The space saved over using :attr:`~object.__dict__` can be significant. " "Attribute lookup speed can be significantly improved as well." msgstr "" -#: reference/datamodel.rst:2227 +#: reference/datamodel.rst:2222 msgid "" "This class variable can be assigned a string, iterable, or sequence of " "strings with variable names used by instances. *__slots__* reserves space " @@ -2513,18 +2509,18 @@ msgid "" "`~object.__dict__` and *__weakref__* for each instance." msgstr "" -#: reference/datamodel.rst:2236 +#: reference/datamodel.rst:2231 msgid "Notes on using *__slots__*:" msgstr "" -#: reference/datamodel.rst:2238 +#: reference/datamodel.rst:2233 msgid "" "When inheriting from a class without *__slots__*, the :attr:`~object." "__dict__` and *__weakref__* attribute of the instances will always be " "accessible." msgstr "" -#: reference/datamodel.rst:2242 +#: reference/datamodel.rst:2237 msgid "" "Without a :attr:`~object.__dict__` variable, instances cannot be assigned " "new variables not listed in the *__slots__* definition. Attempts to assign " @@ -2533,7 +2529,7 @@ msgid "" "sequence of strings in the *__slots__* declaration." msgstr "" -#: reference/datamodel.rst:2249 +#: reference/datamodel.rst:2244 msgid "" "Without a *__weakref__* variable for each instance, classes defining " "*__slots__* do not support :mod:`weak references ` to its " @@ -2541,7 +2537,7 @@ msgid "" "to the sequence of strings in the *__slots__* declaration." msgstr "" -#: reference/datamodel.rst:2255 +#: reference/datamodel.rst:2250 msgid "" "*__slots__* are implemented at the class level by creating :ref:`descriptors " "` for each variable name. As a result, class attributes cannot " @@ -2549,7 +2545,7 @@ msgid "" "otherwise, the class attribute would overwrite the descriptor assignment." msgstr "" -#: reference/datamodel.rst:2261 +#: reference/datamodel.rst:2256 msgid "" "The action of a *__slots__* declaration is not limited to the class where it " "is defined. *__slots__* declared in parents are available in child classes. " @@ -2558,7 +2554,7 @@ msgid "" "names of any *additional* slots)." msgstr "" -#: reference/datamodel.rst:2267 +#: reference/datamodel.rst:2262 msgid "" "If a class defines a slot also defined in a base class, the instance " "variable defined by the base class slot is inaccessible (except by " @@ -2567,7 +2563,7 @@ msgid "" "prevent this." msgstr "" -#: reference/datamodel.rst:2272 +#: reference/datamodel.rst:2267 msgid "" ":exc:`TypeError` will be raised if nonempty *__slots__* are defined for a " "class derived from a :c:member:`\"variable-length\" built-in type " @@ -2575,11 +2571,11 @@ msgid "" "`tuple`." msgstr "" -#: reference/datamodel.rst:2277 +#: reference/datamodel.rst:2272 msgid "Any non-string :term:`iterable` may be assigned to *__slots__*." msgstr "" -#: reference/datamodel.rst:2279 +#: reference/datamodel.rst:2274 msgid "" "If a :class:`dictionary ` is used to assign *__slots__*, the " "dictionary keys will be used as the slot names. The values of the dictionary " @@ -2587,13 +2583,13 @@ msgid "" "func:`inspect.getdoc` and displayed in the output of :func:`help`." msgstr "" -#: reference/datamodel.rst:2284 +#: reference/datamodel.rst:2279 msgid "" ":attr:`~instance.__class__` assignment works only if both classes have the " "same *__slots__*." msgstr "" -#: reference/datamodel.rst:2287 +#: reference/datamodel.rst:2282 msgid "" ":ref:`Multiple inheritance ` with multiple slotted parent " "classes can be used, but only one parent is allowed to have attributes " @@ -2601,18 +2597,18 @@ msgid "" "raise :exc:`TypeError`." msgstr "" -#: reference/datamodel.rst:2293 +#: reference/datamodel.rst:2288 msgid "" "If an :term:`iterator` is used for *__slots__* then a :term:`descriptor` is " "created for each of the iterator's values. However, the *__slots__* " "attribute will be an empty iterator." msgstr "" -#: reference/datamodel.rst:2301 +#: reference/datamodel.rst:2296 msgid "Customizing class creation" msgstr "" -#: reference/datamodel.rst:2303 +#: reference/datamodel.rst:2298 msgid "" "Whenever a class inherits from another class, :meth:`~object." "__init_subclass__` is called on the parent class. This way, it is possible " @@ -2622,14 +2618,14 @@ msgid "" "future subclasses of the class defining the method." msgstr "" -#: reference/datamodel.rst:2312 +#: reference/datamodel.rst:2307 msgid "" "This method is called whenever the containing class is subclassed. *cls* is " "then the new subclass. If defined as a normal instance method, this method " "is implicitly converted to a class method." msgstr "" -#: reference/datamodel.rst:2316 +#: reference/datamodel.rst:2311 msgid "" "Keyword arguments which are given to a new class are passed to the parent " "class's ``__init_subclass__``. For compatibility with other classes using " @@ -2637,13 +2633,13 @@ msgid "" "pass the others over to the base class, as in::" msgstr "" -#: reference/datamodel.rst:2330 +#: reference/datamodel.rst:2325 msgid "" "The default implementation ``object.__init_subclass__`` does nothing, but " "raises an error if it is called with any arguments." msgstr "" -#: reference/datamodel.rst:2335 +#: reference/datamodel.rst:2330 msgid "" "The metaclass hint ``metaclass`` is consumed by the rest of the type " "machinery, and is never passed to ``__init_subclass__`` implementations. The " @@ -2651,41 +2647,41 @@ msgid "" "``type(cls)``." msgstr "" -#: reference/datamodel.rst:2343 +#: reference/datamodel.rst:2338 msgid "" "When a class is created, :meth:`type.__new__` scans the class variables and " "makes callbacks to those with a :meth:`~object.__set_name__` hook." msgstr "" -#: reference/datamodel.rst:2348 +#: reference/datamodel.rst:2343 msgid "" "Automatically called at the time the owning class *owner* is created. The " "object has been assigned to *name* in that class::" msgstr "" -#: reference/datamodel.rst:2354 +#: reference/datamodel.rst:2349 msgid "" "If the class variable is assigned after the class is created, :meth:" "`__set_name__` will not be called automatically. If needed, :meth:" "`__set_name__` can be called directly::" msgstr "" -#: reference/datamodel.rst:2365 +#: reference/datamodel.rst:2360 msgid "See :ref:`class-object-creation` for more details." msgstr "" -#: reference/datamodel.rst:2373 +#: reference/datamodel.rst:2368 msgid "Metaclasses" msgstr "" -#: reference/datamodel.rst:2380 +#: reference/datamodel.rst:2375 msgid "" "By default, classes are constructed using :func:`type`. The class body is " "executed in a new namespace and the class name is bound locally to the " "result of ``type(name, bases, namespace)``." msgstr "" -#: reference/datamodel.rst:2384 +#: reference/datamodel.rst:2379 msgid "" "The class creation process can be customized by passing the ``metaclass`` " "keyword argument in the class definition line, or by inheriting from an " @@ -2693,41 +2689,41 @@ msgid "" "both ``MyClass`` and ``MySubclass`` are instances of ``Meta``::" msgstr "" -#: reference/datamodel.rst:2398 +#: reference/datamodel.rst:2393 msgid "" "Any other keyword arguments that are specified in the class definition are " "passed through to all metaclass operations described below." msgstr "" -#: reference/datamodel.rst:2401 +#: reference/datamodel.rst:2396 msgid "When a class definition is executed, the following steps occur:" msgstr "" -#: reference/datamodel.rst:2403 +#: reference/datamodel.rst:2398 msgid "MRO entries are resolved;" msgstr "" -#: reference/datamodel.rst:2404 +#: reference/datamodel.rst:2399 msgid "the appropriate metaclass is determined;" msgstr "" -#: reference/datamodel.rst:2405 +#: reference/datamodel.rst:2400 msgid "the class namespace is prepared;" msgstr "" -#: reference/datamodel.rst:2406 +#: reference/datamodel.rst:2401 msgid "the class body is executed;" msgstr "" -#: reference/datamodel.rst:2407 +#: reference/datamodel.rst:2402 msgid "the class object is created." msgstr "" -#: reference/datamodel.rst:2411 +#: reference/datamodel.rst:2406 msgid "Resolving MRO entries" msgstr "" -#: reference/datamodel.rst:2415 +#: reference/datamodel.rst:2410 msgid "" "If a base that appears in a class definition is not an instance of :class:" "`type`, then an :meth:`!__mro_entries__` method is searched on the base. If " @@ -2739,59 +2735,59 @@ msgid "" "is ignored." msgstr "" -#: reference/datamodel.rst:2426 +#: reference/datamodel.rst:2421 msgid ":func:`types.resolve_bases`" msgstr "" -#: reference/datamodel.rst:2427 +#: reference/datamodel.rst:2422 msgid "Dynamically resolve bases that are not instances of :class:`type`." msgstr "" -#: reference/datamodel.rst:2429 +#: reference/datamodel.rst:2424 msgid ":func:`types.get_original_bases`" msgstr "" -#: reference/datamodel.rst:2430 +#: reference/datamodel.rst:2425 msgid "" "Retrieve a class's \"original bases\" prior to modifications by :meth:" "`~object.__mro_entries__`." msgstr "" -#: reference/datamodel.rst:2433 +#: reference/datamodel.rst:2428 msgid ":pep:`560`" msgstr "" -#: reference/datamodel.rst:2434 +#: reference/datamodel.rst:2429 msgid "Core support for typing module and generic types." msgstr "" -#: reference/datamodel.rst:2438 +#: reference/datamodel.rst:2433 msgid "Determining the appropriate metaclass" msgstr "" -#: reference/datamodel.rst:2442 +#: reference/datamodel.rst:2437 msgid "" "The appropriate metaclass for a class definition is determined as follows:" msgstr "" -#: reference/datamodel.rst:2444 +#: reference/datamodel.rst:2439 msgid "" "if no bases and no explicit metaclass are given, then :func:`type` is used;" msgstr "" -#: reference/datamodel.rst:2445 +#: reference/datamodel.rst:2440 msgid "" "if an explicit metaclass is given and it is *not* an instance of :func:" "`type`, then it is used directly as the metaclass;" msgstr "" -#: reference/datamodel.rst:2447 +#: reference/datamodel.rst:2442 msgid "" "if an instance of :func:`type` is given as the explicit metaclass, or bases " "are defined, then the most derived metaclass is used." msgstr "" -#: reference/datamodel.rst:2450 +#: reference/datamodel.rst:2445 msgid "" "The most derived metaclass is selected from the explicitly specified " "metaclass (if any) and the metaclasses (i.e. ``type(cls)``) of all specified " @@ -2800,11 +2796,11 @@ msgid "" "that criterion, then the class definition will fail with ``TypeError``." msgstr "" -#: reference/datamodel.rst:2460 +#: reference/datamodel.rst:2455 msgid "Preparing the class namespace" msgstr "" -#: reference/datamodel.rst:2465 +#: reference/datamodel.rst:2460 msgid "" "Once the appropriate metaclass has been identified, then the class namespace " "is prepared. If the metaclass has a ``__prepare__`` attribute, it is called " @@ -2816,25 +2812,25 @@ msgid "" "copied into a new ``dict``." msgstr "" -#: reference/datamodel.rst:2474 +#: reference/datamodel.rst:2469 msgid "" "If the metaclass has no ``__prepare__`` attribute, then the class namespace " "is initialised as an empty ordered mapping." msgstr "" -#: reference/datamodel.rst:2479 +#: reference/datamodel.rst:2474 msgid ":pep:`3115` - Metaclasses in Python 3000" msgstr "" -#: reference/datamodel.rst:2480 +#: reference/datamodel.rst:2475 msgid "Introduced the ``__prepare__`` namespace hook" msgstr "" -#: reference/datamodel.rst:2484 +#: reference/datamodel.rst:2479 msgid "Executing the class body" msgstr "" -#: reference/datamodel.rst:2489 +#: reference/datamodel.rst:2484 msgid "" "The class body is executed (approximately) as ``exec(body, globals(), " "namespace)``. The key difference from a normal call to :func:`exec` is that " @@ -2843,7 +2839,7 @@ msgid "" "inside a function." msgstr "" -#: reference/datamodel.rst:2495 +#: reference/datamodel.rst:2490 msgid "" "However, even when the class definition occurs inside the function, methods " "defined inside the class still cannot see names defined at the class scope. " @@ -2852,11 +2848,11 @@ msgid "" "reference described in the next section." msgstr "" -#: reference/datamodel.rst:2504 +#: reference/datamodel.rst:2499 msgid "Creating the class object" msgstr "" -#: reference/datamodel.rst:2511 +#: reference/datamodel.rst:2506 msgid "" "Once the class namespace has been populated by executing the class body, the " "class object is created by calling ``metaclass(name, bases, namespace, " @@ -2864,7 +2860,7 @@ msgid "" "to ``__prepare__``)." msgstr "" -#: reference/datamodel.rst:2516 +#: reference/datamodel.rst:2511 msgid "" "This class object is the one that will be referenced by the zero-argument " "form of :func:`super`. ``__class__`` is an implicit closure reference " @@ -2875,7 +2871,7 @@ msgid "" "is identified based on the first argument passed to the method." msgstr "" -#: reference/datamodel.rst:2526 +#: reference/datamodel.rst:2521 msgid "" "In CPython 3.6 and later, the ``__class__`` cell is passed to the metaclass " "as a ``__classcell__`` entry in the class namespace. If present, this must " @@ -2884,39 +2880,39 @@ msgid "" "in Python 3.8." msgstr "" -#: reference/datamodel.rst:2532 +#: reference/datamodel.rst:2527 msgid "" "When using the default metaclass :class:`type`, or any metaclass that " "ultimately calls ``type.__new__``, the following additional customization " "steps are invoked after creating the class object:" msgstr "" -#: reference/datamodel.rst:2536 +#: reference/datamodel.rst:2531 msgid "" "The ``type.__new__`` method collects all of the attributes in the class " "namespace that define a :meth:`~object.__set_name__` method;" msgstr "" -#: reference/datamodel.rst:2538 +#: reference/datamodel.rst:2533 msgid "" "Those ``__set_name__`` methods are called with the class being defined and " "the assigned name of that particular attribute;" msgstr "" -#: reference/datamodel.rst:2540 +#: reference/datamodel.rst:2535 msgid "" "The :meth:`~object.__init_subclass__` hook is called on the immediate parent " "of the new class in its method resolution order." msgstr "" -#: reference/datamodel.rst:2543 +#: reference/datamodel.rst:2538 msgid "" "After the class object is created, it is passed to the class decorators " "included in the class definition (if any) and the resulting object is bound " "in the local namespace as the defined class." msgstr "" -#: reference/datamodel.rst:2547 +#: reference/datamodel.rst:2542 msgid "" "When a new class is created by ``type.__new__``, the object provided as the " "namespace parameter is copied to a new ordered mapping and the original " @@ -2924,19 +2920,19 @@ msgid "" "becomes the :attr:`~object.__dict__` attribute of the class object." msgstr "" -#: reference/datamodel.rst:2554 +#: reference/datamodel.rst:2549 msgid ":pep:`3135` - New super" msgstr "" -#: reference/datamodel.rst:2555 +#: reference/datamodel.rst:2550 msgid "Describes the implicit ``__class__`` closure reference" msgstr "" -#: reference/datamodel.rst:2559 +#: reference/datamodel.rst:2554 msgid "Uses for metaclasses" msgstr "" -#: reference/datamodel.rst:2561 +#: reference/datamodel.rst:2556 msgid "" "The potential uses for metaclasses are boundless. Some ideas that have been " "explored include enum, logging, interface checking, automatic delegation, " @@ -2944,17 +2940,17 @@ msgid "" "locking/synchronization." msgstr "" -#: reference/datamodel.rst:2568 +#: reference/datamodel.rst:2563 msgid "Customizing instance and subclass checks" msgstr "" -#: reference/datamodel.rst:2570 +#: reference/datamodel.rst:2565 msgid "" "The following methods are used to override the default behavior of the :func:" "`isinstance` and :func:`issubclass` built-in functions." msgstr "" -#: reference/datamodel.rst:2573 +#: reference/datamodel.rst:2568 msgid "" "In particular, the metaclass :class:`abc.ABCMeta` implements these methods " "in order to allow the addition of Abstract Base Classes (ABCs) as \"virtual " @@ -2962,21 +2958,21 @@ msgid "" "other ABCs." msgstr "" -#: reference/datamodel.rst:2580 +#: reference/datamodel.rst:2575 msgid "" "Return true if *instance* should be considered a (direct or indirect) " "instance of *class*. If defined, called to implement ``isinstance(instance, " "class)``." msgstr "" -#: reference/datamodel.rst:2587 +#: reference/datamodel.rst:2582 msgid "" "Return true if *subclass* should be considered a (direct or indirect) " "subclass of *class*. If defined, called to implement ``issubclass(subclass, " "class)``." msgstr "" -#: reference/datamodel.rst:2592 +#: reference/datamodel.rst:2587 msgid "" "Note that these methods are looked up on the type (metaclass) of a class. " "They cannot be defined as class methods in the actual class. This is " @@ -2984,11 +2980,11 @@ msgid "" "only in this case the instance is itself a class." msgstr "" -#: reference/datamodel.rst:2599 +#: reference/datamodel.rst:2594 msgid ":pep:`3119` - Introducing Abstract Base Classes" msgstr "" -#: reference/datamodel.rst:2600 +#: reference/datamodel.rst:2595 msgid "" "Includes the specification for customizing :func:`isinstance` and :func:" "`issubclass` behavior through :meth:`~class.__instancecheck__` and :meth:" @@ -2997,11 +2993,11 @@ msgid "" "language." msgstr "" -#: reference/datamodel.rst:2608 +#: reference/datamodel.rst:2603 msgid "Emulating generic types" msgstr "" -#: reference/datamodel.rst:2610 +#: reference/datamodel.rst:2605 msgid "" "When using :term:`type annotations`, it is often useful to " "*parameterize* a :term:`generic type` using Python's square-brackets " @@ -3009,65 +3005,65 @@ msgid "" "a :class:`list` in which all the elements are of type :class:`int`." msgstr "" -#: reference/datamodel.rst:2617 +#: reference/datamodel.rst:2612 msgid ":pep:`484` - Type Hints" msgstr "" -#: reference/datamodel.rst:2618 +#: reference/datamodel.rst:2613 msgid "Introducing Python's framework for type annotations" msgstr "" -#: reference/datamodel.rst:2620 +#: reference/datamodel.rst:2615 msgid ":ref:`Generic Alias Types`" msgstr "" -#: reference/datamodel.rst:2621 +#: reference/datamodel.rst:2616 msgid "Documentation for objects representing parameterized generic classes" msgstr "" -#: reference/datamodel.rst:2623 +#: reference/datamodel.rst:2618 msgid "" ":ref:`Generics`, :ref:`user-defined generics` and :" "class:`typing.Generic`" msgstr "" -#: reference/datamodel.rst:2624 +#: reference/datamodel.rst:2619 msgid "" "Documentation on how to implement generic classes that can be parameterized " "at runtime and understood by static type-checkers." msgstr "" -#: reference/datamodel.rst:2627 +#: reference/datamodel.rst:2622 msgid "" "A class can *generally* only be parameterized if it defines the special " "class method ``__class_getitem__()``." msgstr "" -#: reference/datamodel.rst:2632 +#: reference/datamodel.rst:2627 msgid "" "Return an object representing the specialization of a generic class by type " "arguments found in *key*." msgstr "" -#: reference/datamodel.rst:2635 +#: reference/datamodel.rst:2630 msgid "" "When defined on a class, ``__class_getitem__()`` is automatically a class " "method. As such, there is no need for it to be decorated with :func:" "`@classmethod` when it is defined." msgstr "" -#: reference/datamodel.rst:2641 +#: reference/datamodel.rst:2636 msgid "The purpose of *__class_getitem__*" msgstr "" -#: reference/datamodel.rst:2643 +#: reference/datamodel.rst:2638 msgid "" "The purpose of :meth:`~object.__class_getitem__` is to allow runtime " "parameterization of standard-library generic classes in order to more easily " "apply :term:`type hints` to these classes." msgstr "" -#: reference/datamodel.rst:2647 +#: reference/datamodel.rst:2642 msgid "" "To implement custom generic classes that can be parameterized at runtime and " "understood by static type-checkers, users should either inherit from a " @@ -3076,7 +3072,7 @@ msgid "" "own implementation of ``__class_getitem__()``." msgstr "" -#: reference/datamodel.rst:2653 +#: reference/datamodel.rst:2648 msgid "" "Custom implementations of :meth:`~object.__class_getitem__` on classes " "defined outside of the standard library may not be understood by third-party " @@ -3084,11 +3080,11 @@ msgid "" "purposes other than type hinting is discouraged." msgstr "" -#: reference/datamodel.rst:2663 +#: reference/datamodel.rst:2658 msgid "*__class_getitem__* versus *__getitem__*" msgstr "" -#: reference/datamodel.rst:2665 +#: reference/datamodel.rst:2660 msgid "" "Usually, the :ref:`subscription` of an object using square " "brackets will call the :meth:`~object.__getitem__` instance method defined " @@ -3098,14 +3094,14 @@ msgid "" "genericalias>` object if it is properly defined." msgstr "" -#: reference/datamodel.rst:2672 +#: reference/datamodel.rst:2667 msgid "" "Presented with the :term:`expression` ``obj[x]``, the Python interpreter " "follows something like the following process to decide whether :meth:" "`~object.__getitem__` or :meth:`~object.__class_getitem__` should be called::" msgstr "" -#: reference/datamodel.rst:2700 +#: reference/datamodel.rst:2695 msgid "" "In Python, all classes are themselves instances of other classes. The class " "of a class is known as that class's :term:`metaclass`, and most classes have " @@ -3115,40 +3111,40 @@ msgid "" "__class_getitem__` being called::" msgstr "" -#: reference/datamodel.rst:2719 +#: reference/datamodel.rst:2714 msgid "" "However, if a class has a custom metaclass that defines :meth:`~object." "__getitem__`, subscribing the class may result in different behaviour. An " "example of this can be found in the :mod:`enum` module::" msgstr "" -#: reference/datamodel.rst:2742 +#: reference/datamodel.rst:2737 msgid ":pep:`560` - Core Support for typing module and generic types" msgstr "" -#: reference/datamodel.rst:2743 +#: reference/datamodel.rst:2738 msgid "" "Introducing :meth:`~object.__class_getitem__`, and outlining when a :ref:" "`subscription` results in ``__class_getitem__()`` being " "called instead of :meth:`~object.__getitem__`" msgstr "" -#: reference/datamodel.rst:2751 +#: reference/datamodel.rst:2746 msgid "Emulating callable objects" msgstr "" -#: reference/datamodel.rst:2758 +#: reference/datamodel.rst:2753 msgid "" "Called when the instance is \"called\" as a function; if this method is " "defined, ``x(arg1, arg2, ...)`` roughly translates to ``type(x).__call__(x, " "arg1, ...)``." msgstr "" -#: reference/datamodel.rst:2765 +#: reference/datamodel.rst:2760 msgid "Emulating container types" msgstr "" -#: reference/datamodel.rst:2767 +#: reference/datamodel.rst:2762 msgid "" "The following methods can be defined to implement container objects. " "Containers usually are :term:`sequences ` (such as :class:`lists " @@ -3184,7 +3180,7 @@ msgid "" "should iterate through the values." msgstr "" -#: reference/datamodel.rst:2808 +#: reference/datamodel.rst:2803 msgid "" "Called to implement the built-in function :func:`len`. Should return the " "length of the object, an integer ``>=`` 0. Also, an object that doesn't " @@ -3192,7 +3188,7 @@ msgid "" "returns zero is considered to be false in a Boolean context." msgstr "" -#: reference/datamodel.rst:2815 +#: reference/datamodel.rst:2810 msgid "" "In CPython, the length is required to be at most :data:`sys.maxsize`. If the " "length is larger than :data:`!sys.maxsize` some features (such as :func:" @@ -3201,7 +3197,7 @@ msgid "" "`~object.__bool__` method." msgstr "" -#: reference/datamodel.rst:2824 +#: reference/datamodel.rst:2819 msgid "" "Called to implement :func:`operator.length_hint`. Should return an estimated " "length for the object (which may be greater or less than the actual length). " @@ -3211,20 +3207,20 @@ msgid "" "never required for correctness." msgstr "" -#: reference/datamodel.rst:2838 +#: reference/datamodel.rst:2833 msgid "" "Slicing is done exclusively with the following three methods. A call like ::" msgstr "" -#: reference/datamodel.rst:2842 +#: reference/datamodel.rst:2837 msgid "is translated to ::" msgstr "" -#: reference/datamodel.rst:2846 +#: reference/datamodel.rst:2841 msgid "and so forth. Missing slice items are always filled in with ``None``." msgstr "" -#: reference/datamodel.rst:2851 +#: reference/datamodel.rst:2846 msgid "" "Called to implement evaluation of ``self[key]``. For :term:`sequence` types, " "the accepted keys should be integers. Optionally, they may support :class:" @@ -3236,20 +3232,20 @@ msgid "" "`KeyError` should be raised." msgstr "" -#: reference/datamodel.rst:2863 +#: reference/datamodel.rst:2858 msgid "" ":keyword:`for` loops expect that an :exc:`IndexError` will be raised for " "illegal indexes to allow proper detection of the end of the sequence." msgstr "" -#: reference/datamodel.rst:2868 +#: reference/datamodel.rst:2863 msgid "" "When :ref:`subscripting` a *class*, the special class method :" "meth:`~object.__class_getitem__` may be called instead of ``__getitem__()``. " "See :ref:`classgetitem-versus-getitem` for more details." msgstr "" -#: reference/datamodel.rst:2876 +#: reference/datamodel.rst:2871 msgid "" "Called to implement assignment to ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -3258,7 +3254,7 @@ msgid "" "for improper *key* values as for the :meth:`__getitem__` method." msgstr "" -#: reference/datamodel.rst:2885 +#: reference/datamodel.rst:2880 msgid "" "Called to implement deletion of ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -3267,13 +3263,13 @@ msgid "" "values as for the :meth:`__getitem__` method." msgstr "" -#: reference/datamodel.rst:2894 +#: reference/datamodel.rst:2889 msgid "" "Called by :class:`dict`\\ .\\ :meth:`__getitem__` to implement ``self[key]`` " "for dict subclasses when key is not in the dictionary." msgstr "" -#: reference/datamodel.rst:2900 +#: reference/datamodel.rst:2895 msgid "" "This method is called when an :term:`iterator` is required for a container. " "This method should return a new iterator object that can iterate over all " @@ -3281,14 +3277,14 @@ msgid "" "of the container." msgstr "" -#: reference/datamodel.rst:2908 +#: reference/datamodel.rst:2903 msgid "" "Called (if present) by the :func:`reversed` built-in to implement reverse " "iteration. It should return a new iterator object that iterates over all " "the objects in the container in reverse order." msgstr "" -#: reference/datamodel.rst:2912 +#: reference/datamodel.rst:2907 msgid "" "If the :meth:`__reversed__` method is not provided, the :func:`reversed` " "built-in will fall back to using the sequence protocol (:meth:`__len__` and :" @@ -3297,7 +3293,7 @@ msgid "" "more efficient than the one provided by :func:`reversed`." msgstr "" -#: reference/datamodel.rst:2919 +#: reference/datamodel.rst:2914 msgid "" "The membership test operators (:keyword:`in` and :keyword:`not in`) are " "normally implemented as an iteration through a container. However, container " @@ -3305,14 +3301,14 @@ msgid "" "implementation, which also does not require the object be iterable." msgstr "" -#: reference/datamodel.rst:2926 +#: reference/datamodel.rst:2921 msgid "" "Called to implement membership test operators. Should return true if *item* " "is in *self*, false otherwise. For mapping objects, this should consider " "the keys of the mapping rather than the values or the key-item pairs." msgstr "" -#: reference/datamodel.rst:2930 +#: reference/datamodel.rst:2925 msgid "" "For objects that don't define :meth:`__contains__`, the membership test " "first tries iteration via :meth:`__iter__`, then the old sequence iteration " @@ -3320,11 +3316,11 @@ msgid "" "reference `." msgstr "" -#: reference/datamodel.rst:2939 +#: reference/datamodel.rst:2934 msgid "Emulating numeric types" msgstr "" -#: reference/datamodel.rst:2941 +#: reference/datamodel.rst:2936 msgid "" "The following methods can be defined to emulate numeric objects. Methods " "corresponding to operations that are not supported by the particular kind of " @@ -3332,7 +3328,7 @@ msgid "" "should be left undefined." msgstr "" -#: reference/datamodel.rst:2967 +#: reference/datamodel.rst:2962 msgid "" "These methods are called to implement the binary arithmetic operations " "(``+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:" @@ -3346,13 +3342,13 @@ msgid "" "function is to be supported." msgstr "" -#: reference/datamodel.rst:2978 +#: reference/datamodel.rst:2973 msgid "" "If one of those methods does not support the operation with the supplied " "arguments, it should return :data:`NotImplemented`." msgstr "" -#: reference/datamodel.rst:3001 +#: reference/datamodel.rst:2996 msgid "" "These methods are called to implement the binary arithmetic operations " "(``+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:" @@ -3365,13 +3361,13 @@ msgid "" "`NotImplemented`." msgstr "" -#: reference/datamodel.rst:3013 +#: reference/datamodel.rst:3008 msgid "" "Note that ternary :func:`pow` will not try calling :meth:`__rpow__` (the " "coercion rules would become too complicated)." msgstr "" -#: reference/datamodel.rst:3018 +#: reference/datamodel.rst:3013 msgid "" "If the right operand's type is a subclass of the left operand's type and " "that subclass provides a different implementation of the reflected method " @@ -3380,7 +3376,7 @@ msgid "" "ancestors' operations." msgstr "" -#: reference/datamodel.rst:3039 +#: reference/datamodel.rst:3034 msgid "" "These methods are called to implement the augmented arithmetic assignments " "(``+=``, ``-=``, ``*=``, ``@=``, ``/=``, ``//=``, ``%=``, ``**=``, ``<<=``, " @@ -3398,19 +3394,19 @@ msgid "" "data model." msgstr "" -#: reference/datamodel.rst:3062 +#: reference/datamodel.rst:3057 msgid "" "Called to implement the unary arithmetic operations (``-``, ``+``, :func:" "`abs` and ``~``)." msgstr "" -#: reference/datamodel.rst:3075 +#: reference/datamodel.rst:3070 msgid "" "Called to implement the built-in functions :func:`complex`, :func:`int` and :" "func:`float`. Should return a value of the appropriate type." msgstr "" -#: reference/datamodel.rst:3082 +#: reference/datamodel.rst:3077 msgid "" "Called to implement :func:`operator.index`, and whenever Python needs to " "losslessly convert the numeric object to an integer object (such as in " @@ -3419,14 +3415,14 @@ msgid "" "integer type. Must return an integer." msgstr "" -#: reference/datamodel.rst:3088 +#: reference/datamodel.rst:3083 msgid "" "If :meth:`__int__`, :meth:`__float__` and :meth:`__complex__` are not " "defined then corresponding built-in functions :func:`int`, :func:`float` " "and :func:`complex` fall back to :meth:`__index__`." msgstr "" -#: reference/datamodel.rst:3100 +#: reference/datamodel.rst:3095 msgid "" "Called to implement the built-in function :func:`round` and :mod:`math` " "functions :func:`~math.trunc`, :func:`~math.floor` and :func:`~math.ceil`. " @@ -3435,21 +3431,21 @@ msgid "" "(typically an :class:`int`)." msgstr "" -#: reference/datamodel.rst:3106 +#: reference/datamodel.rst:3101 msgid "" "The built-in function :func:`int` falls back to :meth:`__trunc__` if " "neither :meth:`__int__` nor :meth:`__index__` is defined." msgstr "" -#: reference/datamodel.rst:3109 +#: reference/datamodel.rst:3104 msgid "The delegation of :func:`int` to :meth:`__trunc__` is deprecated." msgstr "" -#: reference/datamodel.rst:3116 +#: reference/datamodel.rst:3111 msgid "With Statement Context Managers" msgstr "" -#: reference/datamodel.rst:3118 +#: reference/datamodel.rst:3113 msgid "" "A :dfn:`context manager` is an object that defines the runtime context to be " "established when executing a :keyword:`with` statement. The context manager " @@ -3459,32 +3455,32 @@ msgid "" "can also be used by directly invoking their methods." msgstr "" -#: reference/datamodel.rst:3129 +#: reference/datamodel.rst:3124 msgid "" "Typical uses of context managers include saving and restoring various kinds " "of global state, locking and unlocking resources, closing opened files, etc." msgstr "" -#: reference/datamodel.rst:3132 +#: reference/datamodel.rst:3127 msgid "" "For more information on context managers, see :ref:`typecontextmanager`." msgstr "" -#: reference/datamodel.rst:3137 +#: reference/datamodel.rst:3132 msgid "" "Enter the runtime context related to this object. The :keyword:`with` " "statement will bind this method's return value to the target(s) specified in " "the :keyword:`!as` clause of the statement, if any." msgstr "" -#: reference/datamodel.rst:3144 +#: reference/datamodel.rst:3139 msgid "" "Exit the runtime context related to this object. The parameters describe the " "exception that caused the context to be exited. If the context was exited " "without an exception, all three arguments will be :const:`None`." msgstr "" -#: reference/datamodel.rst:3148 +#: reference/datamodel.rst:3143 msgid "" "If an exception is supplied, and the method wishes to suppress the exception " "(i.e., prevent it from being propagated), it should return a true value. " @@ -3492,27 +3488,27 @@ msgid "" "method." msgstr "" -#: reference/datamodel.rst:3152 +#: reference/datamodel.rst:3147 msgid "" "Note that :meth:`~object.__exit__` methods should not reraise the passed-in " "exception; this is the caller's responsibility." msgstr "" -#: reference/datamodel.rst:3158 +#: reference/datamodel.rst:3153 msgid ":pep:`343` - The \"with\" statement" msgstr "" -#: reference/datamodel.rst:3159 +#: reference/datamodel.rst:3154 msgid "" "The specification, background, and examples for the Python :keyword:`with` " "statement." msgstr "" -#: reference/datamodel.rst:3166 +#: reference/datamodel.rst:3161 msgid "Customizing positional arguments in class pattern matching" msgstr "" -#: reference/datamodel.rst:3168 +#: reference/datamodel.rst:3163 msgid "" "When using a class name in a pattern, positional arguments in the pattern " "are not allowed by default, i.e. ``case MyClass(x, y)`` is typically invalid " @@ -3520,7 +3516,7 @@ msgid "" "pattern, the class needs to define a *__match_args__* attribute." msgstr "" -#: reference/datamodel.rst:3175 +#: reference/datamodel.rst:3170 msgid "" "This class variable can be assigned a tuple of strings. When this class is " "used in a class pattern with positional arguments, each positional argument " @@ -3529,7 +3525,7 @@ msgid "" "to setting it to ``()``." msgstr "" -#: reference/datamodel.rst:3181 +#: reference/datamodel.rst:3176 msgid "" "For example, if ``MyClass.__match_args__`` is ``(\"left\", \"center\", " "\"right\")`` that means that ``case MyClass(x, y)`` is equivalent to ``case " @@ -3539,19 +3535,19 @@ msgid "" "exc:`TypeError`." msgstr "" -#: reference/datamodel.rst:3191 +#: reference/datamodel.rst:3186 msgid ":pep:`634` - Structural Pattern Matching" msgstr "" -#: reference/datamodel.rst:3192 +#: reference/datamodel.rst:3187 msgid "The specification for the Python ``match`` statement." msgstr "" -#: reference/datamodel.rst:3198 +#: reference/datamodel.rst:3193 msgid "Emulating buffer types" msgstr "" -#: reference/datamodel.rst:3200 +#: reference/datamodel.rst:3195 msgid "" "The :ref:`buffer protocol ` provides a way for Python objects " "to expose efficient access to a low-level memory array. This protocol is " @@ -3559,13 +3555,13 @@ msgid "" "and third-party libraries may define additional buffer types." msgstr "" -#: reference/datamodel.rst:3205 +#: reference/datamodel.rst:3200 msgid "" "While buffer types are usually implemented in C, it is also possible to " "implement the protocol in Python." msgstr "" -#: reference/datamodel.rst:3210 +#: reference/datamodel.rst:3205 msgid "" "Called when a buffer is requested from *self* (for example, by the :class:" "`memoryview` constructor). The *flags* argument is an integer representing " @@ -3575,7 +3571,7 @@ msgid "" "`memoryview` object." msgstr "" -#: reference/datamodel.rst:3219 +#: reference/datamodel.rst:3214 msgid "" "Called when a buffer is no longer needed. The *buffer* argument is a :class:" "`memoryview` object that was previously returned by :meth:`~object." @@ -3584,28 +3580,28 @@ msgid "" "to perform any cleanup are not required to implement this method." msgstr "" -#: reference/datamodel.rst:3230 +#: reference/datamodel.rst:3225 msgid ":pep:`688` - Making the buffer protocol accessible in Python" msgstr "" -#: reference/datamodel.rst:3231 +#: reference/datamodel.rst:3226 msgid "" "Introduces the Python ``__buffer__`` and ``__release_buffer__`` methods." msgstr "" -#: reference/datamodel.rst:3233 +#: reference/datamodel.rst:3228 msgid ":class:`collections.abc.Buffer`" msgstr "" -#: reference/datamodel.rst:3234 +#: reference/datamodel.rst:3229 msgid "ABC for buffer types." msgstr "" -#: reference/datamodel.rst:3239 +#: reference/datamodel.rst:3234 msgid "Special method lookup" msgstr "" -#: reference/datamodel.rst:3241 +#: reference/datamodel.rst:3236 msgid "" "For custom classes, implicit invocations of special methods are only " "guaranteed to work correctly if defined on an object's type, not in the " @@ -3613,7 +3609,7 @@ msgid "" "following code raises an exception::" msgstr "" -#: reference/datamodel.rst:3256 +#: reference/datamodel.rst:3251 msgid "" "The rationale behind this behaviour lies with a number of special methods " "such as :meth:`~object.__hash__` and :meth:`~object.__repr__` that are " @@ -3622,21 +3618,21 @@ msgid "" "invoked on the type object itself::" msgstr "" -#: reference/datamodel.rst:3270 +#: reference/datamodel.rst:3265 msgid "" "Incorrectly attempting to invoke an unbound method of a class in this way is " "sometimes referred to as 'metaclass confusion', and is avoided by bypassing " "the instance when looking up special methods::" msgstr "" -#: reference/datamodel.rst:3279 +#: reference/datamodel.rst:3274 msgid "" "In addition to bypassing any instance attributes in the interest of " "correctness, implicit special method lookup generally also bypasses the :" "meth:`~object.__getattribute__` method even of the object's metaclass::" msgstr "" -#: reference/datamodel.rst:3305 +#: reference/datamodel.rst:3300 msgid "" "Bypassing the :meth:`~object.__getattribute__` machinery in this fashion " "provides significant scope for speed optimisations within the interpreter, " @@ -3645,36 +3641,36 @@ msgid "" "consistently invoked by the interpreter)." msgstr "" -#: reference/datamodel.rst:3316 +#: reference/datamodel.rst:3311 msgid "Coroutines" msgstr "" -#: reference/datamodel.rst:3320 +#: reference/datamodel.rst:3315 msgid "Awaitable Objects" msgstr "" -#: reference/datamodel.rst:3322 +#: reference/datamodel.rst:3317 msgid "" "An :term:`awaitable` object generally implements an :meth:`~object." "__await__` method. :term:`Coroutine objects ` returned from :" "keyword:`async def` functions are awaitable." msgstr "" -#: reference/datamodel.rst:3328 +#: reference/datamodel.rst:3323 msgid "" "The :term:`generator iterator` objects returned from generators decorated " "with :func:`types.coroutine` are also awaitable, but they do not implement :" "meth:`~object.__await__`." msgstr "" -#: reference/datamodel.rst:3334 +#: reference/datamodel.rst:3329 msgid "" "Must return an :term:`iterator`. Should be used to implement :term:" "`awaitable` objects. For instance, :class:`asyncio.Future` implements this " "method to be compatible with the :keyword:`await` expression." msgstr "" -#: reference/datamodel.rst:3340 +#: reference/datamodel.rst:3335 msgid "" "The language doesn't place any restriction on the type or value of the " "objects yielded by the iterator returned by ``__await__``, as this is " @@ -3682,15 +3678,15 @@ msgid "" "g. :mod:`asyncio`) that will be managing the :term:`awaitable` object." msgstr "" -#: reference/datamodel.rst:3348 +#: reference/datamodel.rst:3343 msgid ":pep:`492` for additional information about awaitable objects." msgstr "" -#: reference/datamodel.rst:3354 +#: reference/datamodel.rst:3349 msgid "Coroutine Objects" msgstr "" -#: reference/datamodel.rst:3356 +#: reference/datamodel.rst:3351 msgid "" ":term:`Coroutine objects ` are :term:`awaitable` objects. A " "coroutine's execution can be controlled by calling :meth:`~object.__await__` " @@ -3701,18 +3697,18 @@ msgid "" "should not directly raise unhandled :exc:`StopIteration` exceptions." msgstr "" -#: reference/datamodel.rst:3364 +#: reference/datamodel.rst:3359 msgid "" "Coroutines also have the methods listed below, which are analogous to those " "of generators (see :ref:`generator-methods`). However, unlike generators, " "coroutines do not directly support iteration." msgstr "" -#: reference/datamodel.rst:3368 +#: reference/datamodel.rst:3363 msgid "It is a :exc:`RuntimeError` to await on a coroutine more than once." msgstr "" -#: reference/datamodel.rst:3374 +#: reference/datamodel.rst:3369 msgid "" "Starts or resumes execution of the coroutine. If *value* is ``None``, this " "is equivalent to advancing the iterator returned by :meth:`~object." @@ -3723,7 +3719,7 @@ msgid "" "value, described above." msgstr "" -#: reference/datamodel.rst:3385 +#: reference/datamodel.rst:3380 msgid "" "Raises the specified exception in the coroutine. This method delegates to " "the :meth:`~generator.throw` method of the iterator that caused the " @@ -3734,13 +3730,13 @@ msgid "" "not caught in the coroutine, it propagates back to the caller." msgstr "" -#: reference/datamodel.rst:3396 +#: reference/datamodel.rst:3391 msgid "" "The second signature \\(type\\[, value\\[, traceback\\]\\]\\) is deprecated " "and may be removed in a future version of Python." msgstr "" -#: reference/datamodel.rst:3401 +#: reference/datamodel.rst:3396 msgid "" "Causes the coroutine to clean itself up and exit. If the coroutine is " "suspended, this method first delegates to the :meth:`~generator.close` " @@ -3750,99 +3746,99 @@ msgid "" "is marked as having finished executing, even if it was never started." msgstr "" -#: reference/datamodel.rst:3409 +#: reference/datamodel.rst:3404 msgid "" "Coroutine objects are automatically closed using the above process when they " "are about to be destroyed." msgstr "" -#: reference/datamodel.rst:3415 +#: reference/datamodel.rst:3410 msgid "Asynchronous Iterators" msgstr "" -#: reference/datamodel.rst:3417 +#: reference/datamodel.rst:3412 msgid "" "An *asynchronous iterator* can call asynchronous code in its ``__anext__`` " "method." msgstr "" -#: reference/datamodel.rst:3420 +#: reference/datamodel.rst:3415 msgid "" "Asynchronous iterators can be used in an :keyword:`async for` statement." msgstr "" -#: reference/datamodel.rst:3424 +#: reference/datamodel.rst:3419 msgid "Must return an *asynchronous iterator* object." msgstr "" -#: reference/datamodel.rst:3428 +#: reference/datamodel.rst:3423 msgid "" "Must return an *awaitable* resulting in a next value of the iterator. " "Should raise a :exc:`StopAsyncIteration` error when the iteration is over." msgstr "" -#: reference/datamodel.rst:3431 +#: reference/datamodel.rst:3426 msgid "An example of an asynchronous iterable object::" msgstr "" -#: reference/datamodel.rst:3448 +#: reference/datamodel.rst:3443 msgid "" "Prior to Python 3.7, :meth:`~object.__aiter__` could return an *awaitable* " "that would resolve to an :term:`asynchronous iterator `." msgstr "" -#: reference/datamodel.rst:3453 +#: reference/datamodel.rst:3448 msgid "" "Starting with Python 3.7, :meth:`~object.__aiter__` must return an " "asynchronous iterator object. Returning anything else will result in a :exc:" "`TypeError` error." msgstr "" -#: reference/datamodel.rst:3461 +#: reference/datamodel.rst:3456 msgid "Asynchronous Context Managers" msgstr "" -#: reference/datamodel.rst:3463 +#: reference/datamodel.rst:3458 msgid "" "An *asynchronous context manager* is a *context manager* that is able to " "suspend execution in its ``__aenter__`` and ``__aexit__`` methods." msgstr "" -#: reference/datamodel.rst:3466 +#: reference/datamodel.rst:3461 msgid "" "Asynchronous context managers can be used in an :keyword:`async with` " "statement." msgstr "" -#: reference/datamodel.rst:3470 +#: reference/datamodel.rst:3465 msgid "" "Semantically similar to :meth:`~object.__enter__`, the only difference being " "that it must return an *awaitable*." msgstr "" -#: reference/datamodel.rst:3475 +#: reference/datamodel.rst:3470 msgid "" "Semantically similar to :meth:`~object.__exit__`, the only difference being " "that it must return an *awaitable*." msgstr "" -#: reference/datamodel.rst:3478 +#: reference/datamodel.rst:3473 msgid "An example of an asynchronous context manager class::" msgstr "" -#: reference/datamodel.rst:3491 +#: reference/datamodel.rst:3486 msgid "Footnotes" msgstr "" -#: reference/datamodel.rst:3492 +#: reference/datamodel.rst:3487 msgid "" "It *is* possible in some cases to change an object's type, under certain " "controlled conditions. It generally isn't a good idea though, since it can " "lead to some very strange behaviour if it is handled incorrectly." msgstr "" -#: reference/datamodel.rst:3496 +#: reference/datamodel.rst:3491 msgid "" "The :meth:`~object.__hash__`, :meth:`~object.__iter__`, :meth:`~object." "__reversed__`, and :meth:`~object.__contains__` methods have special " @@ -3850,7 +3846,7 @@ msgid "" "by relying on the behavior that ``None`` is not callable." msgstr "" -#: reference/datamodel.rst:3502 +#: reference/datamodel.rst:3497 msgid "" "\"Does not support\" here means that the class has no such method, or the " "method returns :data:`NotImplemented`. Do not set the method to ``None`` if " @@ -3858,7 +3854,7 @@ msgid "" "instead have the opposite effect of explicitly *blocking* such fallback." msgstr "" -#: reference/datamodel.rst:3508 +#: reference/datamodel.rst:3503 msgid "" "For operands of the same type, it is assumed that if the non-reflected " "method -- such as :meth:`~object.__add__` -- fails then the overall " @@ -3870,10 +3866,10 @@ msgstr "" #: reference/datamodel.rst:292 reference/datamodel.rst:359 #: reference/datamodel.rst:405 reference/datamodel.rst:443 #: reference/datamodel.rst:462 reference/datamodel.rst:515 -#: reference/datamodel.rst:657 reference/datamodel.rst:826 -#: reference/datamodel.rst:938 reference/datamodel.rst:1034 -#: reference/datamodel.rst:1200 reference/datamodel.rst:1407 -#: reference/datamodel.rst:2834 +#: reference/datamodel.rst:657 reference/datamodel.rst:819 +#: reference/datamodel.rst:931 reference/datamodel.rst:1027 +#: reference/datamodel.rst:1193 reference/datamodel.rst:1400 +#: reference/datamodel.rst:2829 msgid "object" msgstr "" @@ -3882,10 +3878,10 @@ msgid "data" msgstr "" #: reference/datamodel.rst:292 reference/datamodel.rst:423 -#: reference/datamodel.rst:802 reference/datamodel.rst:1490 -#: reference/datamodel.rst:1735 reference/datamodel.rst:2375 -#: reference/datamodel.rst:2962 reference/datamodel.rst:3011 -#: reference/datamodel.rst:3070 reference/datamodel.rst:3098 +#: reference/datamodel.rst:795 reference/datamodel.rst:1483 +#: reference/datamodel.rst:1730 reference/datamodel.rst:2370 +#: reference/datamodel.rst:2957 reference/datamodel.rst:3006 +#: reference/datamodel.rst:3065 reference/datamodel.rst:3093 msgid "built-in function" msgstr "" @@ -3893,7 +3889,7 @@ msgstr "" msgid "id" msgstr "" -#: reference/datamodel.rst:122 reference/datamodel.rst:2375 +#: reference/datamodel.rst:122 reference/datamodel.rst:2370 msgid "type" msgstr "" @@ -3929,7 +3925,7 @@ msgstr "" msgid "unreachable object" msgstr "" -#: reference/datamodel.rst:938 +#: reference/datamodel.rst:931 msgid "container" msgstr "" @@ -3942,20 +3938,20 @@ msgid "extension" msgstr "" #: reference/datamodel.rst:396 reference/datamodel.rst:498 -#: reference/datamodel.rst:879 reference/datamodel.rst:1053 +#: reference/datamodel.rst:872 reference/datamodel.rst:1046 msgid "module" msgstr "" -#: reference/datamodel.rst:261 reference/datamodel.rst:802 +#: reference/datamodel.rst:261 reference/datamodel.rst:795 msgid "C" msgstr "" -#: reference/datamodel.rst:261 reference/datamodel.rst:802 +#: reference/datamodel.rst:261 reference/datamodel.rst:795 msgid "language" msgstr "" -#: reference/datamodel.rst:938 reference/datamodel.rst:1007 -#: reference/datamodel.rst:1027 +#: reference/datamodel.rst:931 reference/datamodel.rst:1000 +#: reference/datamodel.rst:1020 msgid "attribute" msgstr "" @@ -3975,7 +3971,7 @@ msgstr "" msgid "ellipsis literal" msgstr "" -#: reference/datamodel.rst:1034 +#: reference/datamodel.rst:1027 msgid "numeric" msgstr "" @@ -4000,7 +3996,7 @@ msgid "True" msgstr "" #: reference/datamodel.rst:261 -msgid "floating point" +msgid "floating-point" msgstr "" #: reference/datamodel.rst:279 @@ -4011,15 +4007,15 @@ msgstr "" msgid "Java" msgstr "" -#: reference/datamodel.rst:3070 +#: reference/datamodel.rst:3065 msgid "complex" msgstr "" -#: reference/datamodel.rst:423 reference/datamodel.rst:2804 +#: reference/datamodel.rst:423 reference/datamodel.rst:2799 msgid "len" msgstr "" -#: reference/datamodel.rst:1034 +#: reference/datamodel.rst:1027 msgid "sequence" msgstr "" @@ -4047,7 +4043,7 @@ msgstr "" msgid "immutable" msgstr "" -#: reference/datamodel.rst:1705 reference/datamodel.rst:1735 +#: reference/datamodel.rst:1700 reference/datamodel.rst:1730 msgid "string" msgstr "" @@ -4083,7 +4079,7 @@ msgstr "" msgid "empty" msgstr "" -#: reference/datamodel.rst:1730 +#: reference/datamodel.rst:1725 msgid "bytes" msgstr "" @@ -4099,12 +4095,12 @@ msgstr "" msgid "mutable" msgstr "" -#: reference/datamodel.rst:956 reference/datamodel.rst:1027 +#: reference/datamodel.rst:949 reference/datamodel.rst:1020 msgid "assignment" msgstr "" -#: reference/datamodel.rst:859 reference/datamodel.rst:1626 -#: reference/datamodel.rst:3125 +#: reference/datamodel.rst:852 reference/datamodel.rst:1619 +#: reference/datamodel.rst:3120 msgid "statement" msgstr "" @@ -4136,11 +4132,11 @@ msgstr "" msgid "frozenset" msgstr "" -#: reference/datamodel.rst:1034 +#: reference/datamodel.rst:1027 msgid "mapping" msgstr "" -#: reference/datamodel.rst:938 reference/datamodel.rst:1819 +#: reference/datamodel.rst:931 reference/datamodel.rst:1814 msgid "dictionary" msgstr "" @@ -4156,12 +4152,12 @@ msgstr "" msgid "callable" msgstr "" -#: reference/datamodel.rst:530 reference/datamodel.rst:764 -#: reference/datamodel.rst:802 +#: reference/datamodel.rst:530 reference/datamodel.rst:757 +#: reference/datamodel.rst:795 msgid "function" msgstr "" -#: reference/datamodel.rst:938 reference/datamodel.rst:2756 +#: reference/datamodel.rst:931 reference/datamodel.rst:2751 msgid "call" msgstr "" @@ -4193,7 +4189,7 @@ msgstr "" msgid "global" msgstr "" -#: reference/datamodel.rst:879 +#: reference/datamodel.rst:872 msgid "namespace" msgstr "" @@ -4233,7 +4229,7 @@ msgstr "" msgid "__type_params__ (function attribute)" msgstr "" -#: reference/datamodel.rst:826 +#: reference/datamodel.rst:819 msgid "method" msgstr "" @@ -4261,527 +4257,527 @@ msgstr "" msgid "__module__ (method attribute)" msgstr "" -#: reference/datamodel.rst:1200 +#: reference/datamodel.rst:1193 msgid "generator" msgstr "" -#: reference/datamodel.rst:746 +#: reference/datamodel.rst:739 msgid "iterator" msgstr "" -#: reference/datamodel.rst:3312 +#: reference/datamodel.rst:3307 msgid "coroutine" msgstr "" -#: reference/datamodel.rst:777 +#: reference/datamodel.rst:770 msgid "asynchronous generator" msgstr "" -#: reference/datamodel.rst:777 +#: reference/datamodel.rst:770 msgid "asynchronous iterator" msgstr "" -#: reference/datamodel.rst:826 +#: reference/datamodel.rst:819 msgid "built-in method" msgstr "" -#: reference/datamodel.rst:826 +#: reference/datamodel.rst:819 msgid "built-in" msgstr "" -#: reference/datamodel.rst:859 +#: reference/datamodel.rst:852 msgid "import" msgstr "" -#: reference/datamodel.rst:879 +#: reference/datamodel.rst:872 msgid "__name__ (module attribute)" msgstr "" -#: reference/datamodel.rst:879 +#: reference/datamodel.rst:872 msgid "__doc__ (module attribute)" msgstr "" -#: reference/datamodel.rst:879 +#: reference/datamodel.rst:872 msgid "__file__ (module attribute)" msgstr "" -#: reference/datamodel.rst:879 +#: reference/datamodel.rst:872 msgid "__annotations__ (module attribute)" msgstr "" -#: reference/datamodel.rst:910 +#: reference/datamodel.rst:903 msgid "__dict__ (module attribute)" msgstr "" -#: reference/datamodel.rst:956 reference/datamodel.rst:1609 -#: reference/datamodel.rst:2486 +#: reference/datamodel.rst:949 reference/datamodel.rst:1602 +#: reference/datamodel.rst:2481 msgid "class" msgstr "" -#: reference/datamodel.rst:1007 reference/datamodel.rst:1027 +#: reference/datamodel.rst:1000 reference/datamodel.rst:1020 msgid "class instance" msgstr "" -#: reference/datamodel.rst:1007 reference/datamodel.rst:2756 +#: reference/datamodel.rst:1000 reference/datamodel.rst:2751 msgid "instance" msgstr "" -#: reference/datamodel.rst:961 +#: reference/datamodel.rst:954 msgid "class object" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:958 msgid "__name__ (class attribute)" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:958 msgid "__module__ (class attribute)" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:958 msgid "__dict__ (class attribute)" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:958 msgid "__bases__ (class attribute)" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:958 msgid "__doc__ (class attribute)" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:958 msgid "__annotations__ (class attribute)" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:958 msgid "__type_params__ (class attribute)" msgstr "" -#: reference/datamodel.rst:1042 +#: reference/datamodel.rst:1035 msgid "__dict__ (instance attribute)" msgstr "" -#: reference/datamodel.rst:1042 +#: reference/datamodel.rst:1035 msgid "__class__ (instance attribute)" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1046 msgid "open" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1046 msgid "io" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1046 msgid "popen() (in module os)" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1046 msgid "makefile() (socket method)" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1046 msgid "sys.stdin" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1046 msgid "sys.stdout" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1046 msgid "sys.stderr" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1046 msgid "stdio" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1046 msgid "stdin (in module sys)" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1046 msgid "stdout (in module sys)" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1046 msgid "stderr (in module sys)" msgstr "" -#: reference/datamodel.rst:1082 +#: reference/datamodel.rst:1075 msgid "internal type" msgstr "" -#: reference/datamodel.rst:1082 +#: reference/datamodel.rst:1075 msgid "types, internal" msgstr "" -#: reference/datamodel.rst:1096 +#: reference/datamodel.rst:1089 msgid "bytecode" msgstr "" -#: reference/datamodel.rst:1096 +#: reference/datamodel.rst:1089 msgid "code" msgstr "" -#: reference/datamodel.rst:1096 +#: reference/datamodel.rst:1089 msgid "code object" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_argcount (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_posonlyargcount (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_kwonlyargcount (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_code (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_consts (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_filename (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_firstlineno (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_flags (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_lnotab (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_name (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_names (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_nlocals (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_stacksize (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_varnames (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_cellvars (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_freevars (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1100 msgid "co_qualname (code object attribute)" msgstr "" -#: reference/datamodel.rst:1218 +#: reference/datamodel.rst:1211 msgid "documentation string" msgstr "" -#: reference/datamodel.rst:1307 +#: reference/datamodel.rst:1300 msgid "frame" msgstr "" -#: reference/datamodel.rst:1313 +#: reference/datamodel.rst:1306 msgid "f_back (frame attribute)" msgstr "" -#: reference/datamodel.rst:1313 +#: reference/datamodel.rst:1306 msgid "f_code (frame attribute)" msgstr "" -#: reference/datamodel.rst:1313 +#: reference/datamodel.rst:1306 msgid "f_globals (frame attribute)" msgstr "" -#: reference/datamodel.rst:1313 +#: reference/datamodel.rst:1306 msgid "f_locals (frame attribute)" msgstr "" -#: reference/datamodel.rst:1313 +#: reference/datamodel.rst:1306 msgid "f_lasti (frame attribute)" msgstr "" -#: reference/datamodel.rst:1313 +#: reference/datamodel.rst:1306 msgid "f_builtins (frame attribute)" msgstr "" -#: reference/datamodel.rst:1352 +#: reference/datamodel.rst:1345 msgid "f_trace (frame attribute)" msgstr "" -#: reference/datamodel.rst:1352 +#: reference/datamodel.rst:1345 msgid "f_trace_lines (frame attribute)" msgstr "" -#: reference/datamodel.rst:1352 +#: reference/datamodel.rst:1345 msgid "f_trace_opcodes (frame attribute)" msgstr "" -#: reference/datamodel.rst:1352 +#: reference/datamodel.rst:1345 msgid "f_lineno (frame attribute)" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1400 msgid "traceback" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1400 msgid "stack" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1400 msgid "trace" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1400 msgid "exception" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1400 msgid "handler" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1400 msgid "execution" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1400 msgid "exc_info (in module sys)" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1400 msgid "last_traceback (in module sys)" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1400 msgid "sys.exc_info" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1400 msgid "sys.exception" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1400 msgid "sys.last_traceback" msgstr "" -#: reference/datamodel.rst:1444 +#: reference/datamodel.rst:1437 msgid "tb_frame (traceback attribute)" msgstr "" -#: reference/datamodel.rst:1444 +#: reference/datamodel.rst:1437 msgid "tb_lineno (traceback attribute)" msgstr "" -#: reference/datamodel.rst:1444 +#: reference/datamodel.rst:1437 msgid "tb_lasti (traceback attribute)" msgstr "" -#: reference/datamodel.rst:1444 +#: reference/datamodel.rst:1437 msgid "try" msgstr "" -#: reference/datamodel.rst:1474 +#: reference/datamodel.rst:1467 msgid "tb_next (traceback attribute)" msgstr "" -#: reference/datamodel.rst:2834 +#: reference/datamodel.rst:2829 msgid "slice" msgstr "" -#: reference/datamodel.rst:1496 +#: reference/datamodel.rst:1489 msgid "start (slice object attribute)" msgstr "" -#: reference/datamodel.rst:1496 +#: reference/datamodel.rst:1489 msgid "stop (slice object attribute)" msgstr "" -#: reference/datamodel.rst:1496 +#: reference/datamodel.rst:1489 msgid "step (slice object attribute)" msgstr "" -#: reference/datamodel.rst:1544 +#: reference/datamodel.rst:1537 msgid "operator" msgstr "" -#: reference/datamodel.rst:1544 +#: reference/datamodel.rst:1537 msgid "overloading" msgstr "" -#: reference/datamodel.rst:1544 +#: reference/datamodel.rst:1537 msgid "__getitem__() (mapping object method)" msgstr "" -#: reference/datamodel.rst:1580 +#: reference/datamodel.rst:1573 msgid "subclassing" msgstr "" -#: reference/datamodel.rst:1580 +#: reference/datamodel.rst:1573 msgid "immutable types" msgstr "" -#: reference/datamodel.rst:1609 +#: reference/datamodel.rst:1602 msgid "constructor" msgstr "" -#: reference/datamodel.rst:1626 +#: reference/datamodel.rst:1619 msgid "destructor" msgstr "" -#: reference/datamodel.rst:1626 +#: reference/datamodel.rst:1619 msgid "finalizer" msgstr "" -#: reference/datamodel.rst:1626 +#: reference/datamodel.rst:1619 msgid "del" msgstr "" -#: reference/datamodel.rst:1688 +#: reference/datamodel.rst:1683 msgid "repr() (built-in function)" msgstr "" -#: reference/datamodel.rst:1688 +#: reference/datamodel.rst:1683 msgid "__repr__() (object method)" msgstr "" -#: reference/datamodel.rst:1705 +#: reference/datamodel.rst:1700 msgid "__str__() (object method)" msgstr "" -#: reference/datamodel.rst:1705 +#: reference/datamodel.rst:1700 msgid "format() (built-in function)" msgstr "" -#: reference/datamodel.rst:1705 +#: reference/datamodel.rst:1700 msgid "print() (built-in function)" msgstr "" -#: reference/datamodel.rst:1735 +#: reference/datamodel.rst:1730 msgid "__format__() (object method)" msgstr "" -#: reference/datamodel.rst:1735 +#: reference/datamodel.rst:1730 msgid "conversion" msgstr "" -#: reference/datamodel.rst:1735 +#: reference/datamodel.rst:1730 msgid "print" msgstr "" -#: reference/datamodel.rst:1774 +#: reference/datamodel.rst:1769 msgid "comparisons" msgstr "" -#: reference/datamodel.rst:1819 +#: reference/datamodel.rst:1814 msgid "hash" msgstr "" -#: reference/datamodel.rst:1900 +#: reference/datamodel.rst:1895 msgid "__len__() (mapping object method)" msgstr "" -#: reference/datamodel.rst:2004 +#: reference/datamodel.rst:1999 msgid "__getattr__ (module attribute)" msgstr "" -#: reference/datamodel.rst:2004 +#: reference/datamodel.rst:1999 msgid "__dir__ (module attribute)" msgstr "" -#: reference/datamodel.rst:2004 +#: reference/datamodel.rst:1999 msgid "__class__ (module attribute)" msgstr "" -#: reference/datamodel.rst:2375 +#: reference/datamodel.rst:2370 msgid "metaclass" msgstr "" -#: reference/datamodel.rst:2375 +#: reference/datamodel.rst:2370 msgid "= (equals)" msgstr "" -#: reference/datamodel.rst:2375 +#: reference/datamodel.rst:2370 msgid "class definition" msgstr "" -#: reference/datamodel.rst:2439 +#: reference/datamodel.rst:2434 msgid "metaclass hint" msgstr "" -#: reference/datamodel.rst:2462 +#: reference/datamodel.rst:2457 msgid "__prepare__ (metaclass method)" msgstr "" -#: reference/datamodel.rst:2486 +#: reference/datamodel.rst:2481 msgid "body" msgstr "" -#: reference/datamodel.rst:2506 +#: reference/datamodel.rst:2501 msgid "__class__ (method cell)" msgstr "" -#: reference/datamodel.rst:2506 +#: reference/datamodel.rst:2501 msgid "__classcell__ (class namespace entry)" msgstr "" -#: reference/datamodel.rst:2804 +#: reference/datamodel.rst:2799 msgid "__bool__() (object method)" msgstr "" -#: reference/datamodel.rst:2997 +#: reference/datamodel.rst:2992 msgid "divmod" msgstr "" -#: reference/datamodel.rst:2997 reference/datamodel.rst:3011 +#: reference/datamodel.rst:2992 reference/datamodel.rst:3006 msgid "pow" msgstr "" -#: reference/datamodel.rst:3060 +#: reference/datamodel.rst:3055 msgid "abs" msgstr "" -#: reference/datamodel.rst:3070 +#: reference/datamodel.rst:3065 msgid "int" msgstr "" -#: reference/datamodel.rst:3070 +#: reference/datamodel.rst:3065 msgid "float" msgstr "" -#: reference/datamodel.rst:3098 +#: reference/datamodel.rst:3093 msgid "round" msgstr "" -#: reference/datamodel.rst:3125 +#: reference/datamodel.rst:3120 msgid "with" msgstr "" -#: reference/datamodel.rst:3125 +#: reference/datamodel.rst:3120 msgid "context manager" msgstr "" diff --git a/reference/expressions.po b/reference/expressions.po index 71a26e172..e8ac5aef4 100644 --- a/reference/expressions.po +++ b/reference/expressions.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -56,7 +56,7 @@ msgstr "" #: reference/expressions.rst:36 msgid "" -"otherwise, if either argument is a floating point number, the other is " +"otherwise, if either argument is a floating-point number, the other is " "converted to floating point;" msgstr "" @@ -100,39 +100,94 @@ msgid "" "`NameError` exception." msgstr "" -#: reference/expressions.rst:86 +#: reference/expressions.rst:87 +msgid "Private name mangling" +msgstr "" + +#: reference/expressions.rst:89 +msgid "" +"When an identifier that textually occurs in a class definition begins with " +"two or more underscore characters and does not end in two or more " +"underscores, it is considered a :dfn:`private name` of that class." +msgstr "" + +#: reference/expressions.rst:95 +msgid "The :ref:`class specifications `." +msgstr "" + +#: reference/expressions.rst:97 +msgid "" +"More precisely, private names are transformed to a longer form before code " +"is generated for them. If the transformed name is longer than 255 " +"characters, implementation-defined truncation may happen." +msgstr "" + +#: reference/expressions.rst:101 +msgid "" +"The transformation is independent of the syntactical context in which the " +"identifier is used but only the following private identifiers are mangled:" +msgstr "" + +#: reference/expressions.rst:104 +msgid "" +"Any name used as the name of a variable that is assigned or read or any name " +"of an attribute being accessed." +msgstr "" + +#: reference/expressions.rst:107 +msgid "" +"The ``__name__`` attribute of nested functions, classes, and type aliases is " +"however not mangled." +msgstr "" + +#: reference/expressions.rst:110 +msgid "" +"The name of imported modules, e.g., ``__spam`` in ``import __spam``. If the " +"module is part of a package (i.e., its name contains a dot), the name is " +"*not* mangled, e.g., the ``__foo`` in ``import __foo.bar`` is not mangled." +msgstr "" + +#: reference/expressions.rst:115 +msgid "" +"The name of an imported member, e.g., ``__f`` in ``from spam import __f``." +msgstr "" + +#: reference/expressions.rst:117 +msgid "The transformation rule is defined as follows:" +msgstr "" + +#: reference/expressions.rst:119 msgid "" -"**Private name mangling:** When an identifier that textually occurs in a " -"class definition begins with two or more underscore characters and does not " -"end in two or more underscores, it is considered a :dfn:`private name` of " -"that class. Private names are transformed to a longer form before code is " -"generated for them. The transformation inserts the class name, with leading " -"underscores removed and a single underscore inserted, in front of the name. " -"For example, the identifier ``__spam`` occurring in a class named ``Ham`` " -"will be transformed to ``_Ham__spam``. This transformation is independent " -"of the syntactical context in which the identifier is used. If the " -"transformed name is extremely long (longer than 255 characters), " -"implementation defined truncation may happen. If the class name consists " -"only of underscores, no transformation is done." +"The class name, with leading underscores removed and a single leading " +"underscore inserted, is inserted in front of the identifier, e.g., the " +"identifier ``__spam`` occurring in a class named ``Foo``, ``_Foo`` or " +"``__Foo`` is transformed to ``_Foo__spam``." msgstr "" -#: reference/expressions.rst:102 +#: reference/expressions.rst:124 +msgid "" +"If the class name consists only of underscores, the transformation is the " +"identity, e.g., the identifier ``__spam`` occurring in a class named ``_`` " +"or ``__`` is left as is." +msgstr "" + +#: reference/expressions.rst:131 msgid "Literals" msgstr "" -#: reference/expressions.rst:106 +#: reference/expressions.rst:135 msgid "Python supports string and bytes literals and various numeric literals:" msgstr "" -#: reference/expressions.rst:112 +#: reference/expressions.rst:141 msgid "" "Evaluation of a literal yields an object of the given type (string, bytes, " -"integer, floating point number, complex number) with the given value. The " -"value may be approximated in the case of floating point and imaginary " +"integer, floating-point number, complex number) with the given value. The " +"value may be approximated in the case of floating-point and imaginary " "(complex) literals. See section :ref:`literals` for details." msgstr "" -#: reference/expressions.rst:121 +#: reference/expressions.rst:150 msgid "" "All literals correspond to immutable data types, and hence the object's " "identity is less important than its value. Multiple evaluations of literals " @@ -141,30 +196,30 @@ msgid "" "the same value." msgstr "" -#: reference/expressions.rst:131 +#: reference/expressions.rst:160 msgid "Parenthesized forms" msgstr "" -#: reference/expressions.rst:137 +#: reference/expressions.rst:166 msgid "" "A parenthesized form is an optional expression list enclosed in parentheses:" msgstr "" -#: reference/expressions.rst:142 +#: reference/expressions.rst:171 msgid "" "A parenthesized expression list yields whatever that expression list yields: " "if the list contains at least one comma, it yields a tuple; otherwise, it " "yields the single expression that makes up the expression list." msgstr "" -#: reference/expressions.rst:148 +#: reference/expressions.rst:177 msgid "" "An empty pair of parentheses yields an empty tuple object. Since tuples are " "immutable, the same rules as for literals apply (i.e., two occurrences of " "the empty tuple may or may not yield the same object)." msgstr "" -#: reference/expressions.rst:156 +#: reference/expressions.rst:185 msgid "" "Note that tuples are not formed by the parentheses, but rather by use of the " "comma. The exception is the empty tuple, for which parentheses *are* " @@ -172,31 +227,31 @@ msgid "" "ambiguities and allow common typos to pass uncaught." msgstr "" -#: reference/expressions.rst:165 +#: reference/expressions.rst:194 msgid "Displays for lists, sets and dictionaries" msgstr "" -#: reference/expressions.rst:169 +#: reference/expressions.rst:198 msgid "" "For constructing a list, a set or a dictionary Python provides special " "syntax called \"displays\", each of them in two flavors:" msgstr "" -#: reference/expressions.rst:172 +#: reference/expressions.rst:201 msgid "either the container contents are listed explicitly, or" msgstr "" -#: reference/expressions.rst:174 +#: reference/expressions.rst:203 msgid "" "they are computed via a set of looping and filtering instructions, called a :" "dfn:`comprehension`." msgstr "" -#: reference/expressions.rst:182 +#: reference/expressions.rst:211 msgid "Common syntax elements for comprehensions are:" msgstr "" -#: reference/expressions.rst:190 +#: reference/expressions.rst:219 msgid "" "The comprehension consists of a single expression followed by at least one :" "keyword:`!for` clause and zero or more :keyword:`!for` or :keyword:`!if` " @@ -206,7 +261,7 @@ msgid "" "expression to produce an element each time the innermost block is reached." msgstr "" -#: reference/expressions.rst:197 +#: reference/expressions.rst:226 msgid "" "However, aside from the iterable expression in the leftmost :keyword:`!for` " "clause, the comprehension is executed in a separate implicitly nested scope. " @@ -214,7 +269,7 @@ msgid "" "the enclosing scope." msgstr "" -#: reference/expressions.rst:201 +#: reference/expressions.rst:230 msgid "" "The iterable expression in the leftmost :keyword:`!for` clause is evaluated " "directly in the enclosing scope and then passed as an argument to the " @@ -224,52 +279,58 @@ msgid "" "iterable. For example: ``[x*y for x in range(10) for y in range(x, x+10)]``." msgstr "" -#: reference/expressions.rst:208 +#: reference/expressions.rst:237 msgid "" "To ensure the comprehension always results in a container of the appropriate " "type, ``yield`` and ``yield from`` expressions are prohibited in the " "implicitly nested scope." msgstr "" -#: reference/expressions.rst:215 +#: reference/expressions.rst:244 msgid "" "Since Python 3.6, in an :keyword:`async def` function, an :keyword:`!async " "for` clause may be used to iterate over a :term:`asynchronous iterator`. A " "comprehension in an :keyword:`!async def` function may consist of either a :" "keyword:`!for` or :keyword:`!async for` clause following the leading " "expression, may contain additional :keyword:`!for` or :keyword:`!async for` " -"clauses, and may also use :keyword:`await` expressions. If a comprehension " -"contains either :keyword:`!async for` clauses or :keyword:`!await` " -"expressions or other asynchronous comprehensions it is called an :dfn:" -"`asynchronous comprehension`. An asynchronous comprehension may suspend the " -"execution of the coroutine function in which it appears. See also :pep:`530`." +"clauses, and may also use :keyword:`await` expressions." +msgstr "" + +#: reference/expressions.rst:251 +msgid "" +"If a comprehension contains :keyword:`!async for` clauses, or if it " +"contains :keyword:`!await` expressions or other asynchronous comprehensions " +"anywhere except the iterable expression in the leftmost :keyword:`!for` " +"clause, it is called an :dfn:`asynchronous comprehension`. An asynchronous " +"comprehension may suspend the execution of the coroutine function in which " +"it appears. See also :pep:`530`." msgstr "" -#: reference/expressions.rst:227 +#: reference/expressions.rst:258 msgid "Asynchronous comprehensions were introduced." msgstr "" -#: reference/expressions.rst:408 +#: reference/expressions.rst:439 msgid "``yield`` and ``yield from`` prohibited in the implicitly nested scope." msgstr "" -#: reference/expressions.rst:233 +#: reference/expressions.rst:264 msgid "" "Asynchronous comprehensions are now allowed inside comprehensions in " "asynchronous functions. Outer comprehensions implicitly become asynchronous." msgstr "" -#: reference/expressions.rst:242 +#: reference/expressions.rst:273 msgid "List displays" msgstr "" -#: reference/expressions.rst:252 +#: reference/expressions.rst:283 msgid "" "A list display is a possibly empty series of expressions enclosed in square " "brackets:" msgstr "" -#: reference/expressions.rst:258 +#: reference/expressions.rst:289 msgid "" "A list display yields a new list object, the contents being specified by " "either a list of expressions or a comprehension. When a comma-separated " @@ -279,17 +340,17 @@ msgid "" "comprehension." msgstr "" -#: reference/expressions.rst:268 +#: reference/expressions.rst:299 msgid "Set displays" msgstr "" -#: reference/expressions.rst:277 +#: reference/expressions.rst:308 msgid "" "A set display is denoted by curly braces and distinguishable from dictionary " "displays by the lack of colons separating keys and values:" msgstr "" -#: reference/expressions.rst:283 +#: reference/expressions.rst:314 msgid "" "A set display yields a new mutable set object, the contents being specified " "by either a sequence of expressions or a comprehension. When a comma-" @@ -299,27 +360,27 @@ msgid "" "comprehension." msgstr "" -#: reference/expressions.rst:289 +#: reference/expressions.rst:320 msgid "" "An empty set cannot be constructed with ``{}``; this literal constructs an " "empty dictionary." msgstr "" -#: reference/expressions.rst:296 +#: reference/expressions.rst:327 msgid "Dictionary displays" msgstr "" -#: reference/expressions.rst:307 +#: reference/expressions.rst:338 msgid "" "A dictionary display is a possibly empty series of dict items (key/value " "pairs) enclosed in curly braces:" msgstr "" -#: reference/expressions.rst:316 +#: reference/expressions.rst:347 msgid "A dictionary display yields a new dictionary object." msgstr "" -#: reference/expressions.rst:318 +#: reference/expressions.rst:349 msgid "" "If a comma-separated sequence of dict items is given, they are evaluated " "from left to right to define the entries of the dictionary: each key object " @@ -329,7 +390,7 @@ msgid "" "given." msgstr "" -#: reference/expressions.rst:328 +#: reference/expressions.rst:359 msgid "" "A double asterisk ``**`` denotes :dfn:`dictionary unpacking`. Its operand " "must be a :term:`mapping`. Each mapping item is added to the new " @@ -337,11 +398,11 @@ msgid "" "and earlier dictionary unpackings." msgstr "" -#: reference/expressions.rst:333 +#: reference/expressions.rst:364 msgid "Unpacking into dictionary displays, originally proposed by :pep:`448`." msgstr "" -#: reference/expressions.rst:336 +#: reference/expressions.rst:367 msgid "" "A dict comprehension, in contrast to list and set comprehensions, needs two " "expressions separated with a colon followed by the usual \"for\" and \"if\" " @@ -349,7 +410,7 @@ msgid "" "are inserted in the new dictionary in the order they are produced." msgstr "" -#: reference/expressions.rst:344 +#: reference/expressions.rst:375 msgid "" "Restrictions on the types of the key values are listed earlier in section :" "ref:`types`. (To summarize, the key type should be :term:`hashable`, which " @@ -358,7 +419,7 @@ msgid "" "given key value prevails." msgstr "" -#: reference/expressions.rst:350 +#: reference/expressions.rst:381 msgid "" "Prior to Python 3.8, in dict comprehensions, the evaluation order of key and " "value was not well-defined. In CPython, the value was evaluated before the " @@ -366,22 +427,22 @@ msgid "" "by :pep:`572`." msgstr "" -#: reference/expressions.rst:360 +#: reference/expressions.rst:391 msgid "Generator expressions" msgstr "" -#: reference/expressions.rst:367 +#: reference/expressions.rst:398 msgid "A generator expression is a compact generator notation in parentheses:" msgstr "" -#: reference/expressions.rst:372 +#: reference/expressions.rst:403 msgid "" "A generator expression yields a new generator object. Its syntax is the " "same as for comprehensions, except that it is enclosed in parentheses " "instead of brackets or curly braces." msgstr "" -#: reference/expressions.rst:376 +#: reference/expressions.rst:407 msgid "" "Variables used in the generator expression are evaluated lazily when the :" "meth:`~generator.__next__` method is called for the generator object (in the " @@ -395,20 +456,20 @@ msgid "" "``(x*y for x in range(10) for y in range(x, x+10))``." msgstr "" -#: reference/expressions.rst:387 +#: reference/expressions.rst:418 msgid "" "The parentheses can be omitted on calls with only one argument. See " "section :ref:`calls` for details." msgstr "" -#: reference/expressions.rst:390 +#: reference/expressions.rst:421 msgid "" "To avoid interfering with the expected operation of the generator expression " "itself, ``yield`` and ``yield from`` expressions are prohibited in the " "implicitly defined generator." msgstr "" -#: reference/expressions.rst:394 +#: reference/expressions.rst:425 msgid "" "If a generator expression contains either :keyword:`!async for` clauses or :" "keyword:`await` expressions it is called an :dfn:`asynchronous generator " @@ -417,22 +478,22 @@ msgid "" "`async-iterators`)." msgstr "" -#: reference/expressions.rst:400 +#: reference/expressions.rst:431 msgid "Asynchronous generator expressions were introduced." msgstr "" -#: reference/expressions.rst:403 +#: reference/expressions.rst:434 msgid "" "Prior to Python 3.7, asynchronous generator expressions could only appear " "in :keyword:`async def` coroutines. Starting with 3.7, any function can use " "asynchronous generator expressions." msgstr "" -#: reference/expressions.rst:415 +#: reference/expressions.rst:446 msgid "Yield expressions" msgstr "" -#: reference/expressions.rst:428 +#: reference/expressions.rst:459 msgid "" "The yield expression is used when defining a :term:`generator` function or " "an :term:`asynchronous generator` function and thus can only be used in the " @@ -442,27 +503,27 @@ msgid "" "asynchronous generator function. For example::" msgstr "" -#: reference/expressions.rst:441 +#: reference/expressions.rst:472 msgid "" "Due to their side effects on the containing scope, ``yield`` expressions are " "not permitted as part of the implicitly defined scopes used to implement " "comprehensions and generator expressions." msgstr "" -#: reference/expressions.rst:445 +#: reference/expressions.rst:476 msgid "" "Yield expressions prohibited in the implicitly nested scopes used to " "implement comprehensions and generator expressions." msgstr "" -#: reference/expressions.rst:449 +#: reference/expressions.rst:480 msgid "" "Generator functions are described below, while asynchronous generator " "functions are described separately in section :ref:`asynchronous-generator-" "functions`." msgstr "" -#: reference/expressions.rst:453 +#: reference/expressions.rst:484 msgid "" "When a generator function is called, it returns an iterator known as a " "generator. That generator then controls the execution of the generator " @@ -483,7 +544,7 @@ msgid "" "be the value passed in to that method." msgstr "" -#: reference/expressions.rst:473 +#: reference/expressions.rst:504 msgid "" "All of this makes generator functions quite similar to coroutines; they " "yield multiple times, they have more than one entry point and their " @@ -492,7 +553,7 @@ msgid "" "the control is always transferred to the generator's caller." msgstr "" -#: reference/expressions.rst:479 +#: reference/expressions.rst:510 msgid "" "Yield expressions are allowed anywhere in a :keyword:`try` construct. If " "the generator is not resumed before it is finalized (by reaching a zero " @@ -501,7 +562,7 @@ msgid "" "`finally` clauses to execute." msgstr "" -#: reference/expressions.rst:488 +#: reference/expressions.rst:519 msgid "" "When ``yield from `` is used, the supplied expression must be an " "iterable. The values produced by iterating that iterable are passed directly " @@ -513,7 +574,7 @@ msgid "" "will just raise the passed in exception immediately." msgstr "" -#: reference/expressions.rst:497 +#: reference/expressions.rst:528 msgid "" "When the underlying iterator is complete, the :attr:`~StopIteration.value` " "attribute of the raised :exc:`StopIteration` instance becomes the value of " @@ -522,73 +583,73 @@ msgid "" "returning a value from the subgenerator)." msgstr "" -#: reference/expressions.rst:503 +#: reference/expressions.rst:534 msgid "Added ``yield from `` to delegate control flow to a subiterator." msgstr "" -#: reference/expressions.rst:506 +#: reference/expressions.rst:537 msgid "" "The parentheses may be omitted when the yield expression is the sole " "expression on the right hand side of an assignment statement." msgstr "" -#: reference/expressions.rst:511 +#: reference/expressions.rst:542 msgid ":pep:`255` - Simple Generators" msgstr "" -#: reference/expressions.rst:512 +#: reference/expressions.rst:543 msgid "" "The proposal for adding generators and the :keyword:`yield` statement to " "Python." msgstr "" -#: reference/expressions.rst:514 +#: reference/expressions.rst:545 msgid ":pep:`342` - Coroutines via Enhanced Generators" msgstr "" -#: reference/expressions.rst:515 +#: reference/expressions.rst:546 msgid "" "The proposal to enhance the API and syntax of generators, making them usable " "as simple coroutines." msgstr "" -#: reference/expressions.rst:518 +#: reference/expressions.rst:549 msgid ":pep:`380` - Syntax for Delegating to a Subgenerator" msgstr "" -#: reference/expressions.rst:519 +#: reference/expressions.rst:550 msgid "" "The proposal to introduce the :token:`~python-grammar:yield_from` syntax, " "making delegation to subgenerators easy." msgstr "" -#: reference/expressions.rst:522 +#: reference/expressions.rst:553 msgid ":pep:`525` - Asynchronous Generators" msgstr "" -#: reference/expressions.rst:523 +#: reference/expressions.rst:554 msgid "" "The proposal that expanded on :pep:`492` by adding generator capabilities to " "coroutine functions." msgstr "" -#: reference/expressions.rst:530 +#: reference/expressions.rst:561 msgid "Generator-iterator methods" msgstr "" -#: reference/expressions.rst:532 +#: reference/expressions.rst:563 msgid "" "This subsection describes the methods of a generator iterator. They can be " "used to control the execution of a generator function." msgstr "" -#: reference/expressions.rst:535 +#: reference/expressions.rst:566 msgid "" "Note that calling any of the generator methods below when the generator is " "already executing raises a :exc:`ValueError` exception." msgstr "" -#: reference/expressions.rst:543 +#: reference/expressions.rst:574 msgid "" "Starts the execution of a generator function or resumes it at the last " "executed yield expression. When a generator function is resumed with a :" @@ -600,13 +661,13 @@ msgid "" "`StopIteration` exception is raised." msgstr "" -#: reference/expressions.rst:552 +#: reference/expressions.rst:583 msgid "" "This method is normally called implicitly, e.g. by a :keyword:`for` loop, or " "by the built-in :func:`next` function." msgstr "" -#: reference/expressions.rst:558 +#: reference/expressions.rst:589 msgid "" "Resumes the execution and \"sends\" a value into the generator function. " "The *value* argument becomes the result of the current yield expression. " @@ -617,7 +678,7 @@ msgid "" "expression that could receive the value." msgstr "" -#: reference/expressions.rst:570 +#: reference/expressions.rst:601 msgid "" "Raises an exception at the point where the generator was paused, and returns " "the next value yielded by the generator function. If the generator exits " @@ -626,13 +687,13 @@ msgid "" "a different exception, then that exception propagates to the caller." msgstr "" -#: reference/expressions.rst:576 +#: reference/expressions.rst:607 msgid "" "In typical use, this is called with a single exception instance similar to " "the way the :keyword:`raise` keyword is used." msgstr "" -#: reference/expressions.rst:579 +#: reference/expressions.rst:610 msgid "" "For backwards compatibility, however, the second signature is supported, " "following a convention from older versions of Python. The *type* argument " @@ -643,13 +704,13 @@ msgid "" "*value* may be cleared." msgstr "" -#: reference/expressions.rst:764 +#: reference/expressions.rst:795 msgid "" "The second signature \\(type\\[, value\\[, traceback\\]\\]\\) is deprecated " "and may be removed in a future version of Python." msgstr "" -#: reference/expressions.rst:598 +#: reference/expressions.rst:629 msgid "" "Raises a :exc:`GeneratorExit` at the point where the generator function was " "paused. If the generator function then exits gracefully, is already closed, " @@ -660,34 +721,34 @@ msgid "" "has already exited due to an exception or normal exit." msgstr "" -#: reference/expressions.rst:609 +#: reference/expressions.rst:640 msgid "Examples" msgstr "" -#: reference/expressions.rst:611 +#: reference/expressions.rst:642 msgid "" "Here is a simple example that demonstrates the behavior of generators and " "generator functions::" msgstr "" -#: reference/expressions.rst:638 +#: reference/expressions.rst:669 msgid "" "For examples using ``yield from``, see :ref:`pep-380` in \"What's New in " "Python.\"" msgstr "" -#: reference/expressions.rst:644 +#: reference/expressions.rst:675 msgid "Asynchronous generator functions" msgstr "" -#: reference/expressions.rst:646 +#: reference/expressions.rst:677 msgid "" "The presence of a yield expression in a function or method defined using :" "keyword:`async def` further defines the function as an :term:`asynchronous " "generator` function." msgstr "" -#: reference/expressions.rst:650 +#: reference/expressions.rst:681 msgid "" "When an asynchronous generator function is called, it returns an " "asynchronous iterator known as an asynchronous generator object. That object " @@ -697,7 +758,7 @@ msgid "" "keyword:`for` statement." msgstr "" -#: reference/expressions.rst:657 +#: reference/expressions.rst:688 msgid "" "Calling one of the asynchronous generator's methods returns an :term:" "`awaitable` object, and the execution starts when this object is awaited on. " @@ -716,7 +777,7 @@ msgid "" "method." msgstr "" -#: reference/expressions.rst:672 +#: reference/expressions.rst:703 msgid "" "If an asynchronous generator happens to exit early by :keyword:`break`, the " "caller task being cancelled, or other exceptions, the generator's async " @@ -728,7 +789,7 @@ msgid "" "generator and ultimately detach it from the event loop." msgstr "" -#: reference/expressions.rst:682 +#: reference/expressions.rst:713 msgid "" "In an asynchronous generator function, yield expressions are allowed " "anywhere in a :keyword:`try` construct. However, if an asynchronous " @@ -742,7 +803,7 @@ msgid "" "finally` clauses to execute." msgstr "" -#: reference/expressions.rst:693 +#: reference/expressions.rst:724 msgid "" "To take care of finalization upon event loop termination, an event loop " "should define a *finalizer* function which takes an asynchronous generator-" @@ -755,23 +816,23 @@ msgid "" "asyncio/base_events.py`." msgstr "" -#: reference/expressions.rst:702 +#: reference/expressions.rst:733 msgid "" "The expression ``yield from `` is a syntax error when used in an " "asynchronous generator function." msgstr "" -#: reference/expressions.rst:709 +#: reference/expressions.rst:740 msgid "Asynchronous generator-iterator methods" msgstr "" -#: reference/expressions.rst:711 +#: reference/expressions.rst:742 msgid "" "This subsection describes the methods of an asynchronous generator iterator, " "which are used to control the execution of a generator function." msgstr "" -#: reference/expressions.rst:719 +#: reference/expressions.rst:750 msgid "" "Returns an awaitable which when run starts to execute the asynchronous " "generator or resumes it at the last executed yield expression. When an " @@ -786,12 +847,12 @@ msgid "" "has completed." msgstr "" -#: reference/expressions.rst:731 +#: reference/expressions.rst:762 msgid "" "This method is normally called implicitly by a :keyword:`async for` loop." msgstr "" -#: reference/expressions.rst:736 +#: reference/expressions.rst:767 msgid "" "Returns an awaitable which when run resumes the execution of the " "asynchronous generator. As with the :meth:`~generator.send()` method for a " @@ -806,7 +867,7 @@ msgid "" "receive the value." msgstr "" -#: reference/expressions.rst:752 +#: reference/expressions.rst:783 msgid "" "Returns an awaitable that raises an exception of type ``type`` at the point " "where the asynchronous generator was paused, and returns the next value " @@ -818,7 +879,7 @@ msgid "" "that exception propagates to the caller of the awaitable." msgstr "" -#: reference/expressions.rst:772 +#: reference/expressions.rst:803 msgid "" "Returns an awaitable that when run will throw a :exc:`GeneratorExit` into " "the asynchronous generator function at the point where it was paused. If the " @@ -834,25 +895,25 @@ msgid "" "will return an awaitable that does nothing." msgstr "" -#: reference/expressions.rst:788 +#: reference/expressions.rst:819 msgid "Primaries" msgstr "" -#: reference/expressions.rst:792 +#: reference/expressions.rst:823 msgid "" "Primaries represent the most tightly bound operations of the language. Their " "syntax is:" msgstr "" -#: reference/expressions.rst:802 +#: reference/expressions.rst:833 msgid "Attribute references" msgstr "" -#: reference/expressions.rst:808 +#: reference/expressions.rst:839 msgid "An attribute reference is a primary followed by a period and a name:" msgstr "" -#: reference/expressions.rst:818 +#: reference/expressions.rst:849 msgid "" "The primary must evaluate to an object of a type that supports attribute " "references, which most objects do. This object is then asked to produce the " @@ -861,7 +922,7 @@ msgid "" "reference may yield different objects." msgstr "" -#: reference/expressions.rst:824 +#: reference/expressions.rst:855 msgid "" "This production can be customized by overriding the :meth:`~object." "__getattribute__` method or the :meth:`~object.__getattr__` method. The :" @@ -869,17 +930,17 @@ msgid "" "or raises :exc:`AttributeError` if the attribute is not available." msgstr "" -#: reference/expressions.rst:830 +#: reference/expressions.rst:861 msgid "" "If an :exc:`AttributeError` is raised and the object has a :meth:`!" "__getattr__` method, that method is called as a fallback." msgstr "" -#: reference/expressions.rst:836 +#: reference/expressions.rst:867 msgid "Subscriptions" msgstr "" -#: reference/expressions.rst:851 +#: reference/expressions.rst:882 msgid "" "The subscription of an instance of a :ref:`container class ` " "will generally select an element from the container. The subscription of a :" @@ -887,13 +948,13 @@ msgid "" "`GenericAlias ` object." msgstr "" -#: reference/expressions.rst:859 +#: reference/expressions.rst:890 msgid "" "When an object is subscripted, the interpreter will evaluate the primary and " "the expression list." msgstr "" -#: reference/expressions.rst:862 +#: reference/expressions.rst:893 msgid "" "The primary must evaluate to an object that supports subscription. An object " "may support subscription through defining one or both of :meth:`~object." @@ -903,20 +964,20 @@ msgid "" "called instead of ``__getitem__``, see :ref:`classgetitem-versus-getitem`." msgstr "" -#: reference/expressions.rst:869 +#: reference/expressions.rst:900 msgid "" "If the expression list contains at least one comma, it will evaluate to a :" "class:`tuple` containing the items of the expression list. Otherwise, the " "expression list will evaluate to the value of the list's sole member." msgstr "" -#: reference/expressions.rst:873 +#: reference/expressions.rst:904 msgid "" "For built-in objects, there are two types of objects that support " "subscription via :meth:`~object.__getitem__`:" msgstr "" -#: reference/expressions.rst:876 +#: reference/expressions.rst:907 msgid "" "Mappings. If the primary is a :term:`mapping`, the expression list must " "evaluate to an object whose value is one of the keys of the mapping, and the " @@ -924,7 +985,7 @@ msgid "" "An example of a builtin mapping class is the :class:`dict` class." msgstr "" -#: reference/expressions.rst:880 +#: reference/expressions.rst:911 msgid "" "Sequences. If the primary is a :term:`sequence`, the expression list must " "evaluate to an :class:`int` or a :class:`slice` (as discussed in the " @@ -932,7 +993,7 @@ msgid "" "`str`, :class:`list` and :class:`tuple` classes." msgstr "" -#: reference/expressions.rst:885 +#: reference/expressions.rst:916 msgid "" "The formal syntax makes no special provision for negative indices in :term:" "`sequences `. However, built-in sequences all provide a :meth:" @@ -946,25 +1007,25 @@ msgid "" "explicitly add that support." msgstr "" -#: reference/expressions.rst:899 +#: reference/expressions.rst:930 msgid "" "A :class:`string ` is a special kind of sequence whose items are " "*characters*. A character is not a separate data type but a string of " "exactly one character." msgstr "" -#: reference/expressions.rst:907 +#: reference/expressions.rst:938 msgid "Slicings" msgstr "" -#: reference/expressions.rst:921 +#: reference/expressions.rst:952 msgid "" "A slicing selects a range of items in a sequence object (e.g., a string, " "tuple or list). Slicings may be used as expressions or as targets in " "assignment or :keyword:`del` statements. The syntax for a slicing:" msgstr "" -#: reference/expressions.rst:934 +#: reference/expressions.rst:965 msgid "" "There is ambiguity in the formal syntax here: anything that looks like an " "expression list also looks like a slice list, so any subscription can be " @@ -974,7 +1035,7 @@ msgid "" "the case if the slice list contains no proper slice)." msgstr "" -#: reference/expressions.rst:946 +#: reference/expressions.rst:977 msgid "" "The semantics for a slicing are as follows. The primary is indexed (using " "the same :meth:`~object.__getitem__` method as normal subscription) with a " @@ -989,23 +1050,23 @@ msgid "" "missing expressions." msgstr "" -#: reference/expressions.rst:970 +#: reference/expressions.rst:1001 msgid "Calls" msgstr "" -#: reference/expressions.rst:972 +#: reference/expressions.rst:1003 msgid "" "A call calls a callable object (e.g., a :term:`function`) with a possibly " "empty series of :term:`arguments `:" msgstr "" -#: reference/expressions.rst:989 +#: reference/expressions.rst:1020 msgid "" "An optional trailing comma may be present after the positional and keyword " "arguments but does not affect the semantics." msgstr "" -#: reference/expressions.rst:995 +#: reference/expressions.rst:1026 msgid "" "The primary must evaluate to a callable object (user-defined functions, " "built-in functions, methods of built-in objects, class objects, methods of " @@ -1015,7 +1076,7 @@ msgid "" "formal :term:`parameter` lists." msgstr "" -#: reference/expressions.rst:1003 +#: reference/expressions.rst:1034 msgid "" "If keyword arguments are present, they are first converted to positional " "arguments, as follows. First, a list of unfilled slots is created for the " @@ -1036,7 +1097,7 @@ msgid "" "filled slots is used as the argument list for the call." msgstr "" -#: reference/expressions.rst:1023 +#: reference/expressions.rst:1054 msgid "" "An implementation may provide built-in functions whose positional parameters " "do not have names, even if they are 'named' for the purpose of " @@ -1045,7 +1106,7 @@ msgid "" "`PyArg_ParseTuple` to parse their arguments." msgstr "" -#: reference/expressions.rst:1029 +#: reference/expressions.rst:1060 msgid "" "If there are more positional arguments than there are formal parameter " "slots, a :exc:`TypeError` exception is raised, unless a formal parameter " @@ -1054,7 +1115,7 @@ msgid "" "empty tuple if there were no excess positional arguments)." msgstr "" -#: reference/expressions.rst:1035 +#: reference/expressions.rst:1066 msgid "" "If any keyword argument does not correspond to a formal parameter name, a :" "exc:`TypeError` exception is raised, unless a formal parameter using the " @@ -1064,7 +1125,7 @@ msgid "" "(new) empty dictionary if there were no excess keyword arguments." msgstr "" -#: reference/expressions.rst:1046 +#: reference/expressions.rst:1077 msgid "" "If the syntax ``*expression`` appears in the function call, ``expression`` " "must evaluate to an :term:`iterable`. Elements from these iterables are " @@ -1074,20 +1135,20 @@ msgid "" "*y1*, ..., *yM*, *x3*, *x4*." msgstr "" -#: reference/expressions.rst:1053 +#: reference/expressions.rst:1084 msgid "" "A consequence of this is that although the ``*expression`` syntax may appear " "*after* explicit keyword arguments, it is processed *before* the keyword " "arguments (and any ``**expression`` arguments -- see below). So::" msgstr "" -#: reference/expressions.rst:1069 +#: reference/expressions.rst:1100 msgid "" "It is unusual for both keyword arguments and the ``*expression`` syntax to " "be used in the same call, so in practice this confusion does not often arise." msgstr "" -#: reference/expressions.rst:1075 +#: reference/expressions.rst:1106 msgid "" "If the syntax ``**expression`` appears in the function call, ``expression`` " "must evaluate to a :term:`mapping`, the contents of which are treated as " @@ -1096,7 +1157,7 @@ msgid "" "a :exc:`TypeError` exception is raised." msgstr "" -#: reference/expressions.rst:1081 +#: reference/expressions.rst:1112 msgid "" "When ``**expression`` is used, each key in this mapping must be a string. " "Each value from the mapping is assigned to the first formal parameter " @@ -1108,35 +1169,35 @@ msgid "" "is raised." msgstr "" -#: reference/expressions.rst:1091 +#: reference/expressions.rst:1122 msgid "" "Formal parameters using the syntax ``*identifier`` or ``**identifier`` " "cannot be used as positional argument slots or as keyword argument names." msgstr "" -#: reference/expressions.rst:1094 +#: reference/expressions.rst:1125 msgid "" "Function calls accept any number of ``*`` and ``**`` unpackings, positional " "arguments may follow iterable unpackings (``*``), and keyword arguments may " "follow dictionary unpackings (``**``). Originally proposed by :pep:`448`." msgstr "" -#: reference/expressions.rst:1100 +#: reference/expressions.rst:1131 msgid "" "A call always returns some value, possibly ``None``, unless it raises an " "exception. How this value is computed depends on the type of the callable " "object." msgstr "" -#: reference/expressions.rst:1104 +#: reference/expressions.rst:1135 msgid "If it is---" msgstr "" -#: reference/expressions.rst:1106 +#: reference/expressions.rst:1137 msgid "a user-defined function:" msgstr "" -#: reference/expressions.rst:1113 +#: reference/expressions.rst:1144 msgid "" "The code block for the function is executed, passing it the argument list. " "The first thing the code block will do is bind the formal parameters to the " @@ -1145,73 +1206,73 @@ msgid "" "value of the function call." msgstr "" -#: reference/expressions.rst:1119 +#: reference/expressions.rst:1150 msgid "a built-in function or method:" msgstr "" -#: reference/expressions.rst:1130 +#: reference/expressions.rst:1161 msgid "" "The result is up to the interpreter; see :ref:`built-in-funcs` for the " "descriptions of built-in functions and methods." msgstr "" -#: reference/expressions.rst:1133 +#: reference/expressions.rst:1164 msgid "a class object:" msgstr "" -#: reference/expressions.rst:1138 +#: reference/expressions.rst:1169 msgid "A new instance of that class is returned." msgstr "" -#: reference/expressions.rst:1140 +#: reference/expressions.rst:1171 msgid "a class instance method:" msgstr "" -#: reference/expressions.rst:1146 +#: reference/expressions.rst:1177 msgid "" "The corresponding user-defined function is called, with an argument list " "that is one longer than the argument list of the call: the instance becomes " "the first argument." msgstr "" -#: reference/expressions.rst:1150 +#: reference/expressions.rst:1181 msgid "a class instance:" msgstr "" -#: reference/expressions.rst:1155 +#: reference/expressions.rst:1186 msgid "" "The class must define a :meth:`~object.__call__` method; the effect is then " "the same as if that method was called." msgstr "" -#: reference/expressions.rst:1946 +#: reference/expressions.rst:1987 msgid "Await expression" msgstr "" -#: reference/expressions.rst:1165 +#: reference/expressions.rst:1196 msgid "" "Suspend the execution of :term:`coroutine` on an :term:`awaitable` object. " "Can only be used inside a :term:`coroutine function`." msgstr "" -#: reference/expressions.rst:1177 +#: reference/expressions.rst:1208 msgid "The power operator" msgstr "" -#: reference/expressions.rst:1183 +#: reference/expressions.rst:1214 msgid "" "The power operator binds more tightly than unary operators on its left; it " "binds less tightly than unary operators on its right. The syntax is:" msgstr "" -#: reference/expressions.rst:1189 +#: reference/expressions.rst:1220 msgid "" "Thus, in an unparenthesized sequence of power and unary operators, the " "operators are evaluated from right to left (this does not constrain the " "evaluation order for the operands): ``-1**2`` results in ``-1``." msgstr "" -#: reference/expressions.rst:1193 +#: reference/expressions.rst:1224 msgid "" "The power operator has the same semantics as the built-in :func:`pow` " "function, when called with two arguments: it yields its left argument raised " @@ -1219,7 +1280,7 @@ msgid "" "converted to a common type, and the result is of that type." msgstr "" -#: reference/expressions.rst:1198 +#: reference/expressions.rst:1229 msgid "" "For int operands, the result has the same type as the operands unless the " "second argument is negative; in that case, all arguments are converted to " @@ -1227,41 +1288,41 @@ msgid "" "``100``, but ``10**-2`` returns ``0.01``." msgstr "" -#: reference/expressions.rst:1203 +#: reference/expressions.rst:1234 msgid "" "Raising ``0.0`` to a negative power results in a :exc:`ZeroDivisionError`. " "Raising a negative number to a fractional power results in a :class:" "`complex` number. (In earlier versions it raised a :exc:`ValueError`.)" msgstr "" -#: reference/expressions.rst:1207 +#: reference/expressions.rst:1238 msgid "" "This operation can be customized using the special :meth:`~object.__pow__` " -"method." +"and :meth:`~object.__rpow__` methods." msgstr "" -#: reference/expressions.rst:1212 +#: reference/expressions.rst:1244 msgid "Unary arithmetic and bitwise operations" msgstr "" -#: reference/expressions.rst:1218 +#: reference/expressions.rst:1250 msgid "All unary arithmetic and bitwise operations have the same priority:" msgstr "" -#: reference/expressions.rst:1229 +#: reference/expressions.rst:1261 msgid "" "The unary ``-`` (minus) operator yields the negation of its numeric " "argument; the operation can be overridden with the :meth:`~object.__neg__` " "special method." msgstr "" -#: reference/expressions.rst:1237 +#: reference/expressions.rst:1269 msgid "" "The unary ``+`` (plus) operator yields its numeric argument unchanged; the " "operation can be overridden with the :meth:`~object.__pos__` special method." msgstr "" -#: reference/expressions.rst:1244 +#: reference/expressions.rst:1276 msgid "" "The unary ``~`` (invert) operator yields the bitwise inversion of its " "integer argument. The bitwise inversion of ``x`` is defined as ``-(x+1)``. " @@ -1269,17 +1330,17 @@ msgid "" "meth:`~object.__invert__` special method." msgstr "" -#: reference/expressions.rst:1253 +#: reference/expressions.rst:1285 msgid "" "In all three cases, if the argument does not have the proper type, a :exc:" "`TypeError` exception is raised." msgstr "" -#: reference/expressions.rst:1260 +#: reference/expressions.rst:1292 msgid "Binary arithmetic operations" msgstr "" -#: reference/expressions.rst:1264 +#: reference/expressions.rst:1296 msgid "" "The binary arithmetic operations have the conventional priority levels. " "Note that some of these operations also apply to certain non-numeric types. " @@ -1287,7 +1348,7 @@ msgid "" "multiplicative operators and one for additive operators:" msgstr "" -#: reference/expressions.rst:1279 +#: reference/expressions.rst:1311 msgid "" "The ``*`` (multiplication) operator yields the product of its arguments. " "The arguments must either both be numbers, or one argument must be an " @@ -1297,19 +1358,25 @@ msgid "" "an empty sequence." msgstr "" -#: reference/expressions.rst:1285 +#: reference/expressions.rst:1317 msgid "" "This operation can be customized using the special :meth:`~object.__mul__` " "and :meth:`~object.__rmul__` methods." msgstr "" -#: reference/expressions.rst:1292 +#: reference/expressions.rst:1324 msgid "" "The ``@`` (at) operator is intended to be used for matrix multiplication. " "No builtin Python types implement this operator." msgstr "" -#: reference/expressions.rst:1303 +#: reference/expressions.rst:1327 +msgid "" +"This operation can be customized using the special :meth:`~object." +"__matmul__` and :meth:`~object.__rmatmul__` methods." +msgstr "" + +#: reference/expressions.rst:1338 msgid "" "The ``/`` (division) and ``//`` (floor division) operators yield the " "quotient of their arguments. The numeric arguments are first converted to a " @@ -1319,25 +1386,27 @@ msgid "" "the :exc:`ZeroDivisionError` exception." msgstr "" -#: reference/expressions.rst:1310 +#: reference/expressions.rst:1345 msgid "" -"This operation can be customized using the special :meth:`~object." -"__truediv__` and :meth:`~object.__floordiv__` methods." +"The division operation can be customized using the special :meth:`~object." +"__truediv__` and :meth:`~object.__rtruediv__` methods. The floor division " +"operation can be customized using the special :meth:`~object.__floordiv__` " +"and :meth:`~object.__rfloordiv__` methods." msgstr "" -#: reference/expressions.rst:1317 +#: reference/expressions.rst:1354 msgid "" "The ``%`` (modulo) operator yields the remainder from the division of the " "first argument by the second. The numeric arguments are first converted to " "a common type. A zero right argument raises the :exc:`ZeroDivisionError` " -"exception. The arguments may be floating point numbers, e.g., ``3.14%0.7`` " +"exception. The arguments may be floating-point numbers, e.g., ``3.14%0.7`` " "equals ``0.34`` (since ``3.14`` equals ``4*0.7 + 0.34``.) The modulo " "operator always yields a result with the same sign as its second operand (or " "zero); the absolute value of the result is strictly smaller than the " "absolute value of the second operand [#]_." msgstr "" -#: reference/expressions.rst:1326 +#: reference/expressions.rst:1363 msgid "" "The floor division and modulo operators are connected by the following " "identity: ``x == (x//y)*y + (x%y)``. Floor division and modulo are also " @@ -1345,7 +1414,7 @@ msgid "" "y, x%y)``. [#]_." msgstr "" -#: reference/expressions.rst:1331 +#: reference/expressions.rst:1368 msgid "" "In addition to performing the modulo operation on numbers, the ``%`` " "operator is also overloaded by string objects to perform old-style string " @@ -1354,20 +1423,20 @@ msgid "" "formatting`." msgstr "" -#: reference/expressions.rst:1336 +#: reference/expressions.rst:1373 msgid "" "The *modulo* operation can be customized using the special :meth:`~object." -"__mod__` method." +"__mod__` and :meth:`~object.__rmod__` methods." msgstr "" -#: reference/expressions.rst:1338 +#: reference/expressions.rst:1376 msgid "" "The floor division operator, the modulo operator, and the :func:`divmod` " "function are not defined for complex numbers. Instead, convert to a " -"floating point number using the :func:`abs` function if appropriate." +"floating-point number using the :func:`abs` function if appropriate." msgstr "" -#: reference/expressions.rst:1347 +#: reference/expressions.rst:1385 msgid "" "The ``+`` (addition) operator yields the sum of its arguments. The " "arguments must either both be numbers or both be sequences of the same " @@ -1375,85 +1444,87 @@ msgid "" "then added together. In the latter case, the sequences are concatenated." msgstr "" -#: reference/expressions.rst:1352 +#: reference/expressions.rst:1390 msgid "" "This operation can be customized using the special :meth:`~object.__add__` " "and :meth:`~object.__radd__` methods." msgstr "" -#: reference/expressions.rst:1360 +#: reference/expressions.rst:1398 msgid "" "The ``-`` (subtraction) operator yields the difference of its arguments. " "The numeric arguments are first converted to a common type." msgstr "" -#: reference/expressions.rst:1363 +#: reference/expressions.rst:1401 msgid "" "This operation can be customized using the special :meth:`~object.__sub__` " -"method." +"and :meth:`~object.__rsub__` methods." msgstr "" -#: reference/expressions.rst:1369 +#: reference/expressions.rst:1408 msgid "Shifting operations" msgstr "" -#: reference/expressions.rst:1376 +#: reference/expressions.rst:1415 msgid "" "The shifting operations have lower priority than the arithmetic operations:" msgstr "" -#: reference/expressions.rst:1381 +#: reference/expressions.rst:1420 msgid "" "These operators accept integers as arguments. They shift the first argument " "to the left or right by the number of bits given by the second argument." msgstr "" -#: reference/expressions.rst:1384 +#: reference/expressions.rst:1423 msgid "" -"This operation can be customized using the special :meth:`~object." -"__lshift__` and :meth:`~object.__rshift__` methods." +"The left shift operation can be customized using the special :meth:`~object." +"__lshift__` and :meth:`~object.__rlshift__` methods. The right shift " +"operation can be customized using the special :meth:`~object.__rshift__` " +"and :meth:`~object.__rrshift__` methods." msgstr "" -#: reference/expressions.rst:1389 +#: reference/expressions.rst:1430 msgid "" "A right shift by *n* bits is defined as floor division by ``pow(2,n)``. A " "left shift by *n* bits is defined as multiplication with ``pow(2,n)``." msgstr "" -#: reference/expressions.rst:1396 +#: reference/expressions.rst:1437 msgid "Binary bitwise operations" msgstr "" -#: reference/expressions.rst:1400 +#: reference/expressions.rst:1441 msgid "Each of the three bitwise operations has a different priority level:" msgstr "" -#: reference/expressions.rst:1411 +#: reference/expressions.rst:1452 msgid "" "The ``&`` operator yields the bitwise AND of its arguments, which must be " "integers or one of them must be a custom object overriding :meth:`~object." "__and__` or :meth:`~object.__rand__` special methods." msgstr "" -#: reference/expressions.rst:1420 +#: reference/expressions.rst:1461 msgid "" "The ``^`` operator yields the bitwise XOR (exclusive OR) of its arguments, " "which must be integers or one of them must be a custom object overriding :" "meth:`~object.__xor__` or :meth:`~object.__rxor__` special methods." msgstr "" -#: reference/expressions.rst:1429 +#: reference/expressions.rst:1470 msgid "" "The ``|`` operator yields the bitwise (inclusive) OR of its arguments, which " "must be integers or one of them must be a custom object overriding :meth:" "`~object.__or__` or :meth:`~object.__ror__` special methods." msgstr "" -#: reference/expressions.rst:1437 +#: reference/expressions.rst:1478 msgid "Comparisons" msgstr "" -#: reference/expressions.rst:1449 +#: reference/expressions.rst:1490 msgid "" "Unlike C, all comparison operations in Python have the same priority, which " "is lower than that of any arithmetic, shifting or bitwise operation. Also " @@ -1461,14 +1532,14 @@ msgid "" "conventional in mathematics:" msgstr "" -#: reference/expressions.rst:1459 +#: reference/expressions.rst:1500 msgid "" "Comparisons yield boolean values: ``True`` or ``False``. Custom :dfn:`rich " "comparison methods` may return non-boolean values. In this case Python will " "call :func:`bool` on such value in boolean contexts." msgstr "" -#: reference/expressions.rst:1465 +#: reference/expressions.rst:1506 msgid "" "Comparisons can be chained arbitrarily, e.g., ``x < y <= z`` is equivalent " "to ``x < y and y <= z``, except that ``y`` is evaluated only once (but in " @@ -1476,7 +1547,7 @@ msgid "" "false)." msgstr "" -#: reference/expressions.rst:1469 +#: reference/expressions.rst:1510 msgid "" "Formally, if *a*, *b*, *c*, ..., *y*, *z* are expressions and *op1*, " "*op2*, ..., *opN* are comparison operators, then ``a op1 b op2 c ... y opN " @@ -1484,24 +1555,24 @@ msgid "" "each expression is evaluated at most once." msgstr "" -#: reference/expressions.rst:1474 +#: reference/expressions.rst:1515 msgid "" "Note that ``a op1 b op2 c`` doesn't imply any kind of comparison between *a* " "and *c*, so that, e.g., ``x < y > z`` is perfectly legal (though perhaps not " "pretty)." msgstr "" -#: reference/expressions.rst:1481 +#: reference/expressions.rst:1522 msgid "Value comparisons" msgstr "" -#: reference/expressions.rst:1483 +#: reference/expressions.rst:1524 msgid "" "The operators ``<``, ``>``, ``==``, ``>=``, ``<=``, and ``!=`` compare the " "values of two objects. The objects do not need to have the same type." msgstr "" -#: reference/expressions.rst:1486 +#: reference/expressions.rst:1527 msgid "" "Chapter :ref:`objects` states that objects have a value (in addition to type " "and identity). The value of an object is a rather abstract notion in " @@ -1513,7 +1584,7 @@ msgid "" "indirectly, by means of their comparison implementation." msgstr "" -#: reference/expressions.rst:1495 +#: reference/expressions.rst:1536 msgid "" "Because all types are (direct or indirect) subtypes of :class:`object`, they " "inherit the default comparison behavior from :class:`object`. Types can " @@ -1521,7 +1592,7 @@ msgid "" "methods` like :meth:`~object.__lt__`, described in :ref:`customization`." msgstr "" -#: reference/expressions.rst:1501 +#: reference/expressions.rst:1542 msgid "" "The default behavior for equality comparison (``==`` and ``!=``) is based on " "the identity of the objects. Hence, equality comparison of instances with " @@ -1531,14 +1602,14 @@ msgid "" "``x is y`` implies ``x == y``)." msgstr "" -#: reference/expressions.rst:1508 +#: reference/expressions.rst:1549 msgid "" "A default order comparison (``<``, ``>``, ``<=``, and ``>=``) is not " "provided; an attempt raises :exc:`TypeError`. A motivation for this default " "behavior is the lack of a similar invariant as for equality." msgstr "" -#: reference/expressions.rst:1512 +#: reference/expressions.rst:1553 msgid "" "The behavior of the default equality comparison, that instances with " "different identities are always unequal, may be in contrast to what types " @@ -1547,13 +1618,13 @@ msgid "" "in fact, a number of built-in types have done that." msgstr "" -#: reference/expressions.rst:1518 +#: reference/expressions.rst:1559 msgid "" "The following list describes the comparison behavior of the most important " "built-in types." msgstr "" -#: reference/expressions.rst:1521 +#: reference/expressions.rst:1562 msgid "" "Numbers of built-in numeric types (:ref:`typesnumeric`) and of the standard " "library types :class:`fractions.Fraction` and :class:`decimal.Decimal` can " @@ -1563,7 +1634,7 @@ msgid "" "of precision." msgstr "" -#: reference/expressions.rst:1528 +#: reference/expressions.rst:1569 msgid "" "The not-a-number values ``float('NaN')`` and ``decimal.Decimal('NaN')`` are " "special. Any ordered comparison of a number to a not-a-number value is " @@ -1573,32 +1644,32 @@ msgid "" "is compliant with IEEE 754." msgstr "" -#: reference/expressions.rst:1535 +#: reference/expressions.rst:1576 msgid "" "``None`` and :data:`NotImplemented` are singletons. :PEP:`8` advises that " "comparisons for singletons should always be done with ``is`` or ``is not``, " "never the equality operators." msgstr "" -#: reference/expressions.rst:1539 +#: reference/expressions.rst:1580 msgid "" "Binary sequences (instances of :class:`bytes` or :class:`bytearray`) can be " "compared within and across their types. They compare lexicographically " "using the numeric values of their elements." msgstr "" -#: reference/expressions.rst:1543 +#: reference/expressions.rst:1584 msgid "" "Strings (instances of :class:`str`) compare lexicographically using the " "numerical Unicode code points (the result of the built-in function :func:" "`ord`) of their characters. [#]_" msgstr "" -#: reference/expressions.rst:1547 +#: reference/expressions.rst:1588 msgid "Strings and binary sequences cannot be directly compared." msgstr "" -#: reference/expressions.rst:1549 +#: reference/expressions.rst:1590 msgid "" "Sequences (instances of :class:`tuple`, :class:`list`, or :class:`range`) " "can be compared only within each of their types, with the restriction that " @@ -1607,7 +1678,7 @@ msgid "" "raises :exc:`TypeError`." msgstr "" -#: reference/expressions.rst:1555 +#: reference/expressions.rst:1596 msgid "" "Sequences compare lexicographically using comparison of corresponding " "elements. The built-in containers typically assume identical objects are " @@ -1615,19 +1686,19 @@ msgid "" "objects to improve performance and to maintain their internal invariants." msgstr "" -#: reference/expressions.rst:1560 +#: reference/expressions.rst:1601 msgid "" "Lexicographical comparison between built-in collections works as follows:" msgstr "" -#: reference/expressions.rst:1562 +#: reference/expressions.rst:1603 msgid "" "For two collections to compare equal, they must be of the same type, have " "the same length, and each pair of corresponding elements must compare equal " "(for example, ``[1,2] == (1,2)`` is false because the type is not the same)." msgstr "" -#: reference/expressions.rst:1567 +#: reference/expressions.rst:1608 msgid "" "Collections that support order comparison are ordered the same as their " "first unequal elements (for example, ``[1,2,x] <= [1,2,y]`` has the same " @@ -1636,25 +1707,25 @@ msgid "" "true)." msgstr "" -#: reference/expressions.rst:1573 +#: reference/expressions.rst:1614 msgid "" "Mappings (instances of :class:`dict`) compare equal if and only if they have " "equal ``(key, value)`` pairs. Equality comparison of the keys and values " "enforces reflexivity." msgstr "" -#: reference/expressions.rst:1577 +#: reference/expressions.rst:1618 msgid "" "Order comparisons (``<``, ``>``, ``<=``, and ``>=``) raise :exc:`TypeError`." msgstr "" -#: reference/expressions.rst:1579 +#: reference/expressions.rst:1620 msgid "" "Sets (instances of :class:`set` or :class:`frozenset`) can be compared " "within and across their types." msgstr "" -#: reference/expressions.rst:1582 +#: reference/expressions.rst:1623 msgid "" "They define order comparison operators to mean subset and superset tests. " "Those relations do not define total orderings (for example, the two sets " @@ -1665,110 +1736,110 @@ msgid "" "sets as inputs)." msgstr "" -#: reference/expressions.rst:1590 +#: reference/expressions.rst:1631 msgid "Comparison of sets enforces reflexivity of its elements." msgstr "" -#: reference/expressions.rst:1592 +#: reference/expressions.rst:1633 msgid "" "Most other built-in types have no comparison methods implemented, so they " "inherit the default comparison behavior." msgstr "" -#: reference/expressions.rst:1595 +#: reference/expressions.rst:1636 msgid "" "User-defined classes that customize their comparison behavior should follow " "some consistency rules, if possible:" msgstr "" -#: reference/expressions.rst:1598 +#: reference/expressions.rst:1639 msgid "" "Equality comparison should be reflexive. In other words, identical objects " "should compare equal:" msgstr "" -#: reference/expressions.rst:1601 +#: reference/expressions.rst:1642 msgid "``x is y`` implies ``x == y``" msgstr "" -#: reference/expressions.rst:1603 +#: reference/expressions.rst:1644 msgid "" "Comparison should be symmetric. In other words, the following expressions " "should have the same result:" msgstr "" -#: reference/expressions.rst:1606 +#: reference/expressions.rst:1647 msgid "``x == y`` and ``y == x``" msgstr "" -#: reference/expressions.rst:1608 +#: reference/expressions.rst:1649 msgid "``x != y`` and ``y != x``" msgstr "" -#: reference/expressions.rst:1610 +#: reference/expressions.rst:1651 msgid "``x < y`` and ``y > x``" msgstr "" -#: reference/expressions.rst:1612 +#: reference/expressions.rst:1653 msgid "``x <= y`` and ``y >= x``" msgstr "" -#: reference/expressions.rst:1614 +#: reference/expressions.rst:1655 msgid "" "Comparison should be transitive. The following (non-exhaustive) examples " "illustrate that:" msgstr "" -#: reference/expressions.rst:1617 +#: reference/expressions.rst:1658 msgid "``x > y and y > z`` implies ``x > z``" msgstr "" -#: reference/expressions.rst:1619 +#: reference/expressions.rst:1660 msgid "``x < y and y <= z`` implies ``x < z``" msgstr "" -#: reference/expressions.rst:1621 +#: reference/expressions.rst:1662 msgid "" "Inverse comparison should result in the boolean negation. In other words, " "the following expressions should have the same result:" msgstr "" -#: reference/expressions.rst:1624 +#: reference/expressions.rst:1665 msgid "``x == y`` and ``not x != y``" msgstr "" -#: reference/expressions.rst:1626 +#: reference/expressions.rst:1667 msgid "``x < y`` and ``not x >= y`` (for total ordering)" msgstr "" -#: reference/expressions.rst:1628 +#: reference/expressions.rst:1669 msgid "``x > y`` and ``not x <= y`` (for total ordering)" msgstr "" -#: reference/expressions.rst:1630 +#: reference/expressions.rst:1671 msgid "" "The last two expressions apply to totally ordered collections (e.g. to " "sequences, but not to sets or mappings). See also the :func:`~functools." "total_ordering` decorator." msgstr "" -#: reference/expressions.rst:1634 +#: reference/expressions.rst:1675 msgid "" "The :func:`hash` result should be consistent with equality. Objects that are " "equal should either have the same hash value, or be marked as unhashable." msgstr "" -#: reference/expressions.rst:1638 +#: reference/expressions.rst:1679 msgid "" "Python does not enforce these consistency rules. In fact, the not-a-number " "values are an example for not following these rules." msgstr "" -#: reference/expressions.rst:1647 +#: reference/expressions.rst:1688 msgid "Membership test operations" msgstr "" -#: reference/expressions.rst:1649 +#: reference/expressions.rst:1690 msgid "" "The operators :keyword:`in` and :keyword:`not in` test for membership. ``x " "in s`` evaluates to ``True`` if *x* is a member of *s*, and ``False`` " @@ -1779,7 +1850,7 @@ msgid "" "expression ``x in y`` is equivalent to ``any(x is e or x == e for e in y)``." msgstr "" -#: reference/expressions.rst:1657 +#: reference/expressions.rst:1698 msgid "" "For the string and bytes types, ``x in y`` is ``True`` if and only if *x* is " "a substring of *y*. An equivalent test is ``y.find(x) != -1``. Empty " @@ -1787,14 +1858,14 @@ msgid "" "``\"\" in \"abc\"`` will return ``True``." msgstr "" -#: reference/expressions.rst:1662 +#: reference/expressions.rst:1703 msgid "" "For user-defined classes which define the :meth:`~object.__contains__` " "method, ``x in y`` returns ``True`` if ``y.__contains__(x)`` returns a true " "value, and ``False`` otherwise." msgstr "" -#: reference/expressions.rst:1666 +#: reference/expressions.rst:1707 msgid "" "For user-defined classes which do not define :meth:`~object.__contains__` " "but do define :meth:`~object.__iter__`, ``x in y`` is ``True`` if some value " @@ -1803,7 +1874,7 @@ msgid "" "it is as if :keyword:`in` raised that exception." msgstr "" -#: reference/expressions.rst:1672 +#: reference/expressions.rst:1713 msgid "" "Lastly, the old-style iteration protocol is tried: if a class defines :meth:" "`~object.__getitem__`, ``x in y`` is ``True`` if and only if there is a non-" @@ -1812,17 +1883,17 @@ msgid "" "exception is raised, it is as if :keyword:`in` raised that exception)." msgstr "" -#: reference/expressions.rst:1684 +#: reference/expressions.rst:1725 msgid "" "The operator :keyword:`not in` is defined to have the inverse truth value " "of :keyword:`in`." msgstr "" -#: reference/expressions.rst:1697 +#: reference/expressions.rst:1738 msgid "Identity comparisons" msgstr "" -#: reference/expressions.rst:1699 +#: reference/expressions.rst:1740 msgid "" "The operators :keyword:`is` and :keyword:`is not` test for an object's " "identity: ``x is y`` is true if and only if *x* and *y* are the same " @@ -1830,11 +1901,11 @@ msgid "" "``x is not y`` yields the inverse truth value. [#]_" msgstr "" -#: reference/expressions.rst:1711 +#: reference/expressions.rst:1752 msgid "Boolean operations" msgstr "" -#: reference/expressions.rst:1722 +#: reference/expressions.rst:1763 msgid "" "In the context of Boolean operations, and also when expressions are used by " "control flow statements, the following values are interpreted as false: " @@ -1845,25 +1916,25 @@ msgid "" "__bool__` method." msgstr "" -#: reference/expressions.rst:1731 +#: reference/expressions.rst:1772 msgid "" "The operator :keyword:`not` yields ``True`` if its argument is false, " "``False`` otherwise." msgstr "" -#: reference/expressions.rst:1736 +#: reference/expressions.rst:1777 msgid "" "The expression ``x and y`` first evaluates *x*; if *x* is false, its value " "is returned; otherwise, *y* is evaluated and the resulting value is returned." msgstr "" -#: reference/expressions.rst:1741 +#: reference/expressions.rst:1782 msgid "" "The expression ``x or y`` first evaluates *x*; if *x* is true, its value is " "returned; otherwise, *y* is evaluated and the resulting value is returned." msgstr "" -#: reference/expressions.rst:1744 +#: reference/expressions.rst:1785 msgid "" "Note that neither :keyword:`and` nor :keyword:`or` restrict the value and " "type they return to ``False`` and ``True``, but rather return the last " @@ -1874,11 +1945,11 @@ msgid "" "argument (for example, ``not 'foo'`` produces ``False`` rather than ``''``.)" msgstr "" -#: reference/expressions.rst:1760 +#: reference/expressions.rst:1801 msgid "Assignment expressions" msgstr "" -#: reference/expressions.rst:1765 +#: reference/expressions.rst:1806 msgid "" "An assignment expression (sometimes also called a \"named expression\" or " "\"walrus\") assigns an :token:`~python-grammar:expression` to an :token:" @@ -1886,15 +1957,15 @@ msgid "" "`~python-grammar:expression`." msgstr "" -#: reference/expressions.rst:1770 +#: reference/expressions.rst:1811 msgid "One common use case is when handling matched regular expressions:" msgstr "" -#: reference/expressions.rst:1777 +#: reference/expressions.rst:1818 msgid "Or, when processing a file stream in chunks:" msgstr "" -#: reference/expressions.rst:1784 +#: reference/expressions.rst:1825 msgid "" "Assignment expressions must be surrounded by parentheses when used as " "expression statements and when used as sub-expressions in slicing, " @@ -1904,36 +1975,36 @@ msgid "" "and ``while`` statements." msgstr "" -#: reference/expressions.rst:1792 +#: reference/expressions.rst:1833 msgid "See :pep:`572` for more details about assignment expressions." msgstr "" -#: reference/expressions.rst:1799 +#: reference/expressions.rst:1840 msgid "Conditional expressions" msgstr "" -#: reference/expressions.rst:1811 +#: reference/expressions.rst:1852 msgid "" "Conditional expressions (sometimes called a \"ternary operator\") have the " "lowest priority of all Python operations." msgstr "" -#: reference/expressions.rst:1814 +#: reference/expressions.rst:1855 msgid "" "The expression ``x if C else y`` first evaluates the condition, *C* rather " "than *x*. If *C* is true, *x* is evaluated and its value is returned; " "otherwise, *y* is evaluated and its value is returned." msgstr "" -#: reference/expressions.rst:1818 +#: reference/expressions.rst:1859 msgid "See :pep:`308` for more details about conditional expressions." msgstr "" -#: reference/expressions.rst:1825 +#: reference/expressions.rst:1866 msgid "Lambdas" msgstr "" -#: reference/expressions.rst:1836 +#: reference/expressions.rst:1877 msgid "" "Lambda expressions (sometimes called lambda forms) are used to create " "anonymous functions. The expression ``lambda parameters: expression`` yields " @@ -1941,25 +2012,25 @@ msgid "" "defined with:" msgstr "" -#: reference/expressions.rst:1845 +#: reference/expressions.rst:1886 msgid "" "See section :ref:`function` for the syntax of parameter lists. Note that " "functions created with lambda expressions cannot contain statements or " "annotations." msgstr "" -#: reference/expressions.rst:1853 +#: reference/expressions.rst:1894 msgid "Expression lists" msgstr "" -#: reference/expressions.rst:1867 +#: reference/expressions.rst:1908 msgid "" "Except when part of a list or set display, an expression list containing at " "least one comma yields a tuple. The length of the tuple is the number of " "expressions in the list. The expressions are evaluated from left to right." msgstr "" -#: reference/expressions.rst:1876 +#: reference/expressions.rst:1917 msgid "" "An asterisk ``*`` denotes :dfn:`iterable unpacking`. Its operand must be " "an :term:`iterable`. The iterable is expanded into a sequence of items, " @@ -1967,12 +2038,12 @@ msgid "" "unpacking." msgstr "" -#: reference/expressions.rst:1881 +#: reference/expressions.rst:1922 msgid "" "Iterable unpacking in expression lists, originally proposed by :pep:`448`." msgstr "" -#: reference/expressions.rst:1886 +#: reference/expressions.rst:1927 msgid "" "A trailing comma is required only to create a one-item tuple, such as ``1," "``; it is optional in all other cases. A single expression without a " @@ -1981,28 +2052,28 @@ msgid "" "``()``.)" msgstr "" -#: reference/expressions.rst:1897 +#: reference/expressions.rst:1938 msgid "Evaluation order" msgstr "" -#: reference/expressions.rst:1901 +#: reference/expressions.rst:1942 msgid "" "Python evaluates expressions from left to right. Notice that while " "evaluating an assignment, the right-hand side is evaluated before the left-" "hand side." msgstr "" -#: reference/expressions.rst:1904 +#: reference/expressions.rst:1945 msgid "" "In the following lines, expressions will be evaluated in the arithmetic " "order of their suffixes::" msgstr "" -#: reference/expressions.rst:1918 +#: reference/expressions.rst:1959 msgid "Operator precedence" msgstr "" -#: reference/expressions.rst:1923 +#: reference/expressions.rst:1964 msgid "" "The following table summarizes the operator precedence in Python, from " "highest precedence (most binding) to lowest precedence (least binding). " @@ -2012,176 +2083,176 @@ msgid "" "group from right to left)." msgstr "" -#: reference/expressions.rst:1929 +#: reference/expressions.rst:1970 msgid "" "Note that comparisons, membership tests, and identity tests, all have the " "same precedence and have a left-to-right chaining feature as described in " "the :ref:`comparisons` section." msgstr "" -#: reference/expressions.rst:1935 +#: reference/expressions.rst:1976 msgid "Operator" msgstr "" -#: reference/expressions.rst:1935 +#: reference/expressions.rst:1976 msgid "Description" msgstr "" -#: reference/expressions.rst:1937 +#: reference/expressions.rst:1978 msgid "``(expressions...)``," msgstr "" -#: reference/expressions.rst:1939 +#: reference/expressions.rst:1980 msgid "``[expressions...]``, ``{key: value...}``, ``{expressions...}``" msgstr "" -#: reference/expressions.rst:1937 +#: reference/expressions.rst:1978 msgid "" "Binding or parenthesized expression, list display, dictionary display, set " "display" msgstr "" -#: reference/expressions.rst:1943 +#: reference/expressions.rst:1984 msgid "``x[index]``, ``x[index:index]``, ``x(arguments...)``, ``x.attribute``" msgstr "" -#: reference/expressions.rst:1943 +#: reference/expressions.rst:1984 msgid "Subscription, slicing, call, attribute reference" msgstr "" -#: reference/expressions.rst:1946 +#: reference/expressions.rst:1987 msgid ":keyword:`await x `" msgstr "" -#: reference/expressions.rst:1948 +#: reference/expressions.rst:1989 msgid "``**``" msgstr "" -#: reference/expressions.rst:1948 +#: reference/expressions.rst:1989 msgid "Exponentiation [#]_" msgstr "" -#: reference/expressions.rst:1950 +#: reference/expressions.rst:1991 msgid "``+x``, ``-x``, ``~x``" msgstr "" -#: reference/expressions.rst:1950 +#: reference/expressions.rst:1991 msgid "Positive, negative, bitwise NOT" msgstr "" -#: reference/expressions.rst:1952 +#: reference/expressions.rst:1993 msgid "``*``, ``@``, ``/``, ``//``, ``%``" msgstr "" -#: reference/expressions.rst:1952 +#: reference/expressions.rst:1993 msgid "" "Multiplication, matrix multiplication, division, floor division, remainder " "[#]_" msgstr "" -#: reference/expressions.rst:1956 +#: reference/expressions.rst:1997 msgid "``+``, ``-``" msgstr "" -#: reference/expressions.rst:1956 +#: reference/expressions.rst:1997 msgid "Addition and subtraction" msgstr "" -#: reference/expressions.rst:1958 +#: reference/expressions.rst:1999 msgid "``<<``, ``>>``" msgstr "" -#: reference/expressions.rst:1958 +#: reference/expressions.rst:1999 msgid "Shifts" msgstr "" -#: reference/expressions.rst:1960 +#: reference/expressions.rst:2001 msgid "``&``" msgstr "" -#: reference/expressions.rst:1960 +#: reference/expressions.rst:2001 msgid "Bitwise AND" msgstr "" -#: reference/expressions.rst:1962 +#: reference/expressions.rst:2003 msgid "``^``" msgstr "" -#: reference/expressions.rst:1962 +#: reference/expressions.rst:2003 msgid "Bitwise XOR" msgstr "" -#: reference/expressions.rst:1964 +#: reference/expressions.rst:2005 msgid "``|``" msgstr "" -#: reference/expressions.rst:1964 +#: reference/expressions.rst:2005 msgid "Bitwise OR" msgstr "" -#: reference/expressions.rst:1966 +#: reference/expressions.rst:2007 msgid "" ":keyword:`in`, :keyword:`not in`, :keyword:`is`, :keyword:`is not`, ``<``, " "``<=``, ``>``, ``>=``, ``!=``, ``==``" msgstr "" -#: reference/expressions.rst:1966 +#: reference/expressions.rst:2007 msgid "Comparisons, including membership tests and identity tests" msgstr "" -#: reference/expressions.rst:1970 +#: reference/expressions.rst:2011 msgid ":keyword:`not x `" msgstr "" -#: reference/expressions.rst:1970 +#: reference/expressions.rst:2011 msgid "Boolean NOT" msgstr "" -#: reference/expressions.rst:1972 +#: reference/expressions.rst:2013 msgid ":keyword:`and`" msgstr "" -#: reference/expressions.rst:1972 +#: reference/expressions.rst:2013 msgid "Boolean AND" msgstr "" -#: reference/expressions.rst:1974 +#: reference/expressions.rst:2015 msgid ":keyword:`or`" msgstr "" -#: reference/expressions.rst:1974 +#: reference/expressions.rst:2015 msgid "Boolean OR" msgstr "" -#: reference/expressions.rst:1976 +#: reference/expressions.rst:2017 msgid ":keyword:`if ` -- :keyword:`!else`" msgstr "" -#: reference/expressions.rst:1976 +#: reference/expressions.rst:2017 msgid "Conditional expression" msgstr "" -#: reference/expressions.rst:1978 +#: reference/expressions.rst:2019 msgid ":keyword:`lambda`" msgstr "" -#: reference/expressions.rst:1978 +#: reference/expressions.rst:2019 msgid "Lambda expression" msgstr "" -#: reference/expressions.rst:1980 +#: reference/expressions.rst:2021 msgid "``:=``" msgstr "" -#: reference/expressions.rst:1980 +#: reference/expressions.rst:2021 msgid "Assignment expression" msgstr "" -#: reference/expressions.rst:1985 +#: reference/expressions.rst:2026 msgid "Footnotes" msgstr "" -#: reference/expressions.rst:1986 +#: reference/expressions.rst:2027 msgid "" "While ``abs(x%y) < abs(y)`` is true mathematically, for floats it may not be " "true numerically due to roundoff. For example, and assuming a platform on " @@ -2193,7 +2264,7 @@ msgid "" "approach is more appropriate depends on the application." msgstr "" -#: reference/expressions.rst:1995 +#: reference/expressions.rst:2036 msgid "" "If x is very close to an exact integer multiple of y, it's possible for ``x//" "y`` to be one larger than ``(x-x%y)//y`` due to rounding. In such cases, " @@ -2201,7 +2272,7 @@ msgid "" "* y + x % y`` be very close to ``x``." msgstr "" -#: reference/expressions.rst:2000 +#: reference/expressions.rst:2041 msgid "" "The Unicode standard distinguishes between :dfn:`code points` (e.g. U+0041) " "and :dfn:`abstract characters` (e.g. \"LATIN CAPITAL LETTER A\"). While most " @@ -2215,7 +2286,7 @@ msgid "" "(COMBINING CEDILLA)." msgstr "" -#: reference/expressions.rst:2011 +#: reference/expressions.rst:2052 msgid "" "The comparison operators on strings compare at the level of Unicode code " "points. This may be counter-intuitive to humans. For example, ``\"\\u00C7\" " @@ -2223,13 +2294,13 @@ msgid "" "same abstract character \"LATIN CAPITAL LETTER C WITH CEDILLA\"." msgstr "" -#: reference/expressions.rst:2016 +#: reference/expressions.rst:2057 msgid "" "To compare strings at the level of abstract characters (that is, in a way " "intuitive to humans), use :func:`unicodedata.normalize`." msgstr "" -#: reference/expressions.rst:2019 +#: reference/expressions.rst:2060 msgid "" "Due to automatic garbage-collection, free lists, and the dynamic nature of " "descriptors, you may notice seemingly unusual behaviour in certain uses of " @@ -2237,20 +2308,20 @@ msgid "" "instance methods, or constants. Check their documentation for more info." msgstr "" -#: reference/expressions.rst:2024 +#: reference/expressions.rst:2065 msgid "" "The power operator ``**`` binds less tightly than an arithmetic or bitwise " "unary operator on its right, that is, ``2**-1`` is ``0.5``." msgstr "" -#: reference/expressions.rst:2027 +#: reference/expressions.rst:2068 msgid "" "The ``%`` operator is also used for string formatting; the same precedence " "applies." msgstr "" -#: reference/expressions.rst:362 reference/expressions.rst:1713 -#: reference/expressions.rst:1827 reference/expressions.rst:1855 +#: reference/expressions.rst:393 reference/expressions.rst:1754 +#: reference/expressions.rst:1868 reference/expressions.rst:1896 msgid "expression" msgstr "" @@ -2258,7 +2329,7 @@ msgstr "" msgid "BNF" msgstr "" -#: reference/expressions.rst:1214 reference/expressions.rst:1262 +#: reference/expressions.rst:1246 reference/expressions.rst:1294 msgid "arithmetic" msgstr "" @@ -2278,9 +2349,9 @@ msgstr "" msgid "identifier" msgstr "" -#: reference/expressions.rst:538 reference/expressions.rst:715 -#: reference/expressions.rst:813 reference/expressions.rst:1297 -#: reference/expressions.rst:1387 +#: reference/expressions.rst:569 reference/expressions.rst:746 +#: reference/expressions.rst:844 reference/expressions.rst:1332 +#: reference/expressions.rst:1428 msgid "exception" msgstr "" @@ -2300,676 +2371,676 @@ msgstr "" msgid "names" msgstr "" -#: reference/expressions.rst:104 +#: reference/expressions.rst:133 msgid "literal" msgstr "" -#: reference/expressions.rst:341 +#: reference/expressions.rst:372 msgid "immutable" msgstr "" -#: reference/expressions.rst:117 +#: reference/expressions.rst:146 msgid "data" msgstr "" -#: reference/expressions.rst:117 +#: reference/expressions.rst:146 msgid "type" msgstr "" -#: reference/expressions.rst:244 reference/expressions.rst:298 -#: reference/expressions.rst:362 reference/expressions.rst:705 -#: reference/expressions.rst:842 reference/expressions.rst:959 -#: reference/expressions.rst:1120 reference/expressions.rst:1141 -#: reference/expressions.rst:1865 +#: reference/expressions.rst:275 reference/expressions.rst:329 +#: reference/expressions.rst:393 reference/expressions.rst:736 +#: reference/expressions.rst:873 reference/expressions.rst:990 +#: reference/expressions.rst:1151 reference/expressions.rst:1172 +#: reference/expressions.rst:1906 msgid "object" msgstr "" -#: reference/expressions.rst:133 +#: reference/expressions.rst:162 msgid "parenthesized form" msgstr "" -#: reference/expressions.rst:362 reference/expressions.rst:959 +#: reference/expressions.rst:393 reference/expressions.rst:990 msgid "() (parentheses)" msgstr "" -#: reference/expressions.rst:133 +#: reference/expressions.rst:162 msgid "tuple display" msgstr "" -#: reference/expressions.rst:244 +#: reference/expressions.rst:275 msgid "empty" msgstr "" -#: reference/expressions.rst:842 reference/expressions.rst:1865 +#: reference/expressions.rst:873 reference/expressions.rst:1906 msgid "tuple" msgstr "" -#: reference/expressions.rst:1884 +#: reference/expressions.rst:1925 msgid "comma" msgstr "" -#: reference/expressions.rst:244 reference/expressions.rst:298 -#: reference/expressions.rst:959 reference/expressions.rst:1855 +#: reference/expressions.rst:275 reference/expressions.rst:329 +#: reference/expressions.rst:990 reference/expressions.rst:1896 msgid ", (comma)" msgstr "" -#: reference/expressions.rst:244 reference/expressions.rst:298 +#: reference/expressions.rst:275 reference/expressions.rst:329 msgid "comprehensions" msgstr "" -#: reference/expressions.rst:177 +#: reference/expressions.rst:206 msgid "for" msgstr "" -#: reference/expressions.rst:212 +#: reference/expressions.rst:241 msgid "in comprehensions" msgstr "" -#: reference/expressions.rst:1801 +#: reference/expressions.rst:1842 msgid "if" msgstr "" -#: reference/expressions.rst:177 +#: reference/expressions.rst:206 msgid "async for" msgstr "" -#: reference/expressions.rst:1159 +#: reference/expressions.rst:1190 msgid "await" msgstr "" -#: reference/expressions.rst:813 reference/expressions.rst:915 -#: reference/expressions.rst:1855 +#: reference/expressions.rst:844 reference/expressions.rst:946 +#: reference/expressions.rst:1896 msgid "list" msgstr "" -#: reference/expressions.rst:270 reference/expressions.rst:298 +#: reference/expressions.rst:301 reference/expressions.rst:329 msgid "display" msgstr "" -#: reference/expressions.rst:838 +#: reference/expressions.rst:869 msgid "[] (square brackets)" msgstr "" -#: reference/expressions.rst:244 +#: reference/expressions.rst:275 msgid "list expression" msgstr "" -#: reference/expressions.rst:270 reference/expressions.rst:1855 +#: reference/expressions.rst:301 reference/expressions.rst:1896 msgid "expression list" msgstr "" -#: reference/expressions.rst:270 +#: reference/expressions.rst:301 msgid "set" msgstr "" -#: reference/expressions.rst:298 +#: reference/expressions.rst:329 msgid "{} (curly brackets)" msgstr "" -#: reference/expressions.rst:270 +#: reference/expressions.rst:301 msgid "set expression" msgstr "" -#: reference/expressions.rst:324 reference/expressions.rst:842 +#: reference/expressions.rst:355 reference/expressions.rst:873 msgid "dictionary" msgstr "" -#: reference/expressions.rst:298 +#: reference/expressions.rst:329 msgid "key" msgstr "" -#: reference/expressions.rst:298 +#: reference/expressions.rst:329 msgid "value" msgstr "" -#: reference/expressions.rst:298 +#: reference/expressions.rst:329 msgid "key/value pair" msgstr "" -#: reference/expressions.rst:298 +#: reference/expressions.rst:329 msgid "dictionary expression" msgstr "" -#: reference/expressions.rst:909 reference/expressions.rst:1827 +#: reference/expressions.rst:940 reference/expressions.rst:1868 msgid ": (colon)" msgstr "" -#: reference/expressions.rst:298 +#: reference/expressions.rst:329 msgid "in dictionary expressions" msgstr "" -#: reference/expressions.rst:324 +#: reference/expressions.rst:355 msgid "in dictionary displays" msgstr "" -#: reference/expressions.rst:1042 reference/expressions.rst:1872 +#: reference/expressions.rst:1073 reference/expressions.rst:1913 msgid "unpacking" msgstr "" -#: reference/expressions.rst:1072 reference/expressions.rst:1179 +#: reference/expressions.rst:1103 reference/expressions.rst:1210 msgid "**" msgstr "" -#: reference/expressions.rst:341 +#: reference/expressions.rst:372 msgid "hashable" msgstr "" -#: reference/expressions.rst:417 reference/expressions.rst:526 +#: reference/expressions.rst:448 reference/expressions.rst:557 msgid "generator" msgstr "" -#: reference/expressions.rst:362 +#: reference/expressions.rst:393 msgid "generator expression" msgstr "" -#: reference/expressions.rst:1159 +#: reference/expressions.rst:1190 msgid "keyword" msgstr "" -#: reference/expressions.rst:606 +#: reference/expressions.rst:637 msgid "yield" msgstr "" -#: reference/expressions.rst:485 +#: reference/expressions.rst:516 msgid "from" msgstr "" -#: reference/expressions.rst:1107 reference/expressions.rst:1827 +#: reference/expressions.rst:1138 reference/expressions.rst:1868 msgid "function" msgstr "" -#: reference/expressions.rst:471 +#: reference/expressions.rst:502 msgid "coroutine" msgstr "" -#: reference/expressions.rst:485 +#: reference/expressions.rst:516 msgid "yield from expression" msgstr "" -#: reference/expressions.rst:538 +#: reference/expressions.rst:569 msgid "StopIteration" msgstr "" -#: reference/expressions.rst:767 +#: reference/expressions.rst:798 msgid "GeneratorExit" msgstr "" -#: reference/expressions.rst:606 +#: reference/expressions.rst:637 msgid "examples" msgstr "" -#: reference/expressions.rst:705 +#: reference/expressions.rst:736 msgid "asynchronous-generator" msgstr "" -#: reference/expressions.rst:715 +#: reference/expressions.rst:746 msgid "StopAsyncIteration" msgstr "" -#: reference/expressions.rst:790 +#: reference/expressions.rst:821 msgid "primary" msgstr "" -#: reference/expressions.rst:804 +#: reference/expressions.rst:835 msgid "attribute" msgstr "" -#: reference/expressions.rst:804 +#: reference/expressions.rst:835 msgid "reference" msgstr "" -#: reference/expressions.rst:804 +#: reference/expressions.rst:835 msgid ". (dot)" msgstr "" -#: reference/expressions.rst:804 +#: reference/expressions.rst:835 msgid "attribute reference" msgstr "" -#: reference/expressions.rst:813 +#: reference/expressions.rst:844 msgid "AttributeError" msgstr "" -#: reference/expressions.rst:813 +#: reference/expressions.rst:844 msgid "module" msgstr "" -#: reference/expressions.rst:838 +#: reference/expressions.rst:869 msgid "subscription" msgstr "" -#: reference/expressions.rst:915 reference/expressions.rst:1678 +#: reference/expressions.rst:946 reference/expressions.rst:1719 msgid "sequence" msgstr "" -#: reference/expressions.rst:842 +#: reference/expressions.rst:873 msgid "mapping" msgstr "" -#: reference/expressions.rst:895 reference/expressions.rst:915 +#: reference/expressions.rst:926 reference/expressions.rst:946 msgid "string" msgstr "" -#: reference/expressions.rst:895 +#: reference/expressions.rst:926 msgid "item" msgstr "" -#: reference/expressions.rst:895 +#: reference/expressions.rst:926 msgid "character" msgstr "" -#: reference/expressions.rst:909 +#: reference/expressions.rst:940 msgid "slicing" msgstr "" -#: reference/expressions.rst:909 +#: reference/expressions.rst:940 msgid "slice" msgstr "" -#: reference/expressions.rst:941 +#: reference/expressions.rst:972 msgid "start (slice object attribute)" msgstr "" -#: reference/expressions.rst:941 +#: reference/expressions.rst:972 msgid "stop (slice object attribute)" msgstr "" -#: reference/expressions.rst:941 +#: reference/expressions.rst:972 msgid "step (slice object attribute)" msgstr "" -#: reference/expressions.rst:959 +#: reference/expressions.rst:990 msgid "callable" msgstr "" -#: reference/expressions.rst:1107 reference/expressions.rst:1134 -#: reference/expressions.rst:1151 +#: reference/expressions.rst:1138 reference/expressions.rst:1165 +#: reference/expressions.rst:1182 msgid "call" msgstr "" -#: reference/expressions.rst:959 +#: reference/expressions.rst:990 msgid "argument" msgstr "" -#: reference/expressions.rst:992 +#: reference/expressions.rst:1023 msgid "call semantics" msgstr "" -#: reference/expressions.rst:959 +#: reference/expressions.rst:990 msgid "argument list" msgstr "" -#: reference/expressions.rst:959 +#: reference/expressions.rst:990 msgid "= (equals)" msgstr "" -#: reference/expressions.rst:1042 reference/expressions.rst:1072 +#: reference/expressions.rst:1073 reference/expressions.rst:1103 msgid "in function calls" msgstr "" -#: reference/expressions.rst:992 +#: reference/expressions.rst:1023 msgid "parameter" msgstr "" -#: reference/expressions.rst:1275 reference/expressions.rst:1872 +#: reference/expressions.rst:1307 reference/expressions.rst:1913 msgid "* (asterisk)" msgstr "" -#: reference/expressions.rst:1107 +#: reference/expressions.rst:1138 msgid "user-defined" msgstr "" -#: reference/expressions.rst:1107 +#: reference/expressions.rst:1138 msgid "user-defined function" msgstr "" -#: reference/expressions.rst:1120 +#: reference/expressions.rst:1151 msgid "built-in function" msgstr "" -#: reference/expressions.rst:1120 +#: reference/expressions.rst:1151 msgid "method" msgstr "" -#: reference/expressions.rst:1120 +#: reference/expressions.rst:1151 msgid "built-in method" msgstr "" -#: reference/expressions.rst:1134 +#: reference/expressions.rst:1165 msgid "class" msgstr "" -#: reference/expressions.rst:1134 +#: reference/expressions.rst:1165 msgid "class object" msgstr "" -#: reference/expressions.rst:1141 +#: reference/expressions.rst:1172 msgid "class instance" msgstr "" -#: reference/expressions.rst:1151 +#: reference/expressions.rst:1182 msgid "instance" msgstr "" -#: reference/expressions.rst:1151 +#: reference/expressions.rst:1182 msgid "__call__() (object method)" msgstr "" -#: reference/expressions.rst:1179 +#: reference/expressions.rst:1210 msgid "power" msgstr "" -#: reference/expressions.rst:1214 reference/expressions.rst:1371 -#: reference/expressions.rst:1713 +#: reference/expressions.rst:1246 reference/expressions.rst:1410 +#: reference/expressions.rst:1754 msgid "operation" msgstr "" -#: reference/expressions.rst:1223 reference/expressions.rst:1240 -#: reference/expressions.rst:1288 reference/expressions.rst:1313 -#: reference/expressions.rst:1355 reference/expressions.rst:1407 -#: reference/expressions.rst:1424 reference/expressions.rst:1678 -#: reference/expressions.rst:1729 reference/expressions.rst:1739 -#: reference/expressions.rst:1920 +#: reference/expressions.rst:1255 reference/expressions.rst:1272 +#: reference/expressions.rst:1320 reference/expressions.rst:1350 +#: reference/expressions.rst:1393 reference/expressions.rst:1448 +#: reference/expressions.rst:1465 reference/expressions.rst:1719 +#: reference/expressions.rst:1770 reference/expressions.rst:1780 +#: reference/expressions.rst:1961 msgid "operator" msgstr "" -#: reference/expressions.rst:1214 +#: reference/expressions.rst:1246 msgid "unary" msgstr "" -#: reference/expressions.rst:1398 reference/expressions.rst:1415 -#: reference/expressions.rst:1424 +#: reference/expressions.rst:1439 reference/expressions.rst:1456 +#: reference/expressions.rst:1465 msgid "bitwise" msgstr "" -#: reference/expressions.rst:1223 +#: reference/expressions.rst:1255 msgid "negation" msgstr "" -#: reference/expressions.rst:1223 +#: reference/expressions.rst:1255 msgid "minus" msgstr "" -#: reference/expressions.rst:1355 +#: reference/expressions.rst:1393 msgid "- (minus)" msgstr "" -#: reference/expressions.rst:1232 +#: reference/expressions.rst:1264 msgid "unary operator" msgstr "" -#: reference/expressions.rst:1232 +#: reference/expressions.rst:1264 msgid "plus" msgstr "" -#: reference/expressions.rst:1342 +#: reference/expressions.rst:1380 msgid "+ (plus)" msgstr "" -#: reference/expressions.rst:1240 +#: reference/expressions.rst:1272 msgid "inversion" msgstr "" -#: reference/expressions.rst:1240 +#: reference/expressions.rst:1272 msgid "~ (tilde)" msgstr "" -#: reference/expressions.rst:1251 +#: reference/expressions.rst:1283 msgid "TypeError" msgstr "" -#: reference/expressions.rst:1398 +#: reference/expressions.rst:1439 msgid "binary" msgstr "" -#: reference/expressions.rst:1275 +#: reference/expressions.rst:1307 msgid "multiplication" msgstr "" -#: reference/expressions.rst:1288 +#: reference/expressions.rst:1320 msgid "matrix multiplication" msgstr "" -#: reference/expressions.rst:1288 +#: reference/expressions.rst:1320 msgid "@ (at)" msgstr "" -#: reference/expressions.rst:1297 +#: reference/expressions.rst:1332 msgid "ZeroDivisionError" msgstr "" -#: reference/expressions.rst:1297 +#: reference/expressions.rst:1332 msgid "division" msgstr "" -#: reference/expressions.rst:1297 +#: reference/expressions.rst:1332 msgid "/ (slash)" msgstr "" -#: reference/expressions.rst:1297 +#: reference/expressions.rst:1332 msgid "//" msgstr "" -#: reference/expressions.rst:1313 +#: reference/expressions.rst:1350 msgid "modulo" msgstr "" -#: reference/expressions.rst:1313 +#: reference/expressions.rst:1350 msgid "% (percent)" msgstr "" -#: reference/expressions.rst:1342 +#: reference/expressions.rst:1380 msgid "addition" msgstr "" -#: reference/expressions.rst:1355 +#: reference/expressions.rst:1393 msgid "binary operator" msgstr "" -#: reference/expressions.rst:1355 +#: reference/expressions.rst:1393 msgid "subtraction" msgstr "" -#: reference/expressions.rst:1371 +#: reference/expressions.rst:1410 msgid "shifting" msgstr "" -#: reference/expressions.rst:1371 +#: reference/expressions.rst:1410 msgid "<<" msgstr "" -#: reference/expressions.rst:1371 +#: reference/expressions.rst:1410 msgid ">>" msgstr "" -#: reference/expressions.rst:1387 +#: reference/expressions.rst:1428 msgid "ValueError" msgstr "" -#: reference/expressions.rst:1734 +#: reference/expressions.rst:1775 msgid "and" msgstr "" -#: reference/expressions.rst:1407 +#: reference/expressions.rst:1448 msgid "& (ampersand)" msgstr "" -#: reference/expressions.rst:1415 +#: reference/expressions.rst:1456 msgid "xor" msgstr "" -#: reference/expressions.rst:1415 +#: reference/expressions.rst:1456 msgid "exclusive" msgstr "" -#: reference/expressions.rst:1424 reference/expressions.rst:1739 +#: reference/expressions.rst:1465 reference/expressions.rst:1780 msgid "or" msgstr "" -#: reference/expressions.rst:1415 +#: reference/expressions.rst:1456 msgid "^ (caret)" msgstr "" -#: reference/expressions.rst:1424 +#: reference/expressions.rst:1465 msgid "inclusive" msgstr "" -#: reference/expressions.rst:1424 +#: reference/expressions.rst:1465 msgid "| (vertical bar)" msgstr "" -#: reference/expressions.rst:1439 +#: reference/expressions.rst:1480 msgid "comparison" msgstr "" -#: reference/expressions.rst:1439 +#: reference/expressions.rst:1480 msgid "C" msgstr "" -#: reference/expressions.rst:1439 +#: reference/expressions.rst:1480 msgid "language" msgstr "" -#: reference/expressions.rst:1439 +#: reference/expressions.rst:1480 msgid "< (less)" msgstr "" -#: reference/expressions.rst:1439 +#: reference/expressions.rst:1480 msgid "> (greater)" msgstr "" -#: reference/expressions.rst:1439 +#: reference/expressions.rst:1480 msgid "<=" msgstr "" -#: reference/expressions.rst:1439 +#: reference/expressions.rst:1480 msgid ">=" msgstr "" -#: reference/expressions.rst:1439 +#: reference/expressions.rst:1480 msgid "==" msgstr "" -#: reference/expressions.rst:1439 +#: reference/expressions.rst:1480 msgid "!=" msgstr "" -#: reference/expressions.rst:1463 +#: reference/expressions.rst:1504 msgid "chaining" msgstr "" -#: reference/expressions.rst:1463 +#: reference/expressions.rst:1504 msgid "comparisons" msgstr "" -#: reference/expressions.rst:1678 +#: reference/expressions.rst:1719 msgid "in" msgstr "" -#: reference/expressions.rst:1678 +#: reference/expressions.rst:1719 msgid "not in" msgstr "" -#: reference/expressions.rst:1678 +#: reference/expressions.rst:1719 msgid "membership" msgstr "" -#: reference/expressions.rst:1687 +#: reference/expressions.rst:1728 msgid "test" msgstr "" -#: reference/expressions.rst:1687 +#: reference/expressions.rst:1728 msgid "is" msgstr "" -#: reference/expressions.rst:1687 +#: reference/expressions.rst:1728 msgid "is not" msgstr "" -#: reference/expressions.rst:1687 +#: reference/expressions.rst:1728 msgid "identity" msgstr "" -#: reference/expressions.rst:1713 +#: reference/expressions.rst:1754 msgid "Conditional" msgstr "" -#: reference/expressions.rst:1713 +#: reference/expressions.rst:1754 msgid "Boolean" msgstr "" -#: reference/expressions.rst:1729 +#: reference/expressions.rst:1770 msgid "not" msgstr "" -#: reference/expressions.rst:1753 +#: reference/expressions.rst:1794 msgid ":= (colon equals)" msgstr "" -#: reference/expressions.rst:1753 +#: reference/expressions.rst:1794 msgid "assignment expression" msgstr "" -#: reference/expressions.rst:1753 +#: reference/expressions.rst:1794 msgid "walrus operator" msgstr "" -#: reference/expressions.rst:1753 +#: reference/expressions.rst:1794 msgid "named expression" msgstr "" -#: reference/expressions.rst:1801 +#: reference/expressions.rst:1842 msgid "conditional" msgstr "" -#: reference/expressions.rst:1801 +#: reference/expressions.rst:1842 msgid "ternary" msgstr "" -#: reference/expressions.rst:1801 +#: reference/expressions.rst:1842 msgid "conditional expression" msgstr "" -#: reference/expressions.rst:1801 +#: reference/expressions.rst:1842 msgid "else" msgstr "" -#: reference/expressions.rst:1827 +#: reference/expressions.rst:1868 msgid "lambda" msgstr "" -#: reference/expressions.rst:1827 +#: reference/expressions.rst:1868 msgid "form" msgstr "" -#: reference/expressions.rst:1827 +#: reference/expressions.rst:1868 msgid "anonymous" msgstr "" -#: reference/expressions.rst:1827 +#: reference/expressions.rst:1868 msgid "lambda expression" msgstr "" -#: reference/expressions.rst:1872 +#: reference/expressions.rst:1913 msgid "iterable" msgstr "" -#: reference/expressions.rst:1872 +#: reference/expressions.rst:1913 msgid "in expression lists" msgstr "" -#: reference/expressions.rst:1884 +#: reference/expressions.rst:1925 msgid "trailing" msgstr "" -#: reference/expressions.rst:1899 +#: reference/expressions.rst:1940 msgid "evaluation" msgstr "" -#: reference/expressions.rst:1899 +#: reference/expressions.rst:1940 msgid "order" msgstr "" -#: reference/expressions.rst:1920 +#: reference/expressions.rst:1961 msgid "precedence" msgstr "" diff --git a/reference/lexical_analysis.po b/reference/lexical_analysis.po index c21ffc509..c7ded3bcf 100644 --- a/reference/lexical_analysis.po +++ b/reference/lexical_analysis.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1047,7 +1047,7 @@ msgstr "" #: reference/lexical_analysis.rst:885 msgid "" -"There are three types of numeric literals: integers, floating point numbers, " +"There are three types of numeric literals: integers, floating-point numbers, " "and imaginary numbers. There are no complex literals (complex numbers can " "be formed by adding a real number and an imaginary number)." msgstr "" @@ -1096,25 +1096,25 @@ msgid "Underscores are now allowed for grouping purposes in literals." msgstr "" #: reference/lexical_analysis.rst:947 -msgid "Floating point literals" +msgid "Floating-point literals" msgstr "" #: reference/lexical_analysis.rst:949 msgid "" -"Floating point literals are described by the following lexical definitions:" +"Floating-point literals are described by the following lexical definitions:" msgstr "" #: reference/lexical_analysis.rst:959 msgid "" "Note that the integer and exponent parts are always interpreted using radix " "10. For example, ``077e010`` is legal, and denotes the same number as " -"``77e10``. The allowed range of floating point literals is implementation-" +"``77e10``. The allowed range of floating-point literals is implementation-" "dependent. As in integer literals, underscores are supported for digit " "grouping." msgstr "" #: reference/lexical_analysis.rst:964 -msgid "Some examples of floating point literals::" +msgid "Some examples of floating-point literals::" msgstr "" #: reference/lexical_analysis.rst:977 @@ -1128,9 +1128,9 @@ msgstr "" #: reference/lexical_analysis.rst:984 msgid "" "An imaginary literal yields a complex number with a real part of 0.0. " -"Complex numbers are represented as a pair of floating point numbers and have " +"Complex numbers are represented as a pair of floating-point numbers and have " "the same restrictions on their range. To create a complex number with a " -"nonzero real part, add a floating point number to it, e.g., ``(3+4j)``. " +"nonzero real part, add a floating-point number to it, e.g., ``(3+4j)``. " "Some examples of imaginary literals::" msgstr "" @@ -1524,7 +1524,7 @@ msgid "integer literal" msgstr "" #: reference/lexical_analysis.rst:881 -msgid "floating point literal" +msgid "floating-point literal" msgstr "" #: reference/lexical_analysis.rst:881 diff --git a/reference/simple_stmts.po b/reference/simple_stmts.po index 79cd7b704..25668ebd5 100644 --- a/reference/simple_stmts.po +++ b/reference/simple_stmts.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -281,7 +281,7 @@ msgstr "" #: reference/simple_stmts.rst:296 msgid "" -"An augmented assignment expression like ``x += 1`` can be rewritten as ``x = " +"An augmented assignment statement like ``x += 1`` can be rewritten as ``x = " "x + 1`` to achieve a similar, but not exactly equal effect. In the augmented " "version, ``x`` is only evaluated once. Also, when possible, the actual " "operation is performed *in-place*, meaning that rather than creating a new " @@ -331,27 +331,29 @@ msgstr "" #: reference/simple_stmts.rst:336 msgid "" -"For simple names as assignment targets, if in class or module scope, the " -"annotations are evaluated and stored in a special class or module attribute :" -"attr:`__annotations__` that is a dictionary mapping from variable names " -"(mangled if private) to evaluated annotations. This attribute is writable " -"and is automatically created at the start of class or module body execution, " -"if annotations are found statically." +"The assignment target is considered \"simple\" if it consists of a single " +"name that is not enclosed in parentheses. For simple assignment targets, if " +"in class or module scope, the annotations are evaluated and stored in a " +"special class or module attribute :attr:`__annotations__` that is a " +"dictionary mapping from variable names (mangled if private) to evaluated " +"annotations. This attribute is writable and is automatically created at the " +"start of class or module body execution, if annotations are found statically." msgstr "" -#: reference/simple_stmts.rst:344 +#: reference/simple_stmts.rst:346 msgid "" -"For expressions as assignment targets, the annotations are evaluated if in " -"class or module scope, but not stored." +"If the assignment target is not simple (an attribute, subscript node, or " +"parenthesized name), the annotation is evaluated if in class or module " +"scope, but not stored." msgstr "" -#: reference/simple_stmts.rst:347 +#: reference/simple_stmts.rst:350 msgid "" "If a name is annotated in a function scope, then this name is local for that " "scope. Annotations are never evaluated and stored in function scopes." msgstr "" -#: reference/simple_stmts.rst:350 +#: reference/simple_stmts.rst:353 msgid "" "If the right hand side is present, an annotated assignment performs the " "actual assignment before evaluating annotations (where applicable). If the " @@ -360,55 +362,55 @@ msgid "" "__setitem__` or :meth:`~object.__setattr__` call." msgstr "" -#: reference/simple_stmts.rst:358 +#: reference/simple_stmts.rst:361 msgid ":pep:`526` - Syntax for Variable Annotations" msgstr "" -#: reference/simple_stmts.rst:359 +#: reference/simple_stmts.rst:362 msgid "" "The proposal that added syntax for annotating the types of variables " "(including class variables and instance variables), instead of expressing " "them through comments." msgstr "" -#: reference/simple_stmts.rst:363 +#: reference/simple_stmts.rst:366 msgid ":pep:`484` - Type hints" msgstr "" -#: reference/simple_stmts.rst:364 +#: reference/simple_stmts.rst:367 msgid "" "The proposal that added the :mod:`typing` module to provide a standard " "syntax for type annotations that can be used in static analysis tools and " "IDEs." msgstr "" -#: reference/simple_stmts.rst:368 +#: reference/simple_stmts.rst:371 msgid "" "Now annotated assignments allow the same expressions in the right hand side " "as regular assignments. Previously, some expressions (like un-parenthesized " "tuple expressions) caused a syntax error." msgstr "" -#: reference/simple_stmts.rst:377 +#: reference/simple_stmts.rst:380 msgid "The :keyword:`!assert` statement" msgstr "" -#: reference/simple_stmts.rst:384 +#: reference/simple_stmts.rst:387 msgid "" "Assert statements are a convenient way to insert debugging assertions into a " "program:" msgstr "" -#: reference/simple_stmts.rst:390 +#: reference/simple_stmts.rst:393 msgid "The simple form, ``assert expression``, is equivalent to ::" msgstr "" -#: reference/simple_stmts.rst:395 +#: reference/simple_stmts.rst:398 msgid "" "The extended form, ``assert expression1, expression2``, is equivalent to ::" msgstr "" -#: reference/simple_stmts.rst:404 +#: reference/simple_stmts.rst:407 msgid "" "These equivalences assume that :const:`__debug__` and :exc:`AssertionError` " "refer to the built-in variables with those names. In the current " @@ -420,40 +422,40 @@ msgid "" "in the error message; it will be displayed as part of the stack trace." msgstr "" -#: reference/simple_stmts.rst:413 +#: reference/simple_stmts.rst:416 msgid "" "Assignments to :const:`__debug__` are illegal. The value for the built-in " "variable is determined when the interpreter starts." msgstr "" -#: reference/simple_stmts.rst:420 +#: reference/simple_stmts.rst:423 msgid "The :keyword:`!pass` statement" msgstr "" -#: reference/simple_stmts.rst:430 +#: reference/simple_stmts.rst:433 msgid "" ":keyword:`pass` is a null operation --- when it is executed, nothing " "happens. It is useful as a placeholder when a statement is required " "syntactically, but no code needs to be executed, for example::" msgstr "" -#: reference/simple_stmts.rst:442 +#: reference/simple_stmts.rst:445 msgid "The :keyword:`!del` statement" msgstr "" -#: reference/simple_stmts.rst:452 +#: reference/simple_stmts.rst:455 msgid "" "Deletion is recursively defined very similar to the way assignment is " "defined. Rather than spelling it out in full details, here are some hints." msgstr "" -#: reference/simple_stmts.rst:455 +#: reference/simple_stmts.rst:458 msgid "" "Deletion of a target list recursively deletes each target, from left to " "right." msgstr "" -#: reference/simple_stmts.rst:461 +#: reference/simple_stmts.rst:464 msgid "" "Deletion of a name removes the binding of that name from the local or global " "namespace, depending on whether the name occurs in a :keyword:`global` " @@ -461,7 +463,7 @@ msgid "" "`NameError` exception will be raised." msgstr "" -#: reference/simple_stmts.rst:468 +#: reference/simple_stmts.rst:471 msgid "" "Deletion of attribute references, subscriptions and slicings is passed to " "the primary object involved; deletion of a slicing is in general equivalent " @@ -469,42 +471,42 @@ msgid "" "determined by the sliced object)." msgstr "" -#: reference/simple_stmts.rst:473 +#: reference/simple_stmts.rst:476 msgid "" "Previously it was illegal to delete a name from the local namespace if it " "occurs as a free variable in a nested block." msgstr "" -#: reference/simple_stmts.rst:481 +#: reference/simple_stmts.rst:484 msgid "The :keyword:`!return` statement" msgstr "" -#: reference/simple_stmts.rst:491 +#: reference/simple_stmts.rst:494 msgid "" ":keyword:`return` may only occur syntactically nested in a function " "definition, not within a nested class definition." msgstr "" -#: reference/simple_stmts.rst:494 +#: reference/simple_stmts.rst:497 msgid "" "If an expression list is present, it is evaluated, else ``None`` is " "substituted." msgstr "" -#: reference/simple_stmts.rst:496 +#: reference/simple_stmts.rst:499 msgid "" ":keyword:`return` leaves the current function call with the expression list " "(or ``None``) as return value." msgstr "" -#: reference/simple_stmts.rst:501 +#: reference/simple_stmts.rst:504 msgid "" "When :keyword:`return` passes control out of a :keyword:`try` statement with " "a :keyword:`finally` clause, that :keyword:`!finally` clause is executed " "before really leaving the function." msgstr "" -#: reference/simple_stmts.rst:505 +#: reference/simple_stmts.rst:508 msgid "" "In a generator function, the :keyword:`return` statement indicates that the " "generator is done and will cause :exc:`StopIteration` to be raised. The " @@ -512,7 +514,7 @@ msgid "" "`StopIteration` and becomes the :attr:`StopIteration.value` attribute." msgstr "" -#: reference/simple_stmts.rst:510 +#: reference/simple_stmts.rst:513 msgid "" "In an asynchronous generator function, an empty :keyword:`return` statement " "indicates that the asynchronous generator is done and will cause :exc:" @@ -520,11 +522,11 @@ msgid "" "is a syntax error in an asynchronous generator function." msgstr "" -#: reference/simple_stmts.rst:518 +#: reference/simple_stmts.rst:521 msgid "The :keyword:`!yield` statement" msgstr "" -#: reference/simple_stmts.rst:530 +#: reference/simple_stmts.rst:533 msgid "" "A :keyword:`yield` statement is semantically equivalent to a :ref:`yield " "expression `. The yield statement can be used to omit the " @@ -532,11 +534,11 @@ msgid "" "expression statement. For example, the yield statements ::" msgstr "" -#: reference/simple_stmts.rst:538 +#: reference/simple_stmts.rst:541 msgid "are equivalent to the yield expression statements ::" msgstr "" -#: reference/simple_stmts.rst:543 +#: reference/simple_stmts.rst:546 msgid "" "Yield expressions and statements are only used when defining a :term:" "`generator` function, and are only used in the body of the generator " @@ -544,17 +546,17 @@ msgid "" "definition to create a generator function instead of a normal function." msgstr "" -#: reference/simple_stmts.rst:548 +#: reference/simple_stmts.rst:551 msgid "" "For full details of :keyword:`yield` semantics, refer to the :ref:" "`yieldexpr` section." msgstr "" -#: reference/simple_stmts.rst:554 +#: reference/simple_stmts.rst:557 msgid "The :keyword:`!raise` statement" msgstr "" -#: reference/simple_stmts.rst:565 +#: reference/simple_stmts.rst:568 msgid "" "If no expressions are present, :keyword:`raise` re-raises the exception that " "is currently being handled, which is also known as the *active exception*. " @@ -562,7 +564,7 @@ msgid "" "exception is raised indicating that this is an error." msgstr "" -#: reference/simple_stmts.rst:570 +#: reference/simple_stmts.rst:573 msgid "" "Otherwise, :keyword:`raise` evaluates the first expression as the exception " "object. It must be either a subclass or an instance of :class:" @@ -570,13 +572,13 @@ msgid "" "when needed by instantiating the class with no arguments." msgstr "" -#: reference/simple_stmts.rst:575 +#: reference/simple_stmts.rst:578 msgid "" "The :dfn:`type` of the exception is the exception instance's class, the :dfn:" "`value` is the instance itself." msgstr "" -#: reference/simple_stmts.rst:580 +#: reference/simple_stmts.rst:583 msgid "" "A traceback object is normally created automatically when an exception is " "raised and attached to it as the :attr:`~BaseException.__traceback__` " @@ -586,7 +588,7 @@ msgid "" "argument), like so::" msgstr "" -#: reference/simple_stmts.rst:592 +#: reference/simple_stmts.rst:595 msgid "" "The ``from`` clause is used for exception chaining: if given, the second " "*expression* must be another exception class or instance. If the second " @@ -598,7 +600,7 @@ msgid "" "exception is not handled, both exceptions will be printed:" msgstr "" -#: reference/simple_stmts.rst:621 +#: reference/simple_stmts.rst:624 msgid "" "A similar mechanism works implicitly if a new exception is raised when an " "exception is already being handled. An exception may be handled when an :" @@ -607,30 +609,30 @@ msgid "" "exception's :attr:`~BaseException.__context__` attribute:" msgstr "" -#: reference/simple_stmts.rst:647 +#: reference/simple_stmts.rst:650 msgid "" "Exception chaining can be explicitly suppressed by specifying :const:`None` " "in the ``from`` clause:" msgstr "" -#: reference/simple_stmts.rst:661 +#: reference/simple_stmts.rst:664 msgid "" "Additional information on exceptions can be found in section :ref:" "`exceptions`, and information about handling exceptions is in section :ref:" "`try`." msgstr "" -#: reference/simple_stmts.rst:664 +#: reference/simple_stmts.rst:667 msgid ":const:`None` is now permitted as ``Y`` in ``raise X from Y``." msgstr "" -#: reference/simple_stmts.rst:667 +#: reference/simple_stmts.rst:670 msgid "" "Added the :attr:`~BaseException.__suppress_context__` attribute to suppress " "automatic display of the exception context." msgstr "" -#: reference/simple_stmts.rst:670 +#: reference/simple_stmts.rst:673 msgid "" "If the traceback of the active exception is modified in an :keyword:`except` " "clause, a subsequent ``raise`` statement re-raises the exception with the " @@ -638,41 +640,41 @@ msgid "" "traceback it had when it was caught." msgstr "" -#: reference/simple_stmts.rst:679 +#: reference/simple_stmts.rst:682 msgid "The :keyword:`!break` statement" msgstr "" -#: reference/simple_stmts.rst:690 +#: reference/simple_stmts.rst:693 msgid "" ":keyword:`break` may only occur syntactically nested in a :keyword:`for` or :" "keyword:`while` loop, but not nested in a function or class definition " "within that loop." msgstr "" -#: reference/simple_stmts.rst:697 +#: reference/simple_stmts.rst:700 msgid "" "It terminates the nearest enclosing loop, skipping the optional :keyword:`!" "else` clause if the loop has one." msgstr "" -#: reference/simple_stmts.rst:700 +#: reference/simple_stmts.rst:703 msgid "" "If a :keyword:`for` loop is terminated by :keyword:`break`, the loop control " "target keeps its current value." msgstr "" -#: reference/simple_stmts.rst:705 +#: reference/simple_stmts.rst:708 msgid "" "When :keyword:`break` passes control out of a :keyword:`try` statement with " "a :keyword:`finally` clause, that :keyword:`!finally` clause is executed " "before really leaving the loop." msgstr "" -#: reference/simple_stmts.rst:713 +#: reference/simple_stmts.rst:716 msgid "The :keyword:`!continue` statement" msgstr "" -#: reference/simple_stmts.rst:725 +#: reference/simple_stmts.rst:728 msgid "" ":keyword:`continue` may only occur syntactically nested in a :keyword:`for` " "or :keyword:`while` loop, but not nested in a function or class definition " @@ -680,41 +682,41 @@ msgid "" "loop." msgstr "" -#: reference/simple_stmts.rst:729 +#: reference/simple_stmts.rst:732 msgid "" "When :keyword:`continue` passes control out of a :keyword:`try` statement " "with a :keyword:`finally` clause, that :keyword:`!finally` clause is " "executed before really starting the next loop cycle." msgstr "" -#: reference/simple_stmts.rst:738 +#: reference/simple_stmts.rst:741 msgid "The :keyword:`!import` statement" msgstr "" -#: reference/simple_stmts.rst:759 +#: reference/simple_stmts.rst:762 msgid "" "The basic import statement (no :keyword:`from` clause) is executed in two " "steps:" msgstr "" -#: reference/simple_stmts.rst:762 +#: reference/simple_stmts.rst:765 msgid "find a module, loading and initializing it if necessary" msgstr "" -#: reference/simple_stmts.rst:763 +#: reference/simple_stmts.rst:766 msgid "" "define a name or names in the local namespace for the scope where the :" "keyword:`import` statement occurs." msgstr "" -#: reference/simple_stmts.rst:766 +#: reference/simple_stmts.rst:769 msgid "" "When the statement contains multiple clauses (separated by commas) the two " "steps are carried out separately for each clause, just as though the clauses " "had been separated out into individual import statements." msgstr "" -#: reference/simple_stmts.rst:771 +#: reference/simple_stmts.rst:774 msgid "" "The details of the first step, finding and loading modules, are described in " "greater detail in the section on the :ref:`import system `, " @@ -725,26 +727,26 @@ msgid "" "module, which includes execution of the module's code." msgstr "" -#: reference/simple_stmts.rst:779 +#: reference/simple_stmts.rst:782 msgid "" "If the requested module is retrieved successfully, it will be made available " "in the local namespace in one of three ways:" msgstr "" -#: reference/simple_stmts.rst:784 +#: reference/simple_stmts.rst:787 msgid "" "If the module name is followed by :keyword:`!as`, then the name following :" "keyword:`!as` is bound directly to the imported module." msgstr "" -#: reference/simple_stmts.rst:786 +#: reference/simple_stmts.rst:789 msgid "" "If no other name is specified, and the module being imported is a top level " "module, the module's name is bound in the local namespace as a reference to " "the imported module" msgstr "" -#: reference/simple_stmts.rst:789 +#: reference/simple_stmts.rst:792 msgid "" "If the module being imported is *not* a top level module, then the name of " "the top level package that contains the module is bound in the local " @@ -752,53 +754,53 @@ msgid "" "be accessed using its full qualified name rather than directly" msgstr "" -#: reference/simple_stmts.rst:799 +#: reference/simple_stmts.rst:802 msgid "The :keyword:`from` form uses a slightly more complex process:" msgstr "" -#: reference/simple_stmts.rst:801 +#: reference/simple_stmts.rst:804 msgid "" "find the module specified in the :keyword:`from` clause, loading and " "initializing it if necessary;" msgstr "" -#: reference/simple_stmts.rst:803 +#: reference/simple_stmts.rst:806 msgid "for each of the identifiers specified in the :keyword:`import` clauses:" msgstr "" -#: reference/simple_stmts.rst:805 +#: reference/simple_stmts.rst:808 msgid "check if the imported module has an attribute by that name" msgstr "" -#: reference/simple_stmts.rst:806 +#: reference/simple_stmts.rst:809 msgid "" "if not, attempt to import a submodule with that name and then check the " "imported module again for that attribute" msgstr "" -#: reference/simple_stmts.rst:808 +#: reference/simple_stmts.rst:811 msgid "if the attribute is not found, :exc:`ImportError` is raised." msgstr "" -#: reference/simple_stmts.rst:809 +#: reference/simple_stmts.rst:812 msgid "" "otherwise, a reference to that value is stored in the local namespace, using " "the name in the :keyword:`!as` clause if it is present, otherwise using the " "attribute name" msgstr "" -#: reference/simple_stmts.rst:813 +#: reference/simple_stmts.rst:816 msgid "Examples::" msgstr "" -#: reference/simple_stmts.rst:823 +#: reference/simple_stmts.rst:826 msgid "" "If the list of identifiers is replaced by a star (``'*'``), all public names " "defined in the module are bound in the local namespace for the scope where " "the :keyword:`import` statement occurs." msgstr "" -#: reference/simple_stmts.rst:829 +#: reference/simple_stmts.rst:832 msgid "" "The *public names* defined by a module are determined by checking the " "module's namespace for a variable named ``__all__``; if defined, it must be " @@ -811,14 +813,14 @@ msgid "" "API (such as library modules which were imported and used within the module)." msgstr "" -#: reference/simple_stmts.rst:839 +#: reference/simple_stmts.rst:842 msgid "" "The wild card form of import --- ``from module import *`` --- is only " "allowed at the module level. Attempting to use it in class or function " "definitions will raise a :exc:`SyntaxError`." msgstr "" -#: reference/simple_stmts.rst:846 +#: reference/simple_stmts.rst:849 msgid "" "When specifying what module to import you do not have to specify the " "absolute name of the module. When a module or package is contained within " @@ -835,31 +837,30 @@ msgid "" "the :ref:`relativeimports` section." msgstr "" -#: reference/simple_stmts.rst:860 +#: reference/simple_stmts.rst:863 msgid "" ":func:`importlib.import_module` is provided to support applications that " "determine dynamically the modules to be loaded." msgstr "" -#: reference/simple_stmts.rst:863 +#: reference/simple_stmts.rst:866 msgid "" -"Raises an :ref:`auditing event ` ``import`` with arguments " -"``module``, ``filename``, ``sys.path``, ``sys.meta_path``, ``sys." -"path_hooks``." +"Raises an auditing event import with arguments module, filename, sys.path, " +"sys.meta_path, sys.path_hooks." msgstr "" -#: reference/simple_stmts.rst:868 +#: reference/simple_stmts.rst:871 msgid "Future statements" msgstr "" -#: reference/simple_stmts.rst:874 +#: reference/simple_stmts.rst:877 msgid "" "A :dfn:`future statement` is a directive to the compiler that a particular " "module should be compiled using syntax or semantics that will be available " "in a specified future release of Python where the feature becomes standard." msgstr "" -#: reference/simple_stmts.rst:878 +#: reference/simple_stmts.rst:881 msgid "" "The future statement is intended to ease migration to future versions of " "Python that introduce incompatible changes to the language. It allows use " @@ -867,35 +868,35 @@ msgid "" "feature becomes standard." msgstr "" -#: reference/simple_stmts.rst:890 +#: reference/simple_stmts.rst:893 msgid "" "A future statement must appear near the top of the module. The only lines " "that can appear before a future statement are:" msgstr "" -#: reference/simple_stmts.rst:893 +#: reference/simple_stmts.rst:896 msgid "the module docstring (if any)," msgstr "" -#: reference/simple_stmts.rst:894 +#: reference/simple_stmts.rst:897 msgid "comments," msgstr "" -#: reference/simple_stmts.rst:895 +#: reference/simple_stmts.rst:898 msgid "blank lines, and" msgstr "" -#: reference/simple_stmts.rst:896 +#: reference/simple_stmts.rst:899 msgid "other future statements." msgstr "" -#: reference/simple_stmts.rst:898 +#: reference/simple_stmts.rst:901 msgid "" "The only feature that requires using the future statement is ``annotations`` " "(see :pep:`563`)." msgstr "" -#: reference/simple_stmts.rst:901 +#: reference/simple_stmts.rst:904 msgid "" "All historical features enabled by the future statement are still recognized " "by Python 3. The list includes ``absolute_import``, ``division``, " @@ -905,7 +906,7 @@ msgid "" "compatibility." msgstr "" -#: reference/simple_stmts.rst:908 +#: reference/simple_stmts.rst:911 msgid "" "A future statement is recognized and treated specially at compile time: " "Changes to the semantics of core constructs are often implemented by " @@ -915,37 +916,37 @@ msgid "" "cannot be pushed off until runtime." msgstr "" -#: reference/simple_stmts.rst:915 +#: reference/simple_stmts.rst:918 msgid "" "For any given release, the compiler knows which feature names have been " "defined, and raises a compile-time error if a future statement contains a " "feature not known to it." msgstr "" -#: reference/simple_stmts.rst:919 +#: reference/simple_stmts.rst:922 msgid "" "The direct runtime semantics are the same as for any import statement: there " "is a standard module :mod:`__future__`, described later, and it will be " "imported in the usual way at the time the future statement is executed." msgstr "" -#: reference/simple_stmts.rst:923 +#: reference/simple_stmts.rst:926 msgid "" "The interesting runtime semantics depend on the specific feature enabled by " "the future statement." msgstr "" -#: reference/simple_stmts.rst:926 +#: reference/simple_stmts.rst:929 msgid "Note that there is nothing special about the statement::" msgstr "" -#: reference/simple_stmts.rst:930 +#: reference/simple_stmts.rst:933 msgid "" "That is not a future statement; it's an ordinary import statement with no " "special semantics or syntax restrictions." msgstr "" -#: reference/simple_stmts.rst:933 +#: reference/simple_stmts.rst:936 msgid "" "Code compiled by calls to the built-in functions :func:`exec` and :func:" "`compile` that occur in a module :mod:`!M` containing a future statement " @@ -954,7 +955,7 @@ msgid "" "--- see the documentation of that function for details." msgstr "" -#: reference/simple_stmts.rst:939 +#: reference/simple_stmts.rst:942 msgid "" "A future statement typed at an interactive interpreter prompt will take " "effect for the rest of the interpreter session. If an interpreter is " @@ -963,19 +964,19 @@ msgid "" "interactive session started after the script is executed." msgstr "" -#: reference/simple_stmts.rst:947 +#: reference/simple_stmts.rst:950 msgid ":pep:`236` - Back to the __future__" msgstr "" -#: reference/simple_stmts.rst:948 +#: reference/simple_stmts.rst:951 msgid "The original proposal for the __future__ mechanism." msgstr "" -#: reference/simple_stmts.rst:954 +#: reference/simple_stmts.rst:957 msgid "The :keyword:`!global` statement" msgstr "" -#: reference/simple_stmts.rst:964 +#: reference/simple_stmts.rst:967 msgid "" "The :keyword:`global` statement is a declaration which holds for the entire " "current code block. It means that the listed identifiers are to be " @@ -984,13 +985,13 @@ msgid "" "globals without being declared global." msgstr "" -#: reference/simple_stmts.rst:970 +#: reference/simple_stmts.rst:973 msgid "" "Names listed in a :keyword:`global` statement must not be used in the same " "code block textually preceding that :keyword:`!global` statement." msgstr "" -#: reference/simple_stmts.rst:973 +#: reference/simple_stmts.rst:976 msgid "" "Names listed in a :keyword:`global` statement must not be defined as formal " "parameters, or as targets in :keyword:`with` statements or :keyword:`except` " @@ -998,14 +999,14 @@ msgid "" "function definition, :keyword:`import` statement, or variable annotation." msgstr "" -#: reference/simple_stmts.rst:980 +#: reference/simple_stmts.rst:983 msgid "" "The current implementation does not enforce some of these restrictions, but " "programs should not abuse this freedom, as future implementations may " "enforce them or silently change the meaning of the program." msgstr "" -#: reference/simple_stmts.rst:989 +#: reference/simple_stmts.rst:992 msgid "" "**Programmer's note:** :keyword:`global` is a directive to the parser. It " "applies only to code parsed at the same time as the :keyword:`!global` " @@ -1017,11 +1018,11 @@ msgid "" "func:`compile` functions." msgstr "" -#: reference/simple_stmts.rst:1001 +#: reference/simple_stmts.rst:1004 msgid "The :keyword:`!nonlocal` statement" msgstr "" -#: reference/simple_stmts.rst:1009 +#: reference/simple_stmts.rst:1012 msgid "" "When the definition of a function or class is nested (enclosed) within the " "definitions of other functions, its nonlocal scopes are the local scopes of " @@ -1033,53 +1034,53 @@ msgid "" "`SyntaxError` is raised." msgstr "" -#: reference/simple_stmts.rst:1018 +#: reference/simple_stmts.rst:1021 msgid "" "The nonlocal statement applies to the entire scope of a function or class " "body. A :exc:`SyntaxError` is raised if a variable is used or assigned to " "prior to its nonlocal declaration in the scope." msgstr "" -#: reference/simple_stmts.rst:1024 +#: reference/simple_stmts.rst:1027 msgid ":pep:`3104` - Access to Names in Outer Scopes" msgstr "" -#: reference/simple_stmts.rst:1025 +#: reference/simple_stmts.rst:1028 msgid "The specification for the :keyword:`nonlocal` statement." msgstr "" -#: reference/simple_stmts.rst:1027 +#: reference/simple_stmts.rst:1030 msgid "" "**Programmer's note:** :keyword:`nonlocal` is a directive to the parser and " "applies only to code parsed along with it. See the note for the :keyword:" "`global` statement." msgstr "" -#: reference/simple_stmts.rst:1035 +#: reference/simple_stmts.rst:1038 msgid "The :keyword:`!type` statement" msgstr "" -#: reference/simple_stmts.rst:1042 +#: reference/simple_stmts.rst:1045 msgid "" "The :keyword:`!type` statement declares a type alias, which is an instance " "of :class:`typing.TypeAliasType`." msgstr "" -#: reference/simple_stmts.rst:1045 +#: reference/simple_stmts.rst:1048 msgid "For example, the following statement creates a type alias::" msgstr "" -#: reference/simple_stmts.rst:1049 +#: reference/simple_stmts.rst:1052 msgid "This code is roughly equivalent to::" msgstr "" -#: reference/simple_stmts.rst:1055 +#: reference/simple_stmts.rst:1058 msgid "" "``annotation-def`` indicates an :ref:`annotation scope `, " "which behaves mostly like a function, but with several small differences." msgstr "" -#: reference/simple_stmts.rst:1058 +#: reference/simple_stmts.rst:1061 msgid "" "The value of the type alias is evaluated in the annotation scope. It is not " "evaluated when the type alias is created, but only when the value is " @@ -1088,21 +1089,21 @@ msgid "" "not yet defined." msgstr "" -#: reference/simple_stmts.rst:1064 +#: reference/simple_stmts.rst:1067 msgid "" "Type aliases may be made generic by adding a :ref:`type parameter list ` after the name. See :ref:`generic-type-aliases` for more." msgstr "" -#: reference/simple_stmts.rst:1067 +#: reference/simple_stmts.rst:1070 msgid ":keyword:`!type` is a :ref:`soft keyword `." msgstr "" -#: reference/simple_stmts.rst:1073 +#: reference/simple_stmts.rst:1076 msgid ":pep:`695` - Type Parameter Syntax" msgstr "" -#: reference/simple_stmts.rst:1074 +#: reference/simple_stmts.rst:1077 msgid "" "Introduced the :keyword:`!type` statement and syntax for generic classes and " "functions." @@ -1113,10 +1114,10 @@ msgid "simple" msgstr "" #: reference/simple_stmts.rst:39 reference/simple_stmts.rst:263 -#: reference/simple_stmts.rst:379 reference/simple_stmts.rst:444 -#: reference/simple_stmts.rst:483 reference/simple_stmts.rst:556 -#: reference/simple_stmts.rst:715 reference/simple_stmts.rst:870 -#: reference/simple_stmts.rst:1003 reference/simple_stmts.rst:1037 +#: reference/simple_stmts.rst:382 reference/simple_stmts.rst:447 +#: reference/simple_stmts.rst:486 reference/simple_stmts.rst:559 +#: reference/simple_stmts.rst:718 reference/simple_stmts.rst:873 +#: reference/simple_stmts.rst:1006 reference/simple_stmts.rst:1040 msgid "statement" msgstr "" @@ -1125,11 +1126,11 @@ msgid "expression" msgstr "" #: reference/simple_stmts.rst:42 reference/simple_stmts.rst:116 -#: reference/simple_stmts.rst:444 +#: reference/simple_stmts.rst:447 msgid "list" msgstr "" -#: reference/simple_stmts.rst:984 +#: reference/simple_stmts.rst:987 msgid "built-in function" msgstr "" @@ -1138,7 +1139,7 @@ msgid "repr" msgstr "" #: reference/simple_stmts.rst:75 reference/simple_stmts.rst:196 -#: reference/simple_stmts.rst:578 +#: reference/simple_stmts.rst:581 msgid "object" msgstr "" @@ -1191,12 +1192,12 @@ msgstr "" msgid "assignment" msgstr "" -#: reference/simple_stmts.rst:740 reference/simple_stmts.rst:956 +#: reference/simple_stmts.rst:743 reference/simple_stmts.rst:959 msgid "binding" msgstr "" -#: reference/simple_stmts.rst:457 reference/simple_stmts.rst:795 -#: reference/simple_stmts.rst:956 +#: reference/simple_stmts.rst:460 reference/simple_stmts.rst:798 +#: reference/simple_stmts.rst:959 msgid "name" msgstr "" @@ -1208,16 +1209,16 @@ msgstr "" msgid "mutable" msgstr "" -#: reference/simple_stmts.rst:159 reference/simple_stmts.rst:466 +#: reference/simple_stmts.rst:159 reference/simple_stmts.rst:469 msgid "attribute" msgstr "" -#: reference/simple_stmts.rst:116 reference/simple_stmts.rst:694 +#: reference/simple_stmts.rst:116 reference/simple_stmts.rst:697 msgid "target" msgstr "" -#: reference/simple_stmts.rst:379 reference/simple_stmts.rst:956 -#: reference/simple_stmts.rst:1003 +#: reference/simple_stmts.rst:382 reference/simple_stmts.rst:959 +#: reference/simple_stmts.rst:1006 msgid ", (comma)" msgstr "" @@ -1225,7 +1226,7 @@ msgstr "" msgid "in target list" msgstr "" -#: reference/simple_stmts.rst:821 +#: reference/simple_stmts.rst:824 msgid "* (asterisk)" msgstr "" @@ -1341,228 +1342,228 @@ msgstr "" msgid "annotated variable" msgstr "" -#: reference/simple_stmts.rst:379 +#: reference/simple_stmts.rst:382 msgid "assert" msgstr "" -#: reference/simple_stmts.rst:379 +#: reference/simple_stmts.rst:382 msgid "debugging" msgstr "" -#: reference/simple_stmts.rst:379 +#: reference/simple_stmts.rst:382 msgid "assertions" msgstr "" -#: reference/simple_stmts.rst:379 +#: reference/simple_stmts.rst:382 msgid "expression list" msgstr "" -#: reference/simple_stmts.rst:400 +#: reference/simple_stmts.rst:403 msgid "__debug__" msgstr "" -#: reference/simple_stmts.rst:520 reference/simple_stmts.rst:588 -#: reference/simple_stmts.rst:740 +#: reference/simple_stmts.rst:523 reference/simple_stmts.rst:591 +#: reference/simple_stmts.rst:743 msgid "exception" msgstr "" -#: reference/simple_stmts.rst:400 +#: reference/simple_stmts.rst:403 msgid "AssertionError" msgstr "" -#: reference/simple_stmts.rst:422 +#: reference/simple_stmts.rst:425 msgid "pass" msgstr "" -#: reference/simple_stmts.rst:422 +#: reference/simple_stmts.rst:425 msgid "null" msgstr "" -#: reference/simple_stmts.rst:422 +#: reference/simple_stmts.rst:425 msgid "operation" msgstr "" -#: reference/simple_stmts.rst:444 +#: reference/simple_stmts.rst:447 msgid "del" msgstr "" -#: reference/simple_stmts.rst:466 +#: reference/simple_stmts.rst:469 msgid "deletion" msgstr "" -#: reference/simple_stmts.rst:956 +#: reference/simple_stmts.rst:959 msgid "global" msgstr "" -#: reference/simple_stmts.rst:457 +#: reference/simple_stmts.rst:460 msgid "unbinding" msgstr "" -#: reference/simple_stmts.rst:483 +#: reference/simple_stmts.rst:486 msgid "return" msgstr "" -#: reference/simple_stmts.rst:520 +#: reference/simple_stmts.rst:523 msgid "function" msgstr "" -#: reference/simple_stmts.rst:483 +#: reference/simple_stmts.rst:486 msgid "definition" msgstr "" -#: reference/simple_stmts.rst:483 +#: reference/simple_stmts.rst:486 msgid "class" msgstr "" -#: reference/simple_stmts.rst:694 reference/simple_stmts.rst:715 -#: reference/simple_stmts.rst:740 +#: reference/simple_stmts.rst:697 reference/simple_stmts.rst:718 +#: reference/simple_stmts.rst:743 msgid "keyword" msgstr "" -#: reference/simple_stmts.rst:703 reference/simple_stmts.rst:715 +#: reference/simple_stmts.rst:706 reference/simple_stmts.rst:718 msgid "finally" msgstr "" -#: reference/simple_stmts.rst:520 +#: reference/simple_stmts.rst:523 msgid "yield" msgstr "" -#: reference/simple_stmts.rst:520 +#: reference/simple_stmts.rst:523 msgid "generator" msgstr "" -#: reference/simple_stmts.rst:520 +#: reference/simple_stmts.rst:523 msgid "iterator" msgstr "" -#: reference/simple_stmts.rst:520 +#: reference/simple_stmts.rst:523 msgid "StopIteration" msgstr "" -#: reference/simple_stmts.rst:556 +#: reference/simple_stmts.rst:559 msgid "raise" msgstr "" -#: reference/simple_stmts.rst:556 +#: reference/simple_stmts.rst:559 msgid "raising" msgstr "" -#: reference/simple_stmts.rst:556 +#: reference/simple_stmts.rst:559 msgid "__traceback__ (exception attribute)" msgstr "" -#: reference/simple_stmts.rst:578 +#: reference/simple_stmts.rst:581 msgid "traceback" msgstr "" -#: reference/simple_stmts.rst:588 +#: reference/simple_stmts.rst:591 msgid "chaining" msgstr "" -#: reference/simple_stmts.rst:588 +#: reference/simple_stmts.rst:591 msgid "__cause__ (exception attribute)" msgstr "" -#: reference/simple_stmts.rst:588 +#: reference/simple_stmts.rst:591 msgid "__context__ (exception attribute)" msgstr "" -#: reference/simple_stmts.rst:681 +#: reference/simple_stmts.rst:684 msgid "break" msgstr "" -#: reference/simple_stmts.rst:715 +#: reference/simple_stmts.rst:718 msgid "for" msgstr "" -#: reference/simple_stmts.rst:715 +#: reference/simple_stmts.rst:718 msgid "while" msgstr "" -#: reference/simple_stmts.rst:715 +#: reference/simple_stmts.rst:718 msgid "loop" msgstr "" -#: reference/simple_stmts.rst:694 +#: reference/simple_stmts.rst:697 msgid "else" msgstr "" -#: reference/simple_stmts.rst:694 +#: reference/simple_stmts.rst:697 msgid "loop control" msgstr "" -#: reference/simple_stmts.rst:715 +#: reference/simple_stmts.rst:718 msgid "continue" msgstr "" -#: reference/simple_stmts.rst:843 +#: reference/simple_stmts.rst:846 msgid "import" msgstr "" -#: reference/simple_stmts.rst:740 +#: reference/simple_stmts.rst:743 msgid "module" msgstr "" -#: reference/simple_stmts.rst:740 +#: reference/simple_stmts.rst:743 msgid "importing" msgstr "" -#: reference/simple_stmts.rst:795 +#: reference/simple_stmts.rst:798 msgid "from" msgstr "" -#: reference/simple_stmts.rst:782 +#: reference/simple_stmts.rst:785 msgid "as" msgstr "" -#: reference/simple_stmts.rst:740 +#: reference/simple_stmts.rst:743 msgid "ImportError" msgstr "" -#: reference/simple_stmts.rst:782 reference/simple_stmts.rst:821 +#: reference/simple_stmts.rst:785 reference/simple_stmts.rst:824 msgid "import statement" msgstr "" -#: reference/simple_stmts.rst:827 +#: reference/simple_stmts.rst:830 msgid "__all__ (optional module attribute)" msgstr "" -#: reference/simple_stmts.rst:843 +#: reference/simple_stmts.rst:846 msgid "relative" msgstr "" -#: reference/simple_stmts.rst:870 +#: reference/simple_stmts.rst:873 msgid "future" msgstr "" -#: reference/simple_stmts.rst:870 +#: reference/simple_stmts.rst:873 msgid "__future__" msgstr "" -#: reference/simple_stmts.rst:870 +#: reference/simple_stmts.rst:873 msgid "future statement" msgstr "" -#: reference/simple_stmts.rst:1003 +#: reference/simple_stmts.rst:1006 msgid "identifier list" msgstr "" -#: reference/simple_stmts.rst:984 +#: reference/simple_stmts.rst:987 msgid "exec" msgstr "" -#: reference/simple_stmts.rst:984 +#: reference/simple_stmts.rst:987 msgid "eval" msgstr "" -#: reference/simple_stmts.rst:984 +#: reference/simple_stmts.rst:987 msgid "compile" msgstr "" -#: reference/simple_stmts.rst:1003 +#: reference/simple_stmts.rst:1006 msgid "nonlocal" msgstr "" -#: reference/simple_stmts.rst:1037 +#: reference/simple_stmts.rst:1040 msgid "type" msgstr "" diff --git a/sphinx.po b/sphinx.po index 42efcc657..eee8d83ca 100644 --- a/sphinx.po +++ b/sphinx.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-01 00:17+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2022-12-28 16:25-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -230,84 +230,92 @@ msgstr "SSS (Sıkça Sorulan Sorular)" msgid "Frequently asked questions (with answers!)" msgstr "sıkça sorulan sorular (cevaplarla!)" -#: tools/templates/indexcontent.html:39 +#: tools/templates/indexcontent.html:36 +msgid "Deprecations" +msgstr "" + +#: tools/templates/indexcontent.html:37 +msgid "Deprecated functionality" +msgstr "" + +#: tools/templates/indexcontent.html:41 msgid "Indices, glossary, and search:" msgstr "" -#: tools/templates/indexcontent.html:42 +#: tools/templates/indexcontent.html:44 #, fuzzy msgid "Global module index" msgstr "Genel Modül Endeksi" -#: tools/templates/indexcontent.html:43 +#: tools/templates/indexcontent.html:45 msgid "All modules and libraries" msgstr "" -#: tools/templates/indexcontent.html:44 +#: tools/templates/indexcontent.html:46 #, fuzzy msgid "General index" msgstr "Genel Endeks" -#: tools/templates/indexcontent.html:45 +#: tools/templates/indexcontent.html:47 #, fuzzy msgid "All functions, classes, and terms" msgstr "tüm fonksiyonlar, sınıflar, terimler" -#: tools/templates/indexcontent.html:46 +#: tools/templates/indexcontent.html:48 msgid "Glossary" msgstr "Sözlük" -#: tools/templates/indexcontent.html:47 +#: tools/templates/indexcontent.html:49 msgid "Terms explained" msgstr "" -#: tools/templates/indexcontent.html:49 +#: tools/templates/indexcontent.html:51 msgid "Search page" msgstr "Arama sayfası" -#: tools/templates/indexcontent.html:50 +#: tools/templates/indexcontent.html:52 #, fuzzy msgid "Search this documentation" msgstr "bu dokümantasyonu ara" -#: tools/templates/indexcontent.html:51 +#: tools/templates/indexcontent.html:53 #, fuzzy msgid "Complete table of contents" msgstr "Bütün İçeriklerin Tablosu" -#: tools/templates/indexcontent.html:52 +#: tools/templates/indexcontent.html:54 #, fuzzy msgid "Lists all sections and subsections" msgstr "tüm bölümleri ve alt bölümleri listeler" -#: tools/templates/indexcontent.html:56 +#: tools/templates/indexcontent.html:58 #, fuzzy msgid "Project information:" msgstr "Meta bilgiler:" -#: tools/templates/indexcontent.html:59 +#: tools/templates/indexcontent.html:61 #, fuzzy msgid "Reporting issues" msgstr "Hataları bildirme" -#: tools/templates/indexcontent.html:60 +#: tools/templates/indexcontent.html:62 msgid "Contributing to Docs" msgstr "Dokümantasyona Katkıda Bulunma" -#: tools/templates/indexcontent.html:61 +#: tools/templates/indexcontent.html:63 msgid "Download the documentation" msgstr "Dokümantasyonu indir" -#: tools/templates/indexcontent.html:63 +#: tools/templates/indexcontent.html:65 #, fuzzy msgid "History and license of Python" msgstr "Python'un tarihçesi ve Lisansı" -#: tools/templates/indexcontent.html:64 +#: tools/templates/indexcontent.html:66 msgid "Copyright" msgstr "Telif Hakkı" -#: tools/templates/indexcontent.html:65 +#: tools/templates/indexcontent.html:67 msgid "About the documentation" msgstr "Dokümantasyon hakkında" diff --git a/tutorial/classes.po b/tutorial/classes.po index c095bba32..6a578c262 100644 --- a/tutorial/classes.po +++ b/tutorial/classes.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2023-02-02 02:32+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -611,21 +611,10 @@ msgstr "" #: tutorial/classes.rst:340 msgid "" "The other kind of instance attribute reference is a *method*. A method is a " -"function that \"belongs to\" an object. (In Python, the term method is not " -"unique to class instances: other object types can have methods as well. For " -"example, list objects have methods called append, insert, remove, sort, and " -"so on. However, in the following discussion, we'll use the term method " -"exclusively to mean methods of class instance objects, unless explicitly " -"stated otherwise.)" -msgstr "" -"Diğer örnek nitelik başvurusu türü bir *metot*. Metot, bir nesneye \"ait\" " -"olan bir fonksiyondur. (Python'da, terim metodu sınıf örneklerine özgü " -"değildir: diğer nesne türlerinin de metotları olabilir. Örneğin, liste " -"nesnelerini genişletme, ekleme, kaldırma, sıralama vb. Ancak, aşağıdaki " -"tartışmada, aksi açıkça belirtilmedikçe, yalnızca sınıf örneği nesnelerinin " -"metotlarını ifade etmek için terim metodunu kullanacağız.)" - -#: tutorial/classes.rst:349 +"function that \"belongs to\" an object." +msgstr "" + +#: tutorial/classes.rst:345 msgid "" "Valid method names of an instance object depend on its class. By " "definition, all attributes of a class that are function objects define " @@ -642,15 +631,15 @@ msgstr "" "``MyClass.f`` ile aynı şey değildir çünkü bir fonksiyon nesnesi değil, " "*metot nesnesi* 'dir." -#: tutorial/classes.rst:360 +#: tutorial/classes.rst:356 msgid "Method Objects" msgstr "Metot Nesneleri" -#: tutorial/classes.rst:362 +#: tutorial/classes.rst:358 msgid "Usually, a method is called right after it is bound::" msgstr "Genellikle, bir metot bağlandıktan hemen sonra çağrılır::" -#: tutorial/classes.rst:366 +#: tutorial/classes.rst:362 #, fuzzy msgid "" "In the :class:`!MyClass` example, this will return the string ``'hello " @@ -662,11 +651,11 @@ msgstr "" "hemen bir metot çağırmak gerekli değildir: ``x.f`` bir metot nesnesidir, " "yani daha sonra depolanabilir ve çağrılabilir. Mesela::" -#: tutorial/classes.rst:374 +#: tutorial/classes.rst:370 msgid "will continue to print ``hello world`` until the end of time." msgstr "daima ``hello world`` yazdırmaya devam edecek." -#: tutorial/classes.rst:376 +#: tutorial/classes.rst:372 #, fuzzy msgid "" "What exactly happens when a method is called? You may have noticed that ``x." @@ -682,7 +671,7 @@ msgstr "" "oldu? Elbette Python, argüman gerektiren bir fonksiyon, argüman verilmemiş " "iken çağırılırsa --- fonksiyon aslında kullanılmasa bile hata verir..." -#: tutorial/classes.rst:382 +#: tutorial/classes.rst:378 msgid "" "Actually, you may have guessed the answer: the special thing about methods " "is that the instance object is passed as the first argument of the " @@ -699,7 +688,7 @@ msgstr "" "önce metodun örnek nesnesi eklenerek oluşturulan bir argüman listesiyle " "karşılık gelen fonksiyonu çağırmaya eş değerdir." -#: tutorial/classes.rst:389 +#: tutorial/classes.rst:385 #, fuzzy msgid "" "In general, methods work as follows. When a non-data attribute of an " @@ -720,11 +709,11 @@ msgstr "" "bir argüman listesi oluşturulur ve fonksiyon nesnesi bu yeni argüman " "listesiyle çağrılır." -#: tutorial/classes.rst:402 +#: tutorial/classes.rst:398 msgid "Class and Instance Variables" msgstr "Sınıf ve Örnek Değişkenleri" -#: tutorial/classes.rst:404 +#: tutorial/classes.rst:400 msgid "" "Generally speaking, instance variables are for data unique to each instance " "and class variables are for attributes and methods shared by all instances " @@ -734,7 +723,7 @@ msgstr "" "değişkenleri sınıfın tüm örnekleri tarafından paylaşılan nitelikler ile " "metotlar içindir::" -#: tutorial/classes.rst:426 +#: tutorial/classes.rst:422 msgid "" "As discussed in :ref:`tut-object`, shared data can have possibly surprising " "effects with involving :term:`mutable` objects such as lists and " @@ -748,16 +737,16 @@ msgstr "" "kullanılmamalıdır, çünkü yalnızca tek bir liste tüm *Dog* örnekleri " "tarafından paylaşılacaktır::" -#: tutorial/classes.rst:449 +#: tutorial/classes.rst:445 msgid "Correct design of the class should use an instance variable instead::" msgstr "" "Doğru olan ise veriyi paylaşmak yerine bir örnek değişkeni kullanmaktır:" -#: tutorial/classes.rst:473 +#: tutorial/classes.rst:469 msgid "Random Remarks" msgstr "Rastgele Açıklamalar" -#: tutorial/classes.rst:477 +#: tutorial/classes.rst:473 msgid "" "If the same attribute name occurs in both an instance and in a class, then " "attribute lookup prioritizes the instance::" @@ -765,7 +754,7 @@ msgstr "" "Aynı nitelik adı hem bir örnekte hem de bir sınıfta oluşuyorsa, nitelik " "araması örneğe öncelik verir::" -#: tutorial/classes.rst:492 +#: tutorial/classes.rst:488 msgid "" "Data attributes may be referenced by methods as well as by ordinary users " "(\"clients\") of an object. In other words, classes are not usable to " @@ -784,7 +773,7 @@ msgstr "" "kontrol edebilir; bu, C ile yazılmış Python uzantıları tarafından " "kullanılabilir.)" -#: tutorial/classes.rst:500 +#: tutorial/classes.rst:496 msgid "" "Clients should use data attributes with care --- clients may mess up " "invariants maintained by the methods by stamping on their data attributes. " @@ -799,7 +788,7 @@ msgstr "" "burada da ad çakışmalarından kaçınılmalıdır, adlandırma kuralları ise " "kaçınmak için oldukça faydalı olabilir." -#: tutorial/classes.rst:506 +#: tutorial/classes.rst:502 msgid "" "There is no shorthand for referencing data attributes (or other methods!) " "from within methods. I find that this actually increases the readability of " @@ -811,7 +800,7 @@ msgstr "" "çünkü bir metoda bakarken yerel değişkenleri ve örnek değişkenlerini " "karıştırma ihtimali bırakmamış oluyoruz." -#: tutorial/classes.rst:511 +#: tutorial/classes.rst:507 msgid "" "Often, the first argument of a method is called ``self``. This is nothing " "more than a convention: the name ``self`` has absolutely no special meaning " @@ -827,7 +816,7 @@ msgstr "" "okunabilir olabileceğini ve yazılabilecek potansiyel bir *sınıf tarayıcısı* " "programının bu kurala dayanıyor olabileceğini unutmayın." -#: tutorial/classes.rst:517 +#: tutorial/classes.rst:513 msgid "" "Any function object that is a class attribute defines a method for instances " "of that class. It is not necessary that the function definition is " @@ -839,7 +828,7 @@ msgstr "" "dahil olması gerekli değildir: sınıftaki yerel bir değişkene fonksiyon " "nesnesi atamak da uygundur. Mesela::" -#: tutorial/classes.rst:534 +#: tutorial/classes.rst:530 #, fuzzy msgid "" "Now ``f``, ``g`` and ``h`` are all attributes of class :class:`!C` that " @@ -853,7 +842,7 @@ msgstr "" "kullanım şeklinin genellikle yalnızca bir programı okuyan kişinin kafasını " "karıştırmaya yaradığını unutmayın." -#: tutorial/classes.rst:539 +#: tutorial/classes.rst:535 msgid "" "Methods may call other methods by using method attributes of the ``self`` " "argument::" @@ -861,7 +850,7 @@ msgstr "" "Metotlar, ``self`` bağımsız değişkeninin metot niteliklerini kullanarak " "diğer metotları çağırabilir::" -#: tutorial/classes.rst:553 +#: tutorial/classes.rst:549 msgid "" "Methods may reference global names in the same way as ordinary functions. " "The global scope associated with a method is the module containing its " @@ -883,7 +872,7 @@ msgstr "" "kendisi bu genel kapsamda tanımlanır ve sonraki bölümde bir yöntemin kendi " "sınıfına başvurmak istemesinin bazı iyi nedenlerini bulacağız." -#: tutorial/classes.rst:563 +#: tutorial/classes.rst:559 msgid "" "Each value is an object, and therefore has a *class* (also called its " "*type*). It is stored as ``object.__class__``." @@ -891,11 +880,11 @@ msgstr "" "Her değer bir nesnedir ve bu nedenle bir *sınıf* (*type* olarak da " "adlandırılır) bulundurur. ``object.__class__`` olarak depolanır." -#: tutorial/classes.rst:570 +#: tutorial/classes.rst:566 msgid "Inheritance" msgstr "Kalıtım" -#: tutorial/classes.rst:572 +#: tutorial/classes.rst:568 msgid "" "Of course, a language feature would not be worthy of the name \"class\" " "without supporting inheritance. The syntax for a derived class definition " @@ -904,7 +893,7 @@ msgstr "" "Tabii ki, bir dil özelliği kalıtımı desteklemeden \"sınıf\" adına layık " "olmaz. Türetilmiş sınıf tanımının söz dizimi şöyle görünür::" -#: tutorial/classes.rst:583 +#: tutorial/classes.rst:579 #, fuzzy msgid "" "The name :class:`!BaseClassName` must be defined in a namespace accessible " @@ -917,7 +906,7 @@ msgstr "" "verilir. Bu, örneğin, temel sınıf başka bir modülde tanımlandığında yararlı " "olabilir::" -#: tutorial/classes.rst:591 +#: tutorial/classes.rst:587 msgid "" "Execution of a derived class definition proceeds the same as for a base " "class. When the class object is constructed, the base class is remembered. " @@ -932,7 +921,7 @@ msgstr "" "arama temel sınıfa bakmaya devam eder. Temel sınıfın kendisi başka bir " "sınıftan türetilmişse, bu kural özyinelemeli olarak uygulanır." -#: tutorial/classes.rst:597 +#: tutorial/classes.rst:593 msgid "" "There's nothing special about instantiation of derived classes: " "``DerivedClassName()`` creates a new instance of the class. Method " @@ -946,7 +935,7 @@ msgstr "" "gerekirse temel sınıflar zincirinin aşağısına inilir ve bu bir fonksiyon " "nesnesi veriyorsa metot başvurusu geçerlidir." -#: tutorial/classes.rst:603 +#: tutorial/classes.rst:599 msgid "" "Derived classes may override methods of their base classes. Because methods " "have no special privileges when calling other methods of the same object, a " @@ -961,7 +950,7 @@ msgstr "" "çağırabilir. (C++ programcıları için: Python'daki tüm yöntemler etkili bir " "şekilde ``sanal``.)" -#: tutorial/classes.rst:609 +#: tutorial/classes.rst:605 msgid "" "An overriding method in a derived class may in fact want to extend rather " "than simply replace the base class method of the same name. There is a " @@ -977,11 +966,11 @@ msgstr "" "için de yararlıdır. (Bunun yalnızca temel sınıfa genel kapsamda " "``BaseClassName`` olarak erişilebiliyorsa çalıştığını unutmayın.)" -#: tutorial/classes.rst:616 +#: tutorial/classes.rst:612 msgid "Python has two built-in functions that work with inheritance:" msgstr "Python'un kalıtımla çalışan iki yerleşik fonksiyonu vardır:" -#: tutorial/classes.rst:618 +#: tutorial/classes.rst:614 msgid "" "Use :func:`isinstance` to check an instance's type: ``isinstance(obj, int)`` " "will be ``True`` only if ``obj.__class__`` is :class:`int` or some class " @@ -991,7 +980,7 @@ msgstr "" "``isinstance(obj, int)`` yalnızca ``obj.__class__`` :class:`int` veya :class:" "`int` sınıfından türetilmiş bir sınıfsa ``True`` olacaktır." -#: tutorial/classes.rst:622 +#: tutorial/classes.rst:618 msgid "" "Use :func:`issubclass` to check class inheritance: ``issubclass(bool, int)`` " "is ``True`` since :class:`bool` is a subclass of :class:`int`. However, " @@ -1003,11 +992,11 @@ msgstr "" "'in bir alt sınıfıdır. Ancak, ``issubclass(float, int)`` ``False`` " "olduğundan :class:`float`, :class:`int` alt sınıfı değildir." -#: tutorial/classes.rst:632 +#: tutorial/classes.rst:628 msgid "Multiple Inheritance" msgstr "Çoklu Kalıtım" -#: tutorial/classes.rst:634 +#: tutorial/classes.rst:630 msgid "" "Python supports a form of multiple inheritance as well. A class definition " "with multiple base classes looks like this::" @@ -1015,7 +1004,7 @@ msgstr "" "Python, çoklu kalıtım biçimini de destekler. Birden çok temel sınıf içeren " "bir sınıf tanımı şöyle görünür::" -#: tutorial/classes.rst:644 +#: tutorial/classes.rst:640 #, fuzzy msgid "" "For most purposes, in the simplest cases, you can think of the search for " @@ -1033,7 +1022,7 @@ msgstr "" "(özyinelemeli olarak) :class:`Base1` temel sınıflarında aranır ve orada " "bulunamazsa :class:`Base2` vb." -#: tutorial/classes.rst:651 +#: tutorial/classes.rst:647 msgid "" "In fact, it is slightly more complex than that; the method resolution order " "changes dynamically to support cooperative calls to :func:`super`. This " @@ -1047,7 +1036,7 @@ msgstr "" "olarak bilinir ve tekli kalıtım dillerinde bulunan süper çağrıdan daha " "güçlüdür." -#: tutorial/classes.rst:657 +#: tutorial/classes.rst:653 #, fuzzy msgid "" "Dynamic ordering is necessary because all cases of multiple inheritance " @@ -1076,11 +1065,11 @@ msgstr "" "ile güvenilir ve genişletilebilir sınıflar tasarlamayı mümkün kılar. Daha " "fazla ayrıntı için bkz. https://www.python.org/download/releases/2.3/mro/." -#: tutorial/classes.rst:674 +#: tutorial/classes.rst:670 msgid "Private Variables" msgstr "Özel Değişkenler" -#: tutorial/classes.rst:676 +#: tutorial/classes.rst:672 msgid "" "\"Private\" instance variables that cannot be accessed except from inside an " "object don't exist in Python. However, there is a convention that is " @@ -1096,7 +1085,7 @@ msgstr "" "veya veri üyesi olsun). Bir uygulama detayıdır ve önceden haber " "verilmeksizin değiştirilebilir." -#: tutorial/classes.rst:686 +#: tutorial/classes.rst:682 msgid "" "Since there is a valid use-case for class-private members (namely to avoid " "name clashes of names with names defined by subclasses), there is limited " @@ -1115,7 +1104,13 @@ msgstr "" "değiştirilir; Bu mangling, bir sınıfın tanımı içinde gerçekleştiği sürece " "tanımlayıcının söz dizimsel konumuna bakılmaksızın yapılır." -#: tutorial/classes.rst:695 +#: tutorial/classes.rst:693 +msgid "" +"The :ref:`private name mangling specifications ` for " +"details and special cases." +msgstr "" + +#: tutorial/classes.rst:696 msgid "" "Name mangling is helpful for letting subclasses override methods without " "breaking intraclass method calls. For example::" @@ -1123,7 +1118,7 @@ msgstr "" "Ad mangling, alt sınıfların sınıf içi metot çağrılarını kesmeden metotları " "geçersiz kılmasına izin vermek için yararlıdır. Mesela::" -#: tutorial/classes.rst:717 +#: tutorial/classes.rst:718 msgid "" "The above example would work even if ``MappingSubclass`` were to introduce a " "``__update`` identifier since it is replaced with ``_Mapping__update`` in " @@ -1135,7 +1130,7 @@ msgstr "" "``_MappingSubclass__update`` ile değiştirildiği için ``__update`` " "tanımlayıcısı tanıtsa bile çalışır." -#: tutorial/classes.rst:722 +#: tutorial/classes.rst:723 msgid "" "Note that the mangling rules are designed mostly to avoid accidents; it " "still is possible to access or modify a variable that is considered " @@ -1147,7 +1142,7 @@ msgstr "" "hala mümkündür. Bu, hata ayıklayıcı gibi özel durumlarda bile yararlı " "olabilir." -#: tutorial/classes.rst:726 +#: tutorial/classes.rst:727 msgid "" "Notice that code passed to ``exec()`` or ``eval()`` does not consider the " "classname of the invoking class to be the current class; this is similar to " @@ -1162,11 +1157,11 @@ msgstr "" "benzer. Aynı kısıtlama ``getattr()``, ``setattr()`` ve ``delattr()`` ve " "doğrudan ``__dict__`` atıfta bulunurken de geçerlidir." -#: tutorial/classes.rst:737 +#: tutorial/classes.rst:738 msgid "Odds and Ends" msgstr "Oranlar ve Bitişler" -#: tutorial/classes.rst:739 +#: tutorial/classes.rst:740 msgid "" "Sometimes it is useful to have a data type similar to the Pascal \"record\" " "or C \"struct\", bundling together a few named data items. The idiomatic " @@ -1176,7 +1171,7 @@ msgstr "" "'u veya C *struct* 'ına benzer bir veri türüne sahip olmak yararlıdır. " "Deyimsel yaklaşım, bu amaç için :mod:`dataclasses` kullanmaktır::" -#: tutorial/classes.rst:759 +#: tutorial/classes.rst:760 #, fuzzy msgid "" "A piece of Python code that expects a particular abstract data type can " @@ -1193,7 +1188,7 @@ msgstr "" "değişken olarak geçiren :meth:`read` ve :meth:`!readline` yöntemlerine sahip " "bir sınıf tanımlayabilirsiniz." -#: tutorial/classes.rst:771 +#: tutorial/classes.rst:772 #, fuzzy msgid "" ":ref:`Instance method objects ` have attributes, too: :" @@ -1205,11 +1200,11 @@ msgstr "" "örnek nesnedir :meth:`m`, ve ``m.__func__`` yönteme karşılık gelen fonksiyon " "nesnesidir." -#: tutorial/classes.rst:781 +#: tutorial/classes.rst:782 msgid "Iterators" msgstr "Yineleyiciler" -#: tutorial/classes.rst:783 +#: tutorial/classes.rst:784 msgid "" "By now you have probably noticed that most container objects can be looped " "over using a :keyword:`for` statement::" @@ -1217,7 +1212,7 @@ msgstr "" "Şimdiye kadar büyük olasılıkla çoğu kapsayıcı nesnenin bir :keyword:`for` " "deyimi kullanılarak döngüye alınabileceğini fark etmişsinizdir::" -#: tutorial/classes.rst:797 +#: tutorial/classes.rst:798 msgid "" "This style of access is clear, concise, and convenient. The use of " "iterators pervades and unifies Python. Behind the scenes, the :keyword:" @@ -1239,7 +1234,7 @@ msgstr "" "fonksiyonunu kullanarak :meth:`~iterator.__next__` yöntemini " "çağırabilirsiniz; Bu örnek, her şeyin nasıl çalıştığını gösterir::" -#: tutorial/classes.rst:822 +#: tutorial/classes.rst:823 #, fuzzy msgid "" "Having seen the mechanics behind the iterator protocol, it is easy to add " @@ -1253,11 +1248,11 @@ msgstr "" "bir nesne döndüren :meth:`__iter__` metodunu tanımlayın. Sınıf :meth:" "`__next__` tanımlarsa, :meth:`__iter__` sadece ``self`` döndürebilir::" -#: tutorial/classes.rst:859 +#: tutorial/classes.rst:860 msgid "Generators" msgstr "Üreteçler" -#: tutorial/classes.rst:861 +#: tutorial/classes.rst:862 msgid "" ":term:`Generators ` are a simple and powerful tool for creating " "iterators. They are written like regular functions but use the :keyword:" @@ -1273,7 +1268,7 @@ msgstr "" "değerlerini ve hangi deyimin en son yürütüldüğını hatırlar). Bu örnek, " "üreteçlerin oluşturulmasının ne kadar da kolay olabileceğini gösterir::" -#: tutorial/classes.rst:882 +#: tutorial/classes.rst:883 #, fuzzy msgid "" "Anything that can be done with generators can also be done with class-based " @@ -1286,7 +1281,7 @@ msgstr "" "şey: :meth:`__iter__` ve :meth:`~generator.__next__` yöntemlerinin otomatik " "olarak oluşturulmasıdır." -#: tutorial/classes.rst:887 +#: tutorial/classes.rst:888 msgid "" "Another key feature is that the local variables and execution state are " "automatically saved between calls. This made the function easier to write " @@ -1298,7 +1293,7 @@ msgstr "" "kolaylaştırdı ve ``self.index`` ve ``self.data`` gibi değişkenleri " "kullanmaya kıyasla çok daha net hale getirdi." -#: tutorial/classes.rst:892 +#: tutorial/classes.rst:893 msgid "" "In addition to automatic method creation and saving program state, when " "generators terminate, they automatically raise :exc:`StopIteration`. In " @@ -1310,11 +1305,11 @@ msgstr "" "Birlikte, bu özellikler normal bir işlev yazmaktan daha fazla çaba " "harcamadan yinelemeler oluşturmayı kolaylaştırır." -#: tutorial/classes.rst:901 +#: tutorial/classes.rst:902 msgid "Generator Expressions" msgstr "Üreteç İfadeleri" -#: tutorial/classes.rst:903 +#: tutorial/classes.rst:904 msgid "" "Some simple generators can be coded succinctly as expressions using a syntax " "similar to list comprehensions but with parentheses instead of square " @@ -1330,15 +1325,15 @@ msgstr "" "ancak daha az çok yönlüdür ve aynı özellikle liste anlamalarından daha " "bellek dostu olma eğilimindedir." -#: tutorial/classes.rst:910 +#: tutorial/classes.rst:911 msgid "Examples::" msgstr "Örnekler::" -#: tutorial/classes.rst:931 +#: tutorial/classes.rst:932 msgid "Footnotes" msgstr "Dipnotlar" -#: tutorial/classes.rst:932 +#: tutorial/classes.rst:933 msgid "" "Except for one thing. Module objects have a secret read-only attribute " "called :attr:`~object.__dict__` which returns the dictionary used to " @@ -1354,19 +1349,36 @@ msgstr "" "özelliklerine aykırı, dolayısıyla sadece programın durması sonrası çalışan " "hata ayıklayıcılar gibilerinin kullanımına kısıtlanmalı." -#: tutorial/classes.rst:347 +#: tutorial/classes.rst:343 #, fuzzy msgid "object" msgstr "Metot Nesneleri" -#: tutorial/classes.rst:347 +#: tutorial/classes.rst:343 msgid "method" msgstr "" -#: tutorial/classes.rst:683 +#: tutorial/classes.rst:679 msgid "name" msgstr "" -#: tutorial/classes.rst:683 +#: tutorial/classes.rst:679 msgid "mangling" msgstr "" + +#~ msgid "" +#~ "The other kind of instance attribute reference is a *method*. A method is " +#~ "a function that \"belongs to\" an object. (In Python, the term method is " +#~ "not unique to class instances: other object types can have methods as " +#~ "well. For example, list objects have methods called append, insert, " +#~ "remove, sort, and so on. However, in the following discussion, we'll use " +#~ "the term method exclusively to mean methods of class instance objects, " +#~ "unless explicitly stated otherwise.)" +#~ msgstr "" +#~ "Diğer örnek nitelik başvurusu türü bir *metot*. Metot, bir nesneye " +#~ "\"ait\" olan bir fonksiyondur. (Python'da, terim metodu sınıf " +#~ "örneklerine özgü değildir: diğer nesne türlerinin de metotları olabilir. " +#~ "Örneğin, liste nesnelerini genişletme, ekleme, kaldırma, sıralama vb. " +#~ "Ancak, aşağıdaki tartışmada, aksi açıkça belirtilmedikçe, yalnızca sınıf " +#~ "örneği nesnelerinin metotlarını ifade etmek için terim metodunu " +#~ "kullanacağız.)" diff --git a/tutorial/floatingpoint.po b/tutorial/floatingpoint.po index 73e419275..cb017816a 100644 --- a/tutorial/floatingpoint.po +++ b/tutorial/floatingpoint.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2022-12-28 22:25+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -18,7 +18,8 @@ msgstr "" "X-Generator: Poedit 3.2.2\n" #: tutorial/floatingpoint.rst:10 -msgid "Floating Point Arithmetic: Issues and Limitations" +#, fuzzy +msgid "Floating-Point Arithmetic: Issues and Limitations" msgstr "Kayan Nokta Aritmetiği: Sorunlar ve Sınırlamalar" #: tutorial/floatingpoint.rst:16 @@ -162,8 +163,9 @@ msgstr "" "ve basitçe ``0.1`` 'i görüntüleyebilmektedir." #: tutorial/floatingpoint.rst:91 +#, fuzzy msgid "" -"Note that this is in the very nature of binary floating-point: this is not a " +"Note that this is in the very nature of binary floating point: this is not a " "bug in Python, and it is not a bug in your code either. You'll see the same " "kind of thing in all languages that support your hardware's floating-point " "arithmetic (although some languages may not *display* the difference by " @@ -234,7 +236,7 @@ msgid "" "problem with \"0.1\" is explained in precise detail below, in the " "\"Representation Error\" section. See `Examples of Floating Point Problems " "`_ for " -"a pleasant summary of how binary floating-point works and the kinds of " +"a pleasant summary of how binary floating point works and the kinds of " "problems commonly encountered in practice. Also see `The Perils of Floating " "Point `_ for a more complete " "account of other common surprises." @@ -246,9 +248,10 @@ msgstr "" "bakınız." #: tutorial/floatingpoint.rst:156 +#, fuzzy msgid "" "As that says near the end, \"there are no easy answers.\" Still, don't be " -"unduly wary of floating-point! The errors in Python float operations are " +"unduly wary of floating point! The errors in Python float operations are " "inherited from the floating-point hardware, and on most machines are on the " "order of no more than 1 part in 2\\*\\*53 per operation. That's more than " "adequate for most tasks, but you do need to keep in mind that it's not " diff --git a/tutorial/inputoutput.po b/tutorial/inputoutput.po index 06b6d74ee..d34b06e5f 100644 --- a/tutorial/inputoutput.po +++ b/tutorial/inputoutput.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2022-12-28 22:43+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -346,28 +346,30 @@ msgid "Old string formatting" msgstr "Eski dize biçimlendirmesi" #: tutorial/inputoutput.rst:282 +#, fuzzy msgid "" "The % operator (modulo) can also be used for string formatting. Given " -"``'string' % values``, instances of ``%`` in ``string`` are replaced with " -"zero or more elements of ``values``. This operation is commonly known as " -"string interpolation. For example::" +"``format % values`` (where *format* is a string), ``%`` conversion " +"specifications in *format* are replaced with zero or more elements of " +"*values*. This operation is commonly known as string interpolation. For " +"example::" msgstr "" "% operatör (modulo) dize biçimlendirmesi için de kullanılabilir. ``'string' " "% values`` göz önüne alındığında, ``string`` öğesindeki ``%`` örnekleri " "sıfır veya daha fazla ``values`` öğesiyle değiştirilir. Bu işlem genellikle " "dize enterpolasyonu olarak bilinir. Mesela::" -#: tutorial/inputoutput.rst:291 +#: tutorial/inputoutput.rst:293 msgid "" "More information can be found in the :ref:`old-string-formatting` section." msgstr "" "Daha fazla bilgiyi :ref:`old-string-formatting` bölümünde bulabilirsiniz." -#: tutorial/inputoutput.rst:297 +#: tutorial/inputoutput.rst:299 msgid "Reading and Writing Files" msgstr "Dosyaları Okuma ve Yazma" -#: tutorial/inputoutput.rst:303 +#: tutorial/inputoutput.rst:305 msgid "" ":func:`open` returns a :term:`file object`, and is most commonly used with " "two positional arguments and one keyword argument: ``open(filename, mode, " @@ -377,7 +379,7 @@ msgstr "" "argümanı ve bir anahtar sözcük argümanı ile kullanılır: ``open(filename, " "mode, encoding=None)``" -#: tutorial/inputoutput.rst:316 +#: tutorial/inputoutput.rst:318 msgid "" "The first argument is a string containing the filename. The second argument " "is another string containing a few characters describing the way in which " @@ -396,7 +398,7 @@ msgstr "" "eklenir. ``'r+'`` dosyayı hem okumak hem de yazmak için açar. *mode* " "parametresi isteğe bağlıdır; verilmezse ``'r'`` varsayılacaktır." -#: tutorial/inputoutput.rst:325 +#: tutorial/inputoutput.rst:327 msgid "" "Normally, files are opened in :dfn:`text mode`, that means, you read and " "write strings from and to the file, which are encoded in a specific " @@ -416,7 +418,7 @@ msgstr "" "class:`bytes` nesneleri olarak okunur ve yazılır. Dosyayı ikili modda " "açarken *kodlama* belirtemezsiniz." -#: tutorial/inputoutput.rst:335 +#: tutorial/inputoutput.rst:337 msgid "" "In text mode, the default when reading is to convert platform-specific line " "endings (``\\n`` on Unix, ``\\r\\n`` on Windows) to just ``\\n``. When " @@ -435,7 +437,7 @@ msgstr "" "bozacaktır. Bu tür dosyaları okurken ve yazarken ikili modu kullanmaya çok " "dikkat edin." -#: tutorial/inputoutput.rst:343 +#: tutorial/inputoutput.rst:345 msgid "" "It is good practice to use the :keyword:`with` keyword when dealing with " "file objects. The advantage is that the file is properly closed after its " @@ -449,7 +451,7 @@ msgstr "" "`!with` kullanmak da eş değer :keyword:`try` \\ -\\ :keyword:`finally` " "blokları yazmaktançok daha kısadır::" -#: tutorial/inputoutput.rst:356 +#: tutorial/inputoutput.rst:358 msgid "" "If you're not using the :keyword:`with` keyword, then you should call ``f." "close()`` to close the file and immediately free up any system resources " @@ -459,7 +461,7 @@ msgstr "" "kullandığı sistem kaynaklarını hemen boşaltmak için ``f.close()`` metodunu " "çağırmalısınız." -#: tutorial/inputoutput.rst:361 +#: tutorial/inputoutput.rst:363 msgid "" "Calling ``f.write()`` without using the :keyword:`!with` keyword or calling " "``f.close()`` **might** result in the arguments of ``f.write()`` not being " @@ -469,7 +471,7 @@ msgstr "" "``f.close()`` çağırmak, program başarıyla çıksa bile ``f.write()`` " "parametrelerinin diske tamamen yazılmamasıyla sonuçlanabilir." -#: tutorial/inputoutput.rst:369 +#: tutorial/inputoutput.rst:371 msgid "" "After a file object is closed, either by a :keyword:`with` statement or by " "calling ``f.close()``, attempts to use the file object will automatically " @@ -479,11 +481,11 @@ msgstr "" "``f.close()`` çağırarak dosya nesnesini kullanma girişimleri otomatik olarak " "başarısız olur. ::" -#: tutorial/inputoutput.rst:383 +#: tutorial/inputoutput.rst:385 msgid "Methods of File Objects" msgstr "Dosya Nesnelerinin Metotları" -#: tutorial/inputoutput.rst:385 +#: tutorial/inputoutput.rst:387 msgid "" "The rest of the examples in this section will assume that a file object " "called ``f`` has already been created." @@ -491,7 +493,7 @@ msgstr "" "Bu bölümdeki örneklerin geri kalanı, ``f`` adlı bir dosya nesnesinin zaten " "oluşturulduğunu varsayar." -#: tutorial/inputoutput.rst:388 +#: tutorial/inputoutput.rst:390 msgid "" "To read a file's contents, call ``f.read(size)``, which reads some quantity " "of data and returns it as a string (in text mode) or bytes object (in binary " @@ -511,7 +513,7 @@ msgstr "" "veya *size* bayt (ikili modda) okunur ve döndürülür. Dosyanın sonuna " "ulaşıldıysa, ``f.read()`` boş bir dize (``''``) döndürür. ::" -#: tutorial/inputoutput.rst:402 +#: tutorial/inputoutput.rst:404 msgid "" "``f.readline()`` reads a single line from the file; a newline character " "(``\\n``) is left at the end of the string, and is only omitted on the last " @@ -527,7 +529,7 @@ msgstr "" "boş bir satır ise yalnızca tek bir yeni satır içeren bir dize olan ``'\\n'`` " "ile temsil edilir. ::" -#: tutorial/inputoutput.rst:416 +#: tutorial/inputoutput.rst:418 msgid "" "For reading lines from a file, you can loop over the file object. This is " "memory efficient, fast, and leads to simple code::" @@ -536,7 +538,7 @@ msgstr "" "oluşturabilirsiniz. Bu bellek verimliliğine, hızlılığına ve basit koda yol " "açar::" -#: tutorial/inputoutput.rst:425 +#: tutorial/inputoutput.rst:427 msgid "" "If you want to read all the lines of a file in a list you can also use " "``list(f)`` or ``f.readlines()``." @@ -544,7 +546,7 @@ msgstr "" "Listedeki bir dosyanın tüm satırlarını okumak istiyorsanız, ``list(f)`` veya " "``f.readlines()`` öğelerini de kullanabilirsiniz." -#: tutorial/inputoutput.rst:428 +#: tutorial/inputoutput.rst:430 msgid "" "``f.write(string)`` writes the contents of *string* to the file, returning " "the number of characters written. ::" @@ -552,7 +554,7 @@ msgstr "" "``f.write(string)`` *string* içeriğini dosyaya yazar ve yazılan karakter " "sayısını döndürür. ::" -#: tutorial/inputoutput.rst:434 +#: tutorial/inputoutput.rst:436 msgid "" "Other types of objects need to be converted -- either to a string (in text " "mode) or a bytes object (in binary mode) -- before writing them::" @@ -560,7 +562,7 @@ msgstr "" "Diğer nesne türlerinin yazmadan önce bir dizeye (metin modunda) veya bayt " "nesnesine (ikili modda) dönüştürülmesi gerekir::" -#: tutorial/inputoutput.rst:442 +#: tutorial/inputoutput.rst:444 msgid "" "``f.tell()`` returns an integer giving the file object's current position in " "the file represented as number of bytes from the beginning of the file when " @@ -570,7 +572,7 @@ msgstr "" "dosyanın başından itibaren bayt sayısı ve metin modundayken opak bir sayı " "olarak veren bir tamsayı döndürür." -#: tutorial/inputoutput.rst:446 +#: tutorial/inputoutput.rst:448 msgid "" "To change the file object's position, use ``f.seek(offset, whence)``. The " "position is computed from adding *offset* to a reference point; the " @@ -588,7 +590,7 @@ msgstr "" "başvuru noktası için dosyanın başlangıcını kullanarak 0 olarak " "varsayılabilir. ::" -#: tutorial/inputoutput.rst:465 +#: tutorial/inputoutput.rst:467 msgid "" "In text files (those opened without a ``b`` in the mode string), only seeks " "relative to the beginning of the file are allowed (the exception being " @@ -602,7 +604,7 @@ msgstr "" "sıfırdan döndürülen değerlerdir. Başka herhangi bir *offset* değeri tanımsız " "davranış üretir." -#: tutorial/inputoutput.rst:471 +#: tutorial/inputoutput.rst:473 #, fuzzy msgid "" "File objects have some additional methods, such as :meth:`~io.IOBase.isatty` " @@ -613,11 +615,11 @@ msgstr "" "truncate` gibi bazı ek metotları vardır; dosya nesneleri için eksiksiz bir " "kılavuz için Kütüphane Referansı'na bakın." -#: tutorial/inputoutput.rst:479 +#: tutorial/inputoutput.rst:481 msgid "Saving structured data with :mod:`json`" msgstr "Yapılandırılmış verileri :mod:`json` ile kaydetme" -#: tutorial/inputoutput.rst:483 +#: tutorial/inputoutput.rst:485 #, fuzzy msgid "" "Strings can easily be written to and read from a file. Numbers take a bit " @@ -634,7 +636,7 @@ msgstr "" "listeler ve sözlükler gibi daha karmaşık veri türlerini kaydetmek " "istediğinizde, elle ayrıştırma ve seri hale getirmek karmaşık hale gelir." -#: tutorial/inputoutput.rst:490 +#: tutorial/inputoutput.rst:492 msgid "" "Rather than having users constantly writing and debugging code to save " "complicated data types to files, Python allows you to use the popular data " @@ -657,7 +659,7 @@ msgstr "" "saklanmış olabilir veya bir ağ bağlantısı üzerinden uzaktaki bir makineye " "gönderilmiş olabilir." -#: tutorial/inputoutput.rst:501 +#: tutorial/inputoutput.rst:503 msgid "" "The JSON format is commonly used by modern applications to allow for data " "exchange. Many programmers are already familiar with it, which makes it a " @@ -667,7 +669,7 @@ msgstr "" "tarafından yaygın olarak kullanılır. Birçok programcı zaten buna aşinadır, " "bu da onu birlikte çalışabilirlik için iyi bir seçim haline getirir." -#: tutorial/inputoutput.rst:505 +#: tutorial/inputoutput.rst:507 msgid "" "If you have an object ``x``, you can view its JSON string representation " "with a simple line of code::" @@ -675,7 +677,7 @@ msgstr "" "``x`` nesnesiniz varsa, JSON dize gösterimini basit bir kod satırıyla " "görüntüleyebilirsiniz::" -#: tutorial/inputoutput.rst:513 +#: tutorial/inputoutput.rst:515 msgid "" "Another variant of the :func:`~json.dumps` function, called :func:`~json." "dump`, simply serializes the object to a :term:`text file`. So if ``f`` is " @@ -686,7 +688,7 @@ msgstr "" "getirmektedir. Yani ``f`` bir :term:`text file` nesnesi yazmak için " "açılmışsa, bunu yapabiliriz::" -#: tutorial/inputoutput.rst:519 +#: tutorial/inputoutput.rst:521 msgid "" "To decode the object again, if ``f`` is a :term:`binary file` or :term:`text " "file` object which has been opened for reading::" @@ -694,7 +696,7 @@ msgstr "" "Nesnenin kodunu tekrar çözmek için, ``f`` okuma için açılmış bir :term:" "`binary file` veya :term:`text file` nesnesiyse::" -#: tutorial/inputoutput.rst:525 +#: tutorial/inputoutput.rst:527 msgid "" "JSON files must be encoded in UTF-8. Use ``encoding=\"utf-8\"`` when opening " "JSON file as a :term:`text file` for both of reading and writing." @@ -702,7 +704,7 @@ msgstr "" "JSON dosyaları UTF-8'de kodlanmalıdır. Hem okuma hem de yazma için JSON " "dosyasını :term:`text file` olarak açarken ``encoding=\"utf-8\"`` kullanın." -#: tutorial/inputoutput.rst:528 +#: tutorial/inputoutput.rst:530 msgid "" "This simple serialization technique can handle lists and dictionaries, but " "serializing arbitrary class instances in JSON requires a bit of extra " @@ -714,11 +716,11 @@ msgstr "" "çaba gerektirir. :mod:`json` modülü için olan örnek bunun bir açıklamasını " "içerir." -#: tutorial/inputoutput.rst:534 +#: tutorial/inputoutput.rst:536 msgid ":mod:`pickle` - the pickle module" msgstr ":mod:`pickle` - pickle modülü" -#: tutorial/inputoutput.rst:536 +#: tutorial/inputoutput.rst:538 msgid "" "Contrary to :ref:`JSON `, *pickle* is a protocol which allows the " "serialization of arbitrarily complex Python objects. As such, it is " @@ -735,26 +737,26 @@ msgstr "" "seri halden çıkarılması, veriler yetenekli bir saldırgan tarafından " "hazırlanmışsa rasgele kod yürütebilir." -#: tutorial/inputoutput.rst:299 +#: tutorial/inputoutput.rst:301 msgid "built-in function" msgstr "" -#: tutorial/inputoutput.rst:299 +#: tutorial/inputoutput.rst:301 msgid "open" msgstr "" -#: tutorial/inputoutput.rst:299 +#: tutorial/inputoutput.rst:301 msgid "object" msgstr "" -#: tutorial/inputoutput.rst:299 +#: tutorial/inputoutput.rst:301 msgid "file" msgstr "" -#: tutorial/inputoutput.rst:481 +#: tutorial/inputoutput.rst:483 msgid "module" msgstr "" -#: tutorial/inputoutput.rst:481 +#: tutorial/inputoutput.rst:483 msgid "json" msgstr "" diff --git a/tutorial/introduction.po b/tutorial/introduction.po index 2c8edcfe9..8a1fd3632 100644 --- a/tutorial/introduction.po +++ b/tutorial/introduction.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2024-02-27 22:42+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -618,11 +618,12 @@ msgstr "" "olması gerektiğini unutmayın." #: tutorial/introduction.rst:544 +#, fuzzy msgid "" "The :func:`print` function writes the value of the argument(s) it is given. " "It differs from just writing the expression you want to write (as we did " "earlier in the calculator examples) in the way it handles multiple " -"arguments, floating point quantities, and strings. Strings are printed " +"arguments, floating-point quantities, and strings. Strings are printed " "without quotes, and a space is inserted between items, so you can format " "things nicely, like this::" msgstr "" diff --git a/tutorial/stdlib.po b/tutorial/stdlib.po index 8f0e0319f..5101fc80d 100644 --- a/tutorial/stdlib.po +++ b/tutorial/stdlib.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2022-12-28 22:49+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -162,9 +162,10 @@ msgid "Mathematics" msgstr "Matematik" #: tutorial/stdlib.rst:140 +#, fuzzy msgid "" "The :mod:`math` module gives access to the underlying C library functions " -"for floating point math::" +"for floating-point math::" msgstr "" ":mod:`math` modülünün içindeki C kütüphanesi ondalıklı matematik " "fonksiyonlarına erişim sağlar::" diff --git a/tutorial/stdlib2.po b/tutorial/stdlib2.po index 301231d40..490fe0f58 100644 --- a/tutorial/stdlib2.po +++ b/tutorial/stdlib2.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-12-17 01:28+0300\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2022-01-02 22:55+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -315,8 +315,9 @@ msgstr "" "duyulmaktadır." #: tutorial/stdlib2.rst:296 +#, fuzzy msgid "" -"The :mod:`array` module provides an :class:`~array.array()` object that is " +"The :mod:`array` module provides an :class:`~array.array` object that is " "like a list that stores only homogeneous data and stores it more compactly. " "The following example shows an array of numbers stored as two byte unsigned " "binary numbers (typecode ``\"H\"``) rather than the usual 16 bytes per entry " @@ -329,11 +330,12 @@ msgstr "" "``\"H\"``) olarak saklanan bir sayı dizisini gösterir:" #: tutorial/stdlib2.rst:309 +#, fuzzy msgid "" -"The :mod:`collections` module provides a :class:`~collections.deque()` " -"object that is like a list with faster appends and pops from the left side " -"but slower lookups in the middle. These objects are well suited for " -"implementing queues and breadth first tree searches::" +"The :mod:`collections` module provides a :class:`~collections.deque` object " +"that is like a list with faster appends and pops from the left side but " +"slower lookups in the middle. These objects are well suited for implementing " +"queues and breadth first tree searches::" msgstr "" ":mod:`collections` modülü, eklemelerin daha hızlı olduğu ve sol taraftan " "açılan ancak ortada daha yavaş aramaların olduğu bir liste gibi bir :class:" @@ -363,13 +365,15 @@ msgstr "" "çalıştırmak istemeyen uygulamalar için kullanışlıdır::" #: tutorial/stdlib2.rst:356 -msgid "Decimal Floating Point Arithmetic" +#, fuzzy +msgid "Decimal Floating-Point Arithmetic" msgstr "Ondalık Kayan Nokta Aritmetiği" #: tutorial/stdlib2.rst:358 +#, fuzzy msgid "" "The :mod:`decimal` module offers a :class:`~decimal.Decimal` datatype for " -"decimal floating point arithmetic. Compared to the built-in :class:`float` " +"decimal floating-point arithmetic. Compared to the built-in :class:`float` " "implementation of binary floating point, the class is especially helpful for" msgstr "" ":mod:`decimal` modülü, ondalık kayan nokta aritmetiği için bir :class:" diff --git a/using/cmdline.po b/using/cmdline.po index 0f59a1d53..c892f08bd 100644 --- a/using/cmdline.po +++ b/using/cmdline.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -117,9 +117,7 @@ msgid "" msgstr "" #: using/cmdline.rst:73 -msgid "" -"Raises an :ref:`auditing event ` ``cpython.run_command`` with " -"argument ``command``." +msgid "Raises an auditing event cpython.run_command with argument command." msgstr "" #: using/cmdline.rst:77 @@ -175,9 +173,7 @@ msgid "" msgstr "" #: using/cmdline.rst:115 -msgid "" -"Raises an :ref:`auditing event ` ``cpython.run_module`` with " -"argument ``module-name``." +msgid "Raises an auditing event cpython.run_module with argument module-name." msgstr "" #: using/cmdline.rst:118 @@ -213,10 +209,8 @@ msgid "" "path`." msgstr "" -#: using/cmdline.rst:140 -msgid "" -"Raises an :ref:`auditing event ` ``cpython.run_stdin`` with no " -"arguments." +#: using/cmdline.rst:723 +msgid "Raises an auditing event cpython.run_stdin with no arguments." msgstr "" #: using/cmdline.rst:146 @@ -255,9 +249,7 @@ msgid "" msgstr "" #: using/cmdline.rst:167 -msgid "" -"Raises an :ref:`auditing event ` ``cpython.run_file`` with " -"argument ``filename``." +msgid "Raises an auditing event cpython.run_file with argument filename." msgstr "" #: using/cmdline.rst:170 @@ -502,7 +494,7 @@ msgstr "" msgid "See also :envvar:`PYTHONNOUSERSITE`." msgstr "" -#: using/cmdline.rst:810 using/cmdline.rst:822 +#: using/cmdline.rst:816 using/cmdline.rst:828 msgid ":pep:`370` -- Per user site-packages directory" msgstr "" @@ -552,44 +544,44 @@ msgid "" "messages to :data:`sys.stderr`." msgstr "" -#: using/cmdline.rst:838 +#: using/cmdline.rst:844 msgid "" "The simplest settings apply a particular action unconditionally to all " "warnings emitted by a process (even those that are otherwise ignored by " "default)::" msgstr "" -#: using/cmdline.rst:447 +#: using/cmdline.rst:448 msgid "" "The action names can be abbreviated as desired and the interpreter will " "resolve them to the appropriate action name. For example, ``-Wi`` is the " "same as ``-Wignore``." msgstr "" -#: using/cmdline.rst:451 +#: using/cmdline.rst:452 msgid "The full form of argument is::" msgstr "" -#: using/cmdline.rst:455 +#: using/cmdline.rst:456 msgid "" "Empty fields match all values; trailing empty fields may be omitted. For " "example ``-W ignore::DeprecationWarning`` ignores all DeprecationWarning " "warnings." msgstr "" -#: using/cmdline.rst:459 +#: using/cmdline.rst:460 msgid "" "The *action* field is as explained above but only applies to warnings that " "match the remaining fields." msgstr "" -#: using/cmdline.rst:462 +#: using/cmdline.rst:463 msgid "" "The *message* field must match the whole warning message; this match is case-" "insensitive." msgstr "" -#: using/cmdline.rst:465 +#: using/cmdline.rst:466 msgid "" "The *category* field matches the warning category (ex: " "``DeprecationWarning``). This must be a class name; the match test whether " @@ -597,19 +589,19 @@ msgid "" "warning category." msgstr "" -#: using/cmdline.rst:470 +#: using/cmdline.rst:471 msgid "" "The *module* field matches the (fully qualified) module name; this match is " "case-sensitive." msgstr "" -#: using/cmdline.rst:473 +#: using/cmdline.rst:474 msgid "" "The *lineno* field matches the line number, where zero matches all line " "numbers and is thus equivalent to an omitted line number." msgstr "" -#: using/cmdline.rst:476 +#: using/cmdline.rst:477 msgid "" "Multiple :option:`-W` options can be given; when a warning matches more than " "one option, the action for the last matching option is performed. Invalid :" @@ -617,7 +609,7 @@ msgid "" "invalid options when the first warning is issued)." msgstr "" -#: using/cmdline.rst:481 +#: using/cmdline.rst:482 msgid "" "Warnings can also be controlled using the :envvar:`PYTHONWARNINGS` " "environment variable and from within a Python program using the :mod:" @@ -625,31 +617,31 @@ msgid "" "can be used to use a regular expression on the warning message." msgstr "" -#: using/cmdline.rst:849 +#: using/cmdline.rst:856 msgid "" "See :ref:`warning-filter` and :ref:`describing-warning-filters` for more " "details." msgstr "" -#: using/cmdline.rst:492 +#: using/cmdline.rst:493 msgid "" "Skip the first line of the source, allowing use of non-Unix forms of ``#!" "cmd``. This is intended for a DOS specific hack only." msgstr "" -#: using/cmdline.rst:498 +#: using/cmdline.rst:499 msgid "" "Reserved for various implementation-specific options. CPython currently " "defines the following possible values:" msgstr "" -#: using/cmdline.rst:501 +#: using/cmdline.rst:502 msgid "" "``-X faulthandler`` to enable :mod:`faulthandler`. See also :envvar:" "`PYTHONFAULTHANDLER`." msgstr "" -#: using/cmdline.rst:506 +#: using/cmdline.rst:507 msgid "" "``-X showrefcount`` to output the total reference count and number of used " "memory blocks when the program finishes or after each statement in the " @@ -657,7 +649,7 @@ msgid "" "build>`." msgstr "" -#: using/cmdline.rst:513 +#: using/cmdline.rst:514 msgid "" "``-X tracemalloc`` to start tracing Python memory allocations using the :mod:" "`tracemalloc` module. By default, only the most recent frame is stored in a " @@ -666,14 +658,14 @@ msgid "" "envvar:`PYTHONTRACEMALLOC` for more information." msgstr "" -#: using/cmdline.rst:522 +#: using/cmdline.rst:523 msgid "" "``-X int_max_str_digits`` configures the :ref:`integer string conversion " "length limitation `. See also :envvar:" "`PYTHONINTMAXSTRDIGITS`." msgstr "" -#: using/cmdline.rst:528 +#: using/cmdline.rst:529 msgid "" "``-X importtime`` to show how long each import takes. It shows module name, " "cumulative time (including nested imports) and self time (excluding nested " @@ -682,35 +674,35 @@ msgid "" "asyncio'``. See also :envvar:`PYTHONPROFILEIMPORTTIME`." msgstr "" -#: using/cmdline.rst:536 +#: using/cmdline.rst:537 msgid "" "``-X dev``: enable :ref:`Python Development Mode `, introducing " "additional runtime checks that are too expensive to be enabled by default. " "See also :envvar:`PYTHONDEVMODE`." msgstr "" -#: using/cmdline.rst:542 +#: using/cmdline.rst:543 msgid "" "``-X utf8`` enables the :ref:`Python UTF-8 Mode `. ``-X utf8=0`` " "explicitly disables :ref:`Python UTF-8 Mode ` (even when it would " "otherwise activate automatically). See also :envvar:`PYTHONUTF8`." msgstr "" -#: using/cmdline.rst:549 +#: using/cmdline.rst:550 msgid "" "``-X pycache_prefix=PATH`` enables writing ``.pyc`` files to a parallel tree " "rooted at the given directory instead of to the code tree. See also :envvar:" "`PYTHONPYCACHEPREFIX`." msgstr "" -#: using/cmdline.rst:555 +#: using/cmdline.rst:556 msgid "" "``-X warn_default_encoding`` issues a :class:`EncodingWarning` when the " "locale-specific default encoding is used for opening files. See also :envvar:" "`PYTHONWARNDEFAULTENCODING`." msgstr "" -#: using/cmdline.rst:561 +#: using/cmdline.rst:562 msgid "" "``-X no_debug_ranges`` disables the inclusion of the tables mapping extra " "location information (end line, start column offset and end column offset) " @@ -720,7 +712,7 @@ msgid "" "envvar:`PYTHONNODEBUGRANGES`." msgstr "" -#: using/cmdline.rst:570 +#: using/cmdline.rst:571 msgid "" "``-X frozen_modules`` determines whether or not frozen modules are ignored " "by the import machinery. A value of \"on\" means they get imported and " @@ -731,7 +723,7 @@ msgid "" "are always used, even if this flag is set to \"off\"." msgstr "" -#: using/cmdline.rst:580 +#: using/cmdline.rst:581 msgid "" "``-X perf`` enables support for the Linux ``perf`` profiler. When this " "option is provided, the ``perf`` profiler will be able to report Python " @@ -740,33 +732,33 @@ msgid "" "also :envvar:`PYTHONPERFSUPPORT` and :ref:`perf_profiling`." msgstr "" -#: using/cmdline.rst:588 +#: using/cmdline.rst:589 msgid "" "It also allows passing arbitrary values and retrieving them through the :" "data:`sys._xoptions` dictionary." msgstr "" -#: using/cmdline.rst:593 +#: using/cmdline.rst:594 msgid "Removed the ``-X showalloccount`` option." msgstr "" -#: using/cmdline.rst:596 +#: using/cmdline.rst:597 msgid "Removed the ``-X oldparser`` option." msgstr "" -#: using/cmdline.rst:601 +#: using/cmdline.rst:602 msgid "Options you shouldn't use" msgstr "" -#: using/cmdline.rst:605 +#: using/cmdline.rst:606 msgid "Reserved for use by Jython_." msgstr "" -#: using/cmdline.rst:613 +#: using/cmdline.rst:614 msgid "Environment variables" msgstr "" -#: using/cmdline.rst:615 +#: using/cmdline.rst:616 msgid "" "These environment variables influence Python's behavior, they are processed " "before the command-line switches other than -E or -I. It is customary that " @@ -774,7 +766,7 @@ msgid "" "conflict." msgstr "" -#: using/cmdline.rst:622 +#: using/cmdline.rst:623 msgid "" "Change the location of the standard Python libraries. By default, the " "libraries are searched in :file:`{prefix}/lib/python{version}` and :file:" @@ -783,14 +775,14 @@ msgid "" "file:`/usr/local`." msgstr "" -#: using/cmdline.rst:628 +#: using/cmdline.rst:629 msgid "" "When :envvar:`PYTHONHOME` is set to a single directory, its value replaces " "both :file:`{prefix}` and :file:`{exec_prefix}`. To specify different " "values for these, set :envvar:`PYTHONHOME` to :file:`{prefix}:{exec_prefix}`." msgstr "" -#: using/cmdline.rst:635 +#: using/cmdline.rst:636 msgid "" "Augment the default search path for module files. The format is the same as " "the shell's :envvar:`PATH`: one or more directory pathnames separated by :" @@ -798,21 +790,21 @@ msgid "" "existent directories are silently ignored." msgstr "" -#: using/cmdline.rst:640 +#: using/cmdline.rst:641 msgid "" "In addition to normal directories, individual :envvar:`PYTHONPATH` entries " "may refer to zipfiles containing pure Python modules (in either source or " "compiled form). Extension modules cannot be imported from zipfiles." msgstr "" -#: using/cmdline.rst:644 +#: using/cmdline.rst:645 msgid "" "The default search path is installation dependent, but generally begins " "with :file:`{prefix}/lib/python{version}` (see :envvar:`PYTHONHOME` above). " "It is *always* appended to :envvar:`PYTHONPATH`." msgstr "" -#: using/cmdline.rst:648 +#: using/cmdline.rst:649 msgid "" "An additional directory will be inserted in the search path in front of :" "envvar:`PYTHONPATH` as described above under :ref:`using-on-interface-" @@ -820,19 +812,19 @@ msgid "" "the variable :data:`sys.path`." msgstr "" -#: using/cmdline.rst:656 +#: using/cmdline.rst:657 msgid "" "If this is set to a non-empty string, don't prepend a potentially unsafe " "path to :data:`sys.path`: see the :option:`-P` option for details." msgstr "" -#: using/cmdline.rst:664 +#: using/cmdline.rst:665 msgid "" "If this is set to a non-empty string, it overrides the :data:`sys." "platlibdir` value." msgstr "" -#: using/cmdline.rst:672 +#: using/cmdline.rst:673 msgid "" "If this is the name of a readable file, the Python commands in that file are " "executed before the first prompt is displayed in interactive mode. The file " @@ -843,26 +835,26 @@ msgid "" "file." msgstr "" -#: using/cmdline.rst:679 +#: using/cmdline.rst:680 msgid "" -"Raises an :ref:`auditing event ` ``cpython.run_startup`` with " -"argument ``filename``." +"Raises an auditing event cpython.run_startup with the filename as the " +"argument when called on startup." msgstr "" -#: using/cmdline.rst:681 +#: using/cmdline.rst:682 msgid "" "Raises an :ref:`auditing event ` ``cpython.run_startup`` with the " "filename as the argument when called on startup." msgstr "" -#: using/cmdline.rst:687 +#: using/cmdline.rst:688 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-O` option. If set to an integer, it is equivalent to specifying :" "option:`-O` multiple times." msgstr "" -#: using/cmdline.rst:694 +#: using/cmdline.rst:695 msgid "" "If this is set, it names a callable using dotted-path notation. The module " "containing the callable will be imported and then the callable will be run " @@ -873,58 +865,62 @@ msgid "" "breakpointhook` to do nothing but return immediately." msgstr "" -#: using/cmdline.rst:706 +#: using/cmdline.rst:707 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-d` option. If set to an integer, it is equivalent to specifying :" "option:`-d` multiple times." msgstr "" -#: using/cmdline.rst:710 +#: using/cmdline.rst:711 msgid "" "This environment variable requires a :ref:`debug build of Python `, otherwise it's ignored." msgstr "" -#: using/cmdline.rst:716 +#: using/cmdline.rst:717 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-i` option." msgstr "" -#: using/cmdline.rst:719 +#: using/cmdline.rst:720 msgid "" "This variable can also be modified by Python code using :data:`os.environ` " "to force inspect mode on program termination." msgstr "" #: using/cmdline.rst:725 +msgid "(also 3.11.10, 3.10.15, 3.9.20, and 3.8.20) Emits audit events." +msgstr "" + +#: using/cmdline.rst:731 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-u` option." msgstr "" -#: using/cmdline.rst:731 +#: using/cmdline.rst:737 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-v` option. If set to an integer, it is equivalent to specifying :" "option:`-v` multiple times." msgstr "" -#: using/cmdline.rst:738 +#: using/cmdline.rst:744 msgid "" "If this is set, Python ignores case in :keyword:`import` statements. This " "only works on Windows and macOS." msgstr "" -#: using/cmdline.rst:744 +#: using/cmdline.rst:750 msgid "" "If this is set to a non-empty string, Python won't try to write ``.pyc`` " "files on the import of source modules. This is equivalent to specifying " "the :option:`-B` option." msgstr "" -#: using/cmdline.rst:751 +#: using/cmdline.rst:757 msgid "" "If this is set, Python will write ``.pyc`` files in a mirror directory tree " "at this path, instead of in ``__pycache__`` directories within the source " @@ -932,40 +928,40 @@ msgid "" "``pycache_prefix=PATH`` option." msgstr "" -#: using/cmdline.rst:761 +#: using/cmdline.rst:767 msgid "" "If this variable is not set or set to ``random``, a random value is used to " "seed the hashes of str and bytes objects." msgstr "" -#: using/cmdline.rst:764 +#: using/cmdline.rst:770 msgid "" "If :envvar:`PYTHONHASHSEED` is set to an integer value, it is used as a " "fixed seed for generating the hash() of the types covered by the hash " "randomization." msgstr "" -#: using/cmdline.rst:768 +#: using/cmdline.rst:774 msgid "" "Its purpose is to allow repeatable hashing, such as for selftests for the " "interpreter itself, or to allow a cluster of python processes to share hash " "values." msgstr "" -#: using/cmdline.rst:772 +#: using/cmdline.rst:778 msgid "" "The integer must be a decimal number in the range [0,4294967295]. " "Specifying the value 0 will disable hash randomization." msgstr "" -#: using/cmdline.rst:779 +#: using/cmdline.rst:785 msgid "" "If this variable is set to an integer, it is used to configure the " "interpreter's global :ref:`integer string conversion length limitation " "`." msgstr "" -#: using/cmdline.rst:787 +#: using/cmdline.rst:793 msgid "" "If this is set before running the interpreter, it overrides the encoding " "used for stdin/stdout/stderr, in the syntax ``encodingname:errorhandler``. " @@ -973,17 +969,17 @@ msgid "" "have the same meaning as in :func:`str.encode`." msgstr "" -#: using/cmdline.rst:792 +#: using/cmdline.rst:798 msgid "" "For stderr, the ``:errorhandler`` part is ignored; the handler will always " "be ``'backslashreplace'``." msgstr "" -#: using/cmdline.rst:795 +#: using/cmdline.rst:801 msgid "The ``encodingname`` part is now optional." msgstr "" -#: using/cmdline.rst:798 +#: using/cmdline.rst:804 msgid "" "On Windows, the encoding specified by this variable is ignored for " "interactive console buffers unless :envvar:`PYTHONLEGACYWINDOWSSTDIO` is " @@ -991,13 +987,13 @@ msgid "" "not affected." msgstr "" -#: using/cmdline.rst:805 +#: using/cmdline.rst:811 msgid "" "If this is set, Python won't add the :data:`user site-packages directory " "` to :data:`sys.path`." msgstr "" -#: using/cmdline.rst:815 +#: using/cmdline.rst:821 msgid "" "Defines the :data:`user base directory `, which is used to " "compute the path of the :data:`user site-packages directory ` of the :mod:`asyncio` module." msgstr "" -#: using/cmdline.rst:897 +#: using/cmdline.rst:904 msgid "Set the Python memory allocators and/or install debug hooks." msgstr "" -#: using/cmdline.rst:899 +#: using/cmdline.rst:906 msgid "Set the family of memory allocators used by Python:" msgstr "" -#: using/cmdline.rst:901 +#: using/cmdline.rst:908 msgid "" "``default``: use the :ref:`default memory allocators `." msgstr "" -#: using/cmdline.rst:903 +#: using/cmdline.rst:910 msgid "" "``malloc``: use the :c:func:`malloc` function of the C library for all " "domains (:c:macro:`PYMEM_DOMAIN_RAW`, :c:macro:`PYMEM_DOMAIN_MEM`, :c:macro:" "`PYMEM_DOMAIN_OBJ`)." msgstr "" -#: using/cmdline.rst:906 +#: using/cmdline.rst:913 msgid "" "``pymalloc``: use the :ref:`pymalloc allocator ` for :c:macro:" "`PYMEM_DOMAIN_MEM` and :c:macro:`PYMEM_DOMAIN_OBJ` domains and use the :c:" "func:`malloc` function for the :c:macro:`PYMEM_DOMAIN_RAW` domain." msgstr "" -#: using/cmdline.rst:910 +#: using/cmdline.rst:917 msgid "Install :ref:`debug hooks `:" msgstr "" -#: using/cmdline.rst:912 +#: using/cmdline.rst:919 msgid "" "``debug``: install debug hooks on top of the :ref:`default memory allocators " "`." msgstr "" -#: using/cmdline.rst:914 +#: using/cmdline.rst:921 msgid "``malloc_debug``: same as ``malloc`` but also install debug hooks." msgstr "" -#: using/cmdline.rst:915 +#: using/cmdline.rst:922 msgid "``pymalloc_debug``: same as ``pymalloc`` but also install debug hooks." msgstr "" -#: using/cmdline.rst:919 +#: using/cmdline.rst:926 msgid "Added the ``\"default\"`` allocator." msgstr "" -#: using/cmdline.rst:925 +#: using/cmdline.rst:932 msgid "" "If set to a non-empty string, Python will print statistics of the :ref:" "`pymalloc memory allocator ` every time a new pymalloc object " "arena is created, and on shutdown." msgstr "" -#: using/cmdline.rst:929 +#: using/cmdline.rst:936 msgid "" "This variable is ignored if the :envvar:`PYTHONMALLOC` environment variable " "is used to force the :c:func:`malloc` allocator of the C library, or if " "Python is configured without ``pymalloc`` support." msgstr "" -#: using/cmdline.rst:933 +#: using/cmdline.rst:940 msgid "" "This variable can now also be used on Python compiled in release mode. It " "now has no effect if set to an empty string." msgstr "" -#: using/cmdline.rst:940 +#: using/cmdline.rst:947 msgid "" "If set to a non-empty string, the default :term:`filesystem encoding and " "error handler` mode will revert to their pre-3.6 values of 'mbcs' and " @@ -1128,41 +1124,41 @@ msgid "" "'surrogatepass' are used." msgstr "" -#: using/cmdline.rst:945 +#: using/cmdline.rst:952 msgid "" "This may also be enabled at runtime with :func:`sys." "_enablelegacywindowsfsencoding()`." msgstr "" -#: using/cmdline.rst:962 +#: using/cmdline.rst:969 msgid ":ref:`Availability `: Windows." msgstr "" -#: using/cmdline.rst:950 +#: using/cmdline.rst:957 msgid "See :pep:`529` for more details." msgstr "" -#: using/cmdline.rst:955 +#: using/cmdline.rst:962 msgid "" "If set to a non-empty string, does not use the new console reader and " "writer. This means that Unicode characters will be encoded according to the " "active console code page, rather than using utf-8." msgstr "" -#: using/cmdline.rst:959 +#: using/cmdline.rst:966 msgid "" "This variable is ignored if the standard streams are redirected (to files or " "pipes) rather than referring to console buffers." msgstr "" -#: using/cmdline.rst:969 +#: using/cmdline.rst:976 msgid "" "If set to the value ``0``, causes the main Python command line application " "to skip coercing the legacy ASCII-based C and POSIX locales to a more " "capable UTF-8 based alternative." msgstr "" -#: using/cmdline.rst:973 +#: using/cmdline.rst:980 msgid "" "If this variable is *not* set (or is set to a value other than ``0``), the " "``LC_ALL`` locale override environment variable is also not set, and the " @@ -1173,19 +1169,19 @@ msgid "" "runtime:" msgstr "" -#: using/cmdline.rst:981 +#: using/cmdline.rst:988 msgid "``C.UTF-8``" msgstr "" -#: using/cmdline.rst:982 +#: using/cmdline.rst:989 msgid "``C.utf8``" msgstr "" -#: using/cmdline.rst:983 +#: using/cmdline.rst:990 msgid "``UTF-8``" msgstr "" -#: using/cmdline.rst:985 +#: using/cmdline.rst:992 msgid "" "If setting one of these locale categories succeeds, then the ``LC_CTYPE`` " "environment variable will also be set accordingly in the current process " @@ -1198,7 +1194,7 @@ msgid "" "(such as Python's own :func:`locale.getdefaultlocale`)." msgstr "" -#: using/cmdline.rst:995 +#: using/cmdline.rst:1002 msgid "" "Configuring one of these locales (either explicitly or via the above " "implicit locale coercion) automatically enables the ``surrogateescape`` :ref:" @@ -1208,7 +1204,7 @@ msgid "" "envvar:`PYTHONIOENCODING` as usual." msgstr "" -#: using/cmdline.rst:1002 +#: using/cmdline.rst:1009 msgid "" "For debugging purposes, setting ``PYTHONCOERCECLOCALE=warn`` will cause " "Python to emit warning messages on ``stderr`` if either the locale coercion " @@ -1216,7 +1212,7 @@ msgid "" "active when the Python runtime is initialized." msgstr "" -#: using/cmdline.rst:1007 +#: using/cmdline.rst:1014 msgid "" "Also note that even when locale coercion is disabled, or when it fails to " "find a suitable target locale, :envvar:`PYTHONUTF8` will still activate by " @@ -1225,15 +1221,15 @@ msgid "" "system interfaces." msgstr "" -#: using/cmdline.rst:1013 +#: using/cmdline.rst:1020 msgid ":ref:`Availability `: Unix." msgstr "" -#: using/cmdline.rst:1015 +#: using/cmdline.rst:1022 msgid "See :pep:`538` for more details." msgstr "" -#: using/cmdline.rst:1021 +#: using/cmdline.rst:1028 msgid "" "If this environment variable is set to a non-empty string, enable :ref:" "`Python Development Mode `, introducing additional runtime checks " @@ -1241,31 +1237,31 @@ msgid "" "setting the :option:`-X` ``dev`` option." msgstr "" -#: using/cmdline.rst:1030 +#: using/cmdline.rst:1037 msgid "If set to ``1``, enable the :ref:`Python UTF-8 Mode `." msgstr "" -#: using/cmdline.rst:1032 +#: using/cmdline.rst:1039 msgid "If set to ``0``, disable the :ref:`Python UTF-8 Mode `." msgstr "" -#: using/cmdline.rst:1034 +#: using/cmdline.rst:1041 msgid "" "Setting any other non-empty string causes an error during interpreter " "initialisation." msgstr "" -#: using/cmdline.rst:1041 +#: using/cmdline.rst:1048 msgid "" "If this environment variable is set to a non-empty string, issue a :class:" "`EncodingWarning` when the locale-specific default encoding is used." msgstr "" -#: using/cmdline.rst:1044 +#: using/cmdline.rst:1051 msgid "See :ref:`io-encoding-warning` for details." msgstr "" -#: using/cmdline.rst:1050 +#: using/cmdline.rst:1057 msgid "" "If this variable is set, it disables the inclusion of the tables mapping " "extra location information (end line, start column offset and end column " @@ -1274,38 +1270,38 @@ msgid "" "visual location indicators when the interpreter displays tracebacks." msgstr "" -#: using/cmdline.rst:1060 +#: using/cmdline.rst:1067 msgid "" "If this variable is set to a nonzero value, it enables support for the Linux " "``perf`` profiler so Python calls can be detected by it." msgstr "" -#: using/cmdline.rst:1063 +#: using/cmdline.rst:1070 msgid "If set to ``0``, disable Linux ``perf`` profiler support." msgstr "" -#: using/cmdline.rst:1065 +#: using/cmdline.rst:1072 msgid "" "See also the :option:`-X perf <-X>` command-line option and :ref:" "`perf_profiling`." msgstr "" -#: using/cmdline.rst:1072 +#: using/cmdline.rst:1079 msgid "Debug-mode variables" msgstr "" -#: using/cmdline.rst:1076 +#: using/cmdline.rst:1083 msgid "" "If set, Python will dump objects and reference counts still alive after " "shutting down the interpreter." msgstr "" -#: using/cmdline.rst:1086 +#: using/cmdline.rst:1093 msgid "" "Need Python configured with the :option:`--with-trace-refs` build option." msgstr "" -#: using/cmdline.rst:1083 +#: using/cmdline.rst:1090 msgid "" "If set, Python will dump objects and reference counts still alive after " "shutting down the interpreter into a file called *FILENAME*." diff --git a/using/configure.po b/using/configure.po index 5253b9bef..c591c7106 100644 --- a/using/configure.po +++ b/using/configure.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -37,8 +37,8 @@ msgstr "" #: using/configure.rst:17 msgid "" -"Support for `IEEE 754 `_ floating " -"point numbers and `floating point Not-a-Number (NaN) `_ floating-" +"point numbers and `floating-point Not-a-Number (NaN) `_." msgstr "" diff --git a/whatsnew/2.1.po b/whatsnew/2.1.po index 9f8f56b45..00c736885 100644 --- a/whatsnew/2.1.po +++ b/whatsnew/2.1.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -806,9 +806,9 @@ msgstr "" #: whatsnew/2.1.rst:646 msgid "" "Various functions in the :mod:`time` module, such as :func:`~time.asctime` " -"and :func:`~time.localtime`, require a floating point argument containing " +"and :func:`~time.localtime`, require a floating-point argument containing " "the time in seconds since the epoch. The most common use of these functions " -"is to work with the current time, so the floating point argument has been " +"is to work with the current time, so the floating-point argument has been " "made optional; when a value isn't provided, the current time will be used. " "For example, log file entries usually need a string containing the current " "time; in Python 2.1, ``time.asctime()`` can be used, instead of the " diff --git a/whatsnew/2.2.po b/whatsnew/2.2.po index f5650babc..3f243ba3e 100644 --- a/whatsnew/2.2.po +++ b/whatsnew/2.2.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1512,7 +1512,7 @@ msgstr "" msgid "" "The :func:`pow` built-in function no longer supports 3 arguments when " "floating-point numbers are supplied. ``pow(x, y, z)`` returns ``(x**y) % " -"z``, but this is never useful for floating point numbers, and the final " +"z``, but this is never useful for floating-point numbers, and the final " "result varies unpredictably depending on the platform. A call such as " "``pow(2.0, 8.0, 7.0)`` will now raise a :exc:`TypeError` exception." msgstr "" diff --git a/whatsnew/2.3.po b/whatsnew/2.3.po index a0bfb1419..0878a74b1 100644 --- a/whatsnew/2.3.po +++ b/whatsnew/2.3.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1512,7 +1512,7 @@ msgstr "" #: whatsnew/2.3.rst:1384 msgid "" "Application developers should enable this feature only if all their " -"libraries work properly when confronted with floating point time stamps, or " +"libraries work properly when confronted with floating-point time stamps, or " "if they use the tuple API. If used, the feature should be activated on an " "application level instead of trying to enable it on a per-use basis." msgstr "" diff --git a/whatsnew/2.5.po b/whatsnew/2.5.po index 85c6f1337..da2a6c4db 100644 --- a/whatsnew/2.5.po +++ b/whatsnew/2.5.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2026,15 +2026,15 @@ msgid "" ":mod:`ctypes` also provides a wrapper for Python's C API as the ``ctypes." "pythonapi`` object. This object does *not* release the global interpreter " "lock before calling a function, because the lock must be held when calling " -"into the interpreter's code. There's a :class:`py_object()` type " +"into the interpreter's code. There's a :class:`~ctypes.py_object` type " "constructor that will create a :c:expr:`PyObject *` pointer. A simple " "usage::" msgstr "" #: whatsnew/2.5.rst:1737 msgid "" -"Don't forget to use :class:`py_object()`; if it's omitted you end up with a " -"segmentation fault." +"Don't forget to use :func:`~ctypes.py_object`; if it's omitted you end up " +"with a segmentation fault." msgstr "" #: whatsnew/2.5.rst:1740 diff --git a/whatsnew/2.6.po b/whatsnew/2.6.po index 4b293fdad..34440a630 100644 --- a/whatsnew/2.6.po +++ b/whatsnew/2.6.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -3433,7 +3433,7 @@ msgstr "" msgid "" "Several functions return information about the platform's floating-point " "support. :c:func:`PyFloat_GetMax` returns the maximum representable " -"floating point value, and :c:func:`PyFloat_GetMin` returns the minimum " +"floating-point value, and :c:func:`PyFloat_GetMin` returns the minimum " "positive value. :c:func:`PyFloat_GetInfo` returns an object containing more " "information from the :file:`float.h` file, such as ``\"mant_dig\"`` (number " "of digits in the mantissa), ``\"epsilon\"`` (smallest difference between 1.0 " diff --git a/whatsnew/2.7.po b/whatsnew/2.7.po index 551070e49..72e3a0c43 100644 --- a/whatsnew/2.7.po +++ b/whatsnew/2.7.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1252,7 +1252,7 @@ msgid "" "now produces sensible results based on the numeric values of the operands. " "Previously such comparisons would fall back to Python's default rules for " "comparing objects, which produced arbitrary results based on their type. " -"Note that you still cannot combine :class:`!Decimal` and floating-point in " +"Note that you still cannot combine :class:`!Decimal` and floating point in " "other operations such as addition, since you should be explicitly choosing " "how to convert between float and :class:`!Decimal`. (Fixed by Mark " "Dickinson; :issue:`2531`.)" diff --git a/whatsnew/3.1.po b/whatsnew/3.1.po index afee6bea8..fb1fef761 100644 --- a/whatsnew/3.1.po +++ b/whatsnew/3.1.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -216,9 +216,9 @@ msgstr "" #: whatsnew/3.1.rst:208 msgid "" -"Python now uses David Gay's algorithm for finding the shortest floating " +"Python now uses David Gay's algorithm for finding the shortest floating-" "point representation that doesn't change its value. This should help " -"mitigate some of the confusion surrounding binary floating point numbers." +"mitigate some of the confusion surrounding binary floating-point numbers." msgstr "" #: whatsnew/3.1.rst:213 @@ -228,7 +228,7 @@ msgid "" "equivalent, an expression like ``float('1.1')`` evaluates to the nearest " "representable value which is ``0x1.199999999999ap+0`` in hex or " "``1.100000000000000088817841970012523233890533447265625`` in decimal. That " -"nearest value was and still is used in subsequent floating point " +"nearest value was and still is used in subsequent floating-point " "calculations." msgstr "" @@ -240,7 +240,7 @@ msgid "" "using 17 digits was that it relied on IEEE-754 guarantees to assure that " "``eval(repr(1.1))`` would round-trip exactly to its original value. The " "disadvantage is that many people found the output to be confusing (mistaking " -"intrinsic limitations of binary floating point representation as being a " +"intrinsic limitations of binary floating-point representation as being a " "problem with Python itself)." msgstr "" @@ -261,7 +261,7 @@ msgstr "" #: whatsnew/3.1.rst:239 msgid "" -"The new algorithm depends on certain features in the underlying floating " +"The new algorithm depends on certain features in the underlying floating-" "point implementation. If the required features are not found, the old " "algorithm will continue to be used. Also, the text pickle protocols assure " "cross-platform portability by using the old algorithm." @@ -690,7 +690,7 @@ msgstr "" #: whatsnew/3.1.rst:553 msgid "" -"The new floating point string representations can break existing doctests. " +"The new floating-point string representations can break existing doctests. " "For example::" msgstr "" diff --git a/whatsnew/3.11.po b/whatsnew/3.11.po index d8ee8f58e..93fd912e2 100644 --- a/whatsnew/3.11.po +++ b/whatsnew/3.11.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -133,7 +133,7 @@ msgid "" "pep670>`" msgstr "" -#: whatsnew/3.11.rst:2196 +#: whatsnew/3.11.rst:2211 msgid "New Features" msgstr "" @@ -862,16 +862,32 @@ msgid "(Contributed by Yurii Karabas in :issue:`46014`.)" msgstr "" #: whatsnew/3.11.rst:774 -msgid "hashlib" +msgid "gzip" msgstr "" #: whatsnew/3.11.rst:776 msgid "" +"The :func:`gzip.compress` function is now faster when used with the " +"**mtime=0** argument as it delegates the compression entirely to a single :" +"func:`zlib.compress` operation. There is one side effect of this change: The " +"gzip file header contains an \"OS\" byte in its header. That was " +"traditionally always set to a value of 255 representing \"unknown\" by the :" +"mod:`gzip` module. Now, when using :func:`~gzip.compress` with **mtime=0**, " +"it may be set to a different value by the underlying zlib C library Python " +"was linked against. (See :gh:`112346` for details on the side effect.)" +msgstr "" + +#: whatsnew/3.11.rst:789 +msgid "hashlib" +msgstr "" + +#: whatsnew/3.11.rst:791 +msgid "" ":func:`hashlib.blake2b` and :func:`hashlib.blake2s` now prefer `libb2`_ over " "Python's vendored copy. (Contributed by Christian Heimes in :issue:`47095`.)" msgstr "" -#: whatsnew/3.11.rst:780 +#: whatsnew/3.11.rst:795 msgid "" "The internal ``_sha3`` module with SHA3 and SHAKE algorithms now uses " "*tiny_sha3* instead of the *Keccak Code Package* to reduce code and binary " @@ -880,47 +896,47 @@ msgid "" "OpenSSL support. (Contributed by Christian Heimes in :issue:`47098`.)" msgstr "" -#: whatsnew/3.11.rst:787 +#: whatsnew/3.11.rst:802 msgid "" "Add :func:`hashlib.file_digest`, a helper function for efficient hashing of " "files or file-like objects. (Contributed by Christian Heimes in :gh:`89313`.)" msgstr "" -#: whatsnew/3.11.rst:795 +#: whatsnew/3.11.rst:810 msgid "IDLE and idlelib" msgstr "" -#: whatsnew/3.11.rst:797 +#: whatsnew/3.11.rst:812 msgid "" "Apply syntax highlighting to ``.pyi`` files. (Contributed by Alex Waygood " "and Terry Jan Reedy in :issue:`45447`.)" msgstr "" -#: whatsnew/3.11.rst:800 +#: whatsnew/3.11.rst:815 msgid "" "Include prompts when saving Shell with inputs and outputs. (Contributed by " "Terry Jan Reedy in :gh:`95191`.)" msgstr "" -#: whatsnew/3.11.rst:807 +#: whatsnew/3.11.rst:822 msgid "inspect" msgstr "" -#: whatsnew/3.11.rst:809 +#: whatsnew/3.11.rst:824 msgid "" "Add :func:`~inspect.getmembers_static` to return all members without " "triggering dynamic lookup via the descriptor protocol. (Contributed by " "Weipeng Hong in :issue:`30533`.)" msgstr "" -#: whatsnew/3.11.rst:813 +#: whatsnew/3.11.rst:828 msgid "" "Add :func:`~inspect.ismethodwrapper` for checking if the type of an object " "is a :class:`~types.MethodWrapperType`. (Contributed by Hakan Çelik in :" "issue:`29418`.)" msgstr "" -#: whatsnew/3.11.rst:817 +#: whatsnew/3.11.rst:832 msgid "" "Change the frame-related functions in the :mod:`inspect` module to return " "new :class:`~inspect.FrameInfo` and :class:`~inspect.Traceback` class " @@ -929,46 +945,46 @@ msgid "" "line number, column and end column). The affected functions are:" msgstr "" -#: whatsnew/3.11.rst:823 +#: whatsnew/3.11.rst:838 msgid ":func:`inspect.getframeinfo`" msgstr "" -#: whatsnew/3.11.rst:824 +#: whatsnew/3.11.rst:839 msgid ":func:`inspect.getouterframes`" msgstr "" -#: whatsnew/3.11.rst:825 +#: whatsnew/3.11.rst:840 msgid ":func:`inspect.getinnerframes`," msgstr "" -#: whatsnew/3.11.rst:826 +#: whatsnew/3.11.rst:841 msgid ":func:`inspect.stack`" msgstr "" -#: whatsnew/3.11.rst:827 +#: whatsnew/3.11.rst:842 msgid ":func:`inspect.trace`" msgstr "" -#: whatsnew/3.11.rst:829 +#: whatsnew/3.11.rst:844 msgid "(Contributed by Pablo Galindo in :gh:`88116`.)" msgstr "" -#: whatsnew/3.11.rst:835 +#: whatsnew/3.11.rst:850 msgid "locale" msgstr "" -#: whatsnew/3.11.rst:837 +#: whatsnew/3.11.rst:852 msgid "" "Add :func:`locale.getencoding` to get the current locale encoding. It is " "similar to ``locale.getpreferredencoding(False)`` but ignores the :ref:" "`Python UTF-8 Mode `." msgstr "" -#: whatsnew/3.11.rst:845 +#: whatsnew/3.11.rst:860 msgid "logging" msgstr "" -#: whatsnew/3.11.rst:847 +#: whatsnew/3.11.rst:862 msgid "" "Added :func:`~logging.getLevelNamesMapping` to return a mapping from logging " "level names (e.g. ``'CRITICAL'``) to the values of their corresponding :ref:" @@ -976,7 +992,7 @@ msgid "" "`88024`.)" msgstr "" -#: whatsnew/3.11.rst:852 +#: whatsnew/3.11.rst:867 msgid "" "Added a :meth:`~logging.handlers.SysLogHandler.createSocket` method to :" "class:`~logging.handlers.SysLogHandler`, to match :meth:`SocketHandler." @@ -985,23 +1001,23 @@ msgid "" "there is no active socket. (Contributed by Kirill Pinchuk in :gh:`88457`.)" msgstr "" -#: whatsnew/3.11.rst:864 +#: whatsnew/3.11.rst:879 msgid "math" msgstr "" -#: whatsnew/3.11.rst:866 +#: whatsnew/3.11.rst:881 msgid "" "Add :func:`math.exp2`: return 2 raised to the power of x. (Contributed by " "Gideon Mitchell in :issue:`45917`.)" msgstr "" -#: whatsnew/3.11.rst:869 +#: whatsnew/3.11.rst:884 msgid "" "Add :func:`math.cbrt`: return the cube root of x. (Contributed by Ajith " "Ramachandran in :issue:`44357`.)" msgstr "" -#: whatsnew/3.11.rst:872 +#: whatsnew/3.11.rst:887 msgid "" "The behaviour of two :func:`math.pow` corner cases was changed, for " "consistency with the IEEE 754 specification. The operations ``math.pow(0.0, -" @@ -1010,39 +1026,39 @@ msgid "" "`44339`.)" msgstr "" -#: whatsnew/3.11.rst:878 +#: whatsnew/3.11.rst:893 msgid "" "The :data:`math.nan` value is now always available. (Contributed by Victor " "Stinner in :issue:`46917`.)" msgstr "" -#: whatsnew/3.11.rst:885 +#: whatsnew/3.11.rst:900 msgid "operator" msgstr "" -#: whatsnew/3.11.rst:887 +#: whatsnew/3.11.rst:902 msgid "" "A new function ``operator.call`` has been added, such that ``operator." "call(obj, *args, **kwargs) == obj(*args, **kwargs)``. (Contributed by Antony " "Lee in :issue:`44019`.)" msgstr "" -#: whatsnew/3.11.rst:895 +#: whatsnew/3.11.rst:910 msgid "os" msgstr "" -#: whatsnew/3.11.rst:897 +#: whatsnew/3.11.rst:912 msgid "" "On Windows, :func:`os.urandom` now uses ``BCryptGenRandom()``, instead of " "``CryptGenRandom()`` which is deprecated. (Contributed by Donghee Na in :" "issue:`44611`.)" msgstr "" -#: whatsnew/3.11.rst:905 +#: whatsnew/3.11.rst:920 msgid "pathlib" msgstr "" -#: whatsnew/3.11.rst:907 +#: whatsnew/3.11.rst:922 msgid "" ":meth:`~pathlib.Path.glob` and :meth:`~pathlib.Path.rglob` return only " "directories if *pattern* ends with a pathname components separator: :data:" @@ -1050,56 +1066,56 @@ msgid "" "`22276` and :issue:`33392`.)" msgstr "" -#: whatsnew/3.11.rst:916 +#: whatsnew/3.11.rst:931 msgid "re" msgstr "" -#: whatsnew/3.11.rst:918 +#: whatsnew/3.11.rst:933 msgid "" "Atomic grouping (``(?>...)``) and possessive quantifiers (``*+``, ``++``, ``?" "+``, ``{m,n}+``) are now supported in regular expressions. (Contributed by " "Jeffrey C. Jacobs and Serhiy Storchaka in :issue:`433030`.)" msgstr "" -#: whatsnew/3.11.rst:926 +#: whatsnew/3.11.rst:941 msgid "shutil" msgstr "" -#: whatsnew/3.11.rst:928 +#: whatsnew/3.11.rst:943 msgid "" "Add optional parameter *dir_fd* in :func:`shutil.rmtree`. (Contributed by " "Serhiy Storchaka in :issue:`46245`.)" msgstr "" -#: whatsnew/3.11.rst:935 +#: whatsnew/3.11.rst:950 msgid "socket" msgstr "" -#: whatsnew/3.11.rst:937 +#: whatsnew/3.11.rst:952 msgid "" "Add CAN Socket support for NetBSD. (Contributed by Thomas Klausner in :issue:" "`30512`.)" msgstr "" -#: whatsnew/3.11.rst:940 +#: whatsnew/3.11.rst:955 msgid "" ":meth:`~socket.create_connection` has an option to raise, in case of failure " "to connect, an :exc:`ExceptionGroup` containing all errors instead of only " "raising the last error. (Contributed by Irit Katriel in :issue:`29980`.)" msgstr "" -#: whatsnew/3.11.rst:949 +#: whatsnew/3.11.rst:964 msgid "sqlite3" msgstr "" -#: whatsnew/3.11.rst:951 +#: whatsnew/3.11.rst:966 msgid "" "You can now disable the authorizer by passing :const:`None` to :meth:" "`~sqlite3.Connection.set_authorizer`. (Contributed by Erlend E. Aasland in :" "issue:`44491`.)" msgstr "" -#: whatsnew/3.11.rst:955 +#: whatsnew/3.11.rst:970 msgid "" "Collation name :meth:`~sqlite3.Connection.create_collation` can now contain " "any Unicode character. Collation names with invalid characters now raise :" @@ -1107,7 +1123,7 @@ msgid "" "(Contributed by Erlend E. Aasland in :issue:`44688`.)" msgstr "" -#: whatsnew/3.11.rst:960 +#: whatsnew/3.11.rst:975 msgid "" ":mod:`sqlite3` exceptions now include the SQLite extended error code as :" "attr:`~sqlite3.Error.sqlite_errorcode` and the SQLite error name as :attr:" @@ -1115,7 +1131,7 @@ msgid "" "Shahaf, and Erlend E. Aasland in :issue:`16379` and :issue:`24139`.)" msgstr "" -#: whatsnew/3.11.rst:966 +#: whatsnew/3.11.rst:981 msgid "" "Add :meth:`~sqlite3.Connection.setlimit` and :meth:`~sqlite3.Connection." "getlimit` to :class:`sqlite3.Connection` for setting and getting SQLite " @@ -1123,14 +1139,14 @@ msgid "" "`45243`.)" msgstr "" -#: whatsnew/3.11.rst:971 +#: whatsnew/3.11.rst:986 msgid "" ":mod:`sqlite3` now sets :attr:`sqlite3.threadsafety` based on the default " "threading mode the underlying SQLite library has been compiled with. " "(Contributed by Erlend E. Aasland in :issue:`45613`.)" msgstr "" -#: whatsnew/3.11.rst:975 +#: whatsnew/3.11.rst:990 msgid "" ":mod:`sqlite3` C callbacks now use unraisable exceptions if callback " "tracebacks are enabled. Users can now register an :func:`unraisable hook " @@ -1138,14 +1154,14 @@ msgid "" "(Contributed by Erlend E. Aasland in :issue:`45828`.)" msgstr "" -#: whatsnew/3.11.rst:981 +#: whatsnew/3.11.rst:996 msgid "" "Fetch across rollback no longer raises :exc:`~sqlite3.InterfaceError`. " "Instead we leave it to the SQLite library to handle these cases. " "(Contributed by Erlend E. Aasland in :issue:`44092`.)" msgstr "" -#: whatsnew/3.11.rst:985 +#: whatsnew/3.11.rst:1000 msgid "" "Add :meth:`~sqlite3.Connection.serialize` and :meth:`~sqlite3.Connection." "deserialize` to :class:`sqlite3.Connection` for serializing and " @@ -1153,25 +1169,25 @@ msgid "" "`41930`.)" msgstr "" -#: whatsnew/3.11.rst:990 +#: whatsnew/3.11.rst:1005 msgid "" "Add :meth:`~sqlite3.Connection.create_window_function` to :class:`sqlite3." "Connection` for creating aggregate window functions. (Contributed by Erlend " "E. Aasland in :issue:`34916`.)" msgstr "" -#: whatsnew/3.11.rst:994 +#: whatsnew/3.11.rst:1009 msgid "" "Add :meth:`~sqlite3.Connection.blobopen` to :class:`sqlite3.Connection`. :" "class:`sqlite3.Blob` allows incremental I/O operations on blobs. " "(Contributed by Aviv Palivoda and Erlend E. Aasland in :issue:`24905`.)" msgstr "" -#: whatsnew/3.11.rst:1002 +#: whatsnew/3.11.rst:1017 msgid "string" msgstr "" -#: whatsnew/3.11.rst:1004 +#: whatsnew/3.11.rst:1019 msgid "" "Add :meth:`~string.Template.get_identifiers` and :meth:`~string.Template." "is_valid` to :class:`string.Template`, which respectively return all valid " @@ -1179,11 +1195,11 @@ msgid "" "by Ben Kehoe in :gh:`90465`.)" msgstr "" -#: whatsnew/3.11.rst:1014 +#: whatsnew/3.11.rst:1029 msgid "sys" msgstr "" -#: whatsnew/3.11.rst:1016 +#: whatsnew/3.11.rst:1031 msgid "" ":func:`sys.exc_info` now derives the ``type`` and ``traceback`` fields from " "the ``value`` (the exception instance), so when an exception is modified " @@ -1192,24 +1208,24 @@ msgid "" "issue:`45711`.)" msgstr "" -#: whatsnew/3.11.rst:1022 +#: whatsnew/3.11.rst:1037 msgid "" "Add :func:`sys.exception` which returns the active exception instance " "(equivalent to ``sys.exc_info()[1]``). (Contributed by Irit Katriel in :" "issue:`46328`.)" msgstr "" -#: whatsnew/3.11.rst:1026 +#: whatsnew/3.11.rst:1041 msgid "" "Add the :data:`sys.flags.safe_path ` flag. (Contributed by Victor " "Stinner in :gh:`57684`.)" msgstr "" -#: whatsnew/3.11.rst:1033 +#: whatsnew/3.11.rst:1048 msgid "sysconfig" msgstr "" -#: whatsnew/3.11.rst:1035 +#: whatsnew/3.11.rst:1050 msgid "" "Three new :ref:`installation schemes ` (*posix_venv*, " "*nt_venv* and *venv*) were added and are used when Python creates new " @@ -1223,11 +1239,11 @@ msgid "" "(Contributed by Miro Hrončok in :issue:`45413`.)" msgstr "" -#: whatsnew/3.11.rst:1052 +#: whatsnew/3.11.rst:1067 msgid "tempfile" msgstr "" -#: whatsnew/3.11.rst:1054 +#: whatsnew/3.11.rst:1069 msgid "" ":class:`~tempfile.SpooledTemporaryFile` objects now fully implement the " "methods of :class:`io.BufferedIOBase` or :class:`io.TextIOBase` (depending " @@ -1236,11 +1252,11 @@ msgid "" "`70363`.)" msgstr "" -#: whatsnew/3.11.rst:1065 +#: whatsnew/3.11.rst:1080 msgid "threading" msgstr "" -#: whatsnew/3.11.rst:1067 +#: whatsnew/3.11.rst:1082 msgid "" "On Unix, if the ``sem_clockwait()`` function is available in the C library " "(glibc 2.30 and newer), the :meth:`threading.Lock.acquire` method now uses " @@ -1250,11 +1266,11 @@ msgid "" "`41710`.)" msgstr "" -#: whatsnew/3.11.rst:1078 +#: whatsnew/3.11.rst:1093 msgid "time" msgstr "" -#: whatsnew/3.11.rst:1080 +#: whatsnew/3.11.rst:1095 msgid "" "On Unix, :func:`time.sleep` now uses the ``clock_nanosleep()`` or " "``nanosleep()`` function, if available, which has a resolution of 1 " @@ -1263,7 +1279,7 @@ msgid "" "Benjamin Szőke and Victor Stinner in :issue:`21302`.)" msgstr "" -#: whatsnew/3.11.rst:1086 +#: whatsnew/3.11.rst:1101 msgid "" "On Windows 8.1 and newer, :func:`time.sleep` now uses a waitable timer based " "on `high-resolution timers `. " "(Contributed by Niklas Rosenstein in :gh:`85542`.)" msgstr "" -#: whatsnew/3.11.rst:1177 +#: whatsnew/3.11.rst:1192 msgid "" ":func:`typing.get_type_hints` no longer adds :data:`~typing.Optional` to " "parameters with ``None`` as a default. (Contributed by Nikita Sobolev in :gh:" "`90353`.)" msgstr "" -#: whatsnew/3.11.rst:1181 +#: whatsnew/3.11.rst:1196 msgid "" ":func:`typing.get_type_hints` now supports evaluating bare stringified :data:" "`~typing.ClassVar` annotations. (Contributed by Gregory Beauregard in :gh:" "`90711`.)" msgstr "" -#: whatsnew/3.11.rst:1185 +#: whatsnew/3.11.rst:1200 msgid "" ":func:`typing.no_type_check` no longer modifies external classes and " "functions. It also now correctly marks classmethods as not to be type " "checked. (Contributed by Nikita Sobolev in :gh:`90729`.)" msgstr "" -#: whatsnew/3.11.rst:1193 +#: whatsnew/3.11.rst:1208 msgid "unicodedata" msgstr "" -#: whatsnew/3.11.rst:1195 +#: whatsnew/3.11.rst:1210 msgid "" "The Unicode database has been updated to version 14.0.0. (Contributed by " "Benjamin Peterson in :issue:`45190`)." msgstr "" -#: whatsnew/3.11.rst:1202 +#: whatsnew/3.11.rst:1217 msgid "unittest" msgstr "" -#: whatsnew/3.11.rst:1204 +#: whatsnew/3.11.rst:1219 msgid "" "Added methods :meth:`~unittest.TestCase.enterContext` and :meth:`~unittest." "TestCase.enterClassContext` of class :class:`~unittest.TestCase`, method :" @@ -1438,11 +1454,11 @@ msgid "" "enterModuleContext`. (Contributed by Serhiy Storchaka in :issue:`45046`.)" msgstr "" -#: whatsnew/3.11.rst:1216 +#: whatsnew/3.11.rst:1231 msgid "venv" msgstr "" -#: whatsnew/3.11.rst:1218 +#: whatsnew/3.11.rst:1233 msgid "" "When new Python virtual environments are created, the *venv* :ref:`sysconfig " "installation scheme ` is used to determine the paths " @@ -1454,11 +1470,11 @@ msgid "" "`45413`.)" msgstr "" -#: whatsnew/3.11.rst:1232 +#: whatsnew/3.11.rst:1247 msgid "warnings" msgstr "" -#: whatsnew/3.11.rst:1234 +#: whatsnew/3.11.rst:1249 msgid "" ":func:`warnings.catch_warnings` now accepts arguments for :func:`warnings." "simplefilter`, providing a more concise way to locally ignore warnings or " @@ -1466,41 +1482,41 @@ msgid "" "`47074`.)" msgstr "" -#: whatsnew/3.11.rst:1242 +#: whatsnew/3.11.rst:1257 msgid "zipfile" msgstr "" -#: whatsnew/3.11.rst:1244 +#: whatsnew/3.11.rst:1259 msgid "" "Added support for specifying member name encoding for reading metadata in a :" "class:`~zipfile.ZipFile`'s directory and file headers. (Contributed by " "Stephen J. Turnbull and Serhiy Storchaka in :issue:`28080`.)" msgstr "" -#: whatsnew/3.11.rst:1248 +#: whatsnew/3.11.rst:1263 msgid "" "Added :meth:`ZipFile.mkdir() ` for creating new " "directories inside ZIP archives. (Contributed by Sam Ezeh in :gh:`49083`.)" msgstr "" -#: whatsnew/3.11.rst:1252 +#: whatsnew/3.11.rst:1267 msgid "" "Added :attr:`~zipfile.Path.stem`, :attr:`~zipfile.Path.suffix` and :attr:" "`~zipfile.Path.suffixes` to :class:`zipfile.Path`. (Contributed by Miguel " "Brito in :gh:`88261`.)" msgstr "" -#: whatsnew/3.11.rst:1260 +#: whatsnew/3.11.rst:1275 msgid "Optimizations" msgstr "" -#: whatsnew/3.11.rst:1262 +#: whatsnew/3.11.rst:1277 msgid "" "This section covers specific optimizations independent of the :ref:" "`whatsnew311-faster-cpython` project, which is covered in its own section." msgstr "" -#: whatsnew/3.11.rst:1265 +#: whatsnew/3.11.rst:1280 msgid "" "The compiler now optimizes simple :ref:`printf-style % formatting ` on string literals containing only the format codes " @@ -1508,7 +1524,7 @@ msgid "" "string` expression. (Contributed by Serhiy Storchaka in :issue:`28307`.)" msgstr "" -#: whatsnew/3.11.rst:1271 +#: whatsnew/3.11.rst:1286 msgid "" "Integer division (``//``) is better tuned for optimization by compilers. It " "is now around 20% faster on x86-64 when dividing an :class:`int` by a value " @@ -1516,20 +1532,20 @@ msgid "" "gh:`90564`.)" msgstr "" -#: whatsnew/3.11.rst:1276 +#: whatsnew/3.11.rst:1291 msgid "" ":func:`sum` is now nearly 30% faster for integers smaller than ``2**30``. " "(Contributed by Stefan Behnel in :gh:`68264`.)" msgstr "" -#: whatsnew/3.11.rst:1279 +#: whatsnew/3.11.rst:1294 msgid "" "Resizing lists is streamlined for the common case, speeding up :meth:`list." "append` by ≈15% and simple :term:`list comprehension`\\s by up to 20-30% " "(Contributed by Dennis Sweeney in :gh:`91165`.)" msgstr "" -#: whatsnew/3.11.rst:1284 +#: whatsnew/3.11.rst:1299 msgid "" "Dictionaries don't store hash values when all keys are Unicode objects, " "decreasing :class:`dict` size. For example, ``sys.getsizeof(dict." @@ -1537,21 +1553,21 @@ msgid "" "smaller) on 64-bit platforms. (Contributed by Inada Naoki in :issue:`46845`.)" msgstr "" -#: whatsnew/3.11.rst:1290 +#: whatsnew/3.11.rst:1305 msgid "" "Using :class:`asyncio.DatagramProtocol` is now orders of magnitude faster " "when transferring large files over UDP, with speeds over 100 times higher " "for a ≈60 MiB file. (Contributed by msoxzw in :gh:`91487`.)" msgstr "" -#: whatsnew/3.11.rst:1295 +#: whatsnew/3.11.rst:1310 msgid "" ":mod:`math` functions :func:`~math.comb` and :func:`~math.perm` are now ≈10 " "times faster for large arguments (with a larger speedup for larger *k*). " "(Contributed by Serhiy Storchaka in :issue:`37295`.)" msgstr "" -#: whatsnew/3.11.rst:1299 +#: whatsnew/3.11.rst:1314 msgid "" "The :mod:`statistics` functions :func:`~statistics.mean`, :func:`~statistics." "variance` and :func:`~statistics.stdev` now consume iterators in one pass " @@ -1560,17 +1576,17 @@ msgid "" "`90415`.)" msgstr "" -#: whatsnew/3.11.rst:1305 +#: whatsnew/3.11.rst:1320 msgid "" ":func:`unicodedata.normalize` now normalizes pure-ASCII strings in constant " "time. (Contributed by Donghee Na in :issue:`44987`.)" msgstr "" -#: whatsnew/3.11.rst:1313 +#: whatsnew/3.11.rst:1328 msgid "Faster CPython" msgstr "" -#: whatsnew/3.11.rst:1315 +#: whatsnew/3.11.rst:1330 msgid "" "CPython 3.11 is an average of `25% faster `_ than CPython 3.10 as measured with the " @@ -1579,32 +1595,32 @@ msgid "" "overall speedup could be 10-60%." msgstr "" -#: whatsnew/3.11.rst:1322 +#: whatsnew/3.11.rst:1337 msgid "" "This project focuses on two major areas in Python: :ref:`whatsnew311-faster-" "startup` and :ref:`whatsnew311-faster-runtime`. Optimizations not covered by " "this project are listed separately under :ref:`whatsnew311-optimizations`." msgstr "" -#: whatsnew/3.11.rst:1331 +#: whatsnew/3.11.rst:1346 msgid "Faster Startup" msgstr "" -#: whatsnew/3.11.rst:1336 +#: whatsnew/3.11.rst:1351 msgid "Frozen imports / Static code objects" msgstr "" -#: whatsnew/3.11.rst:1338 +#: whatsnew/3.11.rst:1353 msgid "" "Python caches :term:`bytecode` in the :ref:`__pycache__ ` " "directory to speed up module loading." msgstr "" -#: whatsnew/3.11.rst:1341 +#: whatsnew/3.11.rst:1356 msgid "Previously in 3.10, Python module execution looked like this:" msgstr "" -#: whatsnew/3.11.rst:1347 +#: whatsnew/3.11.rst:1362 msgid "" "In Python 3.11, the core modules essential for Python startup are " "\"frozen\". This means that their :ref:`codeobjects` (and bytecode) are " @@ -1612,47 +1628,47 @@ msgid "" "execution process to:" msgstr "" -#: whatsnew/3.11.rst:1356 +#: whatsnew/3.11.rst:1371 msgid "" "Interpreter startup is now 10-15% faster in Python 3.11. This has a big " "impact for short-running programs using Python." msgstr "" -#: whatsnew/3.11.rst:1359 +#: whatsnew/3.11.rst:1374 msgid "" "(Contributed by Eric Snow, Guido van Rossum and Kumar Aditya in many issues.)" msgstr "" -#: whatsnew/3.11.rst:1365 +#: whatsnew/3.11.rst:1380 msgid "Faster Runtime" msgstr "" -#: whatsnew/3.11.rst:1370 +#: whatsnew/3.11.rst:1385 msgid "Cheaper, lazy Python frames" msgstr "" -#: whatsnew/3.11.rst:1372 +#: whatsnew/3.11.rst:1387 msgid "" "Python frames, holding execution information, are created whenever Python " "calls a Python function. The following are new frame optimizations:" msgstr "" -#: whatsnew/3.11.rst:1376 +#: whatsnew/3.11.rst:1391 msgid "Streamlined the frame creation process." msgstr "" -#: whatsnew/3.11.rst:1377 +#: whatsnew/3.11.rst:1392 msgid "" "Avoided memory allocation by generously re-using frame space on the C stack." msgstr "" -#: whatsnew/3.11.rst:1378 +#: whatsnew/3.11.rst:1393 msgid "" "Streamlined the internal frame struct to contain only essential information. " "Frames previously held extra debugging and memory management information." msgstr "" -#: whatsnew/3.11.rst:1381 +#: whatsnew/3.11.rst:1396 msgid "" "Old-style :ref:`frame objects ` are now created only when " "requested by debuggers or by Python introspection functions such as :func:" @@ -1662,29 +1678,29 @@ msgid "" "pyperformance." msgstr "" -#: whatsnew/3.11.rst:1388 +#: whatsnew/3.11.rst:1403 msgid "(Contributed by Mark Shannon in :issue:`44590`.)" msgstr "" -#: whatsnew/3.11.rst:1395 +#: whatsnew/3.11.rst:1410 msgid "Inlined Python function calls" msgstr "" -#: whatsnew/3.11.rst:1397 +#: whatsnew/3.11.rst:1412 msgid "" "During a Python function call, Python will call an evaluating C function to " "interpret that function's code. This effectively limits pure Python " "recursion to what's safe for the C stack." msgstr "" -#: whatsnew/3.11.rst:1401 +#: whatsnew/3.11.rst:1416 msgid "" "In 3.11, when CPython detects Python code calling another Python function, " "it sets up a new frame, and \"jumps\" to the new code inside the new frame. " "This avoids calling the C interpreting function altogether." msgstr "" -#: whatsnew/3.11.rst:1405 +#: whatsnew/3.11.rst:1420 msgid "" "Most Python function calls now consume no C stack space, speeding them up. " "In simple recursive functions like fibonacci or factorial, we observed a " @@ -1693,15 +1709,15 @@ msgid "" "setrecursionlimit`). We measured a 1-3% improvement in pyperformance." msgstr "" -#: whatsnew/3.11.rst:1412 +#: whatsnew/3.11.rst:1427 msgid "(Contributed by Pablo Galindo and Mark Shannon in :issue:`45256`.)" msgstr "" -#: whatsnew/3.11.rst:1418 +#: whatsnew/3.11.rst:1433 msgid "PEP 659: Specializing Adaptive Interpreter" msgstr "" -#: whatsnew/3.11.rst:1420 +#: whatsnew/3.11.rst:1435 msgid "" ":pep:`659` is one of the key parts of the Faster CPython project. The " "general idea is that while Python is a dynamic language, most code has " @@ -1709,7 +1725,7 @@ msgid "" "*type stability*." msgstr "" -#: whatsnew/3.11.rst:1424 +#: whatsnew/3.11.rst:1439 msgid "" "At runtime, Python will try to look for common patterns and type stability " "in the executing code. Python will then replace the current operation with a " @@ -1720,13 +1736,13 @@ msgid "" "term:`bytecode`." msgstr "" -#: whatsnew/3.11.rst:1432 +#: whatsnew/3.11.rst:1447 msgid "" "The specializer will also combine certain common instruction pairs into one " "superinstruction, reducing the overhead during execution." msgstr "" -#: whatsnew/3.11.rst:1435 +#: whatsnew/3.11.rst:1450 msgid "" "Python will only specialize when it sees code that is \"hot\" (executed " "multiple times). This prevents Python from wasting time on run-once code. " @@ -1736,279 +1752,279 @@ msgid "" "circumstances." msgstr "" -#: whatsnew/3.11.rst:1442 +#: whatsnew/3.11.rst:1457 msgid "" "(PEP written by Mark Shannon, with ideas inspired by Stefan Brunthaler. See :" "pep:`659` for more information. Implementation by Mark Shannon and Brandt " "Bucher, with additional help from Irit Katriel and Dennis Sweeney.)" msgstr "" -#: whatsnew/3.11.rst:1450 +#: whatsnew/3.11.rst:1465 msgid "Operation" msgstr "" -#: whatsnew/3.11.rst:1450 +#: whatsnew/3.11.rst:1465 msgid "Form" msgstr "" -#: whatsnew/3.11.rst:1450 +#: whatsnew/3.11.rst:1465 msgid "Specialization" msgstr "" -#: whatsnew/3.11.rst:1450 +#: whatsnew/3.11.rst:1465 msgid "Operation speedup (up to)" msgstr "" -#: whatsnew/3.11.rst:1450 +#: whatsnew/3.11.rst:1465 msgid "Contributor(s)" msgstr "" -#: whatsnew/3.11.rst:1453 +#: whatsnew/3.11.rst:1468 msgid "Binary operations" msgstr "" -#: whatsnew/3.11.rst:1453 +#: whatsnew/3.11.rst:1468 msgid "``x + x``" msgstr "" -#: whatsnew/3.11.rst:1455 +#: whatsnew/3.11.rst:1470 msgid "``x - x``" msgstr "" -#: whatsnew/3.11.rst:1457 +#: whatsnew/3.11.rst:1472 msgid "``x * x``" msgstr "" -#: whatsnew/3.11.rst:1453 +#: whatsnew/3.11.rst:1468 msgid "" "Binary add, multiply and subtract for common types such as :class:`int`, :" "class:`float` and :class:`str` take custom fast paths for their underlying " "types." msgstr "" -#: whatsnew/3.11.rst:1453 +#: whatsnew/3.11.rst:1468 msgid "10%" msgstr "" -#: whatsnew/3.11.rst:1453 +#: whatsnew/3.11.rst:1468 msgid "Mark Shannon, Donghee Na, Brandt Bucher, Dennis Sweeney" msgstr "" -#: whatsnew/3.11.rst:1459 +#: whatsnew/3.11.rst:1474 msgid "Subscript" msgstr "" -#: whatsnew/3.11.rst:1459 +#: whatsnew/3.11.rst:1474 msgid "``a[i]``" msgstr "" -#: whatsnew/3.11.rst:1459 +#: whatsnew/3.11.rst:1474 msgid "" "Subscripting container types such as :class:`list`, :class:`tuple` and :" "class:`dict` directly index the underlying data structures." msgstr "" -#: whatsnew/3.11.rst:1463 +#: whatsnew/3.11.rst:1478 msgid "" "Subscripting custom :meth:`~object.__getitem__` is also inlined similar to :" "ref:`inline-calls`." msgstr "" -#: whatsnew/3.11.rst:1466 +#: whatsnew/3.11.rst:1481 msgid "10-25%" msgstr "" -#: whatsnew/3.11.rst:1459 +#: whatsnew/3.11.rst:1474 msgid "Irit Katriel, Mark Shannon" msgstr "" -#: whatsnew/3.11.rst:1466 +#: whatsnew/3.11.rst:1481 msgid "Store subscript" msgstr "" -#: whatsnew/3.11.rst:1466 +#: whatsnew/3.11.rst:1481 msgid "``a[i] = z``" msgstr "" -#: whatsnew/3.11.rst:1466 +#: whatsnew/3.11.rst:1481 msgid "Similar to subscripting specialization above." msgstr "" -#: whatsnew/3.11.rst:1466 +#: whatsnew/3.11.rst:1481 msgid "Dennis Sweeney" msgstr "" -#: whatsnew/3.11.rst:1469 +#: whatsnew/3.11.rst:1484 msgid "Calls" msgstr "" -#: whatsnew/3.11.rst:1469 +#: whatsnew/3.11.rst:1484 msgid "``f(arg)``" msgstr "" -#: whatsnew/3.11.rst:1471 +#: whatsnew/3.11.rst:1486 msgid "``C(arg)``" msgstr "" -#: whatsnew/3.11.rst:1469 +#: whatsnew/3.11.rst:1484 msgid "" "Calls to common builtin (C) functions and types such as :func:`len` and :" "class:`str` directly call their underlying C version. This avoids going " "through the internal calling convention." msgstr "" -#: whatsnew/3.11.rst:1469 +#: whatsnew/3.11.rst:1484 msgid "20%" msgstr "" -#: whatsnew/3.11.rst:1469 +#: whatsnew/3.11.rst:1484 msgid "Mark Shannon, Ken Jin" msgstr "" -#: whatsnew/3.11.rst:1474 +#: whatsnew/3.11.rst:1489 msgid "Load global variable" msgstr "" -#: whatsnew/3.11.rst:1474 +#: whatsnew/3.11.rst:1489 msgid "``print``" msgstr "" -#: whatsnew/3.11.rst:1476 +#: whatsnew/3.11.rst:1491 msgid "``len``" msgstr "" -#: whatsnew/3.11.rst:1474 +#: whatsnew/3.11.rst:1489 msgid "" "The object's index in the globals/builtins namespace is cached. Loading " "globals and builtins require zero namespace lookups." msgstr "" -#: whatsnew/3.11.rst:1474 +#: whatsnew/3.11.rst:1489 msgid "[#load-global]_" msgstr "" -#: whatsnew/3.11.rst:1478 whatsnew/3.11.rst:1487 +#: whatsnew/3.11.rst:1493 whatsnew/3.11.rst:1502 msgid "Mark Shannon" msgstr "" -#: whatsnew/3.11.rst:1478 +#: whatsnew/3.11.rst:1493 msgid "Load attribute" msgstr "" -#: whatsnew/3.11.rst:1478 +#: whatsnew/3.11.rst:1493 msgid "``o.attr``" msgstr "" -#: whatsnew/3.11.rst:1478 +#: whatsnew/3.11.rst:1493 msgid "" "Similar to loading global variables. The attribute's index inside the class/" "object's namespace is cached. In most cases, attribute loading will require " "zero namespace lookups." msgstr "" -#: whatsnew/3.11.rst:1478 +#: whatsnew/3.11.rst:1493 msgid "[#load-attr]_" msgstr "" -#: whatsnew/3.11.rst:1483 +#: whatsnew/3.11.rst:1498 msgid "Load methods for call" msgstr "" -#: whatsnew/3.11.rst:1483 +#: whatsnew/3.11.rst:1498 msgid "``o.meth()``" msgstr "" -#: whatsnew/3.11.rst:1483 +#: whatsnew/3.11.rst:1498 msgid "" "The actual address of the method is cached. Method loading now has no " "namespace lookups -- even for classes with long inheritance chains." msgstr "" -#: whatsnew/3.11.rst:1483 +#: whatsnew/3.11.rst:1498 msgid "10-20%" msgstr "" -#: whatsnew/3.11.rst:1483 +#: whatsnew/3.11.rst:1498 msgid "Ken Jin, Mark Shannon" msgstr "" -#: whatsnew/3.11.rst:1487 +#: whatsnew/3.11.rst:1502 msgid "Store attribute" msgstr "" -#: whatsnew/3.11.rst:1487 +#: whatsnew/3.11.rst:1502 msgid "``o.attr = z``" msgstr "" -#: whatsnew/3.11.rst:1487 +#: whatsnew/3.11.rst:1502 msgid "Similar to load attribute optimization." msgstr "" -#: whatsnew/3.11.rst:1487 +#: whatsnew/3.11.rst:1502 msgid "2% in pyperformance" msgstr "" -#: whatsnew/3.11.rst:1490 +#: whatsnew/3.11.rst:1505 msgid "Unpack Sequence" msgstr "" -#: whatsnew/3.11.rst:1490 +#: whatsnew/3.11.rst:1505 msgid "``*seq``" msgstr "" -#: whatsnew/3.11.rst:1490 +#: whatsnew/3.11.rst:1505 msgid "" "Specialized for common containers such as :class:`list` and :class:`tuple`. " "Avoids internal calling convention." msgstr "" -#: whatsnew/3.11.rst:1490 +#: whatsnew/3.11.rst:1505 msgid "8%" msgstr "" -#: whatsnew/3.11.rst:1490 +#: whatsnew/3.11.rst:1505 msgid "Brandt Bucher" msgstr "" -#: whatsnew/3.11.rst:1495 +#: whatsnew/3.11.rst:1510 msgid "" "A similar optimization already existed since Python 3.8. 3.11 specializes " "for more forms and reduces some overhead." msgstr "" -#: whatsnew/3.11.rst:1498 +#: whatsnew/3.11.rst:1513 msgid "" "A similar optimization already existed since Python 3.10. 3.11 specializes " "for more forms. Furthermore, all attribute loads should be sped up by :issue:" "`45947`." msgstr "" -#: whatsnew/3.11.rst:1506 +#: whatsnew/3.11.rst:1521 msgid "Misc" msgstr "" -#: whatsnew/3.11.rst:1508 +#: whatsnew/3.11.rst:1523 msgid "" "Objects now require less memory due to lazily created object namespaces. " "Their namespace dictionaries now also share keys more freely. (Contributed " "Mark Shannon in :issue:`45340` and :issue:`40116`.)" msgstr "" -#: whatsnew/3.11.rst:1512 +#: whatsnew/3.11.rst:1527 msgid "" "\"Zero-cost\" exceptions are implemented, eliminating the cost of :keyword:" "`try` statements when no exception is raised. (Contributed by Mark Shannon " "in :issue:`40222`.)" msgstr "" -#: whatsnew/3.11.rst:1516 +#: whatsnew/3.11.rst:1531 msgid "" "A more concise representation of exceptions in the interpreter reduced the " "time required for catching an exception by about 10%. (Contributed by Irit " "Katriel in :issue:`45711`.)" msgstr "" -#: whatsnew/3.11.rst:1520 +#: whatsnew/3.11.rst:1535 msgid "" ":mod:`re`'s regular expression matching engine has been partially " "refactored, and now uses computed gotos (or \"threaded code\") on supported " @@ -2018,37 +2034,37 @@ msgid "" "Bucher in :gh:`91404`.)" msgstr "" -#: whatsnew/3.11.rst:1531 +#: whatsnew/3.11.rst:1546 msgid "FAQ" msgstr "" -#: whatsnew/3.11.rst:1536 +#: whatsnew/3.11.rst:1551 msgid "How should I write my code to utilize these speedups?" msgstr "" -#: whatsnew/3.11.rst:1538 +#: whatsnew/3.11.rst:1553 msgid "" "Write Pythonic code that follows common best practices; you don't have to " "change your code. The Faster CPython project optimizes for common code " "patterns we observe." msgstr "" -#: whatsnew/3.11.rst:1546 +#: whatsnew/3.11.rst:1561 msgid "Will CPython 3.11 use more memory?" msgstr "" -#: whatsnew/3.11.rst:1548 +#: whatsnew/3.11.rst:1563 msgid "" "Maybe not; we don't expect memory use to exceed 20% higher than 3.10. This " "is offset by memory optimizations for frame objects and object dictionaries " "as mentioned above." msgstr "" -#: whatsnew/3.11.rst:1556 +#: whatsnew/3.11.rst:1571 msgid "I don't see any speedups in my workload. Why?" msgstr "" -#: whatsnew/3.11.rst:1558 +#: whatsnew/3.11.rst:1573 msgid "" "Certain code won't have noticeable benefits. If your code spends most of its " "time on I/O operations, or already does most of its computation in a C " @@ -2056,26 +2072,26 @@ msgid "" "project currently benefits pure-Python workloads the most." msgstr "" -#: whatsnew/3.11.rst:1563 +#: whatsnew/3.11.rst:1578 msgid "" "Furthermore, the pyperformance figures are a geometric mean. Even within the " "pyperformance benchmarks, certain benchmarks have slowed down slightly, " "while others have sped up by nearly 2x!" msgstr "" -#: whatsnew/3.11.rst:1571 +#: whatsnew/3.11.rst:1586 msgid "Is there a JIT compiler?" msgstr "" -#: whatsnew/3.11.rst:1573 +#: whatsnew/3.11.rst:1588 msgid "No. We're still exploring other optimizations." msgstr "" -#: whatsnew/3.11.rst:1579 +#: whatsnew/3.11.rst:1594 msgid "About" msgstr "" -#: whatsnew/3.11.rst:1581 +#: whatsnew/3.11.rst:1596 msgid "" "Faster CPython explores optimizations for :term:`CPython`. The main team is " "funded by Microsoft to work on this full-time. Pablo Galindo Salgado is also " @@ -2083,11 +2099,11 @@ msgid "" "contributors are volunteers from the community." msgstr "" -#: whatsnew/3.11.rst:1590 +#: whatsnew/3.11.rst:1605 msgid "CPython bytecode changes" msgstr "" -#: whatsnew/3.11.rst:1592 +#: whatsnew/3.11.rst:1607 msgid "" "The bytecode now contains inline cache entries, which take the form of the " "newly-added :opcode:`CACHE` instructions. Many opcodes expect to be followed " @@ -2097,62 +2113,62 @@ msgid "" "containing quickened data." msgstr "" -#: whatsnew/3.11.rst:1604 +#: whatsnew/3.11.rst:1619 msgid "New opcodes" msgstr "" -#: whatsnew/3.11.rst:1606 +#: whatsnew/3.11.rst:1621 msgid "" ":opcode:`!ASYNC_GEN_WRAP`, :opcode:`RETURN_GENERATOR` and :opcode:`SEND`, " "used in generators and co-routines." msgstr "" -#: whatsnew/3.11.rst:1609 +#: whatsnew/3.11.rst:1624 msgid "" ":opcode:`COPY_FREE_VARS`, which avoids needing special caller-side code for " "closures." msgstr "" -#: whatsnew/3.11.rst:1612 +#: whatsnew/3.11.rst:1627 msgid "" ":opcode:`JUMP_BACKWARD_NO_INTERRUPT`, for use in certain loops where " "handling interrupts is undesirable." msgstr "" -#: whatsnew/3.11.rst:1615 +#: whatsnew/3.11.rst:1630 msgid ":opcode:`MAKE_CELL`, to create :ref:`cell-objects`." msgstr "" -#: whatsnew/3.11.rst:1617 +#: whatsnew/3.11.rst:1632 msgid "" ":opcode:`CHECK_EG_MATCH` and :opcode:`!PREP_RERAISE_STAR`, to handle the :" "ref:`new exception groups and except* ` added in :pep:" "`654`." msgstr "" -#: whatsnew/3.11.rst:1621 +#: whatsnew/3.11.rst:1636 msgid ":opcode:`PUSH_EXC_INFO`, for use in exception handlers." msgstr "" -#: whatsnew/3.11.rst:1623 +#: whatsnew/3.11.rst:1638 msgid "" ":opcode:`RESUME`, a no-op, for internal tracing, debugging and optimization " "checks." msgstr "" -#: whatsnew/3.11.rst:1630 +#: whatsnew/3.11.rst:1645 msgid "Replaced opcodes" msgstr "" -#: whatsnew/3.11.rst:1633 +#: whatsnew/3.11.rst:1648 msgid "Replaced Opcode(s)" msgstr "" -#: whatsnew/3.11.rst:1633 +#: whatsnew/3.11.rst:1648 msgid "New Opcode(s)" msgstr "" -#: whatsnew/3.11.rst:1633 +#: whatsnew/3.11.rst:1648 msgid "Notes" msgstr "" @@ -2164,11 +2180,11 @@ msgstr "" msgid ":opcode:`!INPLACE_*`" msgstr "" -#: whatsnew/3.11.rst:1635 +#: whatsnew/3.11.rst:1650 msgid ":opcode:`BINARY_OP`" msgstr "" -#: whatsnew/3.11.rst:1635 +#: whatsnew/3.11.rst:1650 msgid "Replaced all numeric binary/in-place opcodes with a single opcode" msgstr "" @@ -2200,7 +2216,7 @@ msgstr "" msgid ":opcode:`PUSH_NULL`" msgstr "" -#: whatsnew/3.11.rst:1638 +#: whatsnew/3.11.rst:1653 msgid "" "Decouples argument shifting for methods from handling of keyword arguments; " "allows better specialization of calls" @@ -2238,7 +2254,7 @@ msgstr "" msgid ":opcode:`SWAP`" msgstr "" -#: whatsnew/3.11.rst:1643 +#: whatsnew/3.11.rst:1658 msgid "Stack manipulation instructions" msgstr "" @@ -2250,7 +2266,7 @@ msgstr "" msgid ":opcode:`CHECK_EXC_MATCH`" msgstr "" -#: whatsnew/3.11.rst:1650 +#: whatsnew/3.11.rst:1665 msgid "Now performs check but doesn't jump" msgstr "" @@ -2278,7 +2294,7 @@ msgstr "" msgid ":opcode:`!POP_JUMP_FORWARD_IF_*`" msgstr "" -#: whatsnew/3.11.rst:1652 +#: whatsnew/3.11.rst:1667 msgid "" "See [#bytecode-jump]_; ``TRUE``, ``FALSE``, ``NONE`` and ``NOT_NONE`` " "variants for each direction" @@ -2292,64 +2308,64 @@ msgstr "" msgid ":opcode:`!SETUP_ASYNC_WITH`" msgstr "" -#: whatsnew/3.11.rst:1658 +#: whatsnew/3.11.rst:1673 msgid ":opcode:`BEFORE_WITH`" msgstr "" -#: whatsnew/3.11.rst:1658 +#: whatsnew/3.11.rst:1673 msgid ":keyword:`with` block setup" msgstr "" -#: whatsnew/3.11.rst:1662 +#: whatsnew/3.11.rst:1677 msgid "" "All jump opcodes are now relative, including the existing :opcode:`!" "JUMP_IF_TRUE_OR_POP` and :opcode:`!JUMP_IF_FALSE_OR_POP`. The argument is " "now an offset from the current instruction rather than an absolute location." msgstr "" -#: whatsnew/3.11.rst:1673 +#: whatsnew/3.11.rst:1688 msgid "Changed/removed opcodes" msgstr "" -#: whatsnew/3.11.rst:1675 +#: whatsnew/3.11.rst:1690 msgid "" "Changed :opcode:`MATCH_CLASS` and :opcode:`MATCH_KEYS` to no longer push an " "additional boolean value to indicate success/failure. Instead, ``None`` is " "pushed on failure in place of the tuple of extracted values." msgstr "" -#: whatsnew/3.11.rst:1680 +#: whatsnew/3.11.rst:1695 msgid "" "Changed opcodes that work with exceptions to reflect them now being " "represented as one item on the stack instead of three (see :gh:`89874`)." msgstr "" -#: whatsnew/3.11.rst:1684 +#: whatsnew/3.11.rst:1699 msgid "" "Removed :opcode:`!COPY_DICT_WITHOUT_KEYS`, :opcode:`!GEN_START`, :opcode:`!" "POP_BLOCK`, :opcode:`!SETUP_FINALLY` and :opcode:`!YIELD_FROM`." msgstr "" -#: whatsnew/3.11.rst:2565 +#: whatsnew/3.11.rst:2580 msgid "Deprecated" msgstr "" -#: whatsnew/3.11.rst:1694 +#: whatsnew/3.11.rst:1709 msgid "" "This section lists Python APIs that have been deprecated in Python 3.11." msgstr "" -#: whatsnew/3.11.rst:1696 +#: whatsnew/3.11.rst:1711 msgid "" "Deprecated C APIs are :ref:`listed separately `." msgstr "" -#: whatsnew/3.11.rst:1703 +#: whatsnew/3.11.rst:1718 msgid "Language/Builtins" msgstr "" -#: whatsnew/3.11.rst:1705 +#: whatsnew/3.11.rst:1720 msgid "" "Chaining :class:`classmethod` descriptors (introduced in :issue:`19072`) is " "now deprecated. It can no longer be used to wrap other descriptors such as :" @@ -2359,7 +2375,7 @@ msgid "" "3.10. (Contributed by Raymond Hettinger in :gh:`89519`.)" msgstr "" -#: whatsnew/3.11.rst:1713 +#: whatsnew/3.11.rst:1728 msgid "" "Octal escapes in string and bytes literals with values larger than ``0o377`` " "(255 in decimal) now produce a :exc:`DeprecationWarning`. In a future Python " @@ -2367,7 +2383,7 @@ msgid "" "`SyntaxError`. (Contributed by Serhiy Storchaka in :gh:`81548`.)" msgstr "" -#: whatsnew/3.11.rst:1719 +#: whatsnew/3.11.rst:1734 msgid "" "The delegation of :func:`int` to :meth:`~object.__trunc__` is now " "deprecated. Calling ``int(a)`` when ``type(a)`` implements :meth:`!" @@ -2376,99 +2392,99 @@ msgid "" "`44977`.)" msgstr "" -#: whatsnew/3.11.rst:1729 +#: whatsnew/3.11.rst:1744 msgid "Modules" msgstr "" -#: whatsnew/3.11.rst:1733 +#: whatsnew/3.11.rst:1748 msgid "" ":pep:`594` led to the deprecations of the following modules slated for " "removal in Python 3.13:" msgstr "" -#: whatsnew/3.11.rst:1737 +#: whatsnew/3.11.rst:1752 msgid ":mod:`aifc`" msgstr "" -#: whatsnew/3.11.rst:1737 +#: whatsnew/3.11.rst:1752 msgid ":mod:`chunk`" msgstr "" -#: whatsnew/3.11.rst:1737 +#: whatsnew/3.11.rst:1752 msgid ":mod:`msilib`" msgstr "" -#: whatsnew/3.11.rst:1737 +#: whatsnew/3.11.rst:1752 msgid ":mod:`pipes`" msgstr "" -#: whatsnew/3.11.rst:1737 +#: whatsnew/3.11.rst:1752 msgid ":mod:`telnetlib`" msgstr "" -#: whatsnew/3.11.rst:1739 +#: whatsnew/3.11.rst:1754 msgid ":mod:`audioop`" msgstr "" -#: whatsnew/3.11.rst:1739 +#: whatsnew/3.11.rst:1754 msgid ":mod:`crypt`" msgstr "" -#: whatsnew/3.11.rst:1739 +#: whatsnew/3.11.rst:1754 msgid ":mod:`nis`" msgstr "" -#: whatsnew/3.11.rst:1739 +#: whatsnew/3.11.rst:1754 msgid ":mod:`sndhdr`" msgstr "" -#: whatsnew/3.11.rst:1739 +#: whatsnew/3.11.rst:1754 msgid ":mod:`uu`" msgstr "" -#: whatsnew/3.11.rst:1741 +#: whatsnew/3.11.rst:1756 msgid ":mod:`cgi`" msgstr "" -#: whatsnew/3.11.rst:1741 +#: whatsnew/3.11.rst:1756 msgid ":mod:`imghdr`" msgstr "" -#: whatsnew/3.11.rst:1741 +#: whatsnew/3.11.rst:1756 msgid ":mod:`nntplib`" msgstr "" -#: whatsnew/3.11.rst:1741 +#: whatsnew/3.11.rst:1756 msgid ":mod:`spwd`" msgstr "" -#: whatsnew/3.11.rst:1741 +#: whatsnew/3.11.rst:1756 msgid ":mod:`xdrlib`" msgstr "" -#: whatsnew/3.11.rst:1743 +#: whatsnew/3.11.rst:1758 msgid ":mod:`cgitb`" msgstr "" -#: whatsnew/3.11.rst:1743 +#: whatsnew/3.11.rst:1758 msgid ":mod:`mailcap`" msgstr "" -#: whatsnew/3.11.rst:1743 +#: whatsnew/3.11.rst:1758 msgid ":mod:`ossaudiodev`" msgstr "" -#: whatsnew/3.11.rst:1743 +#: whatsnew/3.11.rst:1758 msgid ":mod:`sunau`" msgstr "" -#: whatsnew/3.11.rst:1746 +#: whatsnew/3.11.rst:1761 msgid "" "(Contributed by Brett Cannon in :issue:`47061` and Victor Stinner in :gh:" "`68966`.)" msgstr "" -#: whatsnew/3.11.rst:1749 +#: whatsnew/3.11.rst:1764 msgid "" "The :mod:`!asynchat`, :mod:`!asyncore` and :mod:`!smtpd` modules have been " "deprecated since at least Python 3.6. Their documentation and deprecation " @@ -2476,7 +2492,7 @@ msgid "" "(Contributed by Hugo van Kemenade in :issue:`47022`.)" msgstr "" -#: whatsnew/3.11.rst:1754 +#: whatsnew/3.11.rst:1769 msgid "" "The :mod:`lib2to3` package and :ref:`2to3 <2to3-reference>` tool are now " "deprecated and may not be able to parse Python 3.10 or newer. See :pep:" @@ -2484,41 +2500,41 @@ msgid "" "Stinner in :issue:`40360`.)" msgstr "" -#: whatsnew/3.11.rst:1759 +#: whatsnew/3.11.rst:1774 msgid "" "Undocumented modules :mod:`!sre_compile`, :mod:`!sre_constants` and :mod:`!" "sre_parse` are now deprecated. (Contributed by Serhiy Storchaka in :issue:" "`47152`.)" msgstr "" -#: whatsnew/3.11.rst:1767 +#: whatsnew/3.11.rst:1782 msgid "Standard Library" msgstr "" -#: whatsnew/3.11.rst:1769 +#: whatsnew/3.11.rst:1784 msgid "" "The following have been deprecated in :mod:`configparser` since Python 3.2. " "Their deprecation warnings have now been updated to note they will be " "removed in Python 3.12:" msgstr "" -#: whatsnew/3.11.rst:1773 +#: whatsnew/3.11.rst:1788 msgid "the :class:`!configparser.SafeConfigParser` class" msgstr "" -#: whatsnew/3.11.rst:1774 +#: whatsnew/3.11.rst:1789 msgid "the :attr:`!configparser.ParsingError.filename` property" msgstr "" -#: whatsnew/3.11.rst:1775 +#: whatsnew/3.11.rst:1790 msgid "the :meth:`!configparser.RawConfigParser.readfp` method" msgstr "" -#: whatsnew/3.11.rst:1777 +#: whatsnew/3.11.rst:1792 msgid "(Contributed by Hugo van Kemenade in :issue:`45173`.)" msgstr "" -#: whatsnew/3.11.rst:1779 +#: whatsnew/3.11.rst:1794 msgid "" ":class:`!configparser.LegacyInterpolation` has been deprecated in the " "docstring since Python 3.2, and is not listed in the :mod:`configparser` " @@ -2528,7 +2544,7 @@ msgid "" "Kemenade in :issue:`46607`.)" msgstr "" -#: whatsnew/3.11.rst:1786 +#: whatsnew/3.11.rst:1801 msgid "" "The older set of :mod:`importlib.resources` functions were deprecated in " "favor of the replacements added in Python 3.9 and will be removed in a " @@ -2536,35 +2552,35 @@ msgid "" "package subdirectories:" msgstr "" -#: whatsnew/3.11.rst:1791 +#: whatsnew/3.11.rst:1806 msgid ":func:`importlib.resources.contents`" msgstr "" -#: whatsnew/3.11.rst:1792 +#: whatsnew/3.11.rst:1807 msgid ":func:`importlib.resources.is_resource`" msgstr "" -#: whatsnew/3.11.rst:1793 +#: whatsnew/3.11.rst:1808 msgid ":func:`importlib.resources.open_binary`" msgstr "" -#: whatsnew/3.11.rst:1794 +#: whatsnew/3.11.rst:1809 msgid ":func:`importlib.resources.open_text`" msgstr "" -#: whatsnew/3.11.rst:1795 +#: whatsnew/3.11.rst:1810 msgid ":func:`importlib.resources.read_binary`" msgstr "" -#: whatsnew/3.11.rst:1796 +#: whatsnew/3.11.rst:1811 msgid ":func:`importlib.resources.read_text`" msgstr "" -#: whatsnew/3.11.rst:1797 +#: whatsnew/3.11.rst:1812 msgid ":func:`importlib.resources.path`" msgstr "" -#: whatsnew/3.11.rst:1799 +#: whatsnew/3.11.rst:1814 msgid "" "The :func:`locale.getdefaultlocale` function is deprecated and will be " "removed in Python 3.15. Use :func:`locale.setlocale`, :func:`locale." @@ -2572,14 +2588,14 @@ msgid "" "getlocale` functions instead. (Contributed by Victor Stinner in :gh:`90817`.)" msgstr "" -#: whatsnew/3.11.rst:1805 +#: whatsnew/3.11.rst:1820 msgid "" "The :func:`locale.resetlocale` function is deprecated and will be removed in " "Python 3.13. Use ``locale.setlocale(locale.LC_ALL, \"\")`` instead. " "(Contributed by Victor Stinner in :gh:`90817`.)" msgstr "" -#: whatsnew/3.11.rst:1809 +#: whatsnew/3.11.rst:1824 msgid "" "Stricter rules will now be applied for numerical group references and group " "names in :ref:`regular expressions `. Only sequences of ASCII " @@ -2590,7 +2606,7 @@ msgid "" "`91760`.)" msgstr "" -#: whatsnew/3.11.rst:1817 +#: whatsnew/3.11.rst:1832 msgid "" "In the :mod:`re` module, the :func:`!re.template` function and the " "corresponding :const:`!re.TEMPLATE` and :const:`!re.T` flags are deprecated, " @@ -2599,7 +2615,7 @@ msgid "" "in :gh:`92728`.)" msgstr "" -#: whatsnew/3.11.rst:1823 +#: whatsnew/3.11.rst:1838 msgid "" ":func:`turtle.settiltangle` has been deprecated since Python 3.1; it now " "emits a deprecation warning and will be removed in Python 3.13. Use :func:" @@ -2608,7 +2624,7 @@ msgid "" "issue:`45837`.)" msgstr "" -#: whatsnew/3.11.rst:1829 +#: whatsnew/3.11.rst:1844 msgid "" ":class:`typing.Text`, which exists solely to provide compatibility support " "between Python 2 and Python 3 code, is now deprecated. Its removal is " @@ -2616,347 +2632,347 @@ msgid "" "wherever possible. (Contributed by Alex Waygood in :gh:`92332`.)" msgstr "" -#: whatsnew/3.11.rst:1835 +#: whatsnew/3.11.rst:1850 msgid "" "The keyword argument syntax for constructing :data:`typing.TypedDict` types " "is now deprecated. Support will be removed in Python 3.13. (Contributed by " "Jingchen Ye in :gh:`90224`.)" msgstr "" -#: whatsnew/3.11.rst:1839 +#: whatsnew/3.11.rst:1854 msgid "" ":class:`!webbrowser.MacOSX` is deprecated and will be removed in Python " "3.13. It is untested, undocumented, and not used by :mod:`webbrowser` " "itself. (Contributed by Donghee Na in :issue:`42255`.)" msgstr "" -#: whatsnew/3.11.rst:1843 +#: whatsnew/3.11.rst:1858 msgid "" "The behavior of returning a value from a :class:`~unittest.TestCase` and :" "class:`~unittest.IsolatedAsyncioTestCase` test methods (other than the " "default ``None`` value) is now deprecated." msgstr "" -#: whatsnew/3.11.rst:1847 +#: whatsnew/3.11.rst:1862 msgid "" "Deprecated the following not-formally-documented :mod:`unittest` functions, " "scheduled for removal in Python 3.13:" msgstr "" -#: whatsnew/3.11.rst:1850 +#: whatsnew/3.11.rst:1865 msgid ":func:`!unittest.findTestCases`" msgstr "" -#: whatsnew/3.11.rst:1851 +#: whatsnew/3.11.rst:1866 msgid ":func:`!unittest.makeSuite`" msgstr "" -#: whatsnew/3.11.rst:1852 +#: whatsnew/3.11.rst:1867 msgid ":func:`!unittest.getTestCaseNames`" msgstr "" -#: whatsnew/3.11.rst:1854 +#: whatsnew/3.11.rst:1869 msgid "Use :class:`~unittest.TestLoader` methods instead:" msgstr "" -#: whatsnew/3.11.rst:1856 +#: whatsnew/3.11.rst:1871 msgid ":meth:`unittest.TestLoader.loadTestsFromModule`" msgstr "" -#: whatsnew/3.11.rst:1857 +#: whatsnew/3.11.rst:1872 msgid ":meth:`unittest.TestLoader.loadTestsFromTestCase`" msgstr "" -#: whatsnew/3.11.rst:1858 +#: whatsnew/3.11.rst:1873 msgid ":meth:`unittest.TestLoader.getTestCaseNames`" msgstr "" -#: whatsnew/3.11.rst:1860 +#: whatsnew/3.11.rst:1875 msgid "(Contributed by Erlend E. Aasland in :issue:`5846`.)" msgstr "" -#: whatsnew/3.11.rst:1862 +#: whatsnew/3.11.rst:1877 msgid "" ":meth:`!unittest.TestProgram.usageExit` is marked deprecated, to be removed " "in 3.13. (Contributed by Carlos Damázio in :gh:`67048`.)" msgstr "" -#: whatsnew/3.11.rst:2593 +#: whatsnew/3.11.rst:2608 msgid "Pending Removal in Python 3.12" msgstr "" -#: whatsnew/3.11.rst:1873 +#: whatsnew/3.11.rst:1888 msgid "" "The following Python APIs have been deprecated in earlier Python releases, " "and will be removed in Python 3.12." msgstr "" -#: whatsnew/3.11.rst:1876 +#: whatsnew/3.11.rst:1891 msgid "" "C APIs pending removal are :ref:`listed separately `." msgstr "" -#: whatsnew/3.11.rst:1879 +#: whatsnew/3.11.rst:1894 msgid "The :mod:`!asynchat` module" msgstr "" -#: whatsnew/3.11.rst:1880 +#: whatsnew/3.11.rst:1895 msgid "The :mod:`!asyncore` module" msgstr "" -#: whatsnew/3.11.rst:1881 +#: whatsnew/3.11.rst:1896 msgid "The :ref:`entire distutils package `" msgstr "" -#: whatsnew/3.11.rst:1882 +#: whatsnew/3.11.rst:1897 msgid "The :mod:`!imp` module" msgstr "" -#: whatsnew/3.11.rst:1883 +#: whatsnew/3.11.rst:1898 msgid "The :class:`typing.io ` namespace" msgstr "" -#: whatsnew/3.11.rst:1884 +#: whatsnew/3.11.rst:1899 msgid "The :class:`typing.re ` namespace" msgstr "" -#: whatsnew/3.11.rst:1885 +#: whatsnew/3.11.rst:1900 msgid ":func:`!cgi.log`" msgstr "" -#: whatsnew/3.11.rst:1886 +#: whatsnew/3.11.rst:1901 msgid ":func:`!importlib.find_loader`" msgstr "" -#: whatsnew/3.11.rst:1887 +#: whatsnew/3.11.rst:1902 msgid ":meth:`!importlib.abc.Loader.module_repr`" msgstr "" -#: whatsnew/3.11.rst:1888 +#: whatsnew/3.11.rst:1903 msgid ":meth:`!importlib.abc.MetaPathFinder.find_module`" msgstr "" -#: whatsnew/3.11.rst:1889 +#: whatsnew/3.11.rst:1904 msgid ":meth:`!importlib.abc.PathEntryFinder.find_loader`" msgstr "" -#: whatsnew/3.11.rst:1890 +#: whatsnew/3.11.rst:1905 msgid ":meth:`!importlib.abc.PathEntryFinder.find_module`" msgstr "" -#: whatsnew/3.11.rst:1891 +#: whatsnew/3.11.rst:1906 msgid ":meth:`!importlib.machinery.BuiltinImporter.find_module`" msgstr "" -#: whatsnew/3.11.rst:1892 +#: whatsnew/3.11.rst:1907 msgid ":meth:`!importlib.machinery.BuiltinLoader.module_repr`" msgstr "" -#: whatsnew/3.11.rst:1893 +#: whatsnew/3.11.rst:1908 msgid ":meth:`!importlib.machinery.FileFinder.find_loader`" msgstr "" -#: whatsnew/3.11.rst:1894 +#: whatsnew/3.11.rst:1909 msgid ":meth:`!importlib.machinery.FileFinder.find_module`" msgstr "" -#: whatsnew/3.11.rst:1895 +#: whatsnew/3.11.rst:1910 msgid ":meth:`!importlib.machinery.FrozenImporter.find_module`" msgstr "" -#: whatsnew/3.11.rst:1896 +#: whatsnew/3.11.rst:1911 msgid ":meth:`!importlib.machinery.FrozenLoader.module_repr`" msgstr "" -#: whatsnew/3.11.rst:1897 +#: whatsnew/3.11.rst:1912 msgid ":meth:`!importlib.machinery.PathFinder.find_module`" msgstr "" -#: whatsnew/3.11.rst:1898 +#: whatsnew/3.11.rst:1913 msgid ":meth:`!importlib.machinery.WindowsRegistryFinder.find_module`" msgstr "" -#: whatsnew/3.11.rst:1899 +#: whatsnew/3.11.rst:1914 msgid ":func:`!importlib.util.module_for_loader`" msgstr "" -#: whatsnew/3.11.rst:1900 +#: whatsnew/3.11.rst:1915 msgid ":func:`!importlib.util.set_loader_wrapper`" msgstr "" -#: whatsnew/3.11.rst:1901 +#: whatsnew/3.11.rst:1916 msgid ":func:`!importlib.util.set_package_wrapper`" msgstr "" -#: whatsnew/3.11.rst:1902 +#: whatsnew/3.11.rst:1917 msgid ":class:`!pkgutil.ImpImporter`" msgstr "" -#: whatsnew/3.11.rst:1903 +#: whatsnew/3.11.rst:1918 msgid ":class:`!pkgutil.ImpLoader`" msgstr "" -#: whatsnew/3.11.rst:1904 +#: whatsnew/3.11.rst:1919 msgid ":meth:`!pathlib.Path.link_to`" msgstr "" -#: whatsnew/3.11.rst:1905 +#: whatsnew/3.11.rst:1920 msgid ":func:`!sqlite3.enable_shared_cache`" msgstr "" -#: whatsnew/3.11.rst:1906 +#: whatsnew/3.11.rst:1921 msgid ":func:`!sqlite3.OptimizedUnicode`" msgstr "" -#: whatsnew/3.11.rst:1907 +#: whatsnew/3.11.rst:1922 msgid ":envvar:`!PYTHONTHREADDEBUG` environment variable" msgstr "" -#: whatsnew/3.11.rst:1908 +#: whatsnew/3.11.rst:1923 msgid "The following deprecated aliases in :mod:`unittest`:" msgstr "" -#: whatsnew/3.11.rst:1911 +#: whatsnew/3.11.rst:1926 msgid "Deprecated alias" msgstr "" -#: whatsnew/3.11.rst:1911 +#: whatsnew/3.11.rst:1926 msgid "Method Name" msgstr "" -#: whatsnew/3.11.rst:1911 +#: whatsnew/3.11.rst:1926 msgid "Deprecated in" msgstr "" -#: whatsnew/3.11.rst:1913 +#: whatsnew/3.11.rst:1928 msgid "``failUnless``" msgstr "" -#: whatsnew/3.11.rst:1920 +#: whatsnew/3.11.rst:1935 msgid ":meth:`.assertTrue`" msgstr "" -#: whatsnew/3.11.rst:1914 whatsnew/3.11.rst:1916 whatsnew/3.11.rst:1918 -#: whatsnew/3.11.rst:1919 +#: whatsnew/3.11.rst:1929 whatsnew/3.11.rst:1931 whatsnew/3.11.rst:1933 +#: whatsnew/3.11.rst:1934 msgid "3.1" msgstr "" -#: whatsnew/3.11.rst:1914 +#: whatsnew/3.11.rst:1929 msgid "``failIf``" msgstr "" -#: whatsnew/3.11.rst:1914 +#: whatsnew/3.11.rst:1929 msgid ":meth:`.assertFalse`" msgstr "" -#: whatsnew/3.11.rst:1915 +#: whatsnew/3.11.rst:1930 msgid "``failUnlessEqual``" msgstr "" -#: whatsnew/3.11.rst:1921 +#: whatsnew/3.11.rst:1936 msgid ":meth:`.assertEqual`" msgstr "" -#: whatsnew/3.11.rst:1916 +#: whatsnew/3.11.rst:1931 msgid "``failIfEqual``" msgstr "" -#: whatsnew/3.11.rst:1922 +#: whatsnew/3.11.rst:1937 msgid ":meth:`.assertNotEqual`" msgstr "" -#: whatsnew/3.11.rst:1917 +#: whatsnew/3.11.rst:1932 msgid "``failUnlessAlmostEqual``" msgstr "" -#: whatsnew/3.11.rst:1923 +#: whatsnew/3.11.rst:1938 msgid ":meth:`.assertAlmostEqual`" msgstr "" -#: whatsnew/3.11.rst:1918 +#: whatsnew/3.11.rst:1933 msgid "``failIfAlmostEqual``" msgstr "" -#: whatsnew/3.11.rst:1924 +#: whatsnew/3.11.rst:1939 msgid ":meth:`.assertNotAlmostEqual`" msgstr "" -#: whatsnew/3.11.rst:1919 +#: whatsnew/3.11.rst:1934 msgid "``failUnlessRaises``" msgstr "" -#: whatsnew/3.11.rst:1919 +#: whatsnew/3.11.rst:1934 msgid ":meth:`.assertRaises`" msgstr "" -#: whatsnew/3.11.rst:1920 +#: whatsnew/3.11.rst:1935 msgid "``assert_``" msgstr "" -#: whatsnew/3.11.rst:1921 whatsnew/3.11.rst:1923 whatsnew/3.11.rst:1925 -#: whatsnew/3.11.rst:1926 +#: whatsnew/3.11.rst:1936 whatsnew/3.11.rst:1938 whatsnew/3.11.rst:1940 +#: whatsnew/3.11.rst:1941 msgid "3.2" msgstr "" -#: whatsnew/3.11.rst:1921 +#: whatsnew/3.11.rst:1936 msgid "``assertEquals``" msgstr "" -#: whatsnew/3.11.rst:1922 +#: whatsnew/3.11.rst:1937 msgid "``assertNotEquals``" msgstr "" -#: whatsnew/3.11.rst:1923 +#: whatsnew/3.11.rst:1938 msgid "``assertAlmostEquals``" msgstr "" -#: whatsnew/3.11.rst:1924 +#: whatsnew/3.11.rst:1939 msgid "``assertNotAlmostEquals``" msgstr "" -#: whatsnew/3.11.rst:1925 +#: whatsnew/3.11.rst:1940 msgid "``assertRegexpMatches``" msgstr "" -#: whatsnew/3.11.rst:1925 +#: whatsnew/3.11.rst:1940 msgid ":meth:`.assertRegex`" msgstr "" -#: whatsnew/3.11.rst:1926 +#: whatsnew/3.11.rst:1941 msgid "``assertRaisesRegexp``" msgstr "" -#: whatsnew/3.11.rst:1926 +#: whatsnew/3.11.rst:1941 msgid ":meth:`.assertRaisesRegex`" msgstr "" -#: whatsnew/3.11.rst:1927 +#: whatsnew/3.11.rst:1942 msgid "``assertNotRegexpMatches``" msgstr "" -#: whatsnew/3.11.rst:1927 +#: whatsnew/3.11.rst:1942 msgid ":meth:`.assertNotRegex`" msgstr "" -#: whatsnew/3.11.rst:1927 +#: whatsnew/3.11.rst:1942 msgid "3.5" msgstr "" -#: whatsnew/3.11.rst:2619 +#: whatsnew/3.11.rst:2634 msgid "Removed" msgstr "" -#: whatsnew/3.11.rst:1936 +#: whatsnew/3.11.rst:1951 msgid "This section lists Python APIs that have been removed in Python 3.11." msgstr "" -#: whatsnew/3.11.rst:1938 +#: whatsnew/3.11.rst:1953 msgid "" "Removed C APIs are :ref:`listed separately `." msgstr "" -#: whatsnew/3.11.rst:1940 +#: whatsnew/3.11.rst:1955 msgid "" "Removed the :func:`!@asyncio.coroutine` :term:`decorator` enabling legacy " "generator-based coroutines to be compatible with :keyword:`async` / :keyword:" @@ -2965,14 +2981,14 @@ msgid "" "instead. (Contributed by Illia Volochii in :issue:`43216`.)" msgstr "" -#: whatsnew/3.11.rst:1947 +#: whatsnew/3.11.rst:1962 msgid "" "Removed :class:`!asyncio.coroutines.CoroWrapper` used for wrapping legacy " "generator-based coroutine objects in the debug mode. (Contributed by Illia " "Volochii in :issue:`43216`.)" msgstr "" -#: whatsnew/3.11.rst:1951 +#: whatsnew/3.11.rst:1966 msgid "" "Due to significant security concerns, the *reuse_address* parameter of :meth:" "`asyncio.loop.create_datagram_endpoint`, disabled in Python 3.9, is now " @@ -2981,44 +2997,44 @@ msgid "" "`45129`.)" msgstr "" -#: whatsnew/3.11.rst:1957 +#: whatsnew/3.11.rst:1972 msgid "" "Removed the :mod:`!binhex` module, deprecated in Python 3.9. Also removed " "the related, similarly-deprecated :mod:`binascii` functions:" msgstr "" -#: whatsnew/3.11.rst:1960 +#: whatsnew/3.11.rst:1975 msgid ":func:`!binascii.a2b_hqx`" msgstr "" -#: whatsnew/3.11.rst:1961 +#: whatsnew/3.11.rst:1976 msgid ":func:`!binascii.b2a_hqx`" msgstr "" -#: whatsnew/3.11.rst:1962 +#: whatsnew/3.11.rst:1977 msgid ":func:`!binascii.rlecode_hqx`" msgstr "" -#: whatsnew/3.11.rst:1963 +#: whatsnew/3.11.rst:1978 msgid ":func:`!binascii.rldecode_hqx`" msgstr "" -#: whatsnew/3.11.rst:1965 +#: whatsnew/3.11.rst:1980 msgid "The :func:`binascii.crc_hqx` function remains available." msgstr "" -#: whatsnew/3.11.rst:1967 +#: whatsnew/3.11.rst:1982 msgid "(Contributed by Victor Stinner in :issue:`45085`.)" msgstr "" -#: whatsnew/3.11.rst:1969 +#: whatsnew/3.11.rst:1984 msgid "" "Removed the :mod:`!distutils` ``bdist_msi`` command deprecated in Python " "3.9. Use ``bdist_wheel`` (wheel packages) instead. (Contributed by Hugo van " "Kemenade in :issue:`45124`.)" msgstr "" -#: whatsnew/3.11.rst:1973 +#: whatsnew/3.11.rst:1988 msgid "" "Removed the :meth:`~object.__getitem__` methods of :class:`xml.dom.pulldom." "DOMEventStream`, :class:`wsgiref.util.FileWrapper` and :class:`fileinput." @@ -3026,7 +3042,7 @@ msgid "" "in :issue:`45132`.)" msgstr "" -#: whatsnew/3.11.rst:1978 +#: whatsnew/3.11.rst:1993 msgid "" "Removed the deprecated :mod:`gettext` functions :func:`!lgettext`, :func:`!" "ldgettext`, :func:`!lngettext` and :func:`!ldngettext`. Also removed the :" @@ -3037,62 +3053,62 @@ msgid "" "by Donghee Na and Serhiy Storchaka in :issue:`44235`.)" msgstr "" -#: whatsnew/3.11.rst:1988 +#: whatsnew/3.11.rst:2003 msgid "Removed from the :mod:`inspect` module:" msgstr "" -#: whatsnew/3.11.rst:1990 +#: whatsnew/3.11.rst:2005 msgid "" "The :func:`!getargspec` function, deprecated since Python 3.0; use :func:" "`inspect.signature` or :func:`inspect.getfullargspec` instead." msgstr "" -#: whatsnew/3.11.rst:1993 +#: whatsnew/3.11.rst:2008 msgid "" "The :func:`!formatargspec` function, deprecated since Python 3.5; use the :" "func:`inspect.signature` function or the :class:`inspect.Signature` object " "directly." msgstr "" -#: whatsnew/3.11.rst:1997 +#: whatsnew/3.11.rst:2012 msgid "" "The undocumented :meth:`!Signature.from_builtin` and :meth:`!Signature." "from_function` methods, deprecated since Python 3.5; use the :meth:" "`Signature.from_callable() ` method instead." msgstr "" -#: whatsnew/3.11.rst:2002 +#: whatsnew/3.11.rst:2017 msgid "(Contributed by Hugo van Kemenade in :issue:`45320`.)" msgstr "" -#: whatsnew/3.11.rst:2004 +#: whatsnew/3.11.rst:2019 msgid "" "Removed the :meth:`~object.__class_getitem__` method from :class:`pathlib." "PurePath`, because it was not used and added by mistake in previous " "versions. (Contributed by Nikita Sobolev in :issue:`46483`.)" msgstr "" -#: whatsnew/3.11.rst:2009 +#: whatsnew/3.11.rst:2024 msgid "" "Removed the :class:`!MailmanProxy` class in the :mod:`!smtpd` module, as it " "is unusable without the external :mod:`!mailman` package. (Contributed by " "Donghee Na in :issue:`35800`.)" msgstr "" -#: whatsnew/3.11.rst:2013 +#: whatsnew/3.11.rst:2028 msgid "" "Removed the deprecated :meth:`!split` method of :class:`!_tkinter." "TkappType`. (Contributed by Erlend E. Aasland in :issue:`38371`.)" msgstr "" -#: whatsnew/3.11.rst:2016 +#: whatsnew/3.11.rst:2031 msgid "" "Removed namespace package support from :mod:`unittest` discovery. It was " "introduced in Python 3.4 but has been broken since Python 3.7. (Contributed " "by Inada Naoki in :issue:`23882`.)" msgstr "" -#: whatsnew/3.11.rst:2020 +#: whatsnew/3.11.rst:2035 msgid "" "Removed the undocumented private :meth:`!float.__set_format__()` method, " "previously known as :meth:`!float.__setformat__()` in Python 3.7. Its " @@ -3101,37 +3117,37 @@ msgid "" "in :issue:`46852`.)" msgstr "" -#: whatsnew/3.11.rst:2026 +#: whatsnew/3.11.rst:2041 msgid "" "The :option:`!--experimental-isolated-subinterpreters` configure flag (and " "corresponding :c:macro:`!EXPERIMENTAL_ISOLATED_SUBINTERPRETERS` macro) have " "been removed." msgstr "" -#: whatsnew/3.11.rst:2030 +#: whatsnew/3.11.rst:2045 msgid "" ":pypi:`Pynche` --- The Pythonically Natural Color and Hue Editor --- has " "been moved out of ``Tools/scripts`` and is `being developed independently " "`_ from the Python source tree." msgstr "" -#: whatsnew/3.11.rst:2262 +#: whatsnew/3.11.rst:2277 msgid "Porting to Python 3.11" msgstr "" -#: whatsnew/3.11.rst:2042 +#: whatsnew/3.11.rst:2057 msgid "" "This section lists previously described changes and other bugfixes in the " "Python API that may require changes to your Python code." msgstr "" -#: whatsnew/3.11.rst:2045 +#: whatsnew/3.11.rst:2060 msgid "" "Porting notes for the C API are :ref:`listed separately `." msgstr "" -#: whatsnew/3.11.rst:2048 +#: whatsnew/3.11.rst:2063 msgid "" ":func:`open`, :func:`io.open`, :func:`codecs.open` and :class:`fileinput." "FileInput` no longer accept ``'U'`` (\"universal newline\") in the file " @@ -3142,7 +3158,7 @@ msgid "" "Stinner in :issue:`37330`.)" msgstr "" -#: whatsnew/3.11.rst:2057 +#: whatsnew/3.11.rst:2072 msgid "" ":class:`ast.AST` node positions are now validated when provided to :func:" "`compile` and other related functions. If invalid positions are detected, a :" @@ -3150,14 +3166,14 @@ msgid "" "`93351`)" msgstr "" -#: whatsnew/3.11.rst:2061 +#: whatsnew/3.11.rst:2076 msgid "" "Prohibited passing non-:class:`concurrent.futures.ThreadPoolExecutor` " "executors to :meth:`asyncio.loop.set_default_executor` following a " "deprecation in Python 3.8. (Contributed by Illia Volochii in :issue:`43234`.)" msgstr "" -#: whatsnew/3.11.rst:2066 +#: whatsnew/3.11.rst:2081 msgid "" ":mod:`calendar`: The :class:`calendar.LocaleTextCalendar` and :class:" "`calendar.LocaleHTMLCalendar` classes now use :func:`locale.getlocale`, " @@ -3165,14 +3181,14 @@ msgid "" "(Contributed by Victor Stinner in :issue:`46659`.)" msgstr "" -#: whatsnew/3.11.rst:2072 +#: whatsnew/3.11.rst:2087 msgid "" "The :mod:`pdb` module now reads the :file:`.pdbrc` configuration file with " "the ``'UTF-8'`` encoding. (Contributed by Srinivas Reddy Thatiparthy (శ్రీనివాస్ " "రెడ్డి తాటిపర్తి) in :issue:`41137`.)" msgstr "" -#: whatsnew/3.11.rst:2076 +#: whatsnew/3.11.rst:2091 msgid "" "The *population* parameter of :func:`random.sample` must be a sequence, and " "automatic conversion of :class:`set`\\s to :class:`list`\\s is no longer " @@ -3181,14 +3197,14 @@ msgid "" "`40465`.)" msgstr "" -#: whatsnew/3.11.rst:2082 +#: whatsnew/3.11.rst:2097 msgid "" "The *random* optional parameter of :func:`random.shuffle` was removed. It " "was previously an arbitrary random function to use for the shuffle; now, :" "func:`random.random` (its previous default) will always be used." msgstr "" -#: whatsnew/3.11.rst:2086 +#: whatsnew/3.11.rst:2101 msgid "" "In :mod:`re` :ref:`re-syntax`, global inline flags (e.g. ``(?i)``) can now " "only be used at the start of regular expressions. Using them elsewhere has " @@ -3196,7 +3212,7 @@ msgid "" "`47066`.)" msgstr "" -#: whatsnew/3.11.rst:2091 +#: whatsnew/3.11.rst:2106 msgid "" "In the :mod:`re` module, several long-standing bugs where fixed that, in " "rare cases, could cause capture groups to get the wrong result. Therefore, " @@ -3204,11 +3220,11 @@ msgid "" "in :issue:`35859`.)" msgstr "" -#: whatsnew/3.11.rst:2100 +#: whatsnew/3.11.rst:2115 msgid "Build Changes" msgstr "" -#: whatsnew/3.11.rst:2102 +#: whatsnew/3.11.rst:2117 msgid "" "CPython now has :pep:`11` :pep:`Tier 3 support <11#tier-3>` for cross " "compiling to the `WebAssembly `_ platforms " @@ -3223,11 +3239,11 @@ msgid "" "gh:`90473`; platforms promoted in :gh:`95085`)" msgstr "" -#: whatsnew/3.11.rst:2116 +#: whatsnew/3.11.rst:2131 msgid "Building CPython now requires:" msgstr "" -#: whatsnew/3.11.rst:2118 +#: whatsnew/3.11.rst:2133 msgid "" "A `C11 `_ compiler and standard library. " "`Optional C11 features `_ floating " +"Support for `IEEE 754 `_ floating-" "point numbers. (Contributed by Victor Stinner in :issue:`46917`.)" msgstr "" -#: whatsnew/3.11.rst:2129 +#: whatsnew/3.11.rst:2144 msgid "" "The :c:macro:`!Py_NO_NAN` macro has been removed. Since CPython now requires " "IEEE 754 floats, NaN values are always available. (Contributed by Victor " "Stinner in :issue:`46656`.)" msgstr "" -#: whatsnew/3.11.rst:2133 +#: whatsnew/3.11.rst:2148 msgid "" "The :mod:`tkinter` package now requires `Tcl/Tk `_ " "version 8.5.12 or newer. (Contributed by Serhiy Storchaka in :issue:`46996`.)" msgstr "" -#: whatsnew/3.11.rst:2137 +#: whatsnew/3.11.rst:2152 msgid "" "Build dependencies, compiler flags, and linker flags for most stdlib " "extension modules are now detected by :program:`configure`. libffi, libnsl, " @@ -3267,13 +3283,13 @@ msgid "" "`45847`, :issue:`45747`, and :issue:`45763`.)" msgstr "" -#: whatsnew/3.11.rst:2147 +#: whatsnew/3.11.rst:2162 msgid "" "libpython is no longer linked against libcrypt. (Contributed by Mike Gilbert " "in :issue:`45433`.)" msgstr "" -#: whatsnew/3.11.rst:2150 +#: whatsnew/3.11.rst:2165 msgid "" "CPython can now be built with the `ThinLTO `_ option via passing ``thin`` to :option:`--with-lto`, i.e. " @@ -3281,7 +3297,7 @@ msgid "" "`44340`.)" msgstr "" -#: whatsnew/3.11.rst:2155 +#: whatsnew/3.11.rst:2170 msgid "" "Freelists for object structs can now be disabled. A new :program:`configure` " "option :option:`--without-freelists` can be used to disable all freelists " @@ -3289,7 +3305,7 @@ msgid "" "`45522`.)" msgstr "" -#: whatsnew/3.11.rst:2160 +#: whatsnew/3.11.rst:2175 msgid "" "``Modules/Setup`` and ``Modules/makesetup`` have been improved and tied up. " "Extension modules can now be built through ``makesetup``. All except some " @@ -3298,7 +3314,7 @@ msgid "" "`45570`, :issue:`45571`, and :issue:`43974`.)" msgstr "" -#: whatsnew/3.11.rst:2167 +#: whatsnew/3.11.rst:2182 msgid "" "Use the environment variables :envvar:`!TCLTK_CFLAGS` and :envvar:`!" "TCLTK_LIBS` to manually specify the location of Tcl/Tk headers and " @@ -3306,7 +3322,7 @@ msgid "" "and :option:`!--with-tcltk-libs` have been removed." msgstr "" -#: whatsnew/3.11.rst:2173 +#: whatsnew/3.11.rst:2188 msgid "" "On RHEL 7 and CentOS 7 the development packages do not provide ``tcl.pc`` " "and ``tk.pc``; use ``TCLTK_LIBS=\"-ltk8.5 -ltkstub8.5 -ltcl8.5\"``. The " @@ -3314,7 +3330,7 @@ msgid "" "build Python with RHEL 7's and CentOS 7's Tcl/Tk and OpenSSL." msgstr "" -#: whatsnew/3.11.rst:2178 +#: whatsnew/3.11.rst:2193 msgid "" "CPython will now use 30-bit digits by default for the Python :class:`int` " "implementation. Previously, the default was to use 30-bit digits on " @@ -3326,23 +3342,23 @@ msgid "" "in :issue:`45569`.)" msgstr "" -#: whatsnew/3.11.rst:2191 +#: whatsnew/3.11.rst:2206 msgid "C API Changes" msgstr "" -#: whatsnew/3.11.rst:2198 +#: whatsnew/3.11.rst:2213 msgid "" "Add a new :c:func:`PyType_GetName` function to get type's short name. " "(Contributed by Hai Shi in :issue:`42035`.)" msgstr "" -#: whatsnew/3.11.rst:2201 +#: whatsnew/3.11.rst:2216 msgid "" "Add a new :c:func:`PyType_GetQualName` function to get type's qualified " "name. (Contributed by Hai Shi in :issue:`42035`.)" msgstr "" -#: whatsnew/3.11.rst:2204 +#: whatsnew/3.11.rst:2219 msgid "" "Add new :c:func:`PyThreadState_EnterTracing` and :c:func:" "`PyThreadState_LeaveTracing` functions to the limited C API to suspend and " @@ -3350,78 +3366,78 @@ msgid "" "`43760`.)" msgstr "" -#: whatsnew/3.11.rst:2209 +#: whatsnew/3.11.rst:2224 msgid "" "Added the :c:data:`Py_Version` constant which bears the same value as :c:" "macro:`PY_VERSION_HEX`. (Contributed by Gabriele N. Tornetta in :issue:" "`43931`.)" msgstr "" -#: whatsnew/3.11.rst:2213 +#: whatsnew/3.11.rst:2228 msgid "" ":c:type:`Py_buffer` and APIs are now part of the limited API and the stable " "ABI:" msgstr "" -#: whatsnew/3.11.rst:2216 +#: whatsnew/3.11.rst:2231 msgid ":c:func:`PyObject_CheckBuffer`" msgstr "" -#: whatsnew/3.11.rst:2217 +#: whatsnew/3.11.rst:2232 msgid ":c:func:`PyObject_GetBuffer`" msgstr "" -#: whatsnew/3.11.rst:2218 +#: whatsnew/3.11.rst:2233 msgid ":c:func:`PyBuffer_GetPointer`" msgstr "" -#: whatsnew/3.11.rst:2219 +#: whatsnew/3.11.rst:2234 msgid ":c:func:`PyBuffer_SizeFromFormat`" msgstr "" -#: whatsnew/3.11.rst:2220 +#: whatsnew/3.11.rst:2235 msgid ":c:func:`PyBuffer_ToContiguous`" msgstr "" -#: whatsnew/3.11.rst:2221 +#: whatsnew/3.11.rst:2236 msgid ":c:func:`PyBuffer_FromContiguous`" msgstr "" -#: whatsnew/3.11.rst:2222 +#: whatsnew/3.11.rst:2237 msgid ":c:func:`PyObject_CopyData`" msgstr "" -#: whatsnew/3.11.rst:2223 +#: whatsnew/3.11.rst:2238 msgid ":c:func:`PyBuffer_IsContiguous`" msgstr "" -#: whatsnew/3.11.rst:2224 +#: whatsnew/3.11.rst:2239 msgid ":c:func:`PyBuffer_FillContiguousStrides`" msgstr "" -#: whatsnew/3.11.rst:2225 +#: whatsnew/3.11.rst:2240 msgid ":c:func:`PyBuffer_FillInfo`" msgstr "" -#: whatsnew/3.11.rst:2226 +#: whatsnew/3.11.rst:2241 msgid ":c:func:`PyBuffer_Release`" msgstr "" -#: whatsnew/3.11.rst:2227 +#: whatsnew/3.11.rst:2242 msgid ":c:func:`PyMemoryView_FromBuffer`" msgstr "" -#: whatsnew/3.11.rst:2228 +#: whatsnew/3.11.rst:2243 msgid "" ":c:member:`~PyBufferProcs.bf_getbuffer` and :c:member:`~PyBufferProcs." "bf_releasebuffer` type slots" msgstr "" -#: whatsnew/3.11.rst:2231 +#: whatsnew/3.11.rst:2246 msgid "(Contributed by Christian Heimes in :issue:`45459`.)" msgstr "" -#: whatsnew/3.11.rst:2233 +#: whatsnew/3.11.rst:2248 msgid "" "Added the :c:func:`PyType_GetModuleByDef` function, used to get the module " "in which a method was defined, in cases where this information is not " @@ -3429,7 +3445,7 @@ msgid "" "in :issue:`46613`.)" msgstr "" -#: whatsnew/3.11.rst:2238 +#: whatsnew/3.11.rst:2253 msgid "" "Add new functions to pack and unpack C double (serialize and deserialize): :" "c:func:`PyFloat_Pack2`, :c:func:`PyFloat_Pack4`, :c:func:`PyFloat_Pack8`, :c:" @@ -3437,14 +3453,14 @@ msgid "" "`PyFloat_Unpack8`. (Contributed by Victor Stinner in :issue:`46906`.)" msgstr "" -#: whatsnew/3.11.rst:2244 +#: whatsnew/3.11.rst:2259 msgid "" "Add new functions to get frame object attributes: :c:func:" "`PyFrame_GetBuiltins`, :c:func:`PyFrame_GetGenerator`, :c:func:" "`PyFrame_GetGlobals`, :c:func:`PyFrame_GetLasti`." msgstr "" -#: whatsnew/3.11.rst:2248 +#: whatsnew/3.11.rst:2263 msgid "" "Added two new functions to get and set the active exception instance: :c:" "func:`PyErr_GetHandledException` and :c:func:`PyErr_SetHandledException`. " @@ -3453,13 +3469,13 @@ msgid "" "exceptions. (Contributed by Irit Katriel in :issue:`46343`.)" msgstr "" -#: whatsnew/3.11.rst:2255 +#: whatsnew/3.11.rst:2270 msgid "" "Added the :c:member:`PyConfig.safe_path` member. (Contributed by Victor " "Stinner in :gh:`57684`.)" msgstr "" -#: whatsnew/3.11.rst:2266 +#: whatsnew/3.11.rst:2281 msgid "" "Some macros have been converted to static inline functions to avoid `macro " "pitfalls `_. The " @@ -3471,7 +3487,7 @@ msgid "" "Stinner and Erlend E. Aasland in :gh:`89653`.)" msgstr "" -#: whatsnew/3.11.rst:2277 +#: whatsnew/3.11.rst:2292 msgid "" ":c:func:`PyErr_SetExcInfo()` no longer uses the ``type`` and ``traceback`` " "arguments, the interpreter now derives those values from the exception " @@ -3479,14 +3495,14 @@ msgid "" "all three arguments. (Contributed by Irit Katriel in :issue:`45711`.)" msgstr "" -#: whatsnew/3.11.rst:2283 +#: whatsnew/3.11.rst:2298 msgid "" ":c:func:`PyErr_GetExcInfo()` now derives the ``type`` and ``traceback`` " "fields of the result from the exception instance (the ``value`` field). " "(Contributed by Irit Katriel in :issue:`45711`.)" msgstr "" -#: whatsnew/3.11.rst:2287 +#: whatsnew/3.11.rst:2302 msgid "" ":c:struct:`_frozen` has a new ``is_package`` field to indicate whether or " "not the frozen module is a package. Previously, a negative value in the " @@ -3494,14 +3510,14 @@ msgid "" "``size``. (Contributed by Kumar Aditya in :issue:`46608`.)" msgstr "" -#: whatsnew/3.11.rst:2293 +#: whatsnew/3.11.rst:2308 msgid "" ":c:func:`_PyFrameEvalFunction` now takes ``_PyInterpreterFrame*`` as its " "second parameter, instead of ``PyFrameObject*``. See :pep:`523` for more " "details of how to use this function pointer type." msgstr "" -#: whatsnew/3.11.rst:2297 +#: whatsnew/3.11.rst:2312 msgid "" ":c:func:`!PyCode_New` and :c:func:`!PyCode_NewWithPosOnlyArgs` now take an " "additional ``exception_table`` argument. Using these functions should be " @@ -3510,7 +3526,7 @@ msgid "" "method." msgstr "" -#: whatsnew/3.11.rst:2303 +#: whatsnew/3.11.rst:2318 msgid "" ":c:type:`PyCodeObject` no longer has the ``co_code``, ``co_varnames``, " "``co_cellvars`` and ``co_freevars`` fields. Instead, use :c:func:" @@ -3520,35 +3536,35 @@ msgid "" "and :gh:`94936`.)" msgstr "" -#: whatsnew/3.11.rst:2311 +#: whatsnew/3.11.rst:2326 msgid "" "The old trashcan macros (``Py_TRASHCAN_SAFE_BEGIN``/" "``Py_TRASHCAN_SAFE_END``) are now deprecated. They should be replaced by the " "new macros ``Py_TRASHCAN_BEGIN`` and ``Py_TRASHCAN_END``." msgstr "" -#: whatsnew/3.11.rst:2315 +#: whatsnew/3.11.rst:2330 msgid "A tp_dealloc function that has the old macros, such as::" msgstr "" -#: whatsnew/3.11.rst:2326 +#: whatsnew/3.11.rst:2341 msgid "should migrate to the new macros as follows::" msgstr "" -#: whatsnew/3.11.rst:2337 +#: whatsnew/3.11.rst:2352 msgid "" "Note that ``Py_TRASHCAN_BEGIN`` has a second argument which should be the " "deallocation function it is in." msgstr "" -#: whatsnew/3.11.rst:2340 +#: whatsnew/3.11.rst:2355 msgid "" "To support older Python versions in the same codebase, you can define the " "following macros and use them throughout the code (credit: these were copied " "from the ``mypy`` codebase)::" msgstr "" -#: whatsnew/3.11.rst:2352 +#: whatsnew/3.11.rst:2367 msgid "" "The :c:func:`PyType_Ready` function now raises an error if a type is defined " "with the :c:macro:`Py_TPFLAGS_HAVE_GC` flag set but has no traverse function " @@ -3556,7 +3572,7 @@ msgid "" "issue:`44263`.)" msgstr "" -#: whatsnew/3.11.rst:2357 +#: whatsnew/3.11.rst:2372 msgid "" "Heap types with the :c:macro:`Py_TPFLAGS_IMMUTABLETYPE` flag can now inherit " "the :pep:`590` vectorcall protocol. Previously, this was only possible for :" @@ -3564,7 +3580,7 @@ msgid "" "issue:`43908`)" msgstr "" -#: whatsnew/3.11.rst:2362 +#: whatsnew/3.11.rst:2377 msgid "" "Since :c:func:`Py_TYPE()` is changed to a inline static function, " "``Py_TYPE(obj) = new_type`` must be replaced with ``Py_SET_TYPE(obj, " @@ -3572,11 +3588,11 @@ msgid "" "Python 3.9). For backward compatibility, this macro can be used::" msgstr "" -#: whatsnew/3.11.rst:2388 +#: whatsnew/3.11.rst:2403 msgid "(Contributed by Victor Stinner in :issue:`39573`.)" msgstr "" -#: whatsnew/3.11.rst:2376 +#: whatsnew/3.11.rst:2391 msgid "" "Since :c:func:`Py_SIZE()` is changed to a inline static function, " "``Py_SIZE(obj) = new_size`` must be replaced with ``Py_SET_SIZE(obj, " @@ -3584,7 +3600,7 @@ msgid "" "Python 3.9). For backward compatibility, this macro can be used::" msgstr "" -#: whatsnew/3.11.rst:2390 +#: whatsnew/3.11.rst:2405 msgid "" "```` no longer includes the header files ````, ````, ```` and ```` when the ``Py_LIMITED_API`` macro is " @@ -3593,7 +3609,7 @@ msgid "" "(Contributed by Victor Stinner in :issue:`45434`.)" msgstr "" -#: whatsnew/3.11.rst:2396 +#: whatsnew/3.11.rst:2411 msgid "" "The non-limited API files ``cellobject.h``, ``classobject.h``, ``code.h``, " "``context.h``, ``funcobject.h``, ``genobject.h`` and ``longintrepr.h`` have " @@ -3604,7 +3620,7 @@ msgid "" "instead. (Contributed by Victor Stinner in :issue:`35134`.)" msgstr "" -#: whatsnew/3.11.rst:2404 +#: whatsnew/3.11.rst:2419 msgid "" "The :c:func:`!PyUnicode_CHECK_INTERNED` macro has been excluded from the " "limited C API. It was never usable there, because it used internal " @@ -3612,149 +3628,149 @@ msgid "" "Victor Stinner in :issue:`46007`.)" msgstr "" -#: whatsnew/3.11.rst:2409 +#: whatsnew/3.11.rst:2424 msgid "" "The following frame functions and type are now directly available with " "``#include ``, it's no longer needed to add ``#include " "``:" msgstr "" -#: whatsnew/3.11.rst:2413 +#: whatsnew/3.11.rst:2428 msgid ":c:func:`PyFrame_Check`" msgstr "" -#: whatsnew/3.11.rst:2414 +#: whatsnew/3.11.rst:2429 msgid ":c:func:`PyFrame_GetBack`" msgstr "" -#: whatsnew/3.11.rst:2415 +#: whatsnew/3.11.rst:2430 msgid ":c:func:`PyFrame_GetBuiltins`" msgstr "" -#: whatsnew/3.11.rst:2416 +#: whatsnew/3.11.rst:2431 msgid ":c:func:`PyFrame_GetGenerator`" msgstr "" -#: whatsnew/3.11.rst:2417 +#: whatsnew/3.11.rst:2432 msgid ":c:func:`PyFrame_GetGlobals`" msgstr "" -#: whatsnew/3.11.rst:2418 +#: whatsnew/3.11.rst:2433 msgid ":c:func:`PyFrame_GetLasti`" msgstr "" -#: whatsnew/3.11.rst:2419 +#: whatsnew/3.11.rst:2434 msgid ":c:func:`PyFrame_GetLocals`" msgstr "" -#: whatsnew/3.11.rst:2420 +#: whatsnew/3.11.rst:2435 msgid ":c:type:`PyFrame_Type`" msgstr "" -#: whatsnew/3.11.rst:2422 +#: whatsnew/3.11.rst:2437 msgid "(Contributed by Victor Stinner in :gh:`93937`.)" msgstr "" -#: whatsnew/3.11.rst:2426 +#: whatsnew/3.11.rst:2441 msgid "" "The :c:type:`PyFrameObject` structure members have been removed from the " "public C API." msgstr "" -#: whatsnew/3.11.rst:2429 +#: whatsnew/3.11.rst:2444 msgid "" "While the documentation notes that the :c:type:`PyFrameObject` fields are " "subject to change at any time, they have been stable for a long time and " "were used in several popular extensions." msgstr "" -#: whatsnew/3.11.rst:2433 +#: whatsnew/3.11.rst:2448 msgid "" "In Python 3.11, the frame struct was reorganized to allow performance " "optimizations. Some fields were removed entirely, as they were details of " "the old implementation." msgstr "" -#: whatsnew/3.11.rst:2437 +#: whatsnew/3.11.rst:2452 msgid ":c:type:`PyFrameObject` fields:" msgstr "" -#: whatsnew/3.11.rst:2439 +#: whatsnew/3.11.rst:2454 msgid "``f_back``: use :c:func:`PyFrame_GetBack`." msgstr "" -#: whatsnew/3.11.rst:2440 +#: whatsnew/3.11.rst:2455 msgid "``f_blockstack``: removed." msgstr "" -#: whatsnew/3.11.rst:2441 +#: whatsnew/3.11.rst:2456 msgid "``f_builtins``: use :c:func:`PyFrame_GetBuiltins`." msgstr "" -#: whatsnew/3.11.rst:2442 +#: whatsnew/3.11.rst:2457 msgid "``f_code``: use :c:func:`PyFrame_GetCode`." msgstr "" -#: whatsnew/3.11.rst:2443 +#: whatsnew/3.11.rst:2458 msgid "``f_gen``: use :c:func:`PyFrame_GetGenerator`." msgstr "" -#: whatsnew/3.11.rst:2444 +#: whatsnew/3.11.rst:2459 msgid "``f_globals``: use :c:func:`PyFrame_GetGlobals`." msgstr "" -#: whatsnew/3.11.rst:2445 +#: whatsnew/3.11.rst:2460 msgid "``f_iblock``: removed." msgstr "" -#: whatsnew/3.11.rst:2446 +#: whatsnew/3.11.rst:2461 msgid "" "``f_lasti``: use :c:func:`PyFrame_GetLasti`. Code using ``f_lasti`` with " "``PyCode_Addr2Line()`` should use :c:func:`PyFrame_GetLineNumber` instead; " "it may be faster." msgstr "" -#: whatsnew/3.11.rst:2449 +#: whatsnew/3.11.rst:2464 msgid "``f_lineno``: use :c:func:`PyFrame_GetLineNumber`" msgstr "" -#: whatsnew/3.11.rst:2450 +#: whatsnew/3.11.rst:2465 msgid "``f_locals``: use :c:func:`PyFrame_GetLocals`." msgstr "" -#: whatsnew/3.11.rst:2451 +#: whatsnew/3.11.rst:2466 msgid "``f_stackdepth``: removed." msgstr "" -#: whatsnew/3.11.rst:2452 +#: whatsnew/3.11.rst:2467 msgid "``f_state``: no public API (renamed to ``f_frame.f_state``)." msgstr "" -#: whatsnew/3.11.rst:2453 +#: whatsnew/3.11.rst:2468 msgid "``f_trace``: no public API." msgstr "" -#: whatsnew/3.11.rst:2454 +#: whatsnew/3.11.rst:2469 msgid "" "``f_trace_lines``: use ``PyObject_GetAttrString((PyObject*)frame, " "\"f_trace_lines\")``." msgstr "" -#: whatsnew/3.11.rst:2455 +#: whatsnew/3.11.rst:2470 msgid "" "``f_trace_opcodes``: use ``PyObject_GetAttrString((PyObject*)frame, " "\"f_trace_opcodes\")``." msgstr "" -#: whatsnew/3.11.rst:2456 +#: whatsnew/3.11.rst:2471 msgid "``f_localsplus``: no public API (renamed to ``f_frame.localsplus``)." msgstr "" -#: whatsnew/3.11.rst:2457 +#: whatsnew/3.11.rst:2472 msgid "``f_valuestack``: removed." msgstr "" -#: whatsnew/3.11.rst:2459 +#: whatsnew/3.11.rst:2474 msgid "" "The Python frame object is now created lazily. A side effect is that the :" "attr:`~frame.f_back` member must not be accessed directly, since its value " @@ -3762,7 +3778,7 @@ msgid "" "called instead." msgstr "" -#: whatsnew/3.11.rst:2465 +#: whatsnew/3.11.rst:2480 msgid "" "Debuggers that accessed the :attr:`~frame.f_locals` directly *must* call :c:" "func:`PyFrame_GetLocals` instead. They no longer need to call :c:func:`!" @@ -3771,71 +3787,71 @@ msgid "" "now managed by the virtual machine." msgstr "" -#: whatsnew/3.11.rst:2471 +#: whatsnew/3.11.rst:2486 msgid "Code defining ``PyFrame_GetCode()`` on Python 3.8 and older::" msgstr "" -#: whatsnew/3.11.rst:2481 +#: whatsnew/3.11.rst:2496 msgid "Code defining ``PyFrame_GetBack()`` on Python 3.8 and older::" msgstr "" -#: whatsnew/3.11.rst:2491 +#: whatsnew/3.11.rst:2506 msgid "" "Or use the `pythoncapi_compat project `__ to get these two functions on older Python versions." msgstr "" -#: whatsnew/3.11.rst:2495 +#: whatsnew/3.11.rst:2510 msgid "Changes of the :c:type:`PyThreadState` structure members:" msgstr "" -#: whatsnew/3.11.rst:2497 +#: whatsnew/3.11.rst:2512 msgid "" "``frame``: removed, use :c:func:`PyThreadState_GetFrame` (function added to " "Python 3.9 by :issue:`40429`). Warning: the function returns a :term:`strong " "reference`, need to call :c:func:`Py_XDECREF`." msgstr "" -#: whatsnew/3.11.rst:2501 +#: whatsnew/3.11.rst:2516 msgid "" "``tracing``: changed, use :c:func:`PyThreadState_EnterTracing` and :c:func:" "`PyThreadState_LeaveTracing` (functions added to Python 3.11 by :issue:" "`43760`)." msgstr "" -#: whatsnew/3.11.rst:2504 +#: whatsnew/3.11.rst:2519 msgid "" "``recursion_depth``: removed, use ``(tstate->recursion_limit - tstate-" ">recursion_remaining)`` instead." msgstr "" -#: whatsnew/3.11.rst:2506 +#: whatsnew/3.11.rst:2521 msgid "``stackcheck_counter``: removed." msgstr "" -#: whatsnew/3.11.rst:2508 +#: whatsnew/3.11.rst:2523 msgid "Code defining ``PyThreadState_GetFrame()`` on Python 3.8 and older::" msgstr "" -#: whatsnew/3.11.rst:2518 +#: whatsnew/3.11.rst:2533 msgid "" "Code defining ``PyThreadState_EnterTracing()`` and " "``PyThreadState_LeaveTracing()`` on Python 3.10 and older::" msgstr "" -#: whatsnew/3.11.rst:2544 +#: whatsnew/3.11.rst:2559 msgid "" "Or use `the pythoncapi-compat project `__ to get these functions on old Python functions." msgstr "" -#: whatsnew/3.11.rst:2548 +#: whatsnew/3.11.rst:2563 msgid "" "Distributors are encouraged to build Python with the optimized Blake2 " "library `libb2`_." msgstr "" -#: whatsnew/3.11.rst:2551 +#: whatsnew/3.11.rst:2566 msgid "" "The :c:member:`PyConfig.module_search_paths_set` field must now be set to 1 " "for initialization to use :c:member:`PyConfig.module_search_paths` to " @@ -3843,7 +3859,7 @@ msgid "" "path and replace any values added to ``module_search_paths``." msgstr "" -#: whatsnew/3.11.rst:2556 +#: whatsnew/3.11.rst:2571 msgid "" ":c:func:`PyConfig_Read` no longer calculates the initial search path, and " "will not fill any values into :c:member:`PyConfig.module_search_paths`. To " @@ -3852,177 +3868,177 @@ msgid "" "object and modify it directly." msgstr "" -#: whatsnew/3.11.rst:2567 +#: whatsnew/3.11.rst:2582 msgid "" "Deprecate the following functions to configure the Python initialization:" msgstr "" -#: whatsnew/3.11.rst:2569 +#: whatsnew/3.11.rst:2584 msgid ":c:func:`!PySys_AddWarnOptionUnicode`" msgstr "" -#: whatsnew/3.11.rst:2570 +#: whatsnew/3.11.rst:2585 msgid ":c:func:`!PySys_AddWarnOption`" msgstr "" -#: whatsnew/3.11.rst:2571 +#: whatsnew/3.11.rst:2586 msgid ":c:func:`!PySys_AddXOption`" msgstr "" -#: whatsnew/3.11.rst:2572 +#: whatsnew/3.11.rst:2587 msgid ":c:func:`!PySys_HasWarnOptions`" msgstr "" -#: whatsnew/3.11.rst:2573 +#: whatsnew/3.11.rst:2588 msgid ":c:func:`!PySys_SetArgvEx`" msgstr "" -#: whatsnew/3.11.rst:2574 +#: whatsnew/3.11.rst:2589 msgid ":c:func:`!PySys_SetArgv`" msgstr "" -#: whatsnew/3.11.rst:2575 +#: whatsnew/3.11.rst:2590 msgid ":c:func:`!PySys_SetPath`" msgstr "" -#: whatsnew/3.11.rst:2576 +#: whatsnew/3.11.rst:2591 msgid ":c:func:`!Py_SetPath`" msgstr "" -#: whatsnew/3.11.rst:2577 +#: whatsnew/3.11.rst:2592 msgid ":c:func:`!Py_SetProgramName`" msgstr "" -#: whatsnew/3.11.rst:2578 +#: whatsnew/3.11.rst:2593 msgid ":c:func:`!Py_SetPythonHome`" msgstr "" -#: whatsnew/3.11.rst:2579 +#: whatsnew/3.11.rst:2594 msgid ":c:func:`!Py_SetStandardStreamEncoding`" msgstr "" -#: whatsnew/3.11.rst:2580 +#: whatsnew/3.11.rst:2595 msgid ":c:func:`!_Py_SetProgramFullPath`" msgstr "" -#: whatsnew/3.11.rst:2582 +#: whatsnew/3.11.rst:2597 msgid "" "Use the new :c:type:`PyConfig` API of the :ref:`Python Initialization " "Configuration ` instead (:pep:`587`). (Contributed by Victor " "Stinner in :gh:`88279`.)" msgstr "" -#: whatsnew/3.11.rst:2586 +#: whatsnew/3.11.rst:2601 msgid "" "Deprecate the ``ob_shash`` member of the :c:type:`PyBytesObject`. Use :c:" "func:`PyObject_Hash` instead. (Contributed by Inada Naoki in :issue:`46864`.)" msgstr "" -#: whatsnew/3.11.rst:2595 +#: whatsnew/3.11.rst:2610 msgid "" "The following C APIs have been deprecated in earlier Python releases, and " "will be removed in Python 3.12." msgstr "" -#: whatsnew/3.11.rst:2598 +#: whatsnew/3.11.rst:2613 msgid ":c:func:`!PyUnicode_AS_DATA`" msgstr "" -#: whatsnew/3.11.rst:2599 +#: whatsnew/3.11.rst:2614 msgid ":c:func:`!PyUnicode_AS_UNICODE`" msgstr "" -#: whatsnew/3.11.rst:2600 +#: whatsnew/3.11.rst:2615 msgid ":c:func:`!PyUnicode_AsUnicodeAndSize`" msgstr "" -#: whatsnew/3.11.rst:2601 +#: whatsnew/3.11.rst:2616 msgid ":c:func:`!PyUnicode_AsUnicode`" msgstr "" -#: whatsnew/3.11.rst:2602 +#: whatsnew/3.11.rst:2617 msgid ":c:func:`!PyUnicode_FromUnicode`" msgstr "" -#: whatsnew/3.11.rst:2603 +#: whatsnew/3.11.rst:2618 msgid ":c:func:`!PyUnicode_GET_DATA_SIZE`" msgstr "" -#: whatsnew/3.11.rst:2604 +#: whatsnew/3.11.rst:2619 msgid ":c:func:`!PyUnicode_GET_SIZE`" msgstr "" -#: whatsnew/3.11.rst:2605 +#: whatsnew/3.11.rst:2620 msgid ":c:func:`!PyUnicode_GetSize`" msgstr "" -#: whatsnew/3.11.rst:2606 +#: whatsnew/3.11.rst:2621 msgid ":c:func:`!PyUnicode_IS_COMPACT`" msgstr "" -#: whatsnew/3.11.rst:2607 +#: whatsnew/3.11.rst:2622 msgid ":c:func:`!PyUnicode_IS_READY`" msgstr "" -#: whatsnew/3.11.rst:2608 +#: whatsnew/3.11.rst:2623 msgid ":c:func:`PyUnicode_READY`" msgstr "" -#: whatsnew/3.11.rst:2609 +#: whatsnew/3.11.rst:2624 msgid ":c:func:`!PyUnicode_WSTR_LENGTH`" msgstr "" -#: whatsnew/3.11.rst:2610 +#: whatsnew/3.11.rst:2625 msgid ":c:func:`!_PyUnicode_AsUnicode`" msgstr "" -#: whatsnew/3.11.rst:2611 +#: whatsnew/3.11.rst:2626 msgid ":c:macro:`!PyUnicode_WCHAR_KIND`" msgstr "" -#: whatsnew/3.11.rst:2612 +#: whatsnew/3.11.rst:2627 msgid ":c:type:`PyUnicodeObject`" msgstr "" -#: whatsnew/3.11.rst:2613 +#: whatsnew/3.11.rst:2628 msgid ":c:func:`!PyUnicode_InternImmortal`" msgstr "" -#: whatsnew/3.11.rst:2621 +#: whatsnew/3.11.rst:2636 msgid "" ":c:func:`!PyFrame_BlockSetup` and :c:func:`!PyFrame_BlockPop` have been " "removed. (Contributed by Mark Shannon in :issue:`40222`.)" msgstr "" -#: whatsnew/3.11.rst:2625 +#: whatsnew/3.11.rst:2640 msgid "Remove the following math macros using the ``errno`` variable:" msgstr "" -#: whatsnew/3.11.rst:2627 +#: whatsnew/3.11.rst:2642 msgid "``Py_ADJUST_ERANGE1()``" msgstr "" -#: whatsnew/3.11.rst:2628 +#: whatsnew/3.11.rst:2643 msgid "``Py_ADJUST_ERANGE2()``" msgstr "" -#: whatsnew/3.11.rst:2629 +#: whatsnew/3.11.rst:2644 msgid "``Py_OVERFLOWED()``" msgstr "" -#: whatsnew/3.11.rst:2630 +#: whatsnew/3.11.rst:2645 msgid "``Py_SET_ERANGE_IF_OVERFLOW()``" msgstr "" -#: whatsnew/3.11.rst:2631 +#: whatsnew/3.11.rst:2646 msgid "``Py_SET_ERRNO_ON_MATH_ERROR()``" msgstr "" -#: whatsnew/3.11.rst:2633 +#: whatsnew/3.11.rst:2648 msgid "(Contributed by Victor Stinner in :issue:`45412`.)" msgstr "" -#: whatsnew/3.11.rst:2635 +#: whatsnew/3.11.rst:2650 msgid "" "Remove ``Py_UNICODE_COPY()`` and ``Py_UNICODE_FILL()`` macros, deprecated " "since Python 3.3. Use ``PyUnicode_CopyCharacters()`` or ``memcpy()`` " @@ -4030,62 +4046,62 @@ msgid "" "(Contributed by Victor Stinner in :issue:`41123`.)" msgstr "" -#: whatsnew/3.11.rst:2640 +#: whatsnew/3.11.rst:2655 msgid "" "Remove the ``pystrhex.h`` header file. It only contains private functions. C " "extensions should only include the main ```` header file. " "(Contributed by Victor Stinner in :issue:`45434`.)" msgstr "" -#: whatsnew/3.11.rst:2644 +#: whatsnew/3.11.rst:2659 msgid "" "Remove the ``Py_FORCE_DOUBLE()`` macro. It was used by the " "``Py_IS_INFINITY()`` macro. (Contributed by Victor Stinner in :issue:" "`45440`.)" msgstr "" -#: whatsnew/3.11.rst:2648 +#: whatsnew/3.11.rst:2663 msgid "" "The following items are no longer available when :c:macro:`Py_LIMITED_API` " "is defined:" msgstr "" -#: whatsnew/3.11.rst:2651 +#: whatsnew/3.11.rst:2666 msgid ":c:func:`PyMarshal_WriteLongToFile`" msgstr "" -#: whatsnew/3.11.rst:2652 +#: whatsnew/3.11.rst:2667 msgid ":c:func:`PyMarshal_WriteObjectToFile`" msgstr "" -#: whatsnew/3.11.rst:2653 +#: whatsnew/3.11.rst:2668 msgid ":c:func:`PyMarshal_ReadObjectFromString`" msgstr "" -#: whatsnew/3.11.rst:2654 +#: whatsnew/3.11.rst:2669 msgid ":c:func:`PyMarshal_WriteObjectToString`" msgstr "" -#: whatsnew/3.11.rst:2655 +#: whatsnew/3.11.rst:2670 msgid "the ``Py_MARSHAL_VERSION`` macro" msgstr "" -#: whatsnew/3.11.rst:2657 +#: whatsnew/3.11.rst:2672 msgid "These are not part of the :ref:`limited API `." msgstr "" -#: whatsnew/3.11.rst:2659 +#: whatsnew/3.11.rst:2674 msgid "(Contributed by Victor Stinner in :issue:`45474`.)" msgstr "" -#: whatsnew/3.11.rst:2661 +#: whatsnew/3.11.rst:2676 msgid "" "Exclude :c:func:`PyWeakref_GET_OBJECT` from the limited C API. It never " "worked since the :c:type:`!PyWeakReference` structure is opaque in the " "limited C API. (Contributed by Victor Stinner in :issue:`35134`.)" msgstr "" -#: whatsnew/3.11.rst:2666 +#: whatsnew/3.11.rst:2681 msgid "" "Remove the ``PyHeapType_GET_MEMBERS()`` macro. It was exposed in the public " "C API by mistake, it must only be used by Python internally. Use the " @@ -4093,90 +4109,90 @@ msgid "" "in :issue:`40170`.)" msgstr "" -#: whatsnew/3.11.rst:2671 +#: whatsnew/3.11.rst:2686 msgid "" "Remove the ``HAVE_PY_SET_53BIT_PRECISION`` macro (moved to the internal C " "API). (Contributed by Victor Stinner in :issue:`45412`.)" msgstr "" -#: whatsnew/3.11.rst:2677 +#: whatsnew/3.11.rst:2692 msgid "" "Remove the :c:type:`Py_UNICODE` encoder APIs, as they have been deprecated " "since Python 3.3, are little used and are inefficient relative to the " "recommended alternatives." msgstr "" -#: whatsnew/3.11.rst:2682 +#: whatsnew/3.11.rst:2697 msgid "The removed functions are:" msgstr "" -#: whatsnew/3.11.rst:2684 +#: whatsnew/3.11.rst:2699 msgid ":func:`!PyUnicode_Encode`" msgstr "" -#: whatsnew/3.11.rst:2685 +#: whatsnew/3.11.rst:2700 msgid ":func:`!PyUnicode_EncodeASCII`" msgstr "" -#: whatsnew/3.11.rst:2686 +#: whatsnew/3.11.rst:2701 msgid ":func:`!PyUnicode_EncodeLatin1`" msgstr "" -#: whatsnew/3.11.rst:2687 +#: whatsnew/3.11.rst:2702 msgid ":func:`!PyUnicode_EncodeUTF7`" msgstr "" -#: whatsnew/3.11.rst:2688 +#: whatsnew/3.11.rst:2703 msgid ":func:`!PyUnicode_EncodeUTF8`" msgstr "" -#: whatsnew/3.11.rst:2689 +#: whatsnew/3.11.rst:2704 msgid ":func:`!PyUnicode_EncodeUTF16`" msgstr "" -#: whatsnew/3.11.rst:2690 +#: whatsnew/3.11.rst:2705 msgid ":func:`!PyUnicode_EncodeUTF32`" msgstr "" -#: whatsnew/3.11.rst:2691 +#: whatsnew/3.11.rst:2706 msgid ":func:`!PyUnicode_EncodeUnicodeEscape`" msgstr "" -#: whatsnew/3.11.rst:2692 +#: whatsnew/3.11.rst:2707 msgid ":func:`!PyUnicode_EncodeRawUnicodeEscape`" msgstr "" -#: whatsnew/3.11.rst:2693 +#: whatsnew/3.11.rst:2708 msgid ":func:`!PyUnicode_EncodeCharmap`" msgstr "" -#: whatsnew/3.11.rst:2694 +#: whatsnew/3.11.rst:2709 msgid ":func:`!PyUnicode_TranslateCharmap`" msgstr "" -#: whatsnew/3.11.rst:2695 +#: whatsnew/3.11.rst:2710 msgid ":func:`!PyUnicode_EncodeDecimal`" msgstr "" -#: whatsnew/3.11.rst:2696 +#: whatsnew/3.11.rst:2711 msgid ":func:`!PyUnicode_TransformDecimalToASCII`" msgstr "" -#: whatsnew/3.11.rst:2698 +#: whatsnew/3.11.rst:2713 msgid "" "See :pep:`624` for details and :pep:`migration guidance <624#alternative-" "apis>`. (Contributed by Inada Naoki in :issue:`44029`.)" msgstr "" -#: whatsnew/3.11.rst:2704 +#: whatsnew/3.11.rst:2719 msgid "Notable changes in 3.11.4" msgstr "" -#: whatsnew/3.11.rst:2707 +#: whatsnew/3.11.rst:2722 msgid "tarfile" msgstr "" -#: whatsnew/3.11.rst:2709 +#: whatsnew/3.11.rst:2724 msgid "" "The extraction methods in :mod:`tarfile`, and :func:`shutil.unpack_archive`, " "have a new a *filter* argument that allows limiting tar features than may be " @@ -4187,15 +4203,15 @@ msgid "" "Viktorin in :pep:`706`.)" msgstr "" -#: whatsnew/3.11.rst:2721 +#: whatsnew/3.11.rst:2736 msgid "Notable changes in 3.11.5" msgstr "" -#: whatsnew/3.11.rst:2724 +#: whatsnew/3.11.rst:2739 msgid "OpenSSL" msgstr "" -#: whatsnew/3.11.rst:2726 +#: whatsnew/3.11.rst:2741 msgid "" "Windows builds and macOS installers from python.org now use OpenSSL 3.0." msgstr "" diff --git a/whatsnew/3.12.po b/whatsnew/3.12.po index b10db4c8a..70d2ab316 100644 --- a/whatsnew/3.12.po +++ b/whatsnew/3.12.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -255,7 +255,7 @@ msgid "" "`_." msgstr "" -#: whatsnew/3.12.rst:1973 +#: whatsnew/3.12.rst:1836 msgid "New Features" msgstr "" @@ -931,7 +931,7 @@ msgstr "" #: whatsnew/3.12.rst:742 msgid "" -"Add :class:`itertools.batched()` for collecting into even-sized tuples where " +"Add :func:`itertools.batched` for collecting into even-sized tuples where " "the last batch may be shorter than the rest. (Contributed by Raymond " "Hettinger in :gh:`98363`.)" msgstr "" @@ -1126,7 +1126,7 @@ msgid "" "Windows. (Contributed by Charles Machalow in :gh:`103179`.)" msgstr "" -#: whatsnew/3.12.rst:1677 +#: whatsnew/3.12.rst:1540 msgid "sqlite3" msgstr "" @@ -1199,7 +1199,7 @@ msgid "" "Katriel in :gh:`102778`.)" msgstr "" -#: whatsnew/3.12.rst:1872 +#: whatsnew/3.12.rst:1735 msgid "" ":func:`sys._current_exceptions` now returns a mapping from thread-id to an " "exception instance, rather than to a ``(typ, exc, tb)`` tuple. (Contributed " @@ -1352,7 +1352,7 @@ msgid "" "Benjamin Peterson in :gh:`96734`)." msgstr "" -#: whatsnew/3.12.rst:1717 +#: whatsnew/3.12.rst:1580 msgid "unittest" msgstr "" @@ -1528,11 +1528,11 @@ msgid "" "demos>`_. (Contributed by Victor Stinner in :gh:`97669`.)" msgstr "" -#: whatsnew/3.12.rst:2275 +#: whatsnew/3.12.rst:2138 msgid "Deprecated" msgstr "" -#: whatsnew/3.12.rst:1156 +#: whatsnew/3.12.rst:1156 deprecations/pending-removal-in-3.14.rst:4 msgid "" ":mod:`argparse`: The *type*, *choices*, and *metavar* parameters of :class:`!" "argparse.BooleanOptionalAction` are deprecated and will be removed in 3.14. " @@ -1547,33 +1547,33 @@ msgid "" "Python 3.14:" msgstr "" -#: whatsnew/3.12.rst:1411 +#: whatsnew/3.12.rst:1165 deprecations/pending-removal-in-3.14.rst:13 msgid ":class:`!ast.Num`" msgstr "" -#: whatsnew/3.12.rst:1412 +#: whatsnew/3.12.rst:1166 deprecations/pending-removal-in-3.14.rst:14 msgid ":class:`!ast.Str`" msgstr "" -#: whatsnew/3.12.rst:1413 +#: whatsnew/3.12.rst:1167 deprecations/pending-removal-in-3.14.rst:15 msgid ":class:`!ast.Bytes`" msgstr "" -#: whatsnew/3.12.rst:1414 +#: whatsnew/3.12.rst:1168 deprecations/pending-removal-in-3.14.rst:16 msgid ":class:`!ast.NameConstant`" msgstr "" -#: whatsnew/3.12.rst:1415 +#: whatsnew/3.12.rst:1169 deprecations/pending-removal-in-3.14.rst:17 msgid ":class:`!ast.Ellipsis`" msgstr "" -#: whatsnew/3.12.rst:1171 +#: whatsnew/3.12.rst:1171 deprecations/pending-removal-in-3.14.rst:19 msgid "" "Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" "`90953`.)" msgstr "" -#: whatsnew/3.12.rst:1417 +#: whatsnew/3.12.rst:1174 deprecations/pending-removal-in-3.14.rst:22 msgid ":mod:`asyncio`:" msgstr "" @@ -1585,7 +1585,7 @@ msgid "" "3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" -#: whatsnew/3.12.rst:1182 +#: whatsnew/3.12.rst:1182 deprecations/pending-removal-in-3.14.rst:30 msgid "" ":func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`, :meth:" "`asyncio.AbstractEventLoopPolicy.set_child_watcher` and :meth:`asyncio." @@ -1593,7 +1593,7 @@ msgid "" "removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" -#: whatsnew/3.12.rst:1188 +#: whatsnew/3.12.rst:1188 deprecations/pending-removal-in-3.14.rst:36 msgid "" "The :meth:`~asyncio.get_event_loop` method of the default event loop policy " "now emits a :exc:`DeprecationWarning` if there is no current event loop set " @@ -1601,7 +1601,7 @@ msgid "" "Rossum in :gh:`100160`.)" msgstr "" -#: whatsnew/3.12.rst:1193 +#: whatsnew/3.12.rst:1193 deprecations/pending-removal-in-future.rst:42 msgid "" ":mod:`calendar`: ``calendar.January`` and ``calendar.February`` constants " "are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." @@ -1638,31 +1638,31 @@ msgid "" "removal in Python 3.14:" msgstr "" -#: whatsnew/3.12.rst:1434 +#: whatsnew/3.12.rst:1216 deprecations/pending-removal-in-3.14.rst:55 msgid ":class:`!importlib.abc.ResourceReader`" msgstr "" -#: whatsnew/3.12.rst:1435 +#: whatsnew/3.12.rst:1217 deprecations/pending-removal-in-3.14.rst:56 msgid ":class:`!importlib.abc.Traversable`" msgstr "" -#: whatsnew/3.12.rst:1436 +#: whatsnew/3.12.rst:1218 deprecations/pending-removal-in-3.14.rst:57 msgid ":class:`!importlib.abc.TraversableResources`" msgstr "" -#: whatsnew/3.12.rst:1220 +#: whatsnew/3.12.rst:1220 deprecations/pending-removal-in-3.14.rst:59 msgid "Use :mod:`importlib.resources.abc` classes instead:" msgstr "" -#: whatsnew/3.12.rst:1222 +#: whatsnew/3.12.rst:1222 deprecations/pending-removal-in-3.14.rst:61 msgid ":class:`importlib.resources.abc.Traversable`" msgstr "" -#: whatsnew/3.12.rst:1223 +#: whatsnew/3.12.rst:1223 deprecations/pending-removal-in-3.14.rst:62 msgid ":class:`importlib.resources.abc.TraversableResources`" msgstr "" -#: whatsnew/3.12.rst:1225 +#: whatsnew/3.12.rst:1225 deprecations/pending-removal-in-3.14.rst:64 msgid "(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)" msgstr "" @@ -1742,7 +1742,7 @@ msgid "" "`102828`.)" msgstr "" -#: whatsnew/3.12.rst:1278 +#: whatsnew/3.12.rst:1278 deprecations/pending-removal-in-3.14.rst:94 msgid ":mod:`sqlite3`:" msgstr "" @@ -1843,387 +1843,808 @@ msgid "" "(Contributed by Nikita Sobolev in :gh:`101866`.)" msgstr "" -#: whatsnew/3.12.rst:1345 +#: deprecations/pending-removal-in-3.13.rst:2 msgid "Pending Removal in Python 3.13" msgstr "" -#: whatsnew/3.12.rst:1347 -msgid "" -"The following modules and APIs have been deprecated in earlier Python " -"releases, and will be removed in Python 3.13." -msgstr "" - -#: whatsnew/3.12.rst:1350 +#: deprecations/pending-removal-in-3.13.rst:4 msgid "Modules (see :pep:`594`):" msgstr "" -#: whatsnew/3.12.rst:1352 +#: deprecations/pending-removal-in-3.13.rst:6 msgid ":mod:`aifc`" msgstr "" -#: whatsnew/3.12.rst:1353 +#: deprecations/pending-removal-in-3.13.rst:7 msgid ":mod:`audioop`" msgstr "" -#: whatsnew/3.12.rst:1354 +#: deprecations/pending-removal-in-3.13.rst:8 msgid ":mod:`cgi`" msgstr "" -#: whatsnew/3.12.rst:1355 +#: deprecations/pending-removal-in-3.13.rst:9 msgid ":mod:`cgitb`" msgstr "" -#: whatsnew/3.12.rst:1356 +#: deprecations/pending-removal-in-3.13.rst:10 msgid ":mod:`chunk`" msgstr "" -#: whatsnew/3.12.rst:1357 +#: deprecations/pending-removal-in-3.13.rst:11 msgid ":mod:`crypt`" msgstr "" -#: whatsnew/3.12.rst:1358 +#: deprecations/pending-removal-in-3.13.rst:12 msgid ":mod:`imghdr`" msgstr "" -#: whatsnew/3.12.rst:1359 +#: deprecations/pending-removal-in-3.13.rst:13 msgid ":mod:`mailcap`" msgstr "" -#: whatsnew/3.12.rst:1360 +#: deprecations/pending-removal-in-3.13.rst:14 msgid ":mod:`msilib`" msgstr "" -#: whatsnew/3.12.rst:1361 +#: deprecations/pending-removal-in-3.13.rst:15 msgid ":mod:`nis`" msgstr "" -#: whatsnew/3.12.rst:1362 +#: deprecations/pending-removal-in-3.13.rst:16 msgid ":mod:`nntplib`" msgstr "" -#: whatsnew/3.12.rst:1363 +#: deprecations/pending-removal-in-3.13.rst:17 msgid ":mod:`ossaudiodev`" msgstr "" -#: whatsnew/3.12.rst:1364 +#: deprecations/pending-removal-in-3.13.rst:18 msgid ":mod:`pipes`" msgstr "" -#: whatsnew/3.12.rst:1365 +#: deprecations/pending-removal-in-3.13.rst:19 msgid ":mod:`sndhdr`" msgstr "" -#: whatsnew/3.12.rst:1366 +#: deprecations/pending-removal-in-3.13.rst:20 msgid ":mod:`spwd`" msgstr "" -#: whatsnew/3.12.rst:1367 +#: deprecations/pending-removal-in-3.13.rst:21 msgid ":mod:`sunau`" msgstr "" -#: whatsnew/3.12.rst:1368 +#: deprecations/pending-removal-in-3.13.rst:22 msgid ":mod:`telnetlib`" msgstr "" -#: whatsnew/3.12.rst:1369 +#: deprecations/pending-removal-in-3.13.rst:23 msgid ":mod:`uu`" msgstr "" -#: whatsnew/3.12.rst:1370 +#: deprecations/pending-removal-in-3.13.rst:24 msgid ":mod:`xdrlib`" msgstr "" -#: whatsnew/3.12.rst:1372 +#: deprecations/pending-removal-in-3.13.rst:26 msgid "Other modules:" msgstr "" -#: whatsnew/3.12.rst:1374 +#: deprecations/pending-removal-in-3.13.rst:28 msgid ":mod:`!lib2to3`, and the :program:`2to3` program (:gh:`84540`)" msgstr "" -#: whatsnew/3.12.rst:1466 +#: deprecations/pending-removal-in-3.13.rst:30 msgid "APIs:" msgstr "" -#: whatsnew/3.12.rst:1378 +#: deprecations/pending-removal-in-3.13.rst:32 msgid ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" msgstr "" -#: whatsnew/3.12.rst:1379 +#: deprecations/pending-removal-in-3.13.rst:33 msgid "``locale.resetlocale()`` (:gh:`90817`)" msgstr "" -#: whatsnew/3.12.rst:1380 +#: deprecations/pending-removal-in-3.13.rst:34 msgid ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" msgstr "" -#: whatsnew/3.12.rst:1381 +#: deprecations/pending-removal-in-3.13.rst:35 msgid ":func:`!unittest.findTestCases` (:gh:`50096`)" msgstr "" -#: whatsnew/3.12.rst:1382 +#: deprecations/pending-removal-in-3.13.rst:36 msgid ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" msgstr "" -#: whatsnew/3.12.rst:1383 +#: deprecations/pending-removal-in-3.13.rst:37 msgid ":func:`!unittest.makeSuite` (:gh:`50096`)" msgstr "" -#: whatsnew/3.12.rst:1384 +#: deprecations/pending-removal-in-3.13.rst:38 msgid ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" msgstr "" -#: whatsnew/3.12.rst:1385 +#: deprecations/pending-removal-in-3.13.rst:39 msgid ":class:`!webbrowser.MacOSX` (:gh:`86421`)" msgstr "" -#: whatsnew/3.12.rst:1386 +#: deprecations/pending-removal-in-3.13.rst:40 msgid ":class:`classmethod` descriptor chaining (:gh:`89519`)" msgstr "" -#: whatsnew/3.12.rst:1387 +#: deprecations/pending-removal-in-3.13.rst:41 msgid ":mod:`importlib.resources` deprecated methods:" msgstr "" -#: whatsnew/3.12.rst:1389 +#: deprecations/pending-removal-in-3.13.rst:43 msgid "``contents()``" msgstr "" -#: whatsnew/3.12.rst:1390 +#: deprecations/pending-removal-in-3.13.rst:44 msgid "``is_resource()``" msgstr "" -#: whatsnew/3.12.rst:1391 +#: deprecations/pending-removal-in-3.13.rst:45 msgid "``open_binary()``" msgstr "" -#: whatsnew/3.12.rst:1392 +#: deprecations/pending-removal-in-3.13.rst:46 msgid "``open_text()``" msgstr "" -#: whatsnew/3.12.rst:1393 +#: deprecations/pending-removal-in-3.13.rst:47 msgid "``path()``" msgstr "" -#: whatsnew/3.12.rst:1394 +#: deprecations/pending-removal-in-3.13.rst:48 msgid "``read_binary()``" msgstr "" -#: whatsnew/3.12.rst:1395 +#: deprecations/pending-removal-in-3.13.rst:49 msgid "``read_text()``" msgstr "" -#: whatsnew/3.12.rst:1397 +#: deprecations/pending-removal-in-3.13.rst:51 msgid "" "Use :func:`importlib.resources.files()` instead. Refer to `importlib-" "resources: Migrating from Legacy `_ (:gh:`106531`)" msgstr "" -#: whatsnew/3.12.rst:2362 +#: deprecations/c-api-pending-removal-in-3.14.rst:2 +#: deprecations/pending-removal-in-3.14.rst:2 msgid "Pending Removal in Python 3.14" msgstr "" -#: whatsnew/3.12.rst:1403 +#: deprecations/pending-removal-in-3.14.rst:9 msgid "" -"The following APIs have been deprecated and will be removed in Python 3.14." +":mod:`ast`: The following features have been deprecated in documentation " +"since Python 3.8, now cause a :exc:`DeprecationWarning` to be emitted at " +"runtime when they are accessed or used, and will be removed in Python 3.14:" msgstr "" -#: whatsnew/3.12.rst:1406 +#: deprecations/pending-removal-in-3.14.rst:24 msgid "" -":mod:`argparse`: The *type*, *choices*, and *metavar* parameters of :class:`!" -"argparse.BooleanOptionalAction`" +"The child watcher classes :class:`~asyncio.MultiLoopChildWatcher`, :class:" +"`~asyncio.FastChildWatcher`, :class:`~asyncio.AbstractChildWatcher` and :" +"class:`~asyncio.SafeChildWatcher` are deprecated and will be removed in " +"Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" -#: whatsnew/3.12.rst:1409 -msgid ":mod:`ast`:" +#: deprecations/pending-removal-in-3.14.rst:41 +msgid "" +":mod:`collections.abc`: Deprecated :class:`~collections.abc.ByteString`. " +"Prefer :class:`!Sequence` or :class:`~collections.abc.Buffer`. For use in " +"typing, prefer a union, like ``bytes | bytearray``, or :class:`collections." +"abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" msgstr "" -#: whatsnew/3.12.rst:1419 -msgid ":class:`!asyncio.MultiLoopChildWatcher`" +#: deprecations/pending-removal-in-3.14.rst:47 +msgid "" +":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." +"localtime`. (Contributed by Alan Williams in :gh:`72346`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:50 +msgid "" +":mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or " +"taken into consideration by the import system (:gh:`97879`)." msgstr "" -#: whatsnew/3.12.rst:1420 -msgid ":class:`!asyncio.FastChildWatcher`" +#: deprecations/pending-removal-in-3.14.rst:53 +msgid ":mod:`importlib.abc` deprecated classes:" msgstr "" -#: whatsnew/3.12.rst:1421 -msgid ":class:`!asyncio.AbstractChildWatcher`" +#: deprecations/pending-removal-in-3.14.rst:66 +msgid "" +":mod:`itertools` had undocumented, inefficient, historically buggy, and " +"inconsistent support for copy, deepcopy, and pickle operations. This will be " +"removed in 3.14 for a significant reduction in code volume and maintenance " +"burden. (Contributed by Raymond Hettinger in :gh:`101588`.)" msgstr "" -#: whatsnew/3.12.rst:1422 -msgid ":class:`!asyncio.SafeChildWatcher`" +#: deprecations/pending-removal-in-3.14.rst:72 +msgid "" +":mod:`multiprocessing`: The default start method will change to a safer one " +"on Linux, BSDs, and other non-macOS POSIX platforms where ``'fork'`` is " +"currently the default (:gh:`84559`). Adding a runtime warning about this was " +"deemed too disruptive as the majority of code is not expected to care. Use " +"the :func:`~multiprocessing.get_context` or :func:`~multiprocessing." +"set_start_method` APIs to explicitly specify when your code *requires* " +"``'fork'``. See :ref:`multiprocessing-start-methods`." msgstr "" -#: whatsnew/3.12.rst:1423 -msgid ":func:`!asyncio.set_child_watcher`" +#: deprecations/pending-removal-in-3.14.rst:80 +msgid "" +":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." +"PurePath.relative_to`: passing additional arguments is deprecated." msgstr "" -#: whatsnew/3.12.rst:1424 -msgid ":func:`!asyncio.get_child_watcher`," +#: deprecations/pending-removal-in-3.14.rst:84 +msgid "" +":mod:`pkgutil`: :func:`~pkgutil.find_loader` and :func:`~pkgutil.get_loader` " +"now raise :exc:`DeprecationWarning`; use :func:`importlib.util.find_spec` " +"instead. (Contributed by Nikita Sobolev in :gh:`97850`.)" msgstr "" -#: whatsnew/3.12.rst:1425 -msgid ":meth:`!asyncio.AbstractEventLoopPolicy.set_child_watcher`" +#: deprecations/pending-removal-in-3.14.rst:89 +msgid ":mod:`pty`:" msgstr "" -#: whatsnew/3.12.rst:1426 -msgid ":meth:`!asyncio.AbstractEventLoopPolicy.get_child_watcher`" +#: deprecations/pending-removal-in-3.14.rst:91 +msgid "``master_open()``: use :func:`pty.openpty`." msgstr "" -#: whatsnew/3.12.rst:1428 -msgid ":mod:`collections.abc`: :class:`!collections.abc.ByteString`." +#: deprecations/pending-removal-in-3.14.rst:92 +msgid "``slave_open()``: use :func:`pty.openpty`." msgstr "" -#: whatsnew/3.12.rst:1430 -msgid ":mod:`email`: the *isdst* parameter in :func:`email.utils.localtime`." +#: deprecations/pending-removal-in-3.14.rst:96 +msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." msgstr "" -#: whatsnew/3.12.rst:1432 -msgid ":mod:`importlib.abc`:" +#: deprecations/pending-removal-in-3.14.rst:98 +msgid "" +":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` if :" +"ref:`named placeholders ` are used and *parameters* is " +"a sequence instead of a :class:`dict`." msgstr "" -#: whatsnew/3.12.rst:1438 -msgid ":mod:`itertools`: Support for copy, deepcopy, and pickle operations." +#: deprecations/pending-removal-in-3.14.rst:102 +msgid "" +"date and datetime adapter, date and timestamp converter: see the :mod:" +"`sqlite3` documentation for suggested replacement recipes." msgstr "" -#: whatsnew/3.12.rst:1440 -msgid ":mod:`pkgutil`:" +#: deprecations/pending-removal-in-3.14.rst:105 +msgid "" +":class:`types.CodeType`: Accessing :attr:`~codeobject.co_lnotab` was " +"deprecated in :pep:`626` since 3.10 and was planned to be removed in 3.12, " +"but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " +"in 3.14. (Contributed by Nikita Sobolev in :gh:`101866`.)" msgstr "" -#: whatsnew/3.12.rst:1442 -msgid ":func:`!pkgutil.find_loader`" +#: deprecations/pending-removal-in-3.14.rst:112 +msgid "" +":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " +"causes a :exc:`DeprecationWarning` to be emitted when it is used." msgstr "" -#: whatsnew/3.12.rst:1443 -msgid ":func:`!pkgutil.get_loader`." +#: deprecations/pending-removal-in-3.14.rst:115 +msgid "" +":mod:`urllib`: :class:`!urllib.parse.Quoter` is deprecated: it was not " +"intended to be a public API. (Contributed by Gregory P. Smith in :gh:" +"`88168`.)" msgstr "" -#: whatsnew/3.12.rst:1445 -msgid ":mod:`pty`:" +#: deprecations/c-api-pending-removal-in-3.15.rst:2 +#: deprecations/pending-removal-in-3.15.rst:2 +msgid "Pending Removal in Python 3.15" msgstr "" -#: whatsnew/3.12.rst:1447 -msgid ":func:`!pty.master_open`" +#: deprecations/pending-removal-in-3.15.rst:4 +msgid "" +":class:`http.server.CGIHTTPRequestHandler` will be removed along with its " +"related ``--cgi`` flag to ``python -m http.server``. It was obsolete and " +"rarely used. No direct replacement exists. *Anything* is better than CGI " +"to interface a web server with a request handler." msgstr "" -#: whatsnew/3.12.rst:1448 -msgid ":func:`!pty.slave_open`" +#: deprecations/pending-removal-in-3.15.rst:9 +msgid "" +":class:`locale`: :func:`locale.getdefaultlocale` was deprecated in Python " +"3.11 and originally planned for removal in Python 3.13 (:gh:`90817`), but " +"removal has been postponed to Python 3.15. Use :func:`locale.setlocale()`, :" +"func:`locale.getencoding()` and :func:`locale.getlocale()` instead. " +"(Contributed by Hugo van Kemenade in :gh:`111187`.)" msgstr "" -#: whatsnew/3.12.rst:1450 -msgid ":mod:`shutil`: The *onerror* argument of :func:`shutil.rmtree`" +#: deprecations/pending-removal-in-3.15.rst:16 +msgid "" +":mod:`pathlib`: :meth:`pathlib.PurePath.is_reserved` is deprecated and " +"scheduled for removal in Python 3.15. From Python 3.13 onwards, use ``os." +"path.isreserved`` to detect reserved paths on Windows." msgstr "" -#: whatsnew/3.12.rst:1452 -msgid ":mod:`typing`: :class:`!typing.ByteString`" +#: deprecations/pending-removal-in-3.15.rst:21 +msgid "" +":mod:`platform`: :func:`~platform.java_ver` is deprecated and will be " +"removed in 3.15. It was largely untested, had a confusing API, and was only " +"useful for Jython support. (Contributed by Nikita Sobolev in :gh:`116349`.)" msgstr "" -#: whatsnew/3.12.rst:1454 +#: deprecations/pending-removal-in-3.15.rst:27 msgid "" -":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`xml." -"etree.ElementTree.Element`." +":mod:`threading`: Passing any arguments to :func:`threading.RLock` is now " +"deprecated. C version allows any numbers of args and kwargs, but they are " +"just ignored. Python version does not allow any arguments. All arguments " +"will be removed from :func:`threading.RLock` in Python 3.15. (Contributed by " +"Nikita Sobolev in :gh:`102029`.)" msgstr "" -#: whatsnew/3.12.rst:1456 -msgid "The ``__package__`` and ``__cached__`` attributes on module objects." +#: deprecations/pending-removal-in-3.15.rst:34 +msgid ":class:`typing.NamedTuple`:" msgstr "" -#: whatsnew/3.12.rst:1458 -msgid "The :attr:`~codeobject.co_lnotab` attribute of code objects." +#: deprecations/pending-removal-in-3.15.rst:36 +msgid "" +"The undocumented keyword argument syntax for creating :class:`!NamedTuple` " +"classes (``NT = NamedTuple(\"NT\", x=int)``) is deprecated, and will be " +"disallowed in 3.15. Use the class-based syntax or the functional syntax " +"instead." msgstr "" -#: whatsnew/3.12.rst:2399 -msgid "Pending Removal in Python 3.15" +#: deprecations/pending-removal-in-3.15.rst:40 +msgid "" +"When using the functional syntax to create a :class:`!NamedTuple` class, " +"failing to pass a value to the *fields* parameter (``NT = " +"NamedTuple(\"NT\")``) is deprecated. Passing ``None`` to the *fields* " +"parameter (``NT = NamedTuple(\"NT\", None)``) is also deprecated. Both will " +"be disallowed in Python 3.15. To create a :class:`!NamedTuple` class with 0 " +"fields, use ``class NT(NamedTuple): pass`` or ``NT = NamedTuple(\"NT\", " +"[])``." msgstr "" -#: whatsnew/3.12.rst:1463 +#: deprecations/pending-removal-in-3.15.rst:47 +msgid "" +":class:`typing.TypedDict`: When using the functional syntax to create a :" +"class:`!TypedDict` class, failing to pass a value to the *fields* parameter " +"(``TD = TypedDict(\"TD\")``) is deprecated. Passing ``None`` to the *fields* " +"parameter (``TD = TypedDict(\"TD\", None)``) is also deprecated. Both will " +"be disallowed in Python 3.15. To create a :class:`!TypedDict` class with 0 " +"fields, use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})``." +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:54 +msgid "" +":mod:`wave`: Deprecate the ``getmark()``, ``setmark()`` and ``getmarkers()`` " +"methods of the :class:`wave.Wave_read` and :class:`wave.Wave_write` classes. " +"They will be removed in Python 3.15. (Contributed by Victor Stinner in :gh:" +"`105096`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.16.rst:2 +msgid "Pending Removal in Python 3.16" +msgstr "" + +#: deprecations/pending-removal-in-3.16.rst:4 msgid "" -"The following APIs have been deprecated and will be removed in Python 3.15." +":mod:`array`: :class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the " +"``'w'`` type instead (``Py_UCS4``)." msgstr "" -#: whatsnew/3.12.rst:1468 -msgid ":func:`locale.getdefaultlocale` (:gh:`90817`)" +#: deprecations/pending-removal-in-3.16.rst:8 +msgid "" +":mod:`symtable`: Deprecate :meth:`symtable.Class.get_methods` due to the " +"lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" msgstr "" -#: whatsnew/3.12.rst:2417 +#: deprecations/c-api-pending-removal-in-future.rst:2 +#: deprecations/pending-removal-in-future.rst:2 msgid "Pending Removal in Future Versions" msgstr "" -#: whatsnew/3.12.rst:1474 +#: deprecations/pending-removal-in-future.rst:4 msgid "" -"The following APIs were deprecated in earlier Python versions and will be " -"removed, although there is currently no date scheduled for their removal." +"The following APIs will be removed in the future, although there is " +"currently no date scheduled for their removal." msgstr "" -#: whatsnew/3.12.rst:1477 +#: deprecations/pending-removal-in-future.rst:7 +msgid "" +":mod:`argparse`: Nesting argument groups and nesting mutually exclusive " +"groups are deprecated." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:10 msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" msgstr "" -#: whatsnew/3.12.rst:1479 -msgid ":class:`typing.Text` (:gh:`92332`)" +#: deprecations/pending-removal-in-future.rst:12 +msgid ":mod:`builtins`:" msgstr "" -#: whatsnew/3.12.rst:1481 +#: deprecations/pending-removal-in-future.rst:14 +msgid "``~bool``, bitwise inversion on bool." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:15 +msgid "``bool(NotImplemented)``." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:16 +msgid "" +"Generators: ``throw(type, exc, tb)`` and ``athrow(type, exc, tb)`` signature " +"is deprecated: use ``throw(exc)`` and ``athrow(exc)`` instead, the single " +"argument signature." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:19 msgid "" "Currently Python accepts numeric literals immediately followed by keywords, " "for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing and " "ambiguous expressions like ``[0x1for x in y]`` (which can be interpreted as " -"``[0x1 for x in y]`` or ``[0x1f or x in y]``). A syntax warning is raised if " -"the numeric literal is immediately followed by one of keywords :keyword:" +"``[0x1 for x in y]`` or ``[0x1f or x in y]``). A syntax warning is raised " +"if the numeric literal is immediately followed by one of keywords :keyword:" "`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :" -"keyword:`is` and :keyword:`or`. In a future release it will be changed to a " +"keyword:`is` and :keyword:`or`. In a future release it will be changed to a " "syntax error. (:gh:`87999`)" msgstr "" -#: whatsnew/3.12.rst:2449 +#: deprecations/pending-removal-in-future.rst:27 +msgid "" +"Support for ``__index__()`` and ``__int__()`` method returning non-int type: " +"these methods will be required to return an instance of a strict subclass " +"of :class:`int`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:30 +msgid "" +"Support for ``__float__()`` method returning a strict subclass of :class:" +"`float`: these methods will be required to return an instance of :class:" +"`float`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:33 +msgid "" +"Support for ``__complex__()`` method returning a strict subclass of :class:" +"`complex`: these methods will be required to return an instance of :class:" +"`complex`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:36 +msgid "Delegation of ``int()`` to ``__trunc__()`` method." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:37 +msgid "" +"Passing a complex number as the *real* or *imag* argument in the :func:" +"`complex` constructor is now deprecated; it should only be passed as a " +"single positional argument. (Contributed by Serhiy Storchaka in :gh:" +"`109218`.)" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:47 +msgid "" +":attr:`codeobject.co_lnotab`: use the :meth:`codeobject.co_lines` method " +"instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:50 +msgid ":mod:`datetime`:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:52 +msgid "" +":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." +"UTC)``." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:54 +msgid "" +":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." +"fromtimestamp(timestamp, tz=datetime.UTC)``." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:57 +msgid ":mod:`gettext`: Plural value must be an integer." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:59 +msgid ":mod:`importlib`:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:61 +msgid "``load_module()`` method: use ``exec_module()`` instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:62 +msgid "" +":func:`~importlib.util.cache_from_source` *debug_override* parameter is " +"deprecated: use the *optimization* parameter instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:65 +msgid ":mod:`importlib.metadata`:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:67 +msgid "``EntryPoints`` tuple interface." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:68 +msgid "Implicit ``None`` on return values." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:70 +msgid "" +":mod:`mailbox`: Use of StringIO input and text mode is deprecated, use " +"BytesIO and binary mode instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:73 +msgid "" +":mod:`os`: Calling :func:`os.register_at_fork` in multi-threaded process." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:75 +msgid "" +":class:`!pydoc.ErrorDuringImport`: A tuple value for *exc_info* parameter is " +"deprecated, use an exception instance." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:78 +msgid "" +":mod:`re`: More strict rules are now applied for numerical group references " +"and group names in regular expressions. Only sequence of ASCII digits is " +"now accepted as a numerical reference. The group name in bytes patterns and " +"replacement strings can now only contain ASCII letters and digits and " +"underscore. (Contributed by Serhiy Storchaka in :gh:`91760`.)" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:85 +msgid "" +":mod:`!sre_compile`, :mod:`!sre_constants` and :mod:`!sre_parse` modules." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:87 +msgid "" +":mod:`shutil`: :func:`~shutil.rmtree`'s *onerror* parameter is deprecated in " +"Python 3.12; use the *onexc* parameter instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:90 +msgid ":mod:`ssl` options and protocols:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:92 +msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:93 +msgid "" +":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" +"`!selected_npn_protocol` are deprecated: use ALPN instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:96 +msgid "``ssl.OP_NO_SSL*`` options" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:97 +msgid "``ssl.OP_NO_TLS*`` options" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:98 +msgid "``ssl.PROTOCOL_SSLv3``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:99 +msgid "``ssl.PROTOCOL_TLS``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:100 +msgid "``ssl.PROTOCOL_TLSv1``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:101 +msgid "``ssl.PROTOCOL_TLSv1_1``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:102 +msgid "``ssl.PROTOCOL_TLSv1_2``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:103 +msgid "``ssl.TLSVersion.SSLv3``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:104 +msgid "``ssl.TLSVersion.TLSv1``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:105 +msgid "``ssl.TLSVersion.TLSv1_1``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:107 +msgid "" +":func:`sysconfig.is_python_build` *check_home* parameter is deprecated and " +"ignored." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:110 +msgid ":mod:`threading` methods:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:112 +msgid "" +":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." +"notify_all`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:113 +msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:114 +msgid "" +":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" +"attr:`threading.Thread.daemon` attribute." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:116 +msgid "" +":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" +"attr:`threading.Thread.name` attribute." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:118 +msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:119 +msgid ":meth:`!threading.activeCount`: use :meth:`threading.active_count`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:121 +msgid ":class:`typing.Text` (:gh:`92332`)." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:123 +msgid "" +":class:`unittest.IsolatedAsyncioTestCase`: it is deprecated to return a " +"value that is not ``None`` from a test case." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:126 +msgid "" +":mod:`urllib.parse` deprecated functions: :func:`~urllib.parse.urlparse` " +"instead" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:128 +msgid "``splitattr()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:129 +msgid "``splithost()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:130 +msgid "``splitnport()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:131 +msgid "``splitpasswd()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:132 +msgid "``splitport()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:133 +msgid "``splitquery()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:134 +msgid "``splittag()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:135 +msgid "``splittype()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:136 +msgid "``splituser()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:137 +msgid "``splitvalue()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:138 +msgid "``to_bytes()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:140 +msgid "" +":mod:`urllib.request`: :class:`~urllib.request.URLopener` and :class:" +"`~urllib.request.FancyURLopener` style of invoking requests is deprecated. " +"Use newer :func:`~urllib.request.urlopen` functions and methods." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:144 +msgid "" +":mod:`wsgiref`: ``SimpleHandler.stdout.write()`` should not do partial " +"writes." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:147 +msgid "" +":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`~xml." +"etree.ElementTree.Element` is deprecated. In a future release it will always " +"return ``True``. Prefer explicit ``len(elem)`` or ``elem is not None`` tests " +"instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:152 +msgid "" +":meth:`zipimport.zipimporter.load_module` is deprecated: use :meth:" +"`~zipimport.zipimporter.exec_module` instead." +msgstr "" + +#: whatsnew/3.12.rst:2233 msgid "Removed" msgstr "" -#: whatsnew/3.12.rst:1495 +#: whatsnew/3.12.rst:1358 msgid "asynchat and asyncore" msgstr "" -#: whatsnew/3.12.rst:1497 +#: whatsnew/3.12.rst:1360 msgid "" "These two modules have been removed according to the schedule in :pep:`594`, " "having been deprecated in Python 3.6. Use :mod:`asyncio` instead. " "(Contributed by Nikita Sobolev in :gh:`96580`.)" msgstr "" -#: whatsnew/3.12.rst:1504 +#: whatsnew/3.12.rst:1367 msgid "configparser" msgstr "" -#: whatsnew/3.12.rst:1506 +#: whatsnew/3.12.rst:1369 msgid "" "Several names deprecated in the :mod:`configparser` way back in 3.2 have " "been removed per :gh:`89336`:" msgstr "" -#: whatsnew/3.12.rst:1509 +#: whatsnew/3.12.rst:1372 msgid "" ":class:`configparser.ParsingError` no longer has a ``filename`` attribute or " "argument. Use the ``source`` attribute and argument instead." msgstr "" -#: whatsnew/3.12.rst:1511 +#: whatsnew/3.12.rst:1374 msgid "" ":mod:`configparser` no longer has a ``SafeConfigParser`` class. Use the " "shorter :class:`~configparser.ConfigParser` name instead." msgstr "" -#: whatsnew/3.12.rst:1513 +#: whatsnew/3.12.rst:1376 msgid "" ":class:`configparser.ConfigParser` no longer has a ``readfp`` method. Use :" "meth:`~configparser.ConfigParser.read_file` instead." msgstr "" -#: whatsnew/3.12.rst:1517 +#: whatsnew/3.12.rst:1380 msgid "distutils" msgstr "" -#: whatsnew/3.12.rst:1519 +#: whatsnew/3.12.rst:1382 msgid "" "Remove the :py:mod:`!distutils` package. It was deprecated in Python 3.10 " "by :pep:`632` \"Deprecate distutils module\". For projects still using " @@ -2232,17 +2653,17 @@ msgid "" "Victor Stinner in :gh:`92584`.)" msgstr "" -#: whatsnew/3.12.rst:1526 +#: whatsnew/3.12.rst:1389 msgid "ensurepip" msgstr "" -#: whatsnew/3.12.rst:1528 +#: whatsnew/3.12.rst:1391 msgid "" "Remove the bundled setuptools wheel from :mod:`ensurepip`, and stop " "installing setuptools in environments created by :mod:`venv`." msgstr "" -#: whatsnew/3.12.rst:1531 +#: whatsnew/3.12.rst:1394 msgid "" "``pip (>= 22.1)`` does not require setuptools to be installed in the " "environment. ``setuptools``-based (and ``distutils``-based) packages can " @@ -2250,7 +2671,7 @@ msgid "" "the build environment it uses for building a package." msgstr "" -#: whatsnew/3.12.rst:1537 +#: whatsnew/3.12.rst:1400 msgid "" "``easy_install``, ``pkg_resources``, ``setuptools`` and ``distutils`` are no " "longer provided by default in environments created with ``venv`` or " @@ -2260,35 +2681,35 @@ msgid "" "(typically, using pip)." msgstr "" -#: whatsnew/3.12.rst:1544 +#: whatsnew/3.12.rst:1407 msgid "(Contributed by Pradyun Gedam in :gh:`95299`.)" msgstr "" -#: whatsnew/3.12.rst:1547 +#: whatsnew/3.12.rst:1410 msgid "enum" msgstr "" -#: whatsnew/3.12.rst:1549 +#: whatsnew/3.12.rst:1412 msgid "" "Remove :mod:`enum`'s ``EnumMeta.__getattr__``, which is no longer needed for " "enum attribute access. (Contributed by Ethan Furman in :gh:`95083`.)" msgstr "" -#: whatsnew/3.12.rst:1554 +#: whatsnew/3.12.rst:1417 msgid "ftplib" msgstr "" -#: whatsnew/3.12.rst:1556 +#: whatsnew/3.12.rst:1419 msgid "" "Remove :mod:`ftplib`'s ``FTP_TLS.ssl_version`` class attribute: use the " "*context* parameter instead. (Contributed by Victor Stinner in :gh:`94172`.)" msgstr "" -#: whatsnew/3.12.rst:1561 +#: whatsnew/3.12.rst:1424 msgid "gzip" msgstr "" -#: whatsnew/3.12.rst:1563 +#: whatsnew/3.12.rst:1426 msgid "" "Remove the ``filename`` attribute of :mod:`gzip`'s :class:`gzip.GzipFile`, " "deprecated since Python 2.6, use the :attr:`~gzip.GzipFile.name` attribute " @@ -2297,11 +2718,11 @@ msgid "" "`94196`.)" msgstr "" -#: whatsnew/3.12.rst:1570 +#: whatsnew/3.12.rst:1433 msgid "hashlib" msgstr "" -#: whatsnew/3.12.rst:1572 +#: whatsnew/3.12.rst:1435 msgid "" "Remove the pure Python implementation of :mod:`hashlib`'s :func:`hashlib." "pbkdf2_hmac()`, deprecated in Python 3.10. Python 3.10 and newer requires " @@ -2310,191 +2731,191 @@ msgid "" "Stinner in :gh:`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1606 +#: whatsnew/3.12.rst:1469 msgid "importlib" msgstr "" -#: whatsnew/3.12.rst:1581 +#: whatsnew/3.12.rst:1444 msgid "" "Many previously deprecated cleanups in :mod:`importlib` have now been " "completed:" msgstr "" -#: whatsnew/3.12.rst:1584 +#: whatsnew/3.12.rst:1447 msgid "" "References to, and support for :meth:`!module_repr()` has been removed. " "(Contributed by Barry Warsaw in :gh:`97850`.)" msgstr "" -#: whatsnew/3.12.rst:1587 +#: whatsnew/3.12.rst:1450 msgid "" "``importlib.util.set_package``, ``importlib.util.set_loader`` and " "``importlib.util.module_for_loader`` have all been removed. (Contributed by " "Brett Cannon and Nikita Sobolev in :gh:`65961` and :gh:`97850`.)" msgstr "" -#: whatsnew/3.12.rst:1591 +#: whatsnew/3.12.rst:1454 msgid "" "Support for ``find_loader()`` and ``find_module()`` APIs have been removed. " "(Contributed by Barry Warsaw in :gh:`98040`.)" msgstr "" -#: whatsnew/3.12.rst:1594 +#: whatsnew/3.12.rst:1457 msgid "" "``importlib.abc.Finder``, ``pkgutil.ImpImporter``, and ``pkgutil.ImpLoader`` " "have been removed. (Contributed by Barry Warsaw in :gh:`98040`.)" msgstr "" -#: whatsnew/3.12.rst:1606 +#: whatsnew/3.12.rst:1469 msgid "imp" msgstr "" -#: whatsnew/3.12.rst:1600 +#: whatsnew/3.12.rst:1463 msgid "" "The :mod:`!imp` module has been removed. (Contributed by Barry Warsaw in :" "gh:`98040`.)" msgstr "" -#: whatsnew/3.12.rst:1603 +#: whatsnew/3.12.rst:1466 msgid "To migrate, consult the following correspondence table:" msgstr "" -#: whatsnew/3.12.rst:1608 +#: whatsnew/3.12.rst:1471 msgid "``imp.NullImporter``" msgstr "" -#: whatsnew/3.12.rst:1608 +#: whatsnew/3.12.rst:1471 msgid "Insert ``None`` into ``sys.path_importer_cache``" msgstr "" -#: whatsnew/3.12.rst:1609 +#: whatsnew/3.12.rst:1472 msgid "``imp.cache_from_source()``" msgstr "" -#: whatsnew/3.12.rst:1609 +#: whatsnew/3.12.rst:1472 msgid ":func:`importlib.util.cache_from_source`" msgstr "" -#: whatsnew/3.12.rst:1610 +#: whatsnew/3.12.rst:1473 msgid "``imp.find_module()``" msgstr "" -#: whatsnew/3.12.rst:1610 +#: whatsnew/3.12.rst:1473 msgid ":func:`importlib.util.find_spec`" msgstr "" -#: whatsnew/3.12.rst:1611 +#: whatsnew/3.12.rst:1474 msgid "``imp.get_magic()``" msgstr "" -#: whatsnew/3.12.rst:1611 +#: whatsnew/3.12.rst:1474 msgid ":attr:`importlib.util.MAGIC_NUMBER`" msgstr "" -#: whatsnew/3.12.rst:1612 +#: whatsnew/3.12.rst:1475 msgid "``imp.get_suffixes()``" msgstr "" -#: whatsnew/3.12.rst:1612 +#: whatsnew/3.12.rst:1475 msgid "" ":attr:`importlib.machinery.SOURCE_SUFFIXES`, :attr:`importlib.machinery." "EXTENSION_SUFFIXES`, and :attr:`importlib.machinery.BYTECODE_SUFFIXES`" msgstr "" -#: whatsnew/3.12.rst:1613 +#: whatsnew/3.12.rst:1476 msgid "``imp.get_tag()``" msgstr "" -#: whatsnew/3.12.rst:1613 +#: whatsnew/3.12.rst:1476 msgid ":attr:`sys.implementation.cache_tag `" msgstr "" -#: whatsnew/3.12.rst:1614 +#: whatsnew/3.12.rst:1477 msgid "``imp.load_module()``" msgstr "" -#: whatsnew/3.12.rst:1614 +#: whatsnew/3.12.rst:1477 msgid ":func:`importlib.import_module`" msgstr "" -#: whatsnew/3.12.rst:1615 +#: whatsnew/3.12.rst:1478 msgid "``imp.new_module(name)``" msgstr "" -#: whatsnew/3.12.rst:1615 +#: whatsnew/3.12.rst:1478 msgid "``types.ModuleType(name)``" msgstr "" -#: whatsnew/3.12.rst:1616 +#: whatsnew/3.12.rst:1479 msgid "``imp.reload()``" msgstr "" -#: whatsnew/3.12.rst:1616 +#: whatsnew/3.12.rst:1479 msgid ":func:`importlib.reload`" msgstr "" -#: whatsnew/3.12.rst:1617 +#: whatsnew/3.12.rst:1480 msgid "``imp.source_from_cache()``" msgstr "" -#: whatsnew/3.12.rst:1617 +#: whatsnew/3.12.rst:1480 msgid ":func:`importlib.util.source_from_cache`" msgstr "" -#: whatsnew/3.12.rst:1618 +#: whatsnew/3.12.rst:1481 msgid "``imp.load_source()``" msgstr "" -#: whatsnew/3.12.rst:1618 +#: whatsnew/3.12.rst:1481 msgid "*See below*" msgstr "" -#: whatsnew/3.12.rst:1621 +#: whatsnew/3.12.rst:1484 msgid "Replace ``imp.load_source()`` with::" msgstr "" -#: whatsnew/3.12.rst:1636 +#: whatsnew/3.12.rst:1499 msgid "Remove :mod:`!imp` functions and attributes with no replacements:" msgstr "" -#: whatsnew/3.12.rst:1638 +#: whatsnew/3.12.rst:1501 msgid "Undocumented functions:" msgstr "" -#: whatsnew/3.12.rst:1640 +#: whatsnew/3.12.rst:1503 msgid "``imp.init_builtin()``" msgstr "" -#: whatsnew/3.12.rst:1641 +#: whatsnew/3.12.rst:1504 msgid "``imp.load_compiled()``" msgstr "" -#: whatsnew/3.12.rst:1642 +#: whatsnew/3.12.rst:1505 msgid "``imp.load_dynamic()``" msgstr "" -#: whatsnew/3.12.rst:1643 +#: whatsnew/3.12.rst:1506 msgid "``imp.load_package()``" msgstr "" -#: whatsnew/3.12.rst:1645 +#: whatsnew/3.12.rst:1508 msgid "" "``imp.lock_held()``, ``imp.acquire_lock()``, ``imp.release_lock()``: the " "locking scheme has changed in Python 3.3 to per-module locks." msgstr "" -#: whatsnew/3.12.rst:1647 +#: whatsnew/3.12.rst:1510 msgid "" "``imp.find_module()`` constants: ``SEARCH_ERROR``, ``PY_SOURCE``, " "``PY_COMPILED``, ``C_EXTENSION``, ``PY_RESOURCE``, ``PKG_DIRECTORY``, " "``C_BUILTIN``, ``PY_FROZEN``, ``PY_CODERESOURCE``, ``IMP_HOOK``." msgstr "" -#: whatsnew/3.12.rst:1652 +#: whatsnew/3.12.rst:1515 msgid "io" msgstr "" -#: whatsnew/3.12.rst:1654 +#: whatsnew/3.12.rst:1517 msgid "" "Remove :mod:`io`'s ``io.OpenWrapper`` and ``_pyio.OpenWrapper``, deprecated " "in Python 3.10: just use :func:`open` instead. The :func:`open` (:func:`io." @@ -2503,22 +2924,22 @@ msgid "" "`94169`.)" msgstr "" -#: whatsnew/3.12.rst:1661 +#: whatsnew/3.12.rst:1524 msgid "locale" msgstr "" -#: whatsnew/3.12.rst:1663 +#: whatsnew/3.12.rst:1526 msgid "" "Remove :mod:`locale`'s :func:`!locale.format` function, deprecated in Python " "3.7: use :func:`locale.format_string` instead. (Contributed by Victor " "Stinner in :gh:`94226`.)" msgstr "" -#: whatsnew/3.12.rst:1668 +#: whatsnew/3.12.rst:1531 msgid "smtpd" msgstr "" -#: whatsnew/3.12.rst:1670 +#: whatsnew/3.12.rst:1533 msgid "" "The ``smtpd`` module has been removed according to the schedule in :pep:" "`594`, having been deprecated in Python 3.4.7 and 3.5.4. Use the :pypi:" @@ -2526,27 +2947,27 @@ msgid "" "(Contributed by Oleg Iarygin in :gh:`93243`.)" msgstr "" -#: whatsnew/3.12.rst:1679 +#: whatsnew/3.12.rst:1542 msgid "" "The following undocumented :mod:`sqlite3` features, deprecated in Python " "3.10, are now removed:" msgstr "" -#: whatsnew/3.12.rst:1682 +#: whatsnew/3.12.rst:1545 msgid "``sqlite3.enable_shared_cache()``" msgstr "" -#: whatsnew/3.12.rst:1683 +#: whatsnew/3.12.rst:1546 msgid "``sqlite3.OptimizedUnicode``" msgstr "" -#: whatsnew/3.12.rst:1685 +#: whatsnew/3.12.rst:1548 msgid "" "If a shared cache must be used, open the database in URI mode using the " "``cache=shared`` query parameter." msgstr "" -#: whatsnew/3.12.rst:1688 +#: whatsnew/3.12.rst:1551 msgid "" "The ``sqlite3.OptimizedUnicode`` text factory has been an alias for :class:" "`str` since Python 3.3. Code that previously set the text factory to " @@ -2554,22 +2975,22 @@ msgid "" "default value which is also ``str``." msgstr "" -#: whatsnew/3.12.rst:1693 +#: whatsnew/3.12.rst:1556 msgid "(Contributed by Erlend E. Aasland in :gh:`92548`.)" msgstr "" -#: whatsnew/3.12.rst:1696 +#: whatsnew/3.12.rst:1559 msgid "ssl" msgstr "" -#: whatsnew/3.12.rst:1698 +#: whatsnew/3.12.rst:1561 msgid "" "Remove :mod:`ssl`'s :func:`!ssl.RAND_pseudo_bytes` function, deprecated in " "Python 3.6: use :func:`os.urandom` or :func:`ssl.RAND_bytes` instead. " "(Contributed by Victor Stinner in :gh:`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1702 +#: whatsnew/3.12.rst:1565 msgid "" "Remove the :func:`!ssl.match_hostname` function. It was deprecated in Python " "3.7. OpenSSL performs hostname matching since Python 3.7, Python no longer " @@ -2577,7 +2998,7 @@ msgid "" "Stinner in :gh:`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1708 +#: whatsnew/3.12.rst:1571 msgid "" "Remove the :func:`!ssl.wrap_socket` function, deprecated in Python 3.7: " "instead, create a :class:`ssl.SSLContext` object and call its :class:`ssl." @@ -2588,185 +3009,185 @@ msgid "" "`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1719 +#: whatsnew/3.12.rst:1582 msgid "Remove many long-deprecated :mod:`unittest` features:" msgstr "" -#: whatsnew/3.12.rst:1723 +#: whatsnew/3.12.rst:1586 msgid "A number of :class:`~unittest.TestCase` method aliases:" msgstr "" -#: whatsnew/3.12.rst:1726 +#: whatsnew/3.12.rst:1589 msgid "Deprecated alias" msgstr "" -#: whatsnew/3.12.rst:1726 +#: whatsnew/3.12.rst:1589 msgid "Method Name" msgstr "" -#: whatsnew/3.12.rst:1726 +#: whatsnew/3.12.rst:1589 msgid "Deprecated in" msgstr "" -#: whatsnew/3.12.rst:1728 +#: whatsnew/3.12.rst:1591 msgid "``failUnless``" msgstr "" -#: whatsnew/3.12.rst:1735 +#: whatsnew/3.12.rst:1598 msgid ":meth:`.assertTrue`" msgstr "" -#: whatsnew/3.12.rst:1729 whatsnew/3.12.rst:1731 whatsnew/3.12.rst:1733 -#: whatsnew/3.12.rst:1734 +#: whatsnew/3.12.rst:1592 whatsnew/3.12.rst:1594 whatsnew/3.12.rst:1596 +#: whatsnew/3.12.rst:1597 msgid "3.1" msgstr "" -#: whatsnew/3.12.rst:1729 +#: whatsnew/3.12.rst:1592 msgid "``failIf``" msgstr "" -#: whatsnew/3.12.rst:1729 +#: whatsnew/3.12.rst:1592 msgid ":meth:`.assertFalse`" msgstr "" -#: whatsnew/3.12.rst:1730 +#: whatsnew/3.12.rst:1593 msgid "``failUnlessEqual``" msgstr "" -#: whatsnew/3.12.rst:1736 +#: whatsnew/3.12.rst:1599 msgid ":meth:`.assertEqual`" msgstr "" -#: whatsnew/3.12.rst:1731 +#: whatsnew/3.12.rst:1594 msgid "``failIfEqual``" msgstr "" -#: whatsnew/3.12.rst:1737 +#: whatsnew/3.12.rst:1600 msgid ":meth:`.assertNotEqual`" msgstr "" -#: whatsnew/3.12.rst:1732 +#: whatsnew/3.12.rst:1595 msgid "``failUnlessAlmostEqual``" msgstr "" -#: whatsnew/3.12.rst:1738 +#: whatsnew/3.12.rst:1601 msgid ":meth:`.assertAlmostEqual`" msgstr "" -#: whatsnew/3.12.rst:1733 +#: whatsnew/3.12.rst:1596 msgid "``failIfAlmostEqual``" msgstr "" -#: whatsnew/3.12.rst:1739 +#: whatsnew/3.12.rst:1602 msgid ":meth:`.assertNotAlmostEqual`" msgstr "" -#: whatsnew/3.12.rst:1734 +#: whatsnew/3.12.rst:1597 msgid "``failUnlessRaises``" msgstr "" -#: whatsnew/3.12.rst:1734 +#: whatsnew/3.12.rst:1597 msgid ":meth:`.assertRaises`" msgstr "" -#: whatsnew/3.12.rst:1735 +#: whatsnew/3.12.rst:1598 msgid "``assert_``" msgstr "" -#: whatsnew/3.12.rst:1736 whatsnew/3.12.rst:1738 whatsnew/3.12.rst:1740 -#: whatsnew/3.12.rst:1741 +#: whatsnew/3.12.rst:1599 whatsnew/3.12.rst:1601 whatsnew/3.12.rst:1603 +#: whatsnew/3.12.rst:1604 msgid "3.2" msgstr "" -#: whatsnew/3.12.rst:1736 +#: whatsnew/3.12.rst:1599 msgid "``assertEquals``" msgstr "" -#: whatsnew/3.12.rst:1737 +#: whatsnew/3.12.rst:1600 msgid "``assertNotEquals``" msgstr "" -#: whatsnew/3.12.rst:1738 +#: whatsnew/3.12.rst:1601 msgid "``assertAlmostEquals``" msgstr "" -#: whatsnew/3.12.rst:1739 +#: whatsnew/3.12.rst:1602 msgid "``assertNotAlmostEquals``" msgstr "" -#: whatsnew/3.12.rst:1740 +#: whatsnew/3.12.rst:1603 msgid "``assertRegexpMatches``" msgstr "" -#: whatsnew/3.12.rst:1740 +#: whatsnew/3.12.rst:1603 msgid ":meth:`.assertRegex`" msgstr "" -#: whatsnew/3.12.rst:1741 +#: whatsnew/3.12.rst:1604 msgid "``assertRaisesRegexp``" msgstr "" -#: whatsnew/3.12.rst:1741 +#: whatsnew/3.12.rst:1604 msgid ":meth:`.assertRaisesRegex`" msgstr "" -#: whatsnew/3.12.rst:1742 +#: whatsnew/3.12.rst:1605 msgid "``assertNotRegexpMatches``" msgstr "" -#: whatsnew/3.12.rst:1742 +#: whatsnew/3.12.rst:1605 msgid ":meth:`.assertNotRegex`" msgstr "" -#: whatsnew/3.12.rst:1742 +#: whatsnew/3.12.rst:1605 msgid "3.5" msgstr "" -#: whatsnew/3.12.rst:1745 +#: whatsnew/3.12.rst:1608 msgid "" "You can use https://github.com/isidentical/teyit to automatically modernise " "your unit tests." msgstr "" -#: whatsnew/3.12.rst:1748 +#: whatsnew/3.12.rst:1611 msgid "" "Undocumented and broken :class:`~unittest.TestCase` method " "``assertDictContainsSubset`` (deprecated in Python 3.2)." msgstr "" -#: whatsnew/3.12.rst:1751 +#: whatsnew/3.12.rst:1614 msgid "" "Undocumented :meth:`TestLoader.loadTestsFromModule ` parameter *use_load_tests* (deprecated and ignored " "since Python 3.5)." msgstr "" -#: whatsnew/3.12.rst:1755 +#: whatsnew/3.12.rst:1618 msgid "" "An alias of the :class:`~unittest.TextTestResult` class: ``_TextTestResult`` " "(deprecated in Python 3.2)." msgstr "" -#: whatsnew/3.12.rst:1758 +#: whatsnew/3.12.rst:1621 msgid "(Contributed by Serhiy Storchaka in :gh:`89325`.)" msgstr "" -#: whatsnew/3.12.rst:1761 +#: whatsnew/3.12.rst:1624 msgid "webbrowser" msgstr "" -#: whatsnew/3.12.rst:1763 +#: whatsnew/3.12.rst:1626 msgid "" "Remove support for obsolete browsers from :mod:`webbrowser`. The removed " "browsers include: Grail, Mosaic, Netscape, Galeon, Skipstone, Iceape, " "Firebird, and Firefox versions 35 and below (:gh:`102871`)." msgstr "" -#: whatsnew/3.12.rst:1768 +#: whatsnew/3.12.rst:1631 msgid "xml.etree.ElementTree" msgstr "" -#: whatsnew/3.12.rst:1770 +#: whatsnew/3.12.rst:1633 msgid "" "Remove the ``ElementTree.Element.copy()`` method of the pure Python " "implementation, deprecated in Python 3.10, use the :func:`copy.copy` " @@ -2775,22 +3196,22 @@ msgid "" "Stinner in :gh:`94383`.)" msgstr "" -#: whatsnew/3.12.rst:1777 +#: whatsnew/3.12.rst:1640 msgid "zipimport" msgstr "" -#: whatsnew/3.12.rst:1779 +#: whatsnew/3.12.rst:1642 msgid "" "Remove :mod:`zipimport`'s ``find_loader()`` and ``find_module()`` methods, " "deprecated in Python 3.10: use the ``find_spec()`` method instead. See :pep:" "`451` for the rationale. (Contributed by Victor Stinner in :gh:`94379`.)" msgstr "" -#: whatsnew/3.12.rst:1785 +#: whatsnew/3.12.rst:1648 msgid "Others" msgstr "" -#: whatsnew/3.12.rst:1787 +#: whatsnew/3.12.rst:1650 msgid "" "Remove the ``suspicious`` rule from the documentation :file:`Makefile` and :" "file:`Doc/tools/rstlint.py`, both in favor of `sphinx-lint `, " "intended for low-level tools like debuggers and JIT compilers. This API may " @@ -3060,84 +3481,84 @@ msgid "" "contents are marked by the ``PyUnstable_`` prefix in names." msgstr "" -#: whatsnew/3.12.rst:1983 +#: whatsnew/3.12.rst:1846 msgid "Code object constructors:" msgstr "" -#: whatsnew/3.12.rst:1985 +#: whatsnew/3.12.rst:1848 msgid "``PyUnstable_Code_New()`` (renamed from ``PyCode_New``)" msgstr "" -#: whatsnew/3.12.rst:1986 +#: whatsnew/3.12.rst:1849 msgid "" "``PyUnstable_Code_NewWithPosOnlyArgs()`` (renamed from " "``PyCode_NewWithPosOnlyArgs``)" msgstr "" -#: whatsnew/3.12.rst:1988 +#: whatsnew/3.12.rst:1851 msgid "Extra storage for code objects (:pep:`523`):" msgstr "" -#: whatsnew/3.12.rst:1990 +#: whatsnew/3.12.rst:1853 msgid "" "``PyUnstable_Eval_RequestCodeExtraIndex()`` (renamed from " "``_PyEval_RequestCodeExtraIndex``)" msgstr "" -#: whatsnew/3.12.rst:1991 +#: whatsnew/3.12.rst:1854 msgid "``PyUnstable_Code_GetExtra()`` (renamed from ``_PyCode_GetExtra``)" msgstr "" -#: whatsnew/3.12.rst:1992 +#: whatsnew/3.12.rst:1855 msgid "``PyUnstable_Code_SetExtra()`` (renamed from ``_PyCode_SetExtra``)" msgstr "" -#: whatsnew/3.12.rst:1994 +#: whatsnew/3.12.rst:1857 msgid "" "The original names will continue to be available until the respective API " "changes." msgstr "" -#: whatsnew/3.12.rst:1997 +#: whatsnew/3.12.rst:1860 msgid "(Contributed by Petr Viktorin in :gh:`101101`.)" msgstr "" -#: whatsnew/3.12.rst:1999 +#: whatsnew/3.12.rst:1862 msgid "" ":pep:`697`: Add an API for extending types whose instance memory layout is " "opaque:" msgstr "" -#: whatsnew/3.12.rst:2002 +#: whatsnew/3.12.rst:1865 msgid "" ":c:member:`PyType_Spec.basicsize` can be zero or negative to specify " "inheriting or extending the base class size." msgstr "" -#: whatsnew/3.12.rst:2004 +#: whatsnew/3.12.rst:1867 msgid "" ":c:func:`PyObject_GetTypeData` and :c:func:`PyType_GetTypeDataSize` added to " "allow access to subclass-specific instance data." msgstr "" -#: whatsnew/3.12.rst:2006 +#: whatsnew/3.12.rst:1869 msgid "" ":c:macro:`Py_TPFLAGS_ITEMS_AT_END` and :c:func:`PyObject_GetItemData` added " "to allow safely extending certain variable-sized types, including :c:var:" "`PyType_Type`." msgstr "" -#: whatsnew/3.12.rst:2009 +#: whatsnew/3.12.rst:1872 msgid "" ":c:macro:`Py_RELATIVE_OFFSET` added to allow defining :c:type:`members " "` in terms of a subclass-specific struct." msgstr "" -#: whatsnew/3.12.rst:2012 +#: whatsnew/3.12.rst:1875 msgid "(Contributed by Petr Viktorin in :gh:`103509`.)" msgstr "" -#: whatsnew/3.12.rst:2014 +#: whatsnew/3.12.rst:1877 msgid "" "Add the new :ref:`limited C API ` function :c:func:" "`PyType_FromMetaclass`, which generalizes the existing :c:func:" @@ -3145,29 +3566,29 @@ msgid "" "(Contributed by Wenzel Jakob in :gh:`93012`.)" msgstr "" -#: whatsnew/3.12.rst:2019 +#: whatsnew/3.12.rst:1882 msgid "" "API for creating objects that can be called using :ref:`the vectorcall " "protocol ` was added to the :ref:`Limited API `:" msgstr "" -#: whatsnew/3.12.rst:2023 +#: whatsnew/3.12.rst:1886 msgid ":c:macro:`Py_TPFLAGS_HAVE_VECTORCALL`" msgstr "" -#: whatsnew/3.12.rst:2024 +#: whatsnew/3.12.rst:1887 msgid ":c:func:`PyVectorcall_NARGS`" msgstr "" -#: whatsnew/3.12.rst:2025 +#: whatsnew/3.12.rst:1888 msgid ":c:func:`PyVectorcall_Call`" msgstr "" -#: whatsnew/3.12.rst:2026 +#: whatsnew/3.12.rst:1889 msgid ":c:type:`vectorcallfunc`" msgstr "" -#: whatsnew/3.12.rst:2028 +#: whatsnew/3.12.rst:1891 msgid "" "The :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag is now removed from a class " "when the class's :py:meth:`~object.__call__` method is reassigned. This " @@ -3178,7 +3599,7 @@ msgid "" "`93274`.)" msgstr "" -#: whatsnew/3.12.rst:2036 +#: whatsnew/3.12.rst:1899 msgid "" "The :c:macro:`Py_TPFLAGS_MANAGED_DICT` and :c:macro:" "`Py_TPFLAGS_MANAGED_WEAKREF` flags have been added. This allows extensions " @@ -3186,32 +3607,32 @@ msgid "" "using less memory and with faster access." msgstr "" -#: whatsnew/3.12.rst:2041 +#: whatsnew/3.12.rst:1904 msgid "" "API for performing calls using :ref:`the vectorcall protocol ` " "was added to the :ref:`Limited API `:" msgstr "" -#: whatsnew/3.12.rst:2045 +#: whatsnew/3.12.rst:1908 msgid ":c:func:`PyObject_Vectorcall`" msgstr "" -#: whatsnew/3.12.rst:2046 +#: whatsnew/3.12.rst:1909 msgid ":c:func:`PyObject_VectorcallMethod`" msgstr "" -#: whatsnew/3.12.rst:2047 +#: whatsnew/3.12.rst:1910 msgid ":c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET`" msgstr "" -#: whatsnew/3.12.rst:2049 +#: whatsnew/3.12.rst:1912 msgid "" "This means that both the incoming and outgoing ends of the vector call " "protocol are now available in the :ref:`Limited API `. (Contributed " "by Wenzel Jakob in :gh:`98586`.)" msgstr "" -#: whatsnew/3.12.rst:2053 +#: whatsnew/3.12.rst:1916 msgid "" "Add two new public functions, :c:func:`PyEval_SetProfileAllThreads` and :c:" "func:`PyEval_SetTraceAllThreads`, that allow to set tracing and profiling " @@ -3219,14 +3640,14 @@ msgid "" "(Contributed by Pablo Galindo in :gh:`93503`.)" msgstr "" -#: whatsnew/3.12.rst:2059 +#: whatsnew/3.12.rst:1922 msgid "" "Add new function :c:func:`PyFunction_SetVectorcall` to the C API which sets " "the vectorcall field of a given :c:type:`PyFunctionObject`. (Contributed by " "Andrew Frost in :gh:`92257`.)" msgstr "" -#: whatsnew/3.12.rst:2063 +#: whatsnew/3.12.rst:1926 msgid "" "The C API now permits registering callbacks via :c:func:" "`PyDict_AddWatcher`, :c:func:`PyDict_Watch` and related APIs to be called " @@ -3235,28 +3656,28 @@ msgid "" "`91052`.)" msgstr "" -#: whatsnew/3.12.rst:2069 +#: whatsnew/3.12.rst:1932 msgid "" "Add :c:func:`PyType_AddWatcher` and :c:func:`PyType_Watch` API to register " "callbacks to receive notification on changes to a type. (Contributed by Carl " "Meyer in :gh:`91051`.)" msgstr "" -#: whatsnew/3.12.rst:2073 +#: whatsnew/3.12.rst:1936 msgid "" "Add :c:func:`PyCode_AddWatcher` and :c:func:`PyCode_ClearWatcher` APIs to " "register callbacks to receive notification on creation and destruction of " "code objects. (Contributed by Itamar Oren in :gh:`91054`.)" msgstr "" -#: whatsnew/3.12.rst:2078 +#: whatsnew/3.12.rst:1941 msgid "" "Add :c:func:`PyFrame_GetVar` and :c:func:`PyFrame_GetVarString` functions to " "get a frame variable by its name. (Contributed by Victor Stinner in :gh:" "`91248`.)" msgstr "" -#: whatsnew/3.12.rst:2082 +#: whatsnew/3.12.rst:1945 msgid "" "Add :c:func:`PyErr_GetRaisedException` and :c:func:" "`PyErr_SetRaisedException` for saving and restoring the current exception. " @@ -3266,14 +3687,14 @@ msgid "" "(Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2090 +#: whatsnew/3.12.rst:1953 msgid "" "Add ``_PyErr_ChainExceptions1``, which takes an exception instance, to " "replace the legacy-API ``_PyErr_ChainExceptions``, which is now deprecated. " "(Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2094 +#: whatsnew/3.12.rst:1957 msgid "" "Add :c:func:`PyException_GetArgs` and :c:func:`PyException_SetArgs` as " "convenience functions for retrieving and modifying the :attr:`~BaseException." @@ -3281,71 +3702,71 @@ msgid "" "in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2099 +#: whatsnew/3.12.rst:1962 msgid "" "Add :c:func:`PyErr_DisplayException`, which takes an exception instance, to " "replace the legacy-api :c:func:`!PyErr_Display`. (Contributed by Irit " "Katriel in :gh:`102755`)." msgstr "" -#: whatsnew/3.12.rst:2105 +#: whatsnew/3.12.rst:1968 msgid "" ":pep:`683`: Introduce *Immortal Objects*, which allows objects to bypass " "reference counts, and related changes to the C-API:" msgstr "" -#: whatsnew/3.12.rst:2108 +#: whatsnew/3.12.rst:1971 msgid "``_Py_IMMORTAL_REFCNT``: The reference count that defines an object" msgstr "" -#: whatsnew/3.12.rst:2109 +#: whatsnew/3.12.rst:1972 msgid "as immortal." msgstr "" -#: whatsnew/3.12.rst:2110 +#: whatsnew/3.12.rst:1973 msgid "" "``_Py_IsImmortal`` Checks if an object has the immortal reference count." msgstr "" -#: whatsnew/3.12.rst:2111 +#: whatsnew/3.12.rst:1974 msgid "``PyObject_HEAD_INIT`` This will now initialize reference count to" msgstr "" -#: whatsnew/3.12.rst:2112 +#: whatsnew/3.12.rst:1975 msgid "``_Py_IMMORTAL_REFCNT`` when used with ``Py_BUILD_CORE``." msgstr "" -#: whatsnew/3.12.rst:2113 +#: whatsnew/3.12.rst:1976 msgid "``SSTATE_INTERNED_IMMORTAL`` An identifier for interned unicode objects" msgstr "" -#: whatsnew/3.12.rst:2114 +#: whatsnew/3.12.rst:1977 msgid "that are immortal." msgstr "" -#: whatsnew/3.12.rst:2115 +#: whatsnew/3.12.rst:1978 msgid "``SSTATE_INTERNED_IMMORTAL_STATIC`` An identifier for interned unicode" msgstr "" -#: whatsnew/3.12.rst:2116 +#: whatsnew/3.12.rst:1979 msgid "objects that are immortal and static" msgstr "" -#: whatsnew/3.12.rst:2117 +#: whatsnew/3.12.rst:1980 msgid "``sys.getunicodeinternedsize`` This returns the total number of unicode" msgstr "" -#: whatsnew/3.12.rst:2118 +#: whatsnew/3.12.rst:1981 msgid "" "objects that have been interned. This is now needed for :file:`refleak.py` " "to correctly track reference counts and allocated blocks" msgstr "" -#: whatsnew/3.12.rst:2121 +#: whatsnew/3.12.rst:1984 msgid "(Contributed by Eddie Elizondo in :gh:`84436`.)" msgstr "" -#: whatsnew/3.12.rst:2123 +#: whatsnew/3.12.rst:1986 msgid "" ":pep:`684`: Add the new :c:func:`Py_NewInterpreterFromConfig` function and :" "c:type:`PyInterpreterConfig`, which may be used to create sub-interpreters " @@ -3353,27 +3774,27 @@ msgid "" "(Contributed by Eric Snow in :gh:`104110`.)" msgstr "" -#: whatsnew/3.12.rst:2129 +#: whatsnew/3.12.rst:1992 msgid "" "In the limited C API version 3.12, :c:func:`Py_INCREF` and :c:func:" "`Py_DECREF` functions are now implemented as opaque function calls to hide " "implementation details. (Contributed by Victor Stinner in :gh:`105387`.)" msgstr "" -#: whatsnew/3.12.rst:2137 +#: whatsnew/3.12.rst:2000 msgid "" "Legacy Unicode APIs based on ``Py_UNICODE*`` representation has been " "removed. Please migrate to APIs based on UTF-8 or ``wchar_t*``." msgstr "" -#: whatsnew/3.12.rst:2140 +#: whatsnew/3.12.rst:2003 msgid "" "Argument parsing functions like :c:func:`PyArg_ParseTuple` doesn't support " "``Py_UNICODE*`` based format (e.g. ``u``, ``Z``) anymore. Please migrate to " "other formats for Unicode like ``s``, ``z``, ``es``, and ``U``." msgstr "" -#: whatsnew/3.12.rst:2144 +#: whatsnew/3.12.rst:2007 msgid "" "``tp_weaklist`` for all static builtin types is always ``NULL``. This is an " "internal-only field on ``PyTypeObject`` but we're pointing out the change in " @@ -3382,7 +3803,7 @@ msgid "" "necessary, the (internal-only) ``_PyObject_GET_WEAKREFS_LISTPTR()`` macro." msgstr "" -#: whatsnew/3.12.rst:2151 +#: whatsnew/3.12.rst:2014 msgid "" "This internal-only :c:member:`PyTypeObject.tp_subclasses` may now not be a " "valid object pointer. Its type was changed to :c:expr:`void *` to reflect " @@ -3390,13 +3811,13 @@ msgid "" "only field directly." msgstr "" -#: whatsnew/3.12.rst:2156 +#: whatsnew/3.12.rst:2019 msgid "" "To get a list of subclasses, call the Python method :py:meth:`~class." "__subclasses__` (using :c:func:`PyObject_CallMethod`, for example)." msgstr "" -#: whatsnew/3.12.rst:2160 +#: whatsnew/3.12.rst:2023 msgid "" "Add support of more formatting options (left aligning, octals, uppercase " "hexadecimals, :c:type:`intmax_t`, :c:type:`ptrdiff_t`, :c:type:`wchar_t` C " @@ -3405,7 +3826,7 @@ msgid "" "`98836`.)" msgstr "" -#: whatsnew/3.12.rst:2166 +#: whatsnew/3.12.rst:2029 msgid "" "An unrecognized format character in :c:func:`PyUnicode_FromFormat` and :c:" "func:`PyUnicode_FromFormatV` now sets a :exc:`SystemError`. In previous " @@ -3414,13 +3835,13 @@ msgid "" "Storchaka in :gh:`95781`.)" msgstr "" -#: whatsnew/3.12.rst:2172 +#: whatsnew/3.12.rst:2035 msgid "" "Fix wrong sign placement in :c:func:`PyUnicode_FromFormat` and :c:func:" "`PyUnicode_FromFormatV`. (Contributed by Philip Georgi in :gh:`95504`.)" msgstr "" -#: whatsnew/3.12.rst:2176 +#: whatsnew/3.12.rst:2039 msgid "" "Extension classes wanting to add a ``__dict__`` or weak reference slot " "should use :c:macro:`Py_TPFLAGS_MANAGED_DICT` and :c:macro:" @@ -3434,7 +3855,7 @@ msgid "" "func:`PyObject_ClearWeakRefs`, as before." msgstr "" -#: whatsnew/3.12.rst:2188 +#: whatsnew/3.12.rst:2051 msgid "" "The :c:func:`PyUnicode_FSDecoder` function no longer accepts bytes-like " "paths, like :class:`bytearray` and :class:`memoryview` types: only the " @@ -3442,7 +3863,7 @@ msgid "" "Victor Stinner in :gh:`98393`.)" msgstr "" -#: whatsnew/3.12.rst:2193 +#: whatsnew/3.12.rst:2056 msgid "" "The :c:macro:`Py_CLEAR`, :c:macro:`Py_SETREF` and :c:macro:`Py_XSETREF` " "macros now only evaluate their arguments once. If an argument has side " @@ -3450,7 +3871,7 @@ msgid "" "Stinner in :gh:`98724`.)" msgstr "" -#: whatsnew/3.12.rst:2198 +#: whatsnew/3.12.rst:2061 msgid "" "The interpreter's error indicator is now always normalized. This means that :" "c:func:`PyErr_SetObject`, :c:func:`PyErr_SetString` and the other functions " @@ -3458,7 +3879,7 @@ msgid "" "(Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2203 +#: whatsnew/3.12.rst:2066 msgid "" "``_Py_RefTotal`` is no longer authoritative and only kept around for ABI " "compatibility. Note that it is an internal global and only available on " @@ -3466,25 +3887,25 @@ msgid "" "``_Py_GetGlobalRefTotal()``." msgstr "" -#: whatsnew/3.12.rst:2208 +#: whatsnew/3.12.rst:2071 msgid "" "The following functions now select an appropriate metaclass for the newly " "created type:" msgstr "" -#: whatsnew/3.12.rst:2211 +#: whatsnew/3.12.rst:2074 msgid ":c:func:`PyType_FromSpec`" msgstr "" -#: whatsnew/3.12.rst:2212 +#: whatsnew/3.12.rst:2075 msgid ":c:func:`PyType_FromSpecWithBases`" msgstr "" -#: whatsnew/3.12.rst:2213 +#: whatsnew/3.12.rst:2076 msgid ":c:func:`PyType_FromModuleAndSpec`" msgstr "" -#: whatsnew/3.12.rst:2215 +#: whatsnew/3.12.rst:2078 msgid "" "Creating classes whose metaclass overrides :c:member:`~PyTypeObject.tp_new` " "is deprecated, and in Python 3.14+ it will be disallowed. Note that these " @@ -3492,14 +3913,14 @@ msgid "" "initialization." msgstr "" -#: whatsnew/3.12.rst:2220 +#: whatsnew/3.12.rst:2083 msgid "" "Note that :c:func:`PyType_FromMetaclass` (added in Python 3.12) already " "disallows creating classes whose metaclass overrides ``tp_new`` (:meth:" "`~object.__new__` in Python)." msgstr "" -#: whatsnew/3.12.rst:2224 +#: whatsnew/3.12.rst:2087 msgid "" "Since ``tp_new`` overrides almost everything ``PyType_From*`` functions do, " "the two are incompatible with each other. The existing behavior -- ignoring " @@ -3508,17 +3929,17 @@ msgid "" "general workaround. One of the following may work for you:" msgstr "" -#: whatsnew/3.12.rst:2231 +#: whatsnew/3.12.rst:2094 msgid "If you control the metaclass, avoid using ``tp_new`` in it:" msgstr "" -#: whatsnew/3.12.rst:2233 +#: whatsnew/3.12.rst:2096 msgid "" "If initialization can be skipped, it can be done in :c:member:`~PyTypeObject." "tp_init` instead." msgstr "" -#: whatsnew/3.12.rst:2235 +#: whatsnew/3.12.rst:2098 msgid "" "If the metaclass doesn't need to be instantiated from Python, set its " "``tp_new`` to ``NULL`` using the :c:macro:" @@ -3526,20 +3947,20 @@ msgid "" "``PyType_From*`` functions." msgstr "" -#: whatsnew/3.12.rst:2240 +#: whatsnew/3.12.rst:2103 msgid "" "Avoid ``PyType_From*`` functions: if you don't need C-specific features " "(slots or setting the instance size), create types by :ref:`calling ` " "the metaclass." msgstr "" -#: whatsnew/3.12.rst:2244 +#: whatsnew/3.12.rst:2107 msgid "" "If you *know* the ``tp_new`` can be skipped safely, filter the deprecation " "warning out using :func:`warnings.catch_warnings` from Python." msgstr "" -#: whatsnew/3.12.rst:2247 +#: whatsnew/3.12.rst:2110 msgid "" ":c:var:`PyOS_InputHook` and :c:var:`PyOS_ReadlineFunctionPointer` are no " "longer called in :ref:`subinterpreters `. This is " @@ -3547,14 +3968,14 @@ msgid "" "callbacks have no way of recovering extension module state)." msgstr "" -#: whatsnew/3.12.rst:2252 +#: whatsnew/3.12.rst:2115 msgid "" "This also avoids situations where extensions may find themselves running in " "a subinterpreter that they don't support (or haven't yet been loaded in). " "See :gh:`104668` for more info." msgstr "" -#: whatsnew/3.12.rst:2256 +#: whatsnew/3.12.rst:2119 msgid "" ":c:struct:`PyLongObject` has had its internals changed for better " "performance. Although the internals of :c:struct:`PyLongObject` are private, " @@ -3565,15 +3986,15 @@ msgid "" "a single machine word:" msgstr "" -#: whatsnew/3.12.rst:2264 +#: whatsnew/3.12.rst:2127 msgid ":c:func:`PyUnstable_Long_IsCompact`" msgstr "" -#: whatsnew/3.12.rst:2265 +#: whatsnew/3.12.rst:2128 msgid ":c:func:`PyUnstable_Long_CompactValue`" msgstr "" -#: whatsnew/3.12.rst:2267 +#: whatsnew/3.12.rst:2130 msgid "" "Custom allocators, set via :c:func:`PyMem_SetAllocator`, are now required to " "be thread-safe, regardless of memory domain. Allocators that don't have " @@ -3582,7 +4003,7 @@ msgid "" "create a new GitHub issue and CC ``@ericsnowcurrently``." msgstr "" -#: whatsnew/3.12.rst:2277 +#: whatsnew/3.12.rst:2140 msgid "" "In accordance with :pep:`699`, the ``ma_version_tag`` field in :c:type:" "`PyDictObject` is deprecated for extension modules. Accessing this field " @@ -3591,458 +4012,618 @@ msgid "" "PEP by Ken Jin.)" msgstr "" -#: whatsnew/3.12.rst:2282 +#: whatsnew/3.12.rst:2145 msgid "Deprecate global configuration variable:" msgstr "" -#: whatsnew/3.12.rst:2369 +#: whatsnew/3.12.rst:2147 msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug`" msgstr "" -#: whatsnew/3.12.rst:2370 +#: whatsnew/3.12.rst:2148 msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose`" msgstr "" -#: whatsnew/3.12.rst:2371 +#: whatsnew/3.12.rst:2149 msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet`" msgstr "" -#: whatsnew/3.12.rst:2372 +#: whatsnew/3.12.rst:2150 msgid ":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive`" msgstr "" -#: whatsnew/3.12.rst:2373 +#: whatsnew/3.12.rst:2151 msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect`" msgstr "" -#: whatsnew/3.12.rst:2374 +#: whatsnew/3.12.rst:2152 msgid ":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level`" msgstr "" -#: whatsnew/3.12.rst:2375 +#: whatsnew/3.12.rst:2153 msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import`" msgstr "" -#: whatsnew/3.12.rst:2376 +#: whatsnew/3.12.rst:2154 msgid ":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning`" msgstr "" -#: whatsnew/3.12.rst:2377 +#: whatsnew/3.12.rst:2155 msgid ":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings`" msgstr "" -#: whatsnew/3.12.rst:2378 +#: whatsnew/3.12.rst:2156 msgid "" ":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment`" msgstr "" -#: whatsnew/3.12.rst:2379 +#: whatsnew/3.12.rst:2157 msgid "" ":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode`" msgstr "" -#: whatsnew/3.12.rst:2380 +#: whatsnew/3.12.rst:2158 msgid "" ":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig.user_site_directory`" msgstr "" -#: whatsnew/3.12.rst:2381 +#: whatsnew/3.12.rst:2159 msgid "" ":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio`" msgstr "" -#: whatsnew/3.12.rst:2382 +#: whatsnew/3.12.rst:2160 msgid "" ":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " "and :c:member:`PyConfig.hash_seed`" msgstr "" -#: whatsnew/3.12.rst:2384 +#: whatsnew/3.12.rst:2162 msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated`" msgstr "" -#: whatsnew/3.12.rst:2385 +#: whatsnew/3.12.rst:2163 msgid "" ":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." "legacy_windows_fs_encoding`" msgstr "" -#: whatsnew/3.12.rst:2386 +#: whatsnew/3.12.rst:2164 msgid "" ":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." "legacy_windows_stdio`" msgstr "" -#: whatsnew/3.12.rst:2387 +#: whatsnew/3.12.rst:2165 msgid "" ":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding`" msgstr "" -#: whatsnew/3.12.rst:2388 +#: whatsnew/3.12.rst:2166 msgid "" ":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding`" msgstr "" -#: whatsnew/3.12.rst:2389 +#: whatsnew/3.12.rst:2167 msgid "" ":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." "filesystem_errors`" msgstr "" -#: whatsnew/3.12.rst:2390 +#: whatsnew/3.12.rst:2168 msgid "" ":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` (see :c:func:" "`Py_PreInitialize`)" msgstr "" -#: whatsnew/3.12.rst:2307 +#: whatsnew/3.12.rst:2170 msgid "" "The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" "`PyConfig` instead. (Contributed by Victor Stinner in :gh:`77782`.)" msgstr "" -#: whatsnew/3.12.rst:2311 +#: whatsnew/3.12.rst:2174 msgid "" "Creating :c:data:`immutable types ` with mutable " "bases is deprecated and will be disabled in Python 3.14. (:gh:`95388`)" msgstr "" -#: whatsnew/3.12.rst:2314 +#: whatsnew/3.12.rst:2177 msgid "" "The :file:`structmember.h` header is deprecated, though it continues to be " "available and there are no plans to remove it." msgstr "" -#: whatsnew/3.12.rst:2317 +#: whatsnew/3.12.rst:2180 msgid "" "Its contents are now available just by including :file:`Python.h`, with a " "``Py`` prefix added if it was missing:" msgstr "" -#: whatsnew/3.12.rst:2320 +#: whatsnew/3.12.rst:2183 msgid "" ":c:struct:`PyMemberDef`, :c:func:`PyMember_GetOne` and :c:func:" "`PyMember_SetOne`" msgstr "" -#: whatsnew/3.12.rst:2322 +#: whatsnew/3.12.rst:2185 msgid "" "Type macros like :c:macro:`Py_T_INT`, :c:macro:`Py_T_DOUBLE`, etc. " "(previously ``T_INT``, ``T_DOUBLE``, etc.)" msgstr "" -#: whatsnew/3.12.rst:2324 +#: whatsnew/3.12.rst:2187 msgid "" "The flags :c:macro:`Py_READONLY` (previously ``READONLY``) and :c:macro:" "`Py_AUDIT_READ` (previously all uppercase)" msgstr "" -#: whatsnew/3.12.rst:2327 +#: whatsnew/3.12.rst:2190 msgid "Several items are not exposed from :file:`Python.h`:" msgstr "" -#: whatsnew/3.12.rst:2329 +#: whatsnew/3.12.rst:2192 msgid ":c:macro:`T_OBJECT` (use :c:macro:`Py_T_OBJECT_EX`)" msgstr "" -#: whatsnew/3.12.rst:2330 +#: whatsnew/3.12.rst:2193 msgid ":c:macro:`T_NONE` (previously undocumented, and pretty quirky)" msgstr "" -#: whatsnew/3.12.rst:2331 +#: whatsnew/3.12.rst:2194 msgid "The macro ``WRITE_RESTRICTED`` which does nothing." msgstr "" -#: whatsnew/3.12.rst:2332 +#: whatsnew/3.12.rst:2195 msgid "" "The macros ``RESTRICTED`` and ``READ_RESTRICTED``, equivalents of :c:macro:" "`Py_AUDIT_READ`." msgstr "" -#: whatsnew/3.12.rst:2334 +#: whatsnew/3.12.rst:2197 msgid "" "In some configurations, ```` is not included from :file:`Python." "h`. It should be included manually when using ``offsetof()``." msgstr "" -#: whatsnew/3.12.rst:2337 +#: whatsnew/3.12.rst:2200 msgid "" "The deprecated header continues to provide its original contents under the " "original names. Your old code can stay unchanged, unless the extra include " "and non-namespaced macros bother you greatly." msgstr "" -#: whatsnew/3.12.rst:2342 +#: whatsnew/3.12.rst:2205 msgid "" "(Contributed in :gh:`47146` by Petr Viktorin, based on earlier work by " "Alexander Belopolsky and Matthias Braun.)" msgstr "" -#: whatsnew/3.12.rst:2345 +#: whatsnew/3.12.rst:2208 msgid "" ":c:func:`PyErr_Fetch` and :c:func:`PyErr_Restore` are deprecated. Use :c:" "func:`PyErr_GetRaisedException` and :c:func:`PyErr_SetRaisedException` " "instead. (Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2350 +#: whatsnew/3.12.rst:2213 msgid "" ":c:func:`!PyErr_Display` is deprecated. Use :c:func:`PyErr_DisplayException` " "instead. (Contributed by Irit Katriel in :gh:`102755`)." msgstr "" -#: whatsnew/3.12.rst:2353 +#: whatsnew/3.12.rst:2216 msgid "" "``_PyErr_ChainExceptions`` is deprecated. Use ``_PyErr_ChainExceptions1`` " "instead. (Contributed by Irit Katriel in :gh:`102192`.)" msgstr "" -#: whatsnew/3.12.rst:2356 +#: whatsnew/3.12.rst:2219 msgid "" "Using :c:func:`PyType_FromSpec`, :c:func:`PyType_FromSpecWithBases` or :c:" "func:`PyType_FromModuleAndSpec` to create a class whose metaclass overrides :" "c:member:`~PyTypeObject.tp_new` is deprecated. Call the metaclass instead." msgstr "" -#: whatsnew/3.12.rst:2364 +#: deprecations/c-api-pending-removal-in-3.14.rst:4 msgid "" "The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules " "(:pep:`699`; :gh:`101193`)." msgstr "" -#: whatsnew/3.12.rst:2367 -msgid "Global configuration variables:" +#: deprecations/c-api-pending-removal-in-3.14.rst:7 +msgid "" +"Creating :c:data:`immutable types ` with mutable " +"bases (:gh:`95388`)." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:10 +msgid "" +"Functions to configure Python's initialization, deprecated in Python 3.11:" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:12 +msgid "``PySys_SetArgvEx()``: set :c:member:`PyConfig.argv` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:13 +msgid "``PySys_SetArgv()``: set :c:member:`PyConfig.argv` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:14 +msgid "``Py_SetProgramName()``: set :c:member:`PyConfig.program_name` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:15 +msgid "``Py_SetPythonHome()``: set :c:member:`PyConfig.home` instead." msgstr "" -#: whatsnew/3.12.rst:2392 +#: deprecations/c-api-pending-removal-in-3.14.rst:17 +#: deprecations/c-api-pending-removal-in-3.14.rst:45 msgid "" "The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" "`PyConfig` instead." msgstr "" -#: whatsnew/3.12.rst:2395 +#: deprecations/c-api-pending-removal-in-3.14.rst:20 +msgid "Global configuration variables:" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:22 +msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:23 +msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:24 +msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:25 msgid "" -"Creating :c:data:`immutable types ` with mutable " -"bases (:gh:`95388`)." +":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:26 +msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect` instead." msgstr "" -#: whatsnew/3.12.rst:2401 +#: deprecations/c-api-pending-removal-in-3.14.rst:27 msgid "" -":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule`" +":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level` " +"instead." msgstr "" -#: whatsnew/3.12.rst:2402 -msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t`" +#: deprecations/c-api-pending-removal-in-3.14.rst:28 +msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import` instead." msgstr "" -#: whatsnew/3.12.rst:2403 -msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t`" +#: deprecations/c-api-pending-removal-in-3.14.rst:29 +msgid "" +":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:30 +msgid "" +":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings` instead." msgstr "" -#: whatsnew/3.12.rst:2404 +#: deprecations/c-api-pending-removal-in-3.14.rst:31 +msgid "" +":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:32 +msgid "" +":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:33 +msgid "" +":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig." +"user_site_directory` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:34 +msgid "" +":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:35 +msgid "" +":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " +"and :c:member:`PyConfig.hash_seed` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:37 +msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:38 +msgid "" +":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." +"legacy_windows_fs_encoding` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:39 +msgid "" +":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." +"legacy_windows_stdio` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:40 +msgid "" +":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." +"filesystem_encoding` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:41 +msgid "" +":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." +"filesystem_encoding` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:42 +msgid "" +":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." +"filesystem_errors` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:43 +msgid "" +":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` instead. (see :" +"c:func:`Py_PreInitialize`)" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:4 +msgid "The bundled copy of ``libmpdecimal``." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:5 +msgid "" +":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:6 +msgid "" +":c:func:`PyWeakref_GET_OBJECT`: use :c:func:`!PyWeakref_GetRef` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:7 +msgid ":c:func:`PyWeakref_GetObject`: use :c:func:`!PyWeakref_GetRef` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:8 +msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:9 +msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:10 msgid "Python initialization functions:" msgstr "" -#: whatsnew/3.12.rst:2406 +#: deprecations/c-api-pending-removal-in-3.15.rst:12 msgid "" ":c:func:`PySys_ResetWarnOptions`: clear :data:`sys.warnoptions` and :data:`!" -"warnings.filters`" +"warnings.filters` instead." msgstr "" -#: whatsnew/3.12.rst:2408 -msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix`" +#: deprecations/c-api-pending-removal-in-3.15.rst:14 +msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix` instead." msgstr "" -#: whatsnew/3.12.rst:2409 -msgid ":c:func:`Py_GetPath`: get :data:`sys.path`" +#: deprecations/c-api-pending-removal-in-3.15.rst:15 +msgid ":c:func:`Py_GetPath`: get :data:`sys.path` instead." msgstr "" -#: whatsnew/3.12.rst:2410 -msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix`" +#: deprecations/c-api-pending-removal-in-3.15.rst:16 +msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix` instead." msgstr "" -#: whatsnew/3.12.rst:2411 -msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable`" +#: deprecations/c-api-pending-removal-in-3.15.rst:17 +msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable` instead." msgstr "" -#: whatsnew/3.12.rst:2412 -msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable`" +#: deprecations/c-api-pending-removal-in-3.15.rst:18 +msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable` instead." msgstr "" -#: whatsnew/3.12.rst:2413 +#: deprecations/c-api-pending-removal-in-3.15.rst:19 msgid "" ":c:func:`Py_GetPythonHome`: get :c:member:`PyConfig.home` or the :envvar:" -"`PYTHONHOME` environment variable" +"`PYTHONHOME` environment variable instead." msgstr "" -#: whatsnew/3.12.rst:2419 +#: deprecations/c-api-pending-removal-in-future.rst:4 msgid "" "The following APIs are deprecated and will be removed, although there is " "currently no date scheduled for their removal." msgstr "" -#: whatsnew/3.12.rst:2422 -msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8" +#: deprecations/c-api-pending-removal-in-future.rst:7 +msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8." msgstr "" -#: whatsnew/3.12.rst:2423 -msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException`" +#: deprecations/c-api-pending-removal-in-future.rst:8 +msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException` instead." msgstr "" -#: whatsnew/3.12.rst:2424 +#: deprecations/c-api-pending-removal-in-future.rst:9 msgid "" -":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException`" +":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException` " +"instead." msgstr "" -#: whatsnew/3.12.rst:2425 -msgid ":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException`" +#: deprecations/c-api-pending-removal-in-future.rst:10 +msgid "" +":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException` instead." msgstr "" -#: whatsnew/3.12.rst:2426 +#: deprecations/c-api-pending-removal-in-future.rst:11 msgid "" -":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject`" +":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject` " +"instead." msgstr "" -#: whatsnew/3.12.rst:2427 -msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child`" +#: deprecations/c-api-pending-removal-in-future.rst:12 +msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child` instead." msgstr "" -#: whatsnew/3.12.rst:2428 +#: deprecations/c-api-pending-removal-in-future.rst:13 msgid "" ":c:func:`PySlice_GetIndicesEx`: use :c:func:`PySlice_Unpack` and :c:func:" -"`PySlice_AdjustIndices`" +"`PySlice_AdjustIndices` instead." msgstr "" -#: whatsnew/3.12.rst:2429 -msgid ":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode`" +#: deprecations/c-api-pending-removal-in-future.rst:14 +msgid "" +":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode` instead." msgstr "" -#: whatsnew/3.12.rst:2430 -msgid ":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode`" +#: deprecations/c-api-pending-removal-in-future.rst:15 +msgid "" +":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode` instead." msgstr "" -#: whatsnew/3.12.rst:2431 -msgid ":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode`" +#: deprecations/c-api-pending-removal-in-future.rst:16 +msgid "" +":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode` instead." msgstr "" -#: whatsnew/3.12.rst:2432 -msgid ":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode`" +#: deprecations/c-api-pending-removal-in-future.rst:17 +msgid "" +":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode` instead." msgstr "" -#: whatsnew/3.12.rst:2433 +#: deprecations/c-api-pending-removal-in-future.rst:18 msgid ":c:func:`PyUnicode_READY`: unneeded since Python 3.12" msgstr "" -#: whatsnew/3.12.rst:2434 -msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException`" +#: deprecations/c-api-pending-removal-in-future.rst:19 +msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException` instead." msgstr "" -#: whatsnew/3.12.rst:2435 -msgid ":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1``" +#: deprecations/c-api-pending-removal-in-future.rst:20 +msgid "" +":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1`` instead." msgstr "" -#: whatsnew/3.12.rst:2436 +#: deprecations/c-api-pending-removal-in-future.rst:21 msgid "" ":c:member:`!PyBytesObject.ob_shash` member: call :c:func:`PyObject_Hash` " -"instead" +"instead." msgstr "" -#: whatsnew/3.12.rst:2438 -msgid ":c:member:`!PyDictObject.ma_version_tag` member" +#: deprecations/c-api-pending-removal-in-future.rst:23 +msgid ":c:member:`!PyDictObject.ma_version_tag` member." msgstr "" -#: whatsnew/3.12.rst:2439 +#: deprecations/c-api-pending-removal-in-future.rst:24 msgid "Thread Local Storage (TLS) API:" msgstr "" -#: whatsnew/3.12.rst:2441 -msgid ":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc`" +#: deprecations/c-api-pending-removal-in-future.rst:26 +msgid "" +":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc` instead." msgstr "" -#: whatsnew/3.12.rst:2442 -msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free`" +#: deprecations/c-api-pending-removal-in-future.rst:27 +msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free` instead." msgstr "" -#: whatsnew/3.12.rst:2443 -msgid ":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set`" +#: deprecations/c-api-pending-removal-in-future.rst:28 +msgid "" +":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set` instead." msgstr "" -#: whatsnew/3.12.rst:2444 -msgid ":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get`" +#: deprecations/c-api-pending-removal-in-future.rst:29 +msgid "" +":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get` instead." msgstr "" -#: whatsnew/3.12.rst:2445 -msgid ":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete`" +#: deprecations/c-api-pending-removal-in-future.rst:30 +msgid "" +":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete` " +"instead." msgstr "" -#: whatsnew/3.12.rst:2446 -msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7" +#: deprecations/c-api-pending-removal-in-future.rst:31 +msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7." msgstr "" -#: whatsnew/3.12.rst:2451 +#: whatsnew/3.12.rst:2235 msgid "" "Remove the :file:`token.h` header file. There was never any public tokenizer " "C API. The :file:`token.h` header file was only designed to be used by " "Python internals. (Contributed by Victor Stinner in :gh:`92651`.)" msgstr "" -#: whatsnew/3.12.rst:2456 +#: whatsnew/3.12.rst:2240 msgid "Legacy Unicode APIs have been removed. See :pep:`623` for detail." msgstr "" -#: whatsnew/3.12.rst:2458 +#: whatsnew/3.12.rst:2242 msgid ":c:macro:`!PyUnicode_WCHAR_KIND`" msgstr "" -#: whatsnew/3.12.rst:2459 +#: whatsnew/3.12.rst:2243 msgid ":c:func:`!PyUnicode_AS_UNICODE`" msgstr "" -#: whatsnew/3.12.rst:2460 +#: whatsnew/3.12.rst:2244 msgid ":c:func:`!PyUnicode_AsUnicode`" msgstr "" -#: whatsnew/3.12.rst:2461 +#: whatsnew/3.12.rst:2245 msgid ":c:func:`!PyUnicode_AsUnicodeAndSize`" msgstr "" -#: whatsnew/3.12.rst:2462 +#: whatsnew/3.12.rst:2246 msgid ":c:func:`!PyUnicode_AS_DATA`" msgstr "" -#: whatsnew/3.12.rst:2463 +#: whatsnew/3.12.rst:2247 msgid ":c:func:`!PyUnicode_FromUnicode`" msgstr "" -#: whatsnew/3.12.rst:2464 +#: whatsnew/3.12.rst:2248 msgid ":c:func:`!PyUnicode_GET_SIZE`" msgstr "" -#: whatsnew/3.12.rst:2465 +#: whatsnew/3.12.rst:2249 msgid ":c:func:`!PyUnicode_GetSize`" msgstr "" -#: whatsnew/3.12.rst:2466 +#: whatsnew/3.12.rst:2250 msgid ":c:func:`!PyUnicode_GET_DATA_SIZE`" msgstr "" -#: whatsnew/3.12.rst:2468 +#: whatsnew/3.12.rst:2252 msgid "" "Remove the ``PyUnicode_InternImmortal()`` function macro. (Contributed by " "Victor Stinner in :gh:`85858`.)" msgstr "" -#: whatsnew/3.12.rst:2472 +#: whatsnew/3.12.rst:2256 msgid "Notable changes in 3.12.4" msgstr "" -#: whatsnew/3.12.rst:2475 +#: whatsnew/3.12.rst:2259 msgid "ipaddress" msgstr "" -#: whatsnew/3.12.rst:2477 +#: whatsnew/3.12.rst:2261 msgid "" "Fixed ``is_global`` and ``is_private`` behavior in ``IPv4Address``, " "``IPv6Address``, ``IPv4Network`` and ``IPv6Network``." diff --git a/whatsnew/3.2.po b/whatsnew/3.2.po index dd549caef..6adbf9802 100644 --- a/whatsnew/3.2.po +++ b/whatsnew/3.2.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1397,7 +1397,7 @@ msgid "" "been relaxed. It is still unsupported (and ill-advised) to have implicit " "mixing in arithmetic expressions such as ``Decimal('1.1') + float('1.1')`` " "because the latter loses information in the process of constructing the " -"binary float. However, since existing floating point value can be converted " +"binary float. However, since existing floating-point value can be converted " "losslessly to either a decimal or rational representation, it makes sense to " "add them to the constructor and to support mixed-type comparisons." msgstr "" diff --git a/whatsnew/3.3.po b/whatsnew/3.3.po index 1f2dd2cf8..841331cc8 100644 --- a/whatsnew/3.3.po +++ b/whatsnew/3.3.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1502,7 +1502,7 @@ msgstr "" #: whatsnew/3.3.rst:1099 msgid "" "The new C version of the decimal module integrates the high speed libmpdec " -"library for arbitrary precision correctly rounded decimal floating point " +"library for arbitrary precision correctly rounded decimal floating-point " "arithmetic. libmpdec conforms to IBM's General Decimal Arithmetic " "Specification." msgstr "" @@ -1511,7 +1511,7 @@ msgstr "" msgid "" "Performance gains range from 10x for database applications to 100x for " "numerically intensive applications. These numbers are expected gains for " -"standard precisions used in decimal floating point arithmetic. Since the " +"standard precisions used in decimal floating-point arithmetic. Since the " "precision is user configurable, the exact figures may vary. For example, in " "integer bignum arithmetic the differences can be significantly higher." msgstr "" diff --git a/whatsnew/3.4.po b/whatsnew/3.4.po index e8343f11f..991ed76ab 100644 --- a/whatsnew/3.4.po +++ b/whatsnew/3.4.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2023,7 +2023,7 @@ msgstr "" #: whatsnew/3.4.rst:1498 msgid "" -"The :mod:`stat` module is now backed by a C implementation in :mod:`_stat`. " +"The :mod:`stat` module is now backed by a C implementation in :mod:`!_stat`. " "A C implementation is required as most of the values aren't standardized and " "are platform-dependent. (Contributed by Christian Heimes in :issue:`11016`.)" msgstr "" diff --git a/whatsnew/3.5.po b/whatsnew/3.5.po index c81bb009e..892cc0842 100644 --- a/whatsnew/3.5.po +++ b/whatsnew/3.5.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2374,8 +2374,8 @@ msgstr "" #: whatsnew/3.5.rst:1938 msgid "" -"The :mod:`tkinter._fix` module used for setting up the Tcl/Tk environment on " -"Windows has been replaced by a private function in the :mod:`_tkinter` " +"The :mod:`!tkinter._fix` module used for setting up the Tcl/Tk environment " +"on Windows has been replaced by a private function in the :mod:`!_tkinter` " "module which makes no permanent changes to environment variables. " "(Contributed by Zachary Ware in :issue:`20035`.)" msgstr "" diff --git a/whatsnew/3.6.po b/whatsnew/3.6.po index f8eef8eaf..c9e4f347b 100644 --- a/whatsnew/3.6.po +++ b/whatsnew/3.6.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-06-01 00:16+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -331,7 +331,7 @@ msgstr "" msgid "" "The :ref:`string formatting ` language also now has support for " "the ``'_'`` option to signal the use of an underscore for a thousands " -"separator for floating point presentation types and for integer presentation " +"separator for floating-point presentation types and for integer presentation " "type ``'d'``. For integer presentation types ``'b'``, ``'o'``, ``'x'``, and " "``'X'``, underscores will be inserted every 4 digits::" msgstr "" diff --git a/whatsnew/3.7.po b/whatsnew/3.7.po index 2cdc508c6..06d2fd527 100644 --- a/whatsnew/3.7.po +++ b/whatsnew/3.7.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -469,7 +469,7 @@ msgstr "" #: whatsnew/3.7.rst:341 msgid "" "The resolution of clocks in modern systems can exceed the limited precision " -"of a floating point number returned by the :func:`time.time` function and " +"of a floating-point number returned by the :func:`time.time` function and " "its variants. To avoid loss of precision, :pep:`564` adds six new " "\"nanosecond\" variants of the existing timer functions to the :mod:`time` " "module:" @@ -2883,8 +2883,8 @@ msgstr "" #: whatsnew/3.7.rst:2051 msgid "" -":mod:`dummy_threading` and :mod:`_dummy_thread` have been deprecated. It is " -"no longer possible to build Python with threading disabled. Use :mod:" +":mod:`!dummy_threading` and :mod:`!_dummy_thread` have been deprecated. It " +"is no longer possible to build Python with threading disabled. Use :mod:" "`threading` instead. (Contributed by Antoine Pitrou in :issue:`31370`.)" msgstr "" @@ -3075,9 +3075,9 @@ msgstr "" #: whatsnew/3.7.rst:2186 msgid "" -":mod:`asyncio` no longer exports the :mod:`selectors` and :mod:`_overlapped` " -"modules as ``asyncio.selectors`` and ``asyncio._overlapped``. Replace ``from " -"asyncio import selectors`` with ``import selectors``." +":mod:`asyncio` no longer exports the :mod:`selectors` and :mod:`!" +"_overlapped` modules as ``asyncio.selectors`` and ``asyncio._overlapped``. " +"Replace ``from asyncio import selectors`` with ``import selectors``." msgstr "" #: whatsnew/3.7.rst:2191 diff --git a/whatsnew/3.8.po b/whatsnew/3.8.po index e01669b75..306f6049a 100644 --- a/whatsnew/3.8.po +++ b/whatsnew/3.8.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-05-01 21:53+0000\n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" "PO-Revision-Date: 2023-02-03 17:30+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1952,8 +1952,9 @@ msgid "statistics" msgstr "statistics" #: whatsnew/3.8.rst:1195 +#, fuzzy msgid "" -"Added :func:`statistics.fmean` as a faster, floating point variant of :func:" +"Added :func:`statistics.fmean` as a faster, floating-point variant of :func:" "`statistics.mean()`. (Contributed by Raymond Hettinger and Steven D'Aprano " "in :issue:`35904`.)" msgstr "" From 7ac3b2674e5d012fe95b2aba2afde6c98c54ebc1 Mon Sep 17 00:00:00 2001 From: python-docs-turkish Date: Thu, 1 Aug 2024 00:20:20 +0000 Subject: [PATCH 2/2] Get changes from CPython Doc for 3.12 --- deprecations/c-api-pending-removal-in-3.14.po | 176 +++ deprecations/c-api-pending-removal-in-3.15.po | 84 ++ .../c-api-pending-removal-in-future.po | 138 ++ deprecations/index.po | 1206 +++++++++++++++++ deprecations/pending-removal-in-3.13.po | 188 +++ deprecations/pending-removal-in-3.14.po | 227 ++++ deprecations/pending-removal-in-3.15.po | 102 ++ deprecations/pending-removal-in-3.16.po | 33 + deprecations/pending-removal-in-future.po | 378 ++++++ 9 files changed, 2532 insertions(+) create mode 100644 deprecations/c-api-pending-removal-in-3.14.po create mode 100644 deprecations/c-api-pending-removal-in-3.15.po create mode 100644 deprecations/c-api-pending-removal-in-future.po create mode 100644 deprecations/index.po create mode 100644 deprecations/pending-removal-in-3.13.po create mode 100644 deprecations/pending-removal-in-3.14.po create mode 100644 deprecations/pending-removal-in-3.15.po create mode 100644 deprecations/pending-removal-in-3.16.po create mode 100644 deprecations/pending-removal-in-future.po diff --git a/deprecations/c-api-pending-removal-in-3.14.po b/deprecations/c-api-pending-removal-in-3.14.po new file mode 100644 index 000000000..b44414dd4 --- /dev/null +++ b/deprecations/c-api-pending-removal-in-3.14.po @@ -0,0 +1,176 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: deprecations/c-api-pending-removal-in-3.14.rst:2 +msgid "Pending Removal in Python 3.14" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:4 +msgid "" +"The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules " +"(:pep:`699`; :gh:`101193`)." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:7 +msgid "" +"Creating :c:data:`immutable types ` with mutable " +"bases (:gh:`95388`)." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:10 +msgid "" +"Functions to configure Python's initialization, deprecated in Python 3.11:" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:12 +msgid "``PySys_SetArgvEx()``: set :c:member:`PyConfig.argv` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:13 +msgid "``PySys_SetArgv()``: set :c:member:`PyConfig.argv` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:14 +msgid "``Py_SetProgramName()``: set :c:member:`PyConfig.program_name` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:15 +msgid "``Py_SetPythonHome()``: set :c:member:`PyConfig.home` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:17 +#: deprecations/c-api-pending-removal-in-3.14.rst:45 +msgid "" +"The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" +"`PyConfig` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:20 +msgid "Global configuration variables:" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:22 +msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:23 +msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:24 +msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:25 +msgid "" +":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:26 +msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:27 +msgid "" +":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:28 +msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:29 +msgid "" +":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:30 +msgid "" +":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:31 +msgid "" +":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:32 +msgid "" +":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:33 +msgid "" +":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig." +"user_site_directory` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:34 +msgid "" +":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:35 +msgid "" +":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " +"and :c:member:`PyConfig.hash_seed` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:37 +msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:38 +msgid "" +":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." +"legacy_windows_fs_encoding` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:39 +msgid "" +":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." +"legacy_windows_stdio` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:40 +msgid "" +":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." +"filesystem_encoding` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:41 +msgid "" +":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." +"filesystem_encoding` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:42 +msgid "" +":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." +"filesystem_errors` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:43 +msgid "" +":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` instead. (see :" +"c:func:`Py_PreInitialize`)" +msgstr "" diff --git a/deprecations/c-api-pending-removal-in-3.15.po b/deprecations/c-api-pending-removal-in-3.15.po new file mode 100644 index 000000000..cd2e9d8b4 --- /dev/null +++ b/deprecations/c-api-pending-removal-in-3.15.po @@ -0,0 +1,84 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: deprecations/c-api-pending-removal-in-3.15.rst:2 +msgid "Pending Removal in Python 3.15" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:4 +msgid "The bundled copy of ``libmpdecimal``." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:5 +msgid "" +":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:6 +msgid "" +":c:func:`PyWeakref_GET_OBJECT`: use :c:func:`!PyWeakref_GetRef` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:7 +msgid ":c:func:`PyWeakref_GetObject`: use :c:func:`!PyWeakref_GetRef` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:8 +msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:9 +msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:10 +msgid "Python initialization functions:" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:12 +msgid "" +":c:func:`PySys_ResetWarnOptions`: clear :data:`sys.warnoptions` and :data:`!" +"warnings.filters` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:14 +msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:15 +msgid ":c:func:`Py_GetPath`: get :data:`sys.path` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:16 +msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:17 +msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:18 +msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:19 +msgid "" +":c:func:`Py_GetPythonHome`: get :c:member:`PyConfig.home` or the :envvar:" +"`PYTHONHOME` environment variable instead." +msgstr "" diff --git a/deprecations/c-api-pending-removal-in-future.po b/deprecations/c-api-pending-removal-in-future.po new file mode 100644 index 000000000..8c8e04a60 --- /dev/null +++ b/deprecations/c-api-pending-removal-in-future.po @@ -0,0 +1,138 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: deprecations/c-api-pending-removal-in-future.rst:2 +msgid "Pending Removal in Future Versions" +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:4 +msgid "" +"The following APIs are deprecated and will be removed, although there is " +"currently no date scheduled for their removal." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:7 +msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:8 +msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:9 +msgid "" +":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:10 +msgid "" +":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:11 +msgid "" +":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:12 +msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:13 +msgid "" +":c:func:`PySlice_GetIndicesEx`: use :c:func:`PySlice_Unpack` and :c:func:" +"`PySlice_AdjustIndices` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:14 +msgid "" +":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:15 +msgid "" +":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:16 +msgid "" +":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:17 +msgid "" +":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:18 +msgid ":c:func:`PyUnicode_READY`: unneeded since Python 3.12" +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:19 +msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:20 +msgid "" +":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1`` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:21 +msgid "" +":c:member:`!PyBytesObject.ob_shash` member: call :c:func:`PyObject_Hash` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:23 +msgid ":c:member:`!PyDictObject.ma_version_tag` member." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:24 +msgid "Thread Local Storage (TLS) API:" +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:26 +msgid "" +":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:27 +msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:28 +msgid "" +":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:29 +msgid "" +":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:30 +msgid "" +":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:31 +msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7." +msgstr "" diff --git a/deprecations/index.po b/deprecations/index.po new file mode 100644 index 000000000..fc7c04727 --- /dev/null +++ b/deprecations/index.po @@ -0,0 +1,1206 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: deprecations/index.rst:2 +msgid "Deprecations" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:2 +msgid "Pending Removal in Python 3.13" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:4 +msgid "Modules (see :pep:`594`):" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:6 +msgid ":mod:`aifc`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:7 +msgid ":mod:`audioop`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:8 +msgid ":mod:`cgi`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:9 +msgid ":mod:`cgitb`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:10 +msgid ":mod:`chunk`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:11 +msgid ":mod:`crypt`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:12 +msgid ":mod:`imghdr`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:13 +msgid ":mod:`mailcap`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:14 +msgid ":mod:`msilib`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:15 +msgid ":mod:`nis`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:16 +msgid ":mod:`nntplib`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:17 +msgid ":mod:`ossaudiodev`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:18 +msgid ":mod:`pipes`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:19 +msgid ":mod:`sndhdr`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:20 +msgid ":mod:`spwd`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:21 +msgid ":mod:`sunau`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:22 +msgid ":mod:`telnetlib`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:23 +msgid ":mod:`uu`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:24 +msgid ":mod:`xdrlib`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:26 +msgid "Other modules:" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:28 +msgid ":mod:`!lib2to3`, and the :program:`2to3` program (:gh:`84540`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:30 +msgid "APIs:" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:32 +msgid ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:33 +msgid "``locale.resetlocale()`` (:gh:`90817`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:34 +msgid ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:35 +msgid ":func:`!unittest.findTestCases` (:gh:`50096`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:36 +msgid ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:37 +msgid ":func:`!unittest.makeSuite` (:gh:`50096`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:38 +msgid ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:39 +msgid ":class:`!webbrowser.MacOSX` (:gh:`86421`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:40 +msgid ":class:`classmethod` descriptor chaining (:gh:`89519`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:41 +msgid ":mod:`importlib.resources` deprecated methods:" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:43 +msgid "``contents()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:44 +msgid "``is_resource()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:45 +msgid "``open_binary()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:46 +msgid "``open_text()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:47 +msgid "``path()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:48 +msgid "``read_binary()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:49 +msgid "``read_text()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:51 +msgid "" +"Use :func:`importlib.resources.files()` instead. Refer to `importlib-" +"resources: Migrating from Legacy `_ (:gh:`106531`)" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:2 +#: deprecations/pending-removal-in-3.14.rst:2 +msgid "Pending Removal in Python 3.14" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:4 +msgid "" +":mod:`argparse`: The *type*, *choices*, and *metavar* parameters of :class:`!" +"argparse.BooleanOptionalAction` are deprecated and will be removed in 3.14. " +"(Contributed by Nikita Sobolev in :gh:`92248`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:9 +msgid "" +":mod:`ast`: The following features have been deprecated in documentation " +"since Python 3.8, now cause a :exc:`DeprecationWarning` to be emitted at " +"runtime when they are accessed or used, and will be removed in Python 3.14:" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:13 +msgid ":class:`!ast.Num`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:14 +msgid ":class:`!ast.Str`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:15 +msgid ":class:`!ast.Bytes`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:16 +msgid ":class:`!ast.NameConstant`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:17 +msgid ":class:`!ast.Ellipsis`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:19 +msgid "" +"Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" +"`90953`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:22 +msgid ":mod:`asyncio`:" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:24 +msgid "" +"The child watcher classes :class:`~asyncio.MultiLoopChildWatcher`, :class:" +"`~asyncio.FastChildWatcher`, :class:`~asyncio.AbstractChildWatcher` and :" +"class:`~asyncio.SafeChildWatcher` are deprecated and will be removed in " +"Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:30 +msgid "" +":func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`, :meth:" +"`asyncio.AbstractEventLoopPolicy.set_child_watcher` and :meth:`asyncio." +"AbstractEventLoopPolicy.get_child_watcher` are deprecated and will be " +"removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:36 +msgid "" +"The :meth:`~asyncio.get_event_loop` method of the default event loop policy " +"now emits a :exc:`DeprecationWarning` if there is no current event loop set " +"and it decides to create one. (Contributed by Serhiy Storchaka and Guido van " +"Rossum in :gh:`100160`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:41 +msgid "" +":mod:`collections.abc`: Deprecated :class:`~collections.abc.ByteString`. " +"Prefer :class:`!Sequence` or :class:`~collections.abc.Buffer`. For use in " +"typing, prefer a union, like ``bytes | bytearray``, or :class:`collections." +"abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:47 +msgid "" +":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." +"localtime`. (Contributed by Alan Williams in :gh:`72346`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:50 +msgid "" +":mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or " +"taken into consideration by the import system (:gh:`97879`)." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:53 +msgid ":mod:`importlib.abc` deprecated classes:" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:55 +msgid ":class:`!importlib.abc.ResourceReader`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:56 +msgid ":class:`!importlib.abc.Traversable`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:57 +msgid ":class:`!importlib.abc.TraversableResources`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:59 +msgid "Use :mod:`importlib.resources.abc` classes instead:" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:61 +msgid ":class:`importlib.resources.abc.Traversable`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:62 +msgid ":class:`importlib.resources.abc.TraversableResources`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:64 +msgid "(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:66 +msgid "" +":mod:`itertools` had undocumented, inefficient, historically buggy, and " +"inconsistent support for copy, deepcopy, and pickle operations. This will be " +"removed in 3.14 for a significant reduction in code volume and maintenance " +"burden. (Contributed by Raymond Hettinger in :gh:`101588`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:72 +msgid "" +":mod:`multiprocessing`: The default start method will change to a safer one " +"on Linux, BSDs, and other non-macOS POSIX platforms where ``'fork'`` is " +"currently the default (:gh:`84559`). Adding a runtime warning about this was " +"deemed too disruptive as the majority of code is not expected to care. Use " +"the :func:`~multiprocessing.get_context` or :func:`~multiprocessing." +"set_start_method` APIs to explicitly specify when your code *requires* " +"``'fork'``. See :ref:`multiprocessing-start-methods`." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:80 +msgid "" +":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." +"PurePath.relative_to`: passing additional arguments is deprecated." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:84 +msgid "" +":mod:`pkgutil`: :func:`~pkgutil.find_loader` and :func:`~pkgutil.get_loader` " +"now raise :exc:`DeprecationWarning`; use :func:`importlib.util.find_spec` " +"instead. (Contributed by Nikita Sobolev in :gh:`97850`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:89 +msgid ":mod:`pty`:" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:91 +msgid "``master_open()``: use :func:`pty.openpty`." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:92 +msgid "``slave_open()``: use :func:`pty.openpty`." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:94 +msgid ":mod:`sqlite3`:" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:96 +msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:98 +msgid "" +":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` if :" +"ref:`named placeholders ` are used and *parameters* is " +"a sequence instead of a :class:`dict`." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:102 +msgid "" +"date and datetime adapter, date and timestamp converter: see the :mod:" +"`sqlite3` documentation for suggested replacement recipes." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:105 +msgid "" +":class:`types.CodeType`: Accessing :attr:`~codeobject.co_lnotab` was " +"deprecated in :pep:`626` since 3.10 and was planned to be removed in 3.12, " +"but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " +"in 3.14. (Contributed by Nikita Sobolev in :gh:`101866`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:112 +msgid "" +":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " +"causes a :exc:`DeprecationWarning` to be emitted when it is used." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:115 +msgid "" +":mod:`urllib`: :class:`!urllib.parse.Quoter` is deprecated: it was not " +"intended to be a public API. (Contributed by Gregory P. Smith in :gh:" +"`88168`.)" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:2 +#: deprecations/pending-removal-in-3.15.rst:2 +msgid "Pending Removal in Python 3.15" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:4 +msgid "" +":class:`http.server.CGIHTTPRequestHandler` will be removed along with its " +"related ``--cgi`` flag to ``python -m http.server``. It was obsolete and " +"rarely used. No direct replacement exists. *Anything* is better than CGI " +"to interface a web server with a request handler." +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:9 +msgid "" +":class:`locale`: :func:`locale.getdefaultlocale` was deprecated in Python " +"3.11 and originally planned for removal in Python 3.13 (:gh:`90817`), but " +"removal has been postponed to Python 3.15. Use :func:`locale.setlocale()`, :" +"func:`locale.getencoding()` and :func:`locale.getlocale()` instead. " +"(Contributed by Hugo van Kemenade in :gh:`111187`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:16 +msgid "" +":mod:`pathlib`: :meth:`pathlib.PurePath.is_reserved` is deprecated and " +"scheduled for removal in Python 3.15. From Python 3.13 onwards, use ``os." +"path.isreserved`` to detect reserved paths on Windows." +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:21 +msgid "" +":mod:`platform`: :func:`~platform.java_ver` is deprecated and will be " +"removed in 3.15. It was largely untested, had a confusing API, and was only " +"useful for Jython support. (Contributed by Nikita Sobolev in :gh:`116349`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:27 +msgid "" +":mod:`threading`: Passing any arguments to :func:`threading.RLock` is now " +"deprecated. C version allows any numbers of args and kwargs, but they are " +"just ignored. Python version does not allow any arguments. All arguments " +"will be removed from :func:`threading.RLock` in Python 3.15. (Contributed by " +"Nikita Sobolev in :gh:`102029`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:34 +msgid ":class:`typing.NamedTuple`:" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:36 +msgid "" +"The undocumented keyword argument syntax for creating :class:`!NamedTuple` " +"classes (``NT = NamedTuple(\"NT\", x=int)``) is deprecated, and will be " +"disallowed in 3.15. Use the class-based syntax or the functional syntax " +"instead." +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:40 +msgid "" +"When using the functional syntax to create a :class:`!NamedTuple` class, " +"failing to pass a value to the *fields* parameter (``NT = " +"NamedTuple(\"NT\")``) is deprecated. Passing ``None`` to the *fields* " +"parameter (``NT = NamedTuple(\"NT\", None)``) is also deprecated. Both will " +"be disallowed in Python 3.15. To create a :class:`!NamedTuple` class with 0 " +"fields, use ``class NT(NamedTuple): pass`` or ``NT = NamedTuple(\"NT\", " +"[])``." +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:47 +msgid "" +":class:`typing.TypedDict`: When using the functional syntax to create a :" +"class:`!TypedDict` class, failing to pass a value to the *fields* parameter " +"(``TD = TypedDict(\"TD\")``) is deprecated. Passing ``None`` to the *fields* " +"parameter (``TD = TypedDict(\"TD\", None)``) is also deprecated. Both will " +"be disallowed in Python 3.15. To create a :class:`!TypedDict` class with 0 " +"fields, use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})``." +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:54 +msgid "" +":mod:`wave`: Deprecate the ``getmark()``, ``setmark()`` and ``getmarkers()`` " +"methods of the :class:`wave.Wave_read` and :class:`wave.Wave_write` classes. " +"They will be removed in Python 3.15. (Contributed by Victor Stinner in :gh:" +"`105096`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.16.rst:2 +msgid "Pending Removal in Python 3.16" +msgstr "" + +#: deprecations/pending-removal-in-3.16.rst:4 +msgid "" +":mod:`array`: :class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the " +"``'w'`` type instead (``Py_UCS4``)." +msgstr "" + +#: deprecations/pending-removal-in-3.16.rst:8 +msgid "" +":mod:`symtable`: Deprecate :meth:`symtable.Class.get_methods` due to the " +"lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:2 +#: deprecations/pending-removal-in-future.rst:2 +msgid "Pending Removal in Future Versions" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:4 +msgid "" +"The following APIs will be removed in the future, although there is " +"currently no date scheduled for their removal." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:7 +msgid "" +":mod:`argparse`: Nesting argument groups and nesting mutually exclusive " +"groups are deprecated." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:10 +msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:12 +msgid ":mod:`builtins`:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:14 +msgid "``~bool``, bitwise inversion on bool." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:15 +msgid "``bool(NotImplemented)``." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:16 +msgid "" +"Generators: ``throw(type, exc, tb)`` and ``athrow(type, exc, tb)`` signature " +"is deprecated: use ``throw(exc)`` and ``athrow(exc)`` instead, the single " +"argument signature." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:19 +msgid "" +"Currently Python accepts numeric literals immediately followed by keywords, " +"for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing and " +"ambiguous expressions like ``[0x1for x in y]`` (which can be interpreted as " +"``[0x1 for x in y]`` or ``[0x1f or x in y]``). A syntax warning is raised " +"if the numeric literal is immediately followed by one of keywords :keyword:" +"`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :" +"keyword:`is` and :keyword:`or`. In a future release it will be changed to a " +"syntax error. (:gh:`87999`)" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:27 +msgid "" +"Support for ``__index__()`` and ``__int__()`` method returning non-int type: " +"these methods will be required to return an instance of a strict subclass " +"of :class:`int`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:30 +msgid "" +"Support for ``__float__()`` method returning a strict subclass of :class:" +"`float`: these methods will be required to return an instance of :class:" +"`float`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:33 +msgid "" +"Support for ``__complex__()`` method returning a strict subclass of :class:" +"`complex`: these methods will be required to return an instance of :class:" +"`complex`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:36 +msgid "Delegation of ``int()`` to ``__trunc__()`` method." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:37 +msgid "" +"Passing a complex number as the *real* or *imag* argument in the :func:" +"`complex` constructor is now deprecated; it should only be passed as a " +"single positional argument. (Contributed by Serhiy Storchaka in :gh:" +"`109218`.)" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:42 +msgid "" +":mod:`calendar`: ``calendar.January`` and ``calendar.February`` constants " +"are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." +"FEBRUARY`. (Contributed by Prince Roshan in :gh:`103636`.)" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:47 +msgid "" +":attr:`codeobject.co_lnotab`: use the :meth:`codeobject.co_lines` method " +"instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:50 +msgid ":mod:`datetime`:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:52 +msgid "" +":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." +"UTC)``." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:54 +msgid "" +":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." +"fromtimestamp(timestamp, tz=datetime.UTC)``." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:57 +msgid ":mod:`gettext`: Plural value must be an integer." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:59 +msgid ":mod:`importlib`:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:61 +msgid "``load_module()`` method: use ``exec_module()`` instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:62 +msgid "" +":func:`~importlib.util.cache_from_source` *debug_override* parameter is " +"deprecated: use the *optimization* parameter instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:65 +msgid ":mod:`importlib.metadata`:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:67 +msgid "``EntryPoints`` tuple interface." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:68 +msgid "Implicit ``None`` on return values." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:70 +msgid "" +":mod:`mailbox`: Use of StringIO input and text mode is deprecated, use " +"BytesIO and binary mode instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:73 +msgid "" +":mod:`os`: Calling :func:`os.register_at_fork` in multi-threaded process." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:75 +msgid "" +":class:`!pydoc.ErrorDuringImport`: A tuple value for *exc_info* parameter is " +"deprecated, use an exception instance." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:78 +msgid "" +":mod:`re`: More strict rules are now applied for numerical group references " +"and group names in regular expressions. Only sequence of ASCII digits is " +"now accepted as a numerical reference. The group name in bytes patterns and " +"replacement strings can now only contain ASCII letters and digits and " +"underscore. (Contributed by Serhiy Storchaka in :gh:`91760`.)" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:85 +msgid "" +":mod:`!sre_compile`, :mod:`!sre_constants` and :mod:`!sre_parse` modules." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:87 +msgid "" +":mod:`shutil`: :func:`~shutil.rmtree`'s *onerror* parameter is deprecated in " +"Python 3.12; use the *onexc* parameter instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:90 +msgid ":mod:`ssl` options and protocols:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:92 +msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:93 +msgid "" +":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" +"`!selected_npn_protocol` are deprecated: use ALPN instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:96 +msgid "``ssl.OP_NO_SSL*`` options" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:97 +msgid "``ssl.OP_NO_TLS*`` options" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:98 +msgid "``ssl.PROTOCOL_SSLv3``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:99 +msgid "``ssl.PROTOCOL_TLS``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:100 +msgid "``ssl.PROTOCOL_TLSv1``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:101 +msgid "``ssl.PROTOCOL_TLSv1_1``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:102 +msgid "``ssl.PROTOCOL_TLSv1_2``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:103 +msgid "``ssl.TLSVersion.SSLv3``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:104 +msgid "``ssl.TLSVersion.TLSv1``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:105 +msgid "``ssl.TLSVersion.TLSv1_1``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:107 +msgid "" +":func:`sysconfig.is_python_build` *check_home* parameter is deprecated and " +"ignored." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:110 +msgid ":mod:`threading` methods:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:112 +msgid "" +":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." +"notify_all`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:113 +msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:114 +msgid "" +":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" +"attr:`threading.Thread.daemon` attribute." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:116 +msgid "" +":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" +"attr:`threading.Thread.name` attribute." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:118 +msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:119 +msgid ":meth:`!threading.activeCount`: use :meth:`threading.active_count`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:121 +msgid ":class:`typing.Text` (:gh:`92332`)." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:123 +msgid "" +":class:`unittest.IsolatedAsyncioTestCase`: it is deprecated to return a " +"value that is not ``None`` from a test case." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:126 +msgid "" +":mod:`urllib.parse` deprecated functions: :func:`~urllib.parse.urlparse` " +"instead" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:128 +msgid "``splitattr()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:129 +msgid "``splithost()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:130 +msgid "``splitnport()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:131 +msgid "``splitpasswd()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:132 +msgid "``splitport()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:133 +msgid "``splitquery()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:134 +msgid "``splittag()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:135 +msgid "``splittype()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:136 +msgid "``splituser()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:137 +msgid "``splitvalue()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:138 +msgid "``to_bytes()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:140 +msgid "" +":mod:`urllib.request`: :class:`~urllib.request.URLopener` and :class:" +"`~urllib.request.FancyURLopener` style of invoking requests is deprecated. " +"Use newer :func:`~urllib.request.urlopen` functions and methods." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:144 +msgid "" +":mod:`wsgiref`: ``SimpleHandler.stdout.write()`` should not do partial " +"writes." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:147 +msgid "" +":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`~xml." +"etree.ElementTree.Element` is deprecated. In a future release it will always " +"return ``True``. Prefer explicit ``len(elem)`` or ``elem is not None`` tests " +"instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:152 +msgid "" +":meth:`zipimport.zipimporter.load_module` is deprecated: use :meth:" +"`~zipimport.zipimporter.exec_module` instead." +msgstr "" + +#: deprecations/index.rst:15 +msgid "C API Deprecations" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:4 +msgid "" +"The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules " +"(:pep:`699`; :gh:`101193`)." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:7 +msgid "" +"Creating :c:data:`immutable types ` with mutable " +"bases (:gh:`95388`)." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:10 +msgid "" +"Functions to configure Python's initialization, deprecated in Python 3.11:" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:12 +msgid "``PySys_SetArgvEx()``: set :c:member:`PyConfig.argv` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:13 +msgid "``PySys_SetArgv()``: set :c:member:`PyConfig.argv` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:14 +msgid "``Py_SetProgramName()``: set :c:member:`PyConfig.program_name` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:15 +msgid "``Py_SetPythonHome()``: set :c:member:`PyConfig.home` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:17 +#: deprecations/c-api-pending-removal-in-3.14.rst:45 +msgid "" +"The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" +"`PyConfig` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:20 +msgid "Global configuration variables:" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:22 +msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:23 +msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:24 +msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:25 +msgid "" +":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:26 +msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:27 +msgid "" +":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:28 +msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:29 +msgid "" +":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:30 +msgid "" +":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:31 +msgid "" +":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:32 +msgid "" +":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:33 +msgid "" +":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig." +"user_site_directory` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:34 +msgid "" +":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:35 +msgid "" +":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " +"and :c:member:`PyConfig.hash_seed` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:37 +msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:38 +msgid "" +":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." +"legacy_windows_fs_encoding` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:39 +msgid "" +":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." +"legacy_windows_stdio` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:40 +msgid "" +":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." +"filesystem_encoding` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:41 +msgid "" +":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." +"filesystem_encoding` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:42 +msgid "" +":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." +"filesystem_errors` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.14.rst:43 +msgid "" +":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` instead. (see :" +"c:func:`Py_PreInitialize`)" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:4 +msgid "The bundled copy of ``libmpdecimal``." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:5 +msgid "" +":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:6 +msgid "" +":c:func:`PyWeakref_GET_OBJECT`: use :c:func:`!PyWeakref_GetRef` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:7 +msgid ":c:func:`PyWeakref_GetObject`: use :c:func:`!PyWeakref_GetRef` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:8 +msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:9 +msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:10 +msgid "Python initialization functions:" +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:12 +msgid "" +":c:func:`PySys_ResetWarnOptions`: clear :data:`sys.warnoptions` and :data:`!" +"warnings.filters` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:14 +msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:15 +msgid ":c:func:`Py_GetPath`: get :data:`sys.path` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:16 +msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:17 +msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:18 +msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-3.15.rst:19 +msgid "" +":c:func:`Py_GetPythonHome`: get :c:member:`PyConfig.home` or the :envvar:" +"`PYTHONHOME` environment variable instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:4 +msgid "" +"The following APIs are deprecated and will be removed, although there is " +"currently no date scheduled for their removal." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:7 +msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:8 +msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:9 +msgid "" +":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:10 +msgid "" +":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:11 +msgid "" +":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:12 +msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:13 +msgid "" +":c:func:`PySlice_GetIndicesEx`: use :c:func:`PySlice_Unpack` and :c:func:" +"`PySlice_AdjustIndices` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:14 +msgid "" +":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:15 +msgid "" +":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:16 +msgid "" +":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:17 +msgid "" +":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:18 +msgid ":c:func:`PyUnicode_READY`: unneeded since Python 3.12" +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:19 +msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:20 +msgid "" +":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1`` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:21 +msgid "" +":c:member:`!PyBytesObject.ob_shash` member: call :c:func:`PyObject_Hash` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:23 +msgid ":c:member:`!PyDictObject.ma_version_tag` member." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:24 +msgid "Thread Local Storage (TLS) API:" +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:26 +msgid "" +":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:27 +msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:28 +msgid "" +":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:29 +msgid "" +":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get` instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:30 +msgid "" +":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete` " +"instead." +msgstr "" + +#: deprecations/c-api-pending-removal-in-future.rst:31 +msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7." +msgstr "" diff --git a/deprecations/pending-removal-in-3.13.po b/deprecations/pending-removal-in-3.13.po new file mode 100644 index 000000000..645108887 --- /dev/null +++ b/deprecations/pending-removal-in-3.13.po @@ -0,0 +1,188 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: deprecations/pending-removal-in-3.13.rst:2 +msgid "Pending Removal in Python 3.13" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:4 +msgid "Modules (see :pep:`594`):" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:6 +msgid ":mod:`aifc`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:7 +msgid ":mod:`audioop`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:8 +msgid ":mod:`cgi`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:9 +msgid ":mod:`cgitb`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:10 +msgid ":mod:`chunk`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:11 +msgid ":mod:`crypt`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:12 +msgid ":mod:`imghdr`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:13 +msgid ":mod:`mailcap`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:14 +msgid ":mod:`msilib`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:15 +msgid ":mod:`nis`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:16 +msgid ":mod:`nntplib`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:17 +msgid ":mod:`ossaudiodev`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:18 +msgid ":mod:`pipes`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:19 +msgid ":mod:`sndhdr`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:20 +msgid ":mod:`spwd`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:21 +msgid ":mod:`sunau`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:22 +msgid ":mod:`telnetlib`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:23 +msgid ":mod:`uu`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:24 +msgid ":mod:`xdrlib`" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:26 +msgid "Other modules:" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:28 +msgid ":mod:`!lib2to3`, and the :program:`2to3` program (:gh:`84540`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:30 +msgid "APIs:" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:32 +msgid ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:33 +msgid "``locale.resetlocale()`` (:gh:`90817`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:34 +msgid ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:35 +msgid ":func:`!unittest.findTestCases` (:gh:`50096`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:36 +msgid ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:37 +msgid ":func:`!unittest.makeSuite` (:gh:`50096`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:38 +msgid ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:39 +msgid ":class:`!webbrowser.MacOSX` (:gh:`86421`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:40 +msgid ":class:`classmethod` descriptor chaining (:gh:`89519`)" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:41 +msgid ":mod:`importlib.resources` deprecated methods:" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:43 +msgid "``contents()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:44 +msgid "``is_resource()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:45 +msgid "``open_binary()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:46 +msgid "``open_text()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:47 +msgid "``path()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:48 +msgid "``read_binary()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:49 +msgid "``read_text()``" +msgstr "" + +#: deprecations/pending-removal-in-3.13.rst:51 +msgid "" +"Use :func:`importlib.resources.files()` instead. Refer to `importlib-" +"resources: Migrating from Legacy `_ (:gh:`106531`)" +msgstr "" diff --git a/deprecations/pending-removal-in-3.14.po b/deprecations/pending-removal-in-3.14.po new file mode 100644 index 000000000..4f2e96e4b --- /dev/null +++ b/deprecations/pending-removal-in-3.14.po @@ -0,0 +1,227 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: deprecations/pending-removal-in-3.14.rst:2 +msgid "Pending Removal in Python 3.14" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:4 +msgid "" +":mod:`argparse`: The *type*, *choices*, and *metavar* parameters of :class:`!" +"argparse.BooleanOptionalAction` are deprecated and will be removed in 3.14. " +"(Contributed by Nikita Sobolev in :gh:`92248`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:9 +msgid "" +":mod:`ast`: The following features have been deprecated in documentation " +"since Python 3.8, now cause a :exc:`DeprecationWarning` to be emitted at " +"runtime when they are accessed or used, and will be removed in Python 3.14:" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:13 +msgid ":class:`!ast.Num`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:14 +msgid ":class:`!ast.Str`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:15 +msgid ":class:`!ast.Bytes`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:16 +msgid ":class:`!ast.NameConstant`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:17 +msgid ":class:`!ast.Ellipsis`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:19 +msgid "" +"Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" +"`90953`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:22 +msgid ":mod:`asyncio`:" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:24 +msgid "" +"The child watcher classes :class:`~asyncio.MultiLoopChildWatcher`, :class:" +"`~asyncio.FastChildWatcher`, :class:`~asyncio.AbstractChildWatcher` and :" +"class:`~asyncio.SafeChildWatcher` are deprecated and will be removed in " +"Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:30 +msgid "" +":func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`, :meth:" +"`asyncio.AbstractEventLoopPolicy.set_child_watcher` and :meth:`asyncio." +"AbstractEventLoopPolicy.get_child_watcher` are deprecated and will be " +"removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:36 +msgid "" +"The :meth:`~asyncio.get_event_loop` method of the default event loop policy " +"now emits a :exc:`DeprecationWarning` if there is no current event loop set " +"and it decides to create one. (Contributed by Serhiy Storchaka and Guido van " +"Rossum in :gh:`100160`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:41 +msgid "" +":mod:`collections.abc`: Deprecated :class:`~collections.abc.ByteString`. " +"Prefer :class:`!Sequence` or :class:`~collections.abc.Buffer`. For use in " +"typing, prefer a union, like ``bytes | bytearray``, or :class:`collections." +"abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:47 +msgid "" +":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." +"localtime`. (Contributed by Alan Williams in :gh:`72346`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:50 +msgid "" +":mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or " +"taken into consideration by the import system (:gh:`97879`)." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:53 +msgid ":mod:`importlib.abc` deprecated classes:" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:55 +msgid ":class:`!importlib.abc.ResourceReader`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:56 +msgid ":class:`!importlib.abc.Traversable`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:57 +msgid ":class:`!importlib.abc.TraversableResources`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:59 +msgid "Use :mod:`importlib.resources.abc` classes instead:" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:61 +msgid ":class:`importlib.resources.abc.Traversable`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:62 +msgid ":class:`importlib.resources.abc.TraversableResources`" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:64 +msgid "(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:66 +msgid "" +":mod:`itertools` had undocumented, inefficient, historically buggy, and " +"inconsistent support for copy, deepcopy, and pickle operations. This will be " +"removed in 3.14 for a significant reduction in code volume and maintenance " +"burden. (Contributed by Raymond Hettinger in :gh:`101588`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:72 +msgid "" +":mod:`multiprocessing`: The default start method will change to a safer one " +"on Linux, BSDs, and other non-macOS POSIX platforms where ``'fork'`` is " +"currently the default (:gh:`84559`). Adding a runtime warning about this was " +"deemed too disruptive as the majority of code is not expected to care. Use " +"the :func:`~multiprocessing.get_context` or :func:`~multiprocessing." +"set_start_method` APIs to explicitly specify when your code *requires* " +"``'fork'``. See :ref:`multiprocessing-start-methods`." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:80 +msgid "" +":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." +"PurePath.relative_to`: passing additional arguments is deprecated." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:84 +msgid "" +":mod:`pkgutil`: :func:`~pkgutil.find_loader` and :func:`~pkgutil.get_loader` " +"now raise :exc:`DeprecationWarning`; use :func:`importlib.util.find_spec` " +"instead. (Contributed by Nikita Sobolev in :gh:`97850`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:89 +msgid ":mod:`pty`:" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:91 +msgid "``master_open()``: use :func:`pty.openpty`." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:92 +msgid "``slave_open()``: use :func:`pty.openpty`." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:94 +msgid ":mod:`sqlite3`:" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:96 +msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:98 +msgid "" +":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` if :" +"ref:`named placeholders ` are used and *parameters* is " +"a sequence instead of a :class:`dict`." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:102 +msgid "" +"date and datetime adapter, date and timestamp converter: see the :mod:" +"`sqlite3` documentation for suggested replacement recipes." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:105 +msgid "" +":class:`types.CodeType`: Accessing :attr:`~codeobject.co_lnotab` was " +"deprecated in :pep:`626` since 3.10 and was planned to be removed in 3.12, " +"but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " +"in 3.14. (Contributed by Nikita Sobolev in :gh:`101866`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:112 +msgid "" +":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " +"causes a :exc:`DeprecationWarning` to be emitted when it is used." +msgstr "" + +#: deprecations/pending-removal-in-3.14.rst:115 +msgid "" +":mod:`urllib`: :class:`!urllib.parse.Quoter` is deprecated: it was not " +"intended to be a public API. (Contributed by Gregory P. Smith in :gh:" +"`88168`.)" +msgstr "" diff --git a/deprecations/pending-removal-in-3.15.po b/deprecations/pending-removal-in-3.15.po new file mode 100644 index 000000000..698286c65 --- /dev/null +++ b/deprecations/pending-removal-in-3.15.po @@ -0,0 +1,102 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: deprecations/pending-removal-in-3.15.rst:2 +msgid "Pending Removal in Python 3.15" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:4 +msgid "" +":class:`http.server.CGIHTTPRequestHandler` will be removed along with its " +"related ``--cgi`` flag to ``python -m http.server``. It was obsolete and " +"rarely used. No direct replacement exists. *Anything* is better than CGI " +"to interface a web server with a request handler." +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:9 +msgid "" +":class:`locale`: :func:`locale.getdefaultlocale` was deprecated in Python " +"3.11 and originally planned for removal in Python 3.13 (:gh:`90817`), but " +"removal has been postponed to Python 3.15. Use :func:`locale.setlocale()`, :" +"func:`locale.getencoding()` and :func:`locale.getlocale()` instead. " +"(Contributed by Hugo van Kemenade in :gh:`111187`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:16 +msgid "" +":mod:`pathlib`: :meth:`pathlib.PurePath.is_reserved` is deprecated and " +"scheduled for removal in Python 3.15. From Python 3.13 onwards, use ``os." +"path.isreserved`` to detect reserved paths on Windows." +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:21 +msgid "" +":mod:`platform`: :func:`~platform.java_ver` is deprecated and will be " +"removed in 3.15. It was largely untested, had a confusing API, and was only " +"useful for Jython support. (Contributed by Nikita Sobolev in :gh:`116349`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:27 +msgid "" +":mod:`threading`: Passing any arguments to :func:`threading.RLock` is now " +"deprecated. C version allows any numbers of args and kwargs, but they are " +"just ignored. Python version does not allow any arguments. All arguments " +"will be removed from :func:`threading.RLock` in Python 3.15. (Contributed by " +"Nikita Sobolev in :gh:`102029`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:34 +msgid ":class:`typing.NamedTuple`:" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:36 +msgid "" +"The undocumented keyword argument syntax for creating :class:`!NamedTuple` " +"classes (``NT = NamedTuple(\"NT\", x=int)``) is deprecated, and will be " +"disallowed in 3.15. Use the class-based syntax or the functional syntax " +"instead." +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:40 +msgid "" +"When using the functional syntax to create a :class:`!NamedTuple` class, " +"failing to pass a value to the *fields* parameter (``NT = " +"NamedTuple(\"NT\")``) is deprecated. Passing ``None`` to the *fields* " +"parameter (``NT = NamedTuple(\"NT\", None)``) is also deprecated. Both will " +"be disallowed in Python 3.15. To create a :class:`!NamedTuple` class with 0 " +"fields, use ``class NT(NamedTuple): pass`` or ``NT = NamedTuple(\"NT\", " +"[])``." +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:47 +msgid "" +":class:`typing.TypedDict`: When using the functional syntax to create a :" +"class:`!TypedDict` class, failing to pass a value to the *fields* parameter " +"(``TD = TypedDict(\"TD\")``) is deprecated. Passing ``None`` to the *fields* " +"parameter (``TD = TypedDict(\"TD\", None)``) is also deprecated. Both will " +"be disallowed in Python 3.15. To create a :class:`!TypedDict` class with 0 " +"fields, use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})``." +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:54 +msgid "" +":mod:`wave`: Deprecate the ``getmark()``, ``setmark()`` and ``getmarkers()`` " +"methods of the :class:`wave.Wave_read` and :class:`wave.Wave_write` classes. " +"They will be removed in Python 3.15. (Contributed by Victor Stinner in :gh:" +"`105096`.)" +msgstr "" diff --git a/deprecations/pending-removal-in-3.16.po b/deprecations/pending-removal-in-3.16.po new file mode 100644 index 000000000..c95dac962 --- /dev/null +++ b/deprecations/pending-removal-in-3.16.po @@ -0,0 +1,33 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: deprecations/pending-removal-in-3.16.rst:2 +msgid "Pending Removal in Python 3.16" +msgstr "" + +#: deprecations/pending-removal-in-3.16.rst:4 +msgid "" +":mod:`array`: :class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the " +"``'w'`` type instead (``Py_UCS4``)." +msgstr "" + +#: deprecations/pending-removal-in-3.16.rst:8 +msgid "" +":mod:`symtable`: Deprecate :meth:`symtable.Class.get_methods` due to the " +"lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" +msgstr "" diff --git a/deprecations/pending-removal-in-future.po b/deprecations/pending-removal-in-future.po new file mode 100644 index 000000000..55ec30d14 --- /dev/null +++ b/deprecations/pending-removal-in-future.po @@ -0,0 +1,378 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2024, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-08-01 00:19+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: deprecations/pending-removal-in-future.rst:2 +msgid "Pending Removal in Future Versions" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:4 +msgid "" +"The following APIs will be removed in the future, although there is " +"currently no date scheduled for their removal." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:7 +msgid "" +":mod:`argparse`: Nesting argument groups and nesting mutually exclusive " +"groups are deprecated." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:10 +msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:12 +msgid ":mod:`builtins`:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:14 +msgid "``~bool``, bitwise inversion on bool." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:15 +msgid "``bool(NotImplemented)``." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:16 +msgid "" +"Generators: ``throw(type, exc, tb)`` and ``athrow(type, exc, tb)`` signature " +"is deprecated: use ``throw(exc)`` and ``athrow(exc)`` instead, the single " +"argument signature." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:19 +msgid "" +"Currently Python accepts numeric literals immediately followed by keywords, " +"for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing and " +"ambiguous expressions like ``[0x1for x in y]`` (which can be interpreted as " +"``[0x1 for x in y]`` or ``[0x1f or x in y]``). A syntax warning is raised " +"if the numeric literal is immediately followed by one of keywords :keyword:" +"`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :" +"keyword:`is` and :keyword:`or`. In a future release it will be changed to a " +"syntax error. (:gh:`87999`)" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:27 +msgid "" +"Support for ``__index__()`` and ``__int__()`` method returning non-int type: " +"these methods will be required to return an instance of a strict subclass " +"of :class:`int`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:30 +msgid "" +"Support for ``__float__()`` method returning a strict subclass of :class:" +"`float`: these methods will be required to return an instance of :class:" +"`float`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:33 +msgid "" +"Support for ``__complex__()`` method returning a strict subclass of :class:" +"`complex`: these methods will be required to return an instance of :class:" +"`complex`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:36 +msgid "Delegation of ``int()`` to ``__trunc__()`` method." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:37 +msgid "" +"Passing a complex number as the *real* or *imag* argument in the :func:" +"`complex` constructor is now deprecated; it should only be passed as a " +"single positional argument. (Contributed by Serhiy Storchaka in :gh:" +"`109218`.)" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:42 +msgid "" +":mod:`calendar`: ``calendar.January`` and ``calendar.February`` constants " +"are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." +"FEBRUARY`. (Contributed by Prince Roshan in :gh:`103636`.)" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:47 +msgid "" +":attr:`codeobject.co_lnotab`: use the :meth:`codeobject.co_lines` method " +"instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:50 +msgid ":mod:`datetime`:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:52 +msgid "" +":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." +"UTC)``." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:54 +msgid "" +":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." +"fromtimestamp(timestamp, tz=datetime.UTC)``." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:57 +msgid ":mod:`gettext`: Plural value must be an integer." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:59 +msgid ":mod:`importlib`:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:61 +msgid "``load_module()`` method: use ``exec_module()`` instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:62 +msgid "" +":func:`~importlib.util.cache_from_source` *debug_override* parameter is " +"deprecated: use the *optimization* parameter instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:65 +msgid ":mod:`importlib.metadata`:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:67 +msgid "``EntryPoints`` tuple interface." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:68 +msgid "Implicit ``None`` on return values." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:70 +msgid "" +":mod:`mailbox`: Use of StringIO input and text mode is deprecated, use " +"BytesIO and binary mode instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:73 +msgid "" +":mod:`os`: Calling :func:`os.register_at_fork` in multi-threaded process." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:75 +msgid "" +":class:`!pydoc.ErrorDuringImport`: A tuple value for *exc_info* parameter is " +"deprecated, use an exception instance." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:78 +msgid "" +":mod:`re`: More strict rules are now applied for numerical group references " +"and group names in regular expressions. Only sequence of ASCII digits is " +"now accepted as a numerical reference. The group name in bytes patterns and " +"replacement strings can now only contain ASCII letters and digits and " +"underscore. (Contributed by Serhiy Storchaka in :gh:`91760`.)" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:85 +msgid "" +":mod:`!sre_compile`, :mod:`!sre_constants` and :mod:`!sre_parse` modules." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:87 +msgid "" +":mod:`shutil`: :func:`~shutil.rmtree`'s *onerror* parameter is deprecated in " +"Python 3.12; use the *onexc* parameter instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:90 +msgid ":mod:`ssl` options and protocols:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:92 +msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:93 +msgid "" +":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" +"`!selected_npn_protocol` are deprecated: use ALPN instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:96 +msgid "``ssl.OP_NO_SSL*`` options" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:97 +msgid "``ssl.OP_NO_TLS*`` options" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:98 +msgid "``ssl.PROTOCOL_SSLv3``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:99 +msgid "``ssl.PROTOCOL_TLS``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:100 +msgid "``ssl.PROTOCOL_TLSv1``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:101 +msgid "``ssl.PROTOCOL_TLSv1_1``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:102 +msgid "``ssl.PROTOCOL_TLSv1_2``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:103 +msgid "``ssl.TLSVersion.SSLv3``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:104 +msgid "``ssl.TLSVersion.TLSv1``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:105 +msgid "``ssl.TLSVersion.TLSv1_1``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:107 +msgid "" +":func:`sysconfig.is_python_build` *check_home* parameter is deprecated and " +"ignored." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:110 +msgid ":mod:`threading` methods:" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:112 +msgid "" +":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." +"notify_all`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:113 +msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:114 +msgid "" +":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" +"attr:`threading.Thread.daemon` attribute." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:116 +msgid "" +":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" +"attr:`threading.Thread.name` attribute." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:118 +msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:119 +msgid ":meth:`!threading.activeCount`: use :meth:`threading.active_count`." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:121 +msgid ":class:`typing.Text` (:gh:`92332`)." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:123 +msgid "" +":class:`unittest.IsolatedAsyncioTestCase`: it is deprecated to return a " +"value that is not ``None`` from a test case." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:126 +msgid "" +":mod:`urllib.parse` deprecated functions: :func:`~urllib.parse.urlparse` " +"instead" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:128 +msgid "``splitattr()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:129 +msgid "``splithost()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:130 +msgid "``splitnport()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:131 +msgid "``splitpasswd()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:132 +msgid "``splitport()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:133 +msgid "``splitquery()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:134 +msgid "``splittag()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:135 +msgid "``splittype()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:136 +msgid "``splituser()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:137 +msgid "``splitvalue()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:138 +msgid "``to_bytes()``" +msgstr "" + +#: deprecations/pending-removal-in-future.rst:140 +msgid "" +":mod:`urllib.request`: :class:`~urllib.request.URLopener` and :class:" +"`~urllib.request.FancyURLopener` style of invoking requests is deprecated. " +"Use newer :func:`~urllib.request.urlopen` functions and methods." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:144 +msgid "" +":mod:`wsgiref`: ``SimpleHandler.stdout.write()`` should not do partial " +"writes." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:147 +msgid "" +":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`~xml." +"etree.ElementTree.Element` is deprecated. In a future release it will always " +"return ``True``. Prefer explicit ``len(elem)`` or ``elem is not None`` tests " +"instead." +msgstr "" + +#: deprecations/pending-removal-in-future.rst:152 +msgid "" +":meth:`zipimport.zipimporter.load_module` is deprecated: use :meth:" +"`~zipimport.zipimporter.exec_module` instead." +msgstr ""