From 020db056d7c264f7eb2cc6aa4b9d15d2c5fd98ac Mon Sep 17 00:00:00 2001 From: python-docs-turkish Date: Sat, 24 Feb 2024 17:23:29 +0000 Subject: [PATCH 1/2] Get changes from CPython Doc for 3.12 --- Makefile | 2 +- c-api/buffer.po | 4 +- c-api/code.po | 124 +- c-api/conversion.po | 75 +- c-api/exceptions.po | 155 +-- c-api/file.po | 28 +- c-api/gcsupport.po | 76 +- c-api/import.po | 119 +- c-api/init.po | 508 ++++---- c-api/intro.po | 61 +- c-api/long.po | 10 +- c-api/memory.po | 20 +- c-api/memoryview.po | 27 +- c-api/object.po | 159 +-- c-api/stable.po | 4 +- c-api/structures.po | 293 +++-- c-api/sys.po | 187 +-- c-api/typeobj.po | 16 +- c-api/unicode.po | 239 ++-- c-api/veryhigh.po | 4 +- extending/extending.po | 8 +- extending/newtypes.po | 6 +- faq/design.po | 8 +- glossary.po | 123 +- howto/annotations.po | 4 +- howto/curses.po | 4 +- howto/descriptor.po | 4 +- howto/ipaddress.po | 4 +- howto/isolating-extensions.po | 4 +- howto/logging-cookbook.po | 348 +++--- howto/logging.po | 122 +- howto/pyporting.po | 602 +--------- howto/regex.po | 4 +- howto/sockets.po | 4 +- howto/sorting.po | 195 ++-- howto/urllib2.po | 8 +- library/__future__.po | 199 ++-- library/argparse.po | 6 +- library/array.po | 113 +- library/asyncio-policy.po | 12 +- library/asyncio-protocol.po | 7 +- library/asyncio-stream.po | 4 +- library/asyncio-subprocess.po | 8 +- library/asyncio-task.po | 208 ++-- library/asyncio.po | 4 +- library/bdb.po | 103 +- library/bisect.po | 10 +- library/codecs.po | 12 +- library/collections.abc.po | 6 +- library/collections.po | 15 +- library/concurrent.futures.po | 122 +- library/configparser.po | 10 +- library/contextlib.po | 225 ++-- library/contextvars.po | 7 +- library/csv.po | 198 ++-- library/datetime.po | 1292 +++++++++++---------- library/dbm.po | 395 ++++--- library/difflib.po | 4 +- library/doctest.po | 18 +- library/email.message.po | 9 +- library/email.policy.po | 148 ++- library/ensurepip.po | 4 +- library/enum.po | 283 +++-- library/exceptions.po | 14 +- library/fnmatch.po | 30 +- library/ftplib.po | 417 ++++--- library/functions.po | 544 ++++----- library/functools.po | 6 +- library/gzip.po | 8 +- library/hashlib.po | 4 +- library/heapq.po | 4 +- library/http.client.po | 73 +- library/http.cookiejar.po | 44 +- library/http.server.po | 12 +- library/idle.po | 632 +++++----- library/imaplib.po | 6 +- library/io.po | 29 +- library/locale.po | 182 +-- library/logging.config.po | 4 +- library/logging.handlers.po | 4 +- library/logging.po | 66 +- library/mailbox.po | 6 +- library/math.po | 6 +- library/mmap.po | 8 +- library/msvcrt.po | 18 +- library/multiprocessing.po | 678 +++++------ library/multiprocessing.shared_memory.po | 260 +++-- library/nntplib.po | 6 +- library/os.po | 933 ++++++++------- library/pathlib.po | 394 ++++--- library/pdb.po | 19 +- library/pickle.po | 254 ++-- library/pickletools.po | 4 +- library/poplib.po | 6 +- library/pyclbr.po | 62 +- library/pyexpat.po | 210 ++-- library/re.po | 892 +++++++------- library/select.po | 12 +- library/shutil.po | 301 ++--- library/smtplib.po | 6 +- library/socket.po | 187 +-- library/socketserver.po | 27 +- library/sqlite3.po | 12 +- library/ssl.po | 121 +- library/statistics.po | 32 +- library/stdtypes.po | 7 +- library/string.po | 4 +- library/struct.po | 294 ++--- library/subprocess.po | 381 +++--- library/symtable.po | 6 +- library/sys.po | 879 +++++++------- library/tarfile.po | 304 ++--- library/telnetlib.po | 6 +- library/test.po | 14 +- library/time.po | 4 +- library/tkinter.ttk.po | 4 +- library/tty.po | 35 +- library/types.po | 139 +-- library/unittest.mock.po | 108 +- library/unittest.po | 6 +- library/urllib.parse.po | 4 +- library/urllib.request.po | 78 +- library/venv.po | 22 +- library/webbrowser.po | 4 +- library/xml.etree.elementtree.po | 16 +- library/xml.po | 63 +- library/xml.sax.utils.po | 4 +- library/zipapp.po | 4 +- library/zipfile.po | 14 +- license.po | 56 +- reference/datamodel.po | 996 ++++++++-------- reference/expressions.po | 942 +++++++-------- reference/import.po | 295 ++--- tutorial/appendix.po | 11 +- tutorial/classes.po | 133 ++- tutorial/datastructures.po | 171 ++- using/cmdline.po | 6 +- using/mac.po | 173 +-- using/windows.po | 14 +- whatsnew/2.0.po | 43 +- whatsnew/2.2.po | 251 ++-- whatsnew/2.3.po | 13 +- whatsnew/2.4.po | 50 +- whatsnew/2.5.po | 59 +- whatsnew/2.6.po | 1355 +++++++++++----------- whatsnew/2.7.po | 840 +++++++------- whatsnew/3.0.po | 55 +- whatsnew/3.1.po | 239 ++-- whatsnew/3.10.po | 438 ++++--- whatsnew/3.11.po | 74 +- whatsnew/3.12.po | 827 ++++++------- whatsnew/3.2.po | 243 ++-- whatsnew/3.3.po | 4 +- whatsnew/3.5.po | 4 +- whatsnew/3.6.po | 469 ++++---- whatsnew/3.7.po | 575 +++++---- whatsnew/3.8.po | 145 ++- whatsnew/3.9.po | 72 +- 158 files changed, 12605 insertions(+), 11862 deletions(-) diff --git a/Makefile b/Makefile index 9c5004b57..aba338ebc 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 := d3f2051eec6039811ae42e4382e8b292a983edc1 +CPYTHON_CURRENT_COMMIT := b4dd31409cf6f23dcd8113d10f74a2e41b8cb1ed LANGUAGE := tr BRANCH := 3.12 diff --git a/c-api/buffer.po b/c-api/buffer.po index a2da6d1cc..ccfa1555c 100644 --- a/c-api/buffer.po +++ b/c-api/buffer.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -689,7 +689,7 @@ msgid "buffer object" msgstr "" #: c-api/buffer.rst:32 -msgid "PyBufferProcs" +msgid "PyBufferProcs (C type)" msgstr "" #: c-api/buffer.rst:294 diff --git a/c-api/code.po b/c-api/code.po index 7105aaa7d..3a966b453 100644 --- a/c-api/code.po +++ b/c-api/code.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -35,124 +35,128 @@ msgstr "" #: c-api/code.rst:24 msgid "" -"This is an instance of :c:type:`PyTypeObject` representing the Python :class:" -"`code` type." +"This is an instance of :c:type:`PyTypeObject` representing the Python :ref:" +"`code object `." msgstr "" #: c-api/code.rst:30 msgid "" -"Return true if *co* is a :class:`code` object. This function always " -"succeeds." +"Return true if *co* is a :ref:`code object `. This function " +"always succeeds." msgstr "" -#: c-api/code.rst:34 -msgid "Return the number of free variables in *co*." +#: c-api/code.rst:35 +msgid "Return the number of free variables in a code object." msgstr "" -#: c-api/code.rst:38 +#: c-api/code.rst:39 +msgid "Return the position of the first free variable in a code object." +msgstr "" + +#: c-api/code.rst:43 msgid "" "Return a new code object. If you need a dummy code object to create a " "frame, use :c:func:`PyCode_NewEmpty` instead." msgstr "" -#: c-api/code.rst:41 +#: c-api/code.rst:46 msgid "" "Since the definition of the bytecode changes often, calling :c:func:" "`PyUnstable_Code_New` directly can bind you to a precise Python version." msgstr "" -#: c-api/code.rst:44 +#: c-api/code.rst:49 msgid "" "The many arguments of this function are inter-dependent in complex ways, " "meaning that subtle changes to values are likely to result in incorrect " "execution or VM crashes. Use this function only with extreme care." msgstr "" -#: c-api/code.rst:48 +#: c-api/code.rst:53 msgid "Added ``qualname`` and ``exceptiontable`` parameters." msgstr "" -#: c-api/code.rst:55 +#: c-api/code.rst:60 msgid "" "Renamed from ``PyCode_New`` as part of :ref:`unstable-c-api`. The old name " "is deprecated, but will remain available until the signature changes again." msgstr "" -#: c-api/code.rst:61 +#: c-api/code.rst:66 msgid "" "Similar to :c:func:`PyUnstable_Code_New`, but with an extra " "\"posonlyargcount\" for positional-only arguments. The same caveats that " "apply to ``PyUnstable_Code_New`` also apply to this function." msgstr "" -#: c-api/code.rst:66 +#: c-api/code.rst:71 msgid "as ``PyCode_NewWithPosOnlyArgs``" msgstr "" -#: c-api/code.rst:68 +#: c-api/code.rst:73 msgid "Added ``qualname`` and ``exceptiontable`` parameters." msgstr "" -#: c-api/code.rst:73 +#: c-api/code.rst:78 msgid "" "Renamed to ``PyUnstable_Code_NewWithPosOnlyArgs``. The old name is " "deprecated, but will remain available until the signature changes again." msgstr "" -#: c-api/code.rst:79 +#: c-api/code.rst:84 msgid "" "Return a new empty code object with the specified filename, function name, " "and first line number. The resulting code object will raise an ``Exception`` " "if executed." msgstr "" -#: c-api/code.rst:85 +#: c-api/code.rst:90 msgid "" "Return the line number of the instruction that occurs on or before " "``byte_offset`` and ends after it. If you just need the line number of a " "frame, use :c:func:`PyFrame_GetLineNumber` instead." msgstr "" -#: c-api/code.rst:88 +#: c-api/code.rst:93 msgid "" "For efficiently iterating over the line numbers in a code object, use `the " "API described in PEP 626 `_." msgstr "" -#: c-api/code.rst:93 +#: c-api/code.rst:98 msgid "" "Sets the passed ``int`` pointers to the source code line and column numbers " "for the instruction at ``byte_offset``. Sets the value to ``0`` when " "information is not available for any particular element." msgstr "" -#: c-api/code.rst:97 +#: c-api/code.rst:102 msgid "Returns ``1`` if the function succeeds and 0 otherwise." msgstr "" -#: c-api/code.rst:103 +#: c-api/code.rst:108 msgid "" "Equivalent to the Python code ``getattr(co, 'co_code')``. Returns a strong " "reference to a :c:type:`PyBytesObject` representing the bytecode in a code " "object. On error, ``NULL`` is returned and an exception is raised." msgstr "" -#: c-api/code.rst:108 +#: c-api/code.rst:113 msgid "" "This ``PyBytesObject`` may be created on-demand by the interpreter and does " "not necessarily represent the bytecode actually executed by CPython. The " "primary use case for this function is debuggers and profilers." msgstr "" -#: c-api/code.rst:116 +#: c-api/code.rst:121 msgid "" "Equivalent to the Python code ``getattr(co, 'co_varnames')``. Returns a new " "reference to a :c:type:`PyTupleObject` containing the names of the local " "variables. On error, ``NULL`` is returned and an exception is raised." msgstr "" -#: c-api/code.rst:125 +#: c-api/code.rst:130 msgid "" "Equivalent to the Python code ``getattr(co, 'co_cellvars')``. Returns a new " "reference to a :c:type:`PyTupleObject` containing the names of the local " @@ -160,14 +164,14 @@ msgid "" "returned and an exception is raised." msgstr "" -#: c-api/code.rst:134 +#: c-api/code.rst:139 msgid "" "Equivalent to the Python code ``getattr(co, 'co_freevars')``. Returns a new " "reference to a :c:type:`PyTupleObject` containing the names of the free " "variables. On error, ``NULL`` is returned and an exception is raised." msgstr "" -#: c-api/code.rst:142 +#: c-api/code.rst:147 msgid "" "Register *callback* as a code object watcher for the current interpreter. " "Return an ID which may be passed to :c:func:`PyCode_ClearWatcher`. In case " @@ -175,7 +179,7 @@ msgid "" "exception." msgstr "" -#: c-api/code.rst:151 +#: c-api/code.rst:156 msgid "" "Clear watcher identified by *watcher_id* previously returned from :c:func:" "`PyCode_AddWatcher` for the current interpreter. Return ``0`` on success, or " @@ -183,17 +187,17 @@ msgid "" "never registered.)" msgstr "" -#: c-api/code.rst:160 +#: c-api/code.rst:165 msgid "" "Enumeration of possible code object watcher events: - " "``PY_CODE_EVENT_CREATE`` - ``PY_CODE_EVENT_DESTROY``" msgstr "" -#: c-api/code.rst:168 +#: c-api/code.rst:173 msgid "Type of a code object watcher callback function." msgstr "" -#: c-api/code.rst:170 +#: c-api/code.rst:175 msgid "" "If *event* is ``PY_CODE_EVENT_CREATE``, then the callback is invoked after " "`co` has been fully initialized. Otherwise, the callback is invoked before " @@ -201,7 +205,7 @@ msgid "" "inspected." msgstr "" -#: c-api/code.rst:175 +#: c-api/code.rst:180 msgid "" "If *event* is ``PY_CODE_EVENT_DESTROY``, taking a reference in the callback " "to the about-to-be-destroyed code object will resurrect it and prevent it " @@ -209,7 +213,7 @@ msgid "" "later, any watcher callbacks active at that time will be called again." msgstr "" -#: c-api/code.rst:180 +#: c-api/code.rst:185 msgid "" "Users of this API should not rely on internal runtime implementation " "details. Such details may include, but are not limited to, the exact order " @@ -219,14 +223,14 @@ msgid "" "the Python code being executed." msgstr "" -#: c-api/code.rst:187 +#: c-api/code.rst:192 msgid "" "If the callback sets an exception, it must return ``-1``; this exception " "will be printed as an unraisable exception using :c:func:" "`PyErr_WriteUnraisable`. Otherwise it should return ``0``." msgstr "" -#: c-api/code.rst:191 +#: c-api/code.rst:196 msgid "" "There may already be a pending exception set on entry to the callback. In " "this case, the callback should return ``0`` with the same exception still " @@ -235,85 +239,85 @@ msgid "" "it before returning." msgstr "" -#: c-api/code.rst:201 +#: c-api/code.rst:206 msgid "Extra information" msgstr "" -#: c-api/code.rst:203 +#: c-api/code.rst:208 msgid "" "To support low-level extensions to frame evaluation, such as external just-" "in-time compilers, it is possible to attach arbitrary extra data to code " "objects." msgstr "" -#: c-api/code.rst:207 +#: c-api/code.rst:212 msgid "" "These functions are part of the unstable C API tier: this functionality is a " "CPython implementation detail, and the API may change without deprecation " "warnings." msgstr "" -#: c-api/code.rst:213 +#: c-api/code.rst:218 msgid "Return a new an opaque index value used to adding data to code objects." msgstr "" -#: c-api/code.rst:215 +#: c-api/code.rst:220 msgid "" "You generally call this function once (per interpreter) and use the result " "with ``PyCode_GetExtra`` and ``PyCode_SetExtra`` to manipulate data on " "individual code objects." msgstr "" -#: c-api/code.rst:219 +#: c-api/code.rst:224 msgid "" "If *free* is not ``NULL``: when a code object is deallocated, *free* will be " "called on non-``NULL`` data stored under the new index. Use :c:func:" "`Py_DecRef` when storing :c:type:`PyObject`." msgstr "" -#: c-api/code.rst:225 +#: c-api/code.rst:230 msgid "as ``_PyEval_RequestCodeExtraIndex``" msgstr "" -#: c-api/code.rst:229 +#: c-api/code.rst:234 msgid "" "Renamed to ``PyUnstable_Eval_RequestCodeExtraIndex``. The old private name " "is deprecated, but will be available until the API changes." msgstr "" -#: c-api/code.rst:235 +#: c-api/code.rst:240 msgid "" "Set *extra* to the extra data stored under the given index. Return 0 on " "success. Set an exception and return -1 on failure." msgstr "" -#: c-api/code.rst:238 +#: c-api/code.rst:243 msgid "" "If no data was set under the index, set *extra* to ``NULL`` and return 0 " "without setting an exception." msgstr "" -#: c-api/code.rst:243 +#: c-api/code.rst:248 msgid "as ``_PyCode_GetExtra``" msgstr "" -#: c-api/code.rst:247 +#: c-api/code.rst:252 msgid "" "Renamed to ``PyUnstable_Code_GetExtra``. The old private name is deprecated, " "but will be available until the API changes." msgstr "" -#: c-api/code.rst:253 +#: c-api/code.rst:258 msgid "" "Set the extra data stored under the given index to *extra*. Return 0 on " "success. Set an exception and return -1 on failure." msgstr "" -#: c-api/code.rst:258 +#: c-api/code.rst:263 msgid "as ``_PyCode_SetExtra``" msgstr "" -#: c-api/code.rst:262 +#: c-api/code.rst:267 msgid "" "Renamed to ``PyUnstable_Code_SetExtra``. The old private name is deprecated, " "but will be available until the API changes." @@ -331,22 +335,22 @@ msgstr "" msgid "code object" msgstr "" -#: c-api/code.rst:51 -msgid "PyCode_New" +#: c-api/code.rst:56 +msgid "PyCode_New (C function)" msgstr "" -#: c-api/code.rst:64 -msgid "PyCode_NewWithPosOnlyArgs" +#: c-api/code.rst:69 +msgid "PyCode_NewWithPosOnlyArgs (C function)" msgstr "" -#: c-api/code.rst:223 -msgid "_PyEval_RequestCodeExtraIndex" +#: c-api/code.rst:228 +msgid "_PyEval_RequestCodeExtraIndex (C function)" msgstr "" -#: c-api/code.rst:241 -msgid "_PyCode_GetExtra" +#: c-api/code.rst:246 +msgid "_PyCode_GetExtra (C function)" msgstr "" -#: c-api/code.rst:256 -msgid "_PyCode_SetExtra" +#: c-api/code.rst:261 +msgid "_PyCode_SetExtra (C function)" msgstr "" diff --git a/c-api/conversion.po b/c-api/conversion.po index 320408a35..8c0aea1b4 100644 --- a/c-api/conversion.po +++ b/c-api/conversion.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -90,6 +90,51 @@ msgstr "" #: c-api/conversion.rst:53 msgid "" +"Convert the initial part of the string in ``str`` to an :c:expr:`unsigned " +"long` value according to the given ``base``, which must be between ``2`` and " +"``36`` inclusive, or be the special value ``0``." +msgstr "" + +#: c-api/conversion.rst:57 +msgid "" +"Leading white space and case of characters are ignored. If ``base`` is zero " +"it looks for a leading ``0b``, ``0o`` or ``0x`` to tell which base. If " +"these are absent it defaults to ``10``. Base must be 0 or between 2 and 36 " +"(inclusive). If ``ptr`` is non-``NULL`` it will contain a pointer to the " +"end of the scan." +msgstr "" + +#: c-api/conversion.rst:63 +msgid "" +"If the converted value falls out of range of corresponding return type, " +"range error occurs (:c:data:`errno` is set to :c:macro:`!ERANGE`) and :c:" +"macro:`!ULONG_MAX` is returned. If no conversion can be performed, ``0`` is " +"returned." +msgstr "" + +#: c-api/conversion.rst:68 +msgid "See also the Unix man page :manpage:`strtoul(3)`." +msgstr "" + +#: c-api/conversion.rst:75 +msgid "" +"Convert the initial part of the string in ``str`` to an :c:expr:`long` value " +"according to the given ``base``, which must be between ``2`` and ``36`` " +"inclusive, or be the special value ``0``." +msgstr "" + +#: c-api/conversion.rst:79 +msgid "" +"Same as :c:func:`PyOS_strtoul`, but return a :c:expr:`long` value instead " +"and :c:macro:`LONG_MAX` on overflows." +msgstr "" + +#: c-api/conversion.rst:82 +msgid "See also the Unix man page :manpage:`strtol(3)`." +msgstr "" + +#: c-api/conversion.rst:89 +msgid "" "Convert a string ``s`` to a :c:expr:`double`, raising a Python exception on " "failure. The set of accepted strings corresponds to the set of strings " "accepted by Python's :func:`float` constructor, except that ``s`` must not " @@ -97,14 +142,14 @@ msgid "" "current locale." msgstr "" -#: c-api/conversion.rst:59 +#: c-api/conversion.rst:95 msgid "" "If ``endptr`` is ``NULL``, convert the whole string. Raise :exc:" "`ValueError` and return ``-1.0`` if the string is not a valid representation " "of a floating-point number." msgstr "" -#: c-api/conversion.rst:63 +#: c-api/conversion.rst:99 msgid "" "If endptr is not ``NULL``, convert as much of the string as possible and set " "``*endptr`` to point to the first unconverted character. If no initial " @@ -113,7 +158,7 @@ msgid "" "ValueError, and return ``-1.0``." msgstr "" -#: c-api/conversion.rst:70 +#: c-api/conversion.rst:106 msgid "" "If ``s`` represents a value that is too large to store in a float (for " "example, ``\"1e500\"`` is such a string on many platforms) then if " @@ -124,50 +169,50 @@ msgid "" "the first character after the converted value." msgstr "" -#: c-api/conversion.rst:78 +#: c-api/conversion.rst:114 msgid "" "If any other error occurs during the conversion (for example an out-of-" "memory error), set the appropriate Python exception and return ``-1.0``." msgstr "" -#: c-api/conversion.rst:87 +#: c-api/conversion.rst:123 msgid "" "Convert a :c:expr:`double` *val* to a string using supplied *format_code*, " "*precision*, and *flags*." msgstr "" -#: c-api/conversion.rst:90 +#: c-api/conversion.rst:126 msgid "" "*format_code* must be one of ``'e'``, ``'E'``, ``'f'``, ``'F'``, ``'g'``, " "``'G'`` or ``'r'``. For ``'r'``, the supplied *precision* must be 0 and is " "ignored. The ``'r'`` format code specifies the standard :func:`repr` format." msgstr "" -#: c-api/conversion.rst:95 +#: c-api/conversion.rst:131 msgid "" "*flags* can be zero or more of the values ``Py_DTSF_SIGN``, " "``Py_DTSF_ADD_DOT_0``, or ``Py_DTSF_ALT``, or-ed together:" msgstr "" -#: c-api/conversion.rst:98 +#: c-api/conversion.rst:134 msgid "" "``Py_DTSF_SIGN`` means to always precede the returned string with a sign " "character, even if *val* is non-negative." msgstr "" -#: c-api/conversion.rst:101 +#: c-api/conversion.rst:137 msgid "" "``Py_DTSF_ADD_DOT_0`` means to ensure that the returned string will not look " "like an integer." msgstr "" -#: c-api/conversion.rst:104 +#: c-api/conversion.rst:140 msgid "" "``Py_DTSF_ALT`` means to apply \"alternate\" formatting rules. See the " "documentation for the :c:func:`PyOS_snprintf` ``'#'`` specifier for details." msgstr "" -#: c-api/conversion.rst:108 +#: c-api/conversion.rst:144 msgid "" "If *ptype* is non-``NULL``, then the value it points to will be set to one " "of ``Py_DTST_FINITE``, ``Py_DTST_INFINITE``, or ``Py_DTST_NAN``, signifying " @@ -175,20 +220,20 @@ msgid "" "respectively." msgstr "" -#: c-api/conversion.rst:112 +#: c-api/conversion.rst:148 msgid "" "The return value is a pointer to *buffer* with the converted string or " "``NULL`` if the conversion failed. The caller is responsible for freeing the " "returned string by calling :c:func:`PyMem_Free`." msgstr "" -#: c-api/conversion.rst:121 +#: c-api/conversion.rst:157 msgid "" "Case insensitive comparison of strings. The function works almost " "identically to :c:func:`!strcmp` except that it ignores the case." msgstr "" -#: c-api/conversion.rst:127 +#: c-api/conversion.rst:163 msgid "" "Case insensitive comparison of strings. The function works almost " "identically to :c:func:`!strncmp` except that it ignores the case." diff --git a/c-api/exceptions.po b/c-api/exceptions.po index 8e01de222..f52f1e734 100644 --- a/c-api/exceptions.po +++ b/c-api/exceptions.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -403,7 +403,8 @@ msgstr "" #: c-api/exceptions.rst:385 msgid "" "Function similar to :c:func:`PyErr_WarnFormat`, but *category* is :exc:" -"`ResourceWarning` and it passes *source* to :func:`warnings.WarningMessage`." +"`ResourceWarning` and it passes *source* to :class:`!warnings." +"WarningMessage`." msgstr "" #: c-api/exceptions.rst:392 @@ -735,7 +736,7 @@ msgstr "" #: c-api/exceptions.rst:722 msgid "" -"The :attr:`__module__` attribute of the new class is set to the first part " +"The :attr:`!__module__` attribute of the new class is set to the first part " "(up to the last dot) of the *name* argument, and the class name is set to " "the last part (after the last dot). The *base* argument can be used to " "specify alternate base classes; it can either be only one class or a tuple " @@ -904,8 +905,8 @@ msgstr "" #: c-api/exceptions.rst:894 msgid "" -"If :c:macro:`USE_STACKCHECK` is defined, this function checks if the OS " -"stack overflowed using :c:func:`PyOS_CheckStack`. In this is the case, it " +"If :c:macro:`!USE_STACKCHECK` is defined, this function checks if the OS " +"stack overflowed using :c:func:`PyOS_CheckStack`. If this is the case, it " "sets a :exc:`MemoryError` and returns a nonzero value." msgstr "" @@ -1455,15 +1456,15 @@ msgid "These are compatibility aliases to :c:data:`PyExc_OSError`:" msgstr "" #: c-api/exceptions.rst:1148 -msgid ":c:data:`PyExc_EnvironmentError`" +msgid ":c:data:`!PyExc_EnvironmentError`" msgstr "" #: c-api/exceptions.rst:1150 -msgid ":c:data:`PyExc_IOError`" +msgid ":c:data:`!PyExc_IOError`" msgstr "" #: c-api/exceptions.rst:1152 -msgid ":c:data:`PyExc_WindowsError`" +msgid ":c:data:`!PyExc_WindowsError`" msgstr "" #: c-api/exceptions.rst:1152 @@ -1601,7 +1602,7 @@ msgid "This is a base class for other standard warning categories." msgstr "" #: c-api/exceptions.rst:170 -msgid "strerror()" +msgid "strerror (C function)" msgstr "" #: c-api/exceptions.rst:654 c-api/exceptions.rst:669 @@ -1613,7 +1614,7 @@ msgid "signal" msgstr "" #: c-api/exceptions.rst:654 -msgid "SIGINT" +msgid "SIGINT (C macro)" msgstr "" #: c-api/exceptions.rst:654 c-api/exceptions.rst:669 @@ -1621,269 +1622,269 @@ msgid "KeyboardInterrupt (built-in exception)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_BaseException" +msgid "PyExc_BaseException (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_Exception" +msgid "PyExc_Exception (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_ArithmeticError" +msgid "PyExc_ArithmeticError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_AssertionError" +msgid "PyExc_AssertionError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_AttributeError" +msgid "PyExc_AttributeError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_BlockingIOError" +msgid "PyExc_BlockingIOError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_BrokenPipeError" +msgid "PyExc_BrokenPipeError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_BufferError" +msgid "PyExc_BufferError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_ChildProcessError" +msgid "PyExc_ChildProcessError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_ConnectionAbortedError" +msgid "PyExc_ConnectionAbortedError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_ConnectionError" +msgid "PyExc_ConnectionError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_ConnectionRefusedError" +msgid "PyExc_ConnectionRefusedError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_ConnectionResetError" +msgid "PyExc_ConnectionResetError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_EOFError" +msgid "PyExc_EOFError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_FileExistsError" +msgid "PyExc_FileExistsError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_FileNotFoundError" +msgid "PyExc_FileNotFoundError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_FloatingPointError" +msgid "PyExc_FloatingPointError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_GeneratorExit" +msgid "PyExc_GeneratorExit (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_ImportError" +msgid "PyExc_ImportError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_IndentationError" +msgid "PyExc_IndentationError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_IndexError" +msgid "PyExc_IndexError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_InterruptedError" +msgid "PyExc_InterruptedError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_IsADirectoryError" +msgid "PyExc_IsADirectoryError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_KeyError" +msgid "PyExc_KeyError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_KeyboardInterrupt" +msgid "PyExc_KeyboardInterrupt (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_LookupError" +msgid "PyExc_LookupError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_MemoryError" +msgid "PyExc_MemoryError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_ModuleNotFoundError" +msgid "PyExc_ModuleNotFoundError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_NameError" +msgid "PyExc_NameError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_NotADirectoryError" +msgid "PyExc_NotADirectoryError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_NotImplementedError" +msgid "PyExc_NotImplementedError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_OSError" +msgid "PyExc_OSError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_OverflowError" +msgid "PyExc_OverflowError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_PermissionError" +msgid "PyExc_PermissionError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_ProcessLookupError" +msgid "PyExc_ProcessLookupError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_RecursionError" +msgid "PyExc_RecursionError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_ReferenceError" +msgid "PyExc_ReferenceError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_RuntimeError" +msgid "PyExc_RuntimeError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_StopAsyncIteration" +msgid "PyExc_StopAsyncIteration (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_StopIteration" +msgid "PyExc_StopIteration (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_SyntaxError" +msgid "PyExc_SyntaxError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_SystemError" +msgid "PyExc_SystemError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_SystemExit" +msgid "PyExc_SystemExit (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_TabError" +msgid "PyExc_TabError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_TimeoutError" +msgid "PyExc_TimeoutError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_TypeError" +msgid "PyExc_TypeError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_UnboundLocalError" +msgid "PyExc_UnboundLocalError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_UnicodeDecodeError" +msgid "PyExc_UnicodeDecodeError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_UnicodeEncodeError" +msgid "PyExc_UnicodeEncodeError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_UnicodeError" +msgid "PyExc_UnicodeError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_UnicodeTranslateError" +msgid "PyExc_UnicodeTranslateError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_ValueError" +msgid "PyExc_ValueError (C var)" msgstr "" #: c-api/exceptions.rst:957 -msgid "PyExc_ZeroDivisionError" +msgid "PyExc_ZeroDivisionError (C var)" msgstr "" #: c-api/exceptions.rst:1140 -msgid "PyExc_EnvironmentError" +msgid "PyExc_EnvironmentError (C var)" msgstr "" #: c-api/exceptions.rst:1140 -msgid "PyExc_IOError" +msgid "PyExc_IOError (C var)" msgstr "" #: c-api/exceptions.rst:1140 -msgid "PyExc_WindowsError" +msgid "PyExc_WindowsError (C var)" msgstr "" #: c-api/exceptions.rst:1177 -msgid "PyExc_Warning" +msgid "PyExc_Warning (C var)" msgstr "" #: c-api/exceptions.rst:1177 -msgid "PyExc_BytesWarning" +msgid "PyExc_BytesWarning (C var)" msgstr "" #: c-api/exceptions.rst:1177 -msgid "PyExc_DeprecationWarning" +msgid "PyExc_DeprecationWarning (C var)" msgstr "" #: c-api/exceptions.rst:1177 -msgid "PyExc_FutureWarning" +msgid "PyExc_FutureWarning (C var)" msgstr "" #: c-api/exceptions.rst:1177 -msgid "PyExc_ImportWarning" +msgid "PyExc_ImportWarning (C var)" msgstr "" #: c-api/exceptions.rst:1177 -msgid "PyExc_PendingDeprecationWarning" +msgid "PyExc_PendingDeprecationWarning (C var)" msgstr "" #: c-api/exceptions.rst:1177 -msgid "PyExc_ResourceWarning" +msgid "PyExc_ResourceWarning (C var)" msgstr "" #: c-api/exceptions.rst:1177 -msgid "PyExc_RuntimeWarning" +msgid "PyExc_RuntimeWarning (C var)" msgstr "" #: c-api/exceptions.rst:1177 -msgid "PyExc_SyntaxWarning" +msgid "PyExc_SyntaxWarning (C var)" msgstr "" #: c-api/exceptions.rst:1177 -msgid "PyExc_UnicodeWarning" +msgid "PyExc_UnicodeWarning (C var)" msgstr "" #: c-api/exceptions.rst:1177 -msgid "PyExc_UserWarning" +msgid "PyExc_UserWarning (C var)" msgstr "" diff --git a/c-api/file.po b/c-api/file.po index bfdaaa669..e75d0bad3 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: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -82,43 +82,47 @@ msgid "" msgstr "" #: c-api/file.rst:68 +msgid "The handler is a function of type:" +msgstr "" + +#: c-api/file.rst:72 msgid "" -"The handler is a function of type :c:expr:`PyObject *(\\*)(PyObject *path, " -"void *userData)`, where *path* is guaranteed to be :c:type:`PyUnicodeObject`." +"Equivalent of :c:expr:`PyObject *(\\*)(PyObject *path, void *userData)`, " +"where *path* is guaranteed to be :c:type:`PyUnicodeObject`." msgstr "" -#: c-api/file.rst:71 +#: c-api/file.rst:76 msgid "" "The *userData* pointer is passed into the hook function. Since hook " "functions may be called from different runtimes, this pointer should not " "refer directly to Python state." msgstr "" -#: c-api/file.rst:75 +#: c-api/file.rst:80 msgid "" "As this hook is intentionally used during import, avoid importing new " "modules during its execution unless they are known to be frozen or available " "in ``sys.modules``." msgstr "" -#: c-api/file.rst:79 +#: c-api/file.rst:84 msgid "" "Once a hook has been set, it cannot be removed or replaced, and later calls " "to :c:func:`PyFile_SetOpenCodeHook` will fail. On failure, the function " "returns -1 and sets an exception if the interpreter has been initialized." msgstr "" -#: c-api/file.rst:83 +#: c-api/file.rst:88 msgid "This function is safe to call before :c:func:`Py_Initialize`." msgstr "" -#: c-api/file.rst:85 +#: c-api/file.rst:90 msgid "" "Raises an :ref:`auditing event ` ``setopencodehook`` with no " "arguments." msgstr "" -#: c-api/file.rst:95 +#: c-api/file.rst:100 msgid "" "Write object *obj* to file object *p*. The only supported flag for *flags* " "is :c:macro:`Py_PRINT_RAW`; if given, the :func:`str` of the object is " @@ -126,7 +130,7 @@ msgid "" "failure; the appropriate exception will be set." msgstr "" -#: c-api/file.rst:103 +#: c-api/file.rst:108 msgid "" "Write string *s* to file object *p*. Return ``0`` on success or ``-1`` on " "failure; the appropriate exception will be set." @@ -144,6 +148,6 @@ msgstr "" msgid "EOFError (built-in exception)" msgstr "" -#: c-api/file.rst:93 -msgid "Py_PRINT_RAW" +#: c-api/file.rst:98 +msgid "Py_PRINT_RAW (C macro)" msgstr "" diff --git a/c-api/gcsupport.po b/c-api/gcsupport.po index be6586e73..73a9cd1eb 100644 --- a/c-api/gcsupport.po +++ b/c-api/gcsupport.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -137,12 +137,18 @@ msgstr "" #: c-api/gcsupport.rst:88 msgid "" -"Resize an object allocated by :c:macro:`PyObject_NewVar`. Returns the " -"resized object or ``NULL`` on failure. *op* must not be tracked by the " -"collector yet." +"Resize an object allocated by :c:macro:`PyObject_NewVar`. Returns the " +"resized object of type ``TYPE*`` (refers to any C type) or ``NULL`` on " +"failure." msgstr "" -#: c-api/gcsupport.rst:94 +#: c-api/gcsupport.rst:92 +msgid "" +"*op* must be of type :c:expr:`PyVarObject *` and must not be tracked by the " +"collector yet. *newsize* must be of type :c:type:`Py_ssize_t`." +msgstr "" + +#: c-api/gcsupport.rst:99 msgid "" "Adds the object *op* to the set of container objects tracked by the " "collector. The collector can run at unexpected times so objects must be " @@ -151,45 +157,45 @@ msgid "" "usually near the end of the constructor." msgstr "" -#: c-api/gcsupport.rst:103 +#: c-api/gcsupport.rst:108 msgid "" "Returns non-zero if the object implements the garbage collector protocol, " "otherwise returns 0." msgstr "" -#: c-api/gcsupport.rst:106 +#: c-api/gcsupport.rst:111 msgid "" "The object cannot be tracked by the garbage collector if this function " "returns 0." msgstr "" -#: c-api/gcsupport.rst:111 +#: c-api/gcsupport.rst:116 msgid "" "Returns 1 if the object type of *op* implements the GC protocol and *op* is " "being currently tracked by the garbage collector and 0 otherwise." msgstr "" -#: c-api/gcsupport.rst:114 +#: c-api/gcsupport.rst:119 msgid "This is analogous to the Python function :func:`gc.is_tracked`." msgstr "" -#: c-api/gcsupport.rst:121 +#: c-api/gcsupport.rst:126 msgid "" "Returns 1 if the object type of *op* implements the GC protocol and *op* has " "been already finalized by the garbage collector and 0 otherwise." msgstr "" -#: c-api/gcsupport.rst:124 +#: c-api/gcsupport.rst:129 msgid "This is analogous to the Python function :func:`gc.is_finalized`." msgstr "" -#: c-api/gcsupport.rst:131 +#: c-api/gcsupport.rst:136 msgid "" "Releases memory allocated to an object using :c:macro:`PyObject_GC_New` or :" "c:macro:`PyObject_GC_NewVar`." msgstr "" -#: c-api/gcsupport.rst:137 +#: c-api/gcsupport.rst:142 msgid "" "Remove the object *op* from the set of container objects tracked by the " "collector. Note that :c:func:`PyObject_GC_Track` can be called again on " @@ -199,19 +205,19 @@ msgid "" "handler become invalid." msgstr "" -#: c-api/gcsupport.rst:146 +#: c-api/gcsupport.rst:151 msgid "" "The :c:func:`!_PyObject_GC_TRACK` and :c:func:`!_PyObject_GC_UNTRACK` macros " "have been removed from the public C API." msgstr "" -#: c-api/gcsupport.rst:149 +#: c-api/gcsupport.rst:154 msgid "" "The :c:member:`~PyTypeObject.tp_traverse` handler accepts a function " "parameter of this type:" msgstr "" -#: c-api/gcsupport.rst:154 +#: c-api/gcsupport.rst:159 msgid "" "Type of the visitor function passed to the :c:member:`~PyTypeObject." "tp_traverse` handler. The function should be called with an object to " @@ -221,13 +227,13 @@ msgid "" "users will need to write their own visitor functions." msgstr "" -#: c-api/gcsupport.rst:161 +#: c-api/gcsupport.rst:166 msgid "" "The :c:member:`~PyTypeObject.tp_traverse` handler must have the following " "type:" msgstr "" -#: c-api/gcsupport.rst:166 +#: c-api/gcsupport.rst:171 msgid "" "Traversal function for a container object. Implementations must call the " "*visit* function for each object directly contained by *self*, with the " @@ -237,7 +243,7 @@ msgid "" "returned immediately." msgstr "" -#: c-api/gcsupport.rst:173 +#: c-api/gcsupport.rst:178 msgid "" "To simplify writing :c:member:`~PyTypeObject.tp_traverse` handlers, a :c:" "func:`Py_VISIT` macro is provided. In order to use this macro, the :c:" @@ -245,20 +251,20 @@ msgid "" "exactly *visit* and *arg*:" msgstr "" -#: c-api/gcsupport.rst:180 +#: c-api/gcsupport.rst:185 msgid "" "If *o* is not ``NULL``, call the *visit* callback, with arguments *o* and " "*arg*. If *visit* returns a non-zero value, then return it. Using this " "macro, :c:member:`~PyTypeObject.tp_traverse` handlers look like::" msgstr "" -#: c-api/gcsupport.rst:193 +#: c-api/gcsupport.rst:198 msgid "" "The :c:member:`~PyTypeObject.tp_clear` handler must be of the :c:type:" "`inquiry` type, or ``NULL`` if the object is immutable." msgstr "" -#: c-api/gcsupport.rst:199 +#: c-api/gcsupport.rst:204 msgid "" "Drop references that may have created reference cycles. Immutable objects " "do not have to define this method since they can never directly create " @@ -268,23 +274,23 @@ msgid "" "in a reference cycle." msgstr "" -#: c-api/gcsupport.rst:208 +#: c-api/gcsupport.rst:213 msgid "Controlling the Garbage Collector State" msgstr "" -#: c-api/gcsupport.rst:210 +#: c-api/gcsupport.rst:215 msgid "" "The C-API provides the following functions for controlling garbage " "collection runs." msgstr "" -#: c-api/gcsupport.rst:215 +#: c-api/gcsupport.rst:220 msgid "" "Perform a full garbage collection, if the garbage collector is enabled. " "(Note that :func:`gc.collect` runs it unconditionally.)" msgstr "" -#: c-api/gcsupport.rst:218 +#: c-api/gcsupport.rst:223 msgid "" "Returns the number of collected + unreachable objects which cannot be " "collected. If the garbage collector is disabled or already collecting, " @@ -292,54 +298,54 @@ msgid "" "data:`sys.unraisablehook`. This function does not raise exceptions." msgstr "" -#: c-api/gcsupport.rst:228 +#: c-api/gcsupport.rst:233 msgid "" "Enable the garbage collector: similar to :func:`gc.enable`. Returns the " "previous state, 0 for disabled and 1 for enabled." msgstr "" -#: c-api/gcsupport.rst:236 +#: c-api/gcsupport.rst:241 msgid "" "Disable the garbage collector: similar to :func:`gc.disable`. Returns the " "previous state, 0 for disabled and 1 for enabled." msgstr "" -#: c-api/gcsupport.rst:244 +#: c-api/gcsupport.rst:249 msgid "" "Query the state of the garbage collector: similar to :func:`gc.isenabled`. " "Returns the current state, 0 for disabled and 1 for enabled." msgstr "" -#: c-api/gcsupport.rst:251 +#: c-api/gcsupport.rst:256 msgid "Querying Garbage Collector State" msgstr "" -#: c-api/gcsupport.rst:253 +#: c-api/gcsupport.rst:258 msgid "" "The C-API provides the following interface for querying information about " "the garbage collector." msgstr "" -#: c-api/gcsupport.rst:258 +#: c-api/gcsupport.rst:263 msgid "" "Run supplied *callback* on all live GC-capable objects. *arg* is passed " "through to all invocations of *callback*." msgstr "" -#: c-api/gcsupport.rst:262 +#: c-api/gcsupport.rst:267 msgid "" "If new objects are (de)allocated by the callback it is undefined if they " "will be visited." msgstr "" -#: c-api/gcsupport.rst:265 +#: c-api/gcsupport.rst:270 msgid "" "Garbage collection is disabled during operation. Explicitly running a " "collection in the callback may lead to undefined behaviour e.g. visiting the " "same objects multiple times or not at all." msgstr "" -#: c-api/gcsupport.rst:273 +#: c-api/gcsupport.rst:278 msgid "" "Type of the visitor function to be passed to :c:func:" "`PyUnstable_GC_VisitObjects`. *arg* is the same as the *arg* passed to " diff --git a/c-api/import.po b/c-api/import.po index 19de349d0..195dbc115 100644 --- a/c-api/import.po +++ b/c-api/import.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -22,28 +22,15 @@ msgstr "" #: c-api/import.rst:16 msgid "" -"This is a simplified interface to :c:func:`PyImport_ImportModuleEx` below, " -"leaving the *globals* and *locals* arguments set to ``NULL`` and *level* set " -"to 0. When the *name* argument contains a dot (when it specifies a " -"submodule of a package), the *fromlist* argument is set to the list " -"``['*']`` so that the return value is the named module rather than the top-" -"level package containing it as would otherwise be the case. (Unfortunately, " -"this has an additional side effect when *name* in fact specifies a " -"subpackage instead of a submodule: the submodules specified in the package's " -"``__all__`` variable are loaded.) Return a new reference to the imported " -"module, or ``NULL`` with an exception set on failure. A failing import of a " -"module doesn't leave the module in :data:`sys.modules`." +"This is a wrapper around :c:func:`PyImport_Import()` which takes a :c:expr:" +"`const char *` as an argument instead of a :c:expr:`PyObject *`." msgstr "" -#: c-api/import.rst:89 -msgid "This function always uses absolute imports." -msgstr "" - -#: c-api/import.rst:33 +#: c-api/import.rst:21 msgid "This function is a deprecated alias of :c:func:`PyImport_ImportModule`." msgstr "" -#: c-api/import.rst:35 +#: c-api/import.rst:23 msgid "" "This function used to fail immediately when the import lock was held by " "another thread. In Python 3.3 though, the locking scheme switched to per-" @@ -51,13 +38,13 @@ msgid "" "needed anymore." msgstr "" -#: c-api/import.rst:46 +#: c-api/import.rst:34 msgid "" "Import a module. This is best described by referring to the built-in Python " "function :func:`__import__`." msgstr "" -#: c-api/import.rst:65 +#: c-api/import.rst:53 msgid "" "The return value is a new reference to the imported module or top-level " "package, or ``NULL`` with an exception set on failure. Like for :func:" @@ -65,30 +52,30 @@ msgid "" "is normally the top-level package, unless a non-empty *fromlist* was given." msgstr "" -#: c-api/import.rst:55 +#: c-api/import.rst:43 msgid "" "Failing imports remove incomplete module objects, like with :c:func:" "`PyImport_ImportModule`." msgstr "" -#: c-api/import.rst:61 +#: c-api/import.rst:49 msgid "" "Import a module. This is best described by referring to the built-in Python " "function :func:`__import__`, as the standard :func:`__import__` function " "calls this function directly." msgstr "" -#: c-api/import.rst:75 +#: c-api/import.rst:63 msgid "" "Similar to :c:func:`PyImport_ImportModuleLevelObject`, but the name is a " "UTF-8 encoded string instead of a Unicode object." msgstr "" -#: c-api/import.rst:78 +#: c-api/import.rst:66 msgid "Negative values for *level* are no longer accepted." msgstr "" -#: c-api/import.rst:83 +#: c-api/import.rst:71 msgid "" "This is a higher-level interface that calls the current \"import hook " "function\" (with an explicit *level* of 0, meaning absolute import). It " @@ -97,13 +84,17 @@ msgid "" "hooks are installed in the current environment." msgstr "" -#: c-api/import.rst:94 +#: c-api/import.rst:77 +msgid "This function always uses absolute imports." +msgstr "" + +#: c-api/import.rst:82 msgid "" "Reload a module. Return a new reference to the reloaded module, or ``NULL`` " "with an exception set on failure (the module still exists in this case)." msgstr "" -#: c-api/import.rst:100 +#: c-api/import.rst:88 msgid "" "Return the module object corresponding to a module name. The *name* " "argument may be of the form ``package.module``. First check the modules " @@ -111,7 +102,7 @@ msgid "" "in the modules dictionary. Return ``NULL`` with an exception set on failure." msgstr "" -#: c-api/import.rst:107 +#: c-api/import.rst:95 msgid "" "This function does not load or import the module; if the module wasn't " "already loaded, you will get an empty module object. Use :c:func:" @@ -120,13 +111,13 @@ msgid "" "already present." msgstr "" -#: c-api/import.rst:117 +#: c-api/import.rst:105 msgid "" "Similar to :c:func:`PyImport_AddModuleObject`, but the name is a UTF-8 " "encoded string instead of a Unicode object." msgstr "" -#: c-api/import.rst:125 +#: c-api/import.rst:113 msgid "" "Given a module name (possibly of the form ``package.module``) and a code " "object read from a Python bytecode file or obtained from the built-in " @@ -140,7 +131,7 @@ msgid "" "to the module author's intents) state." msgstr "" -#: c-api/import.rst:135 +#: c-api/import.rst:123 msgid "" "The module's :attr:`__spec__` and :attr:`__loader__` will be set, if not set " "already, with the appropriate values. The spec's loader will be set to the " @@ -148,61 +139,61 @@ msgid "" "machinery.SourceFileLoader` otherwise." msgstr "" -#: c-api/import.rst:140 +#: c-api/import.rst:128 msgid "" "The module's :attr:`__file__` attribute will be set to the code object's :" "attr:`~codeobject.co_filename`. If applicable, :attr:`__cached__` will also " "be set." msgstr "" -#: c-api/import.rst:144 +#: c-api/import.rst:132 msgid "" "This function will reload the module if it was already imported. See :c:" "func:`PyImport_ReloadModule` for the intended way to reload a module." msgstr "" -#: c-api/import.rst:147 +#: c-api/import.rst:135 msgid "" "If *name* points to a dotted name of the form ``package.module``, any " "package structures not already created will still not be created." msgstr "" -#: c-api/import.rst:150 +#: c-api/import.rst:138 msgid "" "See also :c:func:`PyImport_ExecCodeModuleEx` and :c:func:" "`PyImport_ExecCodeModuleWithPathnames`." msgstr "" -#: c-api/import.rst:153 +#: c-api/import.rst:141 msgid "" "The setting of :attr:`__cached__` and :attr:`__loader__` is deprecated. See :" "class:`~importlib.machinery.ModuleSpec` for alternatives." msgstr "" -#: c-api/import.rst:161 +#: c-api/import.rst:149 msgid "" "Like :c:func:`PyImport_ExecCodeModule`, but the :attr:`__file__` attribute " "of the module object is set to *pathname* if it is non-``NULL``." msgstr "" -#: c-api/import.rst:164 +#: c-api/import.rst:152 msgid "See also :c:func:`PyImport_ExecCodeModuleWithPathnames`." msgstr "" -#: c-api/import.rst:169 +#: c-api/import.rst:157 msgid "" "Like :c:func:`PyImport_ExecCodeModuleEx`, but the :attr:`__cached__` " "attribute of the module object is set to *cpathname* if it is non-``NULL``. " "Of the three functions, this is the preferred one to use." msgstr "" -#: c-api/import.rst:175 +#: c-api/import.rst:163 msgid "" "Setting :attr:`__cached__` is deprecated. See :class:`~importlib.machinery." "ModuleSpec` for alternatives." msgstr "" -#: c-api/import.rst:182 +#: c-api/import.rst:170 msgid "" "Like :c:func:`PyImport_ExecCodeModuleObject`, but *name*, *pathname* and " "*cpathname* are UTF-8 encoded strings. Attempts are also made to figure out " @@ -210,48 +201,48 @@ msgid "" "set to ``NULL``." msgstr "" -#: c-api/import.rst:188 +#: c-api/import.rst:176 msgid "" "Uses :func:`!imp.source_from_cache()` in calculating the source path if only " "the bytecode path is provided." msgstr "" -#: c-api/import.rst:191 +#: c-api/import.rst:179 msgid "No longer uses the removed :mod:`!imp` module." msgstr "" -#: c-api/import.rst:197 +#: c-api/import.rst:185 msgid "" "Return the magic number for Python bytecode files (a.k.a. :file:`.pyc` " "file). The magic number should be present in the first four bytes of the " "bytecode file, in little-endian byte order. Returns ``-1`` on error." msgstr "" -#: c-api/import.rst:201 +#: c-api/import.rst:189 msgid "Return value of ``-1`` upon failure." msgstr "" -#: c-api/import.rst:207 +#: c-api/import.rst:195 msgid "" "Return the magic tag string for :pep:`3147` format Python bytecode file " "names. Keep in mind that the value at ``sys.implementation.cache_tag`` is " "authoritative and should be used instead of this function." msgstr "" -#: c-api/import.rst:215 +#: c-api/import.rst:203 msgid "" "Return the dictionary used for the module administration (a.k.a. ``sys." "modules``). Note that this is a per-interpreter variable." msgstr "" -#: c-api/import.rst:220 +#: c-api/import.rst:208 msgid "" "Return the already imported module with the given name. If the module has " "not been imported yet then returns ``NULL`` but does not set an error. " "Returns ``NULL`` and sets an error if the lookup failed." msgstr "" -#: c-api/import.rst:228 +#: c-api/import.rst:216 msgid "" "Return a finder object for a :data:`sys.path`/:attr:`!pkg.__path__` item " "*path*, possibly by fetching it from the :data:`sys.path_importer_cache` " @@ -262,7 +253,7 @@ msgid "" "path_importer_cache`. Return a new reference to the finder object." msgstr "" -#: c-api/import.rst:239 +#: c-api/import.rst:227 msgid "" "Load a frozen module named *name*. Return ``1`` for success, ``0`` if the " "module is not found, and ``-1`` with an exception set if the initialization " @@ -271,17 +262,17 @@ msgid "" "the module if it was already imported.)" msgstr "" -#: c-api/import.rst:247 +#: c-api/import.rst:235 msgid "The ``__file__`` attribute is no longer set on the module." msgstr "" -#: c-api/import.rst:253 +#: c-api/import.rst:241 msgid "" "Similar to :c:func:`PyImport_ImportFrozenModuleObject`, but the name is a " "UTF-8 encoded string instead of a Unicode object." msgstr "" -#: c-api/import.rst:261 +#: c-api/import.rst:249 msgid "" "This is the structure type definition for frozen module descriptors, as " "generated by the :program:`freeze` utility (see :file:`Tools/freeze/` in the " @@ -289,13 +280,13 @@ msgid "" "h`, is::" msgstr "" -#: c-api/import.rst:273 +#: c-api/import.rst:261 msgid "" "The new ``is_package`` field indicates whether the module is a package or " "not. This replaces setting the ``size`` field to a negative value." msgstr "" -#: c-api/import.rst:279 +#: c-api/import.rst:267 msgid "" "This pointer is initialized to point to an array of :c:struct:`_frozen` " "records, terminated by one whose members are all ``NULL`` or zero. When a " @@ -304,7 +295,7 @@ msgid "" "frozen modules." msgstr "" -#: c-api/import.rst:287 +#: c-api/import.rst:275 msgid "" "Add a single module to the existing table of built-in modules. This is a " "convenience wrapper around :c:func:`PyImport_ExtendInittab`, returning " @@ -314,7 +305,7 @@ msgid "" "before :c:func:`Py_Initialize`." msgstr "" -#: c-api/import.rst:297 +#: c-api/import.rst:285 msgid "" "Structure describing a single entry in the list of built-in modules. " "Programs which embed Python may use an array of these structures in " @@ -322,11 +313,11 @@ msgid "" "built-in modules. The structure consists of two members:" msgstr "" -#: c-api/import.rst:305 +#: c-api/import.rst:293 msgid "The module name, as an ASCII encoded string." msgstr "" -#: c-api/import.rst:314 +#: c-api/import.rst:302 msgid "" "Add a collection of modules to the table of built-in modules. The *newtab* " "array must end with a sentinel entry which contains ``NULL`` for the :c:" @@ -337,7 +328,7 @@ msgid "" "before :c:func:`Py_Initialize`." msgstr "" -#: c-api/import.rst:321 +#: c-api/import.rst:309 msgid "" "If Python is initialized multiple times, :c:func:`PyImport_AppendInittab` " "or :c:func:`PyImport_ExtendInittab` must be called before each Python " @@ -360,18 +351,18 @@ msgstr "" msgid "modules (in module sys)" msgstr "" -#: c-api/import.rst:123 +#: c-api/import.rst:111 msgid "built-in function" msgstr "" -#: c-api/import.rst:44 +#: c-api/import.rst:32 msgid "__import__" msgstr "" -#: c-api/import.rst:123 +#: c-api/import.rst:111 msgid "compile" msgstr "" -#: c-api/import.rst:259 +#: c-api/import.rst:247 msgid "freeze utility" msgstr "" diff --git a/c-api/init.po b/c-api/init.po index f41067164..45b2195ce 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1016,7 +1016,7 @@ msgid "" "a file, so that other Python threads can run in the meantime." msgstr "" -#: c-api/init.rst:865 +#: c-api/init.rst:864 msgid "" "The Python interpreter keeps some thread-specific bookkeeping information " "inside a data structure called :c:type:`PyThreadState`. There's also one " @@ -1024,32 +1024,32 @@ msgid "" "retrieved using :c:func:`PyThreadState_Get`." msgstr "" -#: c-api/init.rst:871 +#: c-api/init.rst:870 msgid "Releasing the GIL from extension code" msgstr "" -#: c-api/init.rst:873 +#: c-api/init.rst:872 msgid "" "Most extension code manipulating the :term:`GIL` has the following simple " "structure::" msgstr "" -#: c-api/init.rst:882 +#: c-api/init.rst:881 msgid "This is so common that a pair of macros exists to simplify it::" msgstr "" -#: c-api/init.rst:892 +#: c-api/init.rst:891 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:896 +#: c-api/init.rst:895 msgid "The block above expands to the following code::" msgstr "" -#: c-api/init.rst:908 +#: c-api/init.rst:907 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 " @@ -1060,7 +1060,7 @@ msgid "" "state, the lock must be acquired before storing the thread state pointer." msgstr "" -#: c-api/init.rst:917 +#: c-api/init.rst:916 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 " @@ -1070,11 +1070,11 @@ msgid "" "compressing or hashing data." msgstr "" -#: c-api/init.rst:928 +#: c-api/init.rst:927 msgid "Non-Python created threads" msgstr "" -#: c-api/init.rst:930 +#: c-api/init.rst:929 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 " @@ -1084,7 +1084,7 @@ msgid "" "for them." msgstr "" -#: c-api/init.rst:937 +#: c-api/init.rst:936 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 " @@ -1095,14 +1095,14 @@ msgid "" "finally free the thread state data structure." msgstr "" -#: c-api/init.rst:945 +#: c-api/init.rst:944 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:959 +#: c-api/init.rst:958 msgid "" "Note that the ``PyGILState_*`` functions assume there is only one global " "interpreter (created automatically by :c:func:`Py_Initialize`). Python " @@ -1111,11 +1111,11 @@ msgid "" "``PyGILState_*`` API is unsupported." msgstr "" -#: c-api/init.rst:969 +#: c-api/init.rst:968 msgid "Cautions about fork()" msgstr "" -#: c-api/init.rst:971 +#: c-api/init.rst:970 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 " @@ -1124,7 +1124,7 @@ msgid "" "CPython's runtime." msgstr "" -#: c-api/init.rst:977 +#: c-api/init.rst:976 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` " @@ -1141,7 +1141,7 @@ msgid "" "locks, but is not always able to." msgstr "" -#: c-api/init.rst:992 +#: c-api/init.rst:991 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 " @@ -1154,17 +1154,17 @@ msgid "" "called immediately after." msgstr "" -#: c-api/init.rst:1005 +#: c-api/init.rst:1004 msgid "High-level API" msgstr "" -#: c-api/init.rst:1007 +#: c-api/init.rst:1006 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:1012 +#: c-api/init.rst:1011 msgid "" "This data structure represents the state shared by a number of cooperating " "threads. Threads belonging to the same interpreter share their module " @@ -1172,7 +1172,7 @@ msgid "" "in this structure." msgstr "" -#: c-api/init.rst:1017 +#: c-api/init.rst:1016 msgid "" "Threads belonging to different interpreters initially share nothing, except " "process state like available memory, open file descriptors and such. The " @@ -1180,52 +1180,52 @@ msgid "" "which interpreter they belong." msgstr "" -#: c-api/init.rst:1025 +#: c-api/init.rst:1024 msgid "" "This data structure represents the state of a single thread. The only " "public data member is:" msgstr "" -#: c-api/init.rst:1030 +#: c-api/init.rst:1029 msgid "This thread's interpreter state." msgstr "" -#: c-api/init.rst:1041 +#: c-api/init.rst:1040 msgid "Deprecated function which does nothing." msgstr "" -#: c-api/init.rst:1043 +#: c-api/init.rst:1042 msgid "" "In Python 3.6 and older, this function created the GIL if it didn't exist." msgstr "" -#: c-api/init.rst:1045 +#: c-api/init.rst:1044 msgid "The function now does nothing." msgstr "" -#: c-api/init.rst:1048 +#: c-api/init.rst:1047 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:1052 +#: c-api/init.rst:1051 msgid "" "This function cannot be called before :c:func:`Py_Initialize()` anymore." msgstr "" -#: c-api/init.rst:1062 +#: c-api/init.rst:1061 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:1066 +#: c-api/init.rst:1065 msgid "The :term:`GIL` is now initialized by :c:func:`Py_Initialize()`." msgstr "" -#: c-api/init.rst:1074 +#: c-api/init.rst:1073 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 " @@ -1233,7 +1233,7 @@ msgid "" "acquired it." msgstr "" -#: c-api/init.rst:1082 +#: c-api/init.rst:1081 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 " @@ -1241,7 +1241,7 @@ msgid "" "ensues." msgstr "" -#: c-api/init.rst:1134 c-api/init.rst:1416 +#: c-api/init.rst:1133 c-api/init.rst:1415 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 " @@ -1250,27 +1250,27 @@ msgid "" "avoid unwanted termination." msgstr "" -#: c-api/init.rst:1096 +#: c-api/init.rst:1095 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:1103 +#: c-api/init.rst:1102 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:1108 +#: c-api/init.rst:1107 msgid "" "The following functions use thread-local storage, and are not compatible " "with sub-interpreters:" msgstr "" -#: c-api/init.rst:1113 +#: c-api/init.rst:1112 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 " @@ -1283,7 +1283,7 @@ msgid "" "is acceptable." msgstr "" -#: c-api/init.rst:1123 +#: c-api/init.rst:1122 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:" @@ -1293,13 +1293,13 @@ msgid "" "func:`PyGILState_Release`." msgstr "" -#: c-api/init.rst:1130 +#: c-api/init.rst:1129 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:1142 +#: c-api/init.rst:1141 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:" @@ -1307,13 +1307,13 @@ msgid "" "caller, hence the use of the GILState API)." msgstr "" -#: c-api/init.rst:1147 +#: c-api/init.rst:1146 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:1153 +#: c-api/init.rst:1152 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 " @@ -1321,7 +1321,7 @@ msgid "" "made on the main thread. This is mainly a helper/diagnostic function." msgstr "" -#: c-api/init.rst:1161 +#: c-api/init.rst:1160 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 " @@ -1332,13 +1332,13 @@ msgid "" "otherwise behave differently." msgstr "" -#: c-api/init.rst:1173 +#: c-api/init.rst:1172 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:1179 +#: c-api/init.rst:1178 msgid "" "This macro expands to ``{ PyThreadState *_save; _save = PyEval_SaveThread();" "``. Note that it contains an opening brace; it must be matched with a " @@ -1346,7 +1346,7 @@ msgid "" "discussion of this macro." msgstr "" -#: c-api/init.rst:1187 +#: c-api/init.rst:1186 msgid "" "This macro expands to ``PyEval_RestoreThread(_save); }``. Note that it " "contains a closing brace; it must be matched with an earlier :c:macro:" @@ -1354,91 +1354,91 @@ msgid "" "macro." msgstr "" -#: c-api/init.rst:1195 +#: c-api/init.rst:1194 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:1201 +#: c-api/init.rst:1200 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:1207 +#: c-api/init.rst:1206 msgid "Low-level API" msgstr "" -#: c-api/init.rst:1209 +#: c-api/init.rst:1208 msgid "" "All of the following functions must be called after :c:func:`Py_Initialize`." msgstr "" -#: c-api/init.rst:1211 +#: c-api/init.rst:1210 msgid ":c:func:`Py_Initialize()` now initializes the :term:`GIL`." msgstr "" -#: c-api/init.rst:1217 +#: c-api/init.rst:1216 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:1221 +#: c-api/init.rst:1220 msgid "" "Raises an :ref:`auditing event ` ``cpython." "PyInterpreterState_New`` with no arguments." msgstr "" -#: c-api/init.rst:1226 +#: c-api/init.rst:1225 msgid "" "Reset all information in an interpreter state object. The global " "interpreter lock must be held." msgstr "" -#: c-api/init.rst:1229 +#: c-api/init.rst:1228 msgid "" "Raises an :ref:`auditing event ` ``cpython." "PyInterpreterState_Clear`` with no arguments." msgstr "" -#: c-api/init.rst:1234 +#: c-api/init.rst:1233 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:1241 +#: c-api/init.rst:1240 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:1248 +#: c-api/init.rst:1247 msgid "" "Reset all information in a thread state object. The global interpreter lock " "must be held." msgstr "" -#: c-api/init.rst:1251 +#: c-api/init.rst:1250 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:1258 +#: c-api/init.rst:1257 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:1265 +#: c-api/init.rst:1264 msgid "" "Destroy the current thread state and release the global interpreter lock. " "Like :c:func:`PyThreadState_Delete`, the global interpreter lock need not be " @@ -1446,118 +1446,118 @@ msgid "" "`PyThreadState_Clear`." msgstr "" -#: c-api/init.rst:1273 +#: c-api/init.rst:1272 msgid "Get the current frame of the Python thread state *tstate*." msgstr "" -#: c-api/init.rst:1275 +#: c-api/init.rst:1274 msgid "" "Return a :term:`strong reference`. Return ``NULL`` if no frame is currently " "executing." msgstr "" -#: c-api/init.rst:1278 +#: c-api/init.rst:1277 msgid "See also :c:func:`PyEval_GetFrame`." msgstr "" -#: c-api/init.rst:1289 c-api/init.rst:1298 +#: c-api/init.rst:1288 c-api/init.rst:1297 msgid "*tstate* must not be ``NULL``." msgstr "" -#: c-api/init.rst:1287 +#: c-api/init.rst:1286 msgid "" "Get the unique thread state identifier of the Python thread state *tstate*." msgstr "" -#: c-api/init.rst:1296 +#: c-api/init.rst:1295 msgid "Get the interpreter of the Python thread state *tstate*." msgstr "" -#: c-api/init.rst:1305 +#: c-api/init.rst:1304 msgid "Suspend tracing and profiling in the Python thread state *tstate*." msgstr "" -#: c-api/init.rst:1307 +#: c-api/init.rst:1306 msgid "Resume them using the :c:func:`PyThreadState_LeaveTracing` function." msgstr "" -#: c-api/init.rst:1314 +#: c-api/init.rst:1313 msgid "" "Resume tracing and profiling in the Python thread state *tstate* suspended " "by the :c:func:`PyThreadState_EnterTracing` function." msgstr "" -#: c-api/init.rst:1317 +#: c-api/init.rst:1316 msgid "" "See also :c:func:`PyEval_SetTrace` and :c:func:`PyEval_SetProfile` functions." msgstr "" -#: c-api/init.rst:1325 +#: c-api/init.rst:1324 msgid "Get the current interpreter." msgstr "" -#: c-api/init.rst:1327 +#: c-api/init.rst:1326 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:1340 +#: c-api/init.rst:1339 msgid "The caller must hold the GIL." msgstr "" -#: c-api/init.rst:1337 +#: c-api/init.rst:1336 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:1347 +#: c-api/init.rst:1346 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:1351 +#: c-api/init.rst:1350 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:1358 +#: c-api/init.rst:1357 msgid "Type of a frame evaluation function." msgstr "" -#: c-api/init.rst:1360 +#: c-api/init.rst:1359 msgid "" "The *throwflag* parameter is used by the ``throw()`` method of generators: " "if non-zero, handle the current exception." msgstr "" -#: c-api/init.rst:1363 +#: c-api/init.rst:1362 msgid "The function now takes a *tstate* parameter." msgstr "" -#: c-api/init.rst:1366 +#: c-api/init.rst:1365 msgid "" "The *frame* parameter changed from ``PyFrameObject*`` to " "``_PyInterpreterFrame*``." msgstr "" -#: c-api/init.rst:1371 +#: c-api/init.rst:1370 msgid "Get the frame evaluation function." msgstr "" -#: c-api/init.rst:1381 +#: c-api/init.rst:1380 msgid "See the :pep:`523` \"Adding a frame evaluation API to CPython\"." msgstr "" -#: c-api/init.rst:1379 +#: c-api/init.rst:1378 msgid "Set the frame evaluation function." msgstr "" -#: c-api/init.rst:1388 +#: c-api/init.rst:1387 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 " @@ -1566,7 +1566,7 @@ msgid "" "raised and the caller should assume no current thread state is available." msgstr "" -#: c-api/init.rst:1397 +#: c-api/init.rst:1396 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. " @@ -1578,33 +1578,33 @@ msgid "" "raises no exceptions." msgstr "" -#: c-api/init.rst:1405 +#: c-api/init.rst:1404 msgid "" "The type of the *id* parameter changed from :c:expr:`long` to :c:expr:" "`unsigned long`." msgstr "" -#: c-api/init.rst:1411 +#: c-api/init.rst:1410 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:1460 +#: c-api/init.rst:1459 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:1427 +#: c-api/init.rst:1426 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:1433 +#: c-api/init.rst:1432 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 " @@ -1613,25 +1613,25 @@ msgid "" "isn't, a fatal error is reported." msgstr "" -#: c-api/init.rst:1439 +#: c-api/init.rst:1438 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:1445 +#: c-api/init.rst:1444 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:1448 +#: c-api/init.rst:1447 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:1454 +#: c-api/init.rst:1453 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 " @@ -1640,23 +1640,23 @@ msgid "" "avoid unwanted termination." msgstr "" -#: c-api/init.rst:1468 +#: c-api/init.rst:1467 msgid "" "Release the global interpreter lock. The lock must have been created " "earlier." msgstr "" -#: c-api/init.rst:1470 +#: c-api/init.rst:1469 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:1479 +#: c-api/init.rst:1478 msgid "Sub-interpreter support" msgstr "" -#: c-api/init.rst:1481 +#: c-api/init.rst:1480 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 " @@ -1664,7 +1664,7 @@ msgid "" "to do that." msgstr "" -#: c-api/init.rst:1486 +#: c-api/init.rst:1485 msgid "" "The \"main\" interpreter is the first one created when the runtime " "initializes. It is usually the only Python interpreter in a process. Unlike " @@ -1675,31 +1675,31 @@ msgid "" "returns a pointer to its state." msgstr "" -#: c-api/init.rst:1493 +#: c-api/init.rst:1492 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:1499 +#: c-api/init.rst:1498 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:1505 +#: c-api/init.rst:1504 msgid "Structure fields:" msgstr "" -#: c-api/init.rst:1509 +#: c-api/init.rst:1508 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:1513 +#: c-api/init.rst:1512 msgid "" "If this is ``0`` then :c:member:`~PyInterpreterConfig." "check_multi_interp_extensions` must be ``1`` (non-zero). If this is ``1`` " @@ -1707,44 +1707,44 @@ msgid "" "`PyInterpreterConfig_OWN_GIL`." msgstr "" -#: c-api/init.rst:1521 +#: c-api/init.rst:1520 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:1525 +#: c-api/init.rst:1524 msgid "" "Note that the :mod:`subprocess` module still works when fork is disallowed." msgstr "" -#: c-api/init.rst:1530 +#: c-api/init.rst:1529 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:1535 +#: c-api/init.rst:1534 msgid "" "Note that the :mod:`subprocess` module still works when exec is disallowed." msgstr "" -#: c-api/init.rst:1540 +#: c-api/init.rst:1539 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:1546 +#: c-api/init.rst:1545 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:1553 +#: c-api/init.rst:1552 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 " @@ -1753,37 +1753,37 @@ msgid "" "`Py_mod_multiple_interpreters`.)" msgstr "" -#: c-api/init.rst:1560 +#: c-api/init.rst:1559 msgid "" "This must be ``1`` (non-zero) if :c:member:`~PyInterpreterConfig." "use_main_obmalloc` is ``0``." msgstr "" -#: c-api/init.rst:1565 +#: c-api/init.rst:1564 msgid "" "This determines the operation of the GIL for the sub-interpreter. It may be " "one of the following:" msgstr "" -#: c-api/init.rst:1572 +#: c-api/init.rst:1571 msgid "Use the default selection (:c:macro:`PyInterpreterConfig_SHARED_GIL`)." msgstr "" -#: c-api/init.rst:1576 +#: c-api/init.rst:1575 msgid "Use (share) the main interpreter's GIL." msgstr "" -#: c-api/init.rst:1580 +#: c-api/init.rst:1579 msgid "Use the sub-interpreter's own GIL." msgstr "" -#: c-api/init.rst:1582 +#: c-api/init.rst:1581 msgid "" "If this is :c:macro:`PyInterpreterConfig_OWN_GIL` then :c:member:" "`PyInterpreterConfig.use_main_obmalloc` must be ``0``." msgstr "" -#: c-api/init.rst:1596 +#: c-api/init.rst:1595 msgid "" "Create a new sub-interpreter. This is an (almost) totally separate " "environment for the execution of Python code. In particular, the new " @@ -1796,13 +1796,13 @@ msgid "" "underlying file descriptors)." msgstr "" -#: c-api/init.rst:1606 +#: c-api/init.rst:1605 msgid "" "The given *config* controls the options with which the interpreter is " "initialized." msgstr "" -#: c-api/init.rst:1609 +#: c-api/init.rst:1608 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 " @@ -1813,7 +1813,7 @@ msgid "" "state." msgstr "" -#: c-api/init.rst:1618 +#: c-api/init.rst:1617 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. " @@ -1825,13 +1825,13 @@ msgid "" "released here." msgstr "" -#: c-api/init.rst:1629 +#: c-api/init.rst:1628 msgid "" "Sub-interpreters are most effective when isolated from each other, with " "certain functionality restricted::" msgstr "" -#: c-api/init.rst:1643 +#: c-api/init.rst:1642 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:" @@ -1839,11 +1839,11 @@ msgid "" "internally on the :c:type:`PyInterpreterState`." msgstr "" -#: c-api/init.rst:1652 +#: c-api/init.rst:1651 msgid "Extension modules are shared between (sub-)interpreters as follows:" msgstr "" -#: c-api/init.rst:1654 +#: c-api/init.rst:1653 msgid "" "For modules using multi-phase initialization, e.g. :c:func:" "`PyModule_FromDefAndSpec`, a separate module object is created and " @@ -1851,7 +1851,7 @@ msgid "" "are shared between these module objects." msgstr "" -#: c-api/init.rst:1660 +#: c-api/init.rst:1659 msgid "" "For modules using single-phase initialization, e.g. :c:func:" "`PyModule_Create`, the first time a particular extension is imported, it is " @@ -1863,7 +1863,7 @@ msgid "" "might cause unwanted behavior (see `Bugs and caveats`_ below)." msgstr "" -#: c-api/init.rst:1671 +#: c-api/init.rst:1670 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:" @@ -1873,7 +1873,7 @@ msgid "" "shared between these modules." msgstr "" -#: c-api/init.rst:1691 +#: c-api/init.rst:1690 msgid "" "Create a new sub-interpreter. This is essentially just a wrapper around :c:" "func:`Py_NewInterpreterFromConfig` with a config that preserves the existing " @@ -1882,7 +1882,7 @@ msgid "" "single-phase init modules." msgstr "" -#: c-api/init.rst:1703 +#: c-api/init.rst:1702 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 " @@ -1892,17 +1892,17 @@ msgid "" "be held before calling this function. No GIL is held when it returns." msgstr "" -#: c-api/init.rst:1711 +#: c-api/init.rst:1710 msgid "" ":c:func:`Py_FinalizeEx` will destroy all sub-interpreters that haven't been " "explicitly destroyed at that point." msgstr "" -#: c-api/init.rst:1716 +#: c-api/init.rst:1715 msgid "A Per-Interpreter GIL" msgstr "" -#: c-api/init.rst:1718 +#: c-api/init.rst:1717 msgid "" "Using :c:func:`Py_NewInterpreterFromConfig` you can create a sub-interpreter " "that is completely isolated from other interpreters, including having its " @@ -1914,7 +1914,7 @@ msgid "" "just using threads. (See :pep:`554`.)" msgstr "" -#: c-api/init.rst:1728 +#: c-api/init.rst:1727 msgid "" "Using an isolated interpreter requires vigilance in preserving that " "isolation. That especially means not sharing any objects or mutable state " @@ -1928,7 +1928,7 @@ msgid "" "builtin objects." msgstr "" -#: c-api/init.rst:1739 +#: c-api/init.rst:1738 msgid "" "If you preserve isolation then you will have access to proper multi-core " "computing without the complications that come with free-threading. Failure " @@ -1936,7 +1936,7 @@ msgid "" "threading, including races and hard-to-debug crashes." msgstr "" -#: c-api/init.rst:1744 +#: c-api/init.rst:1743 msgid "" "Aside from that, one of the main challenges of using multiple isolated " "interpreters is how to communicate between them safely (not break isolation) " @@ -1946,11 +1946,11 @@ msgid "" "sharing) data between interpreters." msgstr "" -#: c-api/init.rst:1755 +#: c-api/init.rst:1754 msgid "Bugs and caveats" msgstr "" -#: c-api/init.rst:1757 +#: c-api/init.rst:1756 msgid "" "Because sub-interpreters (and the main interpreter) are part of the same " "process, the insulation between them isn't perfect --- for example, using " @@ -1963,7 +1963,7 @@ msgid "" "should be avoided if possible." msgstr "" -#: c-api/init.rst:1767 +#: c-api/init.rst:1766 msgid "" "Special care should be taken to avoid sharing user-defined functions, " "methods, instances or classes between sub-interpreters, since import " @@ -1972,7 +1972,7 @@ msgid "" "objects from which the above are reachable." msgstr "" -#: c-api/init.rst:1773 +#: c-api/init.rst:1772 msgid "" "Also note that combining this functionality with ``PyGILState_*`` APIs is " "delicate, because these APIs assume a bijection between Python thread states " @@ -1984,25 +1984,25 @@ msgid "" "created threads will probably be broken when using sub-interpreters." msgstr "" -#: c-api/init.rst:1784 +#: c-api/init.rst:1783 msgid "Asynchronous Notifications" msgstr "" -#: c-api/init.rst:1786 +#: c-api/init.rst:1785 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:1795 +#: c-api/init.rst:1792 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:1799 +#: c-api/init.rst:1796 msgid "" "When successfully queued, *func* will be *eventually* called from the main " "interpreter thread with the argument *arg*. It will be called " @@ -2010,17 +2010,17 @@ msgid "" "these conditions met:" msgstr "" -#: c-api/init.rst:1804 +#: c-api/init.rst:1801 msgid "on a :term:`bytecode` boundary;" msgstr "" -#: c-api/init.rst:1805 +#: c-api/init.rst:1802 msgid "" "with the main thread holding the :term:`global interpreter lock` (*func* can " "therefore use the full C API)." msgstr "" -#: c-api/init.rst:1808 +#: c-api/init.rst:1805 msgid "" "*func* must return ``0`` on success, or ``-1`` on failure with an exception " "set. *func* won't be interrupted to perform another asynchronous " @@ -2028,20 +2028,20 @@ msgid "" "if the global interpreter lock is released." msgstr "" -#: c-api/init.rst:1813 +#: c-api/init.rst:1810 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:1816 +#: c-api/init.rst:1813 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:1821 +#: c-api/init.rst:1818 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 " @@ -2051,7 +2051,7 @@ msgid "" "`PyGILState API`." msgstr "" -#: c-api/init.rst:1828 +#: c-api/init.rst:1825 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 " @@ -2059,18 +2059,18 @@ msgid "" "scheduled calls." msgstr "" -#: c-api/init.rst:1839 +#: c-api/init.rst:1836 msgid "Profiling and Tracing" msgstr "" -#: c-api/init.rst:1844 +#: c-api/init.rst:1841 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:1848 +#: c-api/init.rst:1845 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 " @@ -2080,7 +2080,7 @@ msgid "" "reported to the Python-level trace functions in previous versions." msgstr "" -#: c-api/init.rst:1858 +#: c-api/init.rst:1855 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 " @@ -2092,64 +2092,64 @@ msgid "" "value of *what*:" msgstr "" -#: c-api/init.rst:1867 +#: c-api/init.rst:1864 msgid "Value of *what*" msgstr "" -#: c-api/init.rst:1867 +#: c-api/init.rst:1864 msgid "Meaning of *arg*" msgstr "" -#: c-api/init.rst:1869 +#: c-api/init.rst:1866 msgid ":c:data:`PyTrace_CALL`" msgstr "" -#: c-api/init.rst:1874 c-api/init.rst:1885 +#: c-api/init.rst:1871 c-api/init.rst:1882 msgid "Always :c:data:`Py_None`." msgstr "" -#: c-api/init.rst:1871 +#: c-api/init.rst:1868 msgid ":c:data:`PyTrace_EXCEPTION`" msgstr "" -#: c-api/init.rst:1871 +#: c-api/init.rst:1868 msgid "Exception information as returned by :func:`sys.exc_info`." msgstr "" -#: c-api/init.rst:1874 +#: c-api/init.rst:1871 msgid ":c:data:`PyTrace_LINE`" msgstr "" -#: c-api/init.rst:1876 +#: c-api/init.rst:1873 msgid ":c:data:`PyTrace_RETURN`" msgstr "" -#: c-api/init.rst:1876 +#: c-api/init.rst:1873 msgid "" "Value being returned to the caller, or ``NULL`` if caused by an exception." msgstr "" -#: c-api/init.rst:1879 +#: c-api/init.rst:1876 msgid ":c:data:`PyTrace_C_CALL`" msgstr "" -#: c-api/init.rst:1881 c-api/init.rst:1883 +#: c-api/init.rst:1878 c-api/init.rst:1880 msgid "Function object being called." msgstr "" -#: c-api/init.rst:1881 +#: c-api/init.rst:1878 msgid ":c:data:`PyTrace_C_EXCEPTION`" msgstr "" -#: c-api/init.rst:1883 +#: c-api/init.rst:1880 msgid ":c:data:`PyTrace_C_RETURN`" msgstr "" -#: c-api/init.rst:1885 +#: c-api/init.rst:1882 msgid ":c:data:`PyTrace_OPCODE`" msgstr "" -#: c-api/init.rst:1890 +#: c-api/init.rst:1887 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 " @@ -2158,7 +2158,7 @@ msgid "" "the corresponding frame." msgstr "" -#: c-api/init.rst:1899 +#: c-api/init.rst:1896 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 " @@ -2170,7 +2170,7 @@ msgid "" "profiler." msgstr "" -#: c-api/init.rst:1910 +#: c-api/init.rst:1907 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 " @@ -2178,31 +2178,31 @@ msgid "" "f_trace_lines` to *0* on that frame." msgstr "" -#: c-api/init.rst:1918 +#: c-api/init.rst:1915 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:1924 +#: c-api/init.rst:1921 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:1930 +#: c-api/init.rst:1927 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:1936 +#: c-api/init.rst:1933 msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when " "a C function has returned." msgstr "" -#: c-api/init.rst:1942 +#: c-api/init.rst:1939 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 " @@ -2210,7 +2210,7 @@ msgid "" "attr:`~frame.f_trace_opcodes` to *1* on the frame." msgstr "" -#: c-api/init.rst:1950 +#: c-api/init.rst:1947 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``. " @@ -2220,28 +2220,28 @@ msgid "" "`PyTrace_LINE` :c:data:`PyTrace_OPCODE` and :c:data:`PyTrace_EXCEPTION`." msgstr "" -#: c-api/init.rst:1957 +#: c-api/init.rst:1954 msgid "See also the :func:`sys.setprofile` function." msgstr "" -#: c-api/init.rst:1966 c-api/init.rst:1992 +#: c-api/init.rst:1963 c-api/init.rst:1989 msgid "The caller must hold the :term:`GIL`." msgstr "" -#: c-api/init.rst:1963 +#: c-api/init.rst:1960 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:1968 +#: c-api/init.rst:1965 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:1976 +#: c-api/init.rst:1973 msgid "" "Set the tracing function to *func*. This is similar to :c:func:" "`PyEval_SetProfile`, except the tracing function does receive line-number " @@ -2252,65 +2252,65 @@ msgid "" "*what* parameter." msgstr "" -#: c-api/init.rst:1983 +#: c-api/init.rst:1980 msgid "See also the :func:`sys.settrace` function." msgstr "" -#: c-api/init.rst:1989 +#: c-api/init.rst:1986 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:1994 +#: c-api/init.rst:1991 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:2003 +#: c-api/init.rst:2000 msgid "Advanced Debugger Support" msgstr "" -#: c-api/init.rst:2008 +#: c-api/init.rst:2005 msgid "" "These functions are only intended to be used by advanced debugging tools." msgstr "" -#: c-api/init.rst:2013 +#: c-api/init.rst:2010 msgid "" "Return the interpreter state object at the head of the list of all such " "objects." msgstr "" -#: c-api/init.rst:2018 +#: c-api/init.rst:2015 msgid "Return the main interpreter state object." msgstr "" -#: c-api/init.rst:2023 +#: c-api/init.rst:2020 msgid "" "Return the next interpreter state object after *interp* from the list of all " "such objects." msgstr "" -#: c-api/init.rst:2029 +#: c-api/init.rst:2026 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:2035 +#: c-api/init.rst:2032 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:2042 +#: c-api/init.rst:2039 msgid "Thread Local Storage Support" msgstr "" -#: c-api/init.rst:2046 +#: c-api/init.rst:2043 msgid "" "The Python interpreter provides low-level support for thread-local storage " "(TLS) which wraps the underlying native TLS implementation to support the " @@ -2320,19 +2320,19 @@ msgid "" "thread." msgstr "" -#: c-api/init.rst:2053 +#: c-api/init.rst:2050 msgid "" "The GIL does *not* need to be held when calling these functions; they supply " "their own locking." msgstr "" -#: c-api/init.rst:2056 +#: c-api/init.rst:2053 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:2060 +#: c-api/init.rst:2057 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 " @@ -2340,22 +2340,22 @@ msgid "" "don't do refcount operations on them either." msgstr "" -#: c-api/init.rst:2068 +#: c-api/init.rst:2065 msgid "Thread Specific Storage (TSS) API" msgstr "" -#: c-api/init.rst:2070 +#: c-api/init.rst:2067 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:2076 +#: c-api/init.rst:2073 msgid "\"A New C-API for Thread-Local Storage in CPython\" (:pep:`539`)" msgstr "" -#: c-api/init.rst:2081 +#: c-api/init.rst:2078 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 " @@ -2363,52 +2363,52 @@ msgid "" "public members in this structure." msgstr "" -#: c-api/init.rst:2086 +#: c-api/init.rst:2083 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:2092 +#: c-api/init.rst:2089 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:2097 +#: c-api/init.rst:2094 msgid "Dynamic Allocation" msgstr "" -#: c-api/init.rst:2099 +#: c-api/init.rst:2096 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:2106 +#: c-api/init.rst:2103 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:2113 +#: c-api/init.rst:2110 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:2119 +#: c-api/init.rst:2116 msgid "" "A freed key becomes a dangling pointer. You should reset the key to ``NULL``." msgstr "" -#: c-api/init.rst:2124 +#: c-api/init.rst:2121 msgid "Methods" msgstr "" -#: c-api/init.rst:2126 +#: c-api/init.rst:2123 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 " @@ -2416,13 +2416,13 @@ msgid "" "func:`PyThread_tss_create`." msgstr "" -#: c-api/init.rst:2134 +#: c-api/init.rst:2131 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:2140 +#: c-api/init.rst:2137 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 " @@ -2431,7 +2431,7 @@ msgid "" "no-op and immediately returns success." msgstr "" -#: c-api/init.rst:2149 +#: c-api/init.rst:2146 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 " @@ -2440,31 +2440,31 @@ msgid "" "key -- calling it on an already destroyed key is a no-op." msgstr "" -#: c-api/init.rst:2158 +#: c-api/init.rst:2155 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:2165 +#: c-api/init.rst:2162 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:2173 +#: c-api/init.rst:2170 msgid "Thread Local Storage (TLS) API" msgstr "" -#: c-api/init.rst:2175 +#: c-api/init.rst:2172 msgid "" "This API is superseded by :ref:`Thread Specific Storage (TSS) API `." msgstr "" -#: c-api/init.rst:2180 +#: c-api/init.rst:2177 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 " @@ -2473,7 +2473,7 @@ msgid "" "platforms." msgstr "" -#: c-api/init.rst:2185 +#: c-api/init.rst:2182 msgid "" "Due to the compatibility problem noted above, this version of the API should " "not be used in new code." @@ -2495,19 +2495,19 @@ msgstr "" msgid "path (in module sys)" msgstr "" -#: c-api/init.rst:589 c-api/init.rst:1057 c-api/init.rst:1683 +#: c-api/init.rst:589 c-api/init.rst:1056 c-api/init.rst:1682 msgid "module" msgstr "" -#: c-api/init.rst:1588 c-api/init.rst:1683 +#: c-api/init.rst:1587 c-api/init.rst:1682 msgid "builtins" msgstr "" -#: c-api/init.rst:1588 c-api/init.rst:1683 +#: c-api/init.rst:1587 c-api/init.rst:1682 msgid "__main__" msgstr "" -#: c-api/init.rst:1588 c-api/init.rst:1683 +#: c-api/init.rst:1587 c-api/init.rst:1682 msgid "sys" msgstr "" @@ -2520,18 +2520,18 @@ msgid "path" msgstr "" #: c-api/init.rst:334 -msgid "PySys_SetArgv()" +msgid "PySys_SetArgv (C function)" msgstr "" #: c-api/init.rst:334 -msgid "PySys_SetArgvEx()" +msgid "PySys_SetArgvEx (C function)" msgstr "" -#: c-api/init.rst:1648 c-api/init.rst:1701 -msgid "Py_FinalizeEx()" +#: c-api/init.rst:1647 c-api/init.rst:1700 +msgid "Py_FinalizeEx (C function)" msgstr "" -#: c-api/init.rst:467 c-api/init.rst:1648 +#: c-api/init.rst:467 msgid "Py_Initialize()" msgstr "" @@ -2596,57 +2596,65 @@ msgid "lock, interpreter" msgstr "" #: c-api/init.rst:852 -msgid "setswitchinterval() (in module sys)" +msgid "setswitchinterval (in module sys)" msgstr "" #: c-api/init.rst:861 -msgid "PyThreadState" +msgid "PyThreadState (C type)" msgstr "" -#: c-api/init.rst:888 -msgid "Py_BEGIN_ALLOW_THREADS" +#: c-api/init.rst:887 +msgid "Py_BEGIN_ALLOW_THREADS (C macro)" msgstr "" -#: c-api/init.rst:888 -msgid "Py_END_ALLOW_THREADS" +#: c-api/init.rst:887 +msgid "Py_END_ALLOW_THREADS (C macro)" msgstr "" -#: c-api/init.rst:1035 -msgid "PyEval_RestoreThread()" +#: c-api/init.rst:903 +msgid "PyEval_RestoreThread (C function)" msgstr "" -#: c-api/init.rst:1035 -msgid "PyEval_SaveThread()" +#: c-api/init.rst:903 +msgid "PyEval_SaveThread (C function)" msgstr "" -#: c-api/init.rst:1035 +#: c-api/init.rst:1034 msgid "PyEval_AcquireThread()" msgstr "" -#: c-api/init.rst:1035 +#: c-api/init.rst:1034 msgid "PyEval_ReleaseThread()" msgstr "" -#: c-api/init.rst:1057 +#: c-api/init.rst:1034 +msgid "PyEval_SaveThread()" +msgstr "" + +#: c-api/init.rst:1034 +msgid "PyEval_RestoreThread()" +msgstr "" + +#: c-api/init.rst:1056 msgid "_thread" msgstr "" -#: c-api/init.rst:1683 +#: c-api/init.rst:1682 msgid "stdout (in module sys)" msgstr "" -#: c-api/init.rst:1683 +#: c-api/init.rst:1682 msgid "stderr (in module sys)" msgstr "" -#: c-api/init.rst:1683 +#: c-api/init.rst:1682 msgid "stdin (in module sys)" msgstr "" -#: c-api/init.rst:1678 -msgid "close() (in module os)" +#: c-api/init.rst:1647 +msgid "Py_Initialize (C function)" msgstr "" -#: c-api/init.rst:1793 -msgid "Py_AddPendingCall()" +#: c-api/init.rst:1677 +msgid "close (in module os)" msgstr "" diff --git a/c-api/intro.po b/c-api/intro.po index 5ce9f0309..9d8431e2d 100644 --- a/c-api/intro.po +++ b/c-api/intro.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-10-01 00:18+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -193,8 +193,9 @@ msgstr "" #: c-api/intro.rst:151 msgid "" -"If Python is :ref:`built in debug mode ` (if the ``Py_DEBUG`` " -"macro is defined), the :c:macro:`Py_ALWAYS_INLINE` macro does nothing." +"If Python is :ref:`built in debug mode ` (if the :c:macro:" +"`Py_DEBUG` macro is defined), the :c:macro:`Py_ALWAYS_INLINE` macro does " +"nothing." msgstr "" #: c-api/intro.rst:154 @@ -762,24 +763,24 @@ msgid "" "section." msgstr "" -#: c-api/intro.rst:815 +#: c-api/intro.rst:817 msgid "" -"Compiling the interpreter with the :c:macro:`Py_DEBUG` macro defined " +"Compiling the interpreter with the :c:macro:`!Py_DEBUG` macro defined " "produces what is generally meant by :ref:`a debug build of Python `. :c:macro:`Py_DEBUG` is enabled in the Unix build by adding :option:" +"build>`. :c:macro:`!Py_DEBUG` is enabled in the Unix build by adding :option:" "`--with-pydebug` to the :file:`./configure` command. It is also implied by " -"the presence of the not-Python-specific :c:macro:`_DEBUG` macro. When :c:" -"macro:`Py_DEBUG` is enabled in the Unix build, compiler optimization is " +"the presence of the not-Python-specific :c:macro:`!_DEBUG` macro. When :c:" +"macro:`!Py_DEBUG` is enabled in the Unix build, compiler optimization is " "disabled." msgstr "" -#: c-api/intro.rst:823 +#: c-api/intro.rst:825 msgid "" "In addition to the reference count debugging described below, extra checks " "are performed, see :ref:`Python Debug Build `." msgstr "" -#: c-api/intro.rst:826 +#: c-api/intro.rst:828 msgid "" "Defining :c:macro:`Py_TRACE_REFS` enables reference tracing (see the :option:" "`configure --with-trace-refs option <--with-trace-refs>`). When defined, a " @@ -789,7 +790,7 @@ msgid "" "this happens after every statement run by the interpreter.)" msgstr "" -#: c-api/intro.rst:833 +#: c-api/intro.rst:835 msgid "" "Please refer to :file:`Misc/SpecialBuilds.txt` in the Python source " "distribution for more detailed information." @@ -804,19 +805,19 @@ msgid "type" msgstr "" #: c-api/intro.rst:327 -msgid "Py_INCREF()" +msgid "Py_INCREF (C function)" msgstr "" #: c-api/intro.rst:327 -msgid "Py_DECREF()" +msgid "Py_DECREF (C function)" msgstr "" #: c-api/intro.rst:403 -msgid "PyList_SetItem()" +msgid "PyList_SetItem (C function)" msgstr "" #: c-api/intro.rst:403 -msgid "PyTuple_SetItem()" +msgid "PyTuple_SetItem (C function)" msgstr "" #: c-api/intro.rst:474 @@ -824,11 +825,11 @@ msgid "set_all()" msgstr "" #: c-api/intro.rst:493 -msgid "PyList_GetItem()" +msgid "PyList_GetItem (C function)" msgstr "" #: c-api/intro.rst:493 -msgid "PySequence_GetItem()" +msgid "PySequence_GetItem (C function)" msgstr "" #: c-api/intro.rst:523 @@ -840,19 +841,19 @@ msgid "sum_sequence()" msgstr "" #: c-api/intro.rst:590 -msgid "PyErr_Occurred()" +msgid "PyErr_Occurred (C function)" msgstr "" #: c-api/intro.rst:603 -msgid "PyErr_SetString()" +msgid "PyErr_SetString (C function)" msgstr "" #: c-api/intro.rst:711 -msgid "PyErr_Clear()" +msgid "PyErr_Clear (C function)" msgstr "" #: c-api/intro.rst:627 -msgid "exc_info() (in module sys)" +msgid "exc_info (in module sys)" msgstr "" #: c-api/intro.rst:709 @@ -860,15 +861,15 @@ msgid "incr_item()" msgstr "" #: c-api/intro.rst:711 -msgid "PyErr_ExceptionMatches()" +msgid "PyErr_ExceptionMatches (C function)" msgstr "" #: c-api/intro.rst:711 -msgid "Py_XDECREF()" +msgid "Py_XDECREF (C function)" msgstr "" #: c-api/intro.rst:737 -msgid "Py_Initialize()" +msgid "Py_Initialize (C function)" msgstr "" #: c-api/intro.rst:737 @@ -900,25 +901,25 @@ msgid "path (in module sys)" msgstr "" #: c-api/intro.rst:772 -msgid "Py_SetProgramName()" +msgid "Py_SetProgramName (C function)" msgstr "" #: c-api/intro.rst:772 -msgid "Py_GetPath()" +msgid "Py_GetPath (C function)" msgstr "" #: c-api/intro.rst:772 -msgid "Py_GetPrefix()" +msgid "Py_GetPrefix (C function)" msgstr "" #: c-api/intro.rst:772 -msgid "Py_GetExecPrefix()" +msgid "Py_GetExecPrefix (C function)" msgstr "" #: c-api/intro.rst:772 -msgid "Py_GetProgramFullPath()" +msgid "Py_GetProgramFullPath (C function)" msgstr "" #: c-api/intro.rst:787 -msgid "Py_IsInitialized()" +msgid "Py_IsInitialized (C function)" msgstr "" diff --git a/c-api/long.po b/c-api/long.po index 43e992dde..132b2cdff 100644 --- a/c-api/long.po +++ b/c-api/long.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -375,7 +375,7 @@ msgid "integer" msgstr "" #: c-api/long.rst:119 -msgid "LONG_MAX" +msgid "LONG_MAX (C macro)" msgstr "" #: c-api/long.rst:161 c-api/long.rst:219 c-api/long.rst:251 @@ -383,13 +383,13 @@ msgid "OverflowError (built-in exception)" msgstr "" #: c-api/long.rst:204 -msgid "PY_SSIZE_T_MAX" +msgid "PY_SSIZE_T_MAX (C macro)" msgstr "" #: c-api/long.rst:219 -msgid "ULONG_MAX" +msgid "ULONG_MAX (C macro)" msgstr "" #: c-api/long.rst:235 -msgid "SIZE_MAX" +msgid "SIZE_MAX (C macro)" msgstr "" diff --git a/c-api/memory.po b/c-api/memory.po index 9f63a3b00..f91b276bc 100644 --- a/c-api/memory.po +++ b/c-api/memory.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -322,16 +322,16 @@ msgstr "" #: c-api/memory.rst:269 msgid "" "Same as :c:func:`PyMem_Malloc`, but allocates ``(n * sizeof(TYPE))`` bytes " -"of memory. Returns a pointer cast to :c:expr:`TYPE*`. The memory will not " -"have been initialized in any way." +"of memory. Returns a pointer cast to ``TYPE*``. The memory will not have " +"been initialized in any way." msgstr "" #: c-api/memory.rst:276 msgid "" "Same as :c:func:`PyMem_Realloc`, but the memory block is resized to ``(n * " -"sizeof(TYPE))`` bytes. Returns a pointer cast to :c:expr:`TYPE*`. On " -"return, *p* will be a pointer to the new memory area, or ``NULL`` in the " -"event of failure." +"sizeof(TYPE))`` bytes. Returns a pointer cast to ``TYPE*``. On return, *p* " +"will be a pointer to the new memory area, or ``NULL`` in the event of " +"failure." msgstr "" #: c-api/memory.rst:281 @@ -1066,17 +1066,17 @@ msgid "" msgstr "" #: c-api/memory.rst:43 -msgid "malloc()" +msgid "malloc (C function)" msgstr "" #: c-api/memory.rst:43 -msgid "calloc()" +msgid "calloc (C function)" msgstr "" #: c-api/memory.rst:43 -msgid "realloc()" +msgid "realloc (C function)" msgstr "" #: c-api/memory.rst:43 -msgid "free()" +msgid "free (C function)" msgstr "" diff --git a/c-api/memoryview.po b/c-api/memoryview.po index c5f02dc40..dca40d931 100644 --- a/c-api/memoryview.po +++ b/c-api/memoryview.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -35,20 +35,28 @@ msgid "" "the discretion of the exporter." msgstr "" -#: c-api/memoryview.rst:25 +#: c-api/memoryview.rst:26 +msgid "Flag to request a readonly buffer." +msgstr "" + +#: c-api/memoryview.rst:31 +msgid "Flag to request a writable buffer." +msgstr "" + +#: c-api/memoryview.rst:36 msgid "" "Create a memoryview object using *mem* as the underlying buffer. *flags* can " "be one of :c:macro:`PyBUF_READ` or :c:macro:`PyBUF_WRITE`." msgstr "" -#: c-api/memoryview.rst:32 +#: c-api/memoryview.rst:43 msgid "" "Create a memoryview object wrapping the given buffer structure *view*. For " "simple byte buffers, :c:func:`PyMemoryView_FromMemory` is the preferred " "function." msgstr "" -#: c-api/memoryview.rst:38 +#: c-api/memoryview.rst:49 msgid "" "Create a memoryview object to a :term:`contiguous` chunk of memory (in " "either 'C' or 'F'ortran *order*) from an object that defines the buffer " @@ -57,21 +65,26 @@ msgid "" "new bytes object." msgstr "" -#: c-api/memoryview.rst:47 +#: c-api/memoryview.rst:55 +msgid "" +"*buffertype* can be one of :c:macro:`PyBUF_READ` or :c:macro:`PyBUF_WRITE`." +msgstr "" + +#: c-api/memoryview.rst:60 msgid "" "Return true if the object *obj* is a memoryview object. It is not currently " "allowed to create subclasses of :class:`memoryview`. This function always " "succeeds." msgstr "" -#: c-api/memoryview.rst:54 +#: c-api/memoryview.rst:67 msgid "" "Return a pointer to the memoryview's private copy of the exporter's buffer. " "*mview* **must** be a memoryview instance; this macro doesn't check its " "type, you must do it yourself or you will risk crashes." msgstr "" -#: c-api/memoryview.rst:60 +#: c-api/memoryview.rst:73 msgid "" "Return either a pointer to the exporting object that the memoryview is based " "on or ``NULL`` if the memoryview has been created by one of the functions :c:" diff --git a/c-api/object.po b/c-api/object.po index 67b481d69..14e48d2e9 100644 --- a/c-api/object.po +++ b/c-api/object.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -35,34 +35,41 @@ msgstr "" #: c-api/object.rst:24 msgid "" +"Flag to be used with multiple functions that print the object (like :c:func:" +"`PyObject_Print` and :c:func:`PyFile_WriteObject`). If passed, these " +"function would use the :func:`str` of the object instead of the :func:`repr`." +msgstr "" + +#: c-api/object.rst:32 +msgid "" "Print an object *o*, on file *fp*. Returns ``-1`` on error. The flags " "argument is used to enable certain printing options. The only option " "currently supported is :c:macro:`Py_PRINT_RAW`; if given, the :func:`str` of " "the object is written instead of the :func:`repr`." msgstr "" -#: c-api/object.rst:32 +#: c-api/object.rst:40 msgid "" "Returns ``1`` if *o* has the attribute *attr_name*, and ``0`` otherwise. " "This is equivalent to the Python expression ``hasattr(o, attr_name)``. This " "function always succeeds." msgstr "" -#: c-api/object.rst:38 +#: c-api/object.rst:46 msgid "" "Exceptions that occur when this calls :meth:`~object.__getattr__` and :meth:" "`~object.__getattribute__` methods are silently ignored. For proper error " "handling, use :c:func:`PyObject_GetAttr` instead." msgstr "" -#: c-api/object.rst:45 +#: c-api/object.rst:53 msgid "" "This is the same as :c:func:`PyObject_HasAttr`, but *attr_name* is specified " "as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" "`PyObject*`." msgstr "" -#: c-api/object.rst:51 +#: c-api/object.rst:59 msgid "" "Exceptions that occur when this calls :meth:`~object.__getattr__` and :meth:" "`~object.__getattribute__` methods or while creating the temporary :class:" @@ -70,21 +77,21 @@ msgid "" "`PyObject_GetAttrString` instead." msgstr "" -#: c-api/object.rst:59 +#: c-api/object.rst:67 msgid "" "Retrieve an attribute named *attr_name* from object *o*. Returns the " "attribute value on success, or ``NULL`` on failure. This is the equivalent " "of the Python expression ``o.attr_name``." msgstr "" -#: c-api/object.rst:66 +#: c-api/object.rst:74 msgid "" "This is the same as :c:func:`PyObject_GetAttr`, but *attr_name* is specified " "as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" "`PyObject*`." msgstr "" -#: c-api/object.rst:73 +#: c-api/object.rst:81 msgid "" "Generic attribute getter function that is meant to be put into a type " "object's ``tp_getattro`` slot. It looks for a descriptor in the dictionary " @@ -94,34 +101,34 @@ msgid "" "descriptors don't. Otherwise, an :exc:`AttributeError` is raised." msgstr "" -#: c-api/object.rst:83 +#: c-api/object.rst:91 msgid "" "Set the value of the attribute named *attr_name*, for object *o*, to the " "value *v*. Raise an exception and return ``-1`` on failure; return ``0`` on " "success. This is the equivalent of the Python statement ``o.attr_name = v``." msgstr "" -#: c-api/object.rst:88 +#: c-api/object.rst:96 msgid "" "If *v* is ``NULL``, the attribute is deleted. This behaviour is deprecated " "in favour of using :c:func:`PyObject_DelAttr`, but there are currently no " "plans to remove it." msgstr "" -#: c-api/object.rst:95 +#: c-api/object.rst:103 msgid "" "This is the same as :c:func:`PyObject_SetAttr`, but *attr_name* is specified " "as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" "`PyObject*`." msgstr "" -#: c-api/object.rst:99 +#: c-api/object.rst:107 msgid "" "If *v* is ``NULL``, the attribute is deleted, but this feature is deprecated " "in favour of using :c:func:`PyObject_DelAttrString`." msgstr "" -#: c-api/object.rst:105 +#: c-api/object.rst:113 msgid "" "Generic attribute setter and deleter function that is meant to be put into a " "type object's :c:member:`~PyTypeObject.tp_setattro` slot. It looks for a " @@ -133,26 +140,26 @@ msgid "" "returned." msgstr "" -#: c-api/object.rst:117 +#: c-api/object.rst:125 msgid "" "Delete attribute named *attr_name*, for object *o*. Returns ``-1`` on " "failure. This is the equivalent of the Python statement ``del o.attr_name``." msgstr "" -#: c-api/object.rst:123 +#: c-api/object.rst:131 msgid "" "This is the same as :c:func:`PyObject_DelAttr`, but *attr_name* is specified " "as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" "`PyObject*`." msgstr "" -#: c-api/object.rst:130 +#: c-api/object.rst:138 msgid "" "A generic implementation for the getter of a ``__dict__`` descriptor. It " "creates the dictionary if necessary." msgstr "" -#: c-api/object.rst:133 +#: c-api/object.rst:141 msgid "" "This function may also be called to get the :py:attr:`~object.__dict__` of " "the object *o*. Pass ``NULL`` for *context* when calling it. Since this " @@ -161,30 +168,30 @@ msgid "" "the object." msgstr "" -#: c-api/object.rst:139 +#: c-api/object.rst:147 msgid "On failure, returns ``NULL`` with an exception set." msgstr "" -#: c-api/object.rst:146 +#: c-api/object.rst:154 msgid "" "A generic implementation for the setter of a ``__dict__`` descriptor. This " "implementation does not allow the dictionary to be deleted." msgstr "" -#: c-api/object.rst:154 +#: c-api/object.rst:162 msgid "" "Return a pointer to :py:attr:`~object.__dict__` of the object *obj*. If " "there is no ``__dict__``, return ``NULL`` without setting an exception." msgstr "" -#: c-api/object.rst:157 +#: c-api/object.rst:165 msgid "" "This function may need to allocate memory for the dictionary, so it may be " "more efficient to call :c:func:`PyObject_GetAttr` when accessing an " "attribute on the object." msgstr "" -#: c-api/object.rst:164 +#: c-api/object.rst:172 msgid "" "Compare the values of *o1* and *o2* using the operation specified by *opid*, " "which must be one of :c:macro:`Py_LT`, :c:macro:`Py_LE`, :c:macro:`Py_EQ`, :" @@ -195,37 +202,33 @@ msgid "" "success, or ``NULL`` on failure." msgstr "" -#: c-api/object.rst:174 +#: c-api/object.rst:182 msgid "" "Compare the values of *o1* and *o2* using the operation specified by *opid*, " -"which must be one of :c:macro:`Py_LT`, :c:macro:`Py_LE`, :c:macro:`Py_EQ`, :" -"c:macro:`Py_NE`, :c:macro:`Py_GT`, or :c:macro:`Py_GE`, corresponding to " -"``<``, ``<=``, ``==``, ``!=``, ``>``, or ``>=`` respectively. Returns ``-1`` " -"on error, ``0`` if the result is false, ``1`` otherwise. This is the " -"equivalent of the Python expression ``o1 op o2``, where ``op`` is the " -"operator corresponding to *opid*." +"like :c:func:`PyObject_RichCompare`, but returns ``-1`` on error, ``0`` if " +"the result is false, ``1`` otherwise." msgstr "" -#: c-api/object.rst:183 +#: c-api/object.rst:187 msgid "" "If *o1* and *o2* are the same object, :c:func:`PyObject_RichCompareBool` " "will always return ``1`` for :c:macro:`Py_EQ` and ``0`` for :c:macro:`Py_NE`." msgstr "" -#: c-api/object.rst:188 +#: c-api/object.rst:192 msgid "" "Format *obj* using *format_spec*. This is equivalent to the Python " "expression ``format(obj, format_spec)``." msgstr "" -#: c-api/object.rst:191 +#: c-api/object.rst:195 msgid "" "*format_spec* may be ``NULL``. In this case the call is equivalent to " "``format(obj)``. Returns the formatted string on success, ``NULL`` on " "failure." msgstr "" -#: c-api/object.rst:199 +#: c-api/object.rst:203 msgid "" "Compute a string representation of object *o*. Returns the string " "representation on success, ``NULL`` on failure. This is the equivalent of " @@ -233,13 +236,13 @@ msgid "" "function." msgstr "" -#: c-api/object.rst:227 +#: c-api/object.rst:231 msgid "" "This function now includes a debug assertion to help ensure that it does not " "silently discard an active exception." msgstr "" -#: c-api/object.rst:211 +#: c-api/object.rst:215 msgid "" "As :c:func:`PyObject_Repr`, compute a string representation of object *o*, " "but escape the non-ASCII characters in the string returned by :c:func:" @@ -248,7 +251,7 @@ msgid "" "Called by the :func:`ascii` built-in function." msgstr "" -#: c-api/object.rst:222 +#: c-api/object.rst:226 msgid "" "Compute a string representation of object *o*. Returns the string " "representation on success, ``NULL`` on failure. This is the equivalent of " @@ -256,7 +259,7 @@ msgid "" "function and, therefore, by the :func:`print` function." msgstr "" -#: c-api/object.rst:236 +#: c-api/object.rst:240 msgid "" "Compute a bytes representation of object *o*. ``NULL`` is returned on " "failure and a bytes object on success. This is equivalent to the Python " @@ -265,20 +268,20 @@ msgid "" "bytes object." msgstr "" -#: c-api/object.rst:245 +#: c-api/object.rst:249 msgid "" "Return ``1`` if the class *derived* is identical to or derived from the " "class *cls*, otherwise return ``0``. In case of an error, return ``-1``." msgstr "" -#: c-api/object.rst:267 +#: c-api/object.rst:271 msgid "" "If *cls* is a tuple, the check will be done against every entry in *cls*. " "The result will be ``1`` when at least one of the checks returns ``1``, " "otherwise it will be ``0``." msgstr "" -#: c-api/object.rst:252 +#: c-api/object.rst:256 msgid "" "If *cls* has a :meth:`~class.__subclasscheck__` method, it will be called to " "determine the subclass status as described in :pep:`3119`. Otherwise, " @@ -286,52 +289,52 @@ msgid "" "e. contained in ``cls.__mro__``." msgstr "" -#: c-api/object.rst:257 +#: c-api/object.rst:261 msgid "" "Normally only class objects, i.e. instances of :class:`type` or a derived " "class, are considered classes. However, objects can override this by having " "a :attr:`~class.__bases__` attribute (which must be a tuple of base classes)." msgstr "" -#: c-api/object.rst:264 +#: c-api/object.rst:268 msgid "" "Return ``1`` if *inst* is an instance of the class *cls* or a subclass of " "*cls*, or ``0`` if not. On error, returns ``-1`` and sets an exception." msgstr "" -#: c-api/object.rst:271 +#: c-api/object.rst:275 msgid "" "If *cls* has a :meth:`~class.__instancecheck__` method, it will be called to " "determine the subclass status as described in :pep:`3119`. Otherwise, " "*inst* is an instance of *cls* if its class is a subclass of *cls*." msgstr "" -#: c-api/object.rst:275 +#: c-api/object.rst:279 msgid "" "An instance *inst* can override what is considered its class by having a :" "attr:`~instance.__class__` attribute." msgstr "" -#: c-api/object.rst:278 +#: c-api/object.rst:282 msgid "" "An object *cls* can override if it is considered a class, and what its base " "classes are, by having a :attr:`~class.__bases__` attribute (which must be a " "tuple of base classes)." msgstr "" -#: c-api/object.rst:287 +#: c-api/object.rst:291 msgid "" "Compute and return the hash value of an object *o*. On failure, return " "``-1``. This is the equivalent of the Python expression ``hash(o)``." msgstr "" -#: c-api/object.rst:290 +#: c-api/object.rst:294 msgid "" "The return type is now Py_hash_t. This is a signed integer the same size " "as :c:type:`Py_ssize_t`." msgstr "" -#: c-api/object.rst:297 +#: c-api/object.rst:301 msgid "" "Set a :exc:`TypeError` indicating that ``type(o)`` is not :term:`hashable` " "and return ``-1``. This function receives special treatment when stored in a " @@ -339,21 +342,21 @@ msgid "" "that it is not hashable." msgstr "" -#: c-api/object.rst:305 +#: c-api/object.rst:309 msgid "" "Returns ``1`` if the object *o* is considered to be true, and ``0`` " "otherwise. This is equivalent to the Python expression ``not not o``. On " "failure, return ``-1``." msgstr "" -#: c-api/object.rst:312 +#: c-api/object.rst:316 msgid "" "Returns ``0`` if the object *o* is considered to be true, and ``1`` " "otherwise. This is equivalent to the Python expression ``not o``. On " "failure, return ``-1``." msgstr "" -#: c-api/object.rst:321 +#: c-api/object.rst:325 msgid "" "When *o* is non-``NULL``, returns a type object corresponding to the object " "type of object *o*. On failure, raises :exc:`SystemError` and returns " @@ -364,13 +367,13 @@ msgid "" "when a new :term:`strong reference` is needed." msgstr "" -#: c-api/object.rst:333 +#: c-api/object.rst:337 msgid "" "Return non-zero if the object *o* is of type *type* or a subtype of *type*, " "and ``0`` otherwise. Both parameters must be non-``NULL``." msgstr "" -#: c-api/object.rst:342 +#: c-api/object.rst:346 msgid "" "Return the length of object *o*. If the object *o* provides either the " "sequence and mapping protocols, the sequence length is returned. On error, " @@ -378,7 +381,7 @@ msgid "" "``len(o)``." msgstr "" -#: c-api/object.rst:349 +#: c-api/object.rst:353 msgid "" "Return an estimated length for the object *o*. First try to return its " "actual length, then an estimate using :meth:`~object.__length_hint__`, and " @@ -387,26 +390,26 @@ msgid "" "defaultvalue)``." msgstr "" -#: c-api/object.rst:359 +#: c-api/object.rst:363 msgid "" "Return element of *o* corresponding to the object *key* or ``NULL`` on " "failure. This is the equivalent of the Python expression ``o[key]``." msgstr "" -#: c-api/object.rst:365 +#: c-api/object.rst:369 msgid "" "Map the object *key* to the value *v*. Raise an exception and return ``-1`` " "on failure; return ``0`` on success. This is the equivalent of the Python " "statement ``o[key] = v``. This function *does not* steal a reference to *v*." msgstr "" -#: c-api/object.rst:373 +#: c-api/object.rst:377 msgid "" "Remove the mapping for the object *key* from the object *o*. Return ``-1`` " "on failure. This is equivalent to the Python statement ``del o[key]``." msgstr "" -#: c-api/object.rst:379 +#: c-api/object.rst:383 msgid "" "This is equivalent to the Python expression ``dir(o)``, returning a " "(possibly empty) list of strings appropriate for the object argument, or " @@ -416,7 +419,7 @@ msgid "" "`PyErr_Occurred` will return false." msgstr "" -#: c-api/object.rst:388 +#: c-api/object.rst:392 msgid "" "This is equivalent to the Python expression ``iter(o)``. It returns a new " "iterator for the object argument, or the object itself if the object is " @@ -424,7 +427,7 @@ msgid "" "object cannot be iterated." msgstr "" -#: c-api/object.rst:396 +#: c-api/object.rst:400 msgid "" "This is the equivalent to the Python expression ``aiter(o)``. Takes an :" "class:`AsyncIterable` object and returns an :class:`AsyncIterator` for it. " @@ -433,88 +436,88 @@ msgid "" "``NULL`` if the object cannot be iterated." msgstr "" -#: c-api/object.rst:406 +#: c-api/object.rst:410 msgid "Get a pointer to subclass-specific data reserved for *cls*." msgstr "" -#: c-api/object.rst:408 +#: c-api/object.rst:412 msgid "" "The object *o* must be an instance of *cls*, and *cls* must have been " "created using negative :c:member:`PyType_Spec.basicsize`. Python does not " "check this." msgstr "" -#: c-api/object.rst:412 +#: c-api/object.rst:416 msgid "On error, set an exception and return ``NULL``." msgstr "" -#: c-api/object.rst:418 +#: c-api/object.rst:422 msgid "" "Return the size of the instance memory space reserved for *cls*, i.e. the " "size of the memory :c:func:`PyObject_GetTypeData` returns." msgstr "" -#: c-api/object.rst:421 +#: c-api/object.rst:425 msgid "" "This may be larger than requested using :c:member:`-PyType_Spec.basicsize " "`; it is safe to use this larger size (e.g. with :c:" "func:`!memset`)." msgstr "" -#: c-api/object.rst:424 +#: c-api/object.rst:428 msgid "" "The type *cls* **must** have been created using negative :c:member:" "`PyType_Spec.basicsize`. Python does not check this." msgstr "" -#: c-api/object.rst:428 +#: c-api/object.rst:432 msgid "On error, set an exception and return a negative value." msgstr "" -#: c-api/object.rst:434 +#: c-api/object.rst:438 msgid "" "Get a pointer to per-item data for a class with :c:macro:" "`Py_TPFLAGS_ITEMS_AT_END`." msgstr "" -#: c-api/object.rst:437 +#: c-api/object.rst:441 msgid "" "On error, set an exception and return ``NULL``. :py:exc:`TypeError` is " "raised if *o* does not have :c:macro:`Py_TPFLAGS_ITEMS_AT_END` set." msgstr "" -#: c-api/object.rst:209 c-api/object.rst:285 c-api/object.rst:340 +#: c-api/object.rst:213 c-api/object.rst:289 c-api/object.rst:344 msgid "built-in function" msgstr "" -#: c-api/object.rst:197 +#: c-api/object.rst:201 msgid "repr" msgstr "" -#: c-api/object.rst:209 +#: c-api/object.rst:213 msgid "ascii" msgstr "" -#: c-api/object.rst:217 +#: c-api/object.rst:221 msgid "string" msgstr "" -#: c-api/object.rst:217 +#: c-api/object.rst:221 msgid "PyObject_Str (C function)" msgstr "" -#: c-api/object.rst:234 +#: c-api/object.rst:238 msgid "bytes" msgstr "" -#: c-api/object.rst:285 +#: c-api/object.rst:289 msgid "hash" msgstr "" -#: c-api/object.rst:319 +#: c-api/object.rst:323 msgid "type" msgstr "" -#: c-api/object.rst:340 +#: c-api/object.rst:344 msgid "len" msgstr "" diff --git a/c-api/stable.po b/c-api/stable.po index a37007b8d..492e001d8 100644 --- a/c-api/stable.po +++ b/c-api/stable.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -34,7 +34,7 @@ msgid "" "compatible across a minor release (if these are compiled the same way; see :" "ref:`stable-abi-platform` below). So, code compiled for Python 3.10.0 will " "work on 3.10.8 and vice versa, but will need to be compiled separately for " -"3.9.x and 3.10.x." +"3.9.x and 3.11.x." msgstr "" #: c-api/stable.rst:21 diff --git a/c-api/structures.po b/c-api/structures.po index 0584c9dbb..0a55d2eb5 100644 --- a/c-api/structures.po +++ b/c-api/structures.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -405,52 +405,91 @@ msgid "" msgstr "" #: c-api/structures.rst:404 -msgid "Accessing attributes of extension types" +msgid "" +"Turn *ml* into a Python :term:`callable` object. The caller must ensure that " +"*ml* outlives the :term:`callable`. Typically, *ml* is defined as a static " +"variable." msgstr "" #: c-api/structures.rst:408 msgid "" +"The *self* parameter will be passed as the *self* argument to the C function " +"in ``ml->ml_meth`` when invoked. *self* can be ``NULL``." +msgstr "" + +#: c-api/structures.rst:412 +msgid "" +"The :term:`callable` object's ``__module__`` attribute can be set from the " +"given *module* argument. *module* should be a Python string, which will be " +"used as name of the module the function is defined in. If unavailable, it " +"can be set to :const:`None` or ``NULL``." +msgstr "" + +#: c-api/structures.rst:418 +msgid ":attr:`function.__module__`" +msgstr "" + +#: c-api/structures.rst:420 +msgid "" +"The *cls* parameter will be passed as the *defining_class* argument to the C " +"function. Must be set if :c:macro:`METH_METHOD` is set on ``ml->ml_flags``." +msgstr "" + +#: c-api/structures.rst:429 +msgid "Equivalent to ``PyCMethod_New(ml, self, module, NULL)``." +msgstr "" + +#: c-api/structures.rst:434 +msgid "Equivalent to ``PyCMethod_New(ml, self, NULL, NULL)``." +msgstr "" + +#: c-api/structures.rst:438 +msgid "Accessing attributes of extension types" +msgstr "" + +#: c-api/structures.rst:442 +msgid "" "Structure which describes an attribute of a type which corresponds to a C " "struct member. When defining a class, put a NULL-terminated array of these " "structures in the :c:member:`~PyTypeObject.tp_members` slot." msgstr "" -#: c-api/structures.rst:413 +#: c-api/structures.rst:447 msgid "Its fields are, in order:" msgstr "" -#: c-api/structures.rst:417 +#: c-api/structures.rst:451 msgid "" "Name of the member. A NULL value marks the end of a ``PyMemberDef[]`` array." msgstr "" -#: c-api/structures.rst:420 +#: c-api/structures.rst:454 msgid "The string should be static, no copy is made of it." msgstr "" -#: c-api/structures.rst:424 +#: c-api/structures.rst:458 msgid "" "The type of the member in the C struct. See :ref:`PyMemberDef-types` for the " "possible values." msgstr "" -#: c-api/structures.rst:429 +#: c-api/structures.rst:463 msgid "" "The offset in bytes that the member is located on the type’s object struct." msgstr "" -#: c-api/structures.rst:433 +#: c-api/structures.rst:467 msgid "" "Zero or more of the :ref:`PyMemberDef-flags`, combined using bitwise OR." msgstr "" -#: c-api/structures.rst:437 +#: c-api/structures.rst:471 msgid "" "The docstring, or NULL. The string should be static, no copy is made of it. " "Typically, it is defined using :c:macro:`PyDoc_STR`." msgstr "" -#: c-api/structures.rst:441 +#: c-api/structures.rst:475 msgid "" "By default (when :c:member:`~PyMemberDef.flags` is ``0``), members allow " "both read and write access. Use the :c:macro:`Py_READONLY` flag for read-" @@ -459,7 +498,7 @@ msgid "" "`T_OBJECT`) members can be deleted." msgstr "" -#: c-api/structures.rst:450 +#: c-api/structures.rst:484 msgid "" "For heap-allocated types (created using :c:func:`PyType_FromSpec` or " "similar), ``PyMemberDef`` may contain a definition for the special member " @@ -468,11 +507,11 @@ msgid "" "``Py_T_PYSSIZET`` and ``Py_READONLY``, for example::" msgstr "" -#: c-api/structures.rst:462 +#: c-api/structures.rst:496 msgid "(You may need to ``#include `` for :c:func:`!offsetof`.)" msgstr "" -#: c-api/structures.rst:464 +#: c-api/structures.rst:498 msgid "" "The legacy offsets :c:member:`~PyTypeObject.tp_dictoffset` and :c:member:" "`~PyTypeObject.tp_weaklistoffset` can be defined similarly using " @@ -481,77 +520,77 @@ msgid "" "and :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` instead." msgstr "" -#: c-api/structures.rst:472 +#: c-api/structures.rst:506 msgid "" "``PyMemberDef`` is always available. Previously, it required including " "``\"structmember.h\"``." msgstr "" -#: c-api/structures.rst:477 +#: c-api/structures.rst:511 msgid "" "Get an attribute belonging to the object at address *obj_addr*. The " "attribute is described by ``PyMemberDef`` *m*. Returns ``NULL`` on error." msgstr "" -#: c-api/structures.rst:483 +#: c-api/structures.rst:517 msgid "" "``PyMember_GetOne`` is always available. Previously, it required including " "``\"structmember.h\"``." msgstr "" -#: c-api/structures.rst:488 +#: c-api/structures.rst:522 msgid "" "Set an attribute belonging to the object at address *obj_addr* to object " "*o*. The attribute to set is described by ``PyMemberDef`` *m*. Returns " "``0`` if successful and a negative value on failure." msgstr "" -#: c-api/structures.rst:494 +#: c-api/structures.rst:528 msgid "" "``PyMember_SetOne`` is always available. Previously, it required including " "``\"structmember.h\"``." msgstr "" -#: c-api/structures.rst:500 +#: c-api/structures.rst:534 msgid "Member flags" msgstr "" -#: c-api/structures.rst:502 +#: c-api/structures.rst:536 msgid "The following flags can be used with :c:member:`PyMemberDef.flags`:" msgstr "" -#: c-api/structures.rst:506 +#: c-api/structures.rst:540 msgid "Not writable." msgstr "" -#: c-api/structures.rst:510 +#: c-api/structures.rst:544 msgid "" "Emit an ``object.__getattr__`` :ref:`audit event ` before " "reading." msgstr "" -#: c-api/structures.rst:515 +#: c-api/structures.rst:549 msgid "" "Indicates that the :c:member:`~PyMemberDef.offset` of this ``PyMemberDef`` " "entry indicates an offset from the subclass-specific data, rather than from " "``PyObject``." msgstr "" -#: c-api/structures.rst:519 +#: c-api/structures.rst:553 msgid "" "Can only be used as part of :c:member:`Py_tp_members ` :c:type:`slot ` when creating a class using " +"tp_members>` :c:type:`slot ` when creating a class using " "negative :c:member:`~PyType_Spec.basicsize`. It is mandatory in that case." msgstr "" -#: c-api/structures.rst:524 +#: c-api/structures.rst:558 msgid "" -"This flag is only used in :c:type:`PyTypeSlot`. When setting :c:member:" +"This flag is only used in :c:type:`PyType_Slot`. When setting :c:member:" "`~PyTypeObject.tp_members` during class creation, Python clears it and sets :" "c:member:`PyMemberDef.offset` to the offset from the ``PyObject`` struct." msgstr "" -#: c-api/structures.rst:536 +#: c-api/structures.rst:570 msgid "" "The :c:macro:`!RESTRICTED`, :c:macro:`!READ_RESTRICTED` and :c:macro:`!" "WRITE_RESTRICTED` macros available with ``#include \"structmember.h\"`` are " @@ -560,7 +599,7 @@ msgid "" "nothing." msgstr "" -#: c-api/structures.rst:547 +#: c-api/structures.rst:581 msgid "" "The :c:macro:`!READONLY` macro was renamed to :c:macro:`Py_READONLY`. The :c:" "macro:`!PY_AUDIT_READ` macro was renamed with the ``Py_`` prefix. The new " @@ -569,11 +608,11 @@ msgid "" "names." msgstr "" -#: c-api/structures.rst:556 +#: c-api/structures.rst:590 msgid "Member types" msgstr "" -#: c-api/structures.rst:558 +#: c-api/structures.rst:592 msgid "" ":c:member:`PyMemberDef.type` can be one of the following macros " "corresponding to various C types. When the member is accessed in Python, it " @@ -582,143 +621,143 @@ msgid "" "exception such as :exc:`TypeError` or :exc:`ValueError` is raised." msgstr "" -#: c-api/structures.rst:566 +#: c-api/structures.rst:600 msgid "" "Unless marked (D), attributes defined this way cannot be deleted using e.g. :" "keyword:`del` or :py:func:`delattr`." msgstr "" -#: c-api/structures.rst:570 +#: c-api/structures.rst:604 msgid "Macro name" msgstr "" -#: c-api/structures.rst:570 +#: c-api/structures.rst:604 msgid "C type" msgstr "" -#: c-api/structures.rst:570 +#: c-api/structures.rst:604 msgid "Python type" msgstr "" -#: c-api/structures.rst:572 +#: c-api/structures.rst:606 msgid ":c:expr:`char`" msgstr "" -#: c-api/structures.rst:573 c-api/structures.rst:575 c-api/structures.rst:577 -#: c-api/structures.rst:579 c-api/structures.rst:581 c-api/structures.rst:582 +#: c-api/structures.rst:607 c-api/structures.rst:609 c-api/structures.rst:611 +#: c-api/structures.rst:613 c-api/structures.rst:615 c-api/structures.rst:616 msgid ":py:class:`int`" msgstr "" -#: c-api/structures.rst:573 +#: c-api/structures.rst:607 msgid ":c:expr:`short`" msgstr "" -#: c-api/structures.rst:574 +#: c-api/structures.rst:608 msgid ":c:expr:`int`" msgstr "" -#: c-api/structures.rst:575 +#: c-api/structures.rst:609 msgid ":c:expr:`long`" msgstr "" -#: c-api/structures.rst:576 +#: c-api/structures.rst:610 msgid ":c:expr:`long long`" msgstr "" -#: c-api/structures.rst:577 +#: c-api/structures.rst:611 msgid ":c:expr:`unsigned char`" msgstr "" -#: c-api/structures.rst:578 +#: c-api/structures.rst:612 msgid ":c:expr:`unsigned int`" msgstr "" -#: c-api/structures.rst:579 +#: c-api/structures.rst:613 msgid ":c:expr:`unsigned short`" msgstr "" -#: c-api/structures.rst:580 +#: c-api/structures.rst:614 msgid ":c:expr:`unsigned long`" msgstr "" -#: c-api/structures.rst:581 +#: c-api/structures.rst:615 msgid ":c:expr:`unsigned long long`" msgstr "" -#: c-api/structures.rst:582 +#: c-api/structures.rst:616 msgid ":c:expr:`Py_ssize_t`" msgstr "" -#: c-api/structures.rst:583 +#: c-api/structures.rst:617 msgid ":c:expr:`float`" msgstr "" -#: c-api/structures.rst:584 +#: c-api/structures.rst:618 msgid ":py:class:`float`" msgstr "" -#: c-api/structures.rst:584 +#: c-api/structures.rst:618 msgid ":c:expr:`double`" msgstr "" -#: c-api/structures.rst:585 +#: c-api/structures.rst:619 msgid ":c:expr:`char` (written as 0 or 1)" msgstr "" -#: c-api/structures.rst:585 +#: c-api/structures.rst:619 msgid ":py:class:`bool`" msgstr "" -#: c-api/structures.rst:587 +#: c-api/structures.rst:621 msgid ":c:expr:`const char *` (*)" msgstr "" -#: c-api/structures.rst:588 +#: c-api/structures.rst:622 msgid ":py:class:`str` (RO)" msgstr "" -#: c-api/structures.rst:588 +#: c-api/structures.rst:622 msgid ":c:expr:`const char[]` (*)" msgstr "" -#: c-api/structures.rst:589 +#: c-api/structures.rst:623 msgid ":c:expr:`char` (0-127)" msgstr "" -#: c-api/structures.rst:589 +#: c-api/structures.rst:623 msgid ":py:class:`str` (**)" msgstr "" -#: c-api/structures.rst:590 +#: c-api/structures.rst:624 msgid ":c:expr:`PyObject *`" msgstr "" -#: c-api/structures.rst:590 +#: c-api/structures.rst:624 msgid ":py:class:`object` (D)" msgstr "" -#: c-api/structures.rst:593 +#: c-api/structures.rst:627 msgid "" "(*): Zero-terminated, UTF8-encoded C string. With :c:macro:`!Py_T_STRING` " "the C representation is a pointer; with :c:macro:`!Py_T_STRING_INPLACE` the " "string is stored directly in the structure." msgstr "" -#: c-api/structures.rst:598 +#: c-api/structures.rst:632 msgid "(**): String of length 1. Only ASCII is accepted." msgstr "" -#: c-api/structures.rst:600 +#: c-api/structures.rst:634 msgid "(RO): Implies :c:macro:`Py_READONLY`." msgstr "" -#: c-api/structures.rst:602 +#: c-api/structures.rst:636 msgid "" "(D): Can be deleted, in which case the pointer is set to ``NULL``. Reading a " "``NULL`` pointer raises :py:exc:`AttributeError`." msgstr "" -#: c-api/structures.rst:628 +#: c-api/structures.rst:662 msgid "" "In previous versions, the macros were only available with ``#include " "\"structmember.h\"`` and were named without the ``Py_`` prefix (e.g. as " @@ -726,69 +765,69 @@ msgid "" "with the following deprecated types:" msgstr "" -#: c-api/structures.rst:636 +#: c-api/structures.rst:670 msgid "" "Like ``Py_T_OBJECT_EX``, but ``NULL`` is converted to ``None``. This results " "in surprising behavior in Python: deleting the attribute effectively sets it " "to ``None``." msgstr "" -#: c-api/structures.rst:642 +#: c-api/structures.rst:676 msgid "Always ``None``. Must be used with :c:macro:`Py_READONLY`." msgstr "" -#: c-api/structures.rst:645 +#: c-api/structures.rst:679 msgid "Defining Getters and Setters" msgstr "" -#: c-api/structures.rst:649 +#: c-api/structures.rst:683 msgid "" "Structure to define property-like access for a type. See also description of " "the :c:member:`PyTypeObject.tp_getset` slot." msgstr "" -#: c-api/structures.rst:654 +#: c-api/structures.rst:688 msgid "attribute name" msgstr "" -#: c-api/structures.rst:658 +#: c-api/structures.rst:692 msgid "C function to get the attribute." msgstr "" -#: c-api/structures.rst:662 +#: c-api/structures.rst:696 msgid "" -"Optional C function to set or delete the attribute, if omitted the attribute " -"is readonly." +"Optional C function to set or delete the attribute. If ``NULL``, the " +"attribute is read-only." msgstr "" -#: c-api/structures.rst:666 +#: c-api/structures.rst:701 msgid "optional docstring" msgstr "" -#: c-api/structures.rst:670 +#: c-api/structures.rst:705 msgid "" "Optional function pointer, providing additional data for getter and setter." msgstr "" -#: c-api/structures.rst:672 +#: c-api/structures.rst:709 msgid "" "The ``get`` function takes one :c:expr:`PyObject*` parameter (the instance) " -"and a function pointer (the associated ``closure``)::" +"and a function pointer (the associated ``closure``):" msgstr "" -#: c-api/structures.rst:677 +#: c-api/structures.rst:712 msgid "" "It should return a new reference on success or ``NULL`` with a set exception " "on failure." msgstr "" -#: c-api/structures.rst:680 +#: c-api/structures.rst:717 msgid "" "``set`` functions take two :c:expr:`PyObject*` parameters (the instance and " -"the value to be set) and a function pointer (the associated ``closure``)::" +"the value to be set) and a function pointer (the associated ``closure``):" msgstr "" -#: c-api/structures.rst:685 +#: c-api/structures.rst:720 msgid "" "In case the attribute should be deleted the second parameter is ``NULL``. " "Should return ``0`` on success or ``-1`` with a set exception on failure." @@ -806,94 +845,94 @@ msgstr "" msgid "staticmethod" msgstr "" -#: c-api/structures.rst:529 -msgid "READ_RESTRICTED" +#: c-api/structures.rst:563 +msgid "READ_RESTRICTED (C macro)" msgstr "" -#: c-api/structures.rst:529 -msgid "WRITE_RESTRICTED" +#: c-api/structures.rst:563 +msgid "WRITE_RESTRICTED (C macro)" msgstr "" -#: c-api/structures.rst:529 -msgid "RESTRICTED" +#: c-api/structures.rst:563 +msgid "RESTRICTED (C macro)" msgstr "" -#: c-api/structures.rst:542 -msgid "READONLY" +#: c-api/structures.rst:576 +msgid "READONLY (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_BYTE" +#: c-api/structures.rst:639 +msgid "T_BYTE (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_SHORT" +#: c-api/structures.rst:639 +msgid "T_SHORT (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_INT" +#: c-api/structures.rst:639 +msgid "T_INT (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_LONG" +#: c-api/structures.rst:639 +msgid "T_LONG (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_LONGLONG" +#: c-api/structures.rst:639 +msgid "T_LONGLONG (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_UBYTE" +#: c-api/structures.rst:639 +msgid "T_UBYTE (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_USHORT" +#: c-api/structures.rst:639 +msgid "T_USHORT (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_UINT" +#: c-api/structures.rst:639 +msgid "T_UINT (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_ULONG" +#: c-api/structures.rst:639 +msgid "T_ULONG (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_ULONGULONG" +#: c-api/structures.rst:639 +msgid "T_ULONGULONG (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_PYSSIZET" +#: c-api/structures.rst:639 +msgid "T_PYSSIZET (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_FLOAT" +#: c-api/structures.rst:639 +msgid "T_FLOAT (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_DOUBLE" +#: c-api/structures.rst:639 +msgid "T_DOUBLE (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_BOOL" +#: c-api/structures.rst:639 +msgid "T_BOOL (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_CHAR" +#: c-api/structures.rst:639 +msgid "T_CHAR (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_STRING" +#: c-api/structures.rst:639 +msgid "T_STRING (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_STRING_INPLACE" +#: c-api/structures.rst:639 +msgid "T_STRING_INPLACE (C macro)" msgstr "" -#: c-api/structures.rst:605 -msgid "T_OBJECT_EX" +#: c-api/structures.rst:639 +msgid "T_OBJECT_EX (C macro)" msgstr "" -#: c-api/structures.rst:605 +#: c-api/structures.rst:639 msgid "structmember.h" msgstr "" diff --git a/c-api/sys.po b/c-api/sys.po index 14fa70f99..a7e8882b8 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: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+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 "Operating System Utilities" msgstr "" -#: c-api/sys.rst:10 +#: c-api/sys.rst:11 msgid "" "Return the file system representation for *path*. If the object is a :class:" "`str` or :class:`bytes` object, then a new :term:`strong reference` is " @@ -30,7 +30,7 @@ msgid "" "is returned." msgstr "" -#: c-api/sys.rst:23 +#: c-api/sys.rst:24 msgid "" "Return true (nonzero) if the standard I/O file *fp* with name *filename* is " "deemed interactive. This is the case for files for which " @@ -40,11 +40,11 @@ msgid "" "``'???'``." msgstr "" -#: c-api/sys.rst:29 +#: c-api/sys.rst:30 msgid "This function must not be called before Python is initialized." msgstr "" -#: c-api/sys.rst:34 +#: c-api/sys.rst:35 msgid "" "Function to prepare some internal state before a process fork. This should " "be called before calling :c:func:`fork` or any similar function that clones " @@ -52,14 +52,14 @@ msgid "" "defined." msgstr "" -#: c-api/sys.rst:40 +#: c-api/sys.rst:41 msgid "" "The C :c:func:`fork` call should only be made from the :ref:`\"main\" thread " "` (of the :ref:`\"main\" interpreter `). The same is true for ``PyOS_BeforeFork()``." msgstr "" -#: c-api/sys.rst:50 +#: c-api/sys.rst:51 msgid "" "Function to update some internal state after a process fork. This should be " "called from the parent process after calling :c:func:`fork` or any similar " @@ -68,14 +68,14 @@ msgid "" "defined." msgstr "" -#: c-api/sys.rst:57 +#: c-api/sys.rst:58 msgid "" "The C :c:func:`fork` call should only be made from the :ref:`\"main\" thread " "` (of the :ref:`\"main\" interpreter `). The same is true for ``PyOS_AfterFork_Parent()``." msgstr "" -#: c-api/sys.rst:67 +#: c-api/sys.rst:68 msgid "" "Function to update internal interpreter state after a process fork. This " "must be called from the child process after calling :c:func:`fork`, or any " @@ -84,21 +84,21 @@ msgid "" "systems where :c:func:`fork` is defined." msgstr "" -#: c-api/sys.rst:74 +#: c-api/sys.rst:75 msgid "" "The C :c:func:`fork` call should only be made from the :ref:`\"main\" thread " "` (of the :ref:`\"main\" interpreter `). The same is true for ``PyOS_AfterFork_Child()``." msgstr "" -#: c-api/sys.rst:82 +#: c-api/sys.rst:83 msgid "" ":func:`os.register_at_fork` allows registering custom Python functions to be " "called by :c:func:`PyOS_BeforeFork()`, :c:func:`PyOS_AfterFork_Parent` and :" "c:func:`PyOS_AfterFork_Child`." msgstr "" -#: c-api/sys.rst:89 +#: c-api/sys.rst:90 msgid "" "Function to update some internal state after a process fork; this should be " "called in the new process if the Python interpreter will continue to be " @@ -106,50 +106,48 @@ msgid "" "not need to be called." msgstr "" -#: c-api/sys.rst:94 +#: c-api/sys.rst:95 msgid "This function is superseded by :c:func:`PyOS_AfterFork_Child()`." msgstr "" -#: c-api/sys.rst:100 +#: c-api/sys.rst:103 msgid "" "Return true when the interpreter runs out of stack space. This is a " -"reliable check, but is only available when :c:macro:`USE_STACKCHECK` is " +"reliable check, but is only available when :c:macro:`!USE_STACKCHECK` is " "defined (currently on certain versions of Windows using the Microsoft Visual " -"C++ compiler). :c:macro:`USE_STACKCHECK` will be defined automatically; you " +"C++ compiler). :c:macro:`!USE_STACKCHECK` will be defined automatically; you " "should never change the definition in your own code." msgstr "" -#: c-api/sys.rst:109 +#: c-api/sys.rst:115 msgid "" "Return the current signal handler for signal *i*. This is a thin wrapper " "around either :c:func:`!sigaction` or :c:func:`!signal`. Do not call those " -"functions directly! :c:type:`PyOS_sighandler_t` is a typedef alias for :c:" -"expr:`void (\\*)(int)`." +"functions directly!" msgstr "" -#: c-api/sys.rst:117 +#: c-api/sys.rst:122 msgid "" "Set the signal handler for signal *i* to be *h*; return the old signal " "handler. This is a thin wrapper around either :c:func:`!sigaction` or :c:" -"func:`!signal`. Do not call those functions directly! :c:type:" -"`PyOS_sighandler_t` is a typedef alias for :c:expr:`void (\\*)(int)`." +"func:`!signal`. Do not call those functions directly!" msgstr "" -#: c-api/sys.rst:125 +#: c-api/sys.rst:129 msgid "" "This function should not be called directly: use the :c:type:`PyConfig` API " "with the :c:func:`PyConfig_SetBytesString` function which ensures that :ref:" "`Python is preinitialized `." msgstr "" -#: c-api/sys.rst:196 +#: c-api/sys.rst:200 msgid "" "This function must not be called before :ref:`Python is preinitialized ` and so that the LC_CTYPE locale is properly configured: see the :c:" "func:`Py_PreInitialize` function." msgstr "" -#: c-api/sys.rst:133 +#: c-api/sys.rst:137 msgid "" "Decode a byte string from the :term:`filesystem encoding and error handler`. " "If the error handler is :ref:`surrogateescape error handler " @@ -159,57 +157,57 @@ msgid "" "instead of decoding them." msgstr "" -#: c-api/sys.rst:140 +#: c-api/sys.rst:144 msgid "" "Return a pointer to a newly allocated wide character string, use :c:func:" "`PyMem_RawFree` to free the memory. If size is not ``NULL``, write the " "number of wide characters excluding the null character into ``*size``" msgstr "" -#: c-api/sys.rst:144 +#: c-api/sys.rst:148 msgid "" "Return ``NULL`` on decoding error or memory allocation error. If *size* is " "not ``NULL``, ``*size`` is set to ``(size_t)-1`` on memory error or set to " "``(size_t)-2`` on decoding error." msgstr "" -#: c-api/sys.rst:188 +#: c-api/sys.rst:192 msgid "" "The :term:`filesystem encoding and error handler` are selected by :c:func:" "`PyConfig_Read`: see :c:member:`~PyConfig.filesystem_encoding` and :c:member:" "`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`." msgstr "" -#: c-api/sys.rst:152 +#: c-api/sys.rst:156 msgid "" "Decoding errors should never happen, unless there is a bug in the C library." msgstr "" -#: c-api/sys.rst:155 +#: c-api/sys.rst:159 msgid "" "Use the :c:func:`Py_EncodeLocale` function to encode the character string " "back to a byte string." msgstr "" -#: c-api/sys.rst:160 +#: c-api/sys.rst:164 msgid "" "The :c:func:`PyUnicode_DecodeFSDefaultAndSize` and :c:func:" "`PyUnicode_DecodeLocaleAndSize` functions." msgstr "" -#: c-api/sys.rst:207 +#: c-api/sys.rst:211 msgid "" "The function now uses the UTF-8 encoding in the :ref:`Python UTF-8 Mode " "`." msgstr "" -#: c-api/sys.rst:169 +#: c-api/sys.rst:173 msgid "" "The function now uses the UTF-8 encoding on Windows if :c:member:" "`PyPreConfig.legacy_windows_fs_encoding` is zero;" msgstr "" -#: c-api/sys.rst:176 +#: c-api/sys.rst:180 msgid "" "Encode a wide character string to the :term:`filesystem encoding and error " "handler`. If the error handler is :ref:`surrogateescape error handler " @@ -217,42 +215,42 @@ msgid "" "converted to bytes 0x80..0xFF." msgstr "" -#: c-api/sys.rst:181 +#: c-api/sys.rst:185 msgid "" "Return a pointer to a newly allocated byte string, use :c:func:`PyMem_Free` " "to free the memory. Return ``NULL`` on encoding error or memory allocation " "error." msgstr "" -#: c-api/sys.rst:185 +#: c-api/sys.rst:189 msgid "" "If error_pos is not ``NULL``, ``*error_pos`` is set to ``(size_t)-1`` on " "success, or set to the index of the invalid character on encoding error." msgstr "" -#: c-api/sys.rst:192 +#: c-api/sys.rst:196 msgid "" "Use the :c:func:`Py_DecodeLocale` function to decode the bytes string back " "to a wide character string." msgstr "" -#: c-api/sys.rst:202 +#: c-api/sys.rst:206 msgid "" "The :c:func:`PyUnicode_EncodeFSDefault` and :c:func:`PyUnicode_EncodeLocale` " "functions." msgstr "" -#: c-api/sys.rst:211 +#: c-api/sys.rst:215 msgid "" "The function now uses the UTF-8 encoding on Windows if :c:member:" "`PyPreConfig.legacy_windows_fs_encoding` is zero." msgstr "" -#: c-api/sys.rst:219 +#: c-api/sys.rst:223 msgid "System Functions" msgstr "" -#: c-api/sys.rst:221 +#: c-api/sys.rst:225 msgid "" "These are utility functions that make functionality from the :mod:`sys` " "module accessible to C code. They all work with the current interpreter " @@ -260,43 +258,43 @@ msgid "" "state structure." msgstr "" -#: c-api/sys.rst:227 +#: c-api/sys.rst:231 msgid "" "Return the object *name* from the :mod:`sys` module or ``NULL`` if it does " "not exist, without setting an exception." msgstr "" -#: c-api/sys.rst:232 +#: c-api/sys.rst:236 msgid "" "Set *name* in the :mod:`sys` module to *v* unless *v* is ``NULL``, in which " "case *name* is deleted from the sys module. Returns ``0`` on success, ``-1`` " "on error." msgstr "" -#: c-api/sys.rst:238 +#: c-api/sys.rst:242 msgid "" "Reset :data:`sys.warnoptions` to an empty list. This function may be called " "prior to :c:func:`Py_Initialize`." msgstr "" -#: c-api/sys.rst:254 +#: c-api/sys.rst:258 msgid "" "This API is kept for backward compatibility: setting :c:member:`PyConfig." "warnoptions` should be used instead, see :ref:`Python Initialization " "Configuration `." msgstr "" -#: c-api/sys.rst:247 +#: c-api/sys.rst:251 msgid "" "Append *s* to :data:`sys.warnoptions`. This function must be called prior " "to :c:func:`Py_Initialize` in order to affect the warnings filter list." msgstr "" -#: c-api/sys.rst:258 +#: c-api/sys.rst:262 msgid "Append *unicode* to :data:`sys.warnoptions`." msgstr "" -#: c-api/sys.rst:260 +#: c-api/sys.rst:264 msgid "" "Note: this function is not currently usable from outside the CPython " "implementation, as it must be called prior to the implicit import of :mod:" @@ -305,7 +303,7 @@ msgid "" "Unicode objects." msgstr "" -#: c-api/sys.rst:270 +#: c-api/sys.rst:274 msgid "" "This API is kept for backward compatibility: setting :c:member:`PyConfig." "module_search_paths` and :c:member:`PyConfig.module_search_paths_set` should " @@ -313,20 +311,20 @@ msgid "" "config>`." msgstr "" -#: c-api/sys.rst:275 +#: c-api/sys.rst:279 msgid "" "Set :data:`sys.path` to a list object of paths found in *path* which should " "be a list of paths separated with the platform's search path delimiter (``:" "`` on Unix, ``;`` on Windows)." msgstr "" -#: c-api/sys.rst:283 +#: c-api/sys.rst:287 msgid "" "Write the output string described by *format* to :data:`sys.stdout`. No " "exceptions are raised, even if truncation occurs (see below)." msgstr "" -#: c-api/sys.rst:286 +#: c-api/sys.rst:290 msgid "" "*format* should limit the total size of the formatted output string to 1000 " "bytes or less -- after 1000 bytes, the output string is truncated. In " @@ -337,58 +335,58 @@ msgid "" "of digits for very large numbers." msgstr "" -#: c-api/sys.rst:294 +#: c-api/sys.rst:298 msgid "" "If a problem occurs, or :data:`sys.stdout` is unset, the formatted message " "is written to the real (C level) *stdout*." msgstr "" -#: c-api/sys.rst:299 +#: c-api/sys.rst:303 msgid "" "As :c:func:`PySys_WriteStdout`, but write to :data:`sys.stderr` or *stderr* " "instead." msgstr "" -#: c-api/sys.rst:304 +#: c-api/sys.rst:308 msgid "" "Function similar to PySys_WriteStdout() but format the message using :c:func:" "`PyUnicode_FromFormatV` and don't truncate the message to an arbitrary " "length." msgstr "" -#: c-api/sys.rst:312 +#: c-api/sys.rst:316 msgid "" "As :c:func:`PySys_FormatStdout`, but write to :data:`sys.stderr` or *stderr* " "instead." msgstr "" -#: c-api/sys.rst:319 +#: c-api/sys.rst:323 msgid "" "This API is kept for backward compatibility: setting :c:member:`PyConfig." "xoptions` should be used instead, see :ref:`Python Initialization " "Configuration `." msgstr "" -#: c-api/sys.rst:323 +#: c-api/sys.rst:327 msgid "" "Parse *s* as a set of :option:`-X` options and add them to the current " "options mapping as returned by :c:func:`PySys_GetXOptions`. This function " "may be called prior to :c:func:`Py_Initialize`." msgstr "" -#: c-api/sys.rst:333 +#: c-api/sys.rst:337 msgid "" "Return the current dictionary of :option:`-X` options, similarly to :data:" "`sys._xoptions`. On error, ``NULL`` is returned and an exception is set." msgstr "" -#: c-api/sys.rst:342 +#: c-api/sys.rst:346 msgid "" "Raise an auditing event with any active hooks. Return zero for success and " "non-zero with an exception set on failure." msgstr "" -#: c-api/sys.rst:345 +#: c-api/sys.rst:349 msgid "" "If any hooks have been added, *format* and other arguments will be used to " "construct a tuple to pass. Apart from ``N``, the same format characters as " @@ -399,23 +397,23 @@ msgid "" "leaks.)" msgstr "" -#: c-api/sys.rst:353 +#: c-api/sys.rst:357 msgid "" "Note that ``#`` format characters should always be treated as :c:type:" "`Py_ssize_t`, regardless of whether ``PY_SSIZE_T_CLEAN`` was defined." msgstr "" -#: c-api/sys.rst:356 +#: c-api/sys.rst:360 msgid ":func:`sys.audit` performs the same function from Python code." msgstr "" -#: c-api/sys.rst:362 +#: c-api/sys.rst:366 msgid "" "Require :c:type:`Py_ssize_t` for ``#`` format characters. Previously, an " "unavoidable deprecation warning was raised." msgstr "" -#: c-api/sys.rst:368 +#: c-api/sys.rst:372 msgid "" "Append the callable *hook* to the list of active auditing hooks. Return zero " "on success and non-zero on failure. If the runtime has been initialized, " @@ -423,14 +421,14 @@ msgid "" "all interpreters created by the runtime." msgstr "" -#: c-api/sys.rst:374 +#: c-api/sys.rst:378 msgid "" "The *userData* pointer is passed into the hook function. Since hook " "functions may be called from different runtimes, this pointer should not " "refer directly to Python state." msgstr "" -#: c-api/sys.rst:378 +#: c-api/sys.rst:382 msgid "" "This function is safe to call before :c:func:`Py_Initialize`. When called " "after runtime initialization, existing audit hooks are notified and may " @@ -438,41 +436,46 @@ msgid "" "`Exception` (other errors will not be silenced)." msgstr "" -#: c-api/sys.rst:383 +#: c-api/sys.rst:387 msgid "" -"The hook function is of type :c:expr:`int (*)(const char *event, PyObject " -"*args, void *userData)`, where *args* is guaranteed to be a :c:type:" -"`PyTupleObject`. The hook function is always called with the GIL held by the " -"Python interpreter that raised the event." +"The hook function is always called with the GIL held by the Python " +"interpreter that raised the event." msgstr "" -#: c-api/sys.rst:388 +#: c-api/sys.rst:390 msgid "" "See :pep:`578` for a detailed description of auditing. Functions in the " "runtime and standard library that raise events are listed in the :ref:`audit " "events table `. Details are in each function's documentation." msgstr "" -#: c-api/sys.rst:393 +#: c-api/sys.rst:395 msgid "" "Raises an :ref:`auditing event ` ``sys.addaudithook`` with no " "arguments." msgstr "" -#: c-api/sys.rst:395 +#: c-api/sys.rst:397 msgid "" -"If the interpreter is initialized, this function raises a auditing event " +"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 :class:`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:407 +#: c-api/sys.rst:406 +msgid "" +"The type of the hook function. *event* is the C string event argument passed " +"to :c:func:`PySys_Audit`. *args* is guaranteed to be a :c:type:" +"`PyTupleObject`. *userData* is the argument passed to PySys_AddAuditHook()." +msgstr "" + +#: c-api/sys.rst:417 msgid "Process Control" msgstr "" -#: c-api/sys.rst:414 +#: c-api/sys.rst:424 msgid "" "Print a fatal error message and kill the process. No cleanup is performed. " "This function should only be invoked when a condition is detected that would " @@ -482,29 +485,29 @@ msgid "" "file:`core` file." msgstr "" -#: c-api/sys.rst:421 +#: c-api/sys.rst:431 msgid "" "The ``Py_FatalError()`` function is replaced with a macro which logs " "automatically the name of the current function, unless the " "``Py_LIMITED_API`` macro is defined." msgstr "" -#: c-api/sys.rst:425 +#: c-api/sys.rst:435 msgid "Log the function name automatically." msgstr "" -#: c-api/sys.rst:435 +#: c-api/sys.rst:445 msgid "" "Exit the current process. This calls :c:func:`Py_FinalizeEx` and then calls " "the standard C library function ``exit(status)``. If :c:func:" "`Py_FinalizeEx` indicates an error, the exit status is set to 120." msgstr "" -#: c-api/sys.rst:439 +#: c-api/sys.rst:449 msgid "Errors from finalization no longer ignored." msgstr "" -#: c-api/sys.rst:449 +#: c-api/sys.rst:459 msgid "" "Register a cleanup function to be called by :c:func:`Py_FinalizeEx`. The " "cleanup function will be called with no arguments and should return no " @@ -516,18 +519,22 @@ msgid "" "should be called by *func*." msgstr "" -#: c-api/sys.rst:412 -msgid "abort()" +#: c-api/sys.rst:101 +msgid "USE_STACKCHECK (C macro)" msgstr "" -#: c-api/sys.rst:445 -msgid "Py_FinalizeEx()" +#: c-api/sys.rst:422 +msgid "abort (C function)" msgstr "" -#: c-api/sys.rst:431 -msgid "exit()" +#: c-api/sys.rst:455 +msgid "Py_FinalizeEx (C function)" msgstr "" -#: c-api/sys.rst:445 +#: c-api/sys.rst:441 +msgid "exit (C function)" +msgstr "" + +#: c-api/sys.rst:455 msgid "cleanup functions" msgstr "" diff --git a/c-api/typeobj.po b/c-api/typeobj.po index a96f3efa2..4687af8f2 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -92,7 +92,7 @@ msgstr "" msgid " :c:member:`~PyTypeObject.tp_name`" msgstr "" -#: c-api/typeobj.rst:86 c-api/typeobj.rst:0 +#: c-api/typeobj.rst:44 c-api/typeobj.rst:86 msgid "const char *" msgstr "" @@ -113,7 +113,7 @@ msgstr "" msgid ":c:member:`~PyTypeObject.tp_basicsize`" msgstr "" -#: c-api/typeobj.rst:48 c-api/typeobj.rst:99 c-api/typeobj.rst:0 +#: c-api/typeobj.rst:46 c-api/typeobj.rst:52 c-api/typeobj.rst:120 #: c-api/typeobj.rst:416 msgid ":c:type:`Py_ssize_t`" msgstr "" @@ -376,7 +376,7 @@ msgstr "" msgid ":c:member:`~PyTypeObject.tp_base`" msgstr "" -#: c-api/typeobj.rst:0 +#: c-api/typeobj.rst:111 msgid ":c:type:`PyTypeObject` *" msgstr "" @@ -388,8 +388,8 @@ msgstr "" msgid ":c:member:`~PyTypeObject.tp_dict`" msgstr "" -#: c-api/typeobj.rst:132 c-api/typeobj.rst:136 c-api/typeobj.rst:341 -#: c-api/typeobj.rst:0 c-api/typeobj.rst:368 c-api/typeobj.rst:381 +#: c-api/typeobj.rst:113 c-api/typeobj.rst:134 c-api/typeobj.rst:140 +#: c-api/typeobj.rst:346 c-api/typeobj.rst:368 c-api/typeobj.rst:381 #: c-api/typeobj.rst:404 c-api/typeobj.rst:412 c-api/typeobj.rst:416 #: c-api/typeobj.rst:431 c-api/typeobj.rst:440 c-api/typeobj.rst:446 msgid ":c:type:`PyObject` *" @@ -499,7 +499,7 @@ msgstr "" msgid "[:c:member:`~PyTypeObject.tp_subclasses`]" msgstr "" -#: c-api/typeobj.rst:279 c-api/typeobj.rst:0 +#: c-api/typeobj.rst:138 c-api/typeobj.rst:348 msgid "void *" msgstr "" @@ -1066,7 +1066,7 @@ msgstr "" msgid ":c:type:`visitproc`" msgstr "" -#: c-api/typeobj.rst:362 c-api/typeobj.rst:386 c-api/typeobj.rst:0 +#: c-api/typeobj.rst:350 c-api/typeobj.rst:375 c-api/typeobj.rst:398 #: c-api/typeobj.rst:429 c-api/typeobj.rst:457 c-api/typeobj.rst:462 msgid "int" msgstr "" diff --git a/c-api/unicode.po b/c-api/unicode.po index 23dccfc00..4a2d570df 100644 --- a/c-api/unicode.po +++ b/c-api/unicode.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1038,15 +1038,26 @@ msgid "" "Copy the Unicode object contents into the :c:type:`wchar_t` buffer *wstr*. " "At most *size* :c:type:`wchar_t` characters are copied (excluding a possibly " "trailing null termination character). Return the number of :c:type:" -"`wchar_t` characters copied or ``-1`` in case of an error. Note that the " -"resulting :c:expr:`wchar_t*` string may or may not be null-terminated. It " -"is the responsibility of the caller to make sure that the :c:expr:`wchar_t*` " -"string is null-terminated in case this is required by the application. Also, " -"note that the :c:expr:`wchar_t*` string might contain null characters, which " -"would cause the string to be truncated when used with most C functions." +"`wchar_t` characters copied or ``-1`` in case of an error." msgstr "" -#: c-api/unicode.rst:874 +#: c-api/unicode.rst:866 +msgid "" +"When *wstr* is ``NULL``, instead return the *size* that would be required to " +"store all of *unicode* including a terminating null." +msgstr "" + +#: c-api/unicode.rst:869 +msgid "" +"Note that the resulting :c:expr:`wchar_t*` string may or may not be null-" +"terminated. It is the responsibility of the caller to make sure that the :c:" +"expr:`wchar_t*` string is null-terminated in case this is required by the " +"application. Also, note that the :c:expr:`wchar_t*` string might contain " +"null characters, which would cause the string to be truncated when used with " +"most C functions." +msgstr "" + +#: c-api/unicode.rst:879 msgid "" "Convert the Unicode object to a wide character string. The output string " "always ends with a null character. If *size* is not ``NULL``, write the " @@ -1057,37 +1068,37 @@ msgid "" "`wchar_t*` string contains null characters a :exc:`ValueError` is raised." msgstr "" -#: c-api/unicode.rst:882 +#: c-api/unicode.rst:887 msgid "" "Returns a buffer allocated by :c:macro:`PyMem_New` (use :c:func:`PyMem_Free` " "to free it) on success. On error, returns ``NULL`` and *\\*size* is " "undefined. Raises a :exc:`MemoryError` if memory allocation is failed." msgstr "" -#: c-api/unicode.rst:889 +#: c-api/unicode.rst:894 msgid "" "Raises a :exc:`ValueError` if *size* is ``NULL`` and the :c:expr:`wchar_t*` " "string contains null characters." msgstr "" -#: c-api/unicode.rst:897 +#: c-api/unicode.rst:902 msgid "Built-in Codecs" msgstr "" -#: c-api/unicode.rst:899 +#: c-api/unicode.rst:904 msgid "" "Python provides a set of built-in codecs which are written in C for speed. " "All of these codecs are directly usable via the following functions." msgstr "" -#: c-api/unicode.rst:902 +#: c-api/unicode.rst:907 msgid "" "Many of the following APIs take two arguments encoding and errors, and they " "have the same semantics as the ones of the built-in :func:`str` string " "object constructor." msgstr "" -#: c-api/unicode.rst:906 +#: c-api/unicode.rst:911 msgid "" "Setting encoding to ``NULL`` causes the default encoding to be used which is " "UTF-8. The file system calls should use :c:func:`PyUnicode_FSConverter` for " @@ -1095,28 +1106,28 @@ msgid "" "handler` internally." msgstr "" -#: c-api/unicode.rst:911 +#: c-api/unicode.rst:916 msgid "" "Error handling is set by errors which may also be set to ``NULL`` meaning to " "use the default handling defined for the codec. Default error handling for " "all built-in codecs is \"strict\" (:exc:`ValueError` is raised)." msgstr "" -#: c-api/unicode.rst:915 +#: c-api/unicode.rst:920 msgid "" "The codecs all use a similar interface. Only deviations from the following " "generic ones are documented for simplicity." msgstr "" -#: c-api/unicode.rst:920 +#: c-api/unicode.rst:925 msgid "Generic Codecs" msgstr "" -#: c-api/unicode.rst:922 +#: c-api/unicode.rst:927 msgid "These are the generic codec APIs:" msgstr "" -#: c-api/unicode.rst:928 +#: c-api/unicode.rst:933 msgid "" "Create a Unicode object by decoding *size* bytes of the encoded string " "*str*. *encoding* and *errors* have the same meaning as the parameters of " @@ -1125,7 +1136,7 @@ msgid "" "was raised by the codec." msgstr "" -#: c-api/unicode.rst:938 +#: c-api/unicode.rst:943 msgid "" "Encode a Unicode object and return the result as Python bytes object. " "*encoding* and *errors* have the same meaning as the parameters of the same " @@ -1134,21 +1145,21 @@ msgid "" "was raised by the codec." msgstr "" -#: c-api/unicode.rst:946 +#: c-api/unicode.rst:951 msgid "UTF-8 Codecs" msgstr "" -#: c-api/unicode.rst:948 +#: c-api/unicode.rst:953 msgid "These are the UTF-8 codec APIs:" msgstr "" -#: c-api/unicode.rst:953 +#: c-api/unicode.rst:958 msgid "" "Create a Unicode object by decoding *size* bytes of the UTF-8 encoded string " "*str*. Return ``NULL`` if an exception was raised by the codec." msgstr "" -#: c-api/unicode.rst:960 +#: c-api/unicode.rst:965 msgid "" "If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeUTF8`. If " "*consumed* is not ``NULL``, trailing incomplete UTF-8 byte sequences will " @@ -1156,14 +1167,14 @@ msgid "" "of bytes that have been decoded will be stored in *consumed*." msgstr "" -#: c-api/unicode.rst:968 +#: c-api/unicode.rst:973 msgid "" "Encode a Unicode object using UTF-8 and return the result as Python bytes " "object. Error handling is \"strict\". Return ``NULL`` if an exception was " "raised by the codec." msgstr "" -#: c-api/unicode.rst:975 +#: c-api/unicode.rst:980 msgid "" "Return a pointer to the UTF-8 encoding of the Unicode object, and store the " "size of the encoded representation (in bytes) in *size*. The *size* " @@ -1172,13 +1183,13 @@ msgid "" "regardless of whether there are any other null code points." msgstr "" -#: c-api/unicode.rst:981 +#: c-api/unicode.rst:986 msgid "" "In the case of an error, ``NULL`` is returned with an exception set and no " "*size* is stored." msgstr "" -#: c-api/unicode.rst:984 +#: c-api/unicode.rst:989 msgid "" "This caches the UTF-8 representation of the string in the Unicode object, " "and subsequent calls will return a pointer to the same buffer. The caller " @@ -1187,40 +1198,40 @@ msgid "" "collected." msgstr "" -#: c-api/unicode.rst:1004 +#: c-api/unicode.rst:1009 msgid "The return type is now ``const char *`` rather of ``char *``." msgstr "" -#: c-api/unicode.rst:994 +#: c-api/unicode.rst:999 msgid "This function is a part of the :ref:`limited API `." msgstr "" -#: c-api/unicode.rst:1000 +#: c-api/unicode.rst:1005 msgid "As :c:func:`PyUnicode_AsUTF8AndSize`, but does not store the size." msgstr "" -#: c-api/unicode.rst:1009 +#: c-api/unicode.rst:1014 msgid "UTF-32 Codecs" msgstr "" -#: c-api/unicode.rst:1011 +#: c-api/unicode.rst:1016 msgid "These are the UTF-32 codec APIs:" msgstr "" -#: c-api/unicode.rst:1017 +#: c-api/unicode.rst:1022 msgid "" "Decode *size* bytes from a UTF-32 encoded buffer string and return the " "corresponding Unicode object. *errors* (if non-``NULL``) defines the error " "handling. It defaults to \"strict\"." msgstr "" -#: c-api/unicode.rst:1071 +#: c-api/unicode.rst:1076 msgid "" "If *byteorder* is non-``NULL``, the decoder starts decoding using the given " "byte order::" msgstr "" -#: c-api/unicode.rst:1028 +#: c-api/unicode.rst:1033 msgid "" "If ``*byteorder`` is zero, and the first four bytes of the input data are a " "byte order mark (BOM), the decoder switches to this byte order and the BOM " @@ -1228,21 +1239,21 @@ msgid "" "``-1`` or ``1``, any byte order mark is copied to the output." msgstr "" -#: c-api/unicode.rst:1033 +#: c-api/unicode.rst:1038 msgid "" "After completion, *\\*byteorder* is set to the current byte order at the end " "of input data." msgstr "" -#: c-api/unicode.rst:1087 +#: c-api/unicode.rst:1092 msgid "If *byteorder* is ``NULL``, the codec starts in native order mode." msgstr "" -#: c-api/unicode.rst:1089 +#: c-api/unicode.rst:1094 msgid "Return ``NULL`` if an exception was raised by the codec." msgstr "" -#: c-api/unicode.rst:1044 +#: c-api/unicode.rst:1049 msgid "" "If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeUTF32`. If " "*consumed* is not ``NULL``, :c:func:`PyUnicode_DecodeUTF32Stateful` will not " @@ -1251,29 +1262,29 @@ msgid "" "number of bytes that have been decoded will be stored in *consumed*." msgstr "" -#: c-api/unicode.rst:1053 +#: c-api/unicode.rst:1058 msgid "" "Return a Python byte string using the UTF-32 encoding in native byte order. " "The string always starts with a BOM mark. Error handling is \"strict\". " "Return ``NULL`` if an exception was raised by the codec." msgstr "" -#: c-api/unicode.rst:1059 +#: c-api/unicode.rst:1064 msgid "UTF-16 Codecs" msgstr "" -#: c-api/unicode.rst:1061 +#: c-api/unicode.rst:1066 msgid "These are the UTF-16 codec APIs:" msgstr "" -#: c-api/unicode.rst:1067 +#: c-api/unicode.rst:1072 msgid "" "Decode *size* bytes from a UTF-16 encoded buffer string and return the " "corresponding Unicode object. *errors* (if non-``NULL``) defines the error " "handling. It defaults to \"strict\"." msgstr "" -#: c-api/unicode.rst:1078 +#: c-api/unicode.rst:1083 msgid "" "If ``*byteorder`` is zero, and the first two bytes of the input data are a " "byte order mark (BOM), the decoder switches to this byte order and the BOM " @@ -1282,13 +1293,13 @@ msgid "" "result in either a ``\\ufeff`` or a ``\\ufffe`` character)." msgstr "" -#: c-api/unicode.rst:1084 +#: c-api/unicode.rst:1089 msgid "" "After completion, ``*byteorder`` is set to the current byte order at the end " "of input data." msgstr "" -#: c-api/unicode.rst:1095 +#: c-api/unicode.rst:1100 msgid "" "If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeUTF16`. If " "*consumed* is not ``NULL``, :c:func:`PyUnicode_DecodeUTF16Stateful` will not " @@ -1298,28 +1309,28 @@ msgid "" "*consumed*." msgstr "" -#: c-api/unicode.rst:1104 +#: c-api/unicode.rst:1109 msgid "" "Return a Python byte string using the UTF-16 encoding in native byte order. " "The string always starts with a BOM mark. Error handling is \"strict\". " "Return ``NULL`` if an exception was raised by the codec." msgstr "" -#: c-api/unicode.rst:1110 +#: c-api/unicode.rst:1115 msgid "UTF-7 Codecs" msgstr "" -#: c-api/unicode.rst:1112 +#: c-api/unicode.rst:1117 msgid "These are the UTF-7 codec APIs:" msgstr "" -#: c-api/unicode.rst:1117 +#: c-api/unicode.rst:1122 msgid "" "Create a Unicode object by decoding *size* bytes of the UTF-7 encoded string " "*str*. Return ``NULL`` if an exception was raised by the codec." msgstr "" -#: c-api/unicode.rst:1124 +#: c-api/unicode.rst:1129 msgid "" "If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeUTF7`. If " "*consumed* is not ``NULL``, trailing incomplete UTF-7 base-64 sections will " @@ -1327,101 +1338,101 @@ msgid "" "of bytes that have been decoded will be stored in *consumed*." msgstr "" -#: c-api/unicode.rst:1131 +#: c-api/unicode.rst:1136 msgid "Unicode-Escape Codecs" msgstr "" -#: c-api/unicode.rst:1133 +#: c-api/unicode.rst:1138 msgid "These are the \"Unicode Escape\" codec APIs:" msgstr "" -#: c-api/unicode.rst:1139 +#: c-api/unicode.rst:1144 msgid "" "Create a Unicode object by decoding *size* bytes of the Unicode-Escape " "encoded string *str*. Return ``NULL`` if an exception was raised by the " "codec." msgstr "" -#: c-api/unicode.rst:1145 +#: c-api/unicode.rst:1150 msgid "" "Encode a Unicode object using Unicode-Escape and return the result as a " "bytes object. Error handling is \"strict\". Return ``NULL`` if an " "exception was raised by the codec." msgstr "" -#: c-api/unicode.rst:1151 +#: c-api/unicode.rst:1156 msgid "Raw-Unicode-Escape Codecs" msgstr "" -#: c-api/unicode.rst:1153 +#: c-api/unicode.rst:1158 msgid "These are the \"Raw Unicode Escape\" codec APIs:" msgstr "" -#: c-api/unicode.rst:1159 +#: c-api/unicode.rst:1164 msgid "" "Create a Unicode object by decoding *size* bytes of the Raw-Unicode-Escape " "encoded string *str*. Return ``NULL`` if an exception was raised by the " "codec." msgstr "" -#: c-api/unicode.rst:1165 +#: c-api/unicode.rst:1170 msgid "" "Encode a Unicode object using Raw-Unicode-Escape and return the result as a " "bytes object. Error handling is \"strict\". Return ``NULL`` if an " "exception was raised by the codec." msgstr "" -#: c-api/unicode.rst:1171 +#: c-api/unicode.rst:1176 msgid "Latin-1 Codecs" msgstr "" -#: c-api/unicode.rst:1173 +#: c-api/unicode.rst:1178 msgid "" "These are the Latin-1 codec APIs: Latin-1 corresponds to the first 256 " "Unicode ordinals and only these are accepted by the codecs during encoding." msgstr "" -#: c-api/unicode.rst:1179 +#: c-api/unicode.rst:1184 msgid "" "Create a Unicode object by decoding *size* bytes of the Latin-1 encoded " "string *str*. Return ``NULL`` if an exception was raised by the codec." msgstr "" -#: c-api/unicode.rst:1185 +#: c-api/unicode.rst:1190 msgid "" "Encode a Unicode object using Latin-1 and return the result as Python bytes " "object. Error handling is \"strict\". Return ``NULL`` if an exception was " "raised by the codec." msgstr "" -#: c-api/unicode.rst:1191 +#: c-api/unicode.rst:1196 msgid "ASCII Codecs" msgstr "" -#: c-api/unicode.rst:1193 +#: c-api/unicode.rst:1198 msgid "" "These are the ASCII codec APIs. Only 7-bit ASCII data is accepted. All " "other codes generate errors." msgstr "" -#: c-api/unicode.rst:1199 +#: c-api/unicode.rst:1204 msgid "" "Create a Unicode object by decoding *size* bytes of the ASCII encoded string " "*str*. Return ``NULL`` if an exception was raised by the codec." msgstr "" -#: c-api/unicode.rst:1205 +#: c-api/unicode.rst:1210 msgid "" "Encode a Unicode object using ASCII and return the result as Python bytes " "object. Error handling is \"strict\". Return ``NULL`` if an exception was " "raised by the codec." msgstr "" -#: c-api/unicode.rst:1211 +#: c-api/unicode.rst:1216 msgid "Character Map Codecs" msgstr "" -#: c-api/unicode.rst:1213 +#: c-api/unicode.rst:1218 msgid "" "This codec is special in that it can be used to implement many different " "codecs (and this is in fact what was done to obtain most of the standard " @@ -1431,18 +1442,18 @@ msgid "" "sequences work well." msgstr "" -#: c-api/unicode.rst:1219 +#: c-api/unicode.rst:1224 msgid "These are the mapping codec APIs:" msgstr "" -#: c-api/unicode.rst:1224 +#: c-api/unicode.rst:1229 msgid "" "Create a Unicode object by decoding *size* bytes of the encoded string *str* " "using the given *mapping* object. Return ``NULL`` if an exception was " "raised by the codec." msgstr "" -#: c-api/unicode.rst:1228 +#: c-api/unicode.rst:1233 msgid "" "If *mapping* is ``NULL``, Latin-1 decoding will be applied. Else *mapping* " "must map bytes ordinals (integers in the range from 0 to 255) to Unicode " @@ -1452,14 +1463,14 @@ msgid "" "treated as undefined mappings and cause an error." msgstr "" -#: c-api/unicode.rst:1239 +#: c-api/unicode.rst:1244 msgid "" "Encode a Unicode object using the given *mapping* object and return the " "result as a bytes object. Error handling is \"strict\". Return ``NULL`` if " "an exception was raised by the codec." msgstr "" -#: c-api/unicode.rst:1243 +#: c-api/unicode.rst:1248 msgid "" "The *mapping* object must map Unicode ordinal integers to bytes objects, " "integers in the range from 0 to 255 or ``None``. Unmapped character " @@ -1467,41 +1478,41 @@ msgid "" "``None`` are treated as \"undefined mapping\" and cause an error." msgstr "" -#: c-api/unicode.rst:1249 +#: c-api/unicode.rst:1254 msgid "The following codec API is special in that maps Unicode to Unicode." msgstr "" -#: c-api/unicode.rst:1253 +#: c-api/unicode.rst:1258 msgid "" "Translate a string by applying a character mapping table to it and return " "the resulting Unicode object. Return ``NULL`` if an exception was raised by " "the codec." msgstr "" -#: c-api/unicode.rst:1257 +#: c-api/unicode.rst:1262 msgid "" "The mapping table must map Unicode ordinal integers to Unicode ordinal " "integers or ``None`` (causing deletion of the character)." msgstr "" -#: c-api/unicode.rst:1260 +#: c-api/unicode.rst:1265 msgid "" "Mapping tables need only provide the :meth:`~object.__getitem__` interface; " "dictionaries and sequences work well. Unmapped character ordinals (ones " "which cause a :exc:`LookupError`) are left untouched and are copied as-is." msgstr "" -#: c-api/unicode.rst:1264 +#: c-api/unicode.rst:1269 msgid "" "*errors* has the usual meaning for codecs. It may be ``NULL`` which " "indicates to use the default error handling." msgstr "" -#: c-api/unicode.rst:1269 +#: c-api/unicode.rst:1274 msgid "MBCS codecs for Windows" msgstr "" -#: c-api/unicode.rst:1271 +#: c-api/unicode.rst:1276 msgid "" "These are the MBCS codec APIs. They are currently only available on Windows " "and use the Win32 MBCS converters to implement the conversions. Note that " @@ -1509,13 +1520,13 @@ msgid "" "is defined by the user settings on the machine running the codec." msgstr "" -#: c-api/unicode.rst:1278 +#: c-api/unicode.rst:1283 msgid "" "Create a Unicode object by decoding *size* bytes of the MBCS encoded string " "*str*. Return ``NULL`` if an exception was raised by the codec." msgstr "" -#: c-api/unicode.rst:1285 +#: c-api/unicode.rst:1290 msgid "" "If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeMBCS`. If " "*consumed* is not ``NULL``, :c:func:`PyUnicode_DecodeMBCSStateful` will not " @@ -1523,44 +1534,44 @@ msgid "" "will be stored in *consumed*." msgstr "" -#: c-api/unicode.rst:1293 +#: c-api/unicode.rst:1298 msgid "" "Encode a Unicode object using MBCS and return the result as Python bytes " "object. Error handling is \"strict\". Return ``NULL`` if an exception was " "raised by the codec." msgstr "" -#: c-api/unicode.rst:1300 +#: c-api/unicode.rst:1305 msgid "" "Encode the Unicode object using the specified code page and return a Python " "bytes object. Return ``NULL`` if an exception was raised by the codec. Use :" "c:macro:`!CP_ACP` code page to get the MBCS encoder." msgstr "" -#: c-api/unicode.rst:1308 +#: c-api/unicode.rst:1313 msgid "Methods & Slots" msgstr "" -#: c-api/unicode.rst:1314 +#: c-api/unicode.rst:1319 msgid "Methods and Slot Functions" msgstr "" -#: c-api/unicode.rst:1316 +#: c-api/unicode.rst:1321 msgid "" "The following APIs are capable of handling Unicode objects and strings on " "input (we refer to them as strings in the descriptions) and return Unicode " "objects or integers as appropriate." msgstr "" -#: c-api/unicode.rst:1320 +#: c-api/unicode.rst:1325 msgid "They all return ``NULL`` or ``-1`` if an exception occurs." msgstr "" -#: c-api/unicode.rst:1325 +#: c-api/unicode.rst:1330 msgid "Concat two strings giving a new Unicode string." msgstr "" -#: c-api/unicode.rst:1330 +#: c-api/unicode.rst:1335 msgid "" "Split a string giving a list of Unicode strings. If *sep* is ``NULL``, " "splitting will be done at all whitespace substrings. Otherwise, splits " @@ -1569,27 +1580,27 @@ msgid "" "list." msgstr "" -#: c-api/unicode.rst:1338 +#: c-api/unicode.rst:1343 msgid "" "Split a Unicode string at line breaks, returning a list of Unicode strings. " "CRLF is considered to be one line break. If *keepends* is ``0``, the Line " "break characters are not included in the resulting strings." msgstr "" -#: c-api/unicode.rst:1345 +#: c-api/unicode.rst:1350 msgid "" "Join a sequence of strings using the given *separator* and return the " "resulting Unicode string." msgstr "" -#: c-api/unicode.rst:1352 +#: c-api/unicode.rst:1357 msgid "" "Return ``1`` if *substr* matches ``unicode[start:end]`` at the given tail " "end (*direction* == ``-1`` means to do a prefix match, *direction* == ``1`` " "a suffix match), ``0`` otherwise. Return ``-1`` if an error occurred." msgstr "" -#: c-api/unicode.rst:1360 +#: c-api/unicode.rst:1365 msgid "" "Return the first position of *substr* in ``unicode[start:end]`` using the " "given *direction* (*direction* == ``1`` means to do a forward search, " @@ -1598,7 +1609,7 @@ msgid "" "``-2`` indicates that an error occurred and an exception has been set." msgstr "" -#: c-api/unicode.rst:1370 +#: c-api/unicode.rst:1375 msgid "" "Return the first position of the character *ch* in ``unicode[start:end]`` " "using the given *direction* (*direction* == ``1`` means to do a forward " @@ -1608,37 +1619,37 @@ msgid "" "set." msgstr "" -#: c-api/unicode.rst:1378 +#: c-api/unicode.rst:1383 msgid "" "*start* and *end* are now adjusted to behave like ``unicode[start:end]``." msgstr "" -#: c-api/unicode.rst:1385 +#: c-api/unicode.rst:1390 msgid "" "Return the number of non-overlapping occurrences of *substr* in " "``unicode[start:end]``. Return ``-1`` if an error occurred." msgstr "" -#: c-api/unicode.rst:1392 +#: c-api/unicode.rst:1397 msgid "" "Replace at most *maxcount* occurrences of *substr* in *unicode* with " "*replstr* and return the resulting Unicode object. *maxcount* == ``-1`` " "means replace all occurrences." msgstr "" -#: c-api/unicode.rst:1399 +#: c-api/unicode.rst:1404 msgid "" "Compare two strings and return ``-1``, ``0``, ``1`` for less than, equal, " "and greater than, respectively." msgstr "" -#: c-api/unicode.rst:1402 +#: c-api/unicode.rst:1407 msgid "" "This function returns ``-1`` upon failure, so one should call :c:func:" "`PyErr_Occurred` to check for errors." msgstr "" -#: c-api/unicode.rst:1408 +#: c-api/unicode.rst:1413 msgid "" "Compare a Unicode object, *unicode*, with *string* and return ``-1``, ``0``, " "``1`` for less than, equal, and greater than, respectively. It is best to " @@ -1646,51 +1657,51 @@ msgid "" "string as ISO-8859-1 if it contains non-ASCII characters." msgstr "" -#: c-api/unicode.rst:1413 +#: c-api/unicode.rst:1418 msgid "This function does not raise exceptions." msgstr "" -#: c-api/unicode.rst:1418 +#: c-api/unicode.rst:1423 msgid "Rich compare two Unicode strings and return one of the following:" msgstr "" -#: c-api/unicode.rst:1420 +#: c-api/unicode.rst:1425 msgid "``NULL`` in case an exception was raised" msgstr "" -#: c-api/unicode.rst:1421 +#: c-api/unicode.rst:1426 msgid ":c:data:`Py_True` or :c:data:`Py_False` for successful comparisons" msgstr "" -#: c-api/unicode.rst:1422 +#: c-api/unicode.rst:1427 msgid ":c:data:`Py_NotImplemented` in case the type combination is unknown" msgstr "" -#: c-api/unicode.rst:1424 +#: c-api/unicode.rst:1429 msgid "" "Possible values for *op* are :c:macro:`Py_GT`, :c:macro:`Py_GE`, :c:macro:" "`Py_EQ`, :c:macro:`Py_NE`, :c:macro:`Py_LT`, and :c:macro:`Py_LE`." msgstr "" -#: c-api/unicode.rst:1430 +#: c-api/unicode.rst:1435 msgid "" "Return a new string object from *format* and *args*; this is analogous to " "``format % args``." msgstr "" -#: c-api/unicode.rst:1436 +#: c-api/unicode.rst:1441 msgid "" "Check whether *substr* is contained in *unicode* and return true or false " "accordingly." msgstr "" -#: c-api/unicode.rst:1439 +#: c-api/unicode.rst:1444 msgid "" "*substr* has to coerce to a one element Unicode string. ``-1`` is returned " "if there was an error." msgstr "" -#: c-api/unicode.rst:1445 +#: c-api/unicode.rst:1450 msgid "" "Intern the argument :c:expr:`*p_unicode` in place. The argument must be the " "address of a pointer variable pointing to a Python Unicode string object. " @@ -1704,7 +1715,7 @@ msgid "" "owned it before the call.)" msgstr "" -#: c-api/unicode.rst:1458 +#: c-api/unicode.rst:1463 msgid "" "A combination of :c:func:`PyUnicode_FromString` and :c:func:" "`PyUnicode_InternInPlace`, returning either a new Unicode string object that " diff --git a/c-api/veryhigh.po b/c-api/veryhigh.po index 2b5dd0e3f..e6ea5d7a1 100644 --- a/c-api/veryhigh.po +++ b/c-api/veryhigh.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -419,5 +419,5 @@ msgid "" msgstr "" #: c-api/veryhigh.rst:333 c-api/veryhigh.rst:342 -msgid "Py_CompileString()" +msgid "Py_CompileString (C function)" msgstr "" diff --git a/extending/extending.po b/extending/extending.po index fdad17487..e42184f6d 100644 --- a/extending/extending.po +++ b/extending/extending.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1292,15 +1292,15 @@ msgid "" msgstr "" #: extending/extending.rst:539 -msgid "PyObject_CallObject()" +msgid "PyObject_CallObject (C function)" msgstr "" #: extending/extending.rst:630 -msgid "PyArg_ParseTuple()" +msgid "PyArg_ParseTuple (C function)" msgstr "" #: extending/extending.rst:722 -msgid "PyArg_ParseTupleAndKeywords()" +msgid "PyArg_ParseTupleAndKeywords (C function)" msgstr "" #: extending/extending.rst:743 diff --git a/extending/newtypes.po b/extending/newtypes.po index 745decbfb..e2e2b68f9 100644 --- a/extending/newtypes.po +++ b/extending/newtypes.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -596,11 +596,11 @@ msgid "finalization, of objects" msgstr "" #: extending/newtypes.rst:91 -msgid "PyErr_Fetch()" +msgid "PyErr_Fetch (C function)" msgstr "" #: extending/newtypes.rst:91 -msgid "PyErr_Restore()" +msgid "PyErr_Restore (C function)" msgstr "" #: extending/newtypes.rst:150 diff --git a/faq/design.po b/faq/design.po index 7f13c343a..05690b57c 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -258,7 +258,7 @@ msgid "" "write() method." msgstr "" -#: faq/design.rst:207 +#: faq/design.rst:189 msgid "https://mail.python.org/pipermail/python-3000/2006-November/004643.html" msgstr "" @@ -596,8 +596,8 @@ msgid "" "differs by a single bit, could hash to ``1142331976``. The hash code is " "then used to calculate a location in an internal array where the value will " "be stored. Assuming that you're storing keys that all have different hash " -"values, this means that dictionaries take constant time -- O(1), in Big-O " -"notation -- to retrieve a key." +"values, this means that dictionaries take constant time -- *O*\\ (1), in Big-" +"O notation -- to retrieve a key." msgstr "" #: faq/design.rst:458 diff --git a/glossary.po b/glossary.po index 788d715f9..3a7ee51ee 100644 --- a/glossary.po +++ b/glossary.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: 2022-12-28 16:12-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -813,10 +813,11 @@ msgid "docstring" msgstr "belge dizisi" #: glossary.rst:351 +#, fuzzy msgid "" "A string literal which appears as the first expression in a class, function " "or module. While ignored when the suite is executed, it is recognized by " -"the compiler and put into the :attr:`__doc__` attribute of the enclosing " +"the compiler and put into the :attr:`!__doc__` attribute of the enclosing " "class, function or module. Since it is available via introspection, it is " "the canonical place for documentation of the object." msgstr "" @@ -1143,7 +1144,7 @@ msgstr "" "aracılığıyla çöp toplama gerçekleştirir. Çöp toplayıcı :mod:`gc` modülü " "kullanılarak kontrol edilebilir." -#: glossary.rst:492 +#: glossary.rst:493 msgid "generator" msgstr "jeneratör" @@ -1189,7 +1190,7 @@ msgstr "" "*jeneratör yineleyici* devam ettiğinde, kaldığı yerden devam eder (her " "çağrıda yeniden başlayan işlevlerin aksine)." -#: glossary.rst:513 +#: glossary.rst:514 msgid "generator expression" msgstr "jeneratör ifadesi" @@ -1735,10 +1736,11 @@ msgid "list" msgstr "liste" #: glossary.rst:742 +#, fuzzy msgid "" "A built-in Python :term:`sequence`. Despite its name it is more akin to an " "array in other languages than to a linked list since access to elements is " -"O(1)." +"*O*\\ (1)." msgstr "" "Yerleşik bir Python :term:`dizi`. Adına rağmen, öğelere erişim O(1) " "olduğundan, diğer dillerdeki bir diziye, bağlantılı bir listeden daha " @@ -1858,7 +1860,7 @@ msgstr "" msgid "More information can be found in :ref:`metaclasses`." msgstr "Daha fazla bilgi :ref:`metaclasses` içinde bulunabilir." -#: glossary.rst:1128 +#: glossary.rst:1130 msgid "method" msgstr "metot" @@ -2527,10 +2529,11 @@ msgstr "" msgid "" "The :class:`collections.abc.Sequence` abstract base class defines a much " "richer interface that goes beyond just :meth:`~object.__getitem__` and :meth:" -"`~object.__len__`, adding :meth:`count`, :meth:`index`, :meth:`~object." +"`~object.__len__`, adding :meth:`!count`, :meth:`!index`, :meth:`~object." "__contains__`, and :meth:`~object.__reversed__`. Types that implement this " "expanded interface can be registered explicitly using :func:`~abc.ABCMeta." -"register`." +"register`. For more documentation on sequence methods generally, see :ref:" +"`Common Sequence Operations `." msgstr "" ":class:`collections.abc.Sequence` soyut temel sınıfı;, :meth:`count`, :meth:" "`index`, :meth:`__contains__`, ve :meth:`__reversed__` ekleyerek sadece :" @@ -2538,11 +2541,11 @@ msgstr "" "arayüzü tanımlar. Bu genişletilmiş arabirimi uygulayan türler, :func:`~abc." "ABCMeta.register` kullanılarak açıkça kaydedilebilir." -#: glossary.rst:1110 +#: glossary.rst:1112 msgid "set comprehension" msgstr "anlamak" -#: glossary.rst:1112 +#: glossary.rst:1114 msgid "" "A compact way to process all or part of the elements in an iterable and " "return a set with the results. ``results = {c for c in 'abracadabra' if c " @@ -2554,11 +2557,11 @@ msgstr "" "for c in 'abracadabra' if c not in 'abc'}``, ``{'r', 'd'}`` dizelerini " "oluşturur. Bakınız :ref:`comprehensions`." -#: glossary.rst:1116 +#: glossary.rst:1118 msgid "single dispatch" msgstr "tek sevk" -#: glossary.rst:1118 +#: glossary.rst:1120 msgid "" "A form of :term:`generic function` dispatch where the implementation is " "chosen based on the type of a single argument." @@ -2566,11 +2569,11 @@ msgstr "" "Uygulamanın tek bir argüman türüne göre seçildiği bir :term:`generic " "function` gönderimi biçimi." -#: glossary.rst:1120 +#: glossary.rst:1122 msgid "slice" msgstr "parçalamak" -#: glossary.rst:1122 +#: glossary.rst:1124 msgid "" "An object usually containing a portion of a :term:`sequence`. A slice is " "created using the subscript notation, ``[]`` with colons between numbers " @@ -2583,11 +2586,11 @@ msgstr "" "gösterimi kullanılarak oluşturulur. Köşeli ayraç (alt simge) gösterimi, " "dahili olarak :class:`slice` nesnelerini kullanır." -#: glossary.rst:1126 +#: glossary.rst:1128 msgid "special method" msgstr "özel metod" -#: glossary.rst:1130 +#: glossary.rst:1132 msgid "" "A method that is called implicitly by Python to execute a certain operation " "on a type, such as addition. Such methods have names starting and ending " @@ -2599,11 +2602,11 @@ msgstr "" "çizgi ile başlayan ve biten adları vardır. Özel yöntemler :ref:" "`specialnames` içinde belgelenmiştir." -#: glossary.rst:1134 +#: glossary.rst:1136 msgid "statement" msgstr "ifade (değer döndürmez)" -#: glossary.rst:1136 +#: glossary.rst:1138 msgid "" "A statement is part of a suite (a \"block\" of code). A statement is either " "an :term:`expression` or one of several constructs with a keyword, such as :" @@ -2613,22 +2616,22 @@ msgstr "" "`expression` veya :keyword:`if`, :keyword:`while` veya :keyword:`for` gibi " "bir anahtar kelimeye sahip birkaç yapıdan biridir." -#: glossary.rst:1139 +#: glossary.rst:1141 msgid "static type checker" msgstr "" -#: glossary.rst:1141 +#: glossary.rst:1143 msgid "" "An external tool that reads Python code and analyzes it, looking for issues " "such as incorrect types. See also :term:`type hints ` and the :" "mod:`typing` module." msgstr "" -#: glossary.rst:1144 +#: glossary.rst:1146 msgid "strong reference" msgstr "güçlü referans" -#: glossary.rst:1146 +#: glossary.rst:1148 #, fuzzy msgid "" "In Python's C API, a strong reference is a reference to an object which is " @@ -2640,7 +2643,7 @@ msgstr "" "referans sayısını artıran ve silindiğinde nesnenin referans sayısını azaltan " "bir nesneye yapılan referanstır." -#: glossary.rst:1152 +#: glossary.rst:1154 msgid "" "The :c:func:`Py_NewRef` function can be used to create a strong reference to " "an object. Usually, the :c:func:`Py_DECREF` function must be called on the " @@ -2652,15 +2655,15 @@ msgstr "" "referansın sızmasını önlemek için güçlü referans kapsamından çıkmadan önce " "güçlü referansta çağrılmalıdır." -#: glossary.rst:1157 +#: glossary.rst:1159 msgid "See also :term:`borrowed reference`." msgstr "Ayrıca bkz. :term:`ödünç alınan referans `." -#: glossary.rst:1158 +#: glossary.rst:1160 msgid "text encoding" msgstr "yazı çözümleme" -#: glossary.rst:1160 +#: glossary.rst:1162 msgid "" "A string in Python is a sequence of Unicode code points (in range " "``U+0000``--``U+10FFFF``). To store or transfer a string, it needs to be " @@ -2670,7 +2673,7 @@ msgstr "" "``U+10FFFF`` aralığında). Bir dizeyi depolamak veya aktarmak için, bir bayt " "dizisi olarak seri hale getirilmesi gerekir." -#: glossary.rst:1164 +#: glossary.rst:1166 msgid "" "Serializing a string into a sequence of bytes is known as \"encoding\", and " "recreating the string from the sequence of bytes is known as \"decoding\"." @@ -2679,7 +2682,7 @@ msgstr "" "olarak bilinir ve dizeyi bayt dizisinden yeniden oluşturmak \"kod çözme " "(decoding)\" olarak bilinir." -#: glossary.rst:1167 +#: glossary.rst:1169 msgid "" "There are a variety of different text serialization :ref:`codecs `, which are collectively referred to as \"text encodings\"." @@ -2687,11 +2690,11 @@ msgstr "" "Toplu olarak \"metin kodlamaları\" olarak adlandırılan çeşitli farklı metin " "serileştirme :ref:`kodekleri ` vardır." -#: glossary.rst:1170 +#: glossary.rst:1172 msgid "text file" msgstr "yazı dosyası" -#: glossary.rst:1172 +#: glossary.rst:1174 msgid "" "A :term:`file object` able to read and write :class:`str` objects. Often, a " "text file actually accesses a byte-oriented datastream and handles the :term:" @@ -2705,7 +2708,7 @@ msgstr "" "metin modunda açılan dosyalar (``'r'`` veya ``'w'``), :data:`sys.stdin`, :" "data:`sys.stdout` ve :class:`io.StringIO` örnekleri verilebilir." -#: glossary.rst:1179 +#: glossary.rst:1181 msgid "" "See also :term:`binary file` for a file object able to read and write :term:" "`bytes-like objects `." @@ -2713,11 +2716,11 @@ msgstr "" "Ayrıca :term:`ikili dosyaları ` okuyabilen ve yazabilen bir " "dosya nesnesi için :term:`bayt benzeri nesnelere ` bakın." -#: glossary.rst:1181 +#: glossary.rst:1183 msgid "triple-quoted string" msgstr "üç tırnaklı dize" -#: glossary.rst:1183 +#: glossary.rst:1185 msgid "" "A string which is bound by three instances of either a quotation mark (\") " "or an apostrophe ('). While they don't provide any functionality not " @@ -2734,11 +2737,11 @@ msgstr "" "yayılabilir, bu da onları özellikle belge dizileri yazarken kullanışlı hale " "getirir." -#: glossary.rst:1190 +#: glossary.rst:1192 msgid "type" msgstr "tip" -#: glossary.rst:1192 +#: glossary.rst:1194 msgid "" "The type of a Python object determines what kind of object it is; every " "object has a type. An object's type is accessible as its :attr:`~instance." @@ -2748,15 +2751,15 @@ msgstr "" "nesnenin bir türü vardır. Bir nesnenin tipine :attr:`~instance.__class__` " "niteliği ile erişilebilir veya ``type(obj)`` ile alınabilir." -#: glossary.rst:1196 +#: glossary.rst:1198 msgid "type alias" msgstr "tip takma adı" -#: glossary.rst:1198 +#: glossary.rst:1200 msgid "A synonym for a type, created by assigning the type to an identifier." msgstr "Bir tanımlayıcıya tür atanarak oluşturulan, bir tür için eş anlamlı." -#: glossary.rst:1200 +#: glossary.rst:1202 msgid "" "Type aliases are useful for simplifying :term:`type hints `. For " "example::" @@ -2764,19 +2767,19 @@ msgstr "" "Tür takma adları, :term:`tür ipuçlarını ` basitleştirmek için " "kullanışlıdır. Örneğin::" -#: glossary.rst:1207 +#: glossary.rst:1209 msgid "could be made more readable like this::" msgstr "bu şekilde daha okunaklı hale getirilebilir::" -#: glossary.rst:1228 +#: glossary.rst:1230 msgid "See :mod:`typing` and :pep:`484`, which describe this functionality." msgstr "Bu işlevi açıklayan :mod:`typing` ve :pep:`484` bölümlerine bakın." -#: glossary.rst:1215 +#: glossary.rst:1217 msgid "type hint" msgstr "tür ipucu" -#: glossary.rst:1217 +#: glossary.rst:1219 msgid "" "An :term:`annotation` that specifies the expected type for a variable, a " "class attribute, or a function parameter or return value." @@ -2784,7 +2787,7 @@ msgstr "" "Bir değişken, bir sınıf niteliği veya bir işlev parametresi veya dönüş " "değeri için beklenen türü belirten bir :term:`ek açıklama `." -#: glossary.rst:1220 +#: glossary.rst:1222 #, fuzzy msgid "" "Type hints are optional and are not enforced by Python but they are useful " @@ -2795,7 +2798,7 @@ msgstr "" "statik tip analiz araçları için faydalıdır ve kod tamamlama ve yeniden " "düzenleme ile IDE'lere yardımcı olur." -#: glossary.rst:1224 +#: glossary.rst:1226 msgid "" "Type hints of global variables, class attributes, and functions, but not " "local variables, can be accessed using :func:`typing.get_type_hints`." @@ -2804,11 +2807,11 @@ msgstr "" "yerel değişkenlere değil, :func:`typing.get_type_hints` kullanılarak " "erişilebilir." -#: glossary.rst:1229 +#: glossary.rst:1231 msgid "universal newlines" msgstr "evrensel yeni satırlar" -#: glossary.rst:1231 +#: glossary.rst:1233 msgid "" "A manner of interpreting text streams in which all of the following are " "recognized as ending a line: the Unix end-of-line convention ``'\\n'``, the " @@ -2821,23 +2824,23 @@ msgstr "" "kuralı ``'\\r\\n'``, ve eski Macintosh kuralı ``'\\r'``. Ek bir kullanım " "için :pep:`278` ve :pep:`3116` ve ayrıca :func:`bytes.splitlines` bakın." -#: glossary.rst:1236 +#: glossary.rst:1238 msgid "variable annotation" msgstr "değişken açıklama" -#: glossary.rst:1238 +#: glossary.rst:1240 msgid "An :term:`annotation` of a variable or a class attribute." msgstr "" "Bir değişkenin veya bir sınıf özniteliğinin :term:`ek açıklaması " "`." -#: glossary.rst:1240 +#: glossary.rst:1242 msgid "" "When annotating a variable or a class attribute, assignment is optional::" msgstr "" "Bir değişkene veya sınıf niteliğine açıklama eklerken atama isteğe bağlıdır::" -#: glossary.rst:1245 +#: glossary.rst:1247 msgid "" "Variable annotations are usually used for :term:`type hints `: " "for example this variable is expected to take :class:`int` values::" @@ -2845,11 +2848,11 @@ msgstr "" "Değişken açıklamaları genellikle :term:`tür ipuçları ` için " "kullanılır: örneğin, bu değişkenin :class:`int` değerlerini alması beklenir::" -#: glossary.rst:1251 +#: glossary.rst:1253 msgid "Variable annotation syntax is explained in section :ref:`annassign`." msgstr "Değişken açıklama sözdizimi :ref:`annassign` bölümünde açıklanmıştır." -#: glossary.rst:1253 +#: glossary.rst:1255 msgid "" "See :term:`function annotation`, :pep:`484` and :pep:`526`, which describe " "this functionality. Also see :ref:`annotations-howto` for best practices on " @@ -2859,11 +2862,11 @@ msgstr "" "bölümlerine bakın. Ek açıklamalarla çalışmaya ilişkin en iyi uygulamalar " "için ayrıca bkz. :ref:`annotations-howto`." -#: glossary.rst:1257 +#: glossary.rst:1259 msgid "virtual environment" msgstr "sanal ortam" -#: glossary.rst:1259 +#: glossary.rst:1261 msgid "" "A cooperatively isolated runtime environment that allows Python users and " "applications to install and upgrade Python distribution packages without " @@ -2875,15 +2878,15 @@ msgstr "" "paketlerini kurmasına ve yükseltmesine olanak tanıyan, işbirliği içinde " "yalıtılmış bir çalışma zamanı ortamı." -#: glossary.rst:1264 +#: glossary.rst:1266 msgid "See also :mod:`venv`." msgstr "Ayrıca bakınız :mod:`venv`." -#: glossary.rst:1265 +#: glossary.rst:1267 msgid "virtual machine" msgstr "sanal makine" -#: glossary.rst:1267 +#: glossary.rst:1269 msgid "" "A computer defined entirely in software. Python's virtual machine executes " "the :term:`bytecode` emitted by the bytecode compiler." @@ -2891,11 +2894,11 @@ msgstr "" "Tamamen yazılımla tanımlanmış bir bilgisayar. Python'un sanal makinesi, bayt " "kodu derleyicisi tarafından yayınlanan :term:`bytecode` 'u çalıştırır." -#: glossary.rst:1269 +#: glossary.rst:1271 msgid "Zen of Python" msgstr "Python'un Zen'i" -#: glossary.rst:1271 +#: glossary.rst:1273 msgid "" "Listing of Python design principles and philosophies that are helpful in " "understanding and using the language. The listing can be found by typing " @@ -2919,7 +2922,7 @@ msgstr "bitişik" msgid "magic" msgstr "" -#: glossary.rst:1128 +#: glossary.rst:1130 #, fuzzy msgid "special" msgstr "özel metod" diff --git a/howto/annotations.po b/howto/annotations.po index 359dc2d39..51524b21a 100644 --- a/howto/annotations.po +++ b/howto/annotations.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -28,7 +28,7 @@ msgstr "" msgid "Larry Hastings" msgstr "" -#: howto/annotations.rst:None +#: howto/annotations.rst:-1 msgid "Abstract" msgstr "" diff --git a/howto/curses.po b/howto/curses.po index 174ea27a7..8989e3296 100644 --- a/howto/curses.po +++ b/howto/curses.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -36,7 +36,7 @@ msgstr "" msgid "2.04" msgstr "" -#: howto/curses.rst:None +#: howto/curses.rst:-1 msgid "Abstract" msgstr "" diff --git a/howto/descriptor.po b/howto/descriptor.po index 7b94225f7..e58e71d0d 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+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" #: howto/descriptor.rst:5 -msgid "Descriptor HowTo Guide" +msgid "Descriptor Guide" msgstr "" #: howto/descriptor.rst:0 diff --git a/howto/ipaddress.po b/howto/ipaddress.po index e81fa55b2..3814e1cb0 100644 --- a/howto/ipaddress.po +++ b/howto/ipaddress.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -32,7 +32,7 @@ msgstr "" msgid "Nick Coghlan" msgstr "" -#: howto/ipaddress.rst:None +#: howto/ipaddress.rst:-1 msgid "Overview" msgstr "" diff --git a/howto/isolating-extensions.po b/howto/isolating-extensions.po index 6f730087a..a586729cb 100644 --- a/howto/isolating-extensions.po +++ b/howto/isolating-extensions.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+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 "Isolating Extension Modules" msgstr "" -#: howto/isolating-extensions.rst:None +#: howto/isolating-extensions.rst:-1 msgid "Abstract" msgstr "" diff --git a/howto/logging-cookbook.po b/howto/logging-cookbook.po index 236148216..6db77fcf0 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: 2023-10-01 00:18+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -922,17 +922,17 @@ msgid "" "effect to the above, as in the following example::" msgstr "" -#: howto/logging-cookbook.rst:1764 +#: howto/logging-cookbook.rst:1762 msgid "" "The above script should log the message ``Hello, world!`` when run with " -"Python 3.2 or later." +"Python 3.8 or later." msgstr "" -#: howto/logging-cookbook.rst:1773 +#: howto/logging-cookbook.rst:1771 msgid "Customizing ``LogRecord``" msgstr "" -#: howto/logging-cookbook.rst:1775 +#: howto/logging-cookbook.rst:1773 msgid "" "Every logging event is represented by a :class:`LogRecord` instance. When an " "event is logged and not filtered out by a logger's level, a :class:" @@ -943,13 +943,13 @@ msgid "" "was done:" msgstr "" -#: howto/logging-cookbook.rst:1782 +#: howto/logging-cookbook.rst:1780 msgid "" ":meth:`Logger.makeRecord`, which is called in the normal process of logging " "an event. This invoked :class:`LogRecord` directly to create an instance." msgstr "" -#: howto/logging-cookbook.rst:1785 +#: howto/logging-cookbook.rst:1783 msgid "" ":func:`makeLogRecord`, which is called with a dictionary containing " "attributes to be added to the LogRecord. This is typically invoked when a " @@ -958,27 +958,27 @@ msgid "" "`~handlers.HTTPHandler`)." msgstr "" -#: howto/logging-cookbook.rst:1791 +#: howto/logging-cookbook.rst:1789 msgid "" "This has usually meant that if you need to do anything special with a :class:" "`LogRecord`, you've had to do one of the following." msgstr "" -#: howto/logging-cookbook.rst:1794 +#: howto/logging-cookbook.rst:1792 msgid "" "Create your own :class:`Logger` subclass, which overrides :meth:`Logger." "makeRecord`, and set it using :func:`~logging.setLoggerClass` before any " "loggers that you care about are instantiated." msgstr "" -#: howto/logging-cookbook.rst:1797 +#: howto/logging-cookbook.rst:1795 msgid "" "Add a :class:`Filter` to a logger or handler, which does the necessary " "special manipulation you need when its :meth:`~Filter.filter` method is " "called." msgstr "" -#: howto/logging-cookbook.rst:1801 +#: howto/logging-cookbook.rst:1799 msgid "" "The first approach would be a little unwieldy in the scenario where (say) " "several different libraries wanted to do different things. Each would " @@ -986,7 +986,7 @@ msgid "" "last would win." msgstr "" -#: howto/logging-cookbook.rst:1806 +#: howto/logging-cookbook.rst:1804 msgid "" "The second approach works reasonably well for many cases, but does not allow " "you to e.g. use a specialized subclass of :class:`LogRecord`. Library " @@ -995,7 +995,7 @@ msgid "" "would do simply by adding new packages or modules and doing ::" msgstr "" -#: howto/logging-cookbook.rst:1814 +#: howto/logging-cookbook.rst:1812 msgid "" "at module level). It's probably one too many things to think about. " "Developers could also add the filter to a :class:`~logging.NullHandler` " @@ -1005,7 +1005,7 @@ msgid "" "developer." msgstr "" -#: howto/logging-cookbook.rst:1820 +#: howto/logging-cookbook.rst:1818 msgid "" "In Python 3.2 and later, :class:`~logging.LogRecord` creation is done " "through a factory, which you can specify. The factory is just a callable you " @@ -1015,7 +1015,7 @@ msgid "" "`LogRecord` is the default setting for the factory." msgstr "" -#: howto/logging-cookbook.rst:1827 +#: howto/logging-cookbook.rst:1825 msgid "" "This approach allows a custom factory to control all aspects of LogRecord " "creation. For example, you could return a subclass, or just add some " @@ -1023,7 +1023,7 @@ msgid "" "this::" msgstr "" -#: howto/logging-cookbook.rst:1840 +#: howto/logging-cookbook.rst:1838 msgid "" "This pattern allows different libraries to chain factories together, and as " "long as they don't overwrite each other's attributes or unintentionally " @@ -1033,70 +1033,70 @@ msgid "" "used when the use of a :class:`Filter` does not provide the desired result." msgstr "" -#: howto/logging-cookbook.rst:1852 +#: howto/logging-cookbook.rst:1850 msgid "Subclassing QueueHandler - a ZeroMQ example" msgstr "" -#: howto/logging-cookbook.rst:1854 +#: howto/logging-cookbook.rst:1852 msgid "" "You can use a :class:`QueueHandler` subclass to send messages to other kinds " "of queues, for example a ZeroMQ 'publish' socket. In the example below,the " "socket is created separately and passed to the handler (as its 'queue')::" msgstr "" -#: howto/logging-cookbook.rst:1873 +#: howto/logging-cookbook.rst:1871 msgid "" "Of course there are other ways of organizing this, for example passing in " "the data needed by the handler to create the socket::" msgstr "" -#: howto/logging-cookbook.rst:1891 +#: howto/logging-cookbook.rst:1889 msgid "Subclassing QueueListener - a ZeroMQ example" msgstr "" -#: howto/logging-cookbook.rst:1893 +#: howto/logging-cookbook.rst:1891 msgid "" "You can also subclass :class:`QueueListener` to get messages from other " "kinds of queues, for example a ZeroMQ 'subscribe' socket. Here's an example::" msgstr "" -#: howto/logging-cookbook.rst:1912 howto/logging-cookbook.rst:3955 +#: howto/logging-cookbook.rst:1910 howto/logging-cookbook.rst:3950 msgid "Module :mod:`logging`" msgstr "" -#: howto/logging-cookbook.rst:1912 howto/logging-cookbook.rst:3955 +#: howto/logging-cookbook.rst:1910 howto/logging-cookbook.rst:3950 msgid "API reference for the logging module." msgstr "" -#: howto/logging-cookbook.rst:1915 howto/logging-cookbook.rst:3958 +#: howto/logging-cookbook.rst:1913 howto/logging-cookbook.rst:3953 msgid "Module :mod:`logging.config`" msgstr "" -#: howto/logging-cookbook.rst:1915 howto/logging-cookbook.rst:3958 +#: howto/logging-cookbook.rst:1913 howto/logging-cookbook.rst:3953 msgid "Configuration API for the logging module." msgstr "" -#: howto/logging-cookbook.rst:1918 howto/logging-cookbook.rst:3961 +#: howto/logging-cookbook.rst:1916 howto/logging-cookbook.rst:3956 msgid "Module :mod:`logging.handlers`" msgstr "" -#: howto/logging-cookbook.rst:1918 howto/logging-cookbook.rst:3961 +#: howto/logging-cookbook.rst:1916 howto/logging-cookbook.rst:3956 msgid "Useful handlers included with the logging module." msgstr "" -#: howto/logging-cookbook.rst:1920 +#: howto/logging-cookbook.rst:1918 msgid ":ref:`A basic logging tutorial `" msgstr "" -#: howto/logging-cookbook.rst:1922 +#: howto/logging-cookbook.rst:1920 msgid ":ref:`A more advanced logging tutorial `" msgstr "" -#: howto/logging-cookbook.rst:1928 +#: howto/logging-cookbook.rst:1926 msgid "An example dictionary-based configuration" msgstr "" -#: howto/logging-cookbook.rst:1930 +#: howto/logging-cookbook.rst:1928 msgid "" "Below is an example of a logging configuration dictionary - it's taken from " "the `documentation on the Django project `_ of the Django documentation." msgstr "" -#: howto/logging-cookbook.rst:1993 +#: howto/logging-cookbook.rst:1988 msgid "Using a rotator and namer to customize log rotation processing" msgstr "" -#: howto/logging-cookbook.rst:1995 +#: howto/logging-cookbook.rst:1990 msgid "" "An example of how you can define a namer and rotator is given in the " "following runnable script, which shows gzip compression of the log file::" msgstr "" -#: howto/logging-cookbook.rst:2026 +#: howto/logging-cookbook.rst:2021 msgid "" "After running this, you will see six new files, five of which are compressed:" msgstr "" -#: howto/logging-cookbook.rst:2039 +#: howto/logging-cookbook.rst:2034 msgid "A more elaborate multiprocessing example" msgstr "" -#: howto/logging-cookbook.rst:2041 +#: howto/logging-cookbook.rst:2036 msgid "" "The following working example shows how logging can be used with " "multiprocessing using configuration files. The configurations are fairly " @@ -1138,7 +1138,7 @@ msgid "" "in a real multiprocessing scenario." msgstr "" -#: howto/logging-cookbook.rst:2046 +#: howto/logging-cookbook.rst:2041 msgid "" "In the example, the main process spawns a listener process and some worker " "processes. Each of the main process, the listener and the workers have three " @@ -1151,17 +1151,17 @@ msgid "" "own scenario." msgstr "" -#: howto/logging-cookbook.rst:2056 +#: howto/logging-cookbook.rst:2051 msgid "" "Here's the script - the docstrings and the comments hopefully explain how it " "works::" msgstr "" -#: howto/logging-cookbook.rst:2268 +#: howto/logging-cookbook.rst:2263 msgid "Inserting a BOM into messages sent to a SysLogHandler" msgstr "" -#: howto/logging-cookbook.rst:2270 +#: howto/logging-cookbook.rst:2265 msgid "" ":rfc:`5424` requires that a Unicode message be sent to a syslog daemon as a " "set of bytes which have the following structure: an optional pure-ASCII " @@ -1170,7 +1170,7 @@ msgid "" "<5424#section-6>`.)" msgstr "" -#: howto/logging-cookbook.rst:2276 +#: howto/logging-cookbook.rst:2271 msgid "" "In Python 3.1, code was added to :class:`~logging.handlers.SysLogHandler` to " "insert a BOM into the message, but unfortunately, it was implemented " @@ -1178,7 +1178,7 @@ msgid "" "hence not allowing any pure-ASCII component to appear before it." msgstr "" -#: howto/logging-cookbook.rst:2282 +#: howto/logging-cookbook.rst:2277 msgid "" "As this behaviour is broken, the incorrect BOM insertion code is being " "removed from Python 3.2.4 and later. However, it is not being replaced, and " @@ -1187,33 +1187,33 @@ msgid "" "encoded using UTF-8, then you need to do the following:" msgstr "" -#: howto/logging-cookbook.rst:2288 +#: howto/logging-cookbook.rst:2283 msgid "" "Attach a :class:`~logging.Formatter` instance to your :class:`~logging." "handlers.SysLogHandler` instance, with a format string such as::" msgstr "" -#: howto/logging-cookbook.rst:2294 +#: howto/logging-cookbook.rst:2289 msgid "" "The Unicode code point U+FEFF, when encoded using UTF-8, will be encoded as " "a UTF-8 BOM -- the byte-string ``b'\\xef\\xbb\\xbf'``." msgstr "" -#: howto/logging-cookbook.rst:2297 +#: howto/logging-cookbook.rst:2292 msgid "" "Replace the ASCII section with whatever placeholders you like, but make sure " "that the data that appears in there after substitution is always ASCII (that " "way, it will remain unchanged after UTF-8 encoding)." msgstr "" -#: howto/logging-cookbook.rst:2301 +#: howto/logging-cookbook.rst:2296 msgid "" "Replace the Unicode section with whatever placeholders you like; if the data " "which appears there after substitution contains characters outside the ASCII " "range, that's fine -- it will be encoded using UTF-8." msgstr "" -#: howto/logging-cookbook.rst:2305 +#: howto/logging-cookbook.rst:2300 msgid "" "The formatted message *will* be encoded using UTF-8 encoding by " "``SysLogHandler``. If you follow the above rules, you should be able to " @@ -1222,11 +1222,11 @@ msgid "" "daemon may complain." msgstr "" -#: howto/logging-cookbook.rst:2312 +#: howto/logging-cookbook.rst:2307 msgid "Implementing structured logging" msgstr "" -#: howto/logging-cookbook.rst:2314 +#: howto/logging-cookbook.rst:2309 msgid "" "Although most logging messages are intended for reading by humans, and thus " "not readily machine-parseable, there might be circumstances where you want " @@ -1238,31 +1238,31 @@ msgid "" "machine-parseable manner::" msgstr "" -#: howto/logging-cookbook.rst:2338 +#: howto/logging-cookbook.rst:2333 msgid "If the above script is run, it prints:" msgstr "" -#: howto/logging-cookbook.rst:2344 howto/logging-cookbook.rst:2386 +#: howto/logging-cookbook.rst:2339 howto/logging-cookbook.rst:2381 msgid "" "Note that the order of items might be different according to the version of " "Python used." msgstr "" -#: howto/logging-cookbook.rst:2347 +#: howto/logging-cookbook.rst:2342 msgid "" "If you need more specialised processing, you can use a custom JSON encoder, " "as in the following complete example::" msgstr "" -#: howto/logging-cookbook.rst:2380 +#: howto/logging-cookbook.rst:2375 msgid "When the above script is run, it prints:" msgstr "" -#: howto/logging-cookbook.rst:2395 +#: howto/logging-cookbook.rst:2390 msgid "Customizing handlers with :func:`dictConfig`" msgstr "" -#: howto/logging-cookbook.rst:2397 +#: howto/logging-cookbook.rst:2392 msgid "" "There are times when you want to customize logging handlers in particular " "ways, and if you use :func:`dictConfig` you may be able to do this without " @@ -1272,24 +1272,24 @@ msgid "" "customize handler creation using a plain function such as::" msgstr "" -#: howto/logging-cookbook.rst:2411 +#: howto/logging-cookbook.rst:2406 msgid "" "You can then specify, in a logging configuration passed to :func:" "`dictConfig`, that a logging handler be created by calling this function::" msgstr "" -#: howto/logging-cookbook.rst:2444 +#: howto/logging-cookbook.rst:2439 msgid "" "In this example I am setting the ownership using the ``pulse`` user and " "group, just for the purposes of illustration. Putting it together into a " "working script, ``chowntest.py``::" msgstr "" -#: howto/logging-cookbook.rst:2491 +#: howto/logging-cookbook.rst:2486 msgid "To run this, you will probably need to run as ``root``:" msgstr "" -#: howto/logging-cookbook.rst:2501 +#: howto/logging-cookbook.rst:2496 msgid "" "Note that this example uses Python 3.3 because that's where :func:`shutil." "chown` makes an appearance. This approach should work with any Python " @@ -1298,17 +1298,17 @@ msgid "" "change using e.g. :func:`os.chown`." msgstr "" -#: howto/logging-cookbook.rst:2507 +#: howto/logging-cookbook.rst:2502 msgid "" "In practice, the handler-creating function may be in a utility module " "somewhere in your project. Instead of the line in the configuration::" msgstr "" -#: howto/logging-cookbook.rst:2512 +#: howto/logging-cookbook.rst:2507 msgid "you could use e.g.::" msgstr "" -#: howto/logging-cookbook.rst:2516 +#: howto/logging-cookbook.rst:2511 msgid "" "where ``project.util`` can be replaced with the actual name of the package " "where the function resides. In the above working script, using ``'ext://" @@ -1316,25 +1316,25 @@ msgid "" "resolved by :func:`dictConfig` from the ``ext://`` specification." msgstr "" -#: howto/logging-cookbook.rst:2521 +#: howto/logging-cookbook.rst:2516 msgid "" "This example hopefully also points the way to how you could implement other " "types of file change - e.g. setting specific POSIX permission bits - in the " "same way, using :func:`os.chmod`." msgstr "" -#: howto/logging-cookbook.rst:2525 +#: howto/logging-cookbook.rst:2520 msgid "" "Of course, the approach could also be extended to types of handler other " "than a :class:`~logging.FileHandler` - for example, one of the rotating file " "handlers, or a different type of handler altogether." msgstr "" -#: howto/logging-cookbook.rst:2535 +#: howto/logging-cookbook.rst:2530 msgid "Using particular formatting styles throughout your application" msgstr "" -#: howto/logging-cookbook.rst:2537 +#: howto/logging-cookbook.rst:2532 msgid "" "In Python 3.2, the :class:`~logging.Formatter` gained a ``style`` keyword " "parameter which, while defaulting to ``%`` for backward compatibility, " @@ -1345,7 +1345,7 @@ msgid "" "is constructed." msgstr "" -#: howto/logging-cookbook.rst:2544 +#: howto/logging-cookbook.rst:2539 msgid "" "Logging calls (:meth:`~Logger.debug`, :meth:`~Logger.info` etc.) only take " "positional parameters for the actual logging message itself, with keyword " @@ -1360,7 +1360,7 @@ msgid "" "calls which are out there in existing code will be using %-format strings." msgstr "" -#: howto/logging-cookbook.rst:2556 +#: howto/logging-cookbook.rst:2551 msgid "" "There have been suggestions to associate format styles with specific " "loggers, but that approach also runs into backward compatibility problems " @@ -1368,7 +1368,7 @@ msgid "" "formatting." msgstr "" -#: howto/logging-cookbook.rst:2560 +#: howto/logging-cookbook.rst:2555 msgid "" "For logging to work interoperably between any third-party libraries and your " "code, decisions about formatting need to be made at the level of the " @@ -1376,11 +1376,11 @@ msgid "" "formatting styles can be accommodated." msgstr "" -#: howto/logging-cookbook.rst:2567 +#: howto/logging-cookbook.rst:2562 msgid "Using LogRecord factories" msgstr "" -#: howto/logging-cookbook.rst:2569 +#: howto/logging-cookbook.rst:2564 msgid "" "In Python 3.2, along with the :class:`~logging.Formatter` changes mentioned " "above, the logging package gained the ability to allow users to set their " @@ -1395,17 +1395,17 @@ msgid "" "implementation does." msgstr "" -#: howto/logging-cookbook.rst:2580 +#: howto/logging-cookbook.rst:2575 msgid "" "Refer to the reference documentation on :func:`setLogRecordFactory` and :" "class:`LogRecord` for more information." msgstr "" -#: howto/logging-cookbook.rst:2585 +#: howto/logging-cookbook.rst:2580 msgid "Using custom message objects" msgstr "" -#: howto/logging-cookbook.rst:2587 +#: howto/logging-cookbook.rst:2582 msgid "" "There is another, perhaps simpler way that you can use {}- and $- formatting " "to construct your individual log messages. You may recall (from :ref:" @@ -1415,7 +1415,7 @@ msgid "" "following two classes::" msgstr "" -#: howto/logging-cookbook.rst:2612 +#: howto/logging-cookbook.rst:2607 msgid "" "Either of these can be used in place of a format string, to allow {}- or $-" "formatting to be used to build the actual \"message\" part which appears in " @@ -1426,17 +1426,17 @@ msgid "" "using ``_`` for localization)." msgstr "" -#: howto/logging-cookbook.rst:2620 +#: howto/logging-cookbook.rst:2615 msgid "" "Examples of this approach are given below. Firstly, formatting with :meth:" "`str.format`::" msgstr "" -#: howto/logging-cookbook.rst:2634 +#: howto/logging-cookbook.rst:2629 msgid "Secondly, formatting with :class:`string.Template`::" msgstr "" -#: howto/logging-cookbook.rst:2641 +#: howto/logging-cookbook.rst:2636 msgid "" "One thing to note is that you pay no significant performance penalty with " "this approach: the actual formatting happens not when you make the logging " @@ -1448,11 +1448,11 @@ msgid "" "shown above." msgstr "" -#: howto/logging-cookbook.rst:2655 +#: howto/logging-cookbook.rst:2650 msgid "Configuring filters with :func:`dictConfig`" msgstr "" -#: howto/logging-cookbook.rst:2657 +#: howto/logging-cookbook.rst:2652 msgid "" "You *can* configure filters using :func:`~logging.config.dictConfig`, though " "it might not be obvious at first glance how to do it (hence this recipe). " @@ -1467,22 +1467,22 @@ msgid "" "complete example::" msgstr "" -#: howto/logging-cookbook.rst:2710 +#: howto/logging-cookbook.rst:2705 msgid "" "This example shows how you can pass configuration data to the callable which " "constructs the instance, in the form of keyword parameters. When run, the " "above script will print:" msgstr "" -#: howto/logging-cookbook.rst:2718 +#: howto/logging-cookbook.rst:2713 msgid "which shows that the filter is working as configured." msgstr "" -#: howto/logging-cookbook.rst:2720 +#: howto/logging-cookbook.rst:2715 msgid "A couple of extra points to note:" msgstr "" -#: howto/logging-cookbook.rst:2722 +#: howto/logging-cookbook.rst:2717 msgid "" "If you can't refer to the callable directly in the configuration (e.g. if it " "lives in a different module, and you can't import it directly where the " @@ -1492,7 +1492,7 @@ msgid "" "the above example." msgstr "" -#: howto/logging-cookbook.rst:2729 +#: howto/logging-cookbook.rst:2724 msgid "" "As well as for filters, this technique can also be used to configure custom " "handlers and formatters. See :ref:`logging-config-dict-userdef` for more " @@ -1501,11 +1501,11 @@ msgid "" "above." msgstr "" -#: howto/logging-cookbook.rst:2738 +#: howto/logging-cookbook.rst:2733 msgid "Customized exception formatting" msgstr "" -#: howto/logging-cookbook.rst:2740 +#: howto/logging-cookbook.rst:2735 msgid "" "There might be times when you want to do customized exception formatting - " "for argument's sake, let's say you want exactly one line per logged event, " @@ -1513,22 +1513,22 @@ msgid "" "formatter class, as shown in the following example::" msgstr "" -#: howto/logging-cookbook.rst:2781 +#: howto/logging-cookbook.rst:2776 msgid "When run, this produces a file with exactly two lines:" msgstr "" -#: howto/logging-cookbook.rst:2788 +#: howto/logging-cookbook.rst:2783 msgid "" "While the above treatment is simplistic, it points the way to how exception " "information can be formatted to your liking. The :mod:`traceback` module may " "be helpful for more specialized needs." msgstr "" -#: howto/logging-cookbook.rst:2795 +#: howto/logging-cookbook.rst:2790 msgid "Speaking logging messages" msgstr "" -#: howto/logging-cookbook.rst:2797 +#: howto/logging-cookbook.rst:2792 msgid "" "There might be situations when it is desirable to have logging messages " "rendered in an audible rather than a visible format. This is easy to do if " @@ -1545,24 +1545,24 @@ msgid "" "approach, which assumes that the ``espeak`` TTS package is available::" msgstr "" -#: howto/logging-cookbook.rst:2839 +#: howto/logging-cookbook.rst:2834 msgid "" "When run, this script should say \"Hello\" and then \"Goodbye\" in a female " "voice." msgstr "" -#: howto/logging-cookbook.rst:2841 +#: howto/logging-cookbook.rst:2836 msgid "" "The above approach can, of course, be adapted to other TTS systems and even " "other systems altogether which can process messages via external programs " "run from a command line." msgstr "" -#: howto/logging-cookbook.rst:2849 +#: howto/logging-cookbook.rst:2844 msgid "Buffering logging messages and outputting them conditionally" msgstr "" -#: howto/logging-cookbook.rst:2851 +#: howto/logging-cookbook.rst:2846 msgid "" "There might be situations where you want to log messages in a temporary area " "and only output them if a certain condition occurs. For example, you may " @@ -1572,7 +1572,7 @@ msgid "" "debug information to be output as well as the error." msgstr "" -#: howto/logging-cookbook.rst:2858 +#: howto/logging-cookbook.rst:2853 msgid "" "Here is an example which shows how you could do this using a decorator for " "your functions where you want logging to behave this way. It makes use of " @@ -1585,7 +1585,7 @@ msgid "" "subclass of ``MemoryHandler`` if you want custom flushing behavior." msgstr "" -#: howto/logging-cookbook.rst:2868 +#: howto/logging-cookbook.rst:2863 msgid "" "The example script has a simple function, ``foo``, which just cycles through " "all the logging levels, writing to ``sys.stderr`` to say what level it's " @@ -1594,7 +1594,7 @@ msgid "" "levels - otherwise, it only logs at DEBUG, INFO and WARNING levels." msgstr "" -#: howto/logging-cookbook.rst:2874 +#: howto/logging-cookbook.rst:2869 msgid "" "The script just arranges to decorate ``foo`` with a decorator which will do " "the conditional logging that's required. The decorator takes a logger as a " @@ -1606,30 +1606,30 @@ msgid "" "respectively." msgstr "" -#: howto/logging-cookbook.rst:2882 +#: howto/logging-cookbook.rst:2877 msgid "Here's the script::" msgstr "" -#: howto/logging-cookbook.rst:2945 +#: howto/logging-cookbook.rst:2940 msgid "When this script is run, the following output should be observed:" msgstr "" -#: howto/logging-cookbook.rst:2975 +#: howto/logging-cookbook.rst:2970 msgid "" "As you can see, actual logging output only occurs when an event is logged " "whose severity is ERROR or greater, but in that case, any previous events at " "lower severities are also logged." msgstr "" -#: howto/logging-cookbook.rst:2979 +#: howto/logging-cookbook.rst:2974 msgid "You can of course use the conventional means of decoration::" msgstr "" -#: howto/logging-cookbook.rst:2989 +#: howto/logging-cookbook.rst:2984 msgid "Sending logging messages to email, with buffering" msgstr "" -#: howto/logging-cookbook.rst:2991 +#: howto/logging-cookbook.rst:2986 msgid "" "To illustrate how you can send log messages via email, so that a set number " "of messages are sent per email, you can subclass :class:`~logging.handlers." @@ -1640,7 +1640,7 @@ msgid "" "argument to see the required and optional arguments.)" msgstr "" -#: howto/logging-cookbook.rst:3063 +#: howto/logging-cookbook.rst:3058 msgid "" "If you run this script and your SMTP server is correctly set up, you should " "find that it sends eleven emails to the addressee you specify. The first ten " @@ -1648,17 +1648,17 @@ msgid "" "messages. That makes up 102 messages as specified in the script." msgstr "" -#: howto/logging-cookbook.rst:3071 +#: howto/logging-cookbook.rst:3066 msgid "Formatting times using UTC (GMT) via configuration" msgstr "" -#: howto/logging-cookbook.rst:3073 +#: howto/logging-cookbook.rst:3068 msgid "" "Sometimes you want to format times using UTC, which can be done using a " "class such as ``UTCFormatter``, shown below::" msgstr "" -#: howto/logging-cookbook.rst:3082 +#: howto/logging-cookbook.rst:3077 msgid "" "and you can then use the ``UTCFormatter`` in your code instead of :class:" "`~logging.Formatter`. If you want to do that via configuration, you can use " @@ -1666,21 +1666,21 @@ msgid "" "the following complete example::" msgstr "" -#: howto/logging-cookbook.rst:3125 +#: howto/logging-cookbook.rst:3120 msgid "When this script is run, it should print something like:" msgstr "" -#: howto/logging-cookbook.rst:3132 +#: howto/logging-cookbook.rst:3127 msgid "" "showing how the time is formatted both as local time and UTC, one for each " "handler." msgstr "" -#: howto/logging-cookbook.rst:3139 +#: howto/logging-cookbook.rst:3134 msgid "Using a context manager for selective logging" msgstr "" -#: howto/logging-cookbook.rst:3141 +#: howto/logging-cookbook.rst:3136 msgid "" "There are times when it would be useful to temporarily change the logging " "configuration and revert it back after doing something. For this, a context " @@ -1690,7 +1690,7 @@ msgid "" "scope of the context manager::" msgstr "" -#: howto/logging-cookbook.rst:3174 +#: howto/logging-cookbook.rst:3169 msgid "" "If you specify a level value, the logger's level is set to that value in the " "scope of the with block covered by the context manager. If you specify a " @@ -1699,13 +1699,13 @@ msgid "" "block exit - you could do this if you don't need the handler any more." msgstr "" -#: howto/logging-cookbook.rst:3180 +#: howto/logging-cookbook.rst:3175 msgid "" "To illustrate how it works, we can add the following block of code to the " "above::" msgstr "" -#: howto/logging-cookbook.rst:3198 +#: howto/logging-cookbook.rst:3193 msgid "" "We initially set the logger's level to ``INFO``, so message #1 appears and " "message #2 doesn't. We then change the level to ``DEBUG`` temporarily in the " @@ -1718,56 +1718,56 @@ msgid "" "(like message #1) whereas message #7 doesn't (just like message #2)." msgstr "" -#: howto/logging-cookbook.rst:3208 +#: howto/logging-cookbook.rst:3203 msgid "If we run the resulting script, the result is as follows:" msgstr "" -#: howto/logging-cookbook.rst:3219 +#: howto/logging-cookbook.rst:3214 msgid "" "If we run it again, but pipe ``stderr`` to ``/dev/null``, we see the " "following, which is the only message written to ``stdout``:" msgstr "" -#: howto/logging-cookbook.rst:3227 +#: howto/logging-cookbook.rst:3222 msgid "Once again, but piping ``stdout`` to ``/dev/null``, we get:" msgstr "" -#: howto/logging-cookbook.rst:3237 +#: howto/logging-cookbook.rst:3232 msgid "" "In this case, the message #5 printed to ``stdout`` doesn't appear, as " "expected." msgstr "" -#: howto/logging-cookbook.rst:3239 +#: howto/logging-cookbook.rst:3234 msgid "" "Of course, the approach described here can be generalised, for example to " "attach logging filters temporarily. Note that the above code works in Python " "2 as well as Python 3." msgstr "" -#: howto/logging-cookbook.rst:3247 +#: howto/logging-cookbook.rst:3242 msgid "A CLI application starter template" msgstr "" -#: howto/logging-cookbook.rst:3249 +#: howto/logging-cookbook.rst:3244 msgid "Here's an example which shows how you can:" msgstr "" -#: howto/logging-cookbook.rst:3251 +#: howto/logging-cookbook.rst:3246 msgid "Use a logging level based on command-line arguments" msgstr "" -#: howto/logging-cookbook.rst:3252 +#: howto/logging-cookbook.rst:3247 msgid "" "Dispatch to multiple subcommands in separate files, all logging at the same " "level in a consistent way" msgstr "" -#: howto/logging-cookbook.rst:3254 +#: howto/logging-cookbook.rst:3249 msgid "Make use of simple, minimal configuration" msgstr "" -#: howto/logging-cookbook.rst:3256 +#: howto/logging-cookbook.rst:3251 msgid "" "Suppose we have a command-line application whose job is to stop, start or " "restart some services. This could be organised for the purposes of " @@ -1778,53 +1778,53 @@ msgid "" "``logging.INFO``. Here's one way that ``app.py`` could be written::" msgstr "" -#: howto/logging-cookbook.rst:3305 +#: howto/logging-cookbook.rst:3300 msgid "" "And the ``start``, ``stop`` and ``restart`` commands can be implemented in " "separate modules, like so for starting::" msgstr "" -#: howto/logging-cookbook.rst:3318 +#: howto/logging-cookbook.rst:3313 msgid "and thus for stopping::" msgstr "" -#: howto/logging-cookbook.rst:3339 +#: howto/logging-cookbook.rst:3334 msgid "and similarly for restarting::" msgstr "" -#: howto/logging-cookbook.rst:3360 +#: howto/logging-cookbook.rst:3355 msgid "" "If we run this application with the default log level, we get output like " "this:" msgstr "" -#: howto/logging-cookbook.rst:3373 +#: howto/logging-cookbook.rst:3368 msgid "" "The first word is the logging level, and the second word is the module or " "package name of the place where the event was logged." msgstr "" -#: howto/logging-cookbook.rst:3376 +#: howto/logging-cookbook.rst:3371 msgid "" "If we change the logging level, then we can change the information sent to " "the log. For example, if we want more information:" msgstr "" -#: howto/logging-cookbook.rst:3393 +#: howto/logging-cookbook.rst:3388 msgid "And if we want less:" msgstr "" -#: howto/logging-cookbook.rst:3401 +#: howto/logging-cookbook.rst:3396 msgid "" "In this case, the commands don't print anything to the console, since " "nothing at ``WARNING`` level or above is logged by them." msgstr "" -#: howto/logging-cookbook.rst:3407 +#: howto/logging-cookbook.rst:3402 msgid "A Qt GUI for logging" msgstr "" -#: howto/logging-cookbook.rst:3409 +#: howto/logging-cookbook.rst:3404 msgid "" "A question that comes up from time to time is about how to log to a GUI " "application. The `Qt `_ framework is a popular cross-" @@ -1832,7 +1832,7 @@ msgid "" "project/PySide2/>`_ or `PyQt5 `_ libraries." msgstr "" -#: howto/logging-cookbook.rst:3415 +#: howto/logging-cookbook.rst:3410 msgid "" "The following example shows how to log to a Qt GUI. This introduces a simple " "``QtHandler`` class which takes a callable, which should be a slot in the " @@ -1842,14 +1842,14 @@ msgid "" "logging messages at random levels with random short delays in between)." msgstr "" -#: howto/logging-cookbook.rst:3422 +#: howto/logging-cookbook.rst:3417 msgid "" "The worker thread is implemented using Qt's ``QThread`` class rather than " "the :mod:`threading` module, as there are circumstances where one has to use " "``QThread``, which offers better integration with other ``Qt`` components." msgstr "" -#: howto/logging-cookbook.rst:3426 +#: howto/logging-cookbook.rst:3421 msgid "" "The code should work with recent releases of either ``PySide2`` or " "``PyQt5``. You should be able to adapt the approach to earlier versions of " @@ -1857,11 +1857,11 @@ msgid "" "information." msgstr "" -#: howto/logging-cookbook.rst:3640 +#: howto/logging-cookbook.rst:3635 msgid "Logging to syslog with RFC5424 support" msgstr "" -#: howto/logging-cookbook.rst:3642 +#: howto/logging-cookbook.rst:3637 msgid "" "Although :rfc:`5424` dates from 2009, most syslog servers are configured by " "default to use the older :rfc:`3164`, which hails from 2001. When " @@ -1871,14 +1871,14 @@ msgid "" "handlers.SysLogHandler` functionality has not been updated." msgstr "" -#: howto/logging-cookbook.rst:3649 +#: howto/logging-cookbook.rst:3644 msgid "" "RFC 5424 contains some useful features such as support for structured data, " "and if you need to be able to log to a syslog server with support for it, " "you can do so with a subclassed handler which looks something like this::" msgstr "" -#: howto/logging-cookbook.rst:3715 +#: howto/logging-cookbook.rst:3710 msgid "" "You'll need to be familiar with RFC 5424 to fully understand the above code, " "and it may be that you have slightly different needs (e.g. for how you pass " @@ -1887,11 +1887,11 @@ msgid "" "using something like this::" msgstr "" -#: howto/logging-cookbook.rst:3729 +#: howto/logging-cookbook.rst:3724 msgid "How to treat a logger like an output stream" msgstr "" -#: howto/logging-cookbook.rst:3731 +#: howto/logging-cookbook.rst:3726 msgid "" "Sometimes, you need to interface to a third-party API which expects a file-" "like object to write to, but you want to direct the API's output to a " @@ -1899,17 +1899,17 @@ msgid "" "API. Here's a short script illustrating such a class:" msgstr "" -#: howto/logging-cookbook.rst:3771 +#: howto/logging-cookbook.rst:3766 msgid "When this script is run, it prints" msgstr "" -#: howto/logging-cookbook.rst:3778 +#: howto/logging-cookbook.rst:3773 msgid "" "You could also use ``LoggerWriter`` to redirect ``sys.stdout`` and ``sys." "stderr`` by doing something like this:" msgstr "" -#: howto/logging-cookbook.rst:3788 +#: howto/logging-cookbook.rst:3783 msgid "" "You should do this *after* configuring logging for your needs. In the above " "example, the :func:`~logging.basicConfig` call does this (using the ``sys." @@ -1917,25 +1917,25 @@ msgid "" "Then, you'd get this kind of result:" msgstr "" -#: howto/logging-cookbook.rst:3801 +#: howto/logging-cookbook.rst:3796 msgid "" "Of course, the examples above show output according to the format used by :" "func:`~logging.basicConfig`, but you can use a different formatter when you " "configure logging." msgstr "" -#: howto/logging-cookbook.rst:3805 +#: howto/logging-cookbook.rst:3800 msgid "" "Note that with the above scheme, you are somewhat at the mercy of buffering " "and the sequence of write calls which you are intercepting. For example, " "with the definition of ``LoggerWriter`` above, if you have the snippet" msgstr "" -#: howto/logging-cookbook.rst:3814 +#: howto/logging-cookbook.rst:3809 msgid "then running the script results in" msgstr "" -#: howto/logging-cookbook.rst:3832 +#: howto/logging-cookbook.rst:3827 msgid "" "As you can see, this output isn't ideal. That's because the underlying code " "which writes to ``sys.stderr`` makes multiple writes, each of which results " @@ -1945,17 +1945,17 @@ msgid "" "``LoggerWriter``:" msgstr "" -#: howto/logging-cookbook.rst:3857 +#: howto/logging-cookbook.rst:3852 msgid "" "This just buffers up stuff until a newline is seen, and then logs complete " "lines. With this approach, you get better output:" msgstr "" -#: howto/logging-cookbook.rst:3873 +#: howto/logging-cookbook.rst:3868 msgid "Patterns to avoid" msgstr "" -#: howto/logging-cookbook.rst:3875 +#: howto/logging-cookbook.rst:3870 msgid "" "Although the preceding sections have described ways of doing things you " "might need to do or deal with, it is worth mentioning some usage patterns " @@ -1963,11 +1963,11 @@ msgid "" "The following sections are in no particular order." msgstr "" -#: howto/logging-cookbook.rst:3881 +#: howto/logging-cookbook.rst:3876 msgid "Opening the same log file multiple times" msgstr "" -#: howto/logging-cookbook.rst:3883 +#: howto/logging-cookbook.rst:3878 msgid "" "On Windows, you will generally not be able to open the same file multiple " "times as this will lead to a \"file is in use by another process\" error. " @@ -1975,32 +1975,32 @@ msgid "" "file multiple times. This could be done accidentally, for example by:" msgstr "" -#: howto/logging-cookbook.rst:3888 +#: howto/logging-cookbook.rst:3883 msgid "" "Adding a file handler more than once which references the same file (e.g. by " "a copy/paste/forget-to-change error)." msgstr "" -#: howto/logging-cookbook.rst:3891 +#: howto/logging-cookbook.rst:3886 msgid "" "Opening two files that look different, as they have different names, but are " "the same because one is a symbolic link to the other." msgstr "" -#: howto/logging-cookbook.rst:3894 +#: howto/logging-cookbook.rst:3889 msgid "" "Forking a process, following which both parent and child have a reference to " "the same file. This might be through use of the :mod:`multiprocessing` " "module, for example." msgstr "" -#: howto/logging-cookbook.rst:3898 +#: howto/logging-cookbook.rst:3893 msgid "" "Opening a file multiple times might *appear* to work most of the time, but " "can lead to a number of problems in practice:" msgstr "" -#: howto/logging-cookbook.rst:3901 +#: howto/logging-cookbook.rst:3896 msgid "" "Logging output can be garbled because multiple threads or processes try to " "write to the same file. Although logging guards against concurrent use of " @@ -2009,7 +2009,7 @@ msgid "" "different handler instances which happen to point to the same file." msgstr "" -#: howto/logging-cookbook.rst:3907 +#: howto/logging-cookbook.rst:3902 msgid "" "An attempt to delete a file (e.g. during file rotation) silently fails, " "because there is another reference pointing to it. This can lead to " @@ -2019,17 +2019,17 @@ msgid "" "being supposedly in place." msgstr "" -#: howto/logging-cookbook.rst:3914 +#: howto/logging-cookbook.rst:3909 msgid "" "Use the techniques outlined in :ref:`multiple-processes` to circumvent such " "issues." msgstr "" -#: howto/logging-cookbook.rst:3918 +#: howto/logging-cookbook.rst:3913 msgid "Using loggers as attributes in a class or passing them as parameters" msgstr "" -#: howto/logging-cookbook.rst:3920 +#: howto/logging-cookbook.rst:3915 msgid "" "While there might be unusual cases where you'll need to do this, in general " "there is no point because loggers are singletons. Code can always access a " @@ -2040,13 +2040,13 @@ msgid "" "module (and not the class) is the unit of software decomposition." msgstr "" -#: howto/logging-cookbook.rst:3929 +#: howto/logging-cookbook.rst:3924 msgid "" "Adding handlers other than :class:`~logging.NullHandler` to a logger in a " "library" msgstr "" -#: howto/logging-cookbook.rst:3931 +#: howto/logging-cookbook.rst:3926 msgid "" "Configuring logging by adding handlers, formatters and filters is the " "responsibility of the application developer, not the library developer. If " @@ -2054,11 +2054,11 @@ msgid "" "your loggers other than a :class:`~logging.NullHandler` instance." msgstr "" -#: howto/logging-cookbook.rst:3937 +#: howto/logging-cookbook.rst:3932 msgid "Creating a lot of loggers" msgstr "" -#: howto/logging-cookbook.rst:3939 +#: howto/logging-cookbook.rst:3934 msgid "" "Loggers are singletons that are never freed during a script execution, and " "so creating lots of loggers will use up memory which can't then be freed. " @@ -2069,14 +2069,14 @@ msgid "" "occasionally slightly more fine-grained than that)." msgstr "" -#: howto/logging-cookbook.rst:3950 +#: howto/logging-cookbook.rst:3945 msgid "Other resources" msgstr "" -#: howto/logging-cookbook.rst:3963 +#: howto/logging-cookbook.rst:3958 msgid ":ref:`Basic Tutorial `" msgstr "" -#: howto/logging-cookbook.rst:3965 +#: howto/logging-cookbook.rst:3960 msgid ":ref:`Advanced Tutorial `" msgstr "" diff --git a/howto/logging.po b/howto/logging.po index dfbdd69ff..e5a53ed2d 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: 2023-10-01 00:18+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -701,10 +701,10 @@ msgstr "" msgid "" "The :meth:`~Handler.setLevel` method, just as in logger objects, specifies " "the lowest severity that will be dispatched to the appropriate destination. " -"Why are there two :func:`setLevel` methods? The level set in the logger " -"determines which severity of messages it will pass to its handlers. The " -"level set in each handler determines which messages that handler will send " -"on." +"Why are there two :meth:`~Handler.setLevel` methods? The level set in the " +"logger determines which severity of messages it will pass to its handlers. " +"The level set in each handler determines which messages that handler will " +"send on." msgstr "" #: howto/logging.rst:528 @@ -913,46 +913,40 @@ msgstr "" 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. The behaviour of the logging package in these " -"circumstances is dependent on the Python version." +"output the event." msgstr "" -#: howto/logging.rst:781 +#: howto/logging.rst:780 +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 " +"acts like a :class:`~logging.StreamHandler` which writes the event " +"description message to the current value of ``sys.stderr`` (therefore " +"respecting any redirections which may be in effect). No formatting is done " +"on the message - just the bare event description message is printed. The " +"handler's level is set to ``WARNING``, so all events at this and greater " +"severities will be output." +msgstr "" + +#: howto/logging.rst:791 msgid "For versions of Python prior to 3.2, the behaviour is as follows:" msgstr "" -#: howto/logging.rst:783 +#: howto/logging.rst:793 msgid "" -"If *logging.raiseExceptions* is ``False`` (production mode), the event is " +"If :data:`raiseExceptions` is ``False`` (production mode), the event is " "silently dropped." msgstr "" -#: howto/logging.rst:786 +#: howto/logging.rst:796 msgid "" -"If *logging.raiseExceptions* is ``True`` (development mode), a message 'No " +"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:789 -msgid "In Python 3.2 and later, the behaviour is as follows:" -msgstr "" - -#: howto/logging.rst:791 -msgid "" -"The event is output using a 'handler of last resort', stored in ``logging." -"lastResort``. This internal handler is not associated with any logger, and " -"acts like a :class:`~logging.StreamHandler` which writes the event " -"description message to the current value of ``sys.stderr`` (therefore " -"respecting any redirections which may be in effect). No formatting is done " -"on the message - just the bare event description message is printed. The " -"handler's level is set to ``WARNING``, so all events at this and greater " -"severities will be output." -msgstr "" - -#: howto/logging.rst:800 +#: howto/logging.rst:799 msgid "" -"To obtain the pre-3.2 behaviour, ``logging.lastResort`` can be set to " -"``None``." +"To obtain the pre-3.2 behaviour, :data:`lastResort` can be set to ``None``." msgstr "" #: howto/logging.rst:805 @@ -1257,8 +1251,8 @@ msgstr "" #: howto/logging.rst:1001 msgid "" -"For formatting multiple messages in a batch, instances of :class:`~handlers." -"BufferingFormatter` can be used. In addition to the format string (which is " +"For formatting multiple messages in a batch, instances of :class:" +"`BufferingFormatter` can be used. In addition to the format string (which is " "applied to each message in the batch), there is provision for header and " "trailer format strings." msgstr "" @@ -1308,7 +1302,7 @@ msgid "" "the exception is swallowed." msgstr "" -#: howto/logging.rst:1038 +#: howto/logging.rst:1039 msgid "" "The default value of :data:`raiseExceptions` is ``True``. This is because " "during development, you typically want to be notified of any exceptions that " @@ -1316,11 +1310,11 @@ msgid "" "production usage." msgstr "" -#: howto/logging.rst:1048 +#: howto/logging.rst:1049 msgid "Using arbitrary objects as messages" msgstr "" -#: howto/logging.rst:1050 +#: howto/logging.rst:1051 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 " @@ -1332,11 +1326,11 @@ msgid "" "the wire." msgstr "" -#: howto/logging.rst:1061 +#: howto/logging.rst:1062 msgid "Optimization" msgstr "" -#: howto/logging.rst:1063 +#: howto/logging.rst:1064 msgid "" "Formatting of message arguments is deferred until it cannot be avoided. " "However, computing the arguments passed to the logging method can also be " @@ -1347,13 +1341,13 @@ msgid "" "code like this::" msgstr "" -#: howto/logging.rst:1075 +#: howto/logging.rst:1076 msgid "" -"so that if the logger's threshold is set above ``DEBUG``, the calls to :func:" -"`expensive_func1` and :func:`expensive_func2` are never made." +"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:1078 +#: howto/logging.rst:1079 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 " @@ -1365,7 +1359,7 @@ msgid "" "while the application is running (which is not all that common)." msgstr "" -#: howto/logging.rst:1087 +#: howto/logging.rst:1088 msgid "" "There are other optimizations which can be made for specific applications " "which need more precise control over what logging information is collected. " @@ -1373,94 +1367,94 @@ msgid "" "you don't need:" msgstr "" -#: howto/logging.rst:1093 +#: howto/logging.rst:1094 msgid "What you don't want to collect" msgstr "" -#: howto/logging.rst:1093 +#: howto/logging.rst:1094 msgid "How to avoid collecting it" msgstr "" -#: howto/logging.rst:1095 +#: howto/logging.rst:1096 msgid "Information about where calls were made from." msgstr "" -#: howto/logging.rst:1095 +#: howto/logging.rst:1096 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:1101 +#: howto/logging.rst:1102 msgid "Threading information." msgstr "" -#: howto/logging.rst:1101 +#: howto/logging.rst:1102 msgid "Set ``logging.logThreads`` to ``False``." msgstr "" -#: howto/logging.rst:1103 +#: howto/logging.rst:1104 msgid "Current process ID (:func:`os.getpid`)" msgstr "" -#: howto/logging.rst:1103 +#: howto/logging.rst:1104 msgid "Set ``logging.logProcesses`` to ``False``." msgstr "" -#: howto/logging.rst:1105 +#: howto/logging.rst:1106 msgid "" "Current process name when using ``multiprocessing`` to manage multiple " "processes." msgstr "" -#: howto/logging.rst:1105 +#: howto/logging.rst:1106 msgid "Set ``logging.logMultiprocessing`` to ``False``." msgstr "" -#: howto/logging.rst:1108 +#: howto/logging.rst:1109 msgid "Current :class:`asyncio.Task` name when using ``asyncio``." msgstr "" -#: howto/logging.rst:1108 +#: howto/logging.rst:1109 msgid "Set ``logging.logAsyncioTasks`` to ``False``." msgstr "" -#: howto/logging.rst:1112 +#: howto/logging.rst:1113 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:1119 +#: howto/logging.rst:1120 msgid "Other resources" msgstr "" -#: howto/logging.rst:1124 +#: howto/logging.rst:1125 msgid "Module :mod:`logging`" msgstr "" -#: howto/logging.rst:1124 +#: howto/logging.rst:1125 msgid "API reference for the logging module." msgstr "" -#: howto/logging.rst:1127 +#: howto/logging.rst:1128 msgid "Module :mod:`logging.config`" msgstr "" -#: howto/logging.rst:1127 +#: howto/logging.rst:1128 msgid "Configuration API for the logging module." msgstr "" -#: howto/logging.rst:1130 +#: howto/logging.rst:1131 msgid "Module :mod:`logging.handlers`" msgstr "" -#: howto/logging.rst:1130 +#: howto/logging.rst:1131 msgid "Useful handlers included with the logging module." msgstr "" -#: howto/logging.rst:1132 +#: howto/logging.rst:1133 msgid ":ref:`A logging cookbook `" msgstr "" diff --git a/howto/pyporting.po b/howto/pyporting.po index 6d341e0a9..3f3fe5dd2 100644 --- a/howto/pyporting.po +++ b/howto/pyporting.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -16,7 +16,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -#: howto/pyporting.rst:5 +#: howto/pyporting.rst:7 msgid "How to port Python 2 Code to Python 3" msgstr "" @@ -24,614 +24,60 @@ msgstr "" msgid "author" msgstr "" -#: howto/pyporting.rst:7 +#: howto/pyporting.rst:9 msgid "Brett Cannon" msgstr "" -#: howto/pyporting.rst:None -msgid "Abstract" -msgstr "" - #: howto/pyporting.rst:11 msgid "" "Python 2 reached its official end-of-life at the start of 2020. This means " "that no new bug reports, fixes, or changes will be made to Python 2 - it's " -"no longer supported." -msgstr "" - -#: howto/pyporting.rst:15 -msgid "" -"This guide is intended to provide you with a path to Python 3 for your code, " -"that includes compatibility with Python 2 as a first step." +"no longer supported: see :pep:`373` and `status of Python versions `_." msgstr "" -#: howto/pyporting.rst:18 +#: howto/pyporting.rst:16 msgid "" "If you are looking to port an extension module instead of pure Python code, " "please see :ref:`cporting-howto`." msgstr "" -#: howto/pyporting.rst:21 +#: howto/pyporting.rst:19 msgid "" "The archived python-porting_ mailing list may contain some useful guidance." msgstr "" -#: howto/pyporting.rst:25 -msgid "The Short Explanation" +#: howto/pyporting.rst:21 +msgid "" +"Since Python 3.13 the original porting guide was discontinued. You can find " +"the old guide in the `archive `_." msgstr "" #: howto/pyporting.rst:27 -msgid "" -"To achieve Python 2/3 compatibility in a single code base, the basic steps " -"are:" +msgid "Third-party guides" msgstr "" -#: howto/pyporting.rst:30 -msgid "Only worry about supporting Python 2.7" +#: howto/pyporting.rst:29 +msgid "There are also multiple third-party guides that might be useful:" msgstr "" #: howto/pyporting.rst:31 -msgid "" -"Make sure you have good test coverage (coverage.py_ can help; ``python -m " -"pip install coverage``)" -msgstr "" - -#: howto/pyporting.rst:33 -msgid "Learn the differences between Python 2 and 3" -msgstr "" - -#: howto/pyporting.rst:34 -msgid "" -"Use Futurize_ (or Modernize_) to update your code (e.g. ``python -m pip " -"install future``)" -msgstr "" - -#: howto/pyporting.rst:35 -msgid "" -"Use Pylint_ to help make sure you don't regress on your Python 3 support " -"(``python -m pip install pylint``)" -msgstr "" - -#: howto/pyporting.rst:37 -msgid "" -"Use caniusepython3_ to find out which of your dependencies are blocking your " -"use of Python 3 (``python -m pip install caniusepython3``)" -msgstr "" - -#: howto/pyporting.rst:39 -msgid "" -"Once your dependencies are no longer blocking you, use continuous " -"integration to make sure you stay compatible with Python 2 and 3 (tox_ can " -"help test against multiple versions of Python; ``python -m pip install tox``)" -msgstr "" - -#: howto/pyporting.rst:42 -msgid "" -"Consider using optional :term:`static type checking ` " -"to make sure your type usage works in both Python 2 and 3 (e.g. use mypy_ to " -"check your typing under both Python 2 and Python 3; ``python -m pip install " -"mypy``)." -msgstr "" - -#: howto/pyporting.rst:49 -msgid "" -"Note: Using ``python -m pip install`` guarantees that the ``pip`` you invoke " -"is the one installed for the Python currently in use, whether it be a system-" -"wide ``pip`` or one installed within a :ref:`virtual environment `." -msgstr "" - -#: howto/pyporting.rst:55 -msgid "Details" -msgstr "" - -#: howto/pyporting.rst:57 -msgid "" -"Even if other factors - say, dependencies over which you have no control - " -"still require you to support Python 2, that does not prevent you taking the " -"step of including Python 3 support." -msgstr "" - -#: howto/pyporting.rst:61 -msgid "" -"Most changes required to support Python 3 lead to cleaner code using newer " -"practices even in Python 2 code." -msgstr "" - -#: howto/pyporting.rst:66 -msgid "Different versions of Python 2" -msgstr "" - -#: howto/pyporting.rst:68 -msgid "" -"Ideally, your code should be compatible with Python 2.7, which was the last " -"supported version of Python 2." -msgstr "" - -#: howto/pyporting.rst:71 -msgid "" -"Some of the tools mentioned in this guide will not work with Python 2.6." -msgstr "" - -#: howto/pyporting.rst:73 -msgid "" -"If absolutely necessary, the six_ project can help you support Python 2.5 " -"and 3 simultaneously. Do realize, though, that nearly all the projects " -"listed in this guide will not be available to you." -msgstr "" - -#: howto/pyporting.rst:77 -msgid "" -"If you are able to skip Python 2.5 and older, the required changes to your " -"code will be minimal. At worst you will have to use a function instead of a " -"method in some instances or have to import a function instead of using a " -"built-in one." -msgstr "" - -#: howto/pyporting.rst:84 -msgid "" -"Make sure you specify the proper version support in your ``setup.py`` file" -msgstr "" - -#: howto/pyporting.rst:86 -msgid "" -"In your ``setup.py`` file you should have the proper `trove classifier`_ " -"specifying what versions of Python you support. As your project does not " -"support Python 3 yet you should at least have ``Programming Language :: " -"Python :: 2 :: Only`` specified. Ideally you should also specify each major/" -"minor version of Python that you do support, e.g. ``Programming Language :: " -"Python :: 2.7``." -msgstr "" - -#: howto/pyporting.rst:95 -msgid "Have good test coverage" -msgstr "" - -#: howto/pyporting.rst:97 -msgid "" -"Once you have your code supporting the oldest version of Python 2 you want " -"it to, you will want to make sure your test suite has good coverage. A good " -"rule of thumb is that if you want to be confident enough in your test suite " -"that any failures that appear after having tools rewrite your code are " -"actual bugs in the tools and not in your code. If you want a number to aim " -"for, try to get over 80% coverage (and don't feel bad if you find it hard to " -"get better than 90% coverage). If you don't already have a tool to measure " -"test coverage then coverage.py_ is recommended." -msgstr "" - -#: howto/pyporting.rst:108 -msgid "Be aware of the differences between Python 2 and 3" -msgstr "" - -#: howto/pyporting.rst:110 -msgid "" -"Once you have your code well-tested you are ready to begin porting your code " -"to Python 3! But to fully understand how your code is going to change and " -"what you want to look out for while you code, you will want to learn what " -"changes Python 3 makes in terms of Python 2." -msgstr "" - -#: howto/pyporting.rst:115 -msgid "" -"Some resources for understanding the differences and their implications for " -"you code:" -msgstr "" - -#: howto/pyporting.rst:118 -msgid "" -"the :ref:`\"What's New\" ` doc for each release of Python 3" -msgstr "" - -#: howto/pyporting.rst:119 -msgid "the `Porting to Python 3`_ book (which is free online)" -msgstr "" - -#: howto/pyporting.rst:120 -msgid "the handy `cheat sheet`_ from the Python-Future project." -msgstr "" - -#: howto/pyporting.rst:124 -msgid "Update your code" -msgstr "" - -#: howto/pyporting.rst:126 -msgid "There are tools available that can port your code automatically." -msgstr "" - -#: howto/pyporting.rst:128 -msgid "" -"Futurize_ does its best to make Python 3 idioms and practices exist in " -"Python 2, e.g. backporting the ``bytes`` type from Python 3 so that you have " -"semantic parity between the major versions of Python. This is the better " -"approach for most cases." -msgstr "" - -#: howto/pyporting.rst:133 -msgid "" -"Modernize_, on the other hand, is more conservative and targets a Python 2/3 " -"subset of Python, directly relying on six_ to help provide compatibility." -msgstr "" - -#: howto/pyporting.rst:136 -msgid "" -"A good approach is to run the tool over your test suite first and visually " -"inspect the diff to make sure the transformation is accurate. After you have " -"transformed your test suite and verified that all the tests still pass as " -"expected, then you can transform your application code knowing that any " -"tests which fail is a translation failure." -msgstr "" - -#: howto/pyporting.rst:142 -msgid "" -"Unfortunately the tools can't automate everything to make your code work " -"under Python 3, and you will also need to read the tools' documentation in " -"case some options you need are turned off by default." -msgstr "" - -#: howto/pyporting.rst:146 -msgid "Key issues to be aware of and check for:" -msgstr "" - -#: howto/pyporting.rst:149 -msgid "Division" -msgstr "" - -#: howto/pyporting.rst:151 -msgid "" -"In Python 3, ``5 / 2 == 2.5`` and not ``2`` as it was in Python 2; all " -"division between ``int`` values result in a ``float``. This change has " -"actually been planned since Python 2.2 which was released in 2002. Since " -"then users have been encouraged to add ``from __future__ import division`` " -"to any and all files which use the ``/`` and ``//`` operators or to be " -"running the interpreter with the ``-Q`` flag. If you have not been doing " -"this then you will need to go through your code and do two things:" -msgstr "" - -#: howto/pyporting.rst:159 -msgid "Add ``from __future__ import division`` to your files" -msgstr "" - -#: howto/pyporting.rst:160 -msgid "" -"Update any division operator as necessary to either use ``//`` to use floor " -"division or continue using ``/`` and expect a float" -msgstr "" - -#: howto/pyporting.rst:163 -msgid "" -"The reason that ``/`` isn't simply translated to ``//`` automatically is " -"that if an object defines a ``__truediv__`` method but not ``__floordiv__`` " -"then your code would begin to fail (e.g. a user-defined class that uses ``/" -"`` to signify some operation but not ``//`` for the same thing or at all)." -msgstr "" - -#: howto/pyporting.rst:170 -msgid "Text versus binary data" -msgstr "" - -#: howto/pyporting.rst:172 -msgid "" -"In Python 2 you could use the ``str`` type for both text and binary data. " -"Unfortunately this confluence of two different concepts could lead to " -"brittle code which sometimes worked for either kind of data, sometimes not. " -"It also could lead to confusing APIs if people didn't explicitly state that " -"something that accepted ``str`` accepted either text or binary data instead " -"of one specific type. This complicated the situation especially for anyone " -"supporting multiple languages as APIs wouldn't bother explicitly supporting " -"``unicode`` when they claimed text data support." -msgstr "" - -#: howto/pyporting.rst:181 -msgid "" -"Python 3 made text and binary data distinct types that cannot simply be " -"mixed together. For any code that deals only with text or only binary data, " -"this separation doesn't pose an issue. But for code that has to deal with " -"both, it does mean you might have to now care about when you are using text " -"compared to binary data, which is why this cannot be entirely automated." -msgstr "" - -#: howto/pyporting.rst:187 -msgid "" -"Decide which APIs take text and which take binary (it is **highly** " -"recommended you don't design APIs that can take both due to the difficulty " -"of keeping the code working; as stated earlier it is difficult to do well). " -"In Python 2 this means making sure the APIs that take text can work with " -"``unicode`` and those that work with binary data work with the ``bytes`` " -"type from Python 3 (which is a subset of ``str`` in Python 2 and acts as an " -"alias for ``bytes`` type in Python 2). Usually the biggest issue is " -"realizing which methods exist on which types in Python 2 and 3 " -"simultaneously (for text that's ``unicode`` in Python 2 and ``str`` in " -"Python 3, for binary that's ``str``/``bytes`` in Python 2 and ``bytes`` in " -"Python 3)." -msgstr "" - -#: howto/pyporting.rst:198 -msgid "" -"The following table lists the **unique** methods of each data type across " -"Python 2 and 3 (e.g., the ``decode()`` method is usable on the equivalent " -"binary data type in either Python 2 or 3, but it can't be used by the " -"textual data type consistently between Python 2 and 3 because ``str`` in " -"Python 3 doesn't have the method). Do note that as of Python 3.5 the " -"``__mod__`` method was added to the bytes type." -msgstr "" - -#: howto/pyporting.rst:206 -msgid "**Text data**" -msgstr "" - -#: howto/pyporting.rst:206 -msgid "**Binary data**" -msgstr "" - -#: howto/pyporting.rst:208 -msgid "\\" -msgstr "" - -#: howto/pyporting.rst:208 -msgid "decode" -msgstr "" - -#: howto/pyporting.rst:210 -msgid "encode" -msgstr "" - -#: howto/pyporting.rst:212 -msgid "format" -msgstr "" - -#: howto/pyporting.rst:214 -msgid "isdecimal" -msgstr "" - -#: howto/pyporting.rst:216 -msgid "isnumeric" -msgstr "" - -#: howto/pyporting.rst:219 -msgid "" -"Making the distinction easier to handle can be accomplished by encoding and " -"decoding between binary data and text at the edge of your code. This means " -"that when you receive text in binary data, you should immediately decode it. " -"And if your code needs to send text as binary data then encode it as late as " -"possible. This allows your code to work with only text internally and thus " -"eliminates having to keep track of what type of data you are working with." -msgstr "" - -#: howto/pyporting.rst:226 -msgid "" -"The next issue is making sure you know whether the string literals in your " -"code represent text or binary data. You should add a ``b`` prefix to any " -"literal that presents binary data. For text you should add a ``u`` prefix to " -"the text literal. (There is a :mod:`__future__` import to force all " -"unspecified literals to be Unicode, but usage has shown it isn't as " -"effective as adding a ``b`` or ``u`` prefix to all literals explicitly)" -msgstr "" - -#: howto/pyporting.rst:233 -msgid "" -"You also need to be careful about opening files. Possibly you have not " -"always bothered to add the ``b`` mode when opening a binary file (e.g., " -"``rb`` for binary reading). Under Python 3, binary files and text files are " -"clearly distinct and mutually incompatible; see the :mod:`io` module for " -"details. Therefore, you **must** make a decision of whether a file will be " -"used for binary access (allowing binary data to be read and/or written) or " -"textual access (allowing text data to be read and/or written). You should " -"also use :func:`io.open` for opening files instead of the built-in :func:" -"`open` function as the :mod:`io` module is consistent from Python 2 to 3 " -"while the built-in :func:`open` function is not (in Python 3 it's actually :" -"func:`io.open`). Do not bother with the outdated practice of using :func:" -"`codecs.open` as that's only necessary for keeping compatibility with Python " -"2.5." -msgstr "" - -#: howto/pyporting.rst:246 -msgid "" -"The constructors of both ``str`` and ``bytes`` have different semantics for " -"the same arguments between Python 2 and 3. Passing an integer to ``bytes`` " -"in Python 2 will give you the string representation of the integer: " -"``bytes(3) == '3'``. But in Python 3, an integer argument to ``bytes`` will " -"give you a bytes object as long as the integer specified, filled with null " -"bytes: ``bytes(3) == b'\\x00\\x00\\x00'``. A similar worry is necessary when " -"passing a bytes object to ``str``. In Python 2 you just get the bytes object " -"back: ``str(b'3') == b'3'``. But in Python 3 you get the string " -"representation of the bytes object: ``str(b'3') == \"b'3'\"``." -msgstr "" - -#: howto/pyporting.rst:256 -msgid "" -"Finally, the indexing of binary data requires careful handling (slicing does " -"**not** require any special handling). In Python 2, ``b'123'[1] == b'2'`` " -"while in Python 3 ``b'123'[1] == 50``. Because binary data is simply a " -"collection of binary numbers, Python 3 returns the integer value for the " -"byte you index on. But in Python 2 because ``bytes == str``, indexing " -"returns a one-item slice of bytes. The six_ project has a function named " -"``six.indexbytes()`` which will return an integer like in Python 3: ``six." -"indexbytes(b'123', 1)``." -msgstr "" - -#: howto/pyporting.rst:265 -msgid "To summarize:" -msgstr "" - -#: howto/pyporting.rst:267 -msgid "Decide which of your APIs take text and which take binary data" -msgstr "" - -#: howto/pyporting.rst:268 -msgid "" -"Make sure that your code that works with text also works with ``unicode`` " -"and code for binary data works with ``bytes`` in Python 2 (see the table " -"above for what methods you cannot use for each type)" -msgstr "" - -#: howto/pyporting.rst:271 -msgid "" -"Mark all binary literals with a ``b`` prefix, textual literals with a ``u`` " -"prefix" +msgid "`Guide by Fedora `_" msgstr "" -#: howto/pyporting.rst:273 -msgid "" -"Decode binary data to text as soon as possible, encode text as binary data " -"as late as possible" -msgstr "" - -#: howto/pyporting.rst:275 -msgid "" -"Open files using :func:`io.open` and make sure to specify the ``b`` mode " -"when appropriate" -msgstr "" - -#: howto/pyporting.rst:277 -msgid "Be careful when indexing into binary data" -msgstr "" - -#: howto/pyporting.rst:281 -msgid "Use feature detection instead of version detection" -msgstr "" - -#: howto/pyporting.rst:283 -msgid "" -"Inevitably you will have code that has to choose what to do based on what " -"version of Python is running. The best way to do this is with feature " -"detection of whether the version of Python you're running under supports " -"what you need. If for some reason that doesn't work then you should make the " -"version check be against Python 2 and not Python 3. To help explain this, " -"let's look at an example." -msgstr "" - -#: howto/pyporting.rst:290 -msgid "" -"Let's pretend that you need access to a feature of :mod:`importlib` that is " -"available in Python's standard library since Python 3.3 and available for " -"Python 2 through importlib2_ on PyPI. You might be tempted to write code to " -"access e.g. the :mod:`importlib.abc` module by doing the following::" -msgstr "" - -#: howto/pyporting.rst:302 -msgid "" -"The problem with this code is what happens when Python 4 comes out? It would " -"be better to treat Python 2 as the exceptional case instead of Python 3 and " -"assume that future Python versions will be more compatible with Python 3 " -"than Python 2::" -msgstr "" - -#: howto/pyporting.rst:314 -msgid "" -"The best solution, though, is to do no version detection at all and instead " -"rely on feature detection. That avoids any potential issues of getting the " -"version detection wrong and helps keep you future-compatible::" -msgstr "" - -#: howto/pyporting.rst:325 -msgid "Prevent compatibility regressions" -msgstr "" - -#: howto/pyporting.rst:327 -msgid "" -"Once you have fully translated your code to be compatible with Python 3, you " -"will want to make sure your code doesn't regress and stop working under " -"Python 3. This is especially true if you have a dependency which is blocking " -"you from actually running under Python 3 at the moment." -msgstr "" - -#: howto/pyporting.rst:332 -msgid "" -"To help with staying compatible, any new modules you create should have at " -"least the following block of code at the top of it::" +#: howto/pyporting.rst:32 +msgid "`PyCon 2020 tutorial `_" msgstr "" -#: howto/pyporting.rst:339 -msgid "" -"You can also run Python 2 with the ``-3`` flag to be warned about various " -"compatibility issues your code triggers during execution. If you turn " -"warnings into errors with ``-Werror`` then you can make sure that you don't " -"accidentally miss a warning." -msgstr "" - -#: howto/pyporting.rst:344 -msgid "" -"You can also use the Pylint_ project and its ``--py3k`` flag to lint your " -"code to receive warnings when your code begins to deviate from Python 3 " -"compatibility. This also prevents you from having to run Modernize_ or " -"Futurize_ over your code regularly to catch compatibility regressions. This " -"does require you only support Python 2.7 and Python 3.4 or newer as that is " -"Pylint's minimum Python version support." -msgstr "" - -#: howto/pyporting.rst:353 -msgid "Check which dependencies block your transition" -msgstr "" - -#: howto/pyporting.rst:355 -msgid "" -"**After** you have made your code compatible with Python 3 you should begin " -"to care about whether your dependencies have also been ported. The " -"caniusepython3_ project was created to help you determine which projects -- " -"directly or indirectly -- are blocking you from supporting Python 3. There " -"is both a command-line tool as well as a web interface at https://" -"caniusepython3.com." -msgstr "" - -#: howto/pyporting.rst:362 -msgid "" -"The project also provides code which you can integrate into your test suite " -"so that you will have a failing test when you no longer have dependencies " -"blocking you from using Python 3. This allows you to avoid having to " -"manually check your dependencies and to be notified quickly when you can " -"start running on Python 3." -msgstr "" - -#: howto/pyporting.rst:369 -msgid "Update your ``setup.py`` file to denote Python 3 compatibility" -msgstr "" - -#: howto/pyporting.rst:371 -msgid "" -"Once your code works under Python 3, you should update the classifiers in " -"your ``setup.py`` to contain ``Programming Language :: Python :: 3`` and to " -"not specify sole Python 2 support. This will tell anyone using your code " -"that you support Python 2 **and** 3. Ideally you will also want to add " -"classifiers for each major/minor version of Python you now support." -msgstr "" - -#: howto/pyporting.rst:379 -msgid "Use continuous integration to stay compatible" -msgstr "" - -#: howto/pyporting.rst:381 -msgid "" -"Once you are able to fully run under Python 3 you will want to make sure " -"your code always works under both Python 2 and 3. Probably the best tool for " -"running your tests under multiple Python interpreters is tox_. You can then " -"integrate tox with your continuous integration system so that you never " -"accidentally break Python 2 or 3 support." -msgstr "" - -#: howto/pyporting.rst:387 +#: howto/pyporting.rst:33 msgid "" -"You may also want to use the ``-bb`` flag with the Python 3 interpreter to " -"trigger an exception when you are comparing bytes to strings or bytes to an " -"int (the latter is available starting in Python 3.5). By default type-" -"differing comparisons simply return ``False``, but if you made a mistake in " -"your separation of text/binary data handling or indexing on bytes you " -"wouldn't easily find the mistake. This flag will raise an exception when " -"these kinds of comparisons occur, making the mistake much easier to track " -"down." +"`Guide by DigitalOcean `_" msgstr "" -#: howto/pyporting.rst:397 -msgid "Consider using optional static type checking" -msgstr "" - -#: howto/pyporting.rst:399 +#: howto/pyporting.rst:34 msgid "" -"Another way to help port your code is to use a :term:`static type checker` " -"like mypy_ or pytype_ on your code. These tools can be used to analyze your " -"code as if it's being run under Python 2, then you can run the tool a second " -"time as if your code is running under Python 3. By running a static type " -"checker twice like this you can discover if you're e.g. misusing binary data " -"type in one version of Python compared to another. If you add optional type " -"hints to your code you can also explicitly state whether your APIs use " -"textual or binary data, helping to make sure everything functions as " -"expected in both versions of Python." +"`Guide by ActiveState `_" msgstr "" diff --git a/howto/regex.po b/howto/regex.po index 961d02fac..26b1438bf 100644 --- a/howto/regex.po +++ b/howto/regex.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -28,7 +28,7 @@ msgstr "" msgid "A.M. Kuchling " msgstr "" -#: howto/regex.rst:None +#: howto/regex.rst:-1 msgid "Abstract" msgstr "" diff --git a/howto/sockets.po b/howto/sockets.po index 436816f12..b4da9ed94 100644 --- a/howto/sockets.po +++ b/howto/sockets.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -28,7 +28,7 @@ msgstr "" msgid "Gordon McMillan" msgstr "" -#: howto/sockets.rst:None +#: howto/sockets.rst:-1 msgid "Abstract" msgstr "" diff --git a/howto/sorting.po b/howto/sorting.po index fa13d84e4..2a8594eba 100644 --- a/howto/sorting.po +++ b/howto/sorting.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 19:05+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: 2023-04-19 21:42+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -17,8 +17,9 @@ msgstr "" "X-Generator: Poedit 3.1\n" #: howto/sorting.rst:4 -msgid "Sorting HOW TO" -msgstr "Sıralama NASIL YAPILIR" +#, fuzzy +msgid "Sorting Techniques" +msgstr "Sıralama Temelleri" #: howto/sorting.rst:0 msgid "Author" @@ -28,15 +29,7 @@ msgstr "Yazar" msgid "Andrew Dalke and Raymond Hettinger" msgstr "Andrew Dalke and Raymond Hettinger" -#: howto/sorting.rst:0 -msgid "Release" -msgstr "Yayın Versiyonu" - -#: howto/sorting.rst:7 -msgid "0.1" -msgstr "0.1" - -#: howto/sorting.rst:10 +#: howto/sorting.rst:9 msgid "" "Python lists have a built-in :meth:`list.sort` method that modifies the list " "in-place. There is also a :func:`sorted` built-in function that builds a " @@ -46,7 +39,7 @@ msgstr "" "yöntemine sahiptir. Ayrıca, bir yinelenebilirden yeni bir sıralanmış liste " "oluşturan bir :func:`sorted` yerleşik işlevi de vardır." -#: howto/sorting.rst:14 +#: howto/sorting.rst:13 msgid "" "In this document, we explore the various techniques for sorting data using " "Python." @@ -54,11 +47,11 @@ msgstr "" "Bu belgede, Python kullanarak verileri sıralamak için çeşitli teknikleri " "keşfediyor olacağız." -#: howto/sorting.rst:18 +#: howto/sorting.rst:17 msgid "Sorting Basics" msgstr "Sıralama Temelleri" -#: howto/sorting.rst:20 +#: howto/sorting.rst:19 msgid "" "A simple ascending sort is very easy: just call the :func:`sorted` function. " "It returns a new sorted list:" @@ -66,7 +59,7 @@ msgstr "" "Basit bir artan sıralama yaratmak çok kolaydır: :func:`sorted` fonksiyonunu " "çağırmanız yeterlidir. Bu fonksiyon, yeni bir sıralanmış liste döndürür:" -#: howto/sorting.rst:28 +#: howto/sorting.rst:27 msgid "" "You can also use the :meth:`list.sort` method. It modifies the list in-place " "(and returns ``None`` to avoid confusion). Usually it's less convenient " @@ -78,7 +71,7 @@ msgstr "" "func:`sorted` yönteminden daha az kullanışlıdır - ancak orijinal listeye " "ihtiyacınız yoksa, biraz daha verimlidir." -#: howto/sorting.rst:40 +#: howto/sorting.rst:39 msgid "" "Another difference is that the :meth:`list.sort` method is only defined for " "lists. In contrast, the :func:`sorted` function accepts any iterable." @@ -87,11 +80,11 @@ msgstr "" "tanımlanmış olmasıdır. Buna karşılık, :func:`sorted` fonksiyonu herhangi bir " "yinelenebiliri kabul eder." -#: howto/sorting.rst:49 +#: howto/sorting.rst:48 msgid "Key Functions" msgstr "Anahtar Fonksiyonları" -#: howto/sorting.rst:51 +#: howto/sorting.rst:50 msgid "" "Both :meth:`list.sort` and :func:`sorted` have a *key* parameter to specify " "a function (or other callable) to be called on each list element prior to " @@ -101,13 +94,13 @@ msgstr "" "listenin her öğesi üzerinde çağrılacak bir işlevi (veya başka bir " "çağrılabiliri) özellikle belirtmek için bir *key* parametresine sahiptir." -#: howto/sorting.rst:55 +#: howto/sorting.rst:54 msgid "For example, here's a case-insensitive string comparison:" msgstr "" "Örneğin, büyük/küçük harfe duyarlı olmayan bir dize karşılaştırması bu " "şekilde yapılmaktadır:" -#: howto/sorting.rst:62 +#: howto/sorting.rst:61 msgid "" "The value of the *key* parameter should be a function (or other callable) " "that takes a single argument and returns a key to use for sorting purposes. " @@ -119,7 +112,7 @@ msgstr "" "çağrılabilir) olmalıdır. Bu teknik, hızlı çalışır çünkü anahtar işlevi her " "girdi (input) kaydı için tam olarak bir kez çağrılır." -#: howto/sorting.rst:67 +#: howto/sorting.rst:66 msgid "" "A common pattern is to sort complex objects using some of the object's " "indices as keys. For example:" @@ -127,23 +120,32 @@ msgstr "" "Yaygın bir model, nesnenin bazı indislerini anahtar olarak kullanarak " "karmaşık nesneleri sıralamaktır. Örneğin:" -#: howto/sorting.rst:80 +#: howto/sorting.rst:79 msgid "" "The same technique works for objects with named attributes. For example:" msgstr "" "Aynı teknik, adlandırılmış niteliklere sahip nesneler için de geçerlidir. " "Örneğin:" -#: howto/sorting.rst:101 -msgid "Operator Module Functions" +#: howto/sorting.rst:99 +msgid "" +"Objects with named attributes can be made by a regular class as shown above, " +"or they can be instances of :class:`~dataclasses.dataclass` or a :term:" +"`named tuple`." +msgstr "" + +#: howto/sorting.rst:104 +#, fuzzy +msgid "Operator Module Functions and Partial Function Evaluation" msgstr "Operatör Modülü İşlevleri" -#: howto/sorting.rst:103 +#: howto/sorting.rst:106 +#, fuzzy msgid "" -"The key-function patterns shown above are very common, so Python provides " -"convenience functions to make accessor functions easier and faster. The :mod:" -"`operator` module has :func:`~operator.itemgetter`, :func:`~operator." -"attrgetter`, and a :func:`~operator.methodcaller` function." +"The :term:`key function` patterns shown above are very common, so Python " +"provides convenience functions to make accessor functions easier and faster. " +"The :mod:`operator` module has :func:`~operator.itemgetter`, :func:" +"`~operator.attrgetter`, and a :func:`~operator.methodcaller` function." msgstr "" "Yukarıda gösterilen anahtar-fonksiyon kalıpları çok yaygındır. Bu nedenle " "Python, erişim fonksiyonlarını daha kolay ve hızlı hale getirmek için bazı " @@ -151,13 +153,13 @@ msgstr "" "itemgetter`, :func:`~operator.attrgetter` ve bir :func:`~operator." "methodcaller` fonksiyonuna sahiptir." -#: howto/sorting.rst:108 +#: howto/sorting.rst:111 msgid "Using those functions, the above examples become simpler and faster:" msgstr "" "Bu fonksiyonların kullanımı sonucunda, yukarıdaki örnekler daha basit ve " "hızlı hale gelir:" -#: howto/sorting.rst:120 +#: howto/sorting.rst:123 msgid "" "The operator module functions allow multiple levels of sorting. For example, " "to sort by *grade* then by *age*:" @@ -165,11 +167,19 @@ msgstr "" "Operatör modülü fonksiyonları birden fazla seviyede sıralama yapılmasına " "izin verir. Örneğin, *sınıf* ve ardından *yaş*'a göre sıralamak için:" -#: howto/sorting.rst:132 +#: howto/sorting.rst:134 +msgid "" +"The :mod:`functools` module provides another helpful tool for making key-" +"functions. The :func:`~functools.partial` function can reduce the `arity " +"`_ of a multi-argument function making " +"it suitable for use as a key-function." +msgstr "" + +#: howto/sorting.rst:153 msgid "Ascending and Descending" msgstr "Yükselen ve Alçalan" -#: howto/sorting.rst:134 +#: howto/sorting.rst:155 msgid "" "Both :meth:`list.sort` and :func:`sorted` accept a *reverse* parameter with " "a boolean value. This is used to flag descending sorts. For example, to get " @@ -179,11 +189,11 @@ msgstr "" "parametresi kabul eder. Bu, azalan sıralamaları işaretlemek için kullanılır. " "Örneğin, öğrenci verilerini ters olarak *yaş* sırasına göre elde etmek için:" -#: howto/sorting.rst:147 +#: howto/sorting.rst:168 msgid "Sort Stability and Complex Sorts" msgstr "Sıralama Kararlılığı ve Karmaşık Sıralamalar" -#: howto/sorting.rst:149 +#: howto/sorting.rst:170 msgid "" "Sorts are guaranteed to be `stable `_\\. That means that when multiple records have " @@ -194,7 +204,7 @@ msgstr "" "fazla kayıt aynı anahtara sahip olduğunda, orijinal sıralamanın " "korunacağıdır." -#: howto/sorting.rst:159 +#: howto/sorting.rst:180 msgid "" "Notice how the two records for *blue* retain their original order so that " "``('blue', 1)`` is guaranteed to precede ``('blue', 2)``." @@ -203,7 +213,7 @@ msgstr "" "böylece ``('blue', 1)`` kaydının ``('blue', 2)`` kaydından önce gelmesi " "garanti edilir." -#: howto/sorting.rst:162 +#: howto/sorting.rst:183 msgid "" "This wonderful property lets you build complex sorts in a series of sorting " "steps. For example, to sort the student data by descending *grade* and then " @@ -214,7 +224,7 @@ msgstr "" "ardından artan *yaş* ile sıralamak için, önce *yaş* sıralamasını yapın ve " "ardından *sınıf* kullanarak tekrar sıralayın:" -#: howto/sorting.rst:172 +#: howto/sorting.rst:193 msgid "" "This can be abstracted out into a wrapper function that can take a list and " "tuples of field and order to sort them on multiple passes." @@ -222,7 +232,7 @@ msgstr "" "Bu, bir listeyi ve alan çiftlerini alıp bunları birden fazla geçişte " "sıralayabilen bir sarmalayıcı fonksiyon oluşturacak şekilde soyutlanabilir." -#: howto/sorting.rst:185 +#: howto/sorting.rst:206 msgid "" "The `Timsort `_ algorithm used in " "Python does multiple sorts efficiently because it can take advantage of any " @@ -232,16 +242,16 @@ msgstr "" "algoritması, bir veri kümesinde zaten mevcut olan herhangi bir sıralamadan " "yararlanabildiği için çoklu sıralamayı verimli bir şekilde yapar." -#: howto/sorting.rst:190 +#: howto/sorting.rst:211 msgid "Decorate-Sort-Undecorate" msgstr "Süsle-Sırala-Boz" -#: howto/sorting.rst:192 +#: howto/sorting.rst:213 msgid "This idiom is called Decorate-Sort-Undecorate after its three steps:" msgstr "" "Süsle-Sırala-Boz deyimi, içerdiği üç adımdan ilham alınarak oluşturulmuştur:" -#: howto/sorting.rst:194 +#: howto/sorting.rst:215 msgid "" "First, the initial list is decorated with new values that control the sort " "order." @@ -249,11 +259,11 @@ msgstr "" "İlk olarak, ilk liste sıralama düzenini kontrol eden yeni değerlerle " "süslenir (dekore edilir)." -#: howto/sorting.rst:196 +#: howto/sorting.rst:217 msgid "Second, the decorated list is sorted." msgstr "İkinci olarak, dekore edilmiş liste sıralanır." -#: howto/sorting.rst:198 +#: howto/sorting.rst:219 msgid "" "Finally, the decorations are removed, creating a list that contains only the " "initial values in the new order." @@ -261,14 +271,14 @@ msgstr "" "Son olarak, süslemeler kaldırılır ve yeni sırada yalnızca ilk değerleri " "içeren bir liste oluşturulur." -#: howto/sorting.rst:201 +#: howto/sorting.rst:222 msgid "" "For example, to sort the student data by *grade* using the DSU approach:" msgstr "" "Örneğin, DSU yaklaşımını kullanarak öğrenci verilerini *sınıf* bazında " "sıralamak için:" -#: howto/sorting.rst:208 +#: howto/sorting.rst:231 msgid "" "This idiom works because tuples are compared lexicographically; the first " "items are compared; if they are the same then the second items are compared, " @@ -278,7 +288,7 @@ msgstr "" "karşılaştırıldığı için işe yarar: İlk öğeler karşılaştırılır, aynılarsa " "ikinci öğeler karşılaştırılır ve bu böyle devam eder." -#: howto/sorting.rst:212 +#: howto/sorting.rst:235 msgid "" "It is not strictly necessary in all cases to include the index *i* in the " "decorated list, but including it gives two benefits:" @@ -286,7 +296,7 @@ msgstr "" "*i* indeksini dekore edilmiş listeye dahil etmek her durumda gerekli " "değildir, ancak dahil etmek iki fayda sağlar:" -#: howto/sorting.rst:215 +#: howto/sorting.rst:238 msgid "" "The sort is stable -- if two items have the same key, their order will be " "preserved in the sorted list." @@ -294,7 +304,7 @@ msgstr "" "Sıralama sabittir -- iki öğe aynı anahtara sahipse, sıralanmış listede " "sıraları korunacaktır." -#: howto/sorting.rst:218 +#: howto/sorting.rst:241 msgid "" "The original items do not have to be comparable because the ordering of the " "decorated tuples will be determined by at most the first two items. So for " @@ -305,7 +315,7 @@ msgstr "" "çiftlerin sıralaması en fazla ilk iki öğe tarafından belirlenecektir. " "Örneğin orijinal liste doğrudan sıralanamayan karmaşık sayılar içerebilir." -#: howto/sorting.rst:223 +#: howto/sorting.rst:246 msgid "" "Another name for this idiom is `Schwartzian transform `_\\, after Randal L. Schwartz, who " @@ -315,7 +325,7 @@ msgstr "" "getiren Randal L. Schwartz'a atfen `Schwartzian transform `_\\'dur." -#: howto/sorting.rst:227 +#: howto/sorting.rst:250 msgid "" "Now that Python sorting provides key-functions, this technique is not often " "needed." @@ -323,11 +333,11 @@ msgstr "" "Artık Python sıralama anahtar fonksiyonları sağladığından, bu tekniğe pek " "sık ihtiyaç duyulmamaktadır." -#: howto/sorting.rst:230 +#: howto/sorting.rst:253 msgid "Comparison Functions" msgstr "Karşılaştırma Fonksiyonları" -#: howto/sorting.rst:232 +#: howto/sorting.rst:255 msgid "" "Unlike key functions that return an absolute value for sorting, a comparison " "function computes the relative ordering for two inputs." @@ -335,7 +345,7 @@ msgstr "" "Sıralama için mutlak bir değer döndüren anahtar işlevlerinin aksine, " "karşılaştırma işlevi iki girdi için göreceli bir sıralamayı hesaplar." -#: howto/sorting.rst:235 +#: howto/sorting.rst:258 msgid "" "For example, a `balance scale `_ compares two samples giving a " @@ -349,7 +359,7 @@ msgstr "" "``cmp(a, b)`` karşılaştırma fonksiyonu; girdiler eşitse sıfır, küçükse " "negatif, büyükse pozitif bir değer döndürür." -#: howto/sorting.rst:242 +#: howto/sorting.rst:265 msgid "" "It is common to encounter comparison functions when translating algorithms " "from other languages. Also, some libraries provide comparison functions as " @@ -361,7 +371,7 @@ msgstr "" "olarak karşılaştırma fonksiyonları sağlar. Örneğin, :func:`locale.strcoll` " "bir karşılaştırma fonksiyonudur." -#: howto/sorting.rst:246 +#: howto/sorting.rst:269 msgid "" "To accommodate those situations, Python provides :class:`functools." "cmp_to_key` to wrap the comparison function to make it usable as a key " @@ -371,11 +381,11 @@ msgstr "" "anahtar fonksiyon olarak kullanılabilir hale getirmek için :class:`functools." "cmp_to_key` aracını sağlar::" -#: howto/sorting.rst:253 +#: howto/sorting.rst:276 msgid "Odds and Ends" msgstr "Tuhaflıklar ve Sonlar" -#: howto/sorting.rst:255 +#: howto/sorting.rst:278 msgid "" "For locale aware sorting, use :func:`locale.strxfrm` for a key function or :" "func:`locale.strcoll` for a comparison function. This is necessary because " @@ -387,7 +397,7 @@ msgstr "" "kullanabilirsiniz. Bu gereklidir çünkü \"alfabetik\" sıralamalar, temel " "alfabe aynı olsa bile kültürler arasında farklılık gösterebilir." -#: howto/sorting.rst:260 +#: howto/sorting.rst:283 msgid "" "The *reverse* parameter still maintains sort stability (so that records with " "equal keys retain the original order). Interestingly, that effect can be " @@ -399,7 +409,7 @@ msgstr "" "şekilde bu etki, parametre olmadan yerleşik :func:`reversed` fonksiyonu iki " "kez kullanılarak da simüle edilebilir:" -#: howto/sorting.rst:274 +#: howto/sorting.rst:297 #, fuzzy msgid "" "The sort routines use ``<`` when making comparisons between two objects. So, " @@ -410,16 +420,16 @@ msgstr "" "kullanır. Bu nedenle, bir :meth:`__lt__` yöntemi tanımlayarak, bir sınıfa " "standart bir sıralama düzeni eklemek kolaydır:" -#: howto/sorting.rst:284 -#, fuzzy +#: howto/sorting.rst:307 msgid "" "However, note that ``<`` can fall back to using :meth:`~object.__gt__` if :" -"meth:`~object.__lt__` is not implemented (see :func:`object.__lt__`)." +"meth:`~object.__lt__` is not implemented (see :func:`object.__lt__` for " +"details on the mechanics). To avoid surprises, :pep:`8` recommends that all " +"six comparison methods be implemented. The :func:`~functools.total_ordering` " +"decorator is provided to make that task easier." msgstr "" -"Ancak, :meth:`__lt__` uygulanmamışsa, ``<``'ın :meth:`__gt__` kullanımına " -"geri dönebileceğini unutmayın (bkz. :func:`object.__lt__`)." -#: howto/sorting.rst:287 +#: howto/sorting.rst:314 msgid "" "Key functions need not depend directly on the objects being sorted. A key " "function can also access external resources. For instance, if the student " @@ -430,3 +440,54 @@ msgstr "" "anahtar işlevi, harici kaynaklara da erişebilir. Örneğin, öğrenci notları " "bir sözlükte saklanıyorsa, öğrenci adlarından oluşan ayrı bir listenin " "sıralanmasında da kullanılabilirler:" + +#: howto/sorting.rst:327 +msgid "Partial Sorts" +msgstr "" + +#: howto/sorting.rst:329 +msgid "" +"Some applications require only some of the data to be ordered. The standard " +"library provides several tools that do less work than a full sort:" +msgstr "" + +#: howto/sorting.rst:332 +msgid "" +":func:`min` and :func:`max` return the smallest and largest values, " +"respectively. These functions make a single pass over the input data and " +"require almost no auxiliary memory." +msgstr "" + +#: howto/sorting.rst:336 +msgid "" +":func:`heapq.nsmallest` and :func:`heapq.nlargest` return the *n* smallest " +"and largest values, respectively. These functions make a single pass over " +"the data keeping only *n* elements in memory at a time. For values of *n* " +"that are small relative to the number of inputs, these functions make far " +"fewer comparisons than a full sort." +msgstr "" + +#: howto/sorting.rst:342 +msgid "" +":func:`heapq.heappush` and :func:`heapq.heappop` create and maintain a " +"partially sorted arrangement of data that keeps the smallest element at " +"position ``0``. These functions are suitable for implementing priority " +"queues which are commonly used for task scheduling." +msgstr "" + +#~ msgid "Sorting HOW TO" +#~ msgstr "Sıralama NASIL YAPILIR" + +#~ msgid "Release" +#~ msgstr "Yayın Versiyonu" + +#~ msgid "0.1" +#~ msgstr "0.1" + +#, fuzzy +#~ msgid "" +#~ "However, note that ``<`` can fall back to using :meth:`~object.__gt__` " +#~ "if :meth:`~object.__lt__` is not implemented (see :func:`object.__lt__`)." +#~ msgstr "" +#~ "Ancak, :meth:`__lt__` uygulanmamışsa, ``<``'ın :meth:`__gt__` kullanımına " +#~ "geri dönebileceğini unutmayın (bkz. :func:`object.__lt__`)." diff --git a/howto/urllib2.po b/howto/urllib2.po index 52406c37b..92b25019c 100644 --- a/howto/urllib2.po +++ b/howto/urllib2.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-10-01 00:18+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -328,8 +328,8 @@ msgstr "" #: howto/urllib2.rst:394 msgid "" "The response returned by urlopen (or the :exc:`~urllib.error.HTTPError` " -"instance) has two useful methods :meth:`info` and :meth:`geturl` and is " -"defined in the module :mod:`urllib.response`.." +"instance) has two useful methods :meth:`!info` and :meth:`!geturl` and is " +"defined in the module :mod:`urllib.response`." msgstr "" #: howto/urllib2.rst:398 @@ -467,7 +467,7 @@ msgstr "" msgid "" "In the above example we only supplied our ``HTTPBasicAuthHandler`` to " "``build_opener``. By default openers have the handlers for normal situations " -"-- ``ProxyHandler`` (if a proxy setting such as an :envvar:`http_proxy` " +"-- ``ProxyHandler`` (if a proxy setting such as an :envvar:`!http_proxy` " "environment variable is set), ``UnknownHandler``, ``HTTPHandler``, " "``HTTPDefaultErrorHandler``, ``HTTPRedirectHandler``, ``FTPHandler``, " "``FileHandler``, ``DataHandler``, ``HTTPErrorProcessor``." diff --git a/library/__future__.po b/library/__future__.po index a3b97d2e5..281227522 100644 --- a/library/__future__.po +++ b/library/__future__.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -25,23 +25,28 @@ msgid "**Source code:** :source:`Lib/__future__.py`" msgstr "" #: library/__future__.rst:11 -msgid ":mod:`__future__` is a real module, and serves three purposes:" +msgid "" +"Imports of the form ``from __future__ import feature`` are called :ref:" +"`future statements `. These are special-cased by the Python compiler " +"to allow the use of new Python features in modules containing the future " +"statement before the release in which the feature becomes standard." msgstr "" -#: library/__future__.rst:13 +#: library/__future__.rst:16 msgid "" -"To avoid confusing existing tools that analyze import statements and expect " -"to find the modules they're importing." +"While these future statements are given additional special meaning by the " +"Python compiler, they are still executed like any other import statement and " +"the :mod:`__future__` exists and is handled by the import system the same " +"way any other Python module would be. This design serves three purposes:" msgstr "" -#: library/__future__.rst:16 +#: library/__future__.rst:21 msgid "" -"To ensure that :ref:`future statements ` run under releases prior to " -"2.1 at least yield runtime exceptions (the import of :mod:`__future__` will " -"fail, because there was no module of that name prior to 2.1)." +"To avoid confusing existing tools that analyze import statements and expect " +"to find the modules they're importing." msgstr "" -#: library/__future__.rst:20 +#: library/__future__.rst:24 msgid "" "To document when incompatible changes were introduced, and when they will be " "--- or were --- made mandatory. This is a form of executable documentation, " @@ -50,199 +55,211 @@ msgid "" msgstr "" #: library/__future__.rst:29 -msgid "Each statement in :file:`__future__.py` is of the form::" -msgstr "" - -#: library/__future__.rst:34 -msgid "" -"where, normally, *OptionalRelease* is less than *MandatoryRelease*, and both " -"are 5-tuples of the same form as :data:`sys.version_info`::" -msgstr "" - -#: library/__future__.rst:46 -msgid "" -"*OptionalRelease* records the first release in which the feature was " -"accepted." -msgstr "" - -#: library/__future__.rst:50 -msgid "" -"In the case of a *MandatoryRelease* that has not yet occurred, " -"*MandatoryRelease* predicts the release in which the feature will become " -"part of the language." -msgstr "" - -#: library/__future__.rst:54 -msgid "" -"Else *MandatoryRelease* records when the feature became part of the " -"language; in releases at or after that, modules no longer need a future " -"statement to use the feature in question, but may continue to use such " -"imports." -msgstr "" - -#: library/__future__.rst:58 msgid "" -"*MandatoryRelease* may also be ``None``, meaning that a planned feature got " -"dropped or that it is not yet decided." +"To ensure that :ref:`future statements ` run under releases prior to " +"Python 2.1 at least yield runtime exceptions (the import of :mod:" +"`__future__` will fail, because there was no module of that name prior to " +"2.1)." msgstr "" -#: library/__future__.rst:63 -msgid "" -"*CompilerFlag* is the (bitfield) flag that should be passed in the fourth " -"argument to the built-in function :func:`compile` to enable the feature in " -"dynamically compiled code. This flag is stored in the :attr:`_Feature." -"compiler_flag` attribute on :class:`_Feature` instances." +#: library/__future__.rst:34 +msgid "Module Contents" msgstr "" -#: library/__future__.rst:68 +#: library/__future__.rst:36 msgid "" "No feature description will ever be deleted from :mod:`__future__`. Since " "its introduction in Python 2.1 the following features have found their way " "into the language using this mechanism:" msgstr "" -#: library/__future__.rst:73 +#: library/__future__.rst:41 msgid "feature" msgstr "" -#: library/__future__.rst:73 +#: library/__future__.rst:41 msgid "optional in" msgstr "" -#: library/__future__.rst:73 +#: library/__future__.rst:41 msgid "mandatory in" msgstr "" -#: library/__future__.rst:73 +#: library/__future__.rst:41 msgid "effect" msgstr "" -#: library/__future__.rst:75 +#: library/__future__.rst:43 msgid "nested_scopes" msgstr "" -#: library/__future__.rst:75 +#: library/__future__.rst:43 msgid "2.1.0b1" msgstr "" -#: library/__future__.rst:75 +#: library/__future__.rst:43 msgid "2.2" msgstr "" -#: library/__future__.rst:75 +#: library/__future__.rst:43 msgid ":pep:`227`: *Statically Nested Scopes*" msgstr "" -#: library/__future__.rst:78 +#: library/__future__.rst:46 msgid "generators" msgstr "" -#: library/__future__.rst:78 +#: library/__future__.rst:46 msgid "2.2.0a1" msgstr "" -#: library/__future__.rst:78 +#: library/__future__.rst:46 msgid "2.3" msgstr "" -#: library/__future__.rst:78 +#: library/__future__.rst:46 msgid ":pep:`255`: *Simple Generators*" msgstr "" -#: library/__future__.rst:81 +#: library/__future__.rst:49 msgid "division" msgstr "" -#: library/__future__.rst:81 +#: library/__future__.rst:49 msgid "2.2.0a2" msgstr "" -#: library/__future__.rst:84 library/__future__.rst:93 +#: library/__future__.rst:52 library/__future__.rst:61 msgid "3.0" msgstr "" -#: library/__future__.rst:81 +#: library/__future__.rst:49 msgid ":pep:`238`: *Changing the Division Operator*" msgstr "" -#: library/__future__.rst:84 +#: library/__future__.rst:52 msgid "absolute_import" msgstr "" -#: library/__future__.rst:87 +#: library/__future__.rst:55 msgid "2.5.0a1" msgstr "" -#: library/__future__.rst:84 +#: library/__future__.rst:52 msgid ":pep:`328`: *Imports: Multi-Line and Absolute/Relative*" msgstr "" -#: library/__future__.rst:87 +#: library/__future__.rst:55 msgid "with_statement" msgstr "" -#: library/__future__.rst:87 +#: library/__future__.rst:55 msgid "2.6" msgstr "" -#: library/__future__.rst:87 +#: library/__future__.rst:55 msgid ":pep:`343`: *The \"with\" Statement*" msgstr "" -#: library/__future__.rst:90 +#: library/__future__.rst:58 msgid "print_function" msgstr "" -#: library/__future__.rst:93 +#: library/__future__.rst:61 msgid "2.6.0a2" msgstr "" -#: library/__future__.rst:90 +#: library/__future__.rst:58 msgid ":pep:`3105`: *Make print a function*" msgstr "" -#: library/__future__.rst:93 +#: library/__future__.rst:61 msgid "unicode_literals" msgstr "" -#: library/__future__.rst:93 +#: library/__future__.rst:61 msgid ":pep:`3112`: *Bytes literals in Python 3000*" msgstr "" -#: library/__future__.rst:96 +#: library/__future__.rst:64 msgid "generator_stop" msgstr "" -#: library/__future__.rst:96 +#: library/__future__.rst:64 msgid "3.5.0b1" msgstr "" -#: library/__future__.rst:96 +#: library/__future__.rst:64 msgid "3.7" msgstr "" -#: library/__future__.rst:96 +#: library/__future__.rst:64 msgid ":pep:`479`: *StopIteration handling inside generators*" msgstr "" -#: library/__future__.rst:99 +#: library/__future__.rst:67 msgid "annotations" msgstr "" -#: library/__future__.rst:99 +#: library/__future__.rst:67 msgid "3.7.0b1" msgstr "" -#: library/__future__.rst:99 +#: library/__future__.rst:67 msgid "TBD [1]_" msgstr "" -#: library/__future__.rst:99 +#: library/__future__.rst:67 msgid ":pep:`563`: *Postponed evaluation of annotations*" msgstr "" +#: library/__future__.rst:77 +msgid "Each statement in :file:`__future__.py` is of the form::" +msgstr "" + +#: library/__future__.rst:82 +msgid "" +"where, normally, *OptionalRelease* is less than *MandatoryRelease*, and both " +"are 5-tuples of the same form as :data:`sys.version_info`::" +msgstr "" + +#: library/__future__.rst:94 +msgid "" +"*OptionalRelease* records the first release in which the feature was " +"accepted." +msgstr "" + +#: library/__future__.rst:98 +msgid "" +"In the case of a *MandatoryRelease* that has not yet occurred, " +"*MandatoryRelease* predicts the release in which the feature will become " +"part of the language." +msgstr "" + +#: library/__future__.rst:102 +msgid "" +"Else *MandatoryRelease* records when the feature became part of the " +"language; in releases at or after that, modules no longer need a future " +"statement to use the feature in question, but may continue to use such " +"imports." +msgstr "" + #: library/__future__.rst:106 msgid "" +"*MandatoryRelease* may also be ``None``, meaning that a planned feature got " +"dropped or that it is not yet decided." +msgstr "" + +#: library/__future__.rst:111 +msgid "" +"*CompilerFlag* is the (bitfield) flag that should be passed in the fourth " +"argument to the built-in function :func:`compile` to enable the feature in " +"dynamically compiled code. This flag is stored in the :attr:`_Feature." +"compiler_flag` attribute on :class:`_Feature` instances." +msgstr "" + +#: library/__future__.rst:117 +msgid "" "``from __future__ import annotations`` was previously scheduled to become " "mandatory in Python 3.10, but the Python Steering Council twice decided to " "delay the change (`announcement for Python 3.10 \n" @@ -26,7 +26,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/argparse.py`" msgstr "" -#: library/argparse.rst:None +#: library/argparse.rst:-1 msgid "Tutorial" msgstr "" @@ -1692,7 +1692,7 @@ msgid "" msgstr "" #: library/argparse.rst:1939 -msgid "The *encodings* and *errors* keyword arguments." +msgid "Added the *encodings* and *errors* parameters." msgstr "" #: library/argparse.rst:1944 diff --git a/library/array.po b/library/array.po index 3055c22cb..53760d67c 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: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -220,19 +220,21 @@ msgstr "" #: library/array.rst:78 msgid "" "A new array whose items are restricted by *typecode*, and initialized from " -"the optional *initializer* value, which must be a list, a :term:`bytes-like " -"object`, or iterable over elements of the appropriate type." +"the optional *initializer* value, which must be a :class:`bytes` or :class:" +"`bytearray` object, a Unicode string, or iterable over elements of the " +"appropriate type." msgstr "" #: library/array.rst:83 msgid "" -"If given a list or string, the initializer is passed to the new array's :" -"meth:`fromlist`, :meth:`frombytes`, or :meth:`fromunicode` method (see " -"below) to add initial items to the array. Otherwise, the iterable " -"initializer is passed to the :meth:`extend` method." +"If given a :class:`bytes` or :class:`bytearray` object, the initializer is " +"passed to the new array's :meth:`frombytes` method; if given a Unicode " +"string, the initializer is passed to the :meth:`fromunicode` method; " +"otherwise, the initializer's iterator is passed to the :meth:`extend` method " +"to add initial items to the array." msgstr "" -#: library/array.rst:88 +#: library/array.rst:90 msgid "" "Array objects support the ordinary sequence operations of indexing, slicing, " "concatenation, and multiplication. When using slice assignment, the " @@ -242,25 +244,25 @@ msgid "" "object>` are supported." msgstr "" -#: library/array.rst:94 +#: library/array.rst:96 msgid "" "Raises an :ref:`auditing event ` ``array.__new__`` with arguments " "``typecode``, ``initializer``." msgstr "" -#: library/array.rst:99 +#: library/array.rst:101 msgid "The typecode character used to create the array." msgstr "" -#: library/array.rst:104 +#: library/array.rst:106 msgid "The length in bytes of one array item in the internal representation." msgstr "" -#: library/array.rst:109 +#: library/array.rst:111 msgid "Append a new item with value *x* to the end of the array." msgstr "" -#: library/array.rst:114 +#: library/array.rst:116 msgid "" "Return a tuple ``(address, length)`` giving the current memory address and " "the length in elements of the buffer used to hold array's contents. The " @@ -272,7 +274,7 @@ msgid "" "it." msgstr "" -#: library/array.rst:124 +#: library/array.rst:126 msgid "" "When using array objects from code written in C or C++ (the only way to " "effectively make use of this information), it makes more sense to use the " @@ -281,7 +283,7 @@ msgid "" "interface is documented in :ref:`bufferobjects`." msgstr "" -#: library/array.rst:133 +#: library/array.rst:135 msgid "" "\"Byteswap\" all items of the array. This is only supported for values " "which are 1, 2, 4, or 8 bytes in size; for other types of values, :exc:" @@ -289,11 +291,11 @@ msgid "" "written on a machine with a different byte order." msgstr "" -#: library/array.rst:141 +#: library/array.rst:143 msgid "Return the number of occurrences of *x* in the array." msgstr "" -#: library/array.rst:146 +#: library/array.rst:148 msgid "" "Append items from *iterable* to the end of the array. If *iterable* is " "another array, it must have *exactly* the same type code; if not, :exc:" @@ -301,18 +303,18 @@ msgid "" "iterable and its elements must be the right type to be appended to the array." msgstr "" -#: library/array.rst:154 +#: library/array.rst:156 msgid "" -"Appends items from the string, interpreting the string as an array of " -"machine values (as if it had been read from a file using the :meth:" -"`fromfile` method)." +"Appends items from the :term:`bytes-like object`, interpreting its content " +"as an array of machine values (as if it had been read from a file using the :" +"meth:`fromfile` method)." msgstr "" -#: library/array.rst:157 +#: library/array.rst:160 msgid ":meth:`!fromstring` is renamed to :meth:`frombytes` for clarity." msgstr "" -#: library/array.rst:163 +#: library/array.rst:166 msgid "" "Read *n* items (as machine values) from the :term:`file object` *f* and " "append them to the end of the array. If less than *n* items are available, :" @@ -320,21 +322,21 @@ msgid "" "inserted into the array." msgstr "" -#: library/array.rst:171 +#: library/array.rst:174 msgid "" "Append items from the list. This is equivalent to ``for x in list: a." "append(x)`` except that if there is a type error, the array is unchanged." msgstr "" -#: library/array.rst:177 +#: library/array.rst:180 msgid "" -"Extends this array with data from the given unicode string. The array must " -"be a type ``'u'`` array; otherwise a :exc:`ValueError` is raised. Use " -"``array.frombytes(unicodestring.encode(enc))`` to append Unicode data to an " -"array of some other type." +"Extends this array with data from the given Unicode string. The array must " +"have type code ``'u'``; otherwise a :exc:`ValueError` is raised. Use ``array." +"frombytes(unicodestring.encode(enc))`` to append Unicode data to an array of " +"some other type." msgstr "" -#: library/array.rst:185 +#: library/array.rst:188 msgid "" "Return the smallest *i* such that *i* is the index of the first occurrence " "of *x* in the array. The optional arguments *start* and *stop* can be " @@ -342,91 +344,92 @@ msgid "" "`ValueError` if *x* is not found." msgstr "" -#: library/array.rst:190 +#: library/array.rst:193 msgid "Added optional *start* and *stop* parameters." msgstr "" -#: library/array.rst:196 +#: library/array.rst:199 msgid "" "Insert a new item with value *x* in the array before position *i*. Negative " "values are treated as being relative to the end of the array." msgstr "" -#: library/array.rst:202 +#: library/array.rst:205 msgid "" "Removes the item with the index *i* from the array and returns it. The " "optional argument defaults to ``-1``, so that by default the last item is " "removed and returned." msgstr "" -#: library/array.rst:209 +#: library/array.rst:212 msgid "Remove the first occurrence of *x* from the array." msgstr "" -#: library/array.rst:214 +#: library/array.rst:217 msgid "Reverse the order of the items in the array." msgstr "" -#: library/array.rst:219 +#: library/array.rst:222 msgid "" "Convert the array to an array of machine values and return the bytes " "representation (the same sequence of bytes that would be written to a file " "by the :meth:`tofile` method.)" msgstr "" -#: library/array.rst:223 +#: library/array.rst:226 msgid ":meth:`!tostring` is renamed to :meth:`tobytes` for clarity." msgstr "" -#: library/array.rst:229 +#: library/array.rst:232 msgid "Write all items (as machine values) to the :term:`file object` *f*." msgstr "" -#: library/array.rst:234 +#: library/array.rst:237 msgid "Convert the array to an ordinary list with the same items." msgstr "" -#: library/array.rst:239 +#: library/array.rst:242 msgid "" -"Convert the array to a unicode string. The array must be a type ``'u'`` " -"array; otherwise a :exc:`ValueError` is raised. Use ``array.tobytes()." -"decode(enc)`` to obtain a unicode string from an array of some other type." +"Convert the array to a Unicode string. The array must have a type ``'u'``; " +"otherwise a :exc:`ValueError` is raised. Use ``array.tobytes().decode(enc)`` " +"to obtain a Unicode string from an array of some other type." msgstr "" -#: library/array.rst:244 +#: library/array.rst:247 msgid "" -"When an array object is printed or converted to a string, it is represented " -"as ``array(typecode, initializer)``. The *initializer* is omitted if the " -"array is empty, otherwise it is a string if the *typecode* is ``'u'``, " -"otherwise it is a list of numbers. The string is guaranteed to be able to " +"The string representation of array objects has the form ``array(typecode, " +"initializer)``. The *initializer* is omitted if the array is empty, " +"otherwise it is a Unicode string if the *typecode* is ``'u'``, otherwise it " +"is a list of numbers. The string representation is guaranteed to be able to " "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``. Examples::" +"``from array import array``. Variables ``inf`` and ``nan`` must also be " +"defined if it contains corresponding floating point values. Examples::" msgstr "" -#: library/array.rst:261 +#: library/array.rst:268 msgid "Module :mod:`struct`" msgstr "" -#: library/array.rst:261 +#: library/array.rst:268 msgid "Packing and unpacking of heterogeneous binary data." msgstr "" -#: library/array.rst:265 +#: library/array.rst:272 msgid "Module :mod:`xdrlib`" msgstr "" -#: library/array.rst:264 +#: library/array.rst:271 msgid "" "Packing and unpacking of External Data Representation (XDR) data as used in " "some remote procedure call systems." msgstr "" -#: library/array.rst:267 +#: library/array.rst:274 msgid "`NumPy `_" msgstr "" -#: library/array.rst:268 +#: library/array.rst:275 msgid "The NumPy package defines another array type." msgstr "" diff --git a/library/asyncio-policy.po b/library/asyncio-policy.po index e47461ad2..33c65b22b 100644 --- a/library/asyncio-policy.po +++ b/library/asyncio-policy.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -296,7 +296,7 @@ msgstr "" #: library/asyncio-policy.rst:240 msgid "" "There is no noticeable overhead when handling a big number of children " -"(*O(1)* each time a child terminates), but starting a thread per process " +"(*O*\\ (1) each time a child terminates), but starting a thread per process " "requires extra memory." msgstr "" @@ -326,7 +326,7 @@ msgstr "" #: library/asyncio-policy.rst:259 msgid "" "The solution is safe but it has a significant overhead when handling a big " -"number of processes (*O(n)* each time a :py:data:`SIGCHLD` is received)." +"number of processes (*O*\\ (*n*) each time a :py:data:`SIGCHLD` is received)." msgstr "" #: library/asyncio-policy.rst:269 @@ -339,8 +339,8 @@ msgstr "" #: library/asyncio-policy.rst:276 msgid "" "This solution is as safe as :class:`MultiLoopChildWatcher` and has the same " -"*O(N)* complexity but requires a running event loop in the main thread to " -"work." +"*O*\\ (*n*) complexity but requires a running event loop in the main thread " +"to work." msgstr "" #: library/asyncio-policy.rst:283 @@ -353,7 +353,7 @@ msgstr "" #: library/asyncio-policy.rst:287 msgid "" "There is no noticeable overhead when handling a big number of children " -"(*O(1)* each time a child terminates)." +"(*O*\\ (1) each time a child terminates)." msgstr "" #: library/asyncio-policy.rst:290 diff --git a/library/asyncio-protocol.po b/library/asyncio-protocol.po index e5bd40008..c4842f056 100644 --- a/library/asyncio-protocol.po +++ b/library/asyncio-protocol.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-10-05 21:24+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -565,8 +565,9 @@ msgstr "" #: library/asyncio-protocol.rst:420 msgid "" -"On POSIX systems, this method sends SIGTERM to the subprocess. On Windows, " -"the Windows API function TerminateProcess() is called to stop the subprocess." +"On POSIX systems, this method sends :py:const:`~signal.SIGTERM` to the " +"subprocess. On Windows, the Windows API function :c:func:`!TerminateProcess` " +"is called to stop the subprocess." msgstr "" #: library/asyncio-protocol.rst:424 diff --git a/library/asyncio-stream.po b/library/asyncio-stream.po index 6a692e080..e2d2710bb 100644 --- a/library/asyncio-stream.po +++ b/library/asyncio-stream.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -85,7 +85,7 @@ msgid "Added the *ssl_handshake_timeout* parameter." msgstr "" #: library/asyncio-stream.rst:80 -msgid "Added *happy_eyeballs_delay* and *interleave* parameters." +msgid "Added the *happy_eyeballs_delay* and *interleave* parameters." msgstr "" #: library/asyncio-stream.rst:125 library/asyncio-stream.rst:187 diff --git a/library/asyncio-subprocess.po b/library/asyncio-subprocess.po index 342fc6713..ae48666c2 100644 --- a/library/asyncio-subprocess.po +++ b/library/asyncio-subprocess.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -289,7 +289,7 @@ msgstr "" #: library/asyncio-subprocess.rst:243 msgid "" -"On Windows, :py:data:`SIGTERM` is an alias for :meth:`terminate`. " +"On Windows, :py:const:`~signal.SIGTERM` is an alias for :meth:`terminate`. " "``CTRL_C_EVENT`` and ``CTRL_BREAK_EVENT`` can be sent to processes started " "with a *creationflags* parameter which includes ``CREATE_NEW_PROCESS_GROUP``." msgstr "" @@ -300,13 +300,13 @@ msgstr "" #: library/asyncio-subprocess.rst:252 msgid "" -"On POSIX systems this method sends :py:const:`signal.SIGTERM` to the child " +"On POSIX systems this method sends :py:const:`~signal.SIGTERM` to the child " "process." msgstr "" #: library/asyncio-subprocess.rst:255 msgid "" -"On Windows the Win32 API function :c:func:`TerminateProcess` is called to " +"On Windows the Win32 API function :c:func:`!TerminateProcess` is called to " "stop the child process." msgstr "" diff --git a/library/asyncio-task.po b/library/asyncio-task.po index 36657ac79..63e49eaa4 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: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -240,11 +240,11 @@ msgid "" "tasks, gather them in a collection::" msgstr "" -#: library/asyncio-task.rst:1076 +#: library/asyncio-task.rst:1075 msgid "Added the *name* parameter." msgstr "" -#: library/asyncio-task.rst:1083 +#: library/asyncio-task.rst:1082 msgid "Added the *context* parameter." msgstr "" @@ -302,7 +302,7 @@ msgid "" msgstr "" #: library/asyncio-task.rst:472 library/asyncio-task.rst:703 -#: library/asyncio-task.rst:769 library/asyncio-task.rst:869 +#: library/asyncio-task.rst:769 library/asyncio-task.rst:868 msgid "Example::" msgstr "" @@ -388,7 +388,7 @@ msgid "" msgstr "" #: library/asyncio-task.rst:521 library/asyncio-task.rst:794 -#: library/asyncio-task.rst:875 +#: library/asyncio-task.rst:874 msgid "Removed the *loop* parameter." msgstr "" @@ -770,52 +770,40 @@ msgstr "" msgid "Constant" msgstr "" -#: library/asyncio-task.rst:831 +#: library/asyncio-task.rst:832 msgid "Description" msgstr "" -#: library/asyncio-task.rst:833 -msgid ":const:`FIRST_COMPLETED`" -msgstr "" - -#: library/asyncio-task.rst:833 +#: library/asyncio-task.rst:835 msgid "The function will return when any future finishes or is cancelled." msgstr "" -#: library/asyncio-task.rst:836 -msgid ":const:`FIRST_EXCEPTION`" -msgstr "" - -#: library/asyncio-task.rst:836 +#: library/asyncio-task.rst:838 msgid "" -"The function will return when any future finishes by raising an exception. " +"The function will return when any future finishes by raising an exception. " "If no future raises an exception then it is equivalent to :const:" "`ALL_COMPLETED`." msgstr "" -#: library/asyncio-task.rst:842 -msgid ":const:`ALL_COMPLETED`" -msgstr "" - -#: library/asyncio-task.rst:842 +#: library/asyncio-task.rst:843 msgid "The function will return when all futures finish or are cancelled." msgstr "" -#: library/asyncio-task.rst:846 +#: library/asyncio-task.rst:845 msgid "" "Unlike :func:`~asyncio.wait_for`, ``wait()`` does not cancel the futures " "when a timeout occurs." msgstr "" -#: library/asyncio-task.rst:852 +#: library/asyncio-task.rst:851 msgid "Passing coroutine objects to ``wait()`` directly is forbidden." msgstr "" -#: library/asyncio-task.rst:882 +#: library/asyncio-task.rst:881 msgid "Added support for generators yielding tasks." msgstr "" -#: library/asyncio-task.rst:861 +#: library/asyncio-task.rst:860 msgid "" "Run :ref:`awaitable objects ` in the *aws* iterable " "concurrently. Return an iterator of coroutines. Each coroutine returned can " @@ -823,26 +811,26 @@ msgid "" "remaining awaitables." msgstr "" -#: library/asyncio-task.rst:866 +#: library/asyncio-task.rst:865 msgid "" "Raises :exc:`TimeoutError` if the timeout occurs before all Futures are done." msgstr "" -#: library/asyncio-task.rst:878 +#: library/asyncio-task.rst:877 msgid "" "Deprecation warning is emitted if not all awaitable objects in the *aws* " "iterable are Future-like objects and there is no running event loop." msgstr "" -#: library/asyncio-task.rst:887 +#: library/asyncio-task.rst:886 msgid "Running in Threads" msgstr "" -#: library/asyncio-task.rst:891 +#: library/asyncio-task.rst:890 msgid "Asynchronously run function *func* in a separate thread." msgstr "" -#: library/asyncio-task.rst:893 +#: library/asyncio-task.rst:892 msgid "" "Any \\*args and \\*\\*kwargs supplied for this function are directly passed " "to *func*. Also, the current :class:`contextvars.Context` is propagated, " @@ -850,19 +838,19 @@ msgid "" "separate thread." msgstr "" -#: library/asyncio-task.rst:898 +#: library/asyncio-task.rst:897 msgid "" "Return a coroutine that can be awaited to get the eventual result of *func*." msgstr "" -#: library/asyncio-task.rst:900 +#: library/asyncio-task.rst:899 msgid "" "This coroutine function is primarily intended to be used for executing IO-" "bound functions/methods that would otherwise block the event loop if they " "were run in the main thread. For example::" msgstr "" -#: library/asyncio-task.rst:930 +#: library/asyncio-task.rst:929 msgid "" "Directly calling ``blocking_io()`` in any coroutine would block the event " "loop for its duration, resulting in an additional 1 second of run time. " @@ -870,7 +858,7 @@ msgid "" "thread without blocking the event loop." msgstr "" -#: library/asyncio-task.rst:937 +#: library/asyncio-task.rst:936 msgid "" "Due to the :term:`GIL`, ``asyncio.to_thread()`` can typically only be used " "to make IO-bound functions non-blocking. However, for extension modules that " @@ -878,85 +866,85 @@ msgid "" "``asyncio.to_thread()`` can also be used for CPU-bound functions." msgstr "" -#: library/asyncio-task.rst:946 +#: library/asyncio-task.rst:945 msgid "Scheduling From Other Threads" msgstr "" -#: library/asyncio-task.rst:950 +#: library/asyncio-task.rst:949 msgid "Submit a coroutine to the given event loop. Thread-safe." msgstr "" -#: library/asyncio-task.rst:952 +#: library/asyncio-task.rst:951 msgid "" "Return a :class:`concurrent.futures.Future` to wait for the result from " "another OS thread." msgstr "" -#: library/asyncio-task.rst:955 +#: library/asyncio-task.rst:954 msgid "" "This function is meant to be called from a different OS thread than the one " "where the event loop is running. Example::" msgstr "" -#: library/asyncio-task.rst:967 +#: library/asyncio-task.rst:966 msgid "" "If an exception is raised in the coroutine, the returned Future will be " "notified. It can also be used to cancel the task in the event loop::" msgstr "" -#: library/asyncio-task.rst:981 +#: library/asyncio-task.rst:980 msgid "" "See the :ref:`concurrency and multithreading ` " "section of the documentation." msgstr "" -#: library/asyncio-task.rst:984 +#: library/asyncio-task.rst:983 msgid "" "Unlike other asyncio functions this function requires the *loop* argument to " "be passed explicitly." msgstr "" -#: library/asyncio-task.rst:991 +#: library/asyncio-task.rst:990 msgid "Introspection" msgstr "" -#: library/asyncio-task.rst:996 +#: library/asyncio-task.rst:995 msgid "" "Return the currently running :class:`Task` instance, or ``None`` if no task " "is running." msgstr "" -#: library/asyncio-task.rst:999 +#: library/asyncio-task.rst:998 msgid "" "If *loop* is ``None`` :func:`get_running_loop` is used to get the current " "loop." msgstr "" -#: library/asyncio-task.rst:1007 +#: library/asyncio-task.rst:1006 msgid "Return a set of not yet finished :class:`Task` objects run by the loop." msgstr "" -#: library/asyncio-task.rst:1010 +#: library/asyncio-task.rst:1009 msgid "" "If *loop* is ``None``, :func:`get_running_loop` is used for getting current " "loop." msgstr "" -#: library/asyncio-task.rst:1018 +#: library/asyncio-task.rst:1017 msgid "Return ``True`` if *obj* is a coroutine object." msgstr "" -#: library/asyncio-task.rst:1024 +#: library/asyncio-task.rst:1023 msgid "Task Object" msgstr "" -#: library/asyncio-task.rst:1028 +#: library/asyncio-task.rst:1027 msgid "" "A :class:`Future-like ` object that runs a Python :ref:`coroutine " "`. Not thread-safe." msgstr "" -#: library/asyncio-task.rst:1031 +#: library/asyncio-task.rst:1030 msgid "" "Tasks are used to run coroutines in event loops. If a coroutine awaits on a " "Future, the Task suspends the execution of the coroutine and waits for the " @@ -964,21 +952,21 @@ msgid "" "wrapped coroutine resumes." msgstr "" -#: library/asyncio-task.rst:1037 +#: library/asyncio-task.rst:1036 msgid "" "Event loops use cooperative scheduling: an event loop runs one Task at a " "time. While a Task awaits for the completion of a Future, the event loop " "runs other Tasks, callbacks, or performs IO operations." msgstr "" -#: library/asyncio-task.rst:1042 +#: library/asyncio-task.rst:1041 msgid "" "Use the high-level :func:`asyncio.create_task` function to create Tasks, or " "the low-level :meth:`loop.create_task` or :func:`ensure_future` functions. " "Manual instantiation of Tasks is discouraged." msgstr "" -#: library/asyncio-task.rst:1047 +#: library/asyncio-task.rst:1046 msgid "" "To cancel a running Task use the :meth:`cancel` method. Calling it will " "cause the Task to throw a :exc:`CancelledError` exception into the wrapped " @@ -986,20 +974,20 @@ msgid "" "cancellation, the Future object will be cancelled." msgstr "" -#: library/asyncio-task.rst:1052 +#: library/asyncio-task.rst:1051 msgid "" ":meth:`cancelled` can be used to check if the Task was cancelled. The method " "returns ``True`` if the wrapped coroutine did not suppress the :exc:" "`CancelledError` exception and was actually cancelled." msgstr "" -#: library/asyncio-task.rst:1057 +#: library/asyncio-task.rst:1056 msgid "" ":class:`asyncio.Task` inherits from :class:`Future` all of its APIs except :" "meth:`Future.set_result` and :meth:`Future.set_exception`." msgstr "" -#: library/asyncio-task.rst:1061 +#: library/asyncio-task.rst:1060 msgid "" "An optional keyword-only *context* argument allows specifying a custom :" "class:`contextvars.Context` for the *coro* to run in. If no *context* is " @@ -1007,7 +995,7 @@ msgid "" "in the copied context." msgstr "" -#: library/asyncio-task.rst:1066 +#: library/asyncio-task.rst:1065 msgid "" "An optional keyword-only *eager_start* argument allows eagerly starting the " "execution of the :class:`asyncio.Task` at task creation time. If set to " @@ -1017,96 +1005,96 @@ msgid "" "eagerly and will skip scheduling to the event loop." msgstr "" -#: library/asyncio-task.rst:1073 +#: library/asyncio-task.rst:1072 msgid "Added support for the :mod:`contextvars` module." msgstr "" -#: library/asyncio-task.rst:1079 +#: library/asyncio-task.rst:1078 msgid "" "Deprecation warning is emitted if *loop* is not specified and there is no " "running event loop." msgstr "" -#: library/asyncio-task.rst:1086 +#: library/asyncio-task.rst:1085 msgid "Added the *eager_start* parameter." msgstr "" -#: library/asyncio-task.rst:1091 +#: library/asyncio-task.rst:1090 msgid "Return ``True`` if the Task is *done*." msgstr "" -#: library/asyncio-task.rst:1093 +#: library/asyncio-task.rst:1092 msgid "" "A Task is *done* when the wrapped coroutine either returned a value, raised " "an exception, or the Task was cancelled." msgstr "" -#: library/asyncio-task.rst:1098 +#: library/asyncio-task.rst:1097 msgid "Return the result of the Task." msgstr "" -#: library/asyncio-task.rst:1100 +#: library/asyncio-task.rst:1099 msgid "" "If the Task is *done*, the result of the wrapped coroutine is returned (or " "if the coroutine raised an exception, that exception is re-raised.)" msgstr "" -#: library/asyncio-task.rst:1118 +#: library/asyncio-task.rst:1117 msgid "" "If the Task has been *cancelled*, this method raises a :exc:`CancelledError` " "exception." msgstr "" -#: library/asyncio-task.rst:1107 +#: library/asyncio-task.rst:1106 msgid "" "If the Task's result isn't yet available, this method raises a :exc:" "`InvalidStateError` exception." msgstr "" -#: library/asyncio-task.rst:1112 +#: library/asyncio-task.rst:1111 msgid "Return the exception of the Task." msgstr "" -#: library/asyncio-task.rst:1114 +#: library/asyncio-task.rst:1113 msgid "" "If the wrapped coroutine raised an exception that exception is returned. If " "the wrapped coroutine returned normally this method returns ``None``." msgstr "" -#: library/asyncio-task.rst:1121 +#: library/asyncio-task.rst:1120 msgid "" "If the Task isn't *done* yet, this method raises an :exc:`InvalidStateError` " "exception." msgstr "" -#: library/asyncio-task.rst:1126 +#: library/asyncio-task.rst:1125 msgid "Add a callback to be run when the Task is *done*." msgstr "" -#: library/asyncio-task.rst:1137 +#: library/asyncio-task.rst:1136 msgid "This method should only be used in low-level callback-based code." msgstr "" -#: library/asyncio-task.rst:1130 +#: library/asyncio-task.rst:1129 msgid "" "See the documentation of :meth:`Future.add_done_callback` for more details." msgstr "" -#: library/asyncio-task.rst:1135 +#: library/asyncio-task.rst:1134 msgid "Remove *callback* from the callbacks list." msgstr "" -#: library/asyncio-task.rst:1139 +#: library/asyncio-task.rst:1138 msgid "" "See the documentation of :meth:`Future.remove_done_callback` for more " "details." msgstr "" -#: library/asyncio-task.rst:1144 +#: library/asyncio-task.rst:1143 msgid "Return the list of stack frames for this Task." msgstr "" -#: library/asyncio-task.rst:1146 +#: library/asyncio-task.rst:1145 msgid "" "If the wrapped coroutine is not done, this returns the stack where it is " "suspended. If the coroutine has completed successfully or was cancelled, " @@ -1114,15 +1102,15 @@ msgid "" "this returns the list of traceback frames." msgstr "" -#: library/asyncio-task.rst:1152 +#: library/asyncio-task.rst:1151 msgid "The frames are always ordered from oldest to newest." msgstr "" -#: library/asyncio-task.rst:1154 +#: library/asyncio-task.rst:1153 msgid "Only one stack frame is returned for a suspended coroutine." msgstr "" -#: library/asyncio-task.rst:1156 +#: library/asyncio-task.rst:1155 msgid "" "The optional *limit* argument sets the maximum number of frames to return; " "by default all available frames are returned. The ordering of the returned " @@ -1131,81 +1119,81 @@ msgid "" "are returned. (This matches the behavior of the traceback module.)" msgstr "" -#: library/asyncio-task.rst:1165 +#: library/asyncio-task.rst:1164 msgid "Print the stack or traceback for this Task." msgstr "" -#: library/asyncio-task.rst:1167 +#: library/asyncio-task.rst:1166 msgid "" "This produces output similar to that of the traceback module for the frames " "retrieved by :meth:`get_stack`." msgstr "" -#: library/asyncio-task.rst:1170 +#: library/asyncio-task.rst:1169 msgid "The *limit* argument is passed to :meth:`get_stack` directly." msgstr "" -#: library/asyncio-task.rst:1172 +#: library/asyncio-task.rst:1171 msgid "" "The *file* argument is an I/O stream to which the output is written; by " "default output is written to :data:`sys.stdout`." msgstr "" -#: library/asyncio-task.rst:1177 +#: library/asyncio-task.rst:1176 msgid "Return the coroutine object wrapped by the :class:`Task`." msgstr "" -#: library/asyncio-task.rst:1181 +#: library/asyncio-task.rst:1180 msgid "" "This will return ``None`` for Tasks which have already completed eagerly. " "See the :ref:`Eager Task Factory `." msgstr "" -#: library/asyncio-task.rst:1188 +#: library/asyncio-task.rst:1187 msgid "Newly added eager task execution means result may be ``None``." msgstr "" -#: library/asyncio-task.rst:1192 +#: library/asyncio-task.rst:1191 msgid "" "Return the :class:`contextvars.Context` object associated with the task." msgstr "" -#: library/asyncio-task.rst:1199 +#: library/asyncio-task.rst:1198 msgid "Return the name of the Task." msgstr "" -#: library/asyncio-task.rst:1201 +#: library/asyncio-task.rst:1200 msgid "" "If no name has been explicitly assigned to the Task, the default asyncio " "Task implementation generates a default name during instantiation." msgstr "" -#: library/asyncio-task.rst:1209 +#: library/asyncio-task.rst:1208 msgid "Set the name of the Task." msgstr "" -#: library/asyncio-task.rst:1211 +#: library/asyncio-task.rst:1210 msgid "" "The *value* argument can be any object, which is then converted to a string." msgstr "" -#: library/asyncio-task.rst:1214 +#: library/asyncio-task.rst:1213 msgid "" "In the default Task implementation, the name will be visible in the :func:" "`repr` output of a task object." msgstr "" -#: library/asyncio-task.rst:1221 +#: library/asyncio-task.rst:1220 msgid "Request the Task to be cancelled." msgstr "" -#: library/asyncio-task.rst:1223 +#: library/asyncio-task.rst:1222 msgid "" "This arranges for a :exc:`CancelledError` exception to be thrown into the " "wrapped coroutine on the next cycle of the event loop." msgstr "" -#: library/asyncio-task.rst:1226 +#: library/asyncio-task.rst:1225 msgid "" "The coroutine then has a chance to clean up or even deny the request by " "suppressing the exception with a :keyword:`try` ... ... ``except " @@ -1217,46 +1205,46 @@ msgid "" "addition to catching the exception." msgstr "" -#: library/asyncio-task.rst:1236 +#: library/asyncio-task.rst:1235 msgid "Added the *msg* parameter." msgstr "" -#: library/asyncio-task.rst:1239 +#: library/asyncio-task.rst:1238 msgid "The ``msg`` parameter is propagated from cancelled task to its awaiter." msgstr "" -#: library/asyncio-task.rst:1244 +#: library/asyncio-task.rst:1243 msgid "" "The following example illustrates how coroutines can intercept the " "cancellation request::" msgstr "" -#: library/asyncio-task.rst:1283 +#: library/asyncio-task.rst:1282 msgid "Return ``True`` if the Task is *cancelled*." msgstr "" -#: library/asyncio-task.rst:1285 +#: library/asyncio-task.rst:1284 msgid "" "The Task is *cancelled* when the cancellation was requested with :meth:" "`cancel` and the wrapped coroutine propagated the :exc:`CancelledError` " "exception thrown into it." msgstr "" -#: library/asyncio-task.rst:1291 +#: library/asyncio-task.rst:1290 msgid "Decrement the count of cancellation requests to this Task." msgstr "" -#: library/asyncio-task.rst:1293 +#: library/asyncio-task.rst:1292 msgid "Returns the remaining number of cancellation requests." msgstr "" -#: library/asyncio-task.rst:1295 +#: library/asyncio-task.rst:1294 msgid "" "Note that once execution of a cancelled task completed, further calls to :" "meth:`uncancel` are ineffective." msgstr "" -#: library/asyncio-task.rst:1300 +#: library/asyncio-task.rst:1299 msgid "" "This method is used by asyncio's internals and isn't expected to be used by " "end-user code. In particular, if a Task gets successfully uncancelled, this " @@ -1265,7 +1253,7 @@ msgid "" "respective structured block. For example::" msgstr "" -#: library/asyncio-task.rst:1318 +#: library/asyncio-task.rst:1317 msgid "" "While the block with ``make_request()`` and ``make_another_request()`` might " "get cancelled due to the timeout, ``unrelated_code()`` should continue " @@ -1274,20 +1262,20 @@ msgid "" "similar fashion." msgstr "" -#: library/asyncio-task.rst:1324 +#: library/asyncio-task.rst:1323 msgid "" "If end-user code is, for some reason, suppresing cancellation by catching :" "exc:`CancelledError`, it needs to call this method to remove the " "cancellation state." msgstr "" -#: library/asyncio-task.rst:1330 +#: library/asyncio-task.rst:1329 msgid "" "Return the number of pending cancellation requests to this Task, i.e., the " "number of calls to :meth:`cancel` less the number of :meth:`uncancel` calls." msgstr "" -#: library/asyncio-task.rst:1334 +#: library/asyncio-task.rst:1333 msgid "" "Note that if this number is greater than zero but the Task is still " "executing, :meth:`cancelled` will still return ``False``. This is because " @@ -1296,7 +1284,7 @@ msgid "" "to zero." msgstr "" -#: library/asyncio-task.rst:1340 +#: library/asyncio-task.rst:1339 msgid "" "This method is used by asyncio's internals and isn't expected to be used by " "end-user code. See :meth:`uncancel` for more details." diff --git a/library/asyncio.po b/library/asyncio.po index 59d358a49..6997d7a6a 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -32,7 +32,7 @@ msgstr "" msgid ":mod:`asyncio` --- Asynchronous I/O" msgstr "" -#: library/asyncio.rst:None +#: library/asyncio.rst:-1 msgid "Hello World!" msgstr "" diff --git a/library/bdb.po b/library/bdb.po index 16166a3c1..35ad18208 100644 --- a/library/bdb.po +++ b/library/bdb.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -189,7 +189,7 @@ msgid "" msgstr "" #: library/bdb.rst:135 -msgid "The *skip* argument." +msgid "Added the *skip* parameter." msgstr "" #: library/bdb.rst:138 @@ -211,8 +211,9 @@ msgstr "" #: library/bdb.rst:151 msgid "" -"Set the :attr:`botframe`, :attr:`stopframe`, :attr:`returnframe` and :attr:" -"`quitting` attributes with values ready to start debugging." +"Set the :attr:`!botframe`, :attr:`!stopframe`, :attr:`!returnframe` and :" +"attr:`quitting ` attributes with values ready to start " +"debugging." msgstr "" #: library/bdb.rst:156 @@ -279,8 +280,8 @@ msgstr "" msgid "" "If the debugger should stop on the current line, invoke the :meth:" "`user_line` method (which should be overridden in subclasses). Raise a :exc:" -"`BdbQuit` exception if the :attr:`Bdb.quitting` flag is set (which can be " -"set from :meth:`user_line`). Return a reference to the :meth:" +"`BdbQuit` exception if the :attr:`quitting ` flag is set " +"(which can be set from :meth:`user_line`). Return a reference to the :meth:" "`trace_dispatch` method for further tracing in that scope." msgstr "" @@ -288,8 +289,8 @@ msgstr "" msgid "" "If the debugger should stop on this function call, invoke the :meth:" "`user_call` method (which should be overridden in subclasses). Raise a :exc:" -"`BdbQuit` exception if the :attr:`Bdb.quitting` flag is set (which can be " -"set from :meth:`user_call`). Return a reference to the :meth:" +"`BdbQuit` exception if the :attr:`quitting ` flag is set " +"(which can be set from :meth:`user_call`). Return a reference to the :meth:" "`trace_dispatch` method for further tracing in that scope." msgstr "" @@ -297,18 +298,18 @@ msgstr "" msgid "" "If the debugger should stop on this function return, invoke the :meth:" "`user_return` method (which should be overridden in subclasses). Raise a :" -"exc:`BdbQuit` exception if the :attr:`Bdb.quitting` flag is set (which can " -"be set from :meth:`user_return`). Return a reference to the :meth:" -"`trace_dispatch` method for further tracing in that scope." +"exc:`BdbQuit` exception if the :attr:`quitting ` flag is set " +"(which can be set from :meth:`user_return`). Return a reference to the :" +"meth:`trace_dispatch` method for further tracing in that scope." msgstr "" #: library/bdb.rst:207 msgid "" "If the debugger should stop at this exception, invokes the :meth:" "`user_exception` method (which should be overridden in subclasses). Raise a :" -"exc:`BdbQuit` exception if the :attr:`Bdb.quitting` flag is set (which can " -"be set from :meth:`user_exception`). Return a reference to the :meth:" -"`trace_dispatch` method for further tracing in that scope." +"exc:`BdbQuit` exception if the :attr:`quitting ` flag is set " +"(which can be set from :meth:`user_exception`). Return a reference to the :" +"meth:`trace_dispatch` method for further tracing in that scope." msgstr "" #: library/bdb.rst:213 @@ -412,51 +413,51 @@ msgid "" "the system trace function to ``None``." msgstr "" -#: library/bdb.rst:296 +#: library/bdb.rst:298 msgid "" -"Set the :attr:`quitting` attribute to ``True``. This raises :exc:`BdbQuit` " +"Set the :attr:`!quitting` attribute to ``True``. This raises :exc:`BdbQuit` " "in the next call to one of the :meth:`!dispatch_\\*` methods." msgstr "" -#: library/bdb.rst:300 +#: library/bdb.rst:302 msgid "" "Derived classes and clients can call the following methods to manipulate " "breakpoints. These methods return a string containing an error message if " "something went wrong, or ``None`` if all is well." msgstr "" -#: library/bdb.rst:306 +#: library/bdb.rst:308 msgid "" "Set a new breakpoint. If the *lineno* line doesn't exist for the *filename* " "passed as argument, return an error message. The *filename* should be in " "canonical form, as described in the :meth:`canonic` method." msgstr "" -#: library/bdb.rst:312 +#: library/bdb.rst:314 msgid "" "Delete the breakpoints in *filename* and *lineno*. If none were set, return " "an error message." msgstr "" -#: library/bdb.rst:317 +#: library/bdb.rst:319 msgid "" "Delete the breakpoint which has the index *arg* in the :attr:`Breakpoint." "bpbynumber`. If *arg* is not numeric or out of range, return an error " "message." msgstr "" -#: library/bdb.rst:323 +#: library/bdb.rst:325 msgid "" "Delete all breakpoints in *filename*. If none were set, return an error " "message." msgstr "" -#: library/bdb.rst:328 +#: library/bdb.rst:330 msgid "" "Delete all existing breakpoints. If none were set, return an error message." msgstr "" -#: library/bdb.rst:333 +#: library/bdb.rst:335 msgid "" "Return a breakpoint specified by the given number. If *arg* is a string, it " "will be converted to a number. If *arg* is a non-numeric string, if the " @@ -464,103 +465,103 @@ msgid "" "raised." msgstr "" -#: library/bdb.rst:342 +#: library/bdb.rst:344 msgid "Return True if there is a breakpoint for *lineno* in *filename*." msgstr "" -#: library/bdb.rst:346 +#: library/bdb.rst:348 msgid "" "Return all breakpoints for *lineno* in *filename*, or an empty list if none " "are set." msgstr "" -#: library/bdb.rst:351 +#: library/bdb.rst:353 msgid "Return all breakpoints in *filename*, or an empty list if none are set." msgstr "" -#: library/bdb.rst:355 +#: library/bdb.rst:357 msgid "Return all breakpoints that are set." msgstr "" -#: library/bdb.rst:358 +#: library/bdb.rst:360 msgid "" "Derived classes and clients can call the following methods to get a data " "structure representing a stack trace." msgstr "" -#: library/bdb.rst:363 +#: library/bdb.rst:365 msgid "Return a list of (frame, lineno) tuples in a stack trace, and a size." msgstr "" -#: library/bdb.rst:365 +#: library/bdb.rst:367 msgid "" "The most recently called frame is last in the list. The size is the number " "of frames below the frame where the debugger was invoked." msgstr "" -#: library/bdb.rst:370 +#: library/bdb.rst:372 msgid "" "Return a string with information about a stack entry, which is a ``(frame, " "lineno)`` tuple. The return string contains:" msgstr "" -#: library/bdb.rst:373 +#: library/bdb.rst:375 msgid "The canonical filename which contains the frame." msgstr "" -#: library/bdb.rst:374 +#: library/bdb.rst:376 msgid "The function name or ``\"\"``." msgstr "" -#: library/bdb.rst:375 +#: library/bdb.rst:377 msgid "The input arguments." msgstr "" -#: library/bdb.rst:376 +#: library/bdb.rst:378 msgid "The return value." msgstr "" -#: library/bdb.rst:377 +#: library/bdb.rst:379 msgid "The line of code (if it exists)." msgstr "" -#: library/bdb.rst:380 +#: library/bdb.rst:382 msgid "" "The following two methods can be called by clients to use a debugger to " "debug a :term:`statement`, given as a string." msgstr "" -#: library/bdb.rst:385 +#: library/bdb.rst:387 msgid "" "Debug a statement executed via the :func:`exec` function. *globals* " -"defaults to :attr:`__main__.__dict__`, *locals* defaults to *globals*." +"defaults to :attr:`!__main__.__dict__`, *locals* defaults to *globals*." msgstr "" -#: library/bdb.rst:390 +#: library/bdb.rst:392 msgid "" "Debug an expression executed via the :func:`eval` function. *globals* and " "*locals* have the same meaning as in :meth:`run`." msgstr "" -#: library/bdb.rst:395 +#: library/bdb.rst:397 msgid "For backwards compatibility. Calls the :meth:`run` method." msgstr "" -#: library/bdb.rst:399 +#: library/bdb.rst:401 msgid "Debug a single function call, and return its result." msgstr "" -#: library/bdb.rst:402 +#: library/bdb.rst:404 msgid "Finally, the module defines the following functions:" msgstr "" -#: library/bdb.rst:406 +#: library/bdb.rst:408 msgid "" "Return True if we should break here, depending on the way the :class:" "`Breakpoint` *b* was set." msgstr "" -#: library/bdb.rst:409 +#: library/bdb.rst:411 msgid "" "If it was set via line number, it checks if :attr:`b.line ` is the same as the one in *frame*. If the breakpoint was set via :" @@ -569,13 +570,13 @@ msgid "" "line." msgstr "" -#: library/bdb.rst:418 +#: library/bdb.rst:420 msgid "" "Return ``(active breakpoint, delete temporary flag)`` or ``(None, None)`` as " "the breakpoint to act upon." msgstr "" -#: library/bdb.rst:421 +#: library/bdb.rst:423 msgid "" "The *active breakpoint* is the first entry in :attr:`bplist ` for the (:attr:`file `, :attr:`line ` count is ignored)." msgstr "" -#: library/bdb.rst:432 +#: library/bdb.rst:434 msgid "If no such entry exists, then (None, None) is returned." msgstr "" -#: library/bdb.rst:437 +#: library/bdb.rst:439 msgid "Start debugging with a :class:`Bdb` instance from caller's frame." msgstr "" + +#: library/bdb.rst:296 +msgid "quitting (bdb.Bdb attribute)" +msgstr "" diff --git a/library/bisect.po b/library/bisect.po index d92df8e4c..21125710e 100644 --- a/library/bisect.po +++ b/library/bisect.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -115,8 +115,8 @@ msgstr "" #: library/bisect.rst:102 msgid "" -"Keep in mind that the ``O(log n)`` search is dominated by the slow O(n) " -"insertion step." +"Keep in mind that the *O*\\ (log *n*) search is dominated by the slow *O*\\ " +"(*n*) insertion step." msgstr "" #: library/bisect.rst:92 @@ -150,8 +150,8 @@ msgstr "" #: library/bisect.rst:118 msgid "" -"The *insort()* functions are ``O(n)`` because the logarithmic search step is " -"dominated by the linear time insertion step." +"The *insort()* functions are *O*\\ (*n*) because the logarithmic search step " +"is dominated by the linear time insertion step." msgstr "" #: library/bisect.rst:121 diff --git a/library/codecs.po b/library/codecs.po index 772434cb1..999cefe4d 100644 --- a/library/codecs.po +++ b/library/codecs.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -456,7 +456,7 @@ msgid "" "In addition, the following error handler is specific to the given codecs:" msgstr "" -#: library/codecs.rst:13 +#: library/codecs.rst:393 msgid "Codecs" msgstr "" @@ -2628,15 +2628,15 @@ msgid ":ref:`Availability `: Windows." msgstr "" #: library/codecs.rst:1545 -msgid "Support any error handler." -msgstr "" - -#: library/codecs.rst:1548 msgid "" "Before 3.2, the *errors* argument was ignored; ``'replace'`` was always used " "to encode, and ``'ignore'`` to decode." msgstr "" +#: library/codecs.rst:1549 +msgid "Support any error handler." +msgstr "" + #: library/codecs.rst:1554 msgid ":mod:`encodings.utf_8_sig` --- UTF-8 codec with BOM signature" msgstr "" diff --git a/library/collections.abc.po b/library/collections.abc.po index 39b690a65..9ed019346 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -234,8 +234,8 @@ msgstr "" #: library/collections.abc.rst:138 msgid "" -"Inherited :class:`Sequence` methods and ``append``, ``reverse``, ``extend``, " -"``pop``, ``remove``, and ``__iadd__``" +"Inherited :class:`Sequence` methods and ``append``, ``clear``, ``reverse``, " +"``extend``, ``pop``, ``remove``, and ``__iadd__``" msgstr "" #: library/collections.abc.rst:144 diff --git a/library/collections.po b/library/collections.po index 60df0ba43..462227e30 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: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -502,15 +502,15 @@ msgid "" "Deques are a generalization of stacks and queues (the name is pronounced " "\"deck\" and is short for \"double-ended queue\"). Deques support thread-" "safe, memory efficient appends and pops from either side of the deque with " -"approximately the same O(1) performance in either direction." +"approximately the same *O*\\ (1) performance in either direction." msgstr "" #: library/collections.rst:463 msgid "" "Though :class:`list` objects support similar operations, they are optimized " -"for fast fixed-length operations and incur O(n) memory movement costs for " -"``pop(0)`` and ``insert(0, v)`` operations which change both the size and " -"position of the underlying data representation." +"for fast fixed-length operations and incur *O*\\ (*n*) memory movement costs " +"for ``pop(0)`` and ``insert(0, v)`` operations which change both the size " +"and position of the underlying data representation." msgstr "" #: library/collections.rst:469 @@ -626,8 +626,9 @@ msgid "" "In addition to the above, deques support iteration, pickling, ``len(d)``, " "``reversed(d)``, ``copy.copy(d)``, ``copy.deepcopy(d)``, membership testing " "with the :keyword:`in` operator, and subscript references such as ``d[0]`` " -"to access the first element. Indexed access is O(1) at both ends but slows " -"to O(n) in the middle. For fast random access, use lists instead." +"to access the first element. Indexed access is *O*\\ (1) at both ends but " +"slows to *O*\\ (*n*) in the middle. For fast random access, use lists " +"instead." msgstr "" #: library/collections.rst:591 diff --git a/library/concurrent.futures.po b/library/concurrent.futures.po index a593913fc..7e35bd41b 100644 --- a/library/concurrent.futures.po +++ b/library/concurrent.futures.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-10-01 00:18+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -69,7 +69,7 @@ msgid "" msgstr "" #: library/concurrent.futures.rst:44 -msgid "Similar to :func:`map(func, *iterables) ` except:" +msgid "Similar to :func:`map(fn, *iterables) ` except:" msgstr "" #: library/concurrent.futures.rst:46 @@ -78,7 +78,7 @@ msgstr "" #: library/concurrent.futures.rst:48 msgid "" -"*func* is executed asynchronously and several calls to *func* may be made " +"*fn* is executed asynchronously and several calls to *fn* may be made " "concurrently." msgstr "" @@ -93,8 +93,8 @@ msgstr "" #: library/concurrent.futures.rst:57 msgid "" -"If a *func* call raises an exception, then that exception will be raised " -"when its value is retrieved from the iterator." +"If a *fn* call raises an exception, then that exception will be raised when " +"its value is retrieved from the iterator." msgstr "" #: library/concurrent.futures.rst:60 @@ -211,12 +211,12 @@ msgstr "" #: library/concurrent.futures.rst:174 msgid "" -"The *thread_name_prefix* argument was added to allow users to control the :" +"Added the *thread_name_prefix* parameter to allow users to control the :" "class:`threading.Thread` names for worker threads created by the pool for " "easier debugging." msgstr "" -#: library/concurrent.futures.rst:179 library/concurrent.futures.rst:282 +#: library/concurrent.futures.rst:179 library/concurrent.futures.rst:283 msgid "Added the *initializer* and *initargs* arguments." msgstr "" @@ -302,19 +302,19 @@ msgstr "" #: library/concurrent.futures.rst:272 msgid "" -"When one of the worker processes terminates abruptly, a :exc:" -"`BrokenProcessPool` error is now raised. Previously, behaviour was " -"undefined but operations on the executor or its futures would often freeze " -"or deadlock." +"When one of the worker processes terminates abruptly, a :exc:`~concurrent." +"futures.process.BrokenProcessPool` error is now raised. Previously, " +"behaviour was undefined but operations on the executor or its futures would " +"often freeze or deadlock." msgstr "" -#: library/concurrent.futures.rst:278 +#: library/concurrent.futures.rst:279 msgid "" "The *mp_context* argument was added to allow users to control the " "start_method for worker processes created by the pool." msgstr "" -#: library/concurrent.futures.rst:285 +#: library/concurrent.futures.rst:286 msgid "" "The default :mod:`multiprocessing` start method (see :ref:`multiprocessing-" "start-methods`) will change away from *fork* in Python 3.14. Code that " @@ -323,13 +323,13 @@ msgid "" "get_context(\"fork\")`` parameter." msgstr "" -#: library/concurrent.futures.rst:292 +#: library/concurrent.futures.rst:293 msgid "" "The *max_tasks_per_child* argument was added to allow users to control the " "lifetime of workers in the pool." msgstr "" -#: library/concurrent.futures.rst:296 +#: library/concurrent.futures.rst:297 msgid "" "On POSIX systems, if your application has multiple threads and the :mod:" "`multiprocessing` context uses the ``\"fork\"`` start method: The :func:`os." @@ -338,28 +338,28 @@ msgid "" "start method. See the :func:`os.fork` documentation for further explanation." msgstr "" -#: library/concurrent.futures.rst:307 +#: library/concurrent.futures.rst:308 msgid "ProcessPoolExecutor Example" msgstr "" -#: library/concurrent.futures.rst:345 +#: library/concurrent.futures.rst:346 msgid "Future Objects" msgstr "" -#: library/concurrent.futures.rst:347 +#: library/concurrent.futures.rst:348 msgid "" "The :class:`Future` class encapsulates the asynchronous execution of a " "callable. :class:`Future` instances are created by :meth:`Executor.submit`." msgstr "" -#: library/concurrent.futures.rst:352 +#: library/concurrent.futures.rst:353 msgid "" "Encapsulates the asynchronous execution of a callable. :class:`Future` " "instances are created by :meth:`Executor.submit` and should not be created " "directly except for testing." msgstr "" -#: library/concurrent.futures.rst:358 +#: library/concurrent.futures.rst:359 msgid "" "Attempt to cancel the call. If the call is currently being executed or " "finished running and cannot be cancelled then the method will return " @@ -367,22 +367,22 @@ msgid "" "``True``." msgstr "" -#: library/concurrent.futures.rst:365 +#: library/concurrent.futures.rst:366 msgid "Return ``True`` if the call was successfully cancelled." msgstr "" -#: library/concurrent.futures.rst:369 +#: library/concurrent.futures.rst:370 msgid "" "Return ``True`` if the call is currently being executed and cannot be " "cancelled." msgstr "" -#: library/concurrent.futures.rst:374 +#: library/concurrent.futures.rst:375 msgid "" "Return ``True`` if the call was successfully cancelled or finished running." msgstr "" -#: library/concurrent.futures.rst:379 +#: library/concurrent.futures.rst:380 msgid "" "Return the value returned by the call. If the call hasn't yet completed then " "this method will wait up to *timeout* seconds. If the call hasn't completed " @@ -391,18 +391,18 @@ msgid "" "no limit to the wait time." msgstr "" -#: library/concurrent.futures.rst:386 library/concurrent.futures.rst:400 +#: library/concurrent.futures.rst:387 library/concurrent.futures.rst:401 msgid "" "If the future is cancelled before completing then :exc:`.CancelledError` " "will be raised." msgstr "" -#: library/concurrent.futures.rst:389 +#: library/concurrent.futures.rst:390 msgid "" "If the call raised an exception, this method will raise the same exception." msgstr "" -#: library/concurrent.futures.rst:393 +#: library/concurrent.futures.rst:394 msgid "" "Return the exception raised by the call. If the call hasn't yet completed " "then this method will wait up to *timeout* seconds. If the call hasn't " @@ -411,18 +411,18 @@ msgid "" "``None``, there is no limit to the wait time." msgstr "" -#: library/concurrent.futures.rst:403 +#: library/concurrent.futures.rst:404 msgid "If the call completed without raising, ``None`` is returned." msgstr "" -#: library/concurrent.futures.rst:407 +#: library/concurrent.futures.rst:408 msgid "" "Attaches the callable *fn* to the future. *fn* will be called, with the " "future as its only argument, when the future is cancelled or finishes " "running." msgstr "" -#: library/concurrent.futures.rst:411 +#: library/concurrent.futures.rst:412 msgid "" "Added callables are called in the order that they were added and are always " "called in a thread belonging to the process that added them. If the " @@ -431,26 +431,26 @@ msgid "" "behavior is undefined." msgstr "" -#: library/concurrent.futures.rst:417 +#: library/concurrent.futures.rst:418 msgid "" "If the future has already completed or been cancelled, *fn* will be called " "immediately." msgstr "" -#: library/concurrent.futures.rst:420 +#: library/concurrent.futures.rst:421 msgid "" "The following :class:`Future` methods are meant for use in unit tests and :" "class:`Executor` implementations." msgstr "" -#: library/concurrent.futures.rst:425 +#: library/concurrent.futures.rst:426 msgid "" "This method should only be called by :class:`Executor` implementations " "before executing the work associated with the :class:`Future` and by unit " "tests." msgstr "" -#: library/concurrent.futures.rst:429 +#: library/concurrent.futures.rst:430 msgid "" "If the method returns ``False`` then the :class:`Future` was cancelled, i." "e. :meth:`Future.cancel` was called and returned ``True``. Any threads " @@ -458,47 +458,47 @@ msgid "" "or :func:`wait`) will be woken up." msgstr "" -#: library/concurrent.futures.rst:434 +#: library/concurrent.futures.rst:435 msgid "" "If the method returns ``True`` then the :class:`Future` was not cancelled " "and has been put in the running state, i.e. calls to :meth:`Future.running` " "will return ``True``." msgstr "" -#: library/concurrent.futures.rst:438 +#: library/concurrent.futures.rst:439 msgid "" "This method can only be called once and cannot be called after :meth:`Future." "set_result` or :meth:`Future.set_exception` have been called." msgstr "" -#: library/concurrent.futures.rst:444 +#: library/concurrent.futures.rst:445 msgid "" "Sets the result of the work associated with the :class:`Future` to *result*." msgstr "" -#: library/concurrent.futures.rst:447 library/concurrent.futures.rst:460 +#: library/concurrent.futures.rst:448 library/concurrent.futures.rst:461 msgid "" "This method should only be used by :class:`Executor` implementations and " "unit tests." msgstr "" -#: library/concurrent.futures.rst:450 library/concurrent.futures.rst:463 +#: library/concurrent.futures.rst:451 library/concurrent.futures.rst:464 msgid "" "This method raises :exc:`concurrent.futures.InvalidStateError` if the :class:" "`Future` is already done." msgstr "" -#: library/concurrent.futures.rst:457 +#: library/concurrent.futures.rst:458 msgid "" "Sets the result of the work associated with the :class:`Future` to the :" "class:`Exception` *exception*." msgstr "" -#: library/concurrent.futures.rst:469 +#: library/concurrent.futures.rst:470 msgid "Module Functions" msgstr "" -#: library/concurrent.futures.rst:473 +#: library/concurrent.futures.rst:474 msgid "" "Wait for the :class:`Future` instances (possibly created by different :class:" "`Executor` instances) given by *fs* to complete. Duplicate futures given to " @@ -509,51 +509,39 @@ msgid "" "running futures)." msgstr "" -#: library/concurrent.futures.rst:481 +#: library/concurrent.futures.rst:482 msgid "" "*timeout* can be used to control the maximum number of seconds to wait " "before returning. *timeout* can be an int or float. If *timeout* is not " "specified or ``None``, there is no limit to the wait time." msgstr "" -#: library/concurrent.futures.rst:485 +#: library/concurrent.futures.rst:486 msgid "" "*return_when* indicates when this function should return. It must be one of " "the following constants:" msgstr "" -#: library/concurrent.futures.rst:491 +#: library/concurrent.futures.rst:492 msgid "Constant" msgstr "" -#: library/concurrent.futures.rst:491 -msgid "Description" -msgstr "" - -#: library/concurrent.futures.rst:493 -msgid ":const:`FIRST_COMPLETED`" -msgstr "" - #: library/concurrent.futures.rst:493 -msgid "The function will return when any future finishes or is cancelled." +msgid "Description" msgstr "" #: library/concurrent.futures.rst:496 -msgid ":const:`FIRST_EXCEPTION`" +msgid "The function will return when any future finishes or is cancelled." msgstr "" -#: library/concurrent.futures.rst:496 +#: library/concurrent.futures.rst:499 msgid "" -"The function will return when any future finishes by raising an exception. " +"The function will return when any future finishes by raising an exception. " "If no future raises an exception then it is equivalent to :const:" "`ALL_COMPLETED`." msgstr "" -#: library/concurrent.futures.rst:502 -msgid ":const:`ALL_COMPLETED`" -msgstr "" - -#: library/concurrent.futures.rst:502 +#: library/concurrent.futures.rst:504 msgid "The function will return when all futures finish or are cancelled." msgstr "" @@ -614,14 +602,14 @@ msgstr "" #: library/concurrent.futures.rst:564 msgid "" "Derived from :exc:`~concurrent.futures.BrokenExecutor`, this exception class " -"is raised when one of the workers of a :class:`ThreadPoolExecutor` has " -"failed initializing." +"is raised when one of the workers of a :class:`~concurrent.futures." +"ThreadPoolExecutor` has failed initializing." msgstr "" -#: library/concurrent.futures.rst:574 +#: library/concurrent.futures.rst:575 msgid "" "Derived from :exc:`~concurrent.futures.BrokenExecutor` (formerly :exc:" "`RuntimeError`), this exception class is raised when one of the workers of " -"a :class:`ProcessPoolExecutor` has terminated in a non-clean fashion (for " -"example, if it was killed from the outside)." +"a :class:`~concurrent.futures.ProcessPoolExecutor` has terminated in a non-" +"clean fashion (for example, if it was killed from the outside)." msgstr "" diff --git a/library/configparser.po b/library/configparser.po index d273d90e7..c2571fdad 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -836,8 +836,8 @@ msgstr "" #: library/configparser.rst:1048 msgid "" -"The *encoding* parameter. Previously, all files were read using the default " -"encoding for :func:`open`." +"Added the *encoding* parameter. Previously, all files were read using the " +"default encoding for :func:`open`." msgstr "" #: library/configparser.rst:1052 @@ -1101,8 +1101,8 @@ msgstr "" #: library/configparser.rst:1294 msgid "" -"Optional ``source`` and ``lineno`` attributes and arguments to :meth:`!" -"__init__` were added." +"Added the optional *source* and *lineno* attributes and parameters to :meth:" +"`!__init__`." msgstr "" #: library/configparser.rst:1301 diff --git a/library/contextlib.po b/library/contextlib.po index c948d3204..a8f171bd2 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -177,20 +177,29 @@ msgid "" "``page.close()`` will be called when the :keyword:`with` block is exited." msgstr "" -#: library/contextlib.rst:188 +#: library/contextlib.rst:187 +msgid "" +"Most types managing resources support the :term:`context manager` protocol, " +"which closes *thing* on leaving the :keyword:`with` statement. As such, :" +"func:`!closing` is most useful for third party types that don't support " +"context managers. This example is purely for illustration purposes, as :func:" +"`~urllib.request.urlopen` would normally be used in a context manager." +msgstr "" + +#: library/contextlib.rst:196 msgid "" "Return an async context manager that calls the ``aclose()`` method of " "*thing* upon completion of the block. This is basically equivalent to::" msgstr "" -#: library/contextlib.rst:200 +#: library/contextlib.rst:208 msgid "" "Significantly, ``aclosing()`` supports deterministic cleanup of async " "generators when they happen to exit early by :keyword:`break` or an " "exception. For example::" msgstr "" -#: library/contextlib.rst:211 +#: library/contextlib.rst:219 msgid "" "This pattern ensures that the generator's async exit code is executed in the " "same context as its iterations (so that exceptions and context variables " @@ -198,28 +207,28 @@ msgid "" "task it depends on)." msgstr "" -#: library/contextlib.rst:223 +#: library/contextlib.rst:231 msgid "" "Return a context manager that returns *enter_result* from ``__enter__``, but " "otherwise does nothing. It is intended to be used as a stand-in for an " "optional context manager, for example::" msgstr "" -#: library/contextlib.rst:237 +#: library/contextlib.rst:245 msgid "An example using *enter_result*::" msgstr "" -#: library/contextlib.rst:250 +#: library/contextlib.rst:258 msgid "" "It can also be used as a stand-in for :ref:`asynchronous context managers " "`::" msgstr "" -#: library/contextlib.rst:266 +#: library/contextlib.rst:274 msgid ":term:`asynchronous context manager` support was added." msgstr "" -#: library/contextlib.rst:273 +#: library/contextlib.rst:281 msgid "" "Return a context manager that suppresses any of the specified exceptions if " "they occur in the body of a :keyword:`!with` statement and then resumes " @@ -227,7 +236,7 @@ msgid "" "statement." msgstr "" -#: library/contextlib.rst:278 +#: library/contextlib.rst:286 msgid "" "As with any other mechanism that completely suppresses exceptions, this " "context manager should be used only to cover very specific errors where " @@ -235,19 +244,19 @@ msgid "" "do." msgstr "" -#: library/contextlib.rst:283 +#: library/contextlib.rst:291 msgid "For example::" msgstr "" -#: library/contextlib.rst:293 +#: library/contextlib.rst:301 msgid "This code is equivalent to::" msgstr "" -#: library/contextlib.rst:352 library/contextlib.rst:379 +#: library/contextlib.rst:360 library/contextlib.rst:387 msgid "This context manager is :ref:`reentrant `." msgstr "" -#: library/contextlib.rst:307 +#: 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 " @@ -255,25 +264,25 @@ msgid "" "re-raised." msgstr "" -#: library/contextlib.rst:313 +#: library/contextlib.rst:321 msgid "" "``suppress`` now supports suppressing exceptions raised as part of an :exc:" "`BaseExceptionGroup`." msgstr "" -#: library/contextlib.rst:319 +#: library/contextlib.rst:327 msgid "" "Context manager for temporarily redirecting :data:`sys.stdout` to another " "file or file-like object." msgstr "" -#: library/contextlib.rst:322 +#: library/contextlib.rst:330 msgid "" "This tool adds flexibility to existing functions or classes whose output is " "hardwired to stdout." msgstr "" -#: library/contextlib.rst:325 +#: library/contextlib.rst:333 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 :" @@ -282,17 +291,17 @@ msgid "" "`with` statement::" msgstr "" -#: library/contextlib.rst:335 +#: library/contextlib.rst:343 msgid "" "To send the output of :func:`help` to a file on disk, redirect the output to " "a regular file::" msgstr "" -#: library/contextlib.rst:342 +#: library/contextlib.rst:350 msgid "To send the output of :func:`help` to *sys.stderr*::" msgstr "" -#: library/contextlib.rst:347 +#: library/contextlib.rst:355 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 " @@ -300,13 +309,13 @@ msgid "" "it is still a useful approach for many utility scripts." msgstr "" -#: library/contextlib.rst:359 +#: library/contextlib.rst:367 msgid "" "Similar to :func:`~contextlib.redirect_stdout` but redirecting :data:`sys." "stderr` to another file or file-like object." msgstr "" -#: library/contextlib.rst:369 +#: library/contextlib.rst:377 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 " @@ -316,60 +325,60 @@ msgid "" "when this context manager is active." msgstr "" -#: library/contextlib.rst:376 +#: library/contextlib.rst:384 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:386 +#: library/contextlib.rst:394 msgid "" "A base class that enables a context manager to also be used as a decorator." msgstr "" -#: library/contextlib.rst:388 +#: library/contextlib.rst:396 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:392 +#: library/contextlib.rst:400 msgid "" "``ContextDecorator`` is used by :func:`contextmanager`, so you get this " "functionality automatically." msgstr "" -#: library/contextlib.rst:395 +#: library/contextlib.rst:403 msgid "Example of ``ContextDecorator``::" msgstr "" -#: library/contextlib.rst:480 +#: library/contextlib.rst:488 msgid "The class can then be used like this::" msgstr "" -#: library/contextlib.rst:426 +#: library/contextlib.rst:434 msgid "" "This change is just syntactic sugar for any construct of the following form::" msgstr "" -#: library/contextlib.rst:432 +#: library/contextlib.rst:440 msgid "``ContextDecorator`` lets you instead write::" msgstr "" -#: library/contextlib.rst:438 +#: library/contextlib.rst:446 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:441 +#: library/contextlib.rst:449 msgid "" "Existing context managers that already have a base class can be extended by " "using ``ContextDecorator`` as a mixin class::" msgstr "" -#: library/contextlib.rst:454 +#: library/contextlib.rst:462 msgid "" "As the decorated function must be able to be called multiple times, the " "underlying context manager must support use in multiple :keyword:`with` " @@ -377,35 +386,35 @@ msgid "" "explicit :keyword:`!with` statement inside the function should be used." msgstr "" -#: library/contextlib.rst:464 +#: library/contextlib.rst:472 msgid "" "Similar to :class:`ContextDecorator` but only for asynchronous functions." msgstr "" -#: library/contextlib.rst:466 +#: library/contextlib.rst:474 msgid "Example of ``AsyncContextDecorator``::" msgstr "" -#: library/contextlib.rst:505 +#: library/contextlib.rst:513 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:509 +#: library/contextlib.rst:517 msgid "" "For example, a set of files may easily be handled in a single with statement " "as follows::" msgstr "" -#: library/contextlib.rst:518 +#: library/contextlib.rst:526 msgid "" "The :meth:`~object.__enter__` method returns the :class:`ExitStack` " "instance, and performs no additional operations." msgstr "" -#: library/contextlib.rst:521 +#: library/contextlib.rst:529 msgid "" "Each instance maintains a stack of registered callbacks that are called in " "reverse order when the instance is closed (either explicitly or implicitly " @@ -413,14 +422,14 @@ msgid "" "invoked implicitly when the context stack instance is garbage collected." msgstr "" -#: library/contextlib.rst:526 +#: library/contextlib.rst:534 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:530 +#: library/contextlib.rst:538 msgid "" "Since registered callbacks are invoked in the reverse order of registration, " "this ends up behaving as if multiple nested :keyword:`with` statements had " @@ -430,7 +439,7 @@ msgid "" "updated state." msgstr "" -#: library/contextlib.rst:537 +#: library/contextlib.rst:545 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 " @@ -438,76 +447,76 @@ msgid "" "in application specific ways." msgstr "" -#: library/contextlib.rst:546 +#: library/contextlib.rst:554 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:550 +#: library/contextlib.rst:558 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:553 +#: library/contextlib.rst:561 msgid "" "Raises :exc:`TypeError` instead of :exc:`AttributeError` if *cm* is not a " "context manager." msgstr "" -#: library/contextlib.rst:559 +#: library/contextlib.rst:567 msgid "" "Adds a context manager's :meth:`~object.__exit__` method to the callback " "stack." msgstr "" -#: library/contextlib.rst:561 +#: library/contextlib.rst:569 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:565 +#: library/contextlib.rst:573 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:569 +#: library/contextlib.rst:577 msgid "" "By returning true values, these callbacks can suppress exceptions the same " "way context manager :meth:`~object.__exit__` methods can." msgstr "" -#: library/contextlib.rst:572 +#: library/contextlib.rst:580 msgid "" "The passed in object is returned from the function, allowing this method to " "be used as a function decorator." msgstr "" -#: library/contextlib.rst:577 +#: library/contextlib.rst:585 msgid "" "Accepts an arbitrary callback function and arguments and adds it to the " "callback stack." msgstr "" -#: library/contextlib.rst:580 +#: library/contextlib.rst:588 msgid "" "Unlike the other methods, callbacks added this way cannot suppress " "exceptions (as they are never passed the exception details)." msgstr "" -#: library/contextlib.rst:583 +#: library/contextlib.rst:591 msgid "" "The passed in callback is returned from the function, allowing this method " "to be used as a function decorator." msgstr "" -#: library/contextlib.rst:588 +#: library/contextlib.rst:596 msgid "" "Transfers the callback stack to a fresh :class:`ExitStack` instance and " "returns it. No callbacks are invoked by this operation - instead, they will " @@ -515,77 +524,77 @@ msgid "" "at the end of a :keyword:`with` statement)." msgstr "" -#: library/contextlib.rst:593 +#: library/contextlib.rst:601 msgid "" "For example, a group of files can be opened as an \"all or nothing\" " "operation as follows::" msgstr "" -#: library/contextlib.rst:607 +#: library/contextlib.rst:615 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:614 +#: library/contextlib.rst:622 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:619 +#: library/contextlib.rst:627 msgid "" "The :meth:`~ExitStack.close` method is not implemented; :meth:`aclose` must " "be used instead." msgstr "" -#: library/contextlib.rst:624 +#: library/contextlib.rst:632 msgid "" "Similar to :meth:`ExitStack.enter_context` but expects an asynchronous " "context manager." msgstr "" -#: library/contextlib.rst:627 +#: library/contextlib.rst:635 msgid "" "Raises :exc:`TypeError` instead of :exc:`AttributeError` if *cm* is not an " "asynchronous context manager." msgstr "" -#: library/contextlib.rst:633 +#: library/contextlib.rst:641 msgid "" "Similar to :meth:`ExitStack.push` but expects either an asynchronous context " "manager or a coroutine function." msgstr "" -#: library/contextlib.rst:638 +#: library/contextlib.rst:646 msgid "Similar to :meth:`ExitStack.callback` but expects a coroutine function." msgstr "" -#: library/contextlib.rst:642 +#: library/contextlib.rst:650 msgid "Similar to :meth:`ExitStack.close` but properly handles awaitables." msgstr "" -#: library/contextlib.rst:644 +#: library/contextlib.rst:652 msgid "Continuing the example for :func:`asynccontextmanager`::" msgstr "" -#: library/contextlib.rst:656 +#: library/contextlib.rst:664 msgid "Examples and Recipes" msgstr "" -#: library/contextlib.rst:658 +#: library/contextlib.rst:666 msgid "" "This section describes some examples and recipes for making effective use of " "the tools provided by :mod:`contextlib`." msgstr "" -#: library/contextlib.rst:663 +#: library/contextlib.rst:671 msgid "Supporting a variable number of context managers" msgstr "" -#: library/contextlib.rst:665 +#: library/contextlib.rst:673 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 " @@ -595,18 +604,18 @@ msgid "" "of the context managers being optional::" msgstr "" -#: library/contextlib.rst:680 +#: library/contextlib.rst:688 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:686 +#: library/contextlib.rst:694 msgid "Catching exceptions from ``__enter__`` methods" msgstr "" -#: library/contextlib.rst:688 +#: library/contextlib.rst:696 msgid "" "It is occasionally desirable to catch exceptions from an ``__enter__`` " "method implementation, *without* inadvertently catching exceptions from the :" @@ -615,7 +624,7 @@ msgid "" "be separated slightly in order to allow this::" msgstr "" -#: library/contextlib.rst:703 +#: library/contextlib.rst:711 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 :" @@ -626,29 +635,29 @@ msgid "" "`with` statement." msgstr "" -#: library/contextlib.rst:713 +#: library/contextlib.rst:721 msgid "Cleaning up in an ``__enter__`` implementation" msgstr "" -#: library/contextlib.rst:715 +#: library/contextlib.rst:723 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:719 +#: library/contextlib.rst:727 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:759 +#: library/contextlib.rst:767 msgid "Replacing any use of ``try-finally`` and flag variables" msgstr "" -#: library/contextlib.rst:761 +#: library/contextlib.rst:769 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 " @@ -656,57 +665,57 @@ msgid "" "by using an ``except`` clause instead), it looks something like this::" msgstr "" -#: library/contextlib.rst:775 +#: library/contextlib.rst:783 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:779 +#: library/contextlib.rst:787 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:791 +#: library/contextlib.rst:799 msgid "" "This allows the intended cleanup up behaviour to be made explicit up front, " "rather than requiring a separate flag variable." msgstr "" -#: library/contextlib.rst:794 +#: library/contextlib.rst:802 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:812 +#: library/contextlib.rst:820 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:827 +#: library/contextlib.rst:835 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:833 +#: library/contextlib.rst:841 msgid "Using a context manager as a function decorator" msgstr "" -#: library/contextlib.rst:835 +#: library/contextlib.rst:843 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:838 +#: library/contextlib.rst:846 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. " @@ -715,15 +724,15 @@ msgid "" "in a single definition::" msgstr "" -#: library/contextlib.rst:859 +#: library/contextlib.rst:867 msgid "Instances of this class can be used as both a context manager::" msgstr "" -#: library/contextlib.rst:865 +#: library/contextlib.rst:873 msgid "And also as a function decorator::" msgstr "" -#: library/contextlib.rst:872 +#: library/contextlib.rst:880 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:" @@ -731,21 +740,21 @@ msgid "" "use an explicit ``with`` statement." msgstr "" -#: library/contextlib.rst:880 +#: library/contextlib.rst:888 msgid ":pep:`343` - The \"with\" statement" msgstr "" -#: library/contextlib.rst:880 +#: library/contextlib.rst:888 msgid "" "The specification, background, and examples for the Python :keyword:`with` " "statement." msgstr "" -#: library/contextlib.rst:886 +#: library/contextlib.rst:894 msgid "Single use, reusable and reentrant context managers" msgstr "" -#: library/contextlib.rst:888 +#: library/contextlib.rst:896 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 " @@ -753,32 +762,32 @@ msgid "" "them a second time will trigger an exception or otherwise not work correctly." msgstr "" -#: library/contextlib.rst:894 +#: library/contextlib.rst:902 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:898 +#: library/contextlib.rst:906 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:902 +#: library/contextlib.rst:910 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:930 +#: library/contextlib.rst:938 msgid "Reentrant context managers" msgstr "" -#: library/contextlib.rst:932 +#: library/contextlib.rst:940 msgid "" "More sophisticated context managers may be \"reentrant\". These context " "managers can not only be used in multiple :keyword:`with` statements, but " @@ -786,21 +795,21 @@ msgid "" "the same context manager." msgstr "" -#: library/contextlib.rst:937 +#: library/contextlib.rst:945 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:956 +#: library/contextlib.rst:964 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:960 +#: library/contextlib.rst:968 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, " @@ -808,11 +817,11 @@ msgid "" "stdout` to a different stream." msgstr "" -#: library/contextlib.rst:969 +#: library/contextlib.rst:977 msgid "Reusable context managers" msgstr "" -#: library/contextlib.rst:971 +#: library/contextlib.rst:979 msgid "" "Distinct from both single use and reentrant context managers are " "\"reusable\" context managers (or, to be completely explicit, \"reusable, " @@ -822,21 +831,21 @@ msgid "" "manager instance has already been used in a containing with statement." msgstr "" -#: library/contextlib.rst:978 +#: library/contextlib.rst:986 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:982 +#: library/contextlib.rst:990 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:1013 +#: library/contextlib.rst:1021 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 " @@ -844,7 +853,7 @@ msgid "" "which is unlikely to be desirable behaviour." msgstr "" -#: library/contextlib.rst:1018 +#: library/contextlib.rst:1026 msgid "" "Using separate :class:`ExitStack` instances instead of reusing a single " "instance avoids that problem::" diff --git a/library/contextvars.po b/library/contextvars.po index efb3bac2b..4561fb986 100644 --- a/library/contextvars.po +++ b/library/contextvars.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-02-01 22:19+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -163,8 +163,9 @@ msgstr "" #: library/contextvars.rst:134 msgid "" -"The function has an O(1) complexity, i.e. works equally fast for contexts " -"with a few context variables and for contexts that have a lot of them." +"The function has an *O*\\ (1) complexity, i.e. works equally fast for " +"contexts with a few context variables and for contexts that have a lot of " +"them." msgstr "" #: library/contextvars.rst:141 diff --git a/library/csv.po b/library/csv.po index 872e9bc14..e3c1bb114 100644 --- a/library/csv.po +++ b/library/csv.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -102,20 +102,20 @@ msgstr "" msgid "" "Return a writer object responsible for converting the user's data into " "delimited strings on the given file-like object. *csvfile* can be any " -"object with a :func:`write` method. If *csvfile* is a file object, it " -"should be opened with ``newline=''`` [1]_. An optional *dialect* parameter " -"can be given which is used to define a set of parameters specific to a " -"particular CSV dialect. It may be an instance of a subclass of the :class:" -"`Dialect` class or one of the strings returned by the :func:`list_dialects` " -"function. The other optional *fmtparams* keyword arguments can be given to " -"override individual formatting parameters in the current dialect. For full " -"details about dialects and formatting parameters, see the :ref:`csv-fmt-" -"params` section. To make it as easy as possible to interface with modules " -"which implement the DB API, the value :const:`None` is written as the empty " -"string. While this isn't a reversible transformation, it makes it easier to " -"dump SQL NULL data values to CSV files without preprocessing the data " -"returned from a ``cursor.fetch*`` call. All other non-string data are " -"stringified with :func:`str` before being written." +"object with a :meth:`~io.TextIOBase.write` method. If *csvfile* is a file " +"object, it should be opened with ``newline=''`` [1]_. An optional *dialect* " +"parameter can be given which is used to define a set of parameters specific " +"to a particular CSV dialect. It may be an instance of a subclass of the :" +"class:`Dialect` class or one of the strings returned by the :func:" +"`list_dialects` function. The other optional *fmtparams* keyword arguments " +"can be given to override individual formatting parameters in the current " +"dialect. For full details about dialects and formatting parameters, see " +"the :ref:`csv-fmt-params` section. To make it as easy as possible to " +"interface with modules which implement the DB API, the value :const:`None` " +"is written as the empty string. While this isn't a reversible " +"transformation, it makes it easier to dump SQL NULL data values to CSV files " +"without preprocessing the data returned from a ``cursor.fetch*`` call. All " +"other non-string data are stringified with :func:`str` before being written." msgstr "" #: library/csv.rst:118 @@ -203,15 +203,15 @@ msgid "" "Create an object which operates like a regular writer but maps dictionaries " "onto output rows. The *fieldnames* parameter is a :mod:`sequence " "` of keys that identify the order in which values in the " -"dictionary passed to the :meth:`writerow` method are written to file *f*. " -"The optional *restval* parameter specifies the value to be written if the " -"dictionary is missing a key in *fieldnames*. If the dictionary passed to " -"the :meth:`writerow` method contains a key not found in *fieldnames*, the " -"optional *extrasaction* parameter indicates what action to take. If it is " -"set to ``'raise'``, the default value, a :exc:`ValueError` is raised. If it " -"is set to ``'ignore'``, extra values in the dictionary are ignored. Any " -"other optional or keyword arguments are passed to the underlying :class:" -"`writer` instance." +"dictionary passed to the :meth:`~csvwriter.writerow` method are written to " +"file *f*. The optional *restval* parameter specifies the value to be " +"written if the dictionary is missing a key in *fieldnames*. If the " +"dictionary passed to the :meth:`~csvwriter.writerow` method contains a key " +"not found in *fieldnames*, the optional *extrasaction* parameter indicates " +"what action to take. If it is set to ``'raise'``, the default value, a :exc:" +"`ValueError` is raised. If it is set to ``'ignore'``, extra values in the " +"dictionary are ignored. Any other optional or keyword arguments are passed " +"to the underlying :class:`writer` instance." msgstr "" #: library/csv.rst:212 @@ -236,42 +236,42 @@ msgid "" "classes through their initializer (``__init__``) functions like this::" msgstr "" -#: library/csv.rst:252 +#: library/csv.rst:251 msgid "" "The :class:`excel` class defines the usual properties of an Excel-generated " "CSV file. It is registered with the dialect name ``'excel'``." msgstr "" -#: library/csv.rst:258 +#: library/csv.rst:257 msgid "" "The :class:`excel_tab` class defines the usual properties of an Excel-" "generated TAB-delimited file. It is registered with the dialect name " "``'excel-tab'``." msgstr "" -#: library/csv.rst:264 +#: library/csv.rst:263 msgid "" "The :class:`unix_dialect` class defines the usual properties of a CSV file " "generated on UNIX systems, i.e. using ``'\\n'`` as line terminator and " "quoting all fields. It is registered with the dialect name ``'unix'``." msgstr "" -#: library/csv.rst:273 +#: library/csv.rst:272 msgid "The :class:`Sniffer` class is used to deduce the format of a CSV file." msgstr "" -#: library/csv.rst:275 +#: library/csv.rst:274 msgid "The :class:`Sniffer` class provides two methods:" msgstr "" -#: library/csv.rst:279 +#: library/csv.rst:278 msgid "" "Analyze the given *sample* and return a :class:`Dialect` subclass reflecting " "the parameters found. If the optional *delimiters* parameter is given, it " "is interpreted as a string containing possible valid delimiter characters." msgstr "" -#: library/csv.rst:287 +#: library/csv.rst:286 msgid "" "Analyze the sample text (presumed to be in CSV format) and return :const:" "`True` if the first row appears to be a series of column headers. Inspecting " @@ -279,58 +279,58 @@ msgid "" "sample contains a header:" msgstr "" -#: library/csv.rst:292 +#: library/csv.rst:291 msgid "the second through n-th rows contain numeric values" msgstr "" -#: library/csv.rst:293 +#: library/csv.rst:292 msgid "" "the second through n-th rows contain strings where at least one value's " "length differs from that of the putative header of that column." msgstr "" -#: library/csv.rst:296 +#: library/csv.rst:295 msgid "" "Twenty rows after the first row are sampled; if more than half of columns + " "rows meet the criteria, :const:`True` is returned." msgstr "" -#: library/csv.rst:301 +#: library/csv.rst:300 msgid "" "This method is a rough heuristic and may produce both false positives and " "negatives." msgstr "" -#: library/csv.rst:304 +#: library/csv.rst:303 msgid "An example for :class:`Sniffer` use::" msgstr "" -#: library/csv.rst:315 +#: library/csv.rst:314 msgid "The :mod:`csv` module defines the following constants:" msgstr "" -#: library/csv.rst:319 +#: library/csv.rst:318 msgid "Instructs :class:`writer` objects to quote all fields." msgstr "" -#: library/csv.rst:324 +#: library/csv.rst:323 msgid "" "Instructs :class:`writer` objects to only quote those fields which contain " "special characters such as *delimiter*, *quotechar* or any of the characters " "in *lineterminator*." msgstr "" -#: library/csv.rst:331 +#: library/csv.rst:330 msgid "Instructs :class:`writer` objects to quote all non-numeric fields." msgstr "" -#: library/csv.rst:333 +#: library/csv.rst:332 msgid "" "Instructs :class:`reader` objects to convert all non-quoted fields to type " "*float*." msgstr "" -#: library/csv.rst:338 +#: library/csv.rst:337 msgid "" "Instructs :class:`writer` objects to never quote fields. When the current " "*delimiter* occurs in output data it is preceded by the current *escapechar* " @@ -338,73 +338,73 @@ msgid "" "if any characters that require escaping are encountered." msgstr "" -#: library/csv.rst:343 +#: library/csv.rst:342 msgid "" "Instructs :class:`reader` objects to perform no special processing of quote " "characters." msgstr "" -#: library/csv.rst:347 +#: library/csv.rst:346 msgid "" "Instructs :class:`writer` objects to quote all fields which are not " "``None``. This is similar to :data:`QUOTE_ALL`, except that if a field " "value is ``None`` an empty (unquoted) string is written." msgstr "" -#: library/csv.rst:351 +#: library/csv.rst:350 msgid "" "Instructs :class:`reader` objects to interpret an empty (unquoted) field as " "None and to otherwise behave as :data:`QUOTE_ALL`." msgstr "" -#: library/csv.rst:356 +#: library/csv.rst:357 msgid "" "Instructs :class:`writer` objects to always place quotes around fields which " "are strings. This is similar to :data:`QUOTE_NONNUMERIC`, except that if a " "field value is ``None`` an empty (unquoted) string is written." msgstr "" -#: library/csv.rst:360 +#: library/csv.rst:361 msgid "" "Instructs :class:`reader` objects to interpret an empty (unquoted) string as " "``None`` and to otherwise behave as :data:`QUOTE_NONNUMERIC`." msgstr "" -#: library/csv.rst:363 +#: library/csv.rst:366 msgid "The :mod:`csv` module defines the following exception:" msgstr "" -#: library/csv.rst:368 +#: library/csv.rst:371 msgid "Raised by any of the functions when an error is detected." msgstr "" -#: library/csv.rst:373 +#: library/csv.rst:376 msgid "Dialects and Formatting Parameters" msgstr "" -#: library/csv.rst:375 +#: library/csv.rst:378 msgid "" "To make it easier to specify the format of input and output records, " "specific formatting parameters are grouped together into dialects. A " -"dialect is a subclass of the :class:`Dialect` class having a set of specific " -"methods and a single :meth:`validate` method. When creating :class:`reader` " -"or :class:`writer` objects, the programmer can specify a string or a " -"subclass of the :class:`Dialect` class as the dialect parameter. In " +"dialect is a subclass of the :class:`Dialect` class containing various " +"attributes describing the format of the CSV file. When creating :class:" +"`reader` or :class:`writer` objects, the programmer can specify a string or " +"a subclass of the :class:`Dialect` class as the dialect parameter. In " "addition to, or instead of, the *dialect* parameter, the programmer can also " "specify individual formatting parameters, which have the same names as the " "attributes defined below for the :class:`Dialect` class." msgstr "" -#: library/csv.rst:385 +#: library/csv.rst:388 msgid "Dialects support the following attributes:" msgstr "" -#: library/csv.rst:390 +#: library/csv.rst:393 msgid "" "A one-character string used to separate fields. It defaults to ``','``." msgstr "" -#: library/csv.rst:395 +#: library/csv.rst:398 msgid "" "Controls how instances of *quotechar* appearing inside a field should " "themselves be quoted. When :const:`True`, the character is doubled. When :" @@ -412,13 +412,13 @@ msgid "" "defaults to :const:`True`." msgstr "" -#: library/csv.rst:400 +#: library/csv.rst:403 msgid "" "On output, if *doublequote* is :const:`False` and no *escapechar* is set, :" "exc:`Error` is raised if a *quotechar* is found in a field." msgstr "" -#: library/csv.rst:406 +#: library/csv.rst:409 msgid "" "A one-character string used by the writer to escape the *delimiter* if " "*quoting* is set to :const:`QUOTE_NONE` and the *quotechar* if *doublequote* " @@ -427,64 +427,64 @@ msgid "" "escaping." msgstr "" -#: library/csv.rst:411 +#: library/csv.rst:414 msgid "An empty *escapechar* is not allowed." msgstr "" -#: library/csv.rst:416 +#: library/csv.rst:419 msgid "" "The string used to terminate lines produced by the :class:`writer`. It " "defaults to ``'\\r\\n'``." msgstr "" -#: library/csv.rst:421 +#: library/csv.rst:424 msgid "" "The :class:`reader` is hard-coded to recognise either ``'\\r'`` or ``'\\n'`` " "as end-of-line, and ignores *lineterminator*. This behavior may change in " "the future." msgstr "" -#: library/csv.rst:428 +#: library/csv.rst:431 msgid "" "A one-character string used to quote fields containing special characters, " "such as the *delimiter* or *quotechar*, or which contain new-line " "characters. It defaults to ``'\"'``." msgstr "" -#: library/csv.rst:432 +#: library/csv.rst:435 msgid "An empty *quotechar* is not allowed." msgstr "" -#: library/csv.rst:437 +#: library/csv.rst:440 msgid "" "Controls when quotes should be generated by the writer and recognised by the " "reader. It can take on any of the :ref:`QUOTE_\\* constants ` and defaults to :const:`QUOTE_MINIMAL`." msgstr "" -#: library/csv.rst:444 +#: library/csv.rst:447 msgid "" "When :const:`True`, spaces immediately following the *delimiter* are " "ignored. The default is :const:`False`." msgstr "" -#: library/csv.rst:450 +#: library/csv.rst:453 msgid "" "When ``True``, raise exception :exc:`Error` on bad CSV input. The default is " "``False``." msgstr "" -#: library/csv.rst:456 +#: library/csv.rst:459 msgid "Reader Objects" msgstr "" -#: library/csv.rst:458 +#: library/csv.rst:461 msgid "" "Reader objects (:class:`DictReader` instances and objects returned by the :" "func:`reader` function) have the following public methods:" msgstr "" -#: library/csv.rst:463 +#: library/csv.rst:466 msgid "" "Return the next row of the reader's iterable object as a list (if the object " "was returned from :func:`reader`) or a dict (if it is a :class:`DictReader` " @@ -492,39 +492,39 @@ msgid "" "should call this as ``next(reader)``." msgstr "" -#: library/csv.rst:469 +#: library/csv.rst:472 msgid "Reader objects have the following public attributes:" msgstr "" -#: library/csv.rst:473 +#: library/csv.rst:476 msgid "A read-only description of the dialect in use by the parser." msgstr "" -#: library/csv.rst:478 +#: library/csv.rst:481 msgid "" "The number of lines read from the source iterator. This is not the same as " "the number of records returned, as records can span multiple lines." msgstr "" -#: library/csv.rst:482 +#: library/csv.rst:485 msgid "DictReader objects have the following public attribute:" msgstr "" -#: library/csv.rst:486 +#: library/csv.rst:489 msgid "" "If not passed as a parameter when creating the object, this attribute is " "initialized upon first access or when the first record is read from the file." msgstr "" -#: library/csv.rst:493 +#: library/csv.rst:496 msgid "Writer Objects" msgstr "" -#: library/csv.rst:495 +#: library/csv.rst:498 msgid "" -":class:`Writer` objects (:class:`DictWriter` instances and objects returned " +":class:`writer` objects (:class:`DictWriter` instances and objects returned " "by the :func:`writer` function) have the following public methods. A *row* " -"must be an iterable of strings or numbers for :class:`Writer` objects and a " +"must be an iterable of strings or numbers for :class:`writer` objects and a " "dictionary mapping fieldnames to strings or numbers (by passing them " "through :func:`str` first) for :class:`DictWriter` objects. Note that " "complex numbers are written out surrounded by parens. This may cause some " @@ -532,66 +532,66 @@ msgid "" "complex numbers at all)." msgstr "" -#: library/csv.rst:506 +#: library/csv.rst:509 msgid "" "Write the *row* parameter to the writer's file object, formatted according " "to the current :class:`Dialect`. Return the return value of the call to the " "*write* method of the underlying file object." msgstr "" -#: library/csv.rst:510 +#: library/csv.rst:513 msgid "Added support of arbitrary iterables." msgstr "" -#: library/csv.rst:515 +#: library/csv.rst:518 msgid "" "Write all elements in *rows* (an iterable of *row* objects as described " "above) to the writer's file object, formatted according to the current " "dialect." msgstr "" -#: library/csv.rst:519 +#: library/csv.rst:522 msgid "Writer objects have the following public attribute:" msgstr "" -#: library/csv.rst:524 +#: library/csv.rst:527 msgid "A read-only description of the dialect in use by the writer." msgstr "" -#: library/csv.rst:527 +#: library/csv.rst:530 msgid "DictWriter objects have the following public method:" msgstr "" -#: library/csv.rst:532 +#: library/csv.rst:535 msgid "" "Write a row with the field names (as specified in the constructor) to the " "writer's file object, formatted according to the current dialect. Return the " "return value of the :meth:`csvwriter.writerow` call used internally." msgstr "" -#: library/csv.rst:537 +#: library/csv.rst:540 msgid "" ":meth:`writeheader` now also returns the value returned by the :meth:" "`csvwriter.writerow` method it uses internally." msgstr "" -#: library/csv.rst:545 +#: library/csv.rst:548 msgid "Examples" msgstr "" -#: library/csv.rst:547 +#: library/csv.rst:550 msgid "The simplest example of reading a CSV file::" msgstr "" -#: library/csv.rst:555 +#: library/csv.rst:558 msgid "Reading a file with an alternate format::" msgstr "" -#: library/csv.rst:563 +#: library/csv.rst:566 msgid "The corresponding simplest possible writing example is::" msgstr "" -#: library/csv.rst:570 +#: library/csv.rst:573 msgid "" "Since :func:`open` is used to open a CSV file for reading, the file will by " "default be decoded into unicode using the system default encoding (see :func:" @@ -599,33 +599,33 @@ msgid "" "``encoding`` argument of open::" msgstr "" -#: library/csv.rst:581 +#: library/csv.rst:584 msgid "" "The same applies to writing in something other than the system default " "encoding: specify the encoding argument when opening the output file." msgstr "" -#: library/csv.rst:584 +#: library/csv.rst:587 msgid "Registering a new dialect::" msgstr "" -#: library/csv.rst:591 +#: library/csv.rst:594 msgid "" "A slightly more advanced use of the reader --- catching and reporting " "errors::" msgstr "" -#: library/csv.rst:603 +#: library/csv.rst:606 msgid "" "And while the module doesn't directly support parsing strings, it can easily " "be done::" msgstr "" -#: library/csv.rst:612 +#: library/csv.rst:615 msgid "Footnotes" msgstr "" -#: library/csv.rst:613 +#: library/csv.rst:616 msgid "" "If ``newline=''`` is not specified, newlines embedded inside quoted fields " "will not be interpreted correctly, and on platforms that use ``\\r\\n`` " diff --git a/library/datetime.po b/library/datetime.po index fbeaf3701..513426831 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: 2023-11-26 17:49-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -25,8 +25,10 @@ msgid "**Source code:** :source:`Lib/datetime.py`" msgstr "**Kaynak kod:** :source:`Lib/datetime.py`" #: library/datetime.rst:17 +#, fuzzy msgid "" -"The :mod:`datetime` module supplies classes for manipulating dates and times." +"The :mod:`!datetime` module supplies classes for manipulating dates and " +"times." msgstr ":mod:`datetime` modülü tarih ve zaman işlemleri için sınıflar sağlar." #: library/datetime.rst:19 @@ -150,9 +152,10 @@ msgstr "" "bilgileri yakalar." #: library/datetime.rst:72 +#, fuzzy msgid "" "Only one concrete :class:`tzinfo` class, the :class:`timezone` class, is " -"supplied by the :mod:`datetime` module. The :class:`timezone` class can " +"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 " "levels of detail is up to the application. The rules for time adjustment " @@ -173,7 +176,8 @@ msgid "Constants" msgstr "Sabitler" #: library/datetime.rst:83 -msgid "The :mod:`datetime` module exports the following constants:" +#, fuzzy +msgid "The :mod:`!datetime` module exports the following constants:" msgstr ":mod:`datetime` modülü aşağıdaki sabitleri dışa aktarır:" #: library/datetime.rst:87 @@ -234,9 +238,10 @@ msgstr "" "`microsecond` ve :attr:`.tzinfo`." #: library/datetime.rst:133 +#, fuzzy msgid "" -"A duration expressing the difference between two :class:`date`, :class:`." -"time`, or :class:`.datetime` instances to microsecond resolution." +"A duration expressing the difference between two :class:`.datetime` or :" +"class:`date` instances to microsecond resolution." msgstr "" "İki :class:`date`, :class:`.time` veya :class:`.datetime` örneği arasındaki " "farkı mikrosaniye çözünürlüğünde ifade eden bir süre." @@ -355,10 +360,13 @@ msgid ":class:`timedelta` Objects" msgstr "" #: library/datetime.rst:205 +#, fuzzy msgid "" "A :class:`timedelta` object represents a duration, the difference between " -"two dates or times." +"two :class:`.datetime` or :class:`date` instances." msgstr "" +"İki :class:`date`, :class:`.time` veya :class:`.datetime` örneği arasındaki " +"farkı mikrosaniye çözünürlüğünde ifade eden bir süre." #: library/datetime.rst:210 msgid "" @@ -434,7 +442,7 @@ msgid "" "example::" msgstr "" -#: library/datetime.rst:561 library/datetime.rst:1693 library/datetime.rst:2298 +#: library/datetime.rst:546 library/datetime.rst:1690 library/datetime.rst:2292 msgid "Class attributes:" msgstr "" @@ -460,7 +468,7 @@ msgid "" "``-timedelta.max`` is not representable as a :class:`timedelta` object." msgstr "" -#: library/datetime.rst:579 library/datetime.rst:1713 +#: library/datetime.rst:564 library/datetime.rst:1710 msgid "Instance attributes (read-only):" msgstr "" @@ -496,15 +504,15 @@ msgstr "" msgid "Between 0 and 999999 inclusive" msgstr "" -#: library/datetime.rst:596 library/datetime.rst:1147 +#: library/datetime.rst:581 library/datetime.rst:1138 msgid "Supported operations:" msgstr "" -#: library/datetime.rst:599 library/datetime.rst:1150 +#: library/datetime.rst:584 library/datetime.rst:1141 msgid "Operation" msgstr "" -#: library/datetime.rst:599 library/datetime.rst:1150 +#: library/datetime.rst:584 library/datetime.rst:1141 msgid "Result" msgstr "" @@ -648,7 +656,7 @@ msgid "" "constructor call with canonical attribute values." msgstr "" -#: library/datetime.rst:613 library/datetime.rst:2529 +#: library/datetime.rst:603 library/datetime.rst:2523 msgid "Notes:" msgstr "" @@ -697,118 +705,104 @@ msgid "" "`timedelta` object by a :class:`float` object are now supported." msgstr "" -#: library/datetime.rst:404 -msgid "" -"Comparisons of :class:`timedelta` objects are supported, with some caveats." -msgstr "" - -#: library/datetime.rst:406 -msgid "" -"The comparisons ``==`` or ``!=`` *always* return a :class:`bool`, no matter " -"the type of the compared object::" +#: library/datetime.rst:403 +msgid ":class:`timedelta` objects support equality and order comparisons." msgstr "" -#: library/datetime.rst:417 -msgid "" -"For all other comparisons (such as ``<`` and ``>``), when a :class:" -"`timedelta` object is compared to an object of a different type, :exc:" -"`TypeError` is raised::" -msgstr "" - -#: library/datetime.rst:428 +#: library/datetime.rst:405 msgid "" "In Boolean contexts, a :class:`timedelta` object is considered to be true if " "and only if it isn't equal to ``timedelta(0)``." msgstr "" -#: library/datetime.rst:642 library/datetime.rst:1823 +#: library/datetime.rst:629 library/datetime.rst:1817 msgid "Instance methods:" msgstr "" -#: library/datetime.rst:435 +#: library/datetime.rst:412 msgid "" "Return the total number of seconds contained in the duration. Equivalent to " "``td / timedelta(seconds=1)``. For interval units other than seconds, use " "the division form directly (e.g. ``td / timedelta(microseconds=1)``)." msgstr "" -#: library/datetime.rst:439 +#: library/datetime.rst:416 msgid "" "Note that for very large time intervals (greater than 270 years on most " "platforms) this method will lose microsecond accuracy." msgstr "" -#: library/datetime.rst:445 +#: library/datetime.rst:422 msgid "Examples of usage: :class:`timedelta`" msgstr "" -#: library/datetime.rst:447 +#: library/datetime.rst:424 msgid "An additional example of normalization::" msgstr "" -#: library/datetime.rst:459 +#: library/datetime.rst:436 msgid "Examples of :class:`timedelta` arithmetic::" msgstr "" -#: library/datetime.rst:478 +#: library/datetime.rst:455 msgid ":class:`date` Objects" msgstr "" -#: library/datetime.rst:480 +#: library/datetime.rst:457 msgid "" "A :class:`date` object represents a date (year, month and day) in an " "idealized calendar, the current Gregorian calendar indefinitely extended in " "both directions." msgstr "" -#: library/datetime.rst:484 +#: library/datetime.rst:461 msgid "" "January 1 of year 1 is called day number 1, January 2 of year 1 is called " "day number 2, and so on. [#]_" msgstr "" -#: library/datetime.rst:489 +#: library/datetime.rst:466 msgid "" "All arguments are required. Arguments must be integers, in the following " "ranges:" msgstr "" -#: library/datetime.rst:492 +#: library/datetime.rst:469 msgid "``MINYEAR <= year <= MAXYEAR``" msgstr "" -#: library/datetime.rst:493 +#: library/datetime.rst:470 msgid "``1 <= month <= 12``" msgstr "" -#: library/datetime.rst:494 +#: library/datetime.rst:471 msgid "``1 <= day <= number of days in the given month and year``" msgstr "" -#: library/datetime.rst:857 +#: library/datetime.rst:844 msgid "" "If an argument outside those ranges is given, :exc:`ValueError` is raised." msgstr "" -#: library/datetime.rst:862 +#: library/datetime.rst:849 msgid "Other constructors, all class methods:" msgstr "" -#: library/datetime.rst:503 +#: library/datetime.rst:480 msgid "Return the current local date." msgstr "" -#: library/datetime.rst:505 +#: library/datetime.rst:482 msgid "This is equivalent to ``date.fromtimestamp(time.time())``." msgstr "" -#: library/datetime.rst:509 +#: library/datetime.rst:486 msgid "" "Return the local date corresponding to the POSIX timestamp, such as is " "returned by :func:`time.time`." msgstr "" -#: library/datetime.rst:512 +#: library/datetime.rst:489 msgid "" "This may raise :exc:`OverflowError`, if the timestamp is out of the range of " "values supported by the platform C :c:func:`localtime` function, and :exc:" @@ -818,7 +812,7 @@ msgid "" "ignored by :meth:`fromtimestamp`." msgstr "" -#: library/datetime.rst:519 +#: library/datetime.rst:496 msgid "" "Raise :exc:`OverflowError` instead of :exc:`ValueError` if the timestamp is " "out of the range of values supported by the platform C :c:func:`localtime` " @@ -826,96 +820,137 @@ msgid "" "`localtime` failure." msgstr "" -#: library/datetime.rst:528 +#: library/datetime.rst:505 msgid "" "Return the date corresponding to the proleptic Gregorian ordinal, where " "January 1 of year 1 has ordinal 1." msgstr "" -#: library/datetime.rst:531 +#: library/datetime.rst:508 msgid "" ":exc:`ValueError` is raised unless ``1 <= ordinal <= date.max.toordinal()``. " "For any date *d*, ``date.fromordinal(d.toordinal()) == d``." msgstr "" -#: library/datetime.rst:538 +#: library/datetime.rst:515 msgid "" "Return a :class:`date` corresponding to a *date_string* given in any valid " -"ISO 8601 format, except ordinal dates (e.g. ``YYYY-DDD``)::" +"ISO 8601 format, with the following exceptions:" msgstr "" -#: library/datetime.rst:550 +#: library/datetime.rst:1005 +msgid "" +"Reduced precision dates are not currently supported (``YYYY-MM``, ``YYYY``)." +msgstr "" + +#: library/datetime.rst:1007 +msgid "" +"Extended date representations are not currently supported (``±YYYYYY-MM-" +"DD``)." +msgstr "" + +#: library/datetime.rst:1009 +msgid "Ordinal dates are not currently supported (``YYYY-OOO``)." +msgstr "" + +#: library/datetime.rst:1011 library/datetime.rst:1446 +msgid "Examples::" +msgstr "" + +#: library/datetime.rst:535 msgid "Previously, this method only supported the format ``YYYY-MM-DD``." msgstr "" -#: library/datetime.rst:555 +#: library/datetime.rst:540 msgid "" "Return a :class:`date` corresponding to the ISO calendar date specified by " "year, week and day. This is the inverse of the function :meth:`date." "isocalendar`." msgstr "" -#: library/datetime.rst:565 +#: library/datetime.rst:550 msgid "The earliest representable date, ``date(MINYEAR, 1, 1)``." msgstr "" -#: library/datetime.rst:570 +#: library/datetime.rst:555 msgid "The latest representable date, ``date(MAXYEAR, 12, 31)``." msgstr "" -#: library/datetime.rst:575 +#: library/datetime.rst:560 msgid "" "The smallest possible difference between non-equal date objects, " "``timedelta(days=1)``." msgstr "" -#: library/datetime.rst:1098 +#: library/datetime.rst:1089 msgid "Between :const:`MINYEAR` and :const:`MAXYEAR` inclusive." msgstr "" -#: library/datetime.rst:1103 +#: library/datetime.rst:1094 msgid "Between 1 and 12 inclusive." msgstr "" -#: library/datetime.rst:1108 +#: library/datetime.rst:1099 msgid "Between 1 and the number of days in the given month of the given year." msgstr "" -#: library/datetime.rst:601 +#: library/datetime.rst:586 msgid "``date2 = date1 + timedelta``" msgstr "" -#: library/datetime.rst:601 +#: library/datetime.rst:586 msgid "*date2* will be ``timedelta.days`` days after *date1*. (1)" msgstr "" -#: library/datetime.rst:604 +#: library/datetime.rst:589 msgid "``date2 = date1 - timedelta``" msgstr "" -#: library/datetime.rst:604 +#: library/datetime.rst:589 msgid "Computes *date2* such that ``date2 + timedelta == date1``. (2)" msgstr "" -#: library/datetime.rst:607 +#: library/datetime.rst:592 msgid "``timedelta = date1 - date2``" msgstr "" -#: library/datetime.rst:1156 +#: library/datetime.rst:1147 msgid "\\(3)" msgstr "" -#: library/datetime.rst:609 +#: library/datetime.rst:0 +msgid "``date1 == date2``" +msgstr "" + +#: library/datetime.rst:0 +msgid "``date1 != date2``" +msgstr "" + +#: library/datetime.rst:1149 +msgid "Equality comparison. (4)" +msgstr "" + +#: library/datetime.rst:0 msgid "``date1 < date2``" msgstr "" -#: library/datetime.rst:609 -msgid "" -"*date1* is considered less than *date2* when *date1* precedes *date2* in " -"time. (4)" +#: library/datetime.rst:0 +msgid "``date1 > date2``" msgstr "" -#: library/datetime.rst:616 +#: library/datetime.rst:0 +msgid "``date1 <= date2``" +msgstr "" + +#: library/datetime.rst:0 +msgid "``date1 >= date2``" +msgstr "" + +#: library/datetime.rst:1152 +msgid "Order comparison. (5)" +msgstr "" + +#: library/datetime.rst:606 msgid "" "*date2* is moved forward in time if ``timedelta.days > 0``, or backward if " "``timedelta.days < 0``. Afterward ``date2 - date1 == timedelta.days``. " @@ -924,97 +959,95 @@ msgid "" "`MINYEAR` or larger than :const:`MAXYEAR`." msgstr "" -#: library/datetime.rst:623 +#: library/datetime.rst:613 msgid "``timedelta.seconds`` and ``timedelta.microseconds`` are ignored." msgstr "" -#: library/datetime.rst:626 +#: library/datetime.rst:616 msgid "" "This is exact, and cannot overflow. timedelta.seconds and timedelta." "microseconds are 0, and date2 + timedelta == date1 after." msgstr "" -#: library/datetime.rst:630 +#: library/datetime.rst:620 +msgid ":class:`date` objects are equal if they represent the same date." +msgstr "" + +#: library/datetime.rst:623 msgid "" -"In other words, ``date1 < date2`` if and only if ``date1.toordinal() < date2." -"toordinal()``. Date comparison raises :exc:`TypeError` if the other " -"comparand isn't also a :class:`date` object. However, ``NotImplemented`` is " -"returned instead if the other comparand has a :meth:`timetuple` attribute. " -"This hook gives other kinds of date objects a chance at implementing mixed-" -"type comparison. If not, when a :class:`date` object is compared to an " -"object of a different type, :exc:`TypeError` is raised unless the comparison " -"is ``==`` or ``!=``. The latter cases return :const:`False` or :const:" -"`True`, respectively." +"*date1* is considered less than *date2* when *date1* precedes *date2* in " +"time. In other words, ``date1 < date2`` if and only if ``date1.toordinal() < " +"date2.toordinal()``." msgstr "" -#: library/datetime.rst:640 +#: library/datetime.rst:627 msgid "" "In Boolean contexts, all :class:`date` objects are considered to be true." msgstr "" -#: library/datetime.rst:646 +#: library/datetime.rst:633 msgid "" "Return a date with the same value, except for those parameters given new " "values by whichever keyword arguments are specified." msgstr "" -#: library/datetime.rst:1866 +#: library/datetime.rst:1860 msgid "Example::" msgstr "" -#: library/datetime.rst:1334 +#: library/datetime.rst:1331 msgid "" "Return a :class:`time.struct_time` such as returned by :func:`time." "localtime`." msgstr "" -#: library/datetime.rst:661 +#: library/datetime.rst:648 msgid "The hours, minutes and seconds are 0, and the DST flag is -1." msgstr "" -#: library/datetime.rst:1336 +#: library/datetime.rst:1333 msgid "``d.timetuple()`` is equivalent to::" msgstr "" -#: library/datetime.rst:667 +#: library/datetime.rst:654 msgid "" "where ``yday = d.toordinal() - date(d.year, 1, 1).toordinal() + 1`` is the " "day number within the current year starting with ``1`` for January 1st." msgstr "" -#: library/datetime.rst:673 +#: library/datetime.rst:660 msgid "" "Return the proleptic Gregorian ordinal of the date, where January 1 of year " "1 has ordinal 1. For any :class:`date` object *d*, ``date.fromordinal(d." "toordinal()) == d``." msgstr "" -#: library/datetime.rst:680 +#: library/datetime.rst:667 msgid "" "Return the day of the week as an integer, where Monday is 0 and Sunday is 6. " "For example, ``date(2002, 12, 4).weekday() == 2``, a Wednesday. See also :" "meth:`isoweekday`." msgstr "" -#: library/datetime.rst:687 +#: library/datetime.rst:674 msgid "" "Return the day of the week as an integer, where Monday is 1 and Sunday is 7. " "For example, ``date(2002, 12, 4).isoweekday() == 3``, a Wednesday. See also :" "meth:`weekday`, :meth:`isocalendar`." msgstr "" -#: library/datetime.rst:694 +#: library/datetime.rst:681 msgid "" "Return a :term:`named tuple` object with three components: ``year``, " "``week`` and ``weekday``." msgstr "" -#: library/datetime.rst:697 +#: library/datetime.rst:684 msgid "" "The ISO calendar is a widely used variant of the Gregorian calendar. [#]_" msgstr "" -#: library/datetime.rst:699 +#: library/datetime.rst:686 msgid "" "The ISO year consists of 52 or 53 full weeks, and where a week starts on a " "Monday and ends on a Sunday. The first week of an ISO year is the first " @@ -1023,41 +1056,41 @@ msgid "" "Gregorian year." msgstr "" -#: library/datetime.rst:704 +#: library/datetime.rst:691 msgid "" "For example, 2004 begins on a Thursday, so the first week of ISO year 2004 " "begins on Monday, 29 Dec 2003 and ends on Sunday, 4 Jan 2004::" msgstr "" -#: library/datetime.rst:713 +#: library/datetime.rst:700 msgid "Result changed from a tuple to a :term:`named tuple`." msgstr "" -#: library/datetime.rst:718 +#: library/datetime.rst:705 msgid "" "Return a string representing the date in ISO 8601 format, ``YYYY-MM-DD``::" msgstr "" -#: library/datetime.rst:726 +#: library/datetime.rst:713 msgid "For a date *d*, ``str(d)`` is equivalent to ``d.isoformat()``." msgstr "" -#: library/datetime.rst:731 +#: library/datetime.rst:718 msgid "Return a string representing the date::" msgstr "" -#: library/datetime.rst:1520 +#: library/datetime.rst:1517 msgid "``d.ctime()`` is equivalent to::" msgstr "" -#: library/datetime.rst:741 +#: library/datetime.rst:728 msgid "" "on platforms where the native C :c:func:`ctime` function (which :func:`time." "ctime` invokes, but which :meth:`date.ctime` does not invoke) conforms to " "the C standard." msgstr "" -#: library/datetime.rst:748 +#: library/datetime.rst:735 msgid "" "Return a string representing the date, controlled by an explicit format " "string. Format codes referring to hours, minutes or seconds will see 0 " @@ -1065,7 +1098,7 @@ msgid "" "isoformat`." msgstr "" -#: library/datetime.rst:755 +#: library/datetime.rst:742 msgid "" "Same as :meth:`.date.strftime`. This makes it possible to specify a format " "string for a :class:`.date` object in :ref:`formatted string literals datetime2``" +msgstr "" + +#: library/datetime.rst:0 +msgid "``datetime1 <= datetime2``" +msgstr "" + +#: library/datetime.rst:0 +msgid "``datetime1 >= datetime2``" msgstr "" -#: library/datetime.rst:1163 +#: library/datetime.rst:1159 msgid "" "datetime2 is a duration of timedelta removed from datetime1, moving forward " "in time if ``timedelta.days`` > 0, or backward if ``timedelta.days`` < 0. " @@ -1478,7 +1519,7 @@ msgid "" "the input is an aware object." msgstr "" -#: library/datetime.rst:1172 +#: library/datetime.rst:1168 msgid "" "Computes the datetime2 such that datetime2 + timedelta == datetime1. As for " "addition, the result has the same :attr:`~.datetime.tzinfo` attribute as the " @@ -1486,14 +1527,14 @@ msgid "" "aware." msgstr "" -#: library/datetime.rst:1177 +#: library/datetime.rst:1173 msgid "" "Subtraction of a :class:`.datetime` from a :class:`.datetime` is defined " "only if both operands are naive, or if both are aware. If one is aware and " "the other is naive, :exc:`TypeError` is raised." msgstr "" -#: library/datetime.rst:1181 +#: library/datetime.rst:1177 msgid "" "If both are naive, or both are aware and have the same :attr:`~.datetime." "tzinfo` attribute, the :attr:`~.datetime.tzinfo` attributes are ignored, and " @@ -1501,78 +1542,84 @@ msgid "" "datetime1``. No time zone adjustments are done in this case." msgstr "" -#: library/datetime.rst:1186 +#: library/datetime.rst:1182 msgid "" "If both are aware and have different :attr:`~.datetime.tzinfo` attributes, " -"``a-b`` acts as if *a* and *b* were first converted to naive UTC datetimes " -"first. The result is ``(a.replace(tzinfo=None) - a.utcoffset()) - (b." +"``a-b`` acts as if *a* and *b* were first converted to naive UTC datetimes. " +"The result is ``(a.replace(tzinfo=None) - a.utcoffset()) - (b." "replace(tzinfo=None) - b.utcoffset())`` except that the implementation never " "overflows." msgstr "" -#: library/datetime.rst:1192 +#: library/datetime.rst:1188 msgid "" -"*datetime1* is considered less than *datetime2* when *datetime1* precedes " -"*datetime2* in time." +":class:`.datetime` objects are equal if they represent the same date and " +"time, taking into account the time zone." msgstr "" -#: library/datetime.rst:1195 +#: library/datetime.rst:1191 msgid "" -"If one comparand is naive and the other is aware, :exc:`TypeError` is raised " -"if an order comparison is attempted. For equality comparisons, naive " -"instances are never equal to aware instances." +"Naive and aware :class:`!datetime` objects are never equal. :class:`!" +"datetime` objects are never equal to :class:`date` objects that are not " +"also :class:`!datetime` instances, even if they represent the same date." msgstr "" -#: library/datetime.rst:1199 +#: library/datetime.rst:1196 msgid "" -"If both comparands are aware, and have the same :attr:`~.datetime.tzinfo` " -"attribute, the common :attr:`~.datetime.tzinfo` attribute is ignored and the " -"base datetimes are compared. If both comparands are aware and have " -"different :attr:`~.datetime.tzinfo` attributes, the comparands are first " -"adjusted by subtracting their UTC offsets (obtained from ``self." -"utcoffset()``)." +"If both comparands are aware and have different :attr:`~.datetime.tzinfo` " +"attributes, the comparison acts as comparands were first converted to UTC " +"datetimes except that the implementation never overflows. :class:`!datetime` " +"instances in a repeated interval are never equal to :class:`!datetime` " +"instances in other time zone." msgstr "" -#: library/datetime.rst:1205 +#: library/datetime.rst:1203 msgid "" -"Equality comparisons between aware and naive :class:`.datetime` instances " -"don't raise :exc:`TypeError`." +"*datetime1* is considered less than *datetime2* when *datetime1* precedes " +"*datetime2* in time, taking into account the time zone." msgstr "" -#: library/datetime.rst:1211 +#: library/datetime.rst:1206 msgid "" -"In order to stop comparison from falling back to the default scheme of " -"comparing object addresses, datetime comparison normally raises :exc:" -"`TypeError` if the other comparand isn't also a :class:`.datetime` object. " -"However, ``NotImplemented`` is returned instead if the other comparand has " -"a :meth:`timetuple` attribute. This hook gives other kinds of date objects a " -"chance at implementing mixed-type comparison. If not, when a :class:`." -"datetime` object is compared to an object of a different type, :exc:" -"`TypeError` is raised unless the comparison is ``==`` or ``!=``. The latter " -"cases return :const:`False` or :const:`True`, respectively." +"Order comparison between naive and aware :class:`.datetime` objects, as well " +"as a :class:`!datetime` object and a :class:`!date` object that is not also " +"a :class:`!datetime` instance, raises :exc:`TypeError`." msgstr "" -#: library/datetime.rst:1225 +#: library/datetime.rst:1210 +msgid "" +"If both comparands are aware and have different :attr:`~.datetime.tzinfo` " +"attributes, the comparison acts as comparands were first converted to UTC " +"datetimes except that the implementation never overflows." +msgstr "" + +#: library/datetime.rst:1214 +msgid "" +"Equality comparisons between aware and naive :class:`.datetime` instances " +"don't raise :exc:`TypeError`." +msgstr "" + +#: library/datetime.rst:1222 msgid "Return :class:`date` object with same year, month and day." msgstr "" -#: library/datetime.rst:1230 +#: library/datetime.rst:1227 msgid "" "Return :class:`.time` object with same hour, minute, second, microsecond and " "fold. :attr:`.tzinfo` is ``None``. See also method :meth:`timetz`." msgstr "" -#: library/datetime.rst:1242 +#: library/datetime.rst:1239 msgid "The fold value is copied to the returned :class:`.time` object." msgstr "" -#: library/datetime.rst:1239 +#: library/datetime.rst:1236 msgid "" "Return :class:`.time` object with same hour, minute, second, microsecond, " "fold, and tzinfo attributes. See also method :meth:`time`." msgstr "" -#: library/datetime.rst:1250 +#: library/datetime.rst:1247 msgid "" "Return a datetime with the same attributes, except for those attributes " "given new values by whichever keyword arguments are specified. Note that " @@ -1580,21 +1627,21 @@ msgid "" "datetime with no conversion of date and time data." msgstr "" -#: library/datetime.rst:1261 +#: library/datetime.rst:1258 msgid "" "Return a :class:`.datetime` object with new :attr:`.tzinfo` attribute *tz*, " "adjusting the date and time data so the result is the same UTC time as " "*self*, but in *tz*'s local time." msgstr "" -#: library/datetime.rst:1265 +#: library/datetime.rst:1262 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." msgstr "" -#: library/datetime.rst:1269 +#: library/datetime.rst:1266 msgid "" "If called without arguments (or with ``tz=None``) the system local timezone " "is assumed for the target timezone. The ``.tzinfo`` attribute of the " @@ -1602,7 +1649,7 @@ msgid "" "with the zone name and offset obtained from the OS." msgstr "" -#: library/datetime.rst:1274 +#: library/datetime.rst:1271 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 " @@ -1611,7 +1658,7 @@ msgid "" "date and time data as ``dt - dt.utcoffset()``." msgstr "" -#: library/datetime.rst:1280 +#: library/datetime.rst:1277 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 " @@ -1619,80 +1666,82 @@ msgid "" "without conversion of date and time data, use ``dt.replace(tzinfo=None)``." msgstr "" -#: library/datetime.rst:1285 +#: library/datetime.rst:1282 msgid "" "Note that the default :meth:`tzinfo.fromutc` method can be overridden in a :" "class:`tzinfo` subclass to affect the result returned by :meth:`astimezone`. " "Ignoring error cases, :meth:`astimezone` acts like::" msgstr "" -#: library/datetime.rst:1297 +#: library/datetime.rst:1294 msgid "*tz* now can be omitted." msgstr "" -#: library/datetime.rst:1300 +#: library/datetime.rst:1297 msgid "" "The :meth:`astimezone` method can now be called on naive instances that are " "presumed to represent system local time." msgstr "" -#: library/datetime.rst:1307 +#: library/datetime.rst:1304 msgid "" "If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." "utcoffset(self)``, and raises an exception if the latter doesn't return " "``None`` or a :class:`timedelta` object with magnitude less than one day." msgstr "" -#: library/datetime.rst:1906 library/datetime.rst:2258 -#: library/datetime.rst:2582 +#: library/datetime.rst:1900 library/datetime.rst:2252 +#: library/datetime.rst:2576 msgid "The UTC offset is not restricted to a whole number of minutes." msgstr "" -#: library/datetime.rst:1317 +#: library/datetime.rst:1314 msgid "" "If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." "dst(self)``, and raises an exception if the latter doesn't return ``None`` " "or a :class:`timedelta` object with magnitude less than one day." msgstr "" -#: library/datetime.rst:1916 library/datetime.rst:2067 +#: library/datetime.rst:1910 library/datetime.rst:2061 msgid "The DST offset is not restricted to a whole number of minutes." msgstr "" -#: library/datetime.rst:1327 +#: library/datetime.rst:1324 msgid "" "If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." "tzname(self)``, raises an exception if the latter doesn't return ``None`` or " "a string object," msgstr "" -#: library/datetime.rst:1342 +#: library/datetime.rst:1339 msgid "" "where ``yday = d.toordinal() - date(d.year, 1, 1).toordinal() + 1`` is the " "day number within the current year starting with ``1`` for January 1st. The :" -"attr:`tm_isdst` flag of the result is set according to the :meth:`dst` " -"method: :attr:`.tzinfo` is ``None`` or :meth:`dst` returns ``None``, :attr:" -"`tm_isdst` is set to ``-1``; else if :meth:`dst` returns a non-zero value, :" -"attr:`tm_isdst` is set to ``1``; else :attr:`tm_isdst` is set to ``0``." +"attr:`~time.struct_time.tm_isdst` flag of the result is set according to " +"the :meth:`dst` method: :attr:`.tzinfo` is ``None`` or :meth:`dst` returns " +"``None``, :attr:`!tm_isdst` is set to ``-1``; else if :meth:`dst` returns a " +"non-zero value, :attr:`!tm_isdst` is set to ``1``; else :attr:`!tm_isdst` is " +"set to ``0``." msgstr "" -#: library/datetime.rst:1353 +#: library/datetime.rst:1350 msgid "" "If :class:`.datetime` instance *d* is naive, this is the same as ``d." -"timetuple()`` except that :attr:`tm_isdst` is forced to 0 regardless of what " -"``d.dst()`` returns. DST is never in effect for a UTC time." +"timetuple()`` except that :attr:`~.time.struct_time.tm_isdst` is forced to 0 " +"regardless of what ``d.dst()`` returns. DST is never in effect for a UTC " +"time." msgstr "" -#: library/datetime.rst:1357 +#: library/datetime.rst:1354 msgid "" "If *d* is aware, *d* is normalized to UTC time, by subtracting ``d." "utcoffset()``, and a :class:`time.struct_time` for the normalized time is " -"returned. :attr:`tm_isdst` is forced to 0. Note that an :exc:`OverflowError` " -"may be raised if *d*.year was ``MINYEAR`` or ``MAXYEAR`` and UTC adjustment " -"spills over a year boundary." +"returned. :attr:`!tm_isdst` is forced to 0. Note that an :exc:" +"`OverflowError` may be raised if *d*.year was ``MINYEAR`` or ``MAXYEAR`` and " +"UTC adjustment spills over a year boundary." msgstr "" -#: library/datetime.rst:1366 +#: library/datetime.rst:1363 msgid "" "Because naive ``datetime`` objects are treated by many ``datetime`` methods " "as local times, it is preferred to use aware datetimes to represent times in " @@ -1702,20 +1751,20 @@ msgid "" "meth:`.datetime.timetuple`." msgstr "" -#: library/datetime.rst:1375 +#: library/datetime.rst:1372 msgid "" "Return the proleptic Gregorian ordinal of the date. The same as ``self." "date().toordinal()``." msgstr "" -#: library/datetime.rst:1380 +#: library/datetime.rst:1377 msgid "" "Return POSIX timestamp corresponding to the :class:`.datetime` instance. The " "return value is a :class:`float` similar to that returned by :func:`time." "time`." msgstr "" -#: library/datetime.rst:1384 +#: library/datetime.rst:1381 msgid "" "Naive :class:`.datetime` instances are assumed to represent local time and " "this method relies on the platform C :c:func:`mktime` function to perform " @@ -1725,18 +1774,18 @@ msgid "" "future." msgstr "" -#: library/datetime.rst:1391 +#: library/datetime.rst:1388 msgid "" "For aware :class:`.datetime` instances, the return value is computed as::" msgstr "" -#: library/datetime.rst:1398 +#: library/datetime.rst:1395 msgid "" "The :meth:`timestamp` method uses the :attr:`.fold` attribute to " "disambiguate the times during a repeated interval." msgstr "" -#: library/datetime.rst:1404 +#: library/datetime.rst:1401 msgid "" "There is no method to obtain the POSIX timestamp directly from a naive :" "class:`.datetime` instance representing UTC time. If your application uses " @@ -1744,145 +1793,145 @@ msgid "" "the POSIX timestamp by supplying ``tzinfo=timezone.utc``::" msgstr "" -#: library/datetime.rst:1412 +#: library/datetime.rst:1409 msgid "or by calculating the timestamp directly::" msgstr "" -#: library/datetime.rst:1418 +#: library/datetime.rst:1415 msgid "" "Return the day of the week as an integer, where Monday is 0 and Sunday is 6. " "The same as ``self.date().weekday()``. See also :meth:`isoweekday`." msgstr "" -#: library/datetime.rst:1424 +#: library/datetime.rst:1421 msgid "" "Return the day of the week as an integer, where Monday is 1 and Sunday is 7. " "The same as ``self.date().isoweekday()``. See also :meth:`weekday`, :meth:" "`isocalendar`." msgstr "" -#: library/datetime.rst:1431 +#: library/datetime.rst:1428 msgid "" "Return a :term:`named tuple` with three components: ``year``, ``week`` and " "``weekday``. The same as ``self.date().isocalendar()``." msgstr "" -#: library/datetime.rst:1437 +#: library/datetime.rst:1434 msgid "Return a string representing the date and time in ISO 8601 format:" msgstr "" -#: library/datetime.rst:1439 +#: library/datetime.rst:1436 msgid "``YYYY-MM-DDTHH:MM:SS.ffffff``, if :attr:`microsecond` is not 0" msgstr "" -#: library/datetime.rst:1440 +#: library/datetime.rst:1437 msgid "``YYYY-MM-DDTHH:MM:SS``, if :attr:`microsecond` is 0" msgstr "" -#: library/datetime.rst:1442 +#: library/datetime.rst:1439 msgid "" "If :meth:`utcoffset` does not return ``None``, a string is appended, giving " "the UTC offset:" msgstr "" -#: library/datetime.rst:1445 +#: library/datetime.rst:1442 msgid "" "``YYYY-MM-DDTHH:MM:SS.ffffff+HH:MM[:SS[.ffffff]]``, if :attr:`microsecond` " "is not 0" msgstr "" -#: library/datetime.rst:1447 +#: library/datetime.rst:1444 msgid "" "``YYYY-MM-DDTHH:MM:SS+HH:MM[:SS[.ffffff]]``, if :attr:`microsecond` is 0" msgstr "" -#: library/datetime.rst:1457 +#: library/datetime.rst:1454 msgid "" "The optional argument *sep* (default ``'T'``) is a one-character separator, " "placed between the date and time portions of the result. For example::" msgstr "" -#: library/datetime.rst:1846 +#: library/datetime.rst:1840 msgid "" "The optional argument *timespec* specifies the number of additional " "components of the time to include (the default is ``'auto'``). It can be one " "of the following:" msgstr "" -#: library/datetime.rst:1850 +#: library/datetime.rst:1844 msgid "" "``'auto'``: Same as ``'seconds'`` if :attr:`microsecond` is 0, same as " "``'microseconds'`` otherwise." msgstr "" -#: library/datetime.rst:1852 +#: library/datetime.rst:1846 msgid "``'hours'``: Include the :attr:`hour` in the two-digit ``HH`` format." msgstr "" -#: library/datetime.rst:1853 +#: library/datetime.rst:1847 msgid "" "``'minutes'``: Include :attr:`hour` and :attr:`minute` in ``HH:MM`` format." msgstr "" -#: library/datetime.rst:1854 +#: library/datetime.rst:1848 msgid "" "``'seconds'``: Include :attr:`hour`, :attr:`minute`, and :attr:`second` in " "``HH:MM:SS`` format." msgstr "" -#: library/datetime.rst:1856 +#: library/datetime.rst:1850 msgid "" "``'milliseconds'``: Include full time, but truncate fractional second part " "to milliseconds. ``HH:MM:SS.sss`` format." msgstr "" -#: library/datetime.rst:1858 +#: library/datetime.rst:1852 msgid "``'microseconds'``: Include full time in ``HH:MM:SS.ffffff`` format." msgstr "" -#: library/datetime.rst:1862 +#: library/datetime.rst:1856 msgid "Excluded time components are truncated, not rounded." msgstr "" -#: library/datetime.rst:1489 +#: library/datetime.rst:1486 msgid ":exc:`ValueError` will be raised on an invalid *timespec* argument::" msgstr "" -#: library/datetime.rst:1877 -msgid "Added the *timespec* argument." +#: library/datetime.rst:1871 +msgid "Added the *timespec* parameter." msgstr "" -#: library/datetime.rst:1505 +#: library/datetime.rst:1502 msgid "" "For a :class:`.datetime` instance *d*, ``str(d)`` is equivalent to ``d." "isoformat(' ')``." msgstr "" -#: library/datetime.rst:1511 +#: library/datetime.rst:1508 msgid "Return a string representing the date and time::" msgstr "" -#: library/datetime.rst:1517 +#: library/datetime.rst:1514 msgid "" "The output string will *not* include time zone information, regardless of " "whether the input is aware or naive." msgstr "" -#: library/datetime.rst:1524 +#: library/datetime.rst:1521 msgid "" "on platforms where the native C :c:func:`ctime` function (which :func:`time." "ctime` invokes, but which :meth:`datetime.ctime` does not invoke) conforms " "to the C standard." msgstr "" -#: library/datetime.rst:1531 +#: library/datetime.rst:1528 msgid "" "Return a string representing the date and time, controlled by an explicit " "format string. See also :ref:`strftime-strptime-behavior` and :meth:" "`datetime.isoformat`." msgstr "" -#: library/datetime.rst:1538 +#: library/datetime.rst:1535 msgid "" "Same as :meth:`.datetime.strftime`. This makes it possible to specify a " "format string for a :class:`.datetime` object in :ref:`formatted string " @@ -1890,104 +1939,102 @@ msgid "" "`strftime-strptime-behavior` and :meth:`datetime.isoformat`." msgstr "" -#: library/datetime.rst:1545 +#: library/datetime.rst:1542 msgid "Examples of Usage: :class:`.datetime`" msgstr "" -#: library/datetime.rst:1547 -msgid "Examples of working with :class:`~datetime.datetime` objects:" +#: library/datetime.rst:1544 +msgid "Examples of working with :class:`.datetime` objects:" msgstr "" -#: library/datetime.rst:1600 +#: library/datetime.rst:1597 msgid "" "The example below defines a :class:`tzinfo` subclass capturing time zone " "information for Kabul, Afghanistan, which used +4 UTC until 1945 and then " "+4:30 UTC thereafter::" msgstr "" -#: library/datetime.rst:1647 +#: library/datetime.rst:1644 msgid "Usage of ``KabulTz`` from above::" msgstr "" -#: library/datetime.rst:1673 +#: library/datetime.rst:1670 msgid ":class:`.time` Objects" msgstr "" -#: library/datetime.rst:1675 +#: library/datetime.rst:1672 msgid "" -"A :class:`time` object represents a (local) time of day, independent of any " +"A :class:`.time` object represents a (local) time of day, independent of any " "particular day, and subject to adjustment via a :class:`tzinfo` object." msgstr "" -#: library/datetime.rst:1680 +#: library/datetime.rst:1677 msgid "" "All arguments are optional. *tzinfo* may be ``None``, or an instance of a :" "class:`tzinfo` subclass. The remaining arguments must be integers in the " "following ranges:" msgstr "" -#: library/datetime.rst:1690 +#: library/datetime.rst:1687 msgid "" "If an argument outside those ranges is given, :exc:`ValueError` is raised. " "All default to ``0`` except *tzinfo*, which defaults to :const:`None`." msgstr "" -#: library/datetime.rst:1698 +#: library/datetime.rst:1695 msgid "The earliest representable :class:`.time`, ``time(0, 0, 0, 0)``." msgstr "" -#: library/datetime.rst:1703 +#: library/datetime.rst:1700 msgid "The latest representable :class:`.time`, ``time(23, 59, 59, 999999)``." msgstr "" -#: library/datetime.rst:1708 +#: library/datetime.rst:1705 msgid "" "The smallest possible difference between non-equal :class:`.time` objects, " "``timedelta(microseconds=1)``, although note that arithmetic on :class:`." "time` objects is not supported." msgstr "" -#: library/datetime.rst:1737 +#: library/datetime.rst:1734 msgid "" "The object passed as the tzinfo argument to the :class:`.time` constructor, " "or ``None`` if none was passed." msgstr "" +#: library/datetime.rst:1748 +msgid "" +":class:`.time` objects support equality and order comparisons, where *a* is " +"considered less than *b* when *a* precedes *b* in time." +msgstr "" + #: library/datetime.rst:1751 msgid "" -":class:`.time` objects support comparison of :class:`.time` to :class:`." -"time`, where *a* is considered less than *b* when *a* precedes *b* in time. " -"If one comparand is naive and the other is aware, :exc:`TypeError` is raised " -"if an order comparison is attempted. For equality comparisons, naive " -"instances are never equal to aware instances." +"Naive and aware :class:`!time` objects are never equal. Order comparison " +"between naive and aware :class:`!time` objects raises :exc:`TypeError`." msgstr "" -#: library/datetime.rst:1757 +#: library/datetime.rst:1755 msgid "" -"If both comparands are aware, and have the same :attr:`~time.tzinfo` " -"attribute, the common :attr:`~time.tzinfo` attribute is ignored and the base " -"times are compared. If both comparands are aware and have different :attr:" -"`~time.tzinfo` attributes, the comparands are first adjusted by subtracting " -"their UTC offsets (obtained from ``self.utcoffset()``). In order to stop " -"mixed-type comparisons from falling back to the default comparison by object " -"address, when a :class:`.time` object is compared to an object of a " -"different type, :exc:`TypeError` is raised unless the comparison is ``==`` " -"or ``!=``. The latter cases return :const:`False` or :const:`True`, " -"respectively." +"If both comparands are aware, and have the same :attr:`~.time.tzinfo` " +"attribute, the common :attr:`!tzinfo` attribute is ignored and the base " +"times are compared. If both comparands are aware and have different :attr:`!" +"tzinfo` attributes, the comparands are first adjusted by subtracting their " +"UTC offsets (obtained from ``self.utcoffset()``)." msgstr "" -#: library/datetime.rst:1767 +#: library/datetime.rst:1761 msgid "" -"Equality comparisons between aware and naive :class:`~datetime.time` " -"instances don't raise :exc:`TypeError`." +"Equality comparisons between aware and naive :class:`.time` instances don't " +"raise :exc:`TypeError`." msgstr "" -#: library/datetime.rst:1771 +#: library/datetime.rst:1765 msgid "" "In Boolean contexts, a :class:`.time` object is always considered to be true." msgstr "" -#: library/datetime.rst:1773 +#: library/datetime.rst:1767 msgid "" "Before Python 3.5, a :class:`.time` object was considered to be false if it " "represented midnight in UTC. This behavior was considered obscure and error-" @@ -1995,35 +2042,39 @@ msgid "" "details." msgstr "" -#: library/datetime.rst:1780 +#: library/datetime.rst:1774 msgid "Other constructor:" msgstr "" -#: library/datetime.rst:1784 +#: library/datetime.rst:1778 msgid "" "Return a :class:`.time` corresponding to a *time_string* in any valid ISO " "8601 format, with the following exceptions:" msgstr "" -#: library/datetime.rst:1788 +#: library/datetime.rst:1782 msgid "" "The leading ``T``, normally required in cases where there may be ambiguity " "between a date and a time, is not required." msgstr "" -#: library/datetime.rst:1790 +#: library/datetime.rst:1784 msgid "" "Fractional seconds may have any number of digits (anything beyond 6 will be " "truncated)." msgstr "" -#: library/datetime.rst:1818 +#: library/datetime.rst:1788 +msgid "Examples:" +msgstr "" + +#: library/datetime.rst:1812 msgid "" "Previously, this method only supported formats that could be emitted by :" "meth:`time.isoformat()`." msgstr "" -#: library/datetime.rst:1828 +#: library/datetime.rst:1822 msgid "" "Return a :class:`.time` with the same value, except for those attributes " "given new values by whichever keyword arguments are specified. Note that " @@ -2031,46 +2082,46 @@ msgid "" "aware :class:`.time`, without conversion of the time data." msgstr "" -#: library/datetime.rst:1839 +#: library/datetime.rst:1833 msgid "Return a string representing the time in ISO 8601 format, one of:" msgstr "" -#: library/datetime.rst:1841 +#: library/datetime.rst:1835 msgid "``HH:MM:SS.ffffff``, if :attr:`microsecond` is not 0" msgstr "" -#: library/datetime.rst:1842 +#: library/datetime.rst:1836 msgid "``HH:MM:SS``, if :attr:`microsecond` is 0" msgstr "" -#: library/datetime.rst:1843 +#: library/datetime.rst:1837 msgid "" "``HH:MM:SS.ffffff+HH:MM[:SS[.ffffff]]``, if :meth:`utcoffset` does not " "return ``None``" msgstr "" -#: library/datetime.rst:1844 +#: library/datetime.rst:1838 msgid "" "``HH:MM:SS+HH:MM[:SS[.ffffff]]``, if :attr:`microsecond` is 0 and :meth:" "`utcoffset` does not return ``None``" msgstr "" -#: library/datetime.rst:1864 +#: library/datetime.rst:1858 msgid ":exc:`ValueError` will be raised on an invalid *timespec* argument." msgstr "" -#: library/datetime.rst:1883 +#: library/datetime.rst:1877 msgid "For a time *t*, ``str(t)`` is equivalent to ``t.isoformat()``." msgstr "" -#: library/datetime.rst:1888 +#: library/datetime.rst:1882 msgid "" "Return a string representing the time, controlled by an explicit format " "string. See also :ref:`strftime-strptime-behavior` and :meth:`time." "isoformat`." msgstr "" -#: library/datetime.rst:1894 +#: library/datetime.rst:1888 msgid "" "Same as :meth:`.time.strftime`. This makes it possible to specify a format " "string for a :class:`.time` object in :ref:`formatted string literals ` file there are some examples of :class:`tzinfo` classes:" msgstr "" -#: library/datetime.rst:2150 +#: library/datetime.rst:2144 msgid "" "Note that there are unavoidable subtleties twice per year in a :class:" "`tzinfo` subclass accounting for both standard and daylight time, at the DST " @@ -2337,7 +2389,7 @@ msgid "" "ends the minute after 1:59 (EDT) on the first Sunday in November::" msgstr "" -#: library/datetime.rst:2164 +#: library/datetime.rst:2158 msgid "" "When DST starts (the \"start\" line), the local wall clock leaps from 1:59 " "to 3:00. A wall time of the form 2:MM doesn't really make sense on that day, " @@ -2346,59 +2398,59 @@ msgid "" "get::" msgstr "" -#: library/datetime.rst:2183 +#: library/datetime.rst:2177 msgid "" "When DST ends (the \"end\" line), there's a potentially worse problem: " "there's an hour that can't be spelled unambiguously in local wall time: the " "last hour of daylight time. In Eastern, that's times of the form 5:MM UTC on " "the day daylight time ends. The local wall clock leaps from 1:59 (daylight " "time) back to 1:00 (standard time) again. Local times of the form 1:MM are " -"ambiguous. :meth:`astimezone` mimics the local clock's behavior by mapping " -"two adjacent UTC hours into the same local hour then. In the Eastern " -"example, UTC times of the form 5:MM and 6:MM both map to 1:MM when converted " -"to Eastern, but earlier times have the :attr:`~datetime.fold` attribute set " -"to 0 and the later times have it set to 1. For example, at the Fall back " -"transition of 2016, we get::" +"ambiguous. :meth:`~.datetime.astimezone` mimics the local clock's behavior " +"by mapping two adjacent UTC hours into the same local hour then. In the " +"Eastern example, UTC times of the form 5:MM and 6:MM both map to 1:MM when " +"converted to Eastern, but earlier times have the :attr:`~.datetime.fold` " +"attribute set to 0 and the later times have it set to 1. For example, at the " +"Fall back transition of 2016, we get::" msgstr "" -#: library/datetime.rst:2205 +#: library/datetime.rst:2199 msgid "" "Note that the :class:`.datetime` instances that differ only by the value of " -"the :attr:`~datetime.fold` attribute are considered equal in comparisons." +"the :attr:`~.datetime.fold` attribute are considered equal in comparisons." msgstr "" -#: library/datetime.rst:2208 +#: library/datetime.rst:2202 msgid "" "Applications that can't bear wall-time ambiguities should explicitly check " -"the value of the :attr:`~datetime.fold` attribute or avoid using hybrid :" +"the value of the :attr:`~.datetime.fold` attribute or avoid using hybrid :" "class:`tzinfo` subclasses; there are no ambiguities when using :class:" "`timezone`, or any other fixed-offset :class:`tzinfo` subclass (such as a " "class representing only EST (fixed offset -5 hours), or only EDT (fixed " "offset -4 hours))." msgstr "" -#: library/datetime.rst:2222 +#: library/datetime.rst:2216 msgid ":mod:`zoneinfo`" msgstr "" -#: library/datetime.rst:2217 +#: library/datetime.rst:2211 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)." +"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)." msgstr "" -#: library/datetime.rst:2221 +#: library/datetime.rst:2215 msgid "" "``zoneinfo`` brings the *IANA timezone database* (also known as the Olson " "database) to Python, and its usage is recommended." msgstr "" -#: library/datetime.rst:2228 +#: library/datetime.rst:2222 msgid "`IANA timezone database `_" msgstr "" -#: library/datetime.rst:2225 +#: library/datetime.rst:2219 msgid "" "The Time Zone Database (often called tz, tzdata or zoneinfo) contains code " "and data that represent the history of local time for many representative " @@ -2407,24 +2459,24 @@ msgid "" "saving rules." msgstr "" -#: library/datetime.rst:2235 +#: library/datetime.rst:2229 msgid ":class:`timezone` Objects" msgstr "" -#: library/datetime.rst:2237 +#: library/datetime.rst:2231 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." msgstr "" -#: library/datetime.rst:2241 +#: library/datetime.rst:2235 msgid "" "Objects of this class cannot be used to represent timezone 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 "" -#: library/datetime.rst:2248 +#: library/datetime.rst:2242 msgid "" "The *offset* argument must be specified as a :class:`timedelta` object " "representing the difference between the local time and UTC. It must be " @@ -2432,25 +2484,25 @@ msgid "" "otherwise :exc:`ValueError` is raised." msgstr "" -#: library/datetime.rst:2253 +#: library/datetime.rst:2247 msgid "" "The *name* argument is optional. If specified it must be a string that will " "be used as the value returned by the :meth:`datetime.tzname` method." msgstr "" -#: library/datetime.rst:2275 +#: library/datetime.rst:2269 msgid "" "Return the fixed value specified when the :class:`timezone` instance is " "constructed." msgstr "" -#: library/datetime.rst:2267 +#: library/datetime.rst:2261 msgid "" "The *dt* argument is ignored. The return value is a :class:`timedelta` " "instance equal to the difference between the local time and UTC." msgstr "" -#: library/datetime.rst:2278 +#: library/datetime.rst:2272 msgid "" "If *name* is not provided in the constructor, the name returned by " "``tzname(dt)`` is generated from the value of the ``offset`` as follows. If " @@ -2459,144 +2511,145 @@ msgid "" "are two digits of ``offset.hours`` and ``offset.minutes`` respectively." msgstr "" -#: library/datetime.rst:2284 +#: library/datetime.rst:2278 msgid "" "Name generated from ``offset=timedelta(0)`` is now plain ``'UTC'``, not " "``'UTC+00:00'``." msgstr "" -#: library/datetime.rst:2291 +#: library/datetime.rst:2285 msgid "Always returns ``None``." msgstr "" -#: library/datetime.rst:2295 +#: library/datetime.rst:2289 msgid "" "Return ``dt + offset``. The *dt* argument must be an aware :class:`." "datetime` instance, with ``tzinfo`` set to ``self``." msgstr "" -#: library/datetime.rst:2302 +#: library/datetime.rst:2296 msgid "The UTC timezone, ``timezone(timedelta(0))``." msgstr "" -#: library/datetime.rst:2311 -msgid ":meth:`strftime` and :meth:`strptime` Behavior" +#: library/datetime.rst:2305 +msgid ":meth:`~.datetime.strftime` and :meth:`~.datetime.strptime` Behavior" msgstr "" -#: library/datetime.rst:2313 +#: library/datetime.rst:2307 msgid "" ":class:`date`, :class:`.datetime`, and :class:`.time` objects all support a " "``strftime(format)`` method, to create a string representing the time under " "the control of an explicit format string." msgstr "" -#: library/datetime.rst:2317 +#: library/datetime.rst:2311 msgid "" "Conversely, the :meth:`datetime.strptime` class method creates a :class:`." "datetime` object from a string representing a date and time and a " "corresponding format string." msgstr "" -#: library/datetime.rst:2321 +#: library/datetime.rst:2315 msgid "" -"The table below provides a high-level comparison of :meth:`strftime` versus :" -"meth:`strptime`:" +"The table below provides a high-level comparison of :meth:`~.datetime." +"strftime` versus :meth:`~.datetime.strptime`:" msgstr "" -#: library/datetime.rst:2325 +#: library/datetime.rst:2319 msgid "``strftime``" msgstr "" -#: library/datetime.rst:2325 +#: library/datetime.rst:2319 msgid "``strptime``" msgstr "" -#: library/datetime.rst:2327 +#: library/datetime.rst:2321 msgid "Usage" msgstr "" -#: library/datetime.rst:2327 +#: library/datetime.rst:2321 msgid "Convert object to a string according to a given format" msgstr "" -#: library/datetime.rst:2327 +#: library/datetime.rst:2321 msgid "" "Parse a string into a :class:`.datetime` object given a corresponding format" msgstr "" -#: library/datetime.rst:2329 +#: library/datetime.rst:2323 msgid "Type of method" msgstr "" -#: library/datetime.rst:2329 +#: library/datetime.rst:2323 msgid "Instance method" msgstr "" -#: library/datetime.rst:2329 +#: library/datetime.rst:2323 msgid "Class method" msgstr "" -#: library/datetime.rst:2331 +#: library/datetime.rst:2325 msgid "Method of" msgstr "" -#: library/datetime.rst:2331 +#: library/datetime.rst:2325 msgid ":class:`date`; :class:`.datetime`; :class:`.time`" msgstr "" -#: library/datetime.rst:2331 +#: library/datetime.rst:2325 msgid ":class:`.datetime`" msgstr "" -#: library/datetime.rst:2333 +#: library/datetime.rst:2327 msgid "Signature" msgstr "" -#: library/datetime.rst:2333 +#: library/datetime.rst:2327 msgid "``strftime(format)``" msgstr "" -#: library/datetime.rst:2333 +#: library/datetime.rst:2327 msgid "``strptime(date_string, format)``" msgstr "" -#: library/datetime.rst:2340 -msgid ":meth:`strftime` and :meth:`strptime` Format Codes" +#: library/datetime.rst:2334 +msgid "" +":meth:`~.datetime.strftime` and :meth:`~.datetime.strptime` Format Codes" msgstr "" -#: library/datetime.rst:2342 +#: library/datetime.rst:2336 msgid "" "These methods accept format codes that can be used to parse and format " "dates::" msgstr "" -#: library/datetime.rst:2350 +#: library/datetime.rst:2344 msgid "" "The following is a list of all the format codes that the 1989 C standard " "requires, and these work on all platforms with a standard C implementation." msgstr "" -#: library/datetime.rst:2457 +#: library/datetime.rst:2451 msgid "Directive" msgstr "" -#: library/datetime.rst:2457 +#: library/datetime.rst:2451 msgid "Meaning" msgstr "" -#: library/datetime.rst:2457 +#: library/datetime.rst:2451 msgid "Example" msgstr "" -#: library/datetime.rst:2457 +#: library/datetime.rst:2451 msgid "Notes" msgstr "" -#: library/datetime.rst:2356 +#: library/datetime.rst:2350 msgid "``%a``" msgstr "" -#: library/datetime.rst:2356 +#: library/datetime.rst:2350 msgid "Weekday as locale's abbreviated name." msgstr "" @@ -2608,11 +2661,11 @@ msgstr "" msgid "So, Mo, ..., Sa (de_DE)" msgstr "" -#: library/datetime.rst:2361 +#: library/datetime.rst:2355 msgid "``%A``" msgstr "" -#: library/datetime.rst:2361 +#: library/datetime.rst:2355 msgid "Weekday as locale's full name." msgstr "" @@ -2624,40 +2677,40 @@ msgstr "" msgid "Sonntag, Montag, ..., Samstag (de_DE)" msgstr "" -#: library/datetime.rst:2366 +#: library/datetime.rst:2360 msgid "``%w``" msgstr "" -#: library/datetime.rst:2366 +#: library/datetime.rst:2360 msgid "Weekday as a decimal number, where 0 is Sunday and 6 is Saturday." msgstr "" -#: library/datetime.rst:2366 +#: library/datetime.rst:2360 msgid "0, 1, ..., 6" msgstr "" -#: library/datetime.rst:2370 +#: library/datetime.rst:2364 msgid "``%d``" msgstr "" -#: library/datetime.rst:2370 +#: library/datetime.rst:2364 msgid "Day of the month as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2370 +#: library/datetime.rst:2364 msgid "01, 02, ..., 31" msgstr "" -#: library/datetime.rst:2383 library/datetime.rst:2392 -#: library/datetime.rst:2401 library/datetime.rst:2419 +#: library/datetime.rst:2377 library/datetime.rst:2386 +#: library/datetime.rst:2395 library/datetime.rst:2413 msgid "\\(9)" msgstr "" -#: library/datetime.rst:2373 +#: library/datetime.rst:2367 msgid "``%b``" msgstr "" -#: library/datetime.rst:2373 +#: library/datetime.rst:2367 msgid "Month as locale's abbreviated name." msgstr "" @@ -2669,11 +2722,11 @@ msgstr "" msgid "Jan, Feb, ..., Dez (de_DE)" msgstr "" -#: library/datetime.rst:2378 +#: library/datetime.rst:2372 msgid "``%B``" msgstr "" -#: library/datetime.rst:2378 +#: library/datetime.rst:2372 msgid "Month as locale's full name." msgstr "" @@ -2685,67 +2738,67 @@ msgstr "" msgid "Januar, Februar, ..., Dezember (de_DE)" msgstr "" -#: library/datetime.rst:2383 +#: library/datetime.rst:2377 msgid "``%m``" msgstr "" -#: library/datetime.rst:2383 +#: library/datetime.rst:2377 msgid "Month as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2395 +#: library/datetime.rst:2389 msgid "01, 02, ..., 12" msgstr "" -#: library/datetime.rst:2386 +#: library/datetime.rst:2380 msgid "``%y``" msgstr "" -#: library/datetime.rst:2386 +#: library/datetime.rst:2380 msgid "Year without century as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2386 +#: library/datetime.rst:2380 msgid "00, 01, ..., 99" msgstr "" -#: library/datetime.rst:2389 +#: library/datetime.rst:2383 msgid "``%Y``" msgstr "" -#: library/datetime.rst:2389 +#: library/datetime.rst:2383 msgid "Year with century as a decimal number." msgstr "" -#: library/datetime.rst:2459 +#: library/datetime.rst:2453 msgid "0001, 0002, ..., 2013, 2014, ..., 9998, 9999" msgstr "" -#: library/datetime.rst:2392 +#: library/datetime.rst:2386 msgid "``%H``" msgstr "" -#: library/datetime.rst:2392 +#: library/datetime.rst:2386 msgid "Hour (24-hour clock) as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2392 +#: library/datetime.rst:2386 msgid "00, 01, ..., 23" msgstr "" -#: library/datetime.rst:2395 +#: library/datetime.rst:2389 msgid "``%I``" msgstr "" -#: library/datetime.rst:2395 +#: library/datetime.rst:2389 msgid "Hour (12-hour clock) as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2398 +#: library/datetime.rst:2392 msgid "``%p``" msgstr "" -#: library/datetime.rst:2398 +#: library/datetime.rst:2392 msgid "Locale's equivalent of either AM or PM." msgstr "" @@ -2757,127 +2810,127 @@ msgstr "" msgid "am, pm (de_DE)" msgstr "" -#: library/datetime.rst:2398 +#: library/datetime.rst:2392 msgid "\\(1), \\(3)" msgstr "" -#: library/datetime.rst:2401 +#: library/datetime.rst:2395 msgid "``%M``" msgstr "" -#: library/datetime.rst:2401 +#: library/datetime.rst:2395 msgid "Minute as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2404 +#: library/datetime.rst:2398 msgid "00, 01, ..., 59" msgstr "" -#: library/datetime.rst:2404 +#: library/datetime.rst:2398 msgid "``%S``" msgstr "" -#: library/datetime.rst:2404 +#: library/datetime.rst:2398 msgid "Second as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2404 +#: library/datetime.rst:2398 msgid "\\(4), \\(9)" msgstr "" -#: library/datetime.rst:2407 +#: library/datetime.rst:2401 msgid "``%f``" msgstr "" -#: library/datetime.rst:2407 +#: library/datetime.rst:2401 msgid "Microsecond as a decimal number, zero-padded to 6 digits." msgstr "" -#: library/datetime.rst:2407 +#: library/datetime.rst:2401 msgid "000000, 000001, ..., 999999" msgstr "" -#: library/datetime.rst:2407 +#: library/datetime.rst:2401 msgid "\\(5)" msgstr "" -#: library/datetime.rst:2580 +#: library/datetime.rst:2574 msgid "``%z``" msgstr "" -#: library/datetime.rst:2411 +#: library/datetime.rst:2405 msgid "" "UTC offset in the form ``±HHMM[SS[.ffffff]]`` (empty string if the object is " "naive)." msgstr "" -#: library/datetime.rst:2411 +#: library/datetime.rst:2405 msgid "(empty), +0000, -0400, +1030, +063415, -030712.345216" msgstr "" -#: library/datetime.rst:2416 library/datetime.rst:2473 +#: library/datetime.rst:2410 library/datetime.rst:2467 msgid "\\(6)" msgstr "" -#: library/datetime.rst:2608 +#: library/datetime.rst:2602 msgid "``%Z``" msgstr "" -#: library/datetime.rst:2416 +#: library/datetime.rst:2410 msgid "Time zone name (empty string if the object is naive)." msgstr "" -#: library/datetime.rst:2416 +#: library/datetime.rst:2410 msgid "(empty), UTC, GMT" msgstr "" -#: library/datetime.rst:2419 +#: library/datetime.rst:2413 msgid "``%j``" msgstr "" -#: library/datetime.rst:2419 +#: library/datetime.rst:2413 msgid "Day of the year as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2419 +#: library/datetime.rst:2413 msgid "001, 002, ..., 366" msgstr "" -#: library/datetime.rst:2422 +#: library/datetime.rst:2416 msgid "``%U``" msgstr "" -#: library/datetime.rst:2422 +#: library/datetime.rst:2416 msgid "" "Week number of the year (Sunday as the first day of the week) as a zero-" "padded decimal number. All days in a new year preceding the first Sunday are " "considered to be in week 0." msgstr "" -#: library/datetime.rst:2430 +#: library/datetime.rst:2424 msgid "00, 01, ..., 53" msgstr "" -#: library/datetime.rst:2430 +#: library/datetime.rst:2424 msgid "\\(7), \\(9)" msgstr "" -#: library/datetime.rst:2430 +#: library/datetime.rst:2424 msgid "``%W``" msgstr "" -#: library/datetime.rst:2430 +#: library/datetime.rst:2424 msgid "" "Week number of the year (Monday as the first day of the week) as a zero-" "padded decimal number. All days in a new year preceding the first Monday are " "considered to be in week 0." msgstr "" -#: library/datetime.rst:2438 +#: library/datetime.rst:2432 msgid "``%c``" msgstr "" -#: library/datetime.rst:2438 +#: library/datetime.rst:2432 msgid "Locale's appropriate date and time representation." msgstr "" @@ -2889,11 +2942,11 @@ msgstr "" msgid "Di 16 Aug 21:30:00 1988 (de_DE)" msgstr "" -#: library/datetime.rst:2443 +#: library/datetime.rst:2437 msgid "``%x``" msgstr "" -#: library/datetime.rst:2443 +#: library/datetime.rst:2437 msgid "Locale's appropriate date representation." msgstr "" @@ -2909,11 +2962,11 @@ msgstr "" msgid "16.08.1988 (de_DE)" msgstr "" -#: library/datetime.rst:2447 +#: library/datetime.rst:2441 msgid "``%X``" msgstr "" -#: library/datetime.rst:2447 +#: library/datetime.rst:2441 msgid "Locale's appropriate time representation." msgstr "" @@ -2925,154 +2978,154 @@ msgstr "" msgid "21:30:00 (de_DE)" msgstr "" -#: library/datetime.rst:2450 +#: library/datetime.rst:2444 msgid "``%%``" msgstr "" -#: library/datetime.rst:2450 +#: library/datetime.rst:2444 msgid "A literal ``'%'`` character." msgstr "" -#: library/datetime.rst:2450 +#: library/datetime.rst:2444 msgid "%" msgstr "" -#: library/datetime.rst:2453 +#: library/datetime.rst:2447 msgid "" "Several additional directives not required by the C89 standard are included " "for convenience. These parameters all correspond to ISO 8601 date values." msgstr "" -#: library/datetime.rst:2459 +#: library/datetime.rst:2453 msgid "``%G``" msgstr "" -#: library/datetime.rst:2459 +#: library/datetime.rst:2453 msgid "" "ISO 8601 year with century representing the year that contains the greater " "part of the ISO week (``%V``)." msgstr "" -#: library/datetime.rst:2459 +#: library/datetime.rst:2453 msgid "\\(8)" msgstr "" -#: library/datetime.rst:2464 +#: library/datetime.rst:2458 msgid "``%u``" msgstr "" -#: library/datetime.rst:2464 +#: library/datetime.rst:2458 msgid "ISO 8601 weekday as a decimal number where 1 is Monday." msgstr "" -#: library/datetime.rst:2464 +#: library/datetime.rst:2458 msgid "1, 2, ..., 7" msgstr "" -#: library/datetime.rst:2467 +#: library/datetime.rst:2461 msgid "``%V``" msgstr "" -#: library/datetime.rst:2467 +#: library/datetime.rst:2461 msgid "" "ISO 8601 week as a decimal number with Monday as the first day of the week. " "Week 01 is the week containing Jan 4." msgstr "" -#: library/datetime.rst:2467 +#: library/datetime.rst:2461 msgid "01, 02, ..., 53" msgstr "" -#: library/datetime.rst:2467 +#: library/datetime.rst:2461 msgid "\\(8), \\(9)" msgstr "" -#: library/datetime.rst:2594 +#: library/datetime.rst:2588 msgid "``%:z``" msgstr "" -#: library/datetime.rst:2473 +#: library/datetime.rst:2467 msgid "" "UTC offset in the form ``±HH:MM[:SS[.ffffff]]`` (empty string if the object " "is naive)." msgstr "" -#: library/datetime.rst:2473 +#: library/datetime.rst:2467 msgid "(empty), +00:00, -04:00, +10:30, +06:34:15, -03:07:12.345216" msgstr "" -#: library/datetime.rst:2479 +#: library/datetime.rst:2473 msgid "" -"These may not be available on all platforms when used with the :meth:" -"`strftime` method. The ISO 8601 year and ISO 8601 week directives are not " -"interchangeable with the year and week number directives above. Calling :" -"meth:`strptime` with incomplete or ambiguous ISO 8601 directives will raise " -"a :exc:`ValueError`." +"These may not be available on all platforms when used with the :meth:`~." +"datetime.strftime` method. The ISO 8601 year and ISO 8601 week directives " +"are not interchangeable with the year and week number directives above. " +"Calling :meth:`~.datetime.strptime` with incomplete or ambiguous ISO 8601 " +"directives will raise a :exc:`ValueError`." msgstr "" -#: library/datetime.rst:2484 +#: library/datetime.rst:2478 msgid "" "The full set of format codes supported varies across platforms, because " -"Python calls the platform C library's :func:`strftime` function, and " +"Python calls the platform C library's :c:func:`strftime` function, and " "platform variations are common. To see the full set of format codes " "supported on your platform, consult the :manpage:`strftime(3)` " "documentation. There are also differences between platforms in handling of " "unsupported format specifiers." msgstr "" -#: library/datetime.rst:2490 +#: library/datetime.rst:2484 msgid "``%G``, ``%u`` and ``%V`` were added." msgstr "" -#: library/datetime.rst:2493 +#: library/datetime.rst:2487 msgid "``%:z`` was added." msgstr "" -#: library/datetime.rst:2497 +#: library/datetime.rst:2491 msgid "Technical Detail" msgstr "" -#: library/datetime.rst:2499 +#: library/datetime.rst:2493 msgid "" "Broadly speaking, ``d.strftime(fmt)`` acts like the :mod:`time` module's " "``time.strftime(fmt, d.timetuple())`` although not all objects support a :" -"meth:`timetuple` method." +"meth:`~date.timetuple` method." msgstr "" -#: library/datetime.rst:2503 +#: library/datetime.rst:2497 msgid "" -"For the :meth:`datetime.strptime` class method, the default value is " +"For the :meth:`.datetime.strptime` class method, the default value is " "``1900-01-01T00:00:00.000``: any components not specified in the format " "string will be pulled from the default value. [#]_" msgstr "" -#: library/datetime.rst:2507 +#: library/datetime.rst:2501 msgid "Using ``datetime.strptime(date_string, format)`` is equivalent to::" msgstr "" -#: library/datetime.rst:2511 +#: library/datetime.rst:2505 msgid "" "except when the format includes sub-second components or timezone offset " "information, which are supported in ``datetime.strptime`` but are discarded " "by ``time.strptime``." msgstr "" -#: library/datetime.rst:2515 +#: library/datetime.rst:2509 msgid "" "For :class:`.time` objects, the format codes for year, month, and day should " -"not be used, as :class:`time` objects have no such values. If they're used " +"not be used, as :class:`!time` objects have no such values. If they're used " "anyway, ``1900`` is substituted for the year, and ``1`` for the month and " "day." msgstr "" -#: library/datetime.rst:2519 +#: library/datetime.rst:2513 msgid "" "For :class:`date` objects, the format codes for hours, minutes, seconds, and " "microseconds should not be used, as :class:`date` objects have no such " "values. If they're used anyway, ``0`` is substituted for them." msgstr "" -#: library/datetime.rst:2523 +#: library/datetime.rst:2517 msgid "" "For the same reason, handling of format strings containing Unicode code " "points that can't be represented in the charset of the current locale is " @@ -3081,7 +3134,7 @@ msgid "" "`UnicodeError` or return an empty string instead." msgstr "" -#: library/datetime.rst:2532 +#: library/datetime.rst:2526 msgid "" "Because the format depends on the current locale, care should be taken when " "making assumptions about the output value. Field orderings will vary (for " @@ -3089,146 +3142,149 @@ msgid "" "contain non-ASCII characters." msgstr "" -#: library/datetime.rst:2538 +#: library/datetime.rst:2532 msgid "" -"The :meth:`strptime` method can parse years in the full [1, 9999] range, but " -"years < 1000 must be zero-filled to 4-digit width." +"The :meth:`~.datetime.strptime` method can parse years in the full [1, 9999] " +"range, but years < 1000 must be zero-filled to 4-digit width." msgstr "" -#: library/datetime.rst:2541 +#: library/datetime.rst:2535 msgid "" -"In previous versions, :meth:`strftime` method was restricted to years >= " -"1900." +"In previous versions, :meth:`~.datetime.strftime` method was restricted to " +"years >= 1900." msgstr "" -#: library/datetime.rst:2545 +#: library/datetime.rst:2539 msgid "" -"In version 3.2, :meth:`strftime` method was restricted to years >= 1000." +"In version 3.2, :meth:`~.datetime.strftime` method was restricted to years " +">= 1000." msgstr "" -#: library/datetime.rst:2550 +#: library/datetime.rst:2544 msgid "" -"When used with the :meth:`strptime` method, the ``%p`` directive only " -"affects the output hour field if the ``%I`` directive is used to parse the " -"hour." +"When used with the :meth:`~.datetime.strptime` method, the ``%p`` directive " +"only affects the output hour field if the ``%I`` directive is used to parse " +"the hour." msgstr "" -#: library/datetime.rst:2554 +#: library/datetime.rst:2548 msgid "" -"Unlike the :mod:`time` module, the :mod:`datetime` module does not support " +"Unlike the :mod:`time` module, the :mod:`!datetime` module does not support " "leap seconds." msgstr "" -#: library/datetime.rst:2558 +#: library/datetime.rst:2552 msgid "" -"When used with the :meth:`strptime` method, the ``%f`` directive accepts " -"from one to six digits and zero pads on the right. ``%f`` is an extension to " -"the set of format characters in the C standard (but implemented separately " -"in datetime objects, and therefore always available)." +"When used with the :meth:`~.datetime.strptime` method, the ``%f`` directive " +"accepts from one to six digits and zero pads on the right. ``%f`` is an " +"extension to the set of format characters in the C standard (but implemented " +"separately in datetime objects, and therefore always available)." msgstr "" -#: library/datetime.rst:2565 +#: library/datetime.rst:2559 msgid "" "For a naive object, the ``%z``, ``%:z`` and ``%Z`` format codes are replaced " "by empty strings." msgstr "" -#: library/datetime.rst:2568 +#: library/datetime.rst:2562 msgid "For an aware object:" msgstr "" -#: library/datetime.rst:2571 +#: library/datetime.rst:2565 msgid "" -":meth:`utcoffset` is transformed into a string of the form ``±HHMM[SS[." -"ffffff]]``, where ``HH`` is a 2-digit string giving the number of UTC offset " -"hours, ``MM`` is a 2-digit string giving the number of UTC offset minutes, " -"``SS`` is a 2-digit string giving the number of UTC offset seconds and " -"``ffffff`` is a 6-digit string giving the number of UTC offset microseconds. " -"The ``ffffff`` part is omitted when the offset is a whole number of seconds " -"and both the ``ffffff`` and the ``SS`` part is omitted when the offset is a " -"whole number of minutes. For example, if :meth:`utcoffset` returns " -"``timedelta(hours=-3, minutes=-30)``, ``%z`` is replaced with the string " -"``'-0330'``." +":meth:`~.datetime.utcoffset` is transformed into a string of the form " +"``±HHMM[SS[.ffffff]]``, where ``HH`` is a 2-digit string giving the number " +"of UTC offset hours, ``MM`` is a 2-digit string giving the number of UTC " +"offset minutes, ``SS`` is a 2-digit string giving the number of UTC offset " +"seconds and ``ffffff`` is a 6-digit string giving the number of UTC offset " +"microseconds. The ``ffffff`` part is omitted when the offset is a whole " +"number of seconds and both the ``ffffff`` and the ``SS`` part is omitted " +"when the offset is a whole number of minutes. For example, if :meth:`~." +"datetime.utcoffset` returns ``timedelta(hours=-3, minutes=-30)``, ``%z`` is " +"replaced with the string ``'-0330'``." msgstr "" -#: library/datetime.rst:2585 +#: library/datetime.rst:2579 msgid "" -"When the ``%z`` directive is provided to the :meth:`strptime` method, the " -"UTC offsets can have a colon as a separator between hours, minutes and " -"seconds. For example, ``'+01:00:00'`` will be parsed as an offset of one " -"hour. In addition, providing ``'Z'`` is identical to ``'+00:00'``." +"When the ``%z`` directive is provided to the :meth:`~.datetime.strptime` " +"method, the UTC offsets can have a colon as a separator between hours, " +"minutes and seconds. For example, ``'+01:00:00'`` will be parsed as an " +"offset of one hour. In addition, providing ``'Z'`` is identical to " +"``'+00:00'``." msgstr "" -#: library/datetime.rst:2593 +#: library/datetime.rst:2587 msgid "" "Behaves exactly as ``%z``, but has a colon separator added between hours, " "minutes and seconds." msgstr "" -#: library/datetime.rst:2597 +#: library/datetime.rst:2591 msgid "" -"In :meth:`strftime`, ``%Z`` is replaced by an empty string if :meth:`tzname` " -"returns ``None``; otherwise ``%Z`` is replaced by the returned value, which " -"must be a string." +"In :meth:`~.datetime.strftime`, ``%Z`` is replaced by an empty string if :" +"meth:`~.datetime.tzname` returns ``None``; otherwise ``%Z`` is replaced by " +"the returned value, which must be a string." msgstr "" -#: library/datetime.rst:2601 -msgid ":meth:`strptime` only accepts certain values for ``%Z``:" +#: library/datetime.rst:2595 +msgid ":meth:`~.datetime.strptime` only accepts certain values for ``%Z``:" msgstr "" -#: library/datetime.rst:2603 +#: library/datetime.rst:2597 msgid "any value in ``time.tzname`` for your machine's locale" msgstr "" -#: library/datetime.rst:2604 +#: library/datetime.rst:2598 msgid "the hard-coded values ``UTC`` and ``GMT``" msgstr "" -#: library/datetime.rst:2606 +#: library/datetime.rst:2600 msgid "" "So someone living in Japan may have ``JST``, ``UTC``, and ``GMT`` as valid " "values, but probably not ``EST``. It will raise ``ValueError`` for invalid " "values." msgstr "" -#: library/datetime.rst:2610 +#: library/datetime.rst:2604 msgid "" -"When the ``%z`` directive is provided to the :meth:`strptime` method, an " -"aware :class:`.datetime` object will be produced. The ``tzinfo`` of the " -"result will be set to a :class:`timezone` instance." +"When the ``%z`` directive is provided to the :meth:`~.datetime.strptime` " +"method, an aware :class:`.datetime` object will be produced. The ``tzinfo`` " +"of the result will be set to a :class:`timezone` instance." msgstr "" -#: library/datetime.rst:2616 +#: library/datetime.rst:2610 msgid "" -"When used with the :meth:`strptime` method, ``%U`` and ``%W`` are only used " -"in calculations when the day of the week and the calendar year (``%Y``) are " -"specified." +"When used with the :meth:`~.datetime.strptime` method, ``%U`` and ``%W`` are " +"only used in calculations when the day of the week and the calendar year " +"(``%Y``) are specified." msgstr "" -#: library/datetime.rst:2621 +#: library/datetime.rst:2615 msgid "" "Similar to ``%U`` and ``%W``, ``%V`` is only used in calculations when the " -"day of the week and the ISO year (``%G``) are specified in a :meth:" -"`strptime` format string. Also note that ``%G`` and ``%Y`` are not " +"day of the week and the ISO year (``%G``) are specified in a :meth:`~." +"datetime.strptime` format string. Also note that ``%G`` and ``%Y`` are not " "interchangeable." msgstr "" -#: library/datetime.rst:2627 +#: library/datetime.rst:2621 msgid "" -"When used with the :meth:`strptime` method, the leading zero is optional " -"for formats ``%d``, ``%m``, ``%H``, ``%I``, ``%M``, ``%S``, ``%j``, ``%U``, " -"``%W``, and ``%V``. Format ``%y`` does require a leading zero." +"When used with the :meth:`~.datetime.strptime` method, the leading zero is " +"optional for formats ``%d``, ``%m``, ``%H``, ``%I``, ``%M``, ``%S``, " +"``%j``, ``%U``, ``%W``, and ``%V``. Format ``%y`` does require a leading " +"zero." msgstr "" -#: library/datetime.rst:2632 +#: library/datetime.rst:2626 msgid "Footnotes" msgstr "" -#: library/datetime.rst:2633 +#: library/datetime.rst:2627 msgid "If, that is, we ignore the effects of Relativity" msgstr "" -#: library/datetime.rst:2635 +#: library/datetime.rst:2629 msgid "" "This matches the definition of the \"proleptic Gregorian\" calendar in " "Dershowitz and Reingold's book *Calendrical Calculations*, where it's the " @@ -3237,23 +3293,23 @@ msgid "" "systems." msgstr "" -#: library/datetime.rst:2641 +#: library/datetime.rst:2635 msgid "" "See R. H. van Gent's `guide to the mathematics of the ISO 8601 calendar " "`_ for a good explanation." msgstr "" -#: library/datetime.rst:2645 +#: library/datetime.rst:2639 msgid "" "Passing ``datetime.strptime('Feb 29', '%b %d')`` will fail since ``1900`` is " "not a leap year." msgstr "" -#: library/datetime.rst:2305 +#: library/datetime.rst:2299 msgid "% (percent)" msgstr "" -#: library/datetime.rst:2305 +#: library/datetime.rst:2299 msgid "datetime format" msgstr "" diff --git a/library/dbm.po b/library/dbm.po index 297c10f62..5b953adaf 100644 --- a/library/dbm.po +++ b/library/dbm.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -48,234 +48,240 @@ msgid "" msgstr "" #: library/dbm.rst:31 -msgid "" -"Returns one of the following values: ``None`` if the file can't be opened " -"because it's unreadable or doesn't exist; the empty string (``''``) if the " -"file's format can't be guessed; or a string containing the required module " -"name, such as ``'dbm.ndbm'`` or ``'dbm.gnu'``." +msgid "Return one of the following values:" msgstr "" -#: library/dbm.rst:210 library/dbm.rst:400 -msgid "Accepts :term:`path-like object` for filename." +#: library/dbm.rst:33 +msgid "" +"``None`` if the file can't be opened because it's unreadable or doesn't exist" msgstr "" -#: library/dbm.rst:41 -msgid "Open the database file *file* and return a corresponding object." +#: library/dbm.rst:34 +msgid "the empty string (``''``) if the file's format can't be guessed" msgstr "" -#: library/dbm.rst:43 +#: library/dbm.rst:35 msgid "" -"If the database file already exists, the :func:`whichdb` function is used to " -"determine its type and the appropriate module is used; if it does not exist, " -"the first module listed above that can be imported is used." +"a string containing the required module name, such as ``'dbm.ndbm'`` or " +"``'dbm.gnu'``" msgstr "" -#: library/dbm.rst:166 library/dbm.rst:364 -msgid "The optional *flag* argument can be:" +#: library/dbm.rst:202 library/dbm.rst:386 +msgid "*filename* accepts a :term:`path-like object`." msgstr "" -#: library/dbm.rst:169 library/dbm.rst:294 library/dbm.rst:367 -msgid "Value" +#: library/dbm.rst:61 +msgid "Open a database and return the corresponding database object." msgstr "" -#: library/dbm.rst:169 library/dbm.rst:294 library/dbm.rst:367 -msgid "Meaning" +#: library/dbm.rst:0 +msgid "Parameters" msgstr "" -#: library/dbm.rst:171 library/dbm.rst:369 -msgid "``'r'``" +#: library/dbm.rst:63 +msgid "" +"The database file to open. If the database file already exists, the :func:" +"`whichdb` function is used to determine its type and the appropriate module " +"is used; if it does not exist, the first submodule listed above that can be " +"imported is used." msgstr "" -#: library/dbm.rst:171 library/dbm.rst:369 -msgid "Open existing database for reading only (default)" +#: library/dbm.rst:174 +msgid "The database file to open." msgstr "" -#: library/dbm.rst:174 library/dbm.rst:372 -msgid "``'w'``" +#: library/dbm.rst:66 +msgid "" +"If the database file already exists, the :func:`whichdb` function is used to " +"determine its type and the appropriate module is used; if it does not exist, " +"the first submodule listed above that can be imported is used." msgstr "" -#: library/dbm.rst:174 library/dbm.rst:372 -msgid "Open existing database for reading and writing" +#: library/dbm.rst:297 +msgid "" +"* ``'r'`` (default): |flag_r| * ``'w'``: |flag_w| * ``'c'``: |flag_c| * " +"``'n'``: |flag_n|" msgstr "" -#: library/dbm.rst:177 library/dbm.rst:375 -msgid "``'c'``" +#: library/dbm.rst:179 library/dbm.rst:298 +msgid "``'r'`` (default): |flag_r|" msgstr "" -#: library/dbm.rst:177 library/dbm.rst:375 -msgid "Open database for reading and writing, creating it if it doesn't exist" +#: library/dbm.rst:180 library/dbm.rst:367 +msgid "``'w'``: |flag_w|" msgstr "" -#: library/dbm.rst:180 library/dbm.rst:378 -msgid "``'n'``" +#: library/dbm.rst:181 library/dbm.rst:300 +msgid "``'c'``: |flag_c|" msgstr "" -#: library/dbm.rst:180 library/dbm.rst:378 -msgid "Always create a new, empty database, open for reading and writing" +#: library/dbm.rst:182 library/dbm.rst:369 +msgid "``'n'``: |flag_n|" msgstr "" -#: library/dbm.rst:309 library/dbm.rst:382 -msgid "" -"The optional *mode* argument is the Unix mode of the file, used only when " -"the database has to be created. It defaults to octal ``0o666`` (and will be " -"modified by the prevailing umask)." +#: library/dbm.rst:196 library/dbm.rst:371 +msgid "|mode_param_doc|" msgstr "" -#: library/dbm.rst:70 -msgid "" -"The object returned by :func:`.open` supports the same basic functionality " -"as dictionaries; keys and their corresponding values can be stored, " -"retrieved, and deleted, and the :keyword:`in` operator and the :meth:`keys` " -"method are available, as well as :meth:`get` and :meth:`setdefault`." +#: library/dbm.rst:80 +msgid "*file* accepts a :term:`path-like object`." msgstr "" -#: library/dbm.rst:75 +#: library/dbm.rst:83 msgid "" -":meth:`get` and :meth:`setdefault` are now available in all database modules." +"The object returned by :func:`~dbm.open` supports the same basic " +"functionality as a :class:`dict`; keys and their corresponding values can be " +"stored, retrieved, and deleted, and the :keyword:`in` operator and the :meth:" +"`!keys` method are available, as well as :meth:`!get` and :meth:`!" +"setdefault` methods." msgstr "" -#: library/dbm.rst:78 +#: library/dbm.rst:88 msgid "" -"Deleting a key from a read-only database raises database module specific " -"error instead of :exc:`KeyError`." +"Key and values are always stored as :class:`bytes`. This means that when " +"strings are used they are implicitly converted to the default encoding " +"before being stored." msgstr "" -#: library/dbm.rst:82 -msgid "Accepts :term:`path-like object` for file." +#: library/dbm.rst:92 +msgid "" +"These objects also support being used in a :keyword:`with` statement, which " +"will automatically close them when done." msgstr "" -#: library/dbm.rst:85 +#: library/dbm.rst:95 msgid "" -"Key and values are always stored as bytes. This means that when strings are " -"used they are implicitly converted to the default encoding before being " -"stored." +":meth:`!get` and :meth:`!setdefault` methods are now available for all :mod:" +"`dbm` backends." msgstr "" -#: library/dbm.rst:89 +#: library/dbm.rst:99 msgid "" -"These objects also support being used in a :keyword:`with` statement, which " -"will automatically close them when done." +"Added native support for the context management protocol to the objects " +"returned by :func:`~dbm.open`." msgstr "" -#: library/dbm.rst:92 +#: library/dbm.rst:103 msgid "" -"Added native support for the context management protocol to the objects " -"returned by :func:`.open`." +"Deleting a key from a read-only database raises a database module specific " +"exception instead of :exc:`KeyError`." msgstr "" -#: library/dbm.rst:96 +#: library/dbm.rst:107 msgid "" "The following example records some hostnames and a corresponding title, and " "then prints out the contents of the database::" msgstr "" -#: library/dbm.rst:126 +#: library/dbm.rst:137 msgid "Module :mod:`shelve`" msgstr "" -#: library/dbm.rst:127 +#: library/dbm.rst:138 msgid "Persistence module which stores non-string data." msgstr "" -#: library/dbm.rst:130 +#: library/dbm.rst:141 msgid "The individual submodules are described in the following sections." msgstr "" -#: library/dbm.rst:134 -msgid ":mod:`dbm.gnu` --- GNU's reinterpretation of dbm" +#: library/dbm.rst:145 +msgid ":mod:`dbm.gnu` --- GNU database manager" msgstr "" -#: library/dbm.rst:140 +#: library/dbm.rst:151 msgid "**Source code:** :source:`Lib/dbm/gnu.py`" msgstr "" -#: library/dbm.rst:144 +#: library/dbm.rst:155 msgid "" -"This module is quite similar to the :mod:`dbm` module, but uses the GNU " -"library ``gdbm`` instead to provide some additional functionality. Please " -"note that the file formats created by :mod:`dbm.gnu` and :mod:`dbm.ndbm` are " -"incompatible." +"The :mod:`dbm.gnu` module provides an interface to the :abbr:`GDBM (GNU " +"dbm)` library, similar to the :mod:`dbm.ndbm` module, but with additional " +"functionality like crash tolerance." msgstr "" -#: library/dbm.rst:148 +#: library/dbm.rst:267 msgid "" -"The :mod:`dbm.gnu` module provides an interface to the GNU DBM library. " -"``dbm.gnu.gdbm`` objects behave like mappings (dictionaries), except that " -"keys and values are always converted to bytes before storing. Printing a " -"``gdbm`` object doesn't print the keys and values, and the :meth:`items` " -"and :meth:`values` methods are not supported." +"The file formats created by :mod:`dbm.gnu` and :mod:`dbm.ndbm` are " +"incompatible and can not be used interchangeably." msgstr "" -#: library/dbm.rst:157 +#: library/dbm.rst:166 msgid "" "Raised on :mod:`dbm.gnu`-specific errors, such as I/O errors. :exc:" "`KeyError` is raised for general mapping errors like specifying an incorrect " "key." msgstr "" -#: library/dbm.rst:163 +#: library/dbm.rst:172 +msgid "Open a GDBM database and return a :class:`!gdbm` object." +msgstr "" + +#: library/dbm.rst:178 msgid "" -"Open a ``gdbm`` database and return a :class:`gdbm` object. The *filename* " -"argument is the name of the database file." +"* ``'r'`` (default): |flag_r| * ``'w'``: |flag_w| * ``'c'``: |flag_c| * " +"``'n'``: |flag_n| The following additional characters may be appended to " +"control how the database is opened: * ``'f'``: Open the database in fast " +"mode. Writes to the database will not be synchronized. * ``'s'``: " +"Synchronized mode. Changes to the database will be written immediately to " +"the file. * ``'u'``: Do not lock database. Not all flags are valid for all " +"versions of GDBM. See the :data:`open_flags` member for a list of supported " +"flag characters." msgstr "" #: library/dbm.rst:184 msgid "" -"The following additional characters may be appended to the flag to control " -"how the database is opened:" +"The following additional characters may be appended to control how the " +"database is opened:" msgstr "" -#: library/dbm.rst:190 -msgid "``'f'``" +#: library/dbm.rst:187 +msgid "" +"``'f'``: Open the database in fast mode. Writes to the database will not be " +"synchronized." msgstr "" -#: library/dbm.rst:190 +#: library/dbm.rst:189 msgid "" -"Open the database in fast mode. Writes to the database will not be " -"synchronized." +"``'s'``: Synchronized mode. Changes to the database will be written " +"immediately to the file." msgstr "" -#: library/dbm.rst:193 -msgid "``'s'``" +#: library/dbm.rst:191 +msgid "``'u'``: Do not lock database." msgstr "" #: library/dbm.rst:193 msgid "" -"Synchronized mode. This will cause changes to the database to be immediately " -"written to the file." +"Not all flags are valid for all versions of GDBM. See the :data:`open_flags` " +"member for a list of supported flag characters." msgstr "" -#: library/dbm.rst:197 -msgid "``'u'``" +#: library/dbm.rst:0 +msgid "Raises" msgstr "" -#: library/dbm.rst:197 -msgid "Do not lock database." +#: library/dbm.rst:199 +msgid "If an invalid *flag* argument is passed." msgstr "" -#: library/dbm.rst:200 +#: library/dbm.rst:207 msgid "" -"Not all flags are valid for all versions of ``gdbm``. The module constant :" -"const:`open_flags` is a string of supported flag characters. The exception :" -"exc:`error` is raised if an invalid flag is specified." +"A string of characters the *flag* parameter of :meth:`~dbm.gnu.open` " +"supports." msgstr "" -#: library/dbm.rst:204 +#: library/dbm.rst:209 msgid "" -"The optional *mode* argument is the Unix mode of the file, used only when " -"the database has to be created. It defaults to octal ``0o666``." -msgstr "" - -#: library/dbm.rst:207 -msgid "" -"In addition to the dictionary-like methods, ``gdbm`` objects have the " -"following methods:" +":class:`!gdbm` objects behave similar to :term:`mappings `, but :" +"meth:`!items` and :meth:`!values` methods are not supported. The following " +"methods are also provided:" msgstr "" #: library/dbm.rst:215 msgid "" "It's possible to loop over every key in the database using this method and " -"the :meth:`nextkey` method. The traversal is ordered by ``gdbm``'s internal " +"the :meth:`nextkey` method. The traversal is ordered by GDBM's internal " "hash values, and won't be sorted by the key values. This method returns the " "starting key." msgstr "" @@ -290,9 +296,9 @@ msgstr "" #: library/dbm.rst:233 msgid "" "If you have carried out a lot of deletions and would like to shrink the " -"space used by the ``gdbm`` file, this routine will reorganize the database. " -"``gdbm`` objects will not shorten the length of a database file except by " -"using this reorganization; otherwise, deleted file space will be kept and " +"space used by the GDBM file, this routine will reorganize the database. :" +"class:`!gdbm` objects will not shorten the length of a database file except " +"by using this reorganization; otherwise, deleted file space will be kept and " "reused as new (key, value) pairs are added." msgstr "" @@ -303,83 +309,77 @@ msgid "" msgstr "" #: library/dbm.rst:246 -msgid "Close the ``gdbm`` database." +msgid "Close the GDBM database." msgstr "" -#: library/dbm.rst:249 -msgid ":mod:`dbm.ndbm` --- Interface based on ndbm" +#: library/dbm.rst:250 +msgid ":mod:`dbm.ndbm` --- New Database Manager" msgstr "" -#: library/dbm.rst:255 +#: library/dbm.rst:256 msgid "**Source code:** :source:`Lib/dbm/ndbm.py`" msgstr "" -#: library/dbm.rst:259 -msgid "" -"The :mod:`dbm.ndbm` module provides an interface to the Unix \"(n)dbm\" " -"library. Dbm objects behave like mappings (dictionaries), except that keys " -"and values are always stored as bytes. Printing a ``dbm`` object doesn't " -"print the keys and values, and the :meth:`items` and :meth:`values` methods " -"are not supported." -msgstr "" - -#: library/dbm.rst:264 +#: library/dbm.rst:260 msgid "" -"This module can be used with the \"classic\" ndbm interface or the GNU GDBM " -"compatibility interface. On Unix, the :program:`configure` script will " -"attempt to locate the appropriate header file to simplify building this " -"module." +"The :mod:`dbm.ndbm` module provides an interface to the :abbr:`NDBM (New " +"Database Manager)` library. This module can be used with the \"classic\" " +"NDBM interface or the :abbr:`GDBM (GNU dbm)` compatibility interface." msgstr "" -#: library/dbm.rst:270 +#: library/dbm.rst:272 msgid "" -"The ndbm library shipped as part of macOS has an undocumented limitation on " +"The NDBM library shipped as part of macOS has an undocumented limitation on " "the size of values, which can result in corrupted database files when " "storing values larger than this limit. Reading such corrupted files can " "result in a hard crash (segmentation fault)." msgstr "" -#: library/dbm.rst:277 +#: library/dbm.rst:279 msgid "" "Raised on :mod:`dbm.ndbm`-specific errors, such as I/O errors. :exc:" "`KeyError` is raised for general mapping errors like specifying an incorrect " "key." msgstr "" -#: library/dbm.rst:283 -msgid "Name of the ``ndbm`` implementation library used." +#: library/dbm.rst:285 +msgid "Name of the NDBM implementation library used." msgstr "" -#: library/dbm.rst:288 +#: library/dbm.rst:290 +msgid "Open an NDBM database and return an :class:`!ndbm` object." +msgstr "" + +#: library/dbm.rst:292 msgid "" -"Open a dbm database and return a ``ndbm`` object. The *filename* argument " -"is the name of the database file (without the :file:`.dir` or :file:`.pag` " +"The basename of the database file (without the :file:`.dir` or :file:`.pag` " "extensions)." msgstr "" -#: library/dbm.rst:291 -msgid "The optional *flag* argument must be one of these values:" +#: library/dbm.rst:306 +msgid "" +":class:`!ndbm` objects behave similar to :term:`mappings `, but :" +"meth:`!items` and :meth:`!values` methods are not supported. The following " +"methods are also provided:" msgstr "" -#: library/dbm.rst:313 -msgid "" -"In addition to the dictionary-like methods, ``ndbm`` objects provide the " -"following method:" +#: library/dbm.rst:310 +msgid "Accepts :term:`path-like object` for filename." msgstr "" -#: library/dbm.rst:321 -msgid "Close the ``ndbm`` database." +#: library/dbm.rst:315 +msgid "Close the NDBM database." msgstr "" -#: library/dbm.rst:325 +#: library/dbm.rst:319 msgid ":mod:`dbm.dumb` --- Portable DBM implementation" msgstr "" -#: library/dbm.rst:330 +#: library/dbm.rst:324 msgid "**Source code:** :source:`Lib/dbm/dumb.py`" msgstr "" -#: library/dbm.rst:336 +#: library/dbm.rst:330 msgid "" "The :mod:`dbm.dumb` module is intended as a last resort fallback for the :" "mod:`dbm` module when a more robust module is not available. The :mod:`dbm." @@ -387,69 +387,100 @@ msgid "" "the other database modules." msgstr "" -#: library/dbm.rst:343 +#: library/dbm.rst:337 msgid "" -"The :mod:`dbm.dumb` module provides a persistent dictionary-like interface " -"which is written entirely in Python. Unlike other modules such as :mod:`dbm." -"gnu` no external library is required. As with other persistent mappings, " -"the keys and values are always stored as bytes." +"The :mod:`dbm.dumb` module provides a persistent :class:`dict`-like " +"interface which is written entirely in Python. Unlike other :mod:`dbm` " +"backends, such as :mod:`dbm.gnu`, no external library is required." msgstr "" -#: library/dbm.rst:348 -msgid "The module defines the following:" +#: library/dbm.rst:342 +msgid "The :mod:`!dbm.dumb` module defines the following:" msgstr "" -#: library/dbm.rst:353 +#: library/dbm.rst:346 msgid "" "Raised on :mod:`dbm.dumb`-specific errors, such as I/O errors. :exc:" "`KeyError` is raised for general mapping errors like specifying an incorrect " "key." msgstr "" -#: library/dbm.rst:359 +#: library/dbm.rst:352 +msgid "" +"Open a :mod:`!dbm.dumb` database. The returned database object behaves " +"similar to a :term:`mapping`, in addition to providing :meth:`~dumbdbm.sync` " +"and :meth:`~dumbdbm.close` methods." +msgstr "" + +#: library/dbm.rst:357 +msgid "" +"The basename of the database file (without extensions). A new database " +"creates the following files: - :file:`{filename}.dat` - :file:`{filename}." +"dir`" +msgstr "" + +#: library/dbm.rst:358 msgid "" -"Open a ``dumbdbm`` database and return a dumbdbm object. The *filename* " -"argument is the basename of the database file (without any specific " -"extensions). When a dumbdbm database is created, files with :file:`.dat` " -"and :file:`.dir` extensions are created." +"The basename of the database file (without extensions). A new database " +"creates the following files:" +msgstr "" + +#: library/dbm.rst:361 +msgid ":file:`{filename}.dat`" msgstr "" -#: library/dbm.rst:387 +#: library/dbm.rst:362 +msgid ":file:`{filename}.dir`" +msgstr "" + +#: library/dbm.rst:365 +msgid "" +"* ``'r'``: |flag_r| * ``'w'``: |flag_w| * ``'c'`` (default): |flag_c| * " +"``'n'``: |flag_n|" +msgstr "" + +#: library/dbm.rst:366 +msgid "``'r'``: |flag_r|" +msgstr "" + +#: library/dbm.rst:368 +msgid "``'c'`` (default): |flag_c|" +msgstr "" + +#: library/dbm.rst:375 msgid "" "It is possible to crash the Python interpreter when loading a database with " "a sufficiently large/complex entry due to stack depth limitations in " "Python's AST compiler." msgstr "" -#: library/dbm.rst:391 +#: library/dbm.rst:379 msgid "" -":func:`.open` always creates a new database when the flag has the value " -"``'n'``." +":func:`~dbm.dumb.open` always creates a new database when *flag* is ``'n'``." msgstr "" -#: library/dbm.rst:395 +#: library/dbm.rst:382 msgid "" -"A database opened with flags ``'r'`` is now read-only. Opening with flags " -"``'r'`` and ``'w'`` no longer creates a database if it does not exist." +"A database opened read-only if *flag* is ``'r'``. A database is not created " +"if it does not exist if *flag* is ``'r'`` or ``'w'``." msgstr "" -#: library/dbm.rst:403 +#: library/dbm.rst:389 msgid "" "In addition to the methods provided by the :class:`collections.abc." -"MutableMapping` class, :class:`dumbdbm` objects provide the following " -"methods:" +"MutableMapping` class, the following methods are provided:" msgstr "" -#: library/dbm.rst:409 +#: library/dbm.rst:395 msgid "" "Synchronize the on-disk directory and data files. This method is called by " "the :meth:`Shelve.sync` method." msgstr "" -#: library/dbm.rst:414 -msgid "Close the ``dumbdbm`` database." +#: library/dbm.rst:400 +msgid "Close the database." msgstr "" -#: library/dbm.rst:332 +#: library/dbm.rst:326 msgid "databases" msgstr "" diff --git a/library/difflib.po b/library/difflib.po index 205bad26e..b0848430d 100644 --- a/library/difflib.po +++ b/library/difflib.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -71,7 +71,7 @@ msgid "" msgstr "" #: library/difflib.rst:386 -msgid "The *autojunk* parameter." +msgid "Added the *autojunk* parameter." msgstr "" #: library/difflib.rst:61 diff --git a/library/doctest.po b/library/doctest.po index 684a22c0a..1b468172d 100644 --- a/library/doctest.po +++ b/library/doctest.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -78,7 +78,7 @@ msgid "" "`doctest`! Jump in. The following sections provide full details. Note that " "there are many examples of doctests in the standard Python test suite and " "libraries. Especially useful examples can be found in the standard test " -"file :file:`Lib/test/test_doctest.py`." +"file :file:`Lib/test/test_doctest/test_doctest.py`." msgstr "" #: library/doctest.rst:143 @@ -241,9 +241,9 @@ msgid "" "In addition, there are cases when you want tests to be part of a module but " "not part of the help text, which requires that the tests not be included in " "the docstring. Doctest looks for a module-level variable called ``__test__`` " -"and uses it to locate other tests. If ``M.__test__`` exists and is truthy, " -"it must be a dict, and each entry maps a (string) name to a function object, " -"class object, or string. Function and class object docstrings found from ``M." +"and uses it to locate other tests. If ``M.__test__`` exists, it must be a " +"dict, and each entry maps a (string) name to a function object, class " +"object, or string. Function and class object docstrings found from ``M." "__test__`` are searched, and strings are treated as if they were " "docstrings. In output, a key ``K`` in ``M.__test__`` appears with name ``M." "__test__.K``." @@ -925,10 +925,10 @@ msgstr "" #: library/doctest.rst:947 msgid "" -"Also test examples reachable from dict ``m.__test__``, if it exists and is " -"not ``None``. ``m.__test__`` maps names (strings) to functions, classes and " -"strings; function and class docstrings are searched for examples; strings " -"are searched directly, as if they were docstrings." +"Also test examples reachable from dict ``m.__test__``, if it exists. ``m." +"__test__`` maps names (strings) to functions, classes and strings; function " +"and class docstrings are searched for examples; strings are searched " +"directly, as if they were docstrings." msgstr "" #: library/doctest.rst:952 diff --git a/library/email.message.po b/library/email.message.po index e77462c74..40fd9a5ff 100644 --- a/library/email.message.po +++ b/library/email.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -67,10 +67,9 @@ msgid "" "The :class:`EmailMessage` dictionary-like interface is indexed by the header " "names, which must be ASCII values. The values of the dictionary are strings " "with some extra methods. Headers are stored and returned in case-preserving " -"form, but field names are matched case-insensitively. Unlike a real dict, " -"there is an ordering to the keys, and there can be duplicate keys. " -"Additional methods are provided for working with headers that have duplicate " -"keys." +"form, but field names are matched case-insensitively. The keys are ordered, " +"but unlike a real dict, there can be duplicates. Addtional methods are " +"provided for working with headers that have duplicate keys." msgstr "" #: library/email.message.rst:47 diff --git a/library/email.policy.po b/library/email.policy.po index de81e9d27..04e95650f 100644 --- a/library/email.policy.po +++ b/library/email.policy.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -238,57 +238,53 @@ msgid "" "being serialized by a generator. Default: :const:`False`." msgstr "" -#: library/email.policy.rst:221 -msgid "The *mangle_from_* parameter." -msgstr "" - -#: library/email.policy.rst:227 +#: library/email.policy.rst:226 msgid "" "A factory function for constructing a new empty message object. Used by the " "parser when building messages. Defaults to ``None``, in which case :class:" "`~email.message.Message` is used." msgstr "" -#: library/email.policy.rst:233 +#: library/email.policy.rst:232 msgid "" "The following :class:`Policy` method is intended to be called by code using " "the email library to create policy instances with custom settings:" msgstr "" -#: library/email.policy.rst:239 +#: library/email.policy.rst:238 msgid "" "Return a new :class:`Policy` instance whose attributes have the same values " "as the current instance, except where those attributes are given new values " "by the keyword arguments." msgstr "" -#: library/email.policy.rst:244 +#: library/email.policy.rst:243 msgid "" "The remaining :class:`Policy` methods are called by the email package code, " "and are not intended to be called by an application using the email package. " "A custom policy must implement all of these methods." msgstr "" -#: library/email.policy.rst:251 +#: library/email.policy.rst:250 msgid "" "Handle a *defect* found on *obj*. When the email package calls this method, " "*defect* will always be a subclass of :class:`~email.errors.Defect`." msgstr "" -#: library/email.policy.rst:255 +#: library/email.policy.rst:254 msgid "" "The default implementation checks the :attr:`raise_on_defect` flag. If it " "is ``True``, *defect* is raised as an exception. If it is ``False`` (the " "default), *obj* and *defect* are passed to :meth:`register_defect`." msgstr "" -#: library/email.policy.rst:262 +#: library/email.policy.rst:261 msgid "" "Register a *defect* on *obj*. In the email package, *defect* will always be " "a subclass of :class:`~email.errors.Defect`." msgstr "" -#: library/email.policy.rst:265 +#: library/email.policy.rst:264 msgid "" "The default implementation calls the ``append`` method of the ``defects`` " "attribute of *obj*. When the email package calls :attr:`handle_defect`, " @@ -298,11 +294,11 @@ msgid "" "defects in parsed messages will raise unexpected errors." msgstr "" -#: library/email.policy.rst:275 +#: library/email.policy.rst:274 msgid "Return the maximum allowed number of headers named *name*." msgstr "" -#: library/email.policy.rst:277 +#: library/email.policy.rst:276 msgid "" "Called when a header is added to an :class:`~email.message.EmailMessage` or :" "class:`~email.message.Message` object. If the returned value is not ``0`` " @@ -310,7 +306,7 @@ msgid "" "greater than or equal to the value returned, a :exc:`ValueError` is raised." msgstr "" -#: library/email.policy.rst:283 +#: library/email.policy.rst:282 msgid "" "Because the default behavior of ``Message.__setitem__`` is to append the " "value to the list of headers, it is easy to create duplicate headers without " @@ -320,11 +316,11 @@ msgid "" "faithfully produce as many headers as exist in the message being parsed.)" msgstr "" -#: library/email.policy.rst:291 +#: library/email.policy.rst:290 msgid "The default implementation returns ``None`` for all header names." msgstr "" -#: library/email.policy.rst:296 +#: library/email.policy.rst:295 msgid "" "The email package calls this method with a list of strings, each string " "ending with the line separation characters found in the source being " @@ -334,7 +330,7 @@ msgid "" "the parsed header." msgstr "" -#: library/email.policy.rst:303 +#: library/email.policy.rst:302 msgid "" "If an implementation wishes to retain compatibility with the existing email " "package policies, *name* should be the case preserved name (all characters " @@ -343,15 +339,15 @@ msgid "" "stripped of leading whitespace." msgstr "" -#: library/email.policy.rst:309 +#: library/email.policy.rst:308 msgid "*sourcelines* may contain surrogateescaped binary data." msgstr "" -#: library/email.policy.rst:327 library/email.policy.rst:343 +#: library/email.policy.rst:326 library/email.policy.rst:342 msgid "There is no default implementation" msgstr "" -#: library/email.policy.rst:316 +#: library/email.policy.rst:315 msgid "" "The email package calls this method with the name and value provided by the " "application program when the application program is modifying a ``Message`` " @@ -360,14 +356,14 @@ msgid "" "``Message`` to represent the header." msgstr "" -#: library/email.policy.rst:322 +#: library/email.policy.rst:321 msgid "" "If an implementation wishes to retain compatibility with the existing email " "package policies, the *name* and *value* should be strings or string " "subclasses that do not change the content of the passed in arguments." msgstr "" -#: library/email.policy.rst:332 +#: library/email.policy.rst:331 msgid "" "The email package calls this method with the *name* and *value* currently " "stored in the ``Message`` when that header is requested by the application " @@ -378,13 +374,13 @@ msgid "" "returned to the application." msgstr "" -#: library/email.policy.rst:340 +#: library/email.policy.rst:339 msgid "" "*value* may contain surrogateescaped binary data. There should be no " "surrogateescaped binary data in the value returned by the method." msgstr "" -#: library/email.policy.rst:348 +#: library/email.policy.rst:347 msgid "" "The email package calls this method with the *name* and *value* currently " "stored in the ``Message`` for a given header. The method should return a " @@ -394,32 +390,32 @@ msgid "" "discussion of the rules for folding email headers." msgstr "" -#: library/email.policy.rst:355 +#: library/email.policy.rst:354 msgid "" "*value* may contain surrogateescaped binary data. There should be no " "surrogateescaped binary data in the string returned by the method." msgstr "" -#: library/email.policy.rst:361 +#: library/email.policy.rst:360 msgid "" "The same as :meth:`fold`, except that the returned value should be a bytes " "object rather than a string." msgstr "" -#: library/email.policy.rst:364 +#: library/email.policy.rst:363 msgid "" "*value* may contain surrogateescaped binary data. These could be converted " "back into binary data in the returned bytes object." msgstr "" -#: library/email.policy.rst:371 +#: library/email.policy.rst:370 msgid "" "This concrete :class:`Policy` provides behavior that is intended to be fully " "compliant with the current email RFCs. These include (but are not limited " "to) :rfc:`5322`, :rfc:`2047`, and the current MIME RFCs." msgstr "" -#: library/email.policy.rst:375 +#: library/email.policy.rst:374 msgid "" "This policy adds new header parsing and folding algorithms. Instead of " "simple strings, headers are ``str`` subclasses with attributes that depend " @@ -427,23 +423,23 @@ msgid "" "implement :rfc:`2047` and :rfc:`5322`." msgstr "" -#: library/email.policy.rst:380 +#: library/email.policy.rst:379 msgid "" "The default value for the :attr:`~email.policy.Policy.message_factory` " "attribute is :class:`~email.message.EmailMessage`." msgstr "" -#: library/email.policy.rst:383 +#: library/email.policy.rst:382 msgid "" "In addition to the settable attributes listed above that apply to all " "policies, this policy adds the following additional attributes:" msgstr "" -#: library/email.policy.rst:386 +#: library/email.policy.rst:385 msgid "[1]_" msgstr "" -#: library/email.policy.rst:391 +#: library/email.policy.rst:390 msgid "" "If ``False``, follow :rfc:`5322`, supporting non-ASCII characters in headers " "by encoding them as \"encoded words\". If ``True``, follow :rfc:`6532` and " @@ -451,7 +447,7 @@ msgid "" "passed to SMTP servers that support the ``SMTPUTF8`` extension (:rfc:`6531`)." msgstr "" -#: library/email.policy.rst:400 +#: library/email.policy.rst:399 msgid "" "If the value for a header in the ``Message`` object originated from a :mod:" "`~email.parser` (as opposed to being set by a program), this attribute " @@ -459,37 +455,37 @@ msgid "" "transforming the message back into serialized form. The possible values are:" msgstr "" -#: library/email.policy.rst:407 +#: library/email.policy.rst:406 msgid "``none``" msgstr "" -#: library/email.policy.rst:407 +#: library/email.policy.rst:406 msgid "all source values use original folding" msgstr "" -#: library/email.policy.rst:409 +#: library/email.policy.rst:408 msgid "``long``" msgstr "" -#: library/email.policy.rst:409 +#: library/email.policy.rst:408 msgid "" "source values that have any line that is longer than ``max_line_length`` " "will be refolded" msgstr "" -#: library/email.policy.rst:412 +#: library/email.policy.rst:411 msgid "``all``" msgstr "" -#: library/email.policy.rst:412 +#: library/email.policy.rst:411 msgid "all values are refolded." msgstr "" -#: library/email.policy.rst:415 +#: library/email.policy.rst:414 msgid "The default is ``long``." msgstr "" -#: library/email.policy.rst:420 +#: library/email.policy.rst:419 msgid "" "A callable that takes two arguments, ``name`` and ``value``, where ``name`` " "is a header field name and ``value`` is an unfolded header field value, and " @@ -500,7 +496,7 @@ msgid "" "custom parsing will be added in the future." msgstr "" -#: library/email.policy.rst:431 +#: library/email.policy.rst:430 msgid "" "An object with at least two methods: get_content and set_content. When the :" "meth:`~email.message.EmailMessage.get_content` or :meth:`~email.message." @@ -511,20 +507,20 @@ msgid "" "``content_manager`` is set to :data:`~email.contentmanager.raw_data_manager`." msgstr "" -#: library/email.policy.rst:601 +#: library/email.policy.rst:600 msgid "" "The class provides the following concrete implementations of the abstract " "methods of :class:`Policy`:" msgstr "" -#: library/email.policy.rst:449 +#: library/email.policy.rst:448 msgid "" "Returns the value of the :attr:`~email.headerregistry.BaseHeader.max_count` " "attribute of the specialized class used to represent the header with the " "given name." msgstr "" -#: library/email.policy.rst:607 +#: library/email.policy.rst:606 msgid "" "The name is parsed as everything up to the '``:``' and returned unmodified. " "The value is determined by stripping leading whitespace off the remainder of " @@ -532,7 +528,7 @@ msgid "" "trailing carriage return or linefeed characters." msgstr "" -#: library/email.policy.rst:465 +#: library/email.policy.rst:464 msgid "" "The name is returned unchanged. If the input value has a ``name`` attribute " "and it matches *name* ignoring case, the value is returned unchanged. " @@ -541,7 +537,7 @@ msgid "" "``ValueError`` is raised if the input value contains CR or LF characters." msgstr "" -#: library/email.policy.rst:475 +#: library/email.policy.rst:474 msgid "" "If the value has a ``name`` attribute, it is returned to unmodified. " "Otherwise the *name*, and the *value* with any CR or LF characters removed, " @@ -550,7 +546,7 @@ msgid "" "character glyph." msgstr "" -#: library/email.policy.rst:484 +#: library/email.policy.rst:483 msgid "" "Header folding is controlled by the :attr:`refold_source` policy setting. A " "value is considered to be a 'source value' if and only if it does not have a " @@ -562,7 +558,7 @@ msgid "" "current policy." msgstr "" -#: library/email.policy.rst:493 +#: library/email.policy.rst:492 msgid "" "Source values are split into lines using :meth:`~str.splitlines`. If the " "value is not to be refolded, the lines are rejoined using the ``linesep`` " @@ -572,13 +568,13 @@ msgid "" "using the ``unknown-8bit`` charset." msgstr "" -#: library/email.policy.rst:503 +#: library/email.policy.rst:502 msgid "" "The same as :meth:`fold` if :attr:`~Policy.cte_type` is ``7bit``, except " "that the returned value is bytes." msgstr "" -#: library/email.policy.rst:506 +#: library/email.policy.rst:505 msgid "" "If :attr:`~Policy.cte_type` is ``8bit``, non-ASCII binary data is converted " "back into bytes. Headers with binary data are not refolded, regardless of " @@ -586,7 +582,7 @@ msgid "" "binary data consists of single byte characters or multibyte characters." msgstr "" -#: library/email.policy.rst:513 +#: library/email.policy.rst:512 msgid "" "The following instances of :class:`EmailPolicy` provide defaults suitable " "for specific application domains. Note that in the future the behavior of " @@ -594,20 +590,20 @@ msgid "" "conform even more closely to the RFCs relevant to their domains." msgstr "" -#: library/email.policy.rst:521 +#: library/email.policy.rst:520 msgid "" "An instance of ``EmailPolicy`` with all defaults unchanged. This policy " "uses the standard Python ``\\n`` line endings rather than the RFC-correct " "``\\r\\n``." msgstr "" -#: library/email.policy.rst:528 +#: library/email.policy.rst:527 msgid "" "Suitable for serializing messages in conformance with the email RFCs. Like " "``default``, but with ``linesep`` set to ``\\r\\n``, which is RFC compliant." msgstr "" -#: library/email.policy.rst:535 +#: library/email.policy.rst:534 msgid "" "The same as ``SMTP`` except that :attr:`~EmailPolicy.utf8` is ``True``. " "Useful for serializing messages to a message store without using encoded " @@ -616,46 +612,46 @@ msgid "" "SMTP.send_message` method handles this automatically)." msgstr "" -#: library/email.policy.rst:544 +#: library/email.policy.rst:543 msgid "" "Suitable for serializing headers with for use in HTTP traffic. Like " "``SMTP`` except that ``max_line_length`` is set to ``None`` (unlimited)." msgstr "" -#: library/email.policy.rst:550 +#: library/email.policy.rst:549 msgid "" "Convenience instance. The same as ``default`` except that " "``raise_on_defect`` is set to ``True``. This allows any policy to be made " "strict by writing::" msgstr "" -#: library/email.policy.rst:557 +#: library/email.policy.rst:556 msgid "" "With all of these :class:`EmailPolicies <.EmailPolicy>`, the effective API " "of the email package is changed from the Python 3.2 API in the following " "ways:" msgstr "" -#: library/email.policy.rst:560 +#: library/email.policy.rst:559 msgid "" "Setting a header on a :class:`~email.message.Message` results in that header " "being parsed and a header object created." msgstr "" -#: library/email.policy.rst:563 +#: library/email.policy.rst:562 msgid "" "Fetching a header value from a :class:`~email.message.Message` results in " "that header being parsed and a header object created and returned." msgstr "" -#: library/email.policy.rst:567 +#: library/email.policy.rst:566 msgid "" "Any header object, or any header that is refolded due to the policy " "settings, is folded using an algorithm that fully implements the RFC folding " "algorithms, including knowing where encoded words are required and allowed." msgstr "" -#: library/email.policy.rst:572 +#: library/email.policy.rst:571 msgid "" "From the application view, this means that any header obtained through the :" "class:`~email.message.EmailMessage` is a header object with extra " @@ -665,13 +661,13 @@ msgid "" "the unicode string into the correct RFC encoded form." msgstr "" -#: library/email.policy.rst:579 +#: library/email.policy.rst:578 msgid "" "The header objects and their attributes are described in :mod:`~email." "headerregistry`." msgstr "" -#: library/email.policy.rst:586 +#: library/email.policy.rst:585 msgid "" "This concrete :class:`Policy` is the backward compatibility policy. It " "replicates the behavior of the email package in Python 3.2. The :mod:" @@ -680,28 +676,28 @@ msgid "" "of the email package is to maintain compatibility with Python 3.2." msgstr "" -#: library/email.policy.rst:592 +#: library/email.policy.rst:591 msgid "" "The following attributes have values that are different from the :class:" "`Policy` default:" msgstr "" -#: library/email.policy.rst:598 +#: library/email.policy.rst:597 msgid "The default is ``True``." msgstr "" -#: library/email.policy.rst:615 +#: library/email.policy.rst:614 msgid "The name and value are returned unmodified." msgstr "" -#: library/email.policy.rst:620 +#: library/email.policy.rst:619 msgid "" "If the value contains binary data, it is converted into a :class:`~email." "header.Header` object using the ``unknown-8bit`` charset. Otherwise it is " "returned unmodified." msgstr "" -#: library/email.policy.rst:627 +#: library/email.policy.rst:626 msgid "" "Headers are folded using the :class:`~email.header.Header` folding " "algorithm, which preserves existing line breaks in the value, and wraps each " @@ -709,7 +705,7 @@ msgid "" "encoded using the ``unknown-8bit`` charset." msgstr "" -#: library/email.policy.rst:635 +#: library/email.policy.rst:634 msgid "" "Headers are folded using the :class:`~email.header.Header` folding " "algorithm, which preserves existing line breaks in the value, and wraps each " @@ -719,17 +715,17 @@ msgid "" "and any (RFC invalid) binary data it may contain." msgstr "" -#: library/email.policy.rst:645 +#: library/email.policy.rst:644 msgid "" "An instance of :class:`Compat32`, providing backward compatibility with the " "behavior of the email package in Python 3.2." msgstr "" -#: library/email.policy.rst:650 +#: library/email.policy.rst:649 msgid "Footnotes" msgstr "" -#: library/email.policy.rst:651 +#: library/email.policy.rst:650 msgid "" "Originally added in 3.3 as a :term:`provisional feature `." diff --git a/library/ensurepip.po b/library/ensurepip.po index d05b84c9c..4d3958180 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -206,7 +206,7 @@ msgid "" "bootstrapping operation." msgstr "" -#: library/ensurepip.rst:134 +#: library/ensurepip.rst:136 msgid "" "Raises an :ref:`auditing event ` ``ensurepip.bootstrap`` with " "argument ``root``." diff --git a/library/enum.po b/library/enum.po index 84abd7b68..f6f16b7c2 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: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -409,50 +409,68 @@ msgid "Returns the number of member in *cls*::" msgstr "" #: library/enum.rst:240 +msgid "Returns a mapping of every enum name to its member, including aliases" +msgstr "" + +#: library/enum.rst:244 msgid "Returns each member in *cls* in reverse definition order::" msgstr "" -#: library/enum.rst:247 +#: library/enum.rst:251 msgid "Before 3.11 ``enum`` used ``EnumMeta`` type, which is kept as an alias." msgstr "" -#: library/enum.rst:252 +#: library/enum.rst:256 msgid "*Enum* is the base class for all *enum* enumerations." msgstr "" -#: library/enum.rst:256 +#: library/enum.rst:260 msgid "The name used to define the ``Enum`` member::" msgstr "" -#: library/enum.rst:263 +#: library/enum.rst:267 msgid "The value given to the ``Enum`` member::" msgstr "" -#: library/enum.rst:268 +#: library/enum.rst:272 msgid "Enum member values" msgstr "" -#: library/enum.rst:270 +#: library/enum.rst:274 msgid "" "Member values can be anything: :class:`int`, :class:`str`, etc. If the " "exact value is unimportant you may use :class:`auto` instances and an " "appropriate value will be chosen for you. See :class:`auto` for the details." msgstr "" -#: library/enum.rst:277 +#: library/enum.rst:281 +msgid "Name of the member." +msgstr "" + +#: library/enum.rst:285 +msgid "Value of the member, can be set in :meth:`~object.__new__`." +msgstr "" + +#: library/enum.rst:289 +msgid "" +"No longer used, kept for backward compatibility. (class attribute, removed " +"during class creation)." +msgstr "" + +#: library/enum.rst:294 msgid "" "``_ignore_`` is only used during creation and is removed from the " "enumeration once creation is complete." msgstr "" -#: library/enum.rst:280 +#: library/enum.rst:297 msgid "" "``_ignore_`` is a list of names that will not become members, and whose " "names will also be removed from the completed enumeration. See :ref:" "`TimePeriod ` for an example." msgstr "" -#: library/enum.rst:286 +#: library/enum.rst:303 msgid "" "Returns ``['__class__', '__doc__', '__module__', 'name', 'value']`` and any " "public methods defined on *self.__class__*::" @@ -462,11 +480,11 @@ msgstr "" msgid "name" msgstr "" -#: library/enum.rst:307 +#: library/enum.rst:324 msgid "The name of the member being defined (e.g. 'RED')." msgstr "" -#: library/enum.rst:308 +#: library/enum.rst:325 msgid "The start value for the Enum; the default is 1." msgstr "" @@ -474,7 +492,7 @@ msgstr "" msgid "count" msgstr "" -#: library/enum.rst:309 +#: library/enum.rst:326 msgid "The number of members currently defined, not including this one." msgstr "" @@ -482,57 +500,81 @@ msgstr "" msgid "last_values" msgstr "" -#: library/enum.rst:310 +#: library/enum.rst:327 msgid "A list of the previous values." msgstr "" -#: library/enum.rst:312 +#: library/enum.rst:329 msgid "" "A *staticmethod* that is used to determine the next value returned by :class:" "`auto`::" msgstr "" -#: library/enum.rst:328 +#: library/enum.rst:345 +msgid "" +"By default, does nothing. If multiple values are given in the member " +"assignment, those values become separate arguments to ``__init__``; e.g." +msgstr "" + +#: library/enum.rst:352 +msgid "" +"``Weekday.__init__()`` would be called as ``Weekday.__init__(self, 1, " +"'Mon')``" +msgstr "" + +#: library/enum.rst:356 msgid "" "A *classmethod* that is used to further configure subsequent subclasses. By " "default, does nothing." msgstr "" -#: library/enum.rst:333 +#: library/enum.rst:361 msgid "" "A *classmethod* for looking up values not found in *cls*. By default it " "does nothing, but can be overridden to implement custom search behavior::" msgstr "" -#: library/enum.rst:355 +#: library/enum.rst:383 +msgid "" +"By default, doesn't exist. If specified, either in the enum class " +"definition or in a mixin class (such as ``int``), all values given in the " +"member assignment will be passed; e.g." +msgstr "" + +#: library/enum.rst:391 +msgid "" +"results in the call ``int('1a', 16)`` and a value of ``17`` for the member." +msgstr "" + +#: library/enum.rst:395 msgid "" "Returns the string used for *repr()* calls. By default, returns the *Enum* " "name, member name, and value, but can be overridden::" msgstr "" -#: library/enum.rst:371 +#: library/enum.rst:411 msgid "" "Returns the string used for *str()* calls. By default, returns the *Enum* " "name and member name, but can be overridden::" msgstr "" -#: library/enum.rst:386 +#: library/enum.rst:426 msgid "" "Returns the string used for *format()* and *f-string* calls. By default, " "returns :meth:`__str__` return value, but can be overridden::" msgstr "" -#: library/enum.rst:401 +#: library/enum.rst:441 msgid "" "Using :class:`auto` with :class:`Enum` results in integers of increasing " "value, starting with ``1``." msgstr "" -#: library/enum.rst:404 +#: library/enum.rst:444 msgid "Added :ref:`enum-dataclass-support`" msgstr "" -#: library/enum.rst:409 +#: library/enum.rst:449 msgid "" "*IntEnum* is the same as *Enum*, but its members are also integers and can " "be used anywhere that an integer can be used. If any integer operation is " @@ -540,20 +582,20 @@ msgid "" "enumeration status." msgstr "" -#: library/enum.rst:430 +#: library/enum.rst:470 msgid "" "Using :class:`auto` with :class:`IntEnum` results in integers of increasing " "value, starting with ``1``." msgstr "" -#: library/enum.rst:433 +#: library/enum.rst:473 msgid "" ":meth:`~object.__str__` is now :meth:`!int.__str__` to better support the " "*replacement of existing constants* use-case. :meth:`~object.__format__` was " "already :meth:`!int.__format__` for that same reason." msgstr "" -#: library/enum.rst:440 +#: library/enum.rst:480 msgid "" "*StrEnum* is the same as *Enum*, but its members are also strings and can be " "used in most of the same places that a string can be used. The result of " @@ -561,7 +603,7 @@ msgid "" "the enumeration." msgstr "" -#: library/enum.rst:446 +#: library/enum.rst:486 msgid "" "There are places in the stdlib that check for an exact :class:`str` instead " "of a :class:`str` subclass (i.e. ``type(unknown) == str`` instead of " @@ -569,285 +611,280 @@ msgid "" "``str(StrEnum.member)``." msgstr "" -#: library/enum.rst:453 +#: library/enum.rst:493 msgid "" "Using :class:`auto` with :class:`StrEnum` results in the lower-cased member " "name as the value." msgstr "" -#: library/enum.rst:458 +#: library/enum.rst:498 msgid "" ":meth:`~object.__str__` is :meth:`!str.__str__` to better support the " "*replacement of existing constants* use-case. :meth:`~object.__format__` is " "likewise :meth:`!str.__format__` for that same reason." msgstr "" -#: library/enum.rst:466 +#: library/enum.rst:506 msgid "" -"*Flag* members support the bitwise operators ``&`` (*AND*), ``|`` (*OR*), " -"``^`` (*XOR*), and ``~`` (*INVERT*); the results of those operators are " -"members of the enumeration." +"``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." msgstr "" -#: library/enum.rst:472 +#: library/enum.rst:512 msgid "Returns *True* if value is in self::" msgstr "" -#: library/enum.rst:493 +#: library/enum.rst:533 msgid "Returns all contained non-alias members::" msgstr "" -#: library/enum.rst:502 -msgid "Aliases are no longer returned during iteration." -msgstr "" - -#: library/enum.rst:506 +#: library/enum.rst:544 msgid "Returns number of members in flag::" msgstr "" -#: library/enum.rst:515 +#: library/enum.rst:553 msgid "Returns *True* if any members in flag, *False* otherwise::" msgstr "" -#: library/enum.rst:527 +#: library/enum.rst:565 msgid "Returns current flag binary or'ed with other::" msgstr "" -#: library/enum.rst:534 +#: library/enum.rst:572 msgid "Returns current flag binary and'ed with other::" msgstr "" -#: library/enum.rst:543 +#: library/enum.rst:581 msgid "Returns current flag binary xor'ed with other::" msgstr "" -#: library/enum.rst:552 +#: library/enum.rst:590 msgid "Returns all the flags in *type(self)* that are not in self::" msgstr "" -#: library/enum.rst:563 +#: library/enum.rst:601 msgid "" "Function used to format any remaining unnamed numeric values. Default is " "the value's repr; common choices are :func:`hex` and :func:`oct`." msgstr "" -#: library/enum.rst:568 +#: library/enum.rst:606 msgid "" "Using :class:`auto` with :class:`Flag` results in integers that are powers " "of two, starting with ``1``." msgstr "" -#: library/enum.rst:571 +#: library/enum.rst:609 msgid "The *repr()* of zero-valued flags has changed. It is now::" msgstr "" -#: library/enum.rst:579 +#: library/enum.rst:617 msgid "" "*IntFlag* is the same as *Flag*, but its members are also integers and can " "be used anywhere that an integer can be used." msgstr "" -#: library/enum.rst:593 +#: library/enum.rst:631 msgid "" "If any integer operation is performed with an *IntFlag* member, the result " "is not an *IntFlag*::" msgstr "" -#: library/enum.rst:599 +#: library/enum.rst:637 msgid "If a *Flag* operation is performed with an *IntFlag* member and:" msgstr "" -#: library/enum.rst:601 +#: library/enum.rst:639 msgid "the result is a valid *IntFlag*: an *IntFlag* is returned" msgstr "" -#: library/enum.rst:602 +#: library/enum.rst:640 msgid "" "the result is not a valid *IntFlag*: the result depends on the " "*FlagBoundary* setting" msgstr "" -#: library/enum.rst:604 +#: library/enum.rst:642 msgid "The *repr()* of unnamed zero-valued flags has changed. It is now:" msgstr "" -#: library/enum.rst:611 +#: library/enum.rst:649 msgid "" "Using :class:`auto` with :class:`IntFlag` results in integers that are " "powers of two, starting with ``1``." msgstr "" -#: library/enum.rst:616 +#: library/enum.rst:654 msgid "" ":meth:`~object.__str__` is now :meth:`!int.__str__` to better support the " "*replacement of existing constants* use-case. :meth:`~object.__format__` " "was already :meth:`!int.__format__` for that same reason." msgstr "" -#: library/enum.rst:620 +#: library/enum.rst:658 msgid "" "Inversion of an :class:`!IntFlag` now returns a positive value that is the " "union of all flags not in the given flag, rather than a negative value. This " "matches the existing :class:`Flag` behavior." msgstr "" -#: library/enum.rst:626 +#: library/enum.rst:664 msgid "" ":class:`!ReprEnum` uses the :meth:`repr() ` of :class:`Enum`, " "but the :class:`str() ` of the mixed-in data type:" msgstr "" -#: library/enum.rst:629 +#: library/enum.rst:667 msgid ":meth:`!int.__str__` for :class:`IntEnum` and :class:`IntFlag`" msgstr "" -#: library/enum.rst:630 +#: library/enum.rst:668 msgid ":meth:`!str.__str__` for :class:`StrEnum`" msgstr "" -#: library/enum.rst:632 +#: library/enum.rst:670 msgid "" "Inherit from :class:`!ReprEnum` to keep the :class:`str() ` / :func:" "`format` of the mixed-in data type instead of using the :class:`Enum`-" "default :meth:`str() `." msgstr "" -#: library/enum.rst:641 +#: library/enum.rst:679 msgid "" "*EnumCheck* contains the options used by the :func:`verify` decorator to " "ensure various constraints; failed constraints result in a :exc:`ValueError`." msgstr "" -#: library/enum.rst:646 +#: library/enum.rst:684 msgid "Ensure that each value has only one name::" msgstr "" -#: library/enum.rst:662 +#: library/enum.rst:700 msgid "" "Ensure that there are no missing values between the lowest-valued member and " "the highest-valued member::" msgstr "" -#: library/enum.rst:677 +#: library/enum.rst:715 msgid "" "Ensure that any flag groups/masks contain only named flags -- useful when " "values are specified instead of being generated by :func:`auto`::" msgstr "" -#: library/enum.rst:694 +#: library/enum.rst:732 msgid "" "CONTINUOUS and NAMED_FLAGS are designed to work with integer-valued members." msgstr "" -#: library/enum.rst:700 +#: library/enum.rst:738 msgid "" "*FlagBoundary* controls how out-of-range values are handled in *Flag* and " "its subclasses." msgstr "" -#: library/enum.rst:705 +#: library/enum.rst:743 msgid "" "Out-of-range values cause a :exc:`ValueError` to be raised. This is the " "default for :class:`Flag`::" msgstr "" -#: library/enum.rst:723 +#: library/enum.rst:761 msgid "" "Out-of-range values have invalid values removed, leaving a valid *Flag* " "value::" msgstr "" -#: library/enum.rst:737 +#: library/enum.rst:775 msgid "" "Out-of-range values lose their *Flag* membership and revert to :class:`int`." msgstr "" -#: library/enum.rst:750 +#: library/enum.rst:788 msgid "" "Out-of-range values are kept, and the *Flag* membership is kept. This is the " "default for :class:`IntFlag`::" msgstr "" -#: library/enum.rst:767 +#: library/enum.rst:805 msgid "Supported ``__dunder__`` names" msgstr "" -#: library/enum.rst:769 +#: library/enum.rst:807 msgid "" ":attr:`~EnumType.__members__` is a read-only ordered mapping of " "``member_name``:``member`` items. It is only available on the class." msgstr "" -#: library/enum.rst:772 +#: library/enum.rst:810 msgid "" ":meth:`~object.__new__`, if specified, must create and return the enum " "members; it is also a very good idea to set the member's :attr:`!_value_` " "appropriately. Once all the members are created it is no longer used." msgstr "" -#: library/enum.rst:778 +#: library/enum.rst:816 msgid "Supported ``_sunder_`` names" msgstr "" -#: library/enum.rst:780 -msgid "``_name_`` -- name of the member" +#: library/enum.rst:818 +msgid ":attr:`~Enum._name_` -- name of the member" msgstr "" -#: library/enum.rst:781 -msgid "" -"``_value_`` -- value of the member; can be set / modified in ``__new__``" +#: library/enum.rst:819 +msgid ":attr:`~Enum._value_` -- value of the member; can be set in ``__new__``" msgstr "" -#: library/enum.rst:783 +#: library/enum.rst:820 msgid "" -"``_missing_`` -- a lookup function used when a value is not found; may be " -"overridden" +":meth:`~Enum._missing_` -- a lookup function used when a value is not found; " +"may be overridden" msgstr "" -#: library/enum.rst:785 +#: library/enum.rst:822 msgid "" -"``_ignore_`` -- a list of names, either as a :class:`list` or a :class:" -"`str`, that will not be transformed into members, and will be removed from " -"the final class" +":attr:`~Enum._ignore_` -- a list of names, either as a :class:`list` or a :" +"class:`str`, that will not be transformed into members, and will be removed " +"from the final class" msgstr "" -#: library/enum.rst:788 +#: library/enum.rst:825 msgid "" -"``_order_`` -- used in Python 2/3 code to ensure member order is consistent " +":attr:`~Enum._order_` -- no longer used, kept for backward compatibility " "(class attribute, removed during class creation)" msgstr "" -#: library/enum.rst:790 +#: library/enum.rst:827 msgid "" -"``_generate_next_value_`` -- used to get an appropriate value for an enum " -"member; may be overridden" +":meth:`~Enum._generate_next_value_` -- used to get an appropriate value for " +"an enum member; may be overridden" msgstr "" -#: library/enum.rst:795 +#: library/enum.rst:832 msgid "" "For standard :class:`Enum` classes the next value chosen is the last value " "seen incremented by one." msgstr "" -#: library/enum.rst:798 +#: library/enum.rst:835 msgid "" "For :class:`Flag` classes the next value chosen will be the next highest " "power-of-two, regardless of the last value seen." msgstr "" -#: library/enum.rst:801 +#: library/enum.rst:838 msgid "``_missing_``, ``_order_``, ``_generate_next_value_``" msgstr "" -#: library/enum.rst:802 +#: library/enum.rst:839 msgid "``_ignore_``" msgstr "" -#: library/enum.rst:807 +#: library/enum.rst:844 msgid "Utilities and Decorators" msgstr "" -#: library/enum.rst:811 +#: library/enum.rst:848 msgid "" "*auto* can be used in place of a value. If used, the *Enum* machinery will " "call an *Enum*'s :meth:`~Enum._generate_next_value_` to get an appropriate " @@ -858,58 +895,54 @@ msgid "" "manually specified values." msgstr "" -#: library/enum.rst:819 +#: library/enum.rst:856 msgid "" "*auto* instances are only resolved when at the top level of an assignment:" msgstr "" -#: library/enum.rst:821 +#: library/enum.rst:858 msgid "``FIRST = auto()`` will work (auto() is replaced with ``1``);" msgstr "" -#: library/enum.rst:822 +#: library/enum.rst:859 msgid "" "``SECOND = auto(), -2`` will work (auto is replaced with ``2``, so ``2, -2`` " -"is" -msgstr "" - -#: library/enum.rst:823 -msgid "used to create the ``SECOND`` enum member;" +"is used to create the ``SECOND`` enum member;" msgstr "" -#: library/enum.rst:824 +#: library/enum.rst:861 msgid "" "``THREE = [auto(), -3]`` will *not* work (``, -3`` is used to " "create the ``THREE`` enum member)" msgstr "" -#: library/enum.rst:829 +#: library/enum.rst:866 msgid "" "In prior versions, ``auto()`` had to be the only thing on the assignment " "line to work properly." msgstr "" -#: library/enum.rst:832 +#: library/enum.rst:869 msgid "" "``_generate_next_value_`` can be overridden to customize the values used by " "*auto*." msgstr "" -#: library/enum.rst:835 +#: library/enum.rst:872 msgid "" "in 3.13 the default ``_generate_next_value_`` will always return the highest " "member value incremented by 1, and will fail if any member is an " "incompatible type." msgstr "" -#: library/enum.rst:841 +#: library/enum.rst:878 msgid "" "A decorator similar to the built-in *property*, but specifically for " "enumerations. It allows member attributes to have the same names as members " "themselves." msgstr "" -#: library/enum.rst:845 +#: library/enum.rst:882 msgid "" "the *property* and the member must be defined in separate classes; for " "example, the *value* and *name* attributes are defined in the *Enum* class, " @@ -917,29 +950,29 @@ msgid "" "``name``." msgstr "" -#: library/enum.rst:854 +#: library/enum.rst:891 msgid "" "A :keyword:`class` decorator specifically for enumerations. It searches an " "enumeration's :attr:`~EnumType.__members__`, gathering any aliases it finds; " "if any are found :exc:`ValueError` is raised with the details::" msgstr "" -#: library/enum.rst:872 +#: library/enum.rst:909 msgid "" "A :keyword:`class` decorator specifically for enumerations. Members from :" "class:`EnumCheck` are used to specify which constraints should be checked on " "the decorated enumeration." msgstr "" -#: library/enum.rst:880 +#: library/enum.rst:917 msgid "A decorator for use in enums: its target will become a member." msgstr "" -#: library/enum.rst:886 +#: library/enum.rst:923 msgid "A decorator for use in enums: its target will not become a member." msgstr "" -#: library/enum.rst:892 +#: library/enum.rst:929 msgid "" "A decorator to change the :class:`str() ` and :func:`repr` of an enum " "to show its members as belonging to the module instead of its class. Should " @@ -947,40 +980,40 @@ msgid "" "namespace (see :class:`re.RegexFlag` for an example)." msgstr "" -#: library/enum.rst:902 +#: library/enum.rst:939 msgid "Return a list of all power-of-two integers contained in a flag *value*." msgstr "" -#: library/enum.rst:909 +#: library/enum.rst:946 msgid "Notes" msgstr "" -#: library/enum.rst:911 +#: library/enum.rst:948 msgid ":class:`IntEnum`, :class:`StrEnum`, and :class:`IntFlag`" msgstr "" -#: library/enum.rst:913 +#: library/enum.rst:950 msgid "" "These three enum types are designed to be drop-in replacements for existing " "integer- and string-based values; as such, they have extra limitations:" msgstr "" -#: library/enum.rst:916 +#: library/enum.rst:953 msgid "``__str__`` uses the value and not the name of the enum member" msgstr "" -#: library/enum.rst:918 +#: library/enum.rst:955 msgid "" "``__format__``, because it uses ``__str__``, will also use the value of the " "enum member instead of its name" msgstr "" -#: library/enum.rst:921 +#: library/enum.rst:958 msgid "" "If you do not need/want those limitations, you can either create your own " "base class by mixing in the ``int`` or ``str`` type yourself::" msgstr "" -#: library/enum.rst:928 +#: library/enum.rst:965 msgid "or you can reassign the appropriate :meth:`str`, etc., in your enum::" msgstr "" diff --git a/library/exceptions.po b/library/exceptions.po index 6a16d4368..03853d780 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -32,12 +32,12 @@ msgstr "" #: library/exceptions.rst:19 msgid "" -"The built-in exceptions listed below can be generated by the interpreter or " -"built-in functions. Except where mentioned, they have an \"associated " -"value\" indicating the detailed cause of the error. This may be a string or " -"a tuple of several items of information (e.g., an error code and a string " -"explaining the code). The associated value is usually passed as arguments " -"to the exception class's constructor." +"The built-in exceptions listed in this chapter can be generated by the " +"interpreter or built-in functions. Except where mentioned, they have an " +"\"associated value\" indicating the detailed cause of the error. This may " +"be a string or a tuple of several items of information (e.g., an error code " +"and a string explaining the code). The associated value is usually passed " +"as arguments to the exception class's constructor." msgstr "" #: library/exceptions.rst:26 diff --git a/library/fnmatch.po b/library/fnmatch.po index 5c0dc4232..13cee773d 100644 --- a/library/fnmatch.po +++ b/library/fnmatch.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -95,8 +95,8 @@ msgstr "" #: library/fnmatch.rst:55 msgid "" -"Test whether the *filename* string matches the *pattern* string, returning :" -"const:`True` or :const:`False`. Both parameters are case-normalized using :" +"Test whether the filename string *name* matches the pattern string *pat*, " +"returning ``True`` or ``False``. Both parameters are case-normalized using :" "func:`os.path.normcase`. :func:`fnmatchcase` can be used to perform a case-" "sensitive comparison, regardless of whether that's standard for the " "operating system." @@ -110,33 +110,33 @@ msgstr "" #: library/fnmatch.rst:74 msgid "" -"Test whether *filename* matches *pattern*, returning :const:`True` or :const:" -"`False`; the comparison is case-sensitive and does not apply :func:`os.path." -"normcase`." +"Test whether the filename string *name* matches the pattern string *pat*, " +"returning ``True`` or ``False``; the comparison is case-sensitive and does " +"not apply :func:`os.path.normcase`." msgstr "" #: library/fnmatch.rst:81 msgid "" -"Construct a list from those elements of the iterable *names* that match " -"*pattern*. It is the same as ``[n for n in names if fnmatch(n, pattern)]``, " -"but implemented more efficiently." +"Construct a list from those elements of the :term:`iterable` *names* that " +"match pattern *pat*. It is the same as ``[n for n in names if fnmatch(n, " +"pat)]``, but implemented more efficiently." msgstr "" -#: library/fnmatch.rst:87 +#: library/fnmatch.rst:89 msgid "" -"Return the shell-style *pattern* converted to a regular expression for using " -"with :func:`re.match`." +"Return the shell-style pattern *pat* converted to a regular expression for " +"using with :func:`re.match`." msgstr "" -#: library/fnmatch.rst:90 +#: library/fnmatch.rst:92 msgid "Example:" msgstr "" -#: library/fnmatch.rst:104 +#: library/fnmatch.rst:106 msgid "Module :mod:`glob`" msgstr "" -#: library/fnmatch.rst:105 +#: library/fnmatch.rst:107 msgid "Unix shell-style path expansion." msgstr "" diff --git a/library/ftplib.po b/library/ftplib.po index a6b45a7fe..d0daf62c0 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -53,212 +53,213 @@ msgstr "" msgid "Here's a sample session using the :mod:`ftplib` module::" msgstr "" -#: library/ftplib.rst:48 -msgid "The module defines the following items:" +#: library/ftplib.rst:51 +msgid "Reference" msgstr "" -#: library/ftplib.rst:52 -msgid "" -"Return a new instance of the :class:`FTP` class. When *host* is given, the " -"method call ``connect(host)`` is made. When *user* is given, additionally " -"the method call ``login(user, passwd, acct)`` is made (where *passwd* and " -"*acct* default to the empty string when not given). The optional *timeout* " -"parameter specifies a timeout in seconds for blocking operations like the " -"connection attempt (if is not specified, the global default timeout setting " -"will be used). *source_address* is a 2-tuple ``(host, port)`` for the socket " -"to bind to as its source address before connecting. The *encoding* parameter " -"specifies the encoding for directories and filenames." +#: library/ftplib.rst:56 +msgid "FTP objects" msgstr "" -#: library/ftplib.rst:62 -msgid "The :class:`FTP` class supports the :keyword:`with` statement, e.g.:" +#: library/ftplib.rst:87 +msgid "Return a new instance of the :class:`FTP` class." msgstr "" -#: library/ftplib.rst:76 -msgid "Support for the :keyword:`with` statement was added." +#: library/ftplib.rst:0 +msgid "Parameters" msgstr "" -#: library/ftplib.rst:102 library/ftplib.rst:207 -msgid "*source_address* parameter was added." +#: library/ftplib.rst:461 +msgid "" +"The hostname to connect to. If given, :code:`connect(host)` is implicitly " +"called by the constructor." msgstr "" -#: library/ftplib.rst:110 +#: library/ftplib.rst:465 msgid "" -"If the *timeout* parameter is set to be zero, it will raise a :class:" -"`ValueError` to prevent the creation of a non-blocking socket. The " -"*encoding* parameter was added, and the default was changed from Latin-1 to " -"UTF-8 to follow :rfc:`2640`." +"|param_doc_user| If given, :code:`login(host, passwd, acct)` is implicitly " +"called by the constructor." msgstr "" -#: library/ftplib.rst:91 -msgid "" -"A :class:`FTP` subclass which adds TLS support to FTP as described in :rfc:" -"`4217`. Connect as usual to port 21 implicitly securing the FTP control " -"connection before authenticating. Securing the data connection requires the " -"user to explicitly ask for it by calling the :meth:`prot_p` method. " -"*context* is a :class:`ssl.SSLContext` object which allows bundling SSL " -"configuration options, certificates and private keys into a single " -"(potentially long-lived) structure. Please read :ref:`ssl-security` for " -"best practices." +#: library/ftplib.rst:212 library/ftplib.rst:470 +msgid "|param_doc_passwd|" +msgstr "" + +#: library/ftplib.rst:215 library/ftplib.rst:473 +msgid "|param_doc_acct|" msgstr "" -#: library/ftplib.rst:105 +#: library/ftplib.rst:104 msgid "" -"The class now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"A timeout in seconds for blocking operations like :meth:`connect` (default: " +"the global default timeout setting)." +msgstr "" + +#: library/ftplib.rst:183 library/ftplib.rst:488 +msgid "|param_doc_source_address|" +msgstr "" + +#: library/ftplib.rst:492 +msgid "|param_doc_encoding|" msgstr "" #: library/ftplib.rst:116 -msgid "The deprecated *keyfile* and *certfile* parameters have been removed." +msgid "The :class:`FTP` class supports the :keyword:`with` statement, e.g.:" msgstr "" -#: library/ftplib.rst:119 -msgid "Here's a sample session using the :class:`FTP_TLS` class::" +#: library/ftplib.rst:130 +msgid "Support for the :keyword:`with` statement was added." msgstr "" -#: library/ftplib.rst:132 -msgid "Exception raised when an unexpected reply is received from the server." +#: library/ftplib.rst:189 +msgid "*source_address* parameter was added." msgstr "" -#: library/ftplib.rst:137 +#: library/ftplib.rst:505 msgid "" -"Exception raised when an error code signifying a temporary error (response " -"codes in the range 400--499) is received." +"If the *timeout* parameter is set to be zero, it will raise a :class:" +"`ValueError` to prevent the creation of a non-blocking socket. The " +"*encoding* parameter was added, and the default was changed from Latin-1 to " +"UTF-8 to follow :rfc:`2640`." msgstr "" -#: library/ftplib.rst:143 +#: library/ftplib.rst:142 msgid "" -"Exception raised when an error code signifying a permanent error (response " -"codes in the range 500--599) is received." +"Several :class:`!FTP` methods are available in two flavors: one for handling " +"text files and another for binary files. The methods are named for the " +"command which is used followed by ``lines`` for the text version or " +"``binary`` for the binary version." msgstr "" -#: library/ftplib.rst:149 -msgid "" -"Exception raised when a reply is received from the server that does not fit " -"the response specifications of the File Transfer Protocol, i.e. begin with a " -"digit in the range 1--5." +#: library/ftplib.rst:147 +msgid ":class:`FTP` instances have the following methods:" msgstr "" -#: library/ftplib.rst:156 +#: library/ftplib.rst:151 msgid "" -"The set of all exceptions (as a tuple) that methods of :class:`FTP` " -"instances may raise as a result of problems with the FTP connection (as " -"opposed to programming errors made by the caller). This set includes the " -"four exceptions listed above as well as :exc:`OSError` and :exc:`EOFError`." +"Set the instance's debugging level as an :class:`int`. This controls the " +"amount of debugging output printed. The debug levels are:" msgstr "" -#: library/ftplib.rst:166 -msgid "Module :mod:`netrc`" +#: library/ftplib.rst:155 +msgid "``0`` (default): No debug output." msgstr "" -#: library/ftplib.rst:165 +#: library/ftplib.rst:156 msgid "" -"Parser for the :file:`.netrc` file format. The file :file:`.netrc` is " -"typically used by FTP clients to load user authentication information before " -"prompting the user." +"``1``: Produce a moderate amount of debug output, generally a single line " +"per request." msgstr "" -#: library/ftplib.rst:173 -msgid "FTP Objects" +#: library/ftplib.rst:158 +msgid "" +"``2`` or higher: Produce the maximum amount of debugging output, logging " +"each line sent and received on the control connection." msgstr "" -#: library/ftplib.rst:175 +#: library/ftplib.rst:163 msgid "" -"Several methods are available in two flavors: one for handling text files " -"and another for binary files. These are named for the command which is used " -"followed by ``lines`` for the text version or ``binary`` for the binary " -"version." +"Connect to the given host and port. This function should be called only once " +"for each instance; it should not be called if a *host* argument was given " +"when the :class:`FTP` instance was created. All other :class:`!FTP` methods " +"can only be called after a connection has successfully been made." msgstr "" -#: library/ftplib.rst:179 -msgid ":class:`FTP` instances have the following methods:" +#: library/ftplib.rst:170 +msgid "The host to connect to." msgstr "" -#: library/ftplib.rst:184 +#: library/ftplib.rst:173 msgid "" -"Set the instance's debugging level. This controls the amount of debugging " -"output printed. The default, ``0``, produces no debugging output. A value " -"of ``1`` produces a moderate amount of debugging output, generally a single " -"line per request. A value of ``2`` or higher produces the maximum amount of " -"debugging output, logging each line sent and received on the control " -"connection." +"The TCP port to connect to (default: ``21``, as specified by the FTP " +"protocol specification). It is rarely needed to specify a different port " +"number." msgstr "" -#: library/ftplib.rst:193 +#: library/ftplib.rst:178 msgid "" -"Connect to the given host and port. The default port number is ``21``, as " -"specified by the FTP protocol specification. It is rarely needed to specify " -"a different port number. This function should be called only once for each " -"instance; it should not be called at all if a host was given when the " -"instance was created. All other methods can only be used after a connection " -"has been made. The optional *timeout* parameter specifies a timeout in " -"seconds for the connection attempt. If no *timeout* is passed, the global " -"default timeout setting will be used. *source_address* is a 2-tuple ``(host, " -"port)`` for the socket to bind to as its source address before connecting." +"A timeout in seconds for the connection attempt (default: the global default " +"timeout setting)." msgstr "" -#: library/ftplib.rst:214 +#: library/ftplib.rst:198 msgid "" "Raises an :ref:`auditing event ` ``ftplib.connect`` with arguments " "``self``, ``host``, ``port``." msgstr "" -#: library/ftplib.rst:213 +#: library/ftplib.rst:195 msgid "" "Return the welcome message sent by the server in reply to the initial " "connection. (This message sometimes contains disclaimers or help " "information that may be relevant to the user.)" msgstr "" -#: library/ftplib.rst:220 +#: library/ftplib.rst:202 msgid "" -"Log in as the given *user*. The *passwd* and *acct* parameters are optional " -"and default to the empty string. If no *user* is specified, it defaults to " -"``'anonymous'``. If *user* is ``'anonymous'``, the default *passwd* is " -"``'anonymous@'``. This function should be called only once for each " -"instance, after a connection has been established; it should not be called " -"at all if a host and user were given when the instance was created. Most " -"FTP commands are only allowed after the client has logged in. The *acct* " -"parameter supplies \"accounting information\"; few systems implement this." +"Log on to the connected FTP server. This function should be called only once " +"for each instance, after a connection has been established; it should not be " +"called if the *host* and *user* arguments were given when the :class:`FTP` " +"instance was created. Most FTP commands are only allowed after the client " +"has logged in." +msgstr "" + +#: library/ftplib.rst:209 +msgid "|param_doc_user|" msgstr "" -#: library/ftplib.rst:232 +#: library/ftplib.rst:221 msgid "" "Abort a file transfer that is in progress. Using this does not always work, " "but it's worth a try." msgstr "" -#: library/ftplib.rst:238 +#: library/ftplib.rst:227 msgid "" "Send a simple command string to the server and return the response string." msgstr "" -#: library/ftplib.rst:258 +#: library/ftplib.rst:249 msgid "" "Raises an :ref:`auditing event ` ``ftplib.sendcmd`` with arguments " "``self``, ``cmd``." msgstr "" -#: library/ftplib.rst:245 +#: library/ftplib.rst:234 msgid "" "Send a simple command string to the server and handle the response. Return " -"nothing if a response code corresponding to success (codes in the range " -"200--299) is received. Raise :exc:`error_reply` otherwise." +"the response string if the response code corresponds to success (codes in " +"the range 200--299). Raise :exc:`error_reply` otherwise." +msgstr "" + +#: library/ftplib.rst:243 +msgid "Retrieve a file in binary transfer mode." +msgstr "" + +#: library/ftplib.rst:289 +msgid "An appropriate ``STOR`` command: :samp:`\"STOR {filename}\"`." +msgstr "" + +#: library/ftplib.rst:248 +msgid "" +"A single parameter callable that is called for each block of data received, " +"with its single argument being the data as :class:`bytes`." msgstr "" #: library/ftplib.rst:254 msgid "" -"Retrieve a file in binary transfer mode. *cmd* should be an appropriate " -"``RETR`` command: ``'RETR filename'``. The *callback* function is called for " -"each block of data received, with a single bytes argument giving the data " -"block. The optional *blocksize* argument specifies the maximum chunk size to " -"read on the low-level socket object created to do the actual transfer (which " -"will also be the largest size of the data blocks passed to *callback*). A " -"reasonable default is chosen. *rest* means the same thing as in the :meth:" -"`transfercmd` method." +"The maximum chunk size to read on the low-level :class:`~socket.socket` " +"object created to do the actual transfer. This also corresponds to the " +"largest size of data that will be passed to *callback*. Defaults to ``8192``." msgstr "" -#: library/ftplib.rst:266 +#: library/ftplib.rst:308 +msgid "" +"A ``REST`` command to be sent to the server. See the documentation for the " +"*rest* parameter of the :meth:`transfercmd` method." +msgstr "" + +#: library/ftplib.rst:268 msgid "" "Retrieve a file or directory listing in the encoding specified by the " "*encoding* parameter at initialization. *cmd* should be an appropriate " @@ -267,31 +268,41 @@ msgid "" "files and information about those files. ``NLST`` retrieves a list of file " "names. The *callback* function is called for each line with a string " "argument containing the line with the trailing CRLF stripped. The default " -"*callback* prints the line to ``sys.stdout``." +"*callback* prints the line to :data:`sys.stdout`." msgstr "" -#: library/ftplib.rst:279 +#: library/ftplib.rst:281 msgid "" "Enable \"passive\" mode if *val* is true, otherwise disable passive mode. " "Passive mode is on by default." msgstr "" -#: library/ftplib.rst:285 +#: library/ftplib.rst:287 +msgid "Store a file in binary transfer mode." +msgstr "" + +#: library/ftplib.rst:292 +msgid "" +"A file object (opened in binary mode) which is read until EOF, using its :" +"meth:`~io.RawIOBase.read` method in blocks of size *blocksize* to provide " +"the data to be stored." +msgstr "" + +#: library/ftplib.rst:298 +msgid "The read block size. Defaults to ``8192``." +msgstr "" + +#: library/ftplib.rst:302 msgid "" -"Store a file in binary transfer mode. *cmd* should be an appropriate " -"``STOR`` command: ``\"STOR filename\"``. *fp* is a :term:`file object` " -"(opened in binary mode) which is read until EOF using its :meth:`~io.IOBase." -"read` method in blocks of size *blocksize* to provide the data to be stored. " -"The *blocksize* argument defaults to 8192. *callback* is an optional single " -"parameter callable that is called on each block of data after it is sent. " -"*rest* means the same thing as in the :meth:`transfercmd` method." +"A single parameter callable that is called for each block of data sent, with " +"its single argument being the data as :class:`bytes`." msgstr "" -#: library/ftplib.rst:293 -msgid "*rest* parameter added." +#: library/ftplib.rst:312 +msgid "The *rest* parameter was added." msgstr "" -#: library/ftplib.rst:299 +#: library/ftplib.rst:318 msgid "" "Store a file in line mode. *cmd* should be an appropriate ``STOR`` command " "(see :meth:`storbinary`). Lines are read until EOF from the :term:`file " @@ -300,7 +311,7 @@ msgid "" "parameter callable that is called on each line after it is sent." msgstr "" -#: library/ftplib.rst:308 +#: library/ftplib.rst:327 msgid "" "Initiate a transfer over the data connection. If the transfer is active, " "send an ``EPRT`` or ``PORT`` command and the transfer command specified by " @@ -309,7 +320,7 @@ msgid "" "command. Either way, return the socket for the connection." msgstr "" -#: library/ftplib.rst:314 +#: library/ftplib.rst:333 msgid "" "If optional *rest* is given, a ``REST`` command is sent to the server, " "passing *rest* as an argument. *rest* is usually a byte offset into the " @@ -322,7 +333,7 @@ msgid "" "simply call :meth:`transfercmd` without a *rest* argument." msgstr "" -#: library/ftplib.rst:327 +#: library/ftplib.rst:346 msgid "" "Like :meth:`transfercmd`, but returns a tuple of the data connection and the " "expected size of the data. If the expected size could not be computed, " @@ -330,7 +341,7 @@ msgid "" "same thing as in :meth:`transfercmd`." msgstr "" -#: library/ftplib.rst:335 +#: library/ftplib.rst:354 msgid "" "List a directory in a standardized format by using ``MLSD`` command (:rfc:" "`3659`). If *path* is omitted the current directory is assumed. *facts* is " @@ -342,7 +353,7 @@ msgid "" "but server is not guaranteed to return all requested facts." msgstr "" -#: library/ftplib.rst:349 +#: library/ftplib.rst:368 msgid "" "Return a list of file names as returned by the ``NLST`` command. The " "optional *argument* is a directory to list (default is the current server " @@ -350,48 +361,48 @@ msgid "" "the ``NLST`` command." msgstr "" -#: library/ftplib.rst:366 +#: library/ftplib.rst:385 msgid "If your server supports the command, :meth:`mlsd` offers a better API." msgstr "" -#: library/ftplib.rst:359 +#: library/ftplib.rst:378 msgid "" "Produce a directory listing as returned by the ``LIST`` command, printing it " "to standard output. The optional *argument* is a directory to list (default " "is the current server directory). Multiple arguments can be used to pass " "non-standard options to the ``LIST`` command. If the last argument is a " "function, it is used as a *callback* function as for :meth:`retrlines`; the " -"default prints to ``sys.stdout``. This method returns ``None``." +"default prints to :data:`sys.stdout`. This method returns ``None``." msgstr "" -#: library/ftplib.rst:371 +#: library/ftplib.rst:390 msgid "Rename file *fromname* on the server to *toname*." msgstr "" -#: library/ftplib.rst:376 +#: library/ftplib.rst:395 msgid "" "Remove the file named *filename* from the server. If successful, returns " "the text of the response, otherwise raises :exc:`error_perm` on permission " "errors or :exc:`error_reply` on other errors." msgstr "" -#: library/ftplib.rst:383 +#: library/ftplib.rst:402 msgid "Set the current directory on the server." msgstr "" -#: library/ftplib.rst:388 +#: library/ftplib.rst:407 msgid "Create a new directory on the server." msgstr "" -#: library/ftplib.rst:393 +#: library/ftplib.rst:412 msgid "Return the pathname of the current directory on the server." msgstr "" -#: library/ftplib.rst:398 +#: library/ftplib.rst:417 msgid "Remove the directory named *dirname* on the server." msgstr "" -#: library/ftplib.rst:403 +#: library/ftplib.rst:422 msgid "" "Request the size of the file named *filename* on the server. On success, " "the size of the file is returned as an integer, otherwise ``None`` is " @@ -399,7 +410,7 @@ msgid "" "supported by many common server implementations." msgstr "" -#: library/ftplib.rst:411 +#: library/ftplib.rst:430 msgid "" "Send a ``QUIT`` command to the server and close the connection. This is the " "\"polite\" way to close a connection, but it may raise an exception if the " @@ -408,7 +419,7 @@ msgid "" "for subsequent calls (see below)." msgstr "" -#: library/ftplib.rst:420 +#: library/ftplib.rst:439 msgid "" "Close the connection unilaterally. This should not be applied to an already " "closed connection such as after a successful call to :meth:`~FTP.quit`. " @@ -417,47 +428,137 @@ msgid "" "connection by issuing another :meth:`login` method)." msgstr "" -#: library/ftplib.rst:428 -msgid "FTP_TLS Objects" +#: library/ftplib.rst:447 +msgid "FTP_TLS objects" msgstr "" -#: library/ftplib.rst:430 +#: library/ftplib.rst:452 +msgid "" +"An :class:`FTP` subclass which adds TLS support to FTP as described in :rfc:" +"`4217`. Connect to port 21 implicitly securing the FTP control connection " +"before authenticating." +msgstr "" + +#: library/ftplib.rst:458 msgid "" -":class:`FTP_TLS` class inherits from :class:`FTP`, defining these additional " -"objects:" +"The user must explicitly secure the data connection by calling the :meth:" +"`prot_p` method." +msgstr "" + +#: library/ftplib.rst:476 +msgid "" +"An SSL context object which allows bundling SSL configuration options, " +"certificates and private keys into a single, potentially long-lived, " +"structure. Please read :ref:`ssl-security` for best practices." +msgstr "" + +#: library/ftplib.rst:483 +msgid "" +"A timeout in seconds for blocking operations like :meth:`~FTP.connect` " +"(default: the global default timeout setting)." +msgstr "" + +#: library/ftplib.rst:497 +msgid "Added the *source_address* parameter." msgstr "" -#: library/ftplib.rst:434 +#: library/ftplib.rst:500 +msgid "" +"The class now supports hostname check with :attr:`ssl.SSLContext." +"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +msgstr "" + +#: library/ftplib.rst:511 +msgid "The deprecated *keyfile* and *certfile* parameters have been removed." +msgstr "" + +#: library/ftplib.rst:514 +msgid "Here's a sample session using the :class:`FTP_TLS` class::" +msgstr "" + +#: library/ftplib.rst:524 +msgid "" +":class:`!FTP_TLS` class inherits from :class:`FTP`, defining these " +"additional methods and attributes:" +msgstr "" + +#: library/ftplib.rst:529 msgid "The SSL version to use (defaults to :data:`ssl.PROTOCOL_SSLv23`)." msgstr "" -#: library/ftplib.rst:438 +#: library/ftplib.rst:533 msgid "" "Set up a secure control connection by using TLS or SSL, depending on what is " "specified in the :attr:`ssl_version` attribute." msgstr "" -#: library/ftplib.rst:441 +#: library/ftplib.rst:536 msgid "" "The method now supports hostname check with :attr:`ssl.SSLContext." "check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." msgstr "" -#: library/ftplib.rst:448 +#: library/ftplib.rst:543 msgid "" "Revert control channel back to plaintext. This can be useful to take " "advantage of firewalls that know how to handle NAT with non-secure FTP " "without opening fixed ports." msgstr "" -#: library/ftplib.rst:456 +#: library/ftplib.rst:551 msgid "Set up secure data connection." msgstr "" -#: library/ftplib.rst:460 +#: library/ftplib.rst:555 msgid "Set up clear text data connection." msgstr "" +#: library/ftplib.rst:559 +msgid "Module variables" +msgstr "" + +#: library/ftplib.rst:563 +msgid "Exception raised when an unexpected reply is received from the server." +msgstr "" + +#: library/ftplib.rst:568 +msgid "" +"Exception raised when an error code signifying a temporary error (response " +"codes in the range 400--499) is received." +msgstr "" + +#: library/ftplib.rst:574 +msgid "" +"Exception raised when an error code signifying a permanent error (response " +"codes in the range 500--599) is received." +msgstr "" + +#: library/ftplib.rst:580 +msgid "" +"Exception raised when a reply is received from the server that does not fit " +"the response specifications of the File Transfer Protocol, i.e. begin with a " +"digit in the range 1--5." +msgstr "" + +#: library/ftplib.rst:587 +msgid "" +"The set of all exceptions (as a tuple) that methods of :class:`FTP` " +"instances may raise as a result of problems with the FTP connection (as " +"opposed to programming errors made by the caller). This set includes the " +"four exceptions listed above as well as :exc:`OSError` and :exc:`EOFError`." +msgstr "" + +#: library/ftplib.rst:597 +msgid "Module :mod:`netrc`" +msgstr "" + +#: library/ftplib.rst:596 +msgid "" +"Parser for the :file:`.netrc` file format. The file :file:`.netrc` is " +"typically used by FTP clients to load user authentication information before " +"prompting the user." +msgstr "" + #: library/ftplib.rst:9 msgid "FTP" msgstr "" diff --git a/library/functions.po b/library/functions.po index 70571dfa6..8f955dd1a 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: 2023-03-08 10:13-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -496,7 +496,7 @@ msgstr "" "Eğer ön ek olarak \"0b\" isteniyorsa veya istenmiyorsa, aşağıdaki gibi iki " "şekilde de kullanabilirsiniz." -#: library/functions.rst:846 library/functions.rst:1164 +#: library/functions.rst:845 library/functions.rst:1163 msgid "See also :func:`format` for more information." msgstr "Ayrıca daha fazla bilgi için :func:`format` 'a bakabilirsiniz." @@ -517,7 +517,7 @@ msgstr "" "sınıfıdır (bkz. :ref:`typesnumeric`). Daha fazla alt sınıfa ayrılamaz. Bunun " "tek örnekleri ``False`` ve ``True`` 'dur (bkz. :ref:`bltin-boolean-values`)." -#: library/functions.rst:711 library/functions.rst:935 +#: library/functions.rst:710 library/functions.rst:934 msgid "*x* is now a positional-only parameter." msgstr "*x* artık yalnızca konumsal bir parametredir." @@ -989,7 +989,7 @@ msgstr "" msgid "The complex type is described in :ref:`typesnumeric`." msgstr "Karmaşık tür, :ref:`typesnumeric` kısmında açıklanmıştır." -#: library/functions.rst:708 library/functions.rst:932 +#: library/functions.rst:707 library/functions.rst:931 msgid "Grouping digits with underscores as in code literals is allowed." msgstr "" "Rakamların, kod sabitlerinde olduğu gibi alt çizgi ile gruplandırılmasına " @@ -1422,19 +1422,18 @@ msgstr "" "baştaki ve sondaki boşluk karakterleri kaldırıldıktan sonra veri girişi " "aşağıdaki dilbilgisindeki ``floatvalue`` üretim kuralına uygun olmalıdır:" -#: library/functions.rst:677 +#: library/functions.rst:678 +#, fuzzy msgid "" -"Here ``digit`` is a Unicode decimal digit (character in the Unicode general " -"category ``Nd``). Case is not significant, so, for example, \"inf\", " -"\"Inf\", \"INFINITY\", and \"iNfINity\" are all acceptable spellings for " -"positive infinity." +"Case is not significant, so, for example, \"inf\", \"Inf\", \"INFINITY\", " +"and \"iNfINity\" are all acceptable spellings for positive infinity." msgstr "" "Burada ``digit`` bir Unicode ondalık basamağıdır (Unicode genel kategorisi " "``Nd`` 'deki karakter). Büyük/küçük harf önemli değildir, bu nedenle, " "örneğin, \"inf\", \"Inf\", \"INFINITY\" ve \"iNfINity\" pozitif sonsuzluk " "için kabul edilebilir yazımlardır." -#: library/functions.rst:682 +#: library/functions.rst:681 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 " @@ -1445,7 +1444,7 @@ msgstr "" "sayı döndürülür. Eğer argüman Python reel sayı aralığının dışındaysa, :exc:" "`OverflowError` hatası ortaya çıkar." -#: library/functions.rst:687 +#: library/functions.rst:686 #, fuzzy msgid "" "For a general Python object ``x``, ``float(x)`` delegates to ``x." @@ -1456,19 +1455,19 @@ msgstr "" "fonksiyonuna delege eder. Eğer ``__float__()`` tanımlanmamışsa, :meth:" "`__index__` 'e geri döner." -#: library/functions.rst:691 +#: library/functions.rst:690 msgid "If no argument is given, ``0.0`` is returned." msgstr "Argüman verilmediyse, ``0.0`` döndürülür." -#: library/functions.rst:693 +#: library/functions.rst:692 msgid "Examples::" msgstr "Örnekler::" -#: library/functions.rst:706 +#: library/functions.rst:705 msgid "The float type is described in :ref:`typesnumeric`." msgstr "Float tipi :ref:`typesnumeric` kısmında açıklandı." -#: library/functions.rst:714 +#: library/functions.rst:713 #, fuzzy msgid "" "Falls back to :meth:`~object.__index__` if :meth:`~object.__float__` is not " @@ -1476,7 +1475,7 @@ msgid "" msgstr "" ":meth:`__float__` tanımlanmadıysa, :meth:`__index__` konumuna geri döner." -#: library/functions.rst:724 +#: library/functions.rst:723 msgid "" "Convert a *value* to a \"formatted\" representation, as controlled by " "*format_spec*. The interpretation of *format_spec* will depend on the type " @@ -1489,7 +1488,7 @@ msgstr "" "tiplerde kullanılan :ref:`formatspec` adında bir standart biçimlendirme " "sözdizimi var." -#: library/functions.rst:729 +#: library/functions.rst:728 msgid "" "The default *format_spec* is an empty string which usually gives the same " "effect as calling :func:`str(value) `." @@ -1497,7 +1496,7 @@ msgstr "" "Varsayılan *format_spec*, :func:`str(value) ` fonksiyonunu çağırmakla " "aynı etkiyi gösteren boş bir dizedir." -#: library/functions.rst:732 +#: library/functions.rst:731 #, fuzzy msgid "" "A call to ``format(value, format_spec)`` is translated to ``type(value)." @@ -1513,7 +1512,7 @@ msgstr "" "*format_spec* boş değilse, veya *format_spec* veya döndürülen değer dize " "değilse, :exc:`TypeError` hatası ortaya çıkar." -#: library/functions.rst:739 +#: library/functions.rst:738 msgid "" "``object().__format__(format_spec)`` raises :exc:`TypeError` if " "*format_spec* is not an empty string." @@ -1521,7 +1520,7 @@ msgstr "" "*format_spec* boş bir dize değilse, ``object().__format__(format_spec)``, :" "exc:`TypeError` hatasını ortaya çıkartır." -#: library/functions.rst:748 +#: library/functions.rst:747 msgid "" "Return a new :class:`frozenset` object, optionally with elements taken from " "*iterable*. ``frozenset`` is a built-in class. See :class:`frozenset` and :" @@ -1532,7 +1531,7 @@ msgstr "" "hakkında dokümantasyona ulaşmak için :class:`frozenset` ve :ref:`types-set` " "'e bakınız." -#: library/functions.rst:752 +#: library/functions.rst:751 msgid "" "For other containers see the built-in :class:`set`, :class:`list`, :class:" "`tuple`, and :class:`dict` classes, as well as the :mod:`collections` module." @@ -1541,7 +1540,7 @@ msgstr "" "`tuple`, ve :class:`dict` sınıflarına, ayrıca :mod:`collections` modülüne " "bakabilirsiniz." -#: library/functions.rst:760 +#: library/functions.rst:759 msgid "" "Return the value of the named attribute of *object*. *name* must be a " "string. If the string is the name of one of the object's attributes, the " @@ -1558,7 +1557,7 @@ msgstr "" "ortaya çıkar. *name* bir Python tanımlayıcısı olmak zorunda değildir (:func:" "`setattr` bkz)." -#: library/functions.rst:769 +#: library/functions.rst:768 msgid "" "Since :ref:`private name mangling ` happens at " "compilation time, one must manually mangle a private attribute's (attributes " @@ -1569,7 +1568,7 @@ msgstr "" "gerçekleştiğinden dolayı, :func:`getattr` ile almak için özel bir niteliğin " "(baştaki iki alt çizgili nitelikler) adını manuel olarak değiştirmek gerekir." -#: library/functions.rst:777 +#: library/functions.rst:776 msgid "" "Return the dictionary implementing the current module namespace. For code " "within functions, this is set when the function is defined and remains the " @@ -1579,7 +1578,7 @@ msgstr "" "için, bu fonksiyon tanımlandığında ayarlanır ve fonksiyonun çağrıldığı " "yerden bağımsız olarak aynı kalır." -#: library/functions.rst:784 +#: library/functions.rst:783 msgid "" "The arguments are an object and a string. The result is ``True`` if the " "string is the name of one of the object's attributes, ``False`` if not. " @@ -1591,7 +1590,7 @@ msgstr "" "'i çağırarak uygulanır ve :exc:`AttributeError` hatası oluşup oluşmayacağı " "görülür.)" -#: library/functions.rst:792 +#: library/functions.rst:791 msgid "" "Return the hash value of the object (if it has one). Hash values are " "integers. They are used to quickly compare dictionary keys during a " @@ -1604,7 +1603,7 @@ msgstr "" "değerler aynı karma değere sahiptir (1 ve 1.0 durumunda olduğu gibi farklı " "veri tiplerinde olsalar bile)." -#: library/functions.rst:799 +#: library/functions.rst:798 #, fuzzy msgid "" "For objects with custom :meth:`~object.__hash__` methods, note that :func:" @@ -1614,7 +1613,7 @@ msgstr "" "makinenin bit genişliğine göre döndürdüğü değeri kestiğini unutmayın. " "Detaylar için :meth:`__hash__` 'e bakınız." -#: library/functions.rst:806 +#: library/functions.rst:805 msgid "" "Invoke the built-in help system. (This function is intended for interactive " "use.) If no argument is given, the interactive help system starts on the " @@ -1630,7 +1629,7 @@ msgstr "" "dizeye bakılır ve bir yardım sayfası konsola bastırılır. Eğer argüman başka " "tipte bir nesne ise, nesne üzerinde bir yardım sayfası oluşturulur." -#: library/functions.rst:813 +#: library/functions.rst:812 msgid "" "Note that if a slash(/) appears in the parameter list of a function when " "invoking :func:`help`, it means that the parameters prior to the slash are " @@ -1643,13 +1642,13 @@ msgstr "" "konumsalparametrelerle ilgili SSS girişi ` " "'ne bakınız." -#: library/functions.rst:818 +#: library/functions.rst:817 msgid "" "This function is added to the built-in namespace by the :mod:`site` module." msgstr "" "Bu fonksiyon :mod:`site` modülü tarafından yerleşik ad alanına eklenir." -#: library/functions.rst:820 +#: library/functions.rst:819 msgid "" "Changes to :mod:`pydoc` and :mod:`inspect` mean that the reported signatures " "for callables are now more comprehensive and consistent." @@ -1658,7 +1657,7 @@ msgstr "" "için rapor edilen damgaların artık daha kapsamlı ve tutarlı olduğunu ifade " "eder." -#: library/functions.rst:827 +#: library/functions.rst:826 #, fuzzy msgid "" "Convert an integer number to a lowercase hexadecimal string prefixed with " @@ -1669,7 +1668,7 @@ msgstr "" "dizeye dönüştürür. Eğer *x* Python :class:`int` nesnesi değilse, tam sayı " "döndüren bir :meth:`__index__` metoduna sahip olmalidir. Bazı örnekler:" -#: library/functions.rst:836 +#: library/functions.rst:835 msgid "" "If you want to convert an integer number to an uppercase or lower " "hexadecimal string with prefix or not, you can use either of the following " @@ -1678,7 +1677,7 @@ msgstr "" "Eğer bir tam sayıyı büyük harf-küçük harf, önekli-öneksiz bir onaltılık " "sayıya dönüştürmek istiyorsanız, aşağıdaki yolları kullanabilirsiniz:" -#: library/functions.rst:848 +#: library/functions.rst:847 msgid "" "See also :func:`int` for converting a hexadecimal string to an integer using " "a base of 16." @@ -1686,7 +1685,7 @@ msgstr "" "Ayrıca onaltılık bir dizgiyi 16 tabanını kullanarak bir tam sayıya " "dönüştürmek için :func:`int` 'e bakınız." -#: library/functions.rst:853 +#: library/functions.rst:852 msgid "" "To obtain a hexadecimal string representation for a float, use the :meth:" "`float.hex` method." @@ -1694,7 +1693,7 @@ msgstr "" "Bir gerçel sayıdan onaltılık bir dize gösterimi elde etmek için :meth:`float." "hex` metodunu kullanın." -#: library/functions.rst:859 +#: library/functions.rst:858 msgid "" "Return the \"identity\" of an object. This is an integer which is " "guaranteed to be unique and constant for this object during its lifetime. " @@ -1705,11 +1704,11 @@ msgstr "" "sabit olduğu garanti edilen bir tam sayıdır. Ömürleri örtüşmeyen iki nesne " "aynı :func:`id` değerine sahip olabilir." -#: library/functions.rst:864 +#: library/functions.rst:863 msgid "This is the address of the object in memory." msgstr "Bu, bellekteki nesnenin adresidir." -#: library/functions.rst:866 +#: library/functions.rst:865 msgid "" "Raises an :ref:`auditing event ` ``builtins.id`` with argument " "``id``." @@ -1717,7 +1716,7 @@ msgstr "" "``id`` argümanıyla beraber bir :ref:`denetleme olayı ` ``builtins." "id`` ortaya çıkartır." -#: library/functions.rst:872 +#: library/functions.rst:871 msgid "" "If the *prompt* argument is present, it is written to standard output " "without a trailing newline. The function then reads a line from input, " @@ -1729,7 +1728,7 @@ msgstr "" "bir dizeye çevirip (sondaki yeni satırı çıkartır) döndürür. EOF " "okunduğunda, :exc:`EOFError` istisnası ortaya çıkar. Örnek::" -#: library/functions.rst:882 +#: library/functions.rst:881 msgid "" "If the :mod:`readline` module was loaded, then :func:`input` will use it to " "provide elaborate line editing and history features." @@ -1737,7 +1736,7 @@ msgstr "" "Eğer :mod:`readline` modülü yüklendiyse, :func:`input` ayrıntılı satır " "düzenleme ve geçmiş özellikleri sağlamak için onu kullanacaktır." -#: library/functions.rst:885 +#: library/functions.rst:884 msgid "" "Raises an :ref:`auditing event ` ``builtins.input`` with argument " "``prompt``." @@ -1745,7 +1744,7 @@ msgstr "" "``prompt`` argümanıyla birlikte bir :ref:`denetleme olayı ` " "``builtins.input`` ortaya çıkartır." -#: library/functions.rst:887 +#: library/functions.rst:886 msgid "" "Raises an :ref:`auditing event ` ``builtins.input`` with argument " "``prompt`` before reading input" @@ -1753,7 +1752,7 @@ msgstr "" "Girişi okumadan önce, ``prompt`` argümanıyla birlikte bir :ref:`denetleme " "olayı ` ``builtins.input`` ortaya çıkartır" -#: library/functions.rst:890 +#: library/functions.rst:889 msgid "" "Raises an :ref:`auditing event ` ``builtins.input/result`` with " "argument ``result``." @@ -1761,7 +1760,7 @@ msgstr "" "``result`` argümanıyla birlikte bir :ref:`denetleme olayı ` " "``builtins.input/result`` ortaya çıkartır." -#: library/functions.rst:892 +#: library/functions.rst:891 msgid "" "Raises an :ref:`auditing event ` ``builtins.input/result`` with " "the result after successfully reading input." @@ -1769,7 +1768,7 @@ msgstr "" "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:899 +#: library/functions.rst:898 #, fuzzy msgid "" "Return an integer object constructed from a number or string *x*, or return " @@ -1785,7 +1784,7 @@ msgstr "" "__index__()`` 'i döndürür. *x* :meth:`__trunc__` 'ı içeriyorsa, ``x." "__trunc__()`` 'ı döndürür. Gerçel sayılar için, sayı tam sayıya çevrilir." -#: library/functions.rst:906 +#: library/functions.rst:905 msgid "" "If *x* is not a number or if *base* is given, then *x* must be a string, :" "class:`bytes`, or :class:`bytearray` instance representing an integer in " @@ -1800,7 +1799,7 @@ msgstr "" "çevrelenebilir ve rakamlar arasına serpiştirilmiş tek alt çizgilere sahip " "olabilir." -#: library/functions.rst:912 +#: library/functions.rst:911 msgid "" "A base-n integer string contains digits, each representing a value from 0 to " "n-1. The values 0--9 can be represented by any Unicode decimal digit. The " @@ -1825,11 +1824,11 @@ msgstr "" "baştaki sıfırlara da izin vermez: ``int('010', 0)`` yasal değilken, " "``int('010')`` ve ``int('010', 8)`` yasaldır." -#: library/functions.rst:923 +#: library/functions.rst:922 msgid "The integer type is described in :ref:`typesnumeric`." msgstr "Tam sayı tipi :ref:`typesnumeric` kısmında açıklandı." -#: library/functions.rst:925 +#: library/functions.rst:924 msgid "" "If *base* is not an instance of :class:`int` and the *base* object has a :" "meth:`base.__index__ ` method, that method is called to " @@ -1841,19 +1840,19 @@ msgstr "" "tamsayı elde etmek için çağrılır. Önceki sürümler :meth:`base.__index__ " "` yerine :meth:`base.__int__ ` 'i kullandı." -#: library/functions.rst:938 +#: library/functions.rst:937 #, fuzzy msgid "" "Falls back to :meth:`~object.__index__` if :meth:`~object.__int__` is not " "defined." msgstr ":meth:`__int__` tanımlı değilse :meth:`__index__` konumuna geri döner." -#: library/functions.rst:941 +#: library/functions.rst:940 #, fuzzy msgid "The delegation to :meth:`~object.__trunc__` is deprecated." msgstr ":meth:`__trunc__` yetkisi kullanımdan kaldırıldı." -#: library/functions.rst:944 +#: library/functions.rst:943 msgid "" ":class:`int` string inputs and string representations can be limited to help " "avoid denial of service attacks. A :exc:`ValueError` is raised when the " @@ -1869,7 +1868,7 @@ msgstr "" "ortaya çıkar. :ref:`tam sayı dönüştürme uzunluk sınırlaması " "` dokümanına bakın." -#: library/functions.rst:954 +#: library/functions.rst:953 msgid "" "Return ``True`` if the *object* argument is an instance of the *classinfo* " "argument, or of a (direct, indirect, or :term:`virtual `) of *classinfo*. A class is considered a " @@ -1913,7 +1912,7 @@ msgstr "" "birinin alt sınıfıysa ``True`` döndürülür. Diğer her durumda, :exc:" "`TypeError` hatası ortaya çıkar." -#: library/functions.rst:986 +#: library/functions.rst:985 #, fuzzy msgid "" "Return an :term:`iterator` object. The first argument is interpreted very " @@ -1941,11 +1940,11 @@ msgstr "" "döndürülen değer *sentinel* 'e eşitse, :exc:`StopIteration` hatası ortaya " "çıkar, aksi takdirde değer döndürülür." -#: library/functions.rst:1000 +#: library/functions.rst:999 msgid "See also :ref:`typeiter`." msgstr "Ayrıca :ref:`typeiter` bkz." -#: library/functions.rst:1002 +#: library/functions.rst:1001 msgid "" "One useful application of the second form of :func:`iter` is to build a " "block-reader. For example, reading fixed-width blocks from a binary database " @@ -1955,7 +1954,7 @@ msgstr "" "okuyucu inşaa etmektir. Örnek olarak, dosyanın sonuna ulaşılana kadar ikili " "bir veritabanı dosyasından sabit genişlikte bloklar okunurken::" -#: library/functions.rst:1014 +#: library/functions.rst:1013 msgid "" "Return the length (the number of items) of an object. The argument may be a " "sequence (such as a string, bytes, tuple, list, or range) or a collection " @@ -1965,7 +1964,7 @@ msgstr "" "(örneğin dize, bytes, demet, liste veya aralık) veya bir koleksiyon (örneğin " "sözlük, küme veya dondurulmuş küme) olabilir." -#: library/functions.rst:1020 +#: library/functions.rst:1019 msgid "" "``len`` raises :exc:`OverflowError` on lengths larger than :data:`sys." "maxsize`, such as :class:`range(2 ** 100) `." @@ -1973,7 +1972,7 @@ msgstr "" "``len``, :class:`range(2 ** 100) ` gibi :data:`sys.maxsize` 'dan daha " "geniş uzunluklar için :exc:`OverflowError` hatası ortaya çıkartır." -#: library/functions.rst:1029 +#: library/functions.rst:1028 msgid "" "Rather than being a function, :class:`list` is actually a mutable sequence " "type, as documented in :ref:`typesseq-list` and :ref:`typesseq`." @@ -1981,7 +1980,7 @@ msgstr "" "Bir fonksiyon görevi görmektense, :ref:`typesseq-list` ve :ref:`typesseq` de " "anlatıldığı gibi :class:`list` bir değiştirebilir dizi çeşididir." -#: library/functions.rst:1035 +#: library/functions.rst:1034 msgid "" "Update and return a dictionary representing the current local symbol table. " "Free variables are returned by :func:`locals` when it is called in function " @@ -1994,7 +1993,7 @@ msgstr "" "Unutmayın ki modül seviyesinde, :func:`locals` ve :func:`globals` aynı " "sözlüklerdir." -#: library/functions.rst:1041 +#: library/functions.rst:1040 msgid "" "The contents of this dictionary should not be modified; changes may not " "affect the values of local and free variables used by the interpreter." @@ -2003,7 +2002,7 @@ msgstr "" "tarafından kullanılan yerel ve serbest değişkenlerin değerlerini " "etkilemeyebilir." -#: library/functions.rst:1046 +#: library/functions.rst:1045 msgid "" "Return an iterator that applies *function* to every item of *iterable*, " "yielding the results. If additional *iterables* arguments are passed, " @@ -2020,7 +2019,7 @@ msgstr "" "girdilerinin zaten demetler halinde verildiği durumlar için, :func:" "`itertools.starmap`\\ 'a bakın." -#: library/functions.rst:1058 +#: library/functions.rst:1057 msgid "" "Return the largest item in an iterable or the largest of two or more " "arguments." @@ -2028,7 +2027,7 @@ msgstr "" "Bir yineleyicinin veya birden fazla parametrenin en büyük elementini " "döndürür." -#: library/functions.rst:1061 +#: library/functions.rst:1060 msgid "" "If one positional argument is provided, it should be an :term:`iterable`. " "The largest item in the iterable is returned. If two or more positional " @@ -2039,7 +2038,7 @@ msgstr "" "pozisyonel parametre sağlandıysa, pozisyonel parametrelerin en büyüğü " "döndürülür." -#: library/functions.rst:1104 +#: library/functions.rst:1103 msgid "" "There are two optional keyword-only arguments. The *key* argument specifies " "a one-argument ordering function like that used for :meth:`list.sort`. The " @@ -2053,7 +2052,7 @@ msgstr "" "döndürülecek nesneyi belirtir. Eğer yineleyici boş ve *varsayılan* " "verilmemiş ise, :exc:`ValueError` hatası ortaya çıkar." -#: library/functions.rst:1072 +#: library/functions.rst:1071 msgid "" "If multiple items are maximal, the function returns the first one " "encountered. This is consistent with other sort-stability preserving tools " @@ -2065,15 +2064,16 @@ msgstr "" "iterable, key=keyfunc)`` gibi sıralama kararlılığı muhafaza eden araçlar ile " "uygundur." -#: library/functions.rst:1115 -msgid "The *default* keyword-only argument." +#: library/functions.rst:1114 +#, fuzzy +msgid "Added the *default* keyword-only parameter." msgstr "*varsayılan* yalnızca anahtar kelime parametresi." -#: library/functions.rst:1118 +#: library/functions.rst:1117 msgid "The *key* can be ``None``." msgstr "*key* ``None`` olabilir." -#: library/functions.rst:1088 +#: library/functions.rst:1087 msgid "" "Return a \"memory view\" object created from the given argument. See :ref:" "`typememoryview` for more information." @@ -2081,7 +2081,7 @@ msgstr "" "Verilen argümandan oluşturulan bir \"memory view\" objesi döndürür. Daha " "fazla bilgi için :ref:`typememoryview` bkz." -#: library/functions.rst:1096 +#: library/functions.rst:1095 msgid "" "Return the smallest item in an iterable or the smallest of two or more " "arguments." @@ -2089,7 +2089,7 @@ msgstr "" "Bir yineleyicideki en küçük elementi veya birden fazla argümandan en " "küçüğünü döndürür." -#: library/functions.rst:1099 +#: library/functions.rst:1098 msgid "" "If one positional argument is provided, it should be an :term:`iterable`. " "The smallest item in the iterable is returned. If two or more positional " @@ -2099,7 +2099,7 @@ msgstr "" "Yineleyicinin en küçük elementi döndürülür. Eğer birden fazla argüman " "sağlandıysa, argümanların en küçüğü döndürülür." -#: library/functions.rst:1110 +#: library/functions.rst:1109 msgid "" "If multiple items are minimal, the function returns the first one " "encountered. This is consistent with other sort-stability preserving tools " @@ -2111,7 +2111,7 @@ msgstr "" "key=keyfunc)`` gibi diğer sıralama kararlılığını koruma araçlarıyla tutarlı " "çalışır." -#: library/functions.rst:1125 +#: library/functions.rst:1124 msgid "" "Retrieve the next item from the :term:`iterator` by calling its :meth:" "`~iterator.__next__` method. If *default* is given, it is returned if the " @@ -2121,7 +2121,7 @@ msgstr "" "elementi getirir. Eğer *default* verildiyse ve yineleyici tükenmiş ise " "*default* döndürülür, aksi takdirde :exc:`StopIteration` hatası ortaya çıkar." -#: library/functions.rst:1132 +#: library/functions.rst:1131 msgid "" "Return a new featureless object. :class:`object` is a base for all classes. " "It has methods that are common to all instances of Python classes. This " @@ -2131,7 +2131,7 @@ msgstr "" "temeldir. Tüm Python sınıflarında bulunan genel metotları içerir. Bu " "fonksiyon hiçbir argüman kabul etmez." -#: library/functions.rst:1138 +#: library/functions.rst:1137 msgid "" ":class:`object` does *not* have a :attr:`~object.__dict__`, so you can't " "assign arbitrary attributes to an instance of the :class:`object` class." @@ -2139,7 +2139,7 @@ msgstr "" ":class:`object`, :attr:`~object.__dict__` özelliğine sahip *değildir*, yani " "bir :class:`object` örneğine keyfi özellikler atayamazsınız." -#: library/functions.rst:1144 +#: library/functions.rst:1143 #, fuzzy msgid "" "Convert an integer number to an octal string prefixed with \"0o\". The " @@ -2151,7 +2151,7 @@ msgstr "" "Python ifadesidir. Eğer *x* bir Python :class:`int` nesnesi değilse, tamsayı " "döndüren bir :meth:`__index__` metoduna sahip olmalıdır. Örnek olarak:" -#: library/functions.rst:1154 +#: library/functions.rst:1153 msgid "" "If you want to convert an integer number to an octal string either with the " "prefix \"0o\" or not, you can use either of the following ways." @@ -2159,7 +2159,7 @@ msgstr "" "Eğer bir tamsayıyı \"0o\" ön ekiyle veya ön eksiz oktal bir dizeye " "dönüştürmek istiyorsanız, aşağıdaki yolları kullanabilirsiniz." -#: library/functions.rst:1171 +#: library/functions.rst:1170 msgid "" "Open *file* and return a corresponding :term:`file object`. If the file " "cannot be opened, an :exc:`OSError` is raised. See :ref:`tut-files` for more " @@ -2169,7 +2169,7 @@ msgstr "" "dosya açılamazsa, :exc:`OSError` hatası ortaya çıkar. Bu fonksiyonun nasıl " "kullanıldığına dair daha fazla örnek için :ref:`tut-files` bkz." -#: library/functions.rst:1175 +#: library/functions.rst:1174 msgid "" "*file* is a :term:`path-like object` giving the pathname (absolute or " "relative to the current working directory) of the file to be opened or an " @@ -2183,7 +2183,7 @@ msgstr "" "açıklayıcısı veirldiyse, *closefd*, ``False`` 'a ayarlanmadığı sürece I/O " "nesnesi kapatıldığında kapatılır." -#: library/functions.rst:1181 +#: library/functions.rst:1180 msgid "" "*mode* is an optional string that specifies the mode in which the file is " "opened. It defaults to ``'r'`` which means open for reading in text mode. " @@ -2207,71 +2207,71 @@ msgstr "" "(İşlenmemiş baytlar okumak veya yazmak için ikili modu kullanın ve " "*encoding* 'i boş bırakın. Geçerli modlar:" -#: library/functions.rst:1198 +#: library/functions.rst:1197 msgid "Character" msgstr "Karakter" -#: library/functions.rst:1198 +#: library/functions.rst:1197 msgid "Meaning" msgstr "Anlam" -#: library/functions.rst:1200 +#: library/functions.rst:1199 msgid "``'r'``" msgstr "``'r'``" -#: library/functions.rst:1200 +#: library/functions.rst:1199 msgid "open for reading (default)" msgstr "okumaya açık (varsayılan)" -#: library/functions.rst:1201 +#: library/functions.rst:1200 msgid "``'w'``" msgstr "``'w'``" -#: library/functions.rst:1201 +#: library/functions.rst:1200 msgid "open for writing, truncating the file first" msgstr "yazmaya açık, önce dosyayı keser" -#: library/functions.rst:1202 +#: library/functions.rst:1201 msgid "``'x'``" msgstr "``'x'``" -#: library/functions.rst:1202 +#: library/functions.rst:1201 msgid "open for exclusive creation, failing if the file already exists" msgstr "ayrıcalıklı oluşturma için açık, dosya varsa hata verir" -#: library/functions.rst:1203 +#: library/functions.rst:1202 msgid "``'a'``" msgstr "``'a'``" -#: library/functions.rst:1203 +#: library/functions.rst:1202 msgid "open for writing, appending to the end of file if it exists" msgstr "yazmaya açık, eğer dosya bulunuyorsa dosyaya ekleme yapar" -#: library/functions.rst:1204 +#: library/functions.rst:1203 msgid "``'b'``" msgstr "``'b'``" -#: library/functions.rst:1348 +#: library/functions.rst:1347 msgid "binary mode" msgstr "ikili mod" -#: library/functions.rst:1205 +#: library/functions.rst:1204 msgid "``'t'``" msgstr "``'t'``" -#: library/functions.rst:1205 +#: library/functions.rst:1204 msgid "text mode (default)" msgstr "metin modu (varsayılan)" -#: library/functions.rst:1206 +#: library/functions.rst:1205 msgid "``'+'``" msgstr "``'+'``" -#: library/functions.rst:1206 +#: library/functions.rst:1205 msgid "open for updating (reading and writing)" msgstr "güncellemeye açık (okuma ve yazma)" -#: library/functions.rst:1209 +#: library/functions.rst:1208 msgid "" "The default mode is ``'r'`` (open for reading text, a synonym of ``'rt'``). " "Modes ``'w+'`` and ``'w+b'`` open and truncate the file. Modes ``'r+'`` and " @@ -2281,7 +2281,7 @@ msgstr "" "``'w+'`` ve ``'w+b'`` modları dosyayı açar ve temizlerler. ``'r+'`` ve " "``'r+b'`` modları dosyayı temizlemeden açarlar." -#: library/functions.rst:1213 +#: library/functions.rst:1212 msgid "" "As mentioned in the :ref:`io-overview`, Python distinguishes between binary " "and text I/O. Files opened in binary mode (including ``'b'`` in the *mode* " @@ -2299,7 +2299,7 @@ msgstr "" "platforma bağlı bir kodlayıcı veya belirtilen *encoding* 'i kullanarak " "deşifre edilir." -#: library/functions.rst:1223 +#: library/functions.rst:1222 msgid "" "Python doesn't depend on the underlying operating system's notion of text " "files; all the processing is done by Python itself, and is therefore " @@ -2309,7 +2309,7 @@ msgstr "" "değildir. Tüm işlemler Python'un kendisi tarafından yapılır ve bu yüzden de " "platformdan bağımsızdır." -#: library/functions.rst:1227 +#: library/functions.rst:1226 msgid "" "*buffering* is an optional integer used to set the buffering policy. Pass 0 " "to switch buffering off (only allowed in binary mode), 1 to select line " @@ -2334,7 +2334,7 @@ msgstr "" "değişkeni verilmediğinde, varsayılan arabelleğe alma ilkesi şu şekilde " "çalışır:" -#: library/functions.rst:1237 +#: library/functions.rst:1236 #, fuzzy msgid "" "Binary files are buffered in fixed-size chunks; the size of the buffer is " @@ -2347,7 +2347,7 @@ msgstr "" "kullanılarak seçilir ve :attr:`io.DEFAULT_BUFFER_SIZE` değerine düşer. Çoğu " "sistemde, arabellek 4096 veya 8192 bayt uzunluğunda olacaktır." -#: library/functions.rst:1242 +#: library/functions.rst:1241 msgid "" "\"Interactive\" text files (files for which :meth:`~io.IOBase.isatty` " "returns ``True``) use line buffering. Other text files use the policy " @@ -2357,7 +2357,7 @@ msgstr "" "döndürdüğü dosyalar) satır arabelleğe almayı kullanır. Diğer metin dosyaları " "yukarıda ikili dosyalar için açıklanan poliçeyi kullanırlar." -#: library/functions.rst:1246 +#: library/functions.rst:1245 msgid "" "*encoding* is the name of the encoding used to decode or encode the file. " "This should only be used in text mode. The default encoding is platform " @@ -2372,7 +2372,7 @@ msgstr "" "kullanılabilir. Desteklenen kodlayıcıların listesi için :mod:`codecs` " "modülüne bkz." -#: library/functions.rst:1252 +#: library/functions.rst:1251 msgid "" "*errors* is an optional string that specifies how encoding and decoding " "errors are to be handled—this cannot be used in binary mode. A variety of " @@ -2386,7 +2386,7 @@ msgstr "" "`codecs.register_error` ile kaydedilen herhangi bir hata işleyici ismi de " "geçerlidir. Standart isimler bunları içerir:" -#: library/functions.rst:1260 +#: library/functions.rst:1259 msgid "" "``'strict'`` to raise a :exc:`ValueError` exception if there is an encoding " "error. The default value of ``None`` has the same effect." @@ -2395,7 +2395,7 @@ msgstr "" "yükseltmek için kullanılır. Varsayılan değer ``None`` ile aynı etkiyi " "gösterir." -#: library/functions.rst:1264 +#: library/functions.rst:1263 msgid "" "``'ignore'`` ignores errors. Note that ignoring encoding errors can lead to " "data loss." @@ -2403,7 +2403,7 @@ msgstr "" "``'ignore'`` hataları görmezden gelir. Kodlayıcı hatalarını görmezden " "gelmenin veri kaybı ile sonuçlanabileceğini unutmayın." -#: library/functions.rst:1267 +#: library/functions.rst:1266 msgid "" "``'replace'`` causes a replacement marker (such as ``'?'``) to be inserted " "where there is malformed data." @@ -2412,7 +2412,7 @@ msgstr "" "(``'?'`` gibi) 'nin hatalı biçimlendirilmiş verinin yerine geçmesine neden " "olur." -#: library/functions.rst:1270 +#: library/functions.rst:1269 msgid "" "``'surrogateescape'`` will represent any incorrect bytes as low surrogate " "code units ranging from U+DC80 to U+DCFF. These surrogate code units will " @@ -2426,7 +2426,7 @@ msgstr "" "baytlara geri döndürülecektir. Bu dosyaları bilinmeyen bir kodlayıcıyla " "işlerken kullanışlıdır." -#: library/functions.rst:1277 +#: library/functions.rst:1276 #, fuzzy msgid "" "``'xmlcharrefreplace'`` is only supported when writing to a file. Characters " @@ -2437,7 +2437,7 @@ msgstr "" "Kodlayıcı tarafından desteklenmeyen karakterler uygun XML karakter örneği " "ile değiştirilir." -#: library/functions.rst:1281 +#: library/functions.rst:1280 msgid "" "``'backslashreplace'`` replaces malformed data by Python's backslashed " "escape sequences." @@ -2445,7 +2445,7 @@ msgstr "" "``'backslashreplace'`` Python'un ters slash kaçış karakterleri yüzünden " "oluşan hatalı veriyi değiştirir." -#: library/functions.rst:1284 +#: library/functions.rst:1283 msgid "" "``'namereplace'`` (also only supported when writing) replaces unsupported " "characters with ``\\N{...}`` escape sequences." @@ -2453,7 +2453,7 @@ msgstr "" "``'namereplace'`` (sadece yazarken desteklenir) desteklenmeyen karakterleri " "``\\N{...}`` kaçış karakterleriyle değiştirir." -#: library/functions.rst:1292 +#: library/functions.rst:1291 msgid "" "*newline* determines how to parse newline characters from the stream. It can " "be ``None``, ``''``, ``'\\n'``, ``'\\r'``, and ``'\\r\\n'``. It works as " @@ -2463,7 +2463,7 @@ msgstr "" "belirler. ``None``, ``''``, ``'\\n'``, ``'\\r'`` ve ``'\\r\\n'`` olabilir. " "Aşağıdaki gibi çalışır:" -#: library/functions.rst:1296 +#: library/functions.rst:1295 msgid "" "When reading input from the stream, if *newline* is ``None``, universal " "newlines mode is enabled. Lines in the input can end in ``'\\n'``, " @@ -2481,7 +2481,7 @@ msgstr "" "değer verildiyse, girdi satırları sadece verilen dize ile sonlanır ve satır " "sonu çağrıcıya çevrilmeden döndürülür." -#: library/functions.rst:1304 +#: library/functions.rst:1303 msgid "" "When writing output to the stream, if *newline* is ``None``, any ``'\\n'`` " "characters written are translated to the system default line separator, :" @@ -2495,7 +2495,7 @@ msgstr "" "yapılmaz. Eğer *newline* diğer uygun değerlerden biri ise, tüm ``'\\n'`` " "karakterleri verilen dizeye dönüştürülür." -#: library/functions.rst:1310 +#: library/functions.rst:1309 msgid "" "If *closefd* is ``False`` and a file descriptor rather than a filename was " "given, the underlying file descriptor will be kept open when the file is " @@ -2507,7 +2507,7 @@ msgstr "" "Eğer bir dosya adı verildiyse, *closefd* ``True`` olmalıdır (varsayılan); " "aksi takdirde, bir hata ortaya çıkar." -#: library/functions.rst:1315 +#: library/functions.rst:1314 msgid "" "A custom opener can be used by passing a callable as *opener*. The " "underlying file descriptor for the file object is then obtained by calling " @@ -2521,11 +2521,11 @@ msgstr "" "dosya tanımlayıcısı döndürmelidir (*opener* yerine :mod:`os.open` göndermek " "fonksiyonel olarak ``None`` göndermek ile benzer sonuçlanır)." -#: library/functions.rst:1321 +#: library/functions.rst:1320 msgid "The newly created file is :ref:`non-inheritable `." msgstr "Yeni oluşturulan dosya :ref:`non-inheritable ` 'dir." -#: library/functions.rst:1323 +#: library/functions.rst:1322 msgid "" "The following example uses the :ref:`dir_fd ` parameter of the :func:" "`os.open` function to open a file relative to a given directory::" @@ -2533,7 +2533,7 @@ msgstr "" "Aşağıdaki örnek verilen bir dizine ait bir dosyayı açmak için :func:`os." "open` fonksiyonunun :ref:`dir_fd ` parametresini kullanır:" -#: library/functions.rst:1336 +#: library/functions.rst:1335 msgid "" "The type of :term:`file object` returned by the :func:`open` function " "depends on the mode. When :func:`open` is used to open a file in a text " @@ -2559,7 +2559,7 @@ msgstr "" "olduğunda, ham akış, :class:`io.RawIOBase` 'in alt sınıfı, :class:`io." "FileIO` döndürülür." -#: library/functions.rst:1357 +#: library/functions.rst:1356 msgid "" "See also the file handling modules, such as :mod:`fileinput`, :mod:`io` " "(where :func:`open` is declared), :mod:`os`, :mod:`os.path`, :mod:" @@ -2569,7 +2569,7 @@ msgstr "" "`os`, :mod:`os.path`, :mod:`tempfile`, ve :mod:`shutil` gibi dosya işleme " "modüllerine de bkz." -#: library/functions.rst:1361 +#: library/functions.rst:1360 msgid "" "Raises an :ref:`auditing event ` ``open`` with arguments ``file``, " "``mode``, ``flags``." @@ -2577,7 +2577,7 @@ msgstr "" "``file``, ``mode``, ``flags`` parametreleriyle bir :ref:`audition event " "` ``open`` ortaya çıkartır." -#: library/functions.rst:1363 +#: library/functions.rst:1362 msgid "" "The ``mode`` and ``flags`` arguments may have been modified or inferred from " "the original call." @@ -2585,21 +2585,21 @@ msgstr "" "``mode`` ve ``flags`` parametreleri orijinal çağrı tarafından modifiye " "edilmiş veya çıkartılmış olabilir." -#: library/functions.rst:1368 +#: library/functions.rst:1367 msgid "The *opener* parameter was added." msgstr "*opener* parametresi eklendi." -#: library/functions.rst:1369 +#: library/functions.rst:1368 msgid "The ``'x'`` mode was added." msgstr "``'x'`` modu eklendi." -#: library/functions.rst:1370 +#: library/functions.rst:1369 msgid ":exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`." msgstr "" "Eskiden :exc:`IOError` hatası ortaya çıkardı, şimdi :exc:`OSError` 'un takma " "adıdır." -#: library/functions.rst:1371 +#: library/functions.rst:1370 msgid "" ":exc:`FileExistsError` is now raised if the file opened in exclusive " "creation mode (``'x'``) already exists." @@ -2607,11 +2607,11 @@ msgstr "" "Artık eğer özel oluşturma modunda (``'x'``) açılmış dosyalar zaten " "bulunuyorsa :exc:`FileExistsError` hatası ortaya çıkar." -#: library/functions.rst:1376 +#: library/functions.rst:1375 msgid "The file is now non-inheritable." msgstr "Dosya artık miras alınamaz." -#: library/functions.rst:1380 +#: library/functions.rst:1379 msgid "" "If the system call is interrupted and the signal handler does not raise an " "exception, the function now retries the system call instead of raising an :" @@ -2621,15 +2621,15 @@ msgstr "" "çıkartmazsa, artık fonksiyon :exc:`InterruptedError` hatası ortaya çıkartmak " "yerine sistem çağrısını yeniden dener (açıklama için :pep:`475` bkz)." -#: library/functions.rst:1383 +#: library/functions.rst:1382 msgid "The ``'namereplace'`` error handler was added." msgstr "``'namereplace'`` hata işleyicisi eklendi." -#: library/functions.rst:1387 +#: library/functions.rst:1386 msgid "Support added to accept objects implementing :class:`os.PathLike`." msgstr ":class:`os.PathLike` uygulayan nesneleri kabul etme desteği eklendi." -#: library/functions.rst:1388 +#: library/functions.rst:1387 msgid "" "On Windows, opening a console buffer may return a subclass of :class:`io." "RawIOBase` other than :class:`io.FileIO`." @@ -2637,11 +2637,11 @@ msgstr "" "Windows'da, bir konsol arabelleğinin açılması :class:`io.FileIO` dışında " "bir :class:`io.RawIOBase` alt sınıfını döndürebilir." -#: library/functions.rst:1391 +#: library/functions.rst:1390 msgid "The ``'U'`` mode has been removed." msgstr "``'U'`` modu kaldırıldı." -#: library/functions.rst:1396 +#: library/functions.rst:1395 msgid "" "Given a string representing one Unicode character, return an integer " "representing the Unicode code point of that character. For example, " @@ -2653,7 +2653,7 @@ msgstr "" "tamsayısını döndürür ve ``ord('€')`` (Euro simgesi) ``8364`` tamsayısını " "döndürür. Bu :func:`chr` 'nin tersidir." -#: library/functions.rst:1404 +#: library/functions.rst:1403 msgid "" "Return *base* to the power *exp*; if *mod* is present, return *base* to the " "power *exp*, modulo *mod* (computed more efficiently than ``pow(base, exp) % " @@ -2665,7 +2665,7 @@ msgstr "" "parametreli formu ``pow(base, exp)``, üs operatörü ``base**exp`` kullanmaya " "eş değerdir." -#: library/functions.rst:1409 +#: library/functions.rst:1408 msgid "" "The arguments must have numeric types. With mixed operand types, the " "coercion rules for binary arithmetic operators apply. For :class:`int` " @@ -2687,7 +2687,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:1419 +#: library/functions.rst:1418 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 " @@ -2701,11 +2701,11 @@ msgstr "" "``pow(inv_base,-exp,mod)`` döndürülüri *inv_base, *base* mod *mod* 'un " "tersidir." -#: library/functions.rst:1425 +#: library/functions.rst:1424 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:1432 +#: library/functions.rst:1431 msgid "" "For :class:`int` operands, the three-argument form of ``pow`` now allows the " "second argument to be negative, permitting computation of modular inverses." @@ -2713,14 +2713,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:1437 +#: library/functions.rst:1436 msgid "" "Allow keyword arguments. Formerly, only positional arguments were supported." msgstr "" "Anahtar kelime parametrelerine izin ver, önceden sadece pozisyonel " "parametreler desteklenirdi." -#: library/functions.rst:1444 +#: library/functions.rst:1443 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 " @@ -2730,7 +2730,7 @@ msgstr "" "şekilde *objects* 'i yazdırır. *sep*, *end, *file*, ve *flush* sunulursa " "anahtar kelime parametreleri olarak verilmelidir." -#: library/functions.rst:1448 +#: library/functions.rst:1447 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* " @@ -2744,7 +2744,7 @@ msgstr "" "varsayılan değerler kullanılır. Eğer *objects* verilmediyse, :func:`print` " "sadece *end* 'i yazdırır." -#: library/functions.rst:1454 +#: library/functions.rst:1453 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 " @@ -2756,7 +2756,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:1459 +#: library/functions.rst:1458 #, fuzzy msgid "" "Output buffering is usually determined by *file*. However, if *flush* is " @@ -2765,15 +2765,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:1463 +#: library/functions.rst:1462 msgid "Added the *flush* keyword argument." msgstr "*flush* anahtar kelimesi argümanı eklendi." -#: library/functions.rst:1469 +#: library/functions.rst:1468 msgid "Return a property attribute." msgstr "Bir özellik özelliği döndürür." -#: library/functions.rst:1471 +#: library/functions.rst:1470 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 " @@ -2784,11 +2784,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:1475 +#: library/functions.rst:1474 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:1492 +#: library/functions.rst:1491 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." @@ -2796,7 +2796,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:1495 +#: library/functions.rst:1494 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 " @@ -2808,7 +2808,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:1508 +#: library/functions.rst:1507 #, fuzzy msgid "" "The ``@property`` decorator turns the :meth:`!voltage` method into a " @@ -2819,7 +2819,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:1516 +#: library/functions.rst:1515 #, fuzzy msgid "" "A property object has ``getter``, ``setter``, and ``deleter`` methods usable " @@ -2833,7 +2833,7 @@ msgstr "" "`~property.deleter` metotlarını içerir. Bu en iyi şekilde bir örnekle " "açıklanabilir::" -#: library/functions.rst:1540 +#: library/functions.rst:1539 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 " @@ -2842,7 +2842,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:1544 +#: library/functions.rst:1543 msgid "" "The returned property object also has the attributes ``fget``, ``fset``, and " "``fdel`` corresponding to the constructor arguments." @@ -2850,11 +2850,11 @@ msgstr "" "Döndürülen property nesnesi yapıcı metotta verilen ``fget``, ``fset``, ve " "``fdel`` özelliklerine sahiptir." -#: library/functions.rst:1547 +#: library/functions.rst:1546 msgid "The docstrings of property objects are now writeable." msgstr "Property nesnelerinin doküman dizeleri artık yazılabilir." -#: library/functions.rst:1556 +#: library/functions.rst:1555 msgid "" "Rather than being a function, :class:`range` is actually an immutable " "sequence type, as documented in :ref:`typesseq-range` and :ref:`typesseq`." @@ -2863,7 +2863,7 @@ msgstr "" "tipidir. Daha fazla bilgi için :ref:`typesseq-range` ve :ref:`typesseq` 'e " "bakınız." -#: library/functions.rst:1562 +#: library/functions.rst:1561 #, fuzzy msgid "" "Return a string containing a printable representation of an object. For " @@ -2885,7 +2885,7 @@ 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:1576 +#: library/functions.rst:1575 #, fuzzy msgid "" "Return a reverse :term:`iterator`. *seq* must be an object which has a :" @@ -2898,7 +2898,7 @@ msgstr "" "tam sayı argümanları alan bir :meth:`__getitem__` metodu) destekleyen bir " "nesne olmalıdır." -#: library/functions.rst:1584 +#: library/functions.rst:1583 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 " @@ -2908,7 +2908,7 @@ msgstr "" "*ndigits* verilmediyse veya ``None`` ise, *number* 'a en yakın tam sayı " "döndürülür." -#: library/functions.rst:1588 +#: library/functions.rst:1587 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 " @@ -2926,7 +2926,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:1597 +#: library/functions.rst:1596 msgid "" "For a general Python object ``number``, ``round`` delegates to ``number." "__round__``." @@ -2934,7 +2934,7 @@ msgstr "" "Genel bir Python nesnesi için ``number``, ``round`` ``number.__round__`` 'u " "temsil eder." -#: library/functions.rst:1602 +#: library/functions.rst:1601 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 " @@ -2948,7 +2948,7 @@ msgstr "" "gösterilemeyeceğinden bu sonucu alıyoruz. Daha fazla bilgi için :ref:`tut-fp-" "issues` 'e bkz." -#: library/functions.rst:1614 +#: library/functions.rst:1613 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-" @@ -2958,7 +2958,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:1618 +#: library/functions.rst:1617 msgid "" "For other containers see the built-in :class:`frozenset`, :class:`list`, :" "class:`tuple`, and :class:`dict` classes, as well as the :mod:`collections` " @@ -2968,7 +2968,7 @@ msgstr "" "`tuple` ve :class:`dict` sınıflarını; aynı zamanda :mod:`collections` " "modülüne bakınız." -#: library/functions.rst:1625 +#: library/functions.rst:1624 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 " @@ -2981,7 +2981,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:1631 +#: library/functions.rst:1630 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:" @@ -2995,7 +2995,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:1639 +#: library/functions.rst:1638 msgid "" "Since :ref:`private name mangling ` happens at " "compilation time, one must manually mangle a private attribute's (attributes " @@ -3005,14 +3005,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:1648 +#: library/functions.rst:1647 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:1656 +#: library/functions.rst:1655 msgid "" "Slice objects have read-only data attributes :attr:`!start`, :attr:`!stop`, " "and :attr:`!step` which merely return the argument values (or their " @@ -3020,30 +3020,30 @@ msgid "" "by NumPy and other third-party packages." msgstr "" -#: library/functions.rst:1661 +#: library/functions.rst:1660 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:1666 +#: library/functions.rst:1665 msgid "" "Slice objects are now :term:`hashable` (provided :attr:`~slice.start`, :attr:" "`~slice.stop`, and :attr:`~slice.step` are hashable)." msgstr "" -#: library/functions.rst:1672 +#: library/functions.rst:1671 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:1674 +#: library/functions.rst:1673 msgid "" "Has two optional arguments which must be specified as keyword arguments." msgstr "İsimle belirtilmesi gereken 2 opsiyonel parametresi vardır." -#: library/functions.rst:1676 +#: library/functions.rst:1675 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." @@ -3053,7 +3053,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:1680 +#: library/functions.rst:1679 msgid "" "*reverse* is a boolean value. If set to ``True``, then the list elements " "are sorted as if each comparison were reversed." @@ -3061,7 +3061,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:1683 +#: library/functions.rst:1682 msgid "" "Use :func:`functools.cmp_to_key` to convert an old-style *cmp* function to a " "*key* function." @@ -3069,7 +3069,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:1686 +#: library/functions.rst:1685 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 " @@ -3081,7 +3081,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:1691 +#: library/functions.rst:1690 msgid "" "The sort algorithm uses only ``<`` comparisons between items. While " "defining an :meth:`~object.__lt__` method will suffice for sorting, :PEP:`8` " @@ -3101,18 +3101,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:1700 +#: library/functions.rst:1699 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:1704 +#: library/functions.rst:1703 msgid "Transform a method into a static method." msgstr "Bir metodu statik metoda dönüştürür." -#: library/functions.rst:1706 +#: library/functions.rst:1705 msgid "" "A static method does not receive an implicit first argument. To declare a " "static method, use this idiom::" @@ -3120,7 +3120,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:1713 +#: library/functions.rst:1712 msgid "" "The ``@staticmethod`` form is a function :term:`decorator` -- see :ref:" "`function` for details." @@ -3128,7 +3128,7 @@ msgstr "" "``@staticmethod`` ifadesi bir :term:`decorator` fonksiyonudur. -- detaylar " "için :ref:`function` bkz." -#: library/functions.rst:1716 +#: library/functions.rst:1715 msgid "" "A static method can be called either on the class (such as ``C.f()``) or on " "an instance (such as ``C().f()``). Moreover, they can be called as regular " @@ -3138,7 +3138,7 @@ msgstr "" "(``C().f()`` gibi) çağırılabilir. Hatta normal fonksiyonlar gibi (``f()``) " "de çağırılabilirler." -#: library/functions.rst:1720 +#: library/functions.rst:1719 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 " @@ -3148,7 +3148,7 @@ msgstr "" "için alternatif bir yapıcı metot oluşturmak isterseniz :func:`classmethod` " "bkz." -#: library/functions.rst:1724 +#: library/functions.rst:1723 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 " @@ -3162,11 +3162,11 @@ msgstr "" "dönüşümü engellemek istediğinizde işinize yarayabilir. Böyle durumlar için, " "bu ifadeyi kullanabilirsiniz::" -#: library/functions.rst:1736 +#: library/functions.rst:1735 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:1738 +#: library/functions.rst:1737 msgid "" "Static methods now inherit the method attributes (``__module__``, " "``__name__``, ``__qualname__``, ``__doc__`` and ``__annotations__``), have a " @@ -3177,14 +3177,14 @@ msgstr "" "``__wrapped__`` özellikleri var ve artık normal fonksiyonlar gibi " "çağırılabilirler." -#: library/functions.rst:1753 +#: library/functions.rst:1752 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:1755 +#: library/functions.rst:1754 msgid "" "``str`` is the built-in string :term:`class`. For general information about " "strings, see :ref:`textseq`." @@ -3192,7 +3192,7 @@ msgstr "" "``str`` yerleşik dize :term:`class` 'ıdır. Dizeler hakkında genel bilgi " "için, :ref:`textseq` bkz." -#: library/functions.rst:1761 +#: library/functions.rst:1760 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 " @@ -3202,7 +3202,7 @@ msgstr "" "döndürür. *iterable* 'ın elemanları normal olarak numaralardır ve başlangıç " "değeri bir dize olamaz." -#: library/functions.rst:1765 +#: library/functions.rst:1764 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 ``''." @@ -3217,17 +3217,17 @@ msgstr "" "nesnelerden oluşan bir diziyi birleştirmek istiyorsanız, :func:`itertools." "chain` fonksiyonunu kullanmayı göz önünde bulundurun." -#: library/functions.rst:1771 +#: library/functions.rst:1770 msgid "The *start* parameter can be specified as a keyword argument." msgstr "*start* parametresi bir anahtar kelime argümanı olarak belirtilebilir." -#: library/functions.rst:1774 +#: library/functions.rst:1773 msgid "" "Summation of floats switched to an algorithm that gives higher accuracy on " "most builds." msgstr "" -#: library/functions.rst:1781 +#: library/functions.rst:1780 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 " @@ -3237,7 +3237,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:1785 +#: library/functions.rst:1784 msgid "" "The *object_or_type* determines the :term:`method resolution order` to be " "searched. The search starts from the class right after the *type*." @@ -3245,7 +3245,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:1789 +#: library/functions.rst:1788 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` " @@ -3255,7 +3255,7 @@ msgstr "" "> B -> C -> A -> object`` ise ve *type* değeri ``B`` ise, :func:`super` ``C -" "> A -> object`` 'i arar." -#: library/functions.rst:1793 +#: library/functions.rst:1792 msgid "" "The :attr:`~class.__mro__` attribute of the *object_or_type* lists the " "method resolution search order used by both :func:`getattr` and :func:" @@ -3267,7 +3267,7 @@ msgstr "" "listeler. Özellik dinamiktir ve kalıtım hiyerarşisi her güncellendiğinde " "değişebilir." -#: library/functions.rst:1798 +#: library/functions.rst:1797 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. " @@ -3279,7 +3279,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:1803 +#: library/functions.rst:1802 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 " @@ -3290,7 +3290,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:1808 +#: library/functions.rst:1807 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 " @@ -3311,12 +3311,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:1818 +#: library/functions.rst:1817 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:1825 +#: library/functions.rst:1824 msgid "" "In addition to method lookups, :func:`super` also works for attribute " "lookups. One possible use case for this is calling :term:`descriptors " @@ -3326,7 +3326,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:1829 +#: library/functions.rst:1828 #, fuzzy msgid "" "Note that :func:`super` is implemented as part of the binding process for " @@ -3343,7 +3343,7 @@ msgstr "" "`super`, ifadeler veya ``super()[name]`` gibi operatörler kullanarak kesin " "aramalar için tanımsızdır." -#: library/functions.rst:1837 +#: library/functions.rst:1836 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 " @@ -3358,7 +3358,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:1844 +#: library/functions.rst:1843 msgid "" "For practical suggestions on how to design cooperative classes using :func:" "`super`, see `guide to using super() `_ bkz." -#: library/functions.rst:1854 +#: library/functions.rst:1853 msgid "" "Rather than being a function, :class:`tuple` is actually an immutable " "sequence type, as documented in :ref:`typesseq-tuple` and :ref:`typesseq`." @@ -3376,7 +3376,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:1863 +#: library/functions.rst:1862 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." @@ -3386,7 +3386,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:1867 +#: library/functions.rst:1866 msgid "" "The :func:`isinstance` built-in function is recommended for testing the type " "of an object, because it takes subclasses into account." @@ -3394,7 +3394,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:1871 +#: library/functions.rst:1870 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 " @@ -3415,11 +3415,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:1886 +#: library/functions.rst:1885 msgid "See also :ref:`bltin-type-objects`." msgstr ":ref:`bltin-type-objects` 'e de bkz." -#: library/functions.rst:1888 +#: library/functions.rst:1887 msgid "" "Keyword arguments provided to the three argument form are passed to the " "appropriate metaclass machinery (usually :meth:`~object.__init_subclass__`) " @@ -3431,11 +3431,11 @@ msgstr "" "tanımındaki anahtar sözcüklerin (*metaclass* dışında) yapacağı şekilde " "iletilir." -#: library/functions.rst:1893 +#: library/functions.rst:1892 msgid "See also :ref:`class-customization`." msgstr ":ref:`class-customization` 'a da bkz." -#: library/functions.rst:1895 +#: library/functions.rst:1894 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." @@ -3443,7 +3443,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:1902 +#: library/functions.rst:1901 msgid "" "Return the :attr:`~object.__dict__` attribute for a module, class, instance, " "or any other object with a :attr:`~object.__dict__` attribute." @@ -3451,7 +3451,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:1905 +#: library/functions.rst:1904 msgid "" "Objects such as modules and instances have an updateable :attr:`~object." "__dict__` attribute; however, other objects may have write restrictions on " @@ -3464,7 +3464,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:1910 +#: library/functions.rst:1909 msgid "" "Without an argument, :func:`vars` acts like :func:`locals`. Note, the " "locals dictionary is only useful for reads since updates to the locals " @@ -3474,7 +3474,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:1914 +#: library/functions.rst:1913 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 " @@ -3484,7 +3484,7 @@ msgstr "" "(örneğin, :attr:`~object.__slots__` özelliğini tanımlayan bir sınıf ise), :" "exc:`TypeError` hatası ortaya çıkar." -#: library/functions.rst:1920 +#: library/functions.rst:1919 msgid "" "Iterate over several iterables in parallel, producing tuples with an item " "from each one." @@ -3492,11 +3492,11 @@ msgstr "" "Paralel olarak birkaç yinelenebilir nesneyi yineler ve hepsinden bir element " "alarak bir demet üretir." -#: library/functions.rst:1923 +#: library/functions.rst:1922 msgid "Example::" msgstr "Örnek::" -#: library/functions.rst:1932 +#: library/functions.rst:1931 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." @@ -3505,7 +3505,7 @@ msgstr "" "parametre yineleyicisinden *i* 'inci elementi içerdiği bir yineleyici " "döndürür." -#: library/functions.rst:1935 +#: library/functions.rst:1934 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:1939 +#: library/functions.rst:1938 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:" @@ -3525,7 +3525,7 @@ msgstr "" "döngüsü veya :class:`list` tarafından sarılarak yinelenmediği sürece " "elementler işlenmez." -#: library/functions.rst:1943 +#: library/functions.rst:1942 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 " @@ -3537,7 +3537,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:1948 +#: library/functions.rst:1947 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 " @@ -3547,7 +3547,7 @@ msgstr "" "durur. Daha uzun yinelebilirlerde kalan elementleri görmezden gelecektir ve " "sonucu en kısa yineleyicinin uzunluğuna eşitleyecektir::" -#: library/functions.rst:1955 +#: library/functions.rst:1954 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`` " @@ -3557,7 +3557,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:1962 +#: library/functions.rst:1961 msgid "" "Unlike the default behavior, it raises a :exc:`ValueError` if one iterable " "is exhausted before the others:" @@ -3565,7 +3565,7 @@ msgstr "" "Varsayılan davranışın aksine, bir yinelenebilir diğerlerinden önce tükenirse " "bir :exc:`ValueError` ortaya çıkar:" -#: library/functions.rst:1980 +#: library/functions.rst:1979 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 " @@ -3575,7 +3575,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:1984 +#: library/functions.rst:1983 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." @@ -3585,7 +3585,7 @@ msgstr "" "uzunlukta olması için sabit bir değerle doldurulabilirler. Bu :func:" "`itertools.zip_longest` tarafından yapılır." -#: library/functions.rst:1988 +#: library/functions.rst:1987 msgid "" "Edge cases: With a single iterable argument, :func:`zip` returns an iterator " "of 1-tuples. With no arguments, it returns an empty iterator." @@ -3594,11 +3594,11 @@ msgstr "" "bir demetin yineleyicisini döndürür. Argüman verilmezse, boş bir yineleyici " "döndürür." -#: library/functions.rst:1991 +#: library/functions.rst:1990 msgid "Tips and tricks:" msgstr "İpucu ve hileler:" -#: library/functions.rst:1993 +#: library/functions.rst:1992 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 " @@ -3613,7 +3613,7 @@ msgstr "" "sayıda çağrı yapmış olur. Bu, girdiyi n-uzunluklu parçalara bölme etkisine " "sahiptir." -#: library/functions.rst:1999 +#: library/functions.rst:1998 msgid "" ":func:`zip` in conjunction with the ``*`` operator can be used to unzip a " "list::" @@ -3621,11 +3621,11 @@ msgstr "" ":func:`zip`, bir listeyi açmak için ``*`` operatörüyle birlikte " "kullanılabilir::" -#: library/functions.rst:2010 +#: library/functions.rst:2009 msgid "Added the ``strict`` argument." msgstr "``strict`` argümanı eklendi." -#: library/functions.rst:2022 +#: library/functions.rst:2021 msgid "" "This is an advanced function that is not needed in everyday Python " "programming, unlike :func:`importlib.import_module`." @@ -3633,7 +3633,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:2025 +#: library/functions.rst:2024 msgid "" "This function is invoked by the :keyword:`import` statement. It can be " "replaced (by importing the :mod:`builtins` module and assigning to " @@ -3652,7 +3652,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:2034 +#: library/functions.rst:2033 msgid "" "The function imports the module *name*, potentially using the given " "*globals* and *locals* to determine how to interpret the name in a package " @@ -3668,7 +3668,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:2041 +#: library/functions.rst:2040 msgid "" "*level* specifies whether to use absolute or relative imports. ``0`` (the " "default) means only perform absolute imports. Positive values for *level* " @@ -3682,7 +3682,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:2047 +#: library/functions.rst:2046 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 " @@ -3693,7 +3693,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:2052 +#: library/functions.rst:2051 msgid "" "For example, the statement ``import spam`` results in bytecode resembling " "the following code::" @@ -3701,11 +3701,11 @@ msgstr "" "Örnek olarak, ``import spam`` ifadesi aşağıdaki koda benzeyen bayt koduyla " "sonuçlanır::" -#: library/functions.rst:2057 +#: library/functions.rst:2056 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:2061 +#: library/functions.rst:2060 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." @@ -3714,7 +3714,7 @@ msgstr "" "dikkat edin, çünkü bu, :keyword:`import` ifadesiyle bir ada bağlanan " "nesnedir." -#: library/functions.rst:2064 +#: library/functions.rst:2063 msgid "" "On the other hand, the statement ``from spam.ham import eggs, sausage as " "saus`` results in ::" @@ -3722,7 +3722,7 @@ msgstr "" "Diğer yandan, ``from spam.ham import eggs, sausage as saus`` ifadesi şöyle " "sonuçlanır::" -#: library/functions.rst:2071 +#: library/functions.rst:2070 msgid "" "Here, the ``spam.ham`` module is returned from :func:`__import__`. From " "this object, the names to import are retrieved and assigned to their " @@ -3731,7 +3731,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:2075 +#: library/functions.rst:2074 msgid "" "If you simply want to import a module (potentially within a package) by " "name, use :func:`importlib.import_module`." @@ -3739,7 +3739,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:2078 +#: library/functions.rst:2077 msgid "" "Negative values for *level* are no longer supported (which also changes the " "default value to 0)." @@ -3747,7 +3747,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:2082 +#: library/functions.rst:2081 msgid "" "When the command line options :option:`-E` or :option:`-I` are being used, " "the environment variable :envvar:`PYTHONCASEOK` is now ignored." @@ -3755,11 +3755,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:2087 +#: library/functions.rst:2086 msgid "Footnotes" msgstr "Dipnotlar" -#: library/functions.rst:2088 +#: library/functions.rst:2087 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 " @@ -3774,7 +3774,7 @@ msgstr "" msgid "Boolean" msgstr "" -#: library/functions.rst:1861 +#: library/functions.rst:1860 msgid "type" msgstr "" @@ -3795,92 +3795,92 @@ msgstr "" msgid "Infinity" msgstr "" -#: library/functions.rst:718 +#: library/functions.rst:717 msgid "__format__" msgstr "" -#: library/functions.rst:1745 +#: library/functions.rst:1744 msgid "string" msgstr "" -#: library/functions.rst:718 +#: library/functions.rst:717 #, fuzzy msgid "format() (built-in function)" msgstr "Gömülü Fonksiyonlar" -#: library/functions.rst:1166 +#: library/functions.rst:1165 msgid "file object" msgstr "" -#: library/functions.rst:1287 +#: library/functions.rst:1286 #, fuzzy msgid "open() built-in function" msgstr "Gömülü Fonksiyonlar" -#: library/functions.rst:1194 +#: library/functions.rst:1193 msgid "file" msgstr "" -#: library/functions.rst:1194 +#: library/functions.rst:1193 msgid "modes" msgstr "" -#: library/functions.rst:1287 +#: library/functions.rst:1286 msgid "universal newlines" msgstr "" -#: library/functions.rst:1348 +#: library/functions.rst:1347 msgid "line-buffered I/O" msgstr "" -#: library/functions.rst:1348 +#: library/functions.rst:1347 msgid "unbuffered I/O" msgstr "" -#: library/functions.rst:1348 +#: library/functions.rst:1347 msgid "buffer size, I/O" msgstr "" -#: library/functions.rst:1348 +#: library/functions.rst:1347 msgid "I/O control" msgstr "" -#: library/functions.rst:1348 +#: library/functions.rst:1347 msgid "buffering" msgstr "" -#: library/functions.rst:1348 +#: library/functions.rst:1347 #, fuzzy msgid "text mode" msgstr "metin modu (varsayılan)" -#: library/functions.rst:2016 +#: library/functions.rst:2015 msgid "module" msgstr "" -#: library/functions.rst:1348 +#: library/functions.rst:1347 msgid "sys" msgstr "" -#: library/functions.rst:1745 +#: library/functions.rst:1744 #, fuzzy msgid "str() (built-in function)" msgstr "Gömülü Fonksiyonlar" -#: library/functions.rst:1861 +#: library/functions.rst:1860 #, fuzzy msgid "object" msgstr ":func:`object`" -#: library/functions.rst:2016 +#: library/functions.rst:2015 msgid "statement" msgstr "" -#: library/functions.rst:2016 +#: library/functions.rst:2015 msgid "import" msgstr "" -#: library/functions.rst:2016 +#: library/functions.rst:2015 msgid "builtins" msgstr "" diff --git a/library/functools.po b/library/functools.po index 911d84bcc..dfeaf6f91 100644 --- a/library/functools.po +++ b/library/functools.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -225,7 +225,7 @@ msgstr "" #: library/functools.rst:197 msgid "" -"The wrapped function is instrumented with a :func:`cache_parameters` " +"The wrapped function is instrumented with a :func:`!cache_parameters` " "function that returns a new :class:`dict` showing the values for *maxsize* " "and *typed*. This is for information purposes only. Mutating the values " "has no effect." @@ -303,7 +303,7 @@ msgid "Added the *user_function* option." msgstr "" #: library/functools.rst:278 -msgid "Added the function :func:`cache_parameters`" +msgid "Added the function :func:`!cache_parameters`" msgstr "" #: library/functools.rst:283 diff --git a/library/gzip.po b/library/gzip.po index 1ef6a2577..e2104d48f 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: 2023-12-01 14:57+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -109,9 +109,9 @@ msgstr "" #: library/gzip.rst:64 msgid "" -"An exception raised for invalid gzip files. It inherits :exc:`OSError`. :" -"exc:`EOFError` and :exc:`zlib.error` can also be raised for invalid gzip " -"files." +"An exception raised for invalid gzip files. It inherits from :exc:" +"`OSError`. :exc:`EOFError` and :exc:`zlib.error` can also be raised for " +"invalid gzip files." msgstr "" #: library/gzip.rst:72 diff --git a/library/hashlib.po b/library/hashlib.po index 82a63125f..07b46c3cd 100644 --- a/library/hashlib.po +++ b/library/hashlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -570,7 +570,7 @@ msgid "" "(``False`` for sequential mode)." msgstr "" -#: library/hashlib.rst:None +#: library/hashlib.rst:-1 msgid "Explanation of tree mode parameters." msgstr "" diff --git a/library/heapq.po b/library/heapq.po index 92fd0731a..41dfaa721 100644 --- a/library/heapq.po +++ b/library/heapq.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -308,7 +308,7 @@ msgid "" "above) into the 0 position, and then percolate this new 0 down the tree, " "exchanging values, until the invariant is re-established. This is clearly " "logarithmic on the total number of items in the tree. By iterating over all " -"items, you get an O(n log n) sort." +"items, you get an *O*\\ (*n* log *n*) sort." msgstr "" #: library/heapq.rst:275 diff --git a/library/http.client.po b/library/http.client.po index c16f7f235..041f8befd 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -123,7 +123,7 @@ msgstr "" #: library/http.client.rst:92 msgid "" "This class now performs all the necessary certificate and hostname checks by " -"default. To revert to the previous, unverified, behavior :func:`ssl." +"default. To revert to the previous, unverified, behavior :func:`!ssl." "_create_unverified_context` can be passed to the *context* parameter." msgstr "" @@ -138,7 +138,7 @@ msgstr "" msgid "" "This class now sends an ALPN extension with protocol indicator ``http/1.1`` " "when no *context* is given. Custom *context* should set ALPN protocols with :" -"meth:`~ssl.SSLContext.set_alpn_protocol`." +"meth:`~ssl.SSLContext.set_alpn_protocols`." msgstr "" #: library/http.client.rst:108 @@ -166,7 +166,7 @@ msgstr "" #: library/http.client.rst:126 msgid "" "Parse the headers from a file pointer *fp* representing a HTTP request/" -"response. The file has to be a :class:`BufferedIOBase` reader (i.e. not " +"response. The file has to be a :class:`~io.BufferedIOBase` reader (i.e. not " "text) and must provide a valid :rfc:`2822` style header." msgstr "" @@ -438,7 +438,7 @@ msgid "" "already have a connection." msgstr "" -#: library/http.client.rst:413 +#: library/http.client.rst:415 msgid "" "Raises an :ref:`auditing event ` ``http.client.connect`` with " "arguments ``self``, ``host``, ``port``." @@ -454,8 +454,9 @@ msgstr "" #: library/http.client.rst:419 msgid "" -"As an alternative to using the :meth:`request` method described above, you " -"can also send your request step by step, by using the four functions below." +"As an alternative to using the :meth:`~HTTPConnection.request` method " +"described above, you can also send your request step by step, by using the " +"four functions below." msgstr "" #: library/http.client.rst:426 @@ -505,49 +506,49 @@ msgid "" msgstr "" #: library/http.client.rst:464 -msgid "Chunked encoding support. The *encode_chunked* parameter was added." +msgid "Added chunked encoding support and the *encode_chunked* parameter." msgstr "" -#: library/http.client.rst:471 +#: library/http.client.rst:470 msgid "" "Send data to the server. This should be used directly only after the :meth:" "`endheaders` method has been called and before :meth:`getresponse` is called." msgstr "" -#: library/http.client.rst:484 +#: library/http.client.rst:485 msgid "" "Raises an :ref:`auditing event ` ``http.client.send`` with " "arguments ``self``, ``data``." msgstr "" -#: library/http.client.rst:481 +#: library/http.client.rst:480 msgid "HTTPResponse Objects" msgstr "" -#: library/http.client.rst:483 +#: library/http.client.rst:482 msgid "" "An :class:`HTTPResponse` instance wraps the HTTP response from the server. " "It provides access to the request headers and the entity body. The response " "is an iterable object and can be used in a with statement." msgstr "" -#: library/http.client.rst:488 +#: library/http.client.rst:487 msgid "" "The :class:`io.BufferedIOBase` interface is now implemented and all of its " "reader operations are supported." msgstr "" -#: library/http.client.rst:495 +#: library/http.client.rst:494 msgid "Reads and returns the response body, or up to the next *amt* bytes." msgstr "" -#: library/http.client.rst:499 +#: library/http.client.rst:498 msgid "" "Reads up to the next len(b) bytes of the response body into the buffer *b*. " "Returns the number of bytes read." msgstr "" -#: library/http.client.rst:506 +#: library/http.client.rst:505 msgid "" "Return the value of the header *name*, or *default* if there is no header " "matching *name*. If there is more than one header with the name *name*, " @@ -555,87 +556,87 @@ msgid "" "than a single string, its elements are similarly returned joined by commas." msgstr "" -#: library/http.client.rst:513 +#: library/http.client.rst:512 msgid "Return a list of (header, value) tuples." msgstr "" -#: library/http.client.rst:517 +#: library/http.client.rst:516 msgid "Return the ``fileno`` of the underlying socket." msgstr "" -#: library/http.client.rst:521 +#: library/http.client.rst:520 msgid "" "A :class:`http.client.HTTPMessage` instance containing the response " "headers. :class:`http.client.HTTPMessage` is a subclass of :class:`email." "message.Message`." msgstr "" -#: library/http.client.rst:527 +#: library/http.client.rst:526 msgid "" "HTTP protocol version used by server. 10 for HTTP/1.0, 11 for HTTP/1.1." msgstr "" -#: library/http.client.rst:531 +#: library/http.client.rst:530 msgid "" "URL of the resource retrieved, commonly used to determine if a redirect was " "followed." msgstr "" -#: library/http.client.rst:535 +#: library/http.client.rst:534 msgid "" "Headers of the response in the form of an :class:`email.message." "EmailMessage` instance." msgstr "" -#: library/http.client.rst:539 +#: library/http.client.rst:538 msgid "Status code returned by server." msgstr "" -#: library/http.client.rst:543 +#: library/http.client.rst:542 msgid "Reason phrase returned by server." msgstr "" -#: library/http.client.rst:547 +#: library/http.client.rst:546 msgid "" "A debugging hook. If :attr:`debuglevel` is greater than zero, messages will " "be printed to stdout as the response is read and parsed." msgstr "" -#: library/http.client.rst:552 +#: library/http.client.rst:551 msgid "Is ``True`` if the stream is closed." msgstr "" -#: library/http.client.rst:556 +#: library/http.client.rst:555 msgid "Deprecated in favor of :attr:`~HTTPResponse.url`." msgstr "" -#: library/http.client.rst:561 +#: library/http.client.rst:560 msgid "Deprecated in favor of :attr:`~HTTPResponse.headers`." msgstr "" -#: library/http.client.rst:566 +#: library/http.client.rst:565 msgid "Deprecated in favor of :attr:`~HTTPResponse.status`." msgstr "" -#: library/http.client.rst:570 +#: library/http.client.rst:569 msgid "Examples" msgstr "" -#: library/http.client.rst:572 +#: library/http.client.rst:571 msgid "Here is an example session that uses the ``GET`` method::" msgstr "" -#: library/http.client.rst:597 +#: library/http.client.rst:596 msgid "" "Here is an example session that uses the ``HEAD`` method. Note that the " "``HEAD`` method never returns any data. ::" msgstr "" -#: library/http.client.rst:612 +#: library/http.client.rst:611 msgid "Here is an example session that uses the ``POST`` method::" msgstr "" -#: library/http.client.rst:628 +#: library/http.client.rst:627 msgid "" "Client side HTTP ``PUT`` requests are very similar to ``POST`` requests. The " "difference lies only on the server side where HTTP servers will allow " @@ -645,11 +646,11 @@ msgid "" "``PUT`` method::" msgstr "" -#: library/http.client.rst:649 +#: library/http.client.rst:648 msgid "HTTPMessage Objects" msgstr "" -#: library/http.client.rst:651 +#: library/http.client.rst:652 msgid "" "An :class:`http.client.HTTPMessage` instance holds the headers from an HTTP " "response. It is implemented using the :class:`email.message.Message` class." diff --git a/library/http.cookiejar.po b/library/http.cookiejar.po index 914939dab..791750ae1 100644 --- a/library/http.cookiejar.po +++ b/library/http.cookiejar.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -822,36 +822,40 @@ msgid "" msgstr "" #: library/http.cookiejar.rst:654 -msgid "Cookie path (a string, eg. ``'/acme/rocket_launchers'``)." +msgid "Cookie domain (a string)." msgstr "" #: library/http.cookiejar.rst:659 -msgid "``True`` if cookie should only be returned over a secure connection." +msgid "Cookie path (a string, eg. ``'/acme/rocket_launchers'``)." msgstr "" #: library/http.cookiejar.rst:664 +msgid "``True`` if cookie should only be returned over a secure connection." +msgstr "" + +#: library/http.cookiejar.rst:669 msgid "" "Integer expiry date in seconds since epoch, or :const:`None`. See also the :" "meth:`is_expired` method." msgstr "" -#: library/http.cookiejar.rst:670 +#: library/http.cookiejar.rst:675 msgid "``True`` if this is a session cookie." msgstr "" -#: library/http.cookiejar.rst:675 +#: library/http.cookiejar.rst:680 msgid "" "String comment from the server explaining the function of this cookie, or :" "const:`None`." msgstr "" -#: library/http.cookiejar.rst:681 +#: library/http.cookiejar.rst:686 msgid "" "URL linking to a comment from the server explaining the function of this " "cookie, or :const:`None`." msgstr "" -#: library/http.cookiejar.rst:687 +#: library/http.cookiejar.rst:692 msgid "" "``True`` if this cookie was received as an :rfc:`2109` cookie (ie. the " "cookie arrived in a :mailheader:`Set-Cookie` header, and the value of the " @@ -860,70 +864,70 @@ msgid "" "cookies, in which case :attr:`version` is 0." msgstr "" -#: library/http.cookiejar.rst:696 +#: library/http.cookiejar.rst:701 msgid "" "``True`` if a port or set of ports was explicitly specified by the server " "(in the :mailheader:`Set-Cookie` / :mailheader:`Set-Cookie2` header)." msgstr "" -#: library/http.cookiejar.rst:702 +#: library/http.cookiejar.rst:707 msgid "``True`` if a domain was explicitly specified by the server." msgstr "" -#: library/http.cookiejar.rst:707 +#: library/http.cookiejar.rst:712 msgid "" "``True`` if the domain explicitly specified by the server began with a dot " "(``'.'``)." msgstr "" -#: library/http.cookiejar.rst:710 +#: library/http.cookiejar.rst:715 msgid "" "Cookies may have additional non-standard cookie-attributes. These may be " "accessed using the following methods:" msgstr "" -#: library/http.cookiejar.rst:716 +#: library/http.cookiejar.rst:721 msgid "Return ``True`` if cookie has the named cookie-attribute." msgstr "" -#: library/http.cookiejar.rst:721 +#: library/http.cookiejar.rst:726 msgid "" "If cookie has the named cookie-attribute, return its value. Otherwise, " "return *default*." msgstr "" -#: library/http.cookiejar.rst:727 +#: library/http.cookiejar.rst:732 msgid "Set the value of the named cookie-attribute." msgstr "" -#: library/http.cookiejar.rst:729 +#: library/http.cookiejar.rst:734 msgid "The :class:`Cookie` class also defines the following method:" msgstr "" -#: library/http.cookiejar.rst:734 +#: library/http.cookiejar.rst:739 msgid "" "``True`` if cookie has passed the time at which the server requested it " "should expire. If *now* is given (in seconds since the epoch), return " "whether the cookie has expired at the specified time." msgstr "" -#: library/http.cookiejar.rst:740 +#: library/http.cookiejar.rst:745 msgid "Examples" msgstr "" -#: library/http.cookiejar.rst:742 +#: library/http.cookiejar.rst:747 msgid "" "The first example shows the most common usage of :mod:`http.cookiejar`::" msgstr "" -#: library/http.cookiejar.rst:749 +#: library/http.cookiejar.rst:754 msgid "" "This example illustrates how to open a URL using your Netscape, Mozilla, or " "Lynx cookies (assumes Unix/Netscape convention for location of the cookies " "file)::" msgstr "" -#: library/http.cookiejar.rst:758 +#: library/http.cookiejar.rst:763 msgid "" "The next example illustrates the use of :class:`DefaultCookiePolicy`. Turn " "on :rfc:`2965` cookies, be more strict about domains when setting and " diff --git a/library/http.server.po b/library/http.server.po index b10fdf6c7..801c85fc1 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -387,7 +387,7 @@ msgid "" msgstr "" #: library/http.server.rst:331 -msgid "The *directory* parameter." +msgid "Added the *directory* parameter." msgstr "" #: library/http.server.rst:334 @@ -525,11 +525,11 @@ msgid "" msgstr "" #: library/http.server.rst:441 -msgid "``--bind`` argument was introduced." +msgid "Added the ``--bind`` option." msgstr "" #: library/http.server.rst:444 -msgid "``--bind`` argument enhanced to support IPv6" +msgid "Support IPv6 in the ``--bind`` option." msgstr "" #: library/http.server.rst:447 @@ -540,7 +540,7 @@ msgid "" msgstr "" #: library/http.server.rst:453 -msgid "``--directory`` argument was introduced." +msgid "Added the ``--directory`` option." msgstr "" #: library/http.server.rst:456 @@ -551,7 +551,7 @@ msgid "" msgstr "" #: library/http.server.rst:462 -msgid "``--protocol`` argument was introduced." +msgid "Added the ``--protocol`` option." msgstr "" #: library/http.server.rst:467 diff --git a/library/idle.po b/library/idle.po index d0e46b58d..a1e1bce8b 100644 --- a/library/idle.po +++ b/library/idle.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -33,46 +33,42 @@ msgid "IDLE has the following features:" msgstr "" #: library/idle.rst:21 -msgid "coded in 100% pure Python, using the :mod:`tkinter` GUI toolkit" -msgstr "" - -#: library/idle.rst:23 msgid "cross-platform: works mostly the same on Windows, Unix, and macOS" msgstr "" -#: library/idle.rst:25 +#: library/idle.rst:23 msgid "" "Python shell window (interactive interpreter) with colorizing of code input, " "output, and error messages" msgstr "" -#: library/idle.rst:28 +#: library/idle.rst:26 msgid "" "multi-window text editor with multiple undo, Python colorizing, smart " "indent, call tips, auto completion, and other features" msgstr "" -#: library/idle.rst:31 +#: library/idle.rst:29 msgid "" "search within any window, replace within editor windows, and search through " "multiple files (grep)" msgstr "" -#: library/idle.rst:34 +#: library/idle.rst:32 msgid "" "debugger with persistent breakpoints, stepping, and viewing of global and " "local namespaces" msgstr "" -#: library/idle.rst:37 +#: library/idle.rst:35 msgid "configuration, browsers, and other dialogs" msgstr "" -#: library/idle.rst:40 +#: library/idle.rst:38 msgid "Menus" msgstr "" -#: library/idle.rst:42 +#: library/idle.rst:40 msgid "" "IDLE has two main window types, the Shell window and the Editor window. It " "is possible to have multiple editor windows simultaneously. On Windows and " @@ -80,81 +76,81 @@ msgid "" "which window type it is associated with." msgstr "" -#: library/idle.rst:47 +#: library/idle.rst:45 msgid "" "Output windows, such as used for Edit => Find in Files, are a subtype of " "editor window. They currently have the same top menu but a different " "default title and context menu." msgstr "" -#: library/idle.rst:51 +#: library/idle.rst:49 msgid "" "On macOS, there is one application menu. It dynamically changes according " "to the window currently selected. It has an IDLE menu, and some entries " "described below are moved around to conform to Apple guidelines." msgstr "" -#: library/idle.rst:56 +#: library/idle.rst:54 msgid "File menu (Shell and Editor)" msgstr "" -#: library/idle.rst:59 +#: library/idle.rst:57 msgid "New File" msgstr "" -#: library/idle.rst:59 +#: library/idle.rst:57 msgid "Create a new file editing window." msgstr "" -#: library/idle.rst:62 +#: library/idle.rst:60 msgid "Open..." msgstr "" -#: library/idle.rst:62 +#: library/idle.rst:60 msgid "Open an existing file with an Open dialog." msgstr "" -#: library/idle.rst:65 +#: library/idle.rst:63 msgid "Open Module..." msgstr "" -#: library/idle.rst:65 +#: library/idle.rst:63 msgid "Open an existing module (searches sys.path)." msgstr "" -#: library/idle.rst:68 +#: library/idle.rst:66 msgid "Recent Files" msgstr "" -#: library/idle.rst:68 +#: library/idle.rst:66 msgid "Open a list of recent files. Click one to open it." msgstr "" -#: library/idle.rst:76 +#: library/idle.rst:74 msgid "Module Browser" msgstr "" -#: library/idle.rst:75 +#: library/idle.rst:73 msgid "" "Show functions, classes, and methods in the current Editor file in a tree " "structure. In the shell, open a module first." msgstr "" -#: library/idle.rst:80 +#: library/idle.rst:78 msgid "Path Browser" msgstr "" -#: library/idle.rst:79 +#: library/idle.rst:77 msgid "" "Show sys.path directories, modules, functions, classes and methods in a tree " "structure." msgstr "" -#: library/idle.rst:86 +#: library/idle.rst:84 msgid "Save" msgstr "" -#: library/idle.rst:83 +#: library/idle.rst:81 msgid "" "Save the current window to the associated file, if there is one. Windows " "that have been changed since being opened or last saved have a \\* before " @@ -162,11 +158,11 @@ msgid "" "instead." msgstr "" -#: library/idle.rst:93 +#: library/idle.rst:91 msgid "Save As..." msgstr "" -#: library/idle.rst:89 +#: library/idle.rst:87 msgid "" "Save the current window with a Save As dialog. The file saved becomes the " "new associated file for the window. (If your file namager is set to hide " @@ -175,280 +171,280 @@ msgid "" "text files, except that on macOS Aqua,'.py' is added for all files.)" msgstr "" -#: library/idle.rst:97 +#: library/idle.rst:95 msgid "Save Copy As..." msgstr "" -#: library/idle.rst:96 +#: library/idle.rst:94 msgid "" "Save the current window to different file without changing the associated " "file. (See Save As note above about filename extensions.)" msgstr "" -#: library/idle.rst:100 +#: library/idle.rst:98 msgid "Print Window" msgstr "" -#: library/idle.rst:100 +#: library/idle.rst:98 msgid "Print the current window to the default printer." msgstr "" -#: library/idle.rst:105 +#: library/idle.rst:103 msgid "Close Window" msgstr "" -#: library/idle.rst:103 +#: library/idle.rst:101 msgid "" "Close the current window (if an unsaved editor, ask to save; if an unsaved " "Shell, ask to quit execution). Calling ``exit()`` or ``close()`` in the " "Shell window also closes Shell. If this is the only window, also exit IDLE." msgstr "" -#: library/idle.rst:108 +#: library/idle.rst:106 msgid "Exit IDLE" msgstr "" -#: library/idle.rst:108 +#: library/idle.rst:106 msgid "Close all windows and quit IDLE (ask to save unsaved edit windows)." msgstr "" -#: library/idle.rst:111 +#: library/idle.rst:109 msgid "Edit menu (Shell and Editor)" msgstr "" -#: library/idle.rst:115 +#: library/idle.rst:113 msgid "Undo" msgstr "" -#: library/idle.rst:114 +#: library/idle.rst:112 msgid "" "Undo the last change to the current window. A maximum of 1000 changes may " "be undone." msgstr "" -#: library/idle.rst:118 +#: library/idle.rst:116 msgid "Redo" msgstr "" -#: library/idle.rst:118 +#: library/idle.rst:116 msgid "Redo the last undone change to the current window." msgstr "" -#: library/idle.rst:121 +#: library/idle.rst:119 msgid "Select All" msgstr "" -#: library/idle.rst:121 +#: library/idle.rst:119 msgid "Select the entire contents of the current window." msgstr "" -#: library/idle.rst:370 library/idle.rst:355 +#: library/idle.rst:353 library/idle.rst:368 msgid "Cut" msgstr "" -#: library/idle.rst:370 +#: library/idle.rst:368 msgid "" "Copy selection into the system-wide clipboard; then delete the selection." msgstr "" -#: library/idle.rst:373 library/idle.rst:355 +#: library/idle.rst:353 library/idle.rst:371 msgid "Copy" msgstr "" -#: library/idle.rst:373 +#: library/idle.rst:371 msgid "Copy selection into the system-wide clipboard." msgstr "" -#: library/idle.rst:376 library/idle.rst:355 +#: library/idle.rst:353 library/idle.rst:374 msgid "Paste" msgstr "" -#: library/idle.rst:376 +#: library/idle.rst:374 msgid "Insert contents of the system-wide clipboard into the current window." msgstr "" -#: library/idle.rst:132 +#: library/idle.rst:130 msgid "The clipboard functions are also available in context menus." msgstr "" -#: library/idle.rst:135 +#: library/idle.rst:133 msgid "Find..." msgstr "" -#: library/idle.rst:135 +#: library/idle.rst:133 msgid "Open a search dialog with many options" msgstr "" -#: library/idle.rst:138 +#: library/idle.rst:136 msgid "Find Again" msgstr "" -#: library/idle.rst:138 +#: library/idle.rst:136 msgid "Repeat the last search, if there is one." msgstr "" -#: library/idle.rst:141 +#: library/idle.rst:139 msgid "Find Selection" msgstr "" -#: library/idle.rst:141 +#: library/idle.rst:139 msgid "Search for the currently selected string, if there is one." msgstr "" -#: library/idle.rst:144 +#: library/idle.rst:142 msgid "Find in Files..." msgstr "" -#: library/idle.rst:144 +#: library/idle.rst:142 msgid "Open a file search dialog. Put results in a new output window." msgstr "" -#: library/idle.rst:147 +#: library/idle.rst:145 msgid "Replace..." msgstr "" -#: library/idle.rst:147 +#: library/idle.rst:145 msgid "Open a search-and-replace dialog." msgstr "" -#: library/idle.rst:152 +#: library/idle.rst:150 msgid "Go to Line" msgstr "" -#: library/idle.rst:150 +#: library/idle.rst:148 msgid "" "Move the cursor to the beginning of the line requested and make that line " "visible. A request past the end of the file goes to the end. Clear any " "selection and update the line and column status." msgstr "" -#: library/idle.rst:156 +#: library/idle.rst:154 msgid "Show Completions" msgstr "" -#: library/idle.rst:155 +#: library/idle.rst:153 msgid "" "Open a scrollable list allowing selection of existing names. See :ref:" "`Completions ` in the Editing and navigation section below." msgstr "" -#: library/idle.rst:160 +#: library/idle.rst:158 msgid "Expand Word" msgstr "" -#: library/idle.rst:159 +#: library/idle.rst:157 msgid "" "Expand a prefix you have typed to match a full word in the same window; " "repeat to get a different expansion." msgstr "" -#: library/idle.rst:165 +#: library/idle.rst:163 msgid "Show Call Tip" msgstr "" -#: library/idle.rst:163 +#: library/idle.rst:161 msgid "" "After an unclosed parenthesis for a function, open a small window with " "function parameter hints. See :ref:`Calltips ` in the Editing and " "navigation section below." msgstr "" -#: library/idle.rst:168 +#: library/idle.rst:166 msgid "Show Surrounding Parens" msgstr "" -#: library/idle.rst:168 +#: library/idle.rst:166 msgid "Highlight the surrounding parenthesis." msgstr "" -#: library/idle.rst:173 +#: library/idle.rst:171 msgid "Format menu (Editor window only)" msgstr "" -#: library/idle.rst:178 +#: library/idle.rst:176 msgid "Format Paragraph" msgstr "" -#: library/idle.rst:176 +#: library/idle.rst:174 msgid "" "Reformat the current blank-line-delimited paragraph in comment block or " "multiline string or selected line in a string. All lines in the paragraph " "will be formatted to less than N columns, where N defaults to 72." msgstr "" -#: library/idle.rst:181 +#: library/idle.rst:179 msgid "Indent Region" msgstr "" -#: library/idle.rst:181 +#: library/idle.rst:179 msgid "Shift selected lines right by the indent width (default 4 spaces)." msgstr "" -#: library/idle.rst:184 +#: library/idle.rst:182 msgid "Dedent Region" msgstr "" -#: library/idle.rst:184 +#: library/idle.rst:182 msgid "Shift selected lines left by the indent width (default 4 spaces)." msgstr "" -#: library/idle.rst:187 +#: library/idle.rst:185 msgid "Comment Out Region" msgstr "" -#: library/idle.rst:187 +#: library/idle.rst:185 msgid "Insert ## in front of selected lines." msgstr "" -#: library/idle.rst:190 +#: library/idle.rst:188 msgid "Uncomment Region" msgstr "" -#: library/idle.rst:190 +#: library/idle.rst:188 msgid "Remove leading # or ## from selected lines." msgstr "" -#: library/idle.rst:194 +#: library/idle.rst:192 msgid "Tabify Region" msgstr "" -#: library/idle.rst:193 +#: library/idle.rst:191 msgid "" "Turn *leading* stretches of spaces into tabs. (Note: We recommend using 4 " "space blocks to indent Python code.)" msgstr "" -#: library/idle.rst:197 +#: library/idle.rst:195 msgid "Untabify Region" msgstr "" -#: library/idle.rst:197 +#: library/idle.rst:195 msgid "Turn *all* tabs into the correct number of spaces." msgstr "" -#: library/idle.rst:200 +#: library/idle.rst:198 msgid "Toggle Tabs" msgstr "" -#: library/idle.rst:200 +#: library/idle.rst:198 msgid "Open a dialog to switch between indenting with spaces and tabs." msgstr "" -#: library/idle.rst:204 +#: library/idle.rst:202 msgid "New Indent Width" msgstr "" -#: library/idle.rst:203 +#: library/idle.rst:201 msgid "" "Open a dialog to change indent width. The accepted default by the Python " "community is 4 spaces." msgstr "" -#: library/idle.rst:210 +#: library/idle.rst:208 msgid "Strip Trailing Chitespace" msgstr "" -#: library/idle.rst:207 +#: library/idle.rst:205 msgid "" "Remove trailing space and other whitespace characters after the last non-" "whitespace character of a line by applying str.rstrip to each line, " @@ -456,15 +452,15 @@ msgid "" "extra newlines at the end of the file." msgstr "" -#: library/idle.rst:216 +#: library/idle.rst:214 msgid "Run menu (Editor window only)" msgstr "" -#: library/idle.rst:227 +#: library/idle.rst:225 msgid "Run Module" msgstr "" -#: library/idle.rst:221 +#: library/idle.rst:219 msgid "" "Do :ref:`Check Module `. If no error, restart the shell to " "clean the environment, then execute the module. Output is displayed in the " @@ -474,22 +470,22 @@ msgid "" "similar to executing a file with ``python -i file`` at a command line." msgstr "" -#: library/idle.rst:234 +#: library/idle.rst:232 msgid "Run... Customized" msgstr "" -#: library/idle.rst:232 +#: library/idle.rst:230 msgid "" "Same as :ref:`Run Module `, but run the module with customized " "settings. *Command Line Arguments* extend :data:`sys.argv` as if passed on " "a command line. The module can be run in the Shell without restarting." msgstr "" -#: library/idle.rst:243 +#: library/idle.rst:241 msgid "Check Module" msgstr "" -#: library/idle.rst:239 +#: library/idle.rst:237 msgid "" "Check the syntax of the module currently open in the Editor window. If the " "module has not been saved IDLE will either prompt the user to save or " @@ -498,70 +494,70 @@ msgid "" "window." msgstr "" -#: library/idle.rst:249 +#: library/idle.rst:247 msgid "Python Shell" msgstr "" -#: library/idle.rst:248 +#: library/idle.rst:246 msgid "Open or wake up the Python Shell window." msgstr "" -#: library/idle.rst:252 +#: library/idle.rst:250 msgid "Shell menu (Shell window only)" msgstr "" -#: library/idle.rst:255 +#: library/idle.rst:253 msgid "View Last Restart" msgstr "" -#: library/idle.rst:255 +#: library/idle.rst:253 msgid "Scroll the shell window to the last Shell restart." msgstr "" -#: library/idle.rst:258 +#: library/idle.rst:256 msgid "Restart Shell" msgstr "" -#: library/idle.rst:258 +#: library/idle.rst:256 msgid "" "Restart the shell to clean the environment and reset display and exception " "handling." msgstr "" -#: library/idle.rst:261 +#: library/idle.rst:259 msgid "Previous History" msgstr "" -#: library/idle.rst:261 +#: library/idle.rst:259 msgid "" "Cycle through earlier commands in history which match the current entry." msgstr "" -#: library/idle.rst:264 +#: library/idle.rst:262 msgid "Next History" msgstr "" -#: library/idle.rst:264 +#: library/idle.rst:262 msgid "Cycle through later commands in history which match the current entry." msgstr "" -#: library/idle.rst:267 +#: library/idle.rst:265 msgid "Interrupt Execution" msgstr "" -#: library/idle.rst:267 +#: library/idle.rst:265 msgid "Stop a running program." msgstr "" -#: library/idle.rst:270 +#: library/idle.rst:268 msgid "Debug menu (Shell window only)" msgstr "" -#: library/idle.rst:277 +#: library/idle.rst:275 msgid "Go to File/Line" msgstr "" -#: library/idle.rst:273 +#: library/idle.rst:271 msgid "" "Look on the current line. with the cursor, and the line above for a filename " "and line number. If found, open the file if not already open, and show the " @@ -570,45 +566,45 @@ msgid "" "Shell window and Output windows." msgstr "" -#: library/idle.rst:286 +#: library/idle.rst:284 msgid "Debugger (toggle)" msgstr "" -#: library/idle.rst:284 +#: library/idle.rst:282 msgid "" "When activated, code entered in the Shell or run from an Editor will run " "under the debugger. In the Editor, breakpoints can be set with the context " "menu. This feature is still incomplete and somewhat experimental." msgstr "" -#: library/idle.rst:290 +#: library/idle.rst:288 msgid "Stack Viewer" msgstr "" -#: library/idle.rst:289 +#: library/idle.rst:287 msgid "" "Show the stack traceback of the last exception in a tree widget, with access " "to locals and globals." msgstr "" -#: library/idle.rst:293 +#: library/idle.rst:291 msgid "Auto-open Stack Viewer" msgstr "" -#: library/idle.rst:293 +#: library/idle.rst:291 msgid "" "Toggle automatically opening the stack viewer on an unhandled exception." msgstr "" -#: library/idle.rst:296 +#: library/idle.rst:294 msgid "Options menu (Shell and Editor)" msgstr "" -#: library/idle.rst:304 +#: library/idle.rst:302 msgid "Configure IDLE" msgstr "" -#: library/idle.rst:299 +#: library/idle.rst:297 msgid "" "Open a configuration dialog and change preferences for the following: fonts, " "indentation, keybindings, text color themes, startup windows and size, " @@ -617,39 +613,39 @@ msgid "" "see :ref:`Setting preferences ` under Help and preferences." msgstr "" -#: library/idle.rst:306 +#: library/idle.rst:304 msgid "" "Most configuration options apply to all windows or all future windows. The " "option items below only apply to the active window." msgstr "" -#: library/idle.rst:313 +#: library/idle.rst:311 msgid "Show/Hide Code Context (Editor Window only)" msgstr "" -#: library/idle.rst:310 +#: library/idle.rst:308 msgid "" "Open a pane at the top of the edit window which shows the block context of " "the code which has scrolled above the top of the window. See :ref:`Code " "Context ` in the Editing and Navigation section below." msgstr "" -#: library/idle.rst:318 +#: library/idle.rst:316 msgid "Show/Hide Line Numbers (Editor Window only)" msgstr "" -#: library/idle.rst:316 +#: library/idle.rst:314 msgid "" "Open a column to the left of the edit window which shows the number of each " "line of text. The default is off, which may be changed in the preferences " "(see :ref:`Setting preferences `)." msgstr "" -#: library/idle.rst:326 +#: library/idle.rst:324 msgid "Zoom/Restore Height" msgstr "" -#: library/idle.rst:321 +#: library/idle.rst:319 msgid "" "Toggles the window between normal size and maximum height. The initial size " "defaults to 40 lines by 80 chars unless changed on the General tab of the " @@ -659,74 +655,74 @@ msgid "" "no effect when a window is maximized." msgstr "" -#: library/idle.rst:329 +#: library/idle.rst:327 msgid "Window menu (Shell and Editor)" msgstr "" -#: library/idle.rst:331 +#: library/idle.rst:329 msgid "" "Lists the names of all open windows; select one to bring it to the " "foreground (deiconifying it if necessary)." msgstr "" -#: library/idle.rst:335 +#: library/idle.rst:333 msgid "Help menu (Shell and Editor)" msgstr "" -#: library/idle.rst:338 +#: library/idle.rst:336 msgid "About IDLE" msgstr "" -#: library/idle.rst:338 +#: library/idle.rst:336 msgid "Display version, copyright, license, credits, and more." msgstr "" -#: library/idle.rst:342 +#: library/idle.rst:340 msgid "IDLE Help" msgstr "" -#: library/idle.rst:341 +#: library/idle.rst:339 msgid "" "Display this IDLE document, detailing the menu options, basic editing and " "navigation, and other tips." msgstr "" -#: library/idle.rst:346 +#: library/idle.rst:344 msgid "Python Docs" msgstr "" -#: library/idle.rst:345 +#: library/idle.rst:343 msgid "" "Access local Python documentation, if installed, or start a web browser and " "open docs.python.org showing the latest Python documentation." msgstr "" -#: library/idle.rst:349 +#: library/idle.rst:347 msgid "Turtle Demo" msgstr "" -#: library/idle.rst:349 +#: library/idle.rst:347 msgid "Run the turtledemo module with example Python code and turtle drawings." msgstr "" -#: library/idle.rst:351 +#: library/idle.rst:349 msgid "" "Additional help sources may be added here with the Configure IDLE dialog " "under the General tab. See the :ref:`Help sources ` subsection " "below for more on Help menu choices." msgstr "" -#: library/idle.rst:364 +#: library/idle.rst:362 msgid "Context menus" msgstr "" -#: library/idle.rst:366 +#: library/idle.rst:364 msgid "" "Open a context menu by right-clicking in a window (Control-click on macOS). " "Context menus have the standard clipboard functions also on the Edit menu." msgstr "" -#: library/idle.rst:378 +#: library/idle.rst:376 msgid "" "Editor windows also have breakpoint functions. Lines with a breakpoint set " "are specially marked. Breakpoints only have an effect when running under " @@ -734,66 +730,66 @@ msgid "" "directory." msgstr "" -#: library/idle.rst:355 +#: library/idle.rst:382 msgid "Set Breakpoint" msgstr "" -#: library/idle.rst:384 +#: library/idle.rst:382 msgid "Set a breakpoint on the current line." msgstr "" -#: library/idle.rst:355 +#: library/idle.rst:385 msgid "Clear Breakpoint" msgstr "" -#: library/idle.rst:387 +#: library/idle.rst:385 msgid "Clear the breakpoint on that line." msgstr "" -#: library/idle.rst:389 +#: library/idle.rst:387 msgid "Shell and Output windows also have the following." msgstr "" -#: library/idle.rst:392 +#: library/idle.rst:390 msgid "Go to file/line" msgstr "" -#: library/idle.rst:392 +#: library/idle.rst:390 msgid "Same as in Debug menu." msgstr "" -#: library/idle.rst:394 +#: library/idle.rst:392 msgid "" "The Shell window also has an output squeezing facility explained in the " "*Python Shell window* subsection below." msgstr "" -#: library/idle.rst:400 +#: library/idle.rst:398 msgid "Squeeze" msgstr "" -#: library/idle.rst:398 +#: library/idle.rst:396 msgid "" "If the cursor is over an output line, squeeze all the output between the " "code above and the prompt below down to a 'Squeezed text' label." msgstr "" -#: library/idle.rst:405 +#: library/idle.rst:403 msgid "Editing and Navigation" msgstr "" -#: library/idle.rst:408 +#: library/idle.rst:406 msgid "Editor windows" msgstr "" -#: library/idle.rst:410 +#: library/idle.rst:408 msgid "" "IDLE may open editor windows when it starts, depending on settings and how " "you start IDLE. Thereafter, use the File menu. There can be only one open " "editor window for a given file." msgstr "" -#: library/idle.rst:414 +#: library/idle.rst:412 msgid "" "The title bar contains the name of the file, the full path, and the version " "of Python and IDLE running the window. The status bar contains the line " @@ -801,99 +797,79 @@ msgid "" "numbers with 0." msgstr "" -#: library/idle.rst:419 +#: library/idle.rst:417 msgid "" "IDLE assumes that files with a known .py* extension contain Python code and " "that other files do not. Run Python code with the Run menu." msgstr "" -#: library/idle.rst:423 +#: library/idle.rst:421 msgid "Key bindings" msgstr "" -#: library/idle.rst:425 +#: library/idle.rst:423 msgid "" -"In this section, 'C' refers to the :kbd:`Control` key on Windows and Unix " -"and the :kbd:`Command` key on macOS." +"The IDLE insertion cursor is a thin vertical bar between character " +"positions. When characters are entered, the insertion cursor and everything " +"to its right moves right one character and the new character is entered in " +"the new space." msgstr "" #: library/idle.rst:428 -msgid ":kbd:`Backspace` deletes to the left; :kbd:`Del` deletes to the right" -msgstr "" - -#: library/idle.rst:430 msgid "" -":kbd:`C-Backspace` delete word left; :kbd:`C-Del` delete word to the right" -msgstr "" - -#: library/idle.rst:432 -msgid "Arrow keys and :kbd:`Page Up`/:kbd:`Page Down` to move around" +"Several non-character keys move the cursor and possibly delete characters. " +"Deletion does not puts text on the clipboard, but IDLE has an undo list. " +"Wherever this doc discusses keys, 'C' refers to the :kbd:`Control` key on " +"Windows and Unix and the :kbd:`Command` key on macOS. (And all such " +"dicussions assume that the keys have not been re-bound to something else.)" msgstr "" -#: library/idle.rst:434 -msgid ":kbd:`C-LeftArrow` and :kbd:`C-RightArrow` moves by words" +#: library/idle.rst:435 +msgid "Arrow keys move the cursor one character or line." msgstr "" -#: library/idle.rst:436 -msgid ":kbd:`Home`/:kbd:`End` go to begin/end of line" -msgstr "" - -#: library/idle.rst:438 -msgid ":kbd:`C-Home`/:kbd:`C-End` go to begin/end of file" +#: library/idle.rst:437 +msgid "" +":kbd:`C-LeftArrow` and :kbd:`C-RightArrow` moves left or right one word." msgstr "" -#: library/idle.rst:440 -msgid "Some useful Emacs bindings are inherited from Tcl/Tk:" +#: library/idle.rst:439 +msgid ":kbd:`Home` and :kbd:`End` go to the beginning or end of the line." msgstr "" -#: library/idle.rst:442 -msgid ":kbd:`C-a` beginning of line" +#: library/idle.rst:441 +msgid ":kbd:`Page Up` and :kbd:`Page Down` go up or down one screen." msgstr "" -#: library/idle.rst:444 -msgid ":kbd:`C-e` end of line" +#: library/idle.rst:443 +msgid ":kbd:`C-Home` and :kbd:`C-End` go to beginning or end of the file." msgstr "" -#: library/idle.rst:446 -msgid ":kbd:`C-k` kill line (but doesn't put it in clipboard)" +#: library/idle.rst:445 +msgid "" +":kbd:`Backspace` and :kbd:`Del` (or :kbd:`C-d`) delete the previous or next " +"character." msgstr "" #: library/idle.rst:448 -msgid ":kbd:`C-l` center window around the insertion point" +msgid ":kbd:`C-Backspace` and :kbd:`C-Del` delete one word left or right." msgstr "" #: library/idle.rst:450 -msgid "" -":kbd:`C-b` go backward one character without deleting (usually you can also " -"use the cursor key for this)" +msgid ":kbd:`C-k` deletes ('kills') everything to the right." msgstr "" -#: library/idle.rst:453 -msgid "" -":kbd:`C-f` go forward one character without deleting (usually you can also " -"use the cursor key for this)" -msgstr "" - -#: library/idle.rst:456 -msgid "" -":kbd:`C-p` go up one line (usually you can also use the cursor key for this)" -msgstr "" - -#: library/idle.rst:459 -msgid ":kbd:`C-d` delete next character" -msgstr "" - -#: library/idle.rst:461 +#: library/idle.rst:452 msgid "" "Standard keybindings (like :kbd:`C-c` to copy and :kbd:`C-v` to paste) may " "work. Keybindings are selected in the Configure IDLE dialog." msgstr "" -#: library/idle.rst:465 +#: library/idle.rst:456 msgid "Automatic indentation" msgstr "" -#: library/idle.rst:467 +#: library/idle.rst:458 msgid "" "After a block-opening statement, the next line is indented by 4 spaces (in " "the Python Shell window by one tab). After certain keywords (break, return " @@ -903,17 +879,17 @@ msgid "" "tabs are restricted to four spaces due to Tcl/Tk limitations." msgstr "" -#: library/idle.rst:474 +#: library/idle.rst:465 msgid "" "See also the indent/dedent region commands on the :ref:`Format menu `." msgstr "" -#: library/idle.rst:478 +#: library/idle.rst:469 msgid "Search and Replace" msgstr "" -#: library/idle.rst:480 +#: library/idle.rst:471 msgid "" "Any selection becomes a search target. However, only selections within a " "line work because searches are only performed within lines with the terminal " @@ -921,11 +897,11 @@ msgid "" "interpreted according to the Python re module." msgstr "" -#: library/idle.rst:488 +#: library/idle.rst:479 msgid "Completions" msgstr "" -#: library/idle.rst:490 +#: library/idle.rst:481 msgid "" "Completions are supplied, when requested and available, for module names, " "attributes of classes or functions, or filenames. Each request method " @@ -938,7 +914,7 @@ msgid "" "box. A double click within the box selects and closes." msgstr "" -#: library/idle.rst:501 +#: library/idle.rst:492 msgid "" "One way to open a box is to type a key character and wait for a predefined " "interval. This defaults to 2 seconds; customize it in the settings dialog. " @@ -950,7 +926,7 @@ msgid "" "directory name and a separator." msgstr "" -#: library/idle.rst:511 +#: library/idle.rst:502 msgid "" "Instead of waiting, or after a box is closed, open a completion box " "immediately with Show Completions on the Edit menu. The default hot key is :" @@ -961,7 +937,7 @@ msgid "" "directory." msgstr "" -#: library/idle.rst:519 +#: library/idle.rst:510 msgid "" "Hitting :kbd:`Tab` after a prefix usually has the same effect as Show " "Completions. (With no prefix, it indents.) However, if there is only one " @@ -969,14 +945,14 @@ msgid "" "without opening a box." msgstr "" -#: library/idle.rst:524 +#: library/idle.rst:515 msgid "" "Invoking 'Show Completions', or hitting :kbd:`Tab` after a prefix, outside " "of a string and without a preceding '.' opens a box with keywords, builtin " "names, and available module-level names." msgstr "" -#: library/idle.rst:528 +#: library/idle.rst:519 msgid "" "When editing code in an editor (as oppose to Shell), increase the available " "module-level names by running your code and not restarting the Shell " @@ -984,18 +960,18 @@ msgid "" "file. This also increases possible attribute completions." msgstr "" -#: library/idle.rst:534 +#: library/idle.rst:525 msgid "" "Completion boxes initially exclude names beginning with '_' or, for modules, " "not included in '__all__'. The hidden names can be accessed by typing '_' " "after '.', either before or after the box is opened." msgstr "" -#: library/idle.rst:541 +#: library/idle.rst:532 msgid "Calltips" msgstr "" -#: library/idle.rst:543 +#: library/idle.rst:534 msgid "" "A calltip is shown automatically when one types :kbd:`(` after the name of " "an *accessible* function. A function name expression may include dots and " @@ -1005,7 +981,7 @@ msgid "" "or enter its shortcut to display a calltip." msgstr "" -#: library/idle.rst:550 +#: library/idle.rst:541 msgid "" "The calltip consists of the function's signature and docstring up to the " "latter's first blank line or the fifth non-blank line. (Some builtin " @@ -1014,14 +990,14 @@ msgid "" "or name (keyword) only. Details are subject to change." msgstr "" -#: library/idle.rst:556 +#: library/idle.rst:547 msgid "" "In Shell, the accessible functions depends on what modules have been " "imported into the user process, including those imported by Idle itself, and " "which definitions have been run, all since the last restart." msgstr "" -#: library/idle.rst:560 +#: library/idle.rst:551 msgid "" "For example, restart the Shell and enter ``itertools.count(``. A calltip " "appears because Idle imports itertools into the user process for its own " @@ -1031,18 +1007,18 @@ msgid "" "display a calltip." msgstr "" -#: library/idle.rst:567 +#: library/idle.rst:558 msgid "" "In an editor, import statements have no effect until one runs the file. One " "might want to run a file after writing import statements, after adding " "function definitions, or after opening an existing file." msgstr "" -#: library/idle.rst:574 +#: library/idle.rst:565 msgid "Code Context" msgstr "" -#: library/idle.rst:576 +#: library/idle.rst:567 msgid "" "Within an editor window containing Python code, code context can be toggled " "in order to show or hide a pane at the top of the window. When shown, this " @@ -1056,23 +1032,23 @@ msgid "" "the top of the editor." msgstr "" -#: library/idle.rst:587 +#: library/idle.rst:578 msgid "" "The text and background colors for the context pane can be configured under " "the Highlights tab in the Configure IDLE dialog." msgstr "" -#: library/idle.rst:591 +#: library/idle.rst:582 msgid "Shell window" msgstr "" -#: library/idle.rst:593 +#: library/idle.rst:584 msgid "" "In IDLE's Shell, enter, edit, and recall complete statements. (Most consoles " "and terminals only work with a single physical line at a time)." msgstr "" -#: library/idle.rst:596 +#: library/idle.rst:587 msgid "" "Submit a single-line statement for execution by hitting :kbd:`Return` with " "the cursor anywhere on the line. If a line is extended with Backslash (:kbd:" @@ -1080,7 +1056,7 @@ msgid "" "compound statement by entering a blank line after the statement." msgstr "" -#: library/idle.rst:602 +#: library/idle.rst:593 msgid "" "When one pastes code into Shell, it is not compiled and possibly executed " "until one hits :kbd:`Return`, as specified above. One may edit pasted code " @@ -1089,7 +1065,7 @@ msgid "" "one." msgstr "" -#: library/idle.rst:608 +#: library/idle.rst:599 msgid "" "Lines containing ``RESTART`` mean that the user execution process has been " "re-started. This occurs when the user execution process has crashed, when " @@ -1097,50 +1073,38 @@ msgid "" "window." msgstr "" -#: library/idle.rst:613 +#: library/idle.rst:604 msgid "" "The editing features described in previous subsections work when entering " -"code interactively. IDLE's Shell window also responds to the following keys." -msgstr "" - -#: library/idle.rst:616 -msgid ":kbd:`C-c` interrupts executing command" +"code interactively. IDLE's Shell window also responds to the following:" msgstr "" -#: library/idle.rst:618 -msgid "" -":kbd:`C-d` sends end-of-file; closes window if typed at a ``>>>`` prompt" +#: library/idle.rst:607 +msgid ":kbd:`C-c` attemps to interrupt statement execution (but may fail)." msgstr "" -#: library/idle.rst:620 -msgid ":kbd:`Alt-/` (Expand word) is also useful to reduce typing" +#: library/idle.rst:609 +msgid ":kbd:`C-d` closes Shell if typed at a ``>>>`` prompt." msgstr "" -#: library/idle.rst:622 -msgid "Command history" -msgstr "" - -#: library/idle.rst:624 +#: library/idle.rst:611 msgid "" -":kbd:`Alt-p` retrieves previous command matching what you have typed. On " -"macOS use :kbd:`C-p`." -msgstr "" - -#: library/idle.rst:627 -msgid ":kbd:`Alt-n` retrieves next. On macOS use :kbd:`C-n`." +":kbd:`Alt-p` and :kbd:`Alt-n` (:kbd:`C-p` and :kbd:`C-n` on macOS) retrieve " +"to the current prompt the previous or next previously entered statement that " +"matches anything already typed." msgstr "" -#: library/idle.rst:629 +#: library/idle.rst:615 msgid "" -":kbd:`Return` while the cursor is on any previous command retrieves that " -"command" +":kbd:`Return` while the cursor is on any previous statement appends the " +"latter to anything already typed at the prompt." msgstr "" -#: library/idle.rst:633 +#: library/idle.rst:619 msgid "Text colors" msgstr "" -#: library/idle.rst:635 +#: library/idle.rst:621 msgid "" "Idle defaults to black on white text, but colors text with special meanings. " "For the shell, these are shell output, shell error, user output, and user " @@ -1150,7 +1114,7 @@ msgid "" "(when present), found text (when possible), and selected text." msgstr "" -#: library/idle.rst:642 +#: library/idle.rst:628 msgid "" "IDLE also highlights the :ref:`soft keywords ` :keyword:" "`match`, :keyword:`case `, and :keyword:`_ ` in " @@ -1159,7 +1123,7 @@ msgid "" "patterns." msgstr "" -#: library/idle.rst:648 +#: library/idle.rst:634 msgid "" "Text coloring is done in the background, so uncolorized text is occasionally " "visible. To change the color scheme, use the Configure IDLE dialog " @@ -1167,11 +1131,11 @@ msgid "" "and text in popups and dialogs is not user-configurable." msgstr "" -#: library/idle.rst:655 +#: library/idle.rst:641 msgid "Startup and Code Execution" msgstr "" -#: library/idle.rst:657 +#: library/idle.rst:643 msgid "" "Upon startup with the ``-s`` option, IDLE will execute the file referenced " "by the environment variables :envvar:`IDLESTARTUP` or :envvar:" @@ -1183,7 +1147,7 @@ msgid "" "modules." msgstr "" -#: library/idle.rst:665 +#: library/idle.rst:651 msgid "" "In addition, ``Tk`` also loads a startup file if it is present. Note that " "the Tk file is loaded unconditionally. This additional file is ``.Idle.py`` " @@ -1192,15 +1156,15 @@ msgid "" "importing functions to be used from IDLE's Python shell." msgstr "" -#: library/idle.rst:672 +#: library/idle.rst:658 msgid "Command line usage" msgstr "" -#: library/idle.rst:688 +#: library/idle.rst:674 msgid "If there are arguments:" msgstr "" -#: library/idle.rst:690 +#: library/idle.rst:676 msgid "" "If ``-``, ``-c``, or ``r`` is used, all arguments are placed in ``sys." "argv[1:...]`` and ``sys.argv[0]`` is set to ``''``, ``'-c'``, or ``'-r'``. " @@ -1208,17 +1172,17 @@ msgid "" "dialog." msgstr "" -#: library/idle.rst:695 +#: library/idle.rst:681 msgid "" "Otherwise, arguments are files opened for editing and ``sys.argv`` reflects " "the arguments passed to IDLE itself." msgstr "" -#: library/idle.rst:699 +#: library/idle.rst:685 msgid "Startup failure" msgstr "" -#: library/idle.rst:701 +#: library/idle.rst:687 msgid "" "IDLE uses a socket to communicate between the IDLE GUI process and the user " "code execution process. A connection must be established whenever the Shell " @@ -1228,7 +1192,7 @@ msgid "" "directs the user here. It then exits." msgstr "" -#: library/idle.rst:708 +#: library/idle.rst:694 msgid "" "One specific connection failure on Unix systems results from misconfigured " "masquerading rules somewhere in a system's network setup. When IDLE is " @@ -1238,7 +1202,7 @@ msgid "" "``tcplisten `` in another." msgstr "" -#: library/idle.rst:716 +#: library/idle.rst:702 msgid "" "A common cause of failure is a user-written file with the same name as a " "standard library module, such as *random.py* and *tkinter.py*. When such a " @@ -1247,7 +1211,7 @@ msgid "" "file." msgstr "" -#: library/idle.rst:722 +#: library/idle.rst:708 msgid "" "Though less common than in the past, an antivirus or firewall program may " "stop the connection. If the program cannot be taught to allow the " @@ -1257,7 +1221,7 @@ msgid "" "connections." msgstr "" -#: library/idle.rst:729 +#: library/idle.rst:715 msgid "" "Python installation issues occasionally stop IDLE: multiple versions can " "clash, or a single installation might need admin access. If one undo the " @@ -1265,7 +1229,7 @@ msgid "" "completely remove Python and start over." msgstr "" -#: library/idle.rst:734 +#: library/idle.rst:720 msgid "" "A zombie pythonw.exe process could be a problem. On Windows, use Task " "Manager to check for one and stop it if there is. Sometimes a restart " @@ -1274,7 +1238,7 @@ msgid "" "may fix a temporary problem." msgstr "" -#: library/idle.rst:740 +#: library/idle.rst:726 msgid "" "When IDLE first starts, it attempts to read user configuration files in ``~/." "idlerc/`` (~ is one's home directory). If there is a problem, an error " @@ -1285,14 +1249,14 @@ msgid "" "with the settings dialog." msgstr "" -#: library/idle.rst:748 +#: library/idle.rst:734 msgid "" "If IDLE quits with no message, and it was not started from a console, try " "starting it from a console or terminal (``python -m idlelib``) and see if " "this results in an error message." msgstr "" -#: library/idle.rst:752 +#: library/idle.rst:738 msgid "" "On Unix-based systems with tcl/tk older than ``8.6.11`` (see ``About IDLE``) " "certain characters of certain fonts can cause a tk failure with a message to " @@ -1301,11 +1265,11 @@ msgid "" "upgrade tcl/tk, then re-configure IDLE to use a font that works better." msgstr "" -#: library/idle.rst:760 +#: library/idle.rst:746 msgid "Running user code" msgstr "" -#: library/idle.rst:762 +#: library/idle.rst:748 msgid "" "With rare exceptions, the result of executing Python code with IDLE is " "intended to be the same as executing the same code by the default method, " @@ -1315,7 +1279,7 @@ msgid "" "``threading.active_count()`` returns 2 instead of 1." msgstr "" -#: library/idle.rst:769 +#: library/idle.rst:755 msgid "" "By default, IDLE runs user code in a separate OS process rather than in the " "user interface process that runs the shell and editor. In the execution " @@ -1325,7 +1289,7 @@ msgid "" "__stderr__`` are not touched, but may be ``None``." msgstr "" -#: library/idle.rst:776 +#: library/idle.rst:762 msgid "" "Sending print output from one process to a text widget in another is slower " "than printing to a system terminal in the same process. This has the most " @@ -1337,7 +1301,7 @@ msgid "" "fields and lines." msgstr "" -#: library/idle.rst:785 +#: library/idle.rst:771 msgid "" "IDLE's standard stream replacements are not inherited by subprocesses " "created in the execution process, whether directly by user code or by " @@ -1348,14 +1312,14 @@ msgid "" "attached to that window for input and output." msgstr "" -#: library/idle.rst:794 +#: library/idle.rst:780 msgid "" "If ``sys`` is reset by user code, such as with ``importlib.reload(sys)``, " "IDLE's changes are lost and input from the keyboard and output to the screen " "will not work correctly." msgstr "" -#: library/idle.rst:798 +#: library/idle.rst:784 msgid "" "When Shell has the focus, it controls the keyboard and screen. This is " "normally transparent, but functions that directly access the keyboard and " @@ -1363,7 +1327,7 @@ msgid "" "determine whether a key has been pressed and if so, which." msgstr "" -#: library/idle.rst:803 +#: library/idle.rst:789 msgid "" "The IDLE code running in the execution process adds frames to the call stack " "that would not be there otherwise. IDLE wraps ``sys.getrecursionlimit`` and " @@ -1371,17 +1335,17 @@ msgid "" "frames." msgstr "" -#: library/idle.rst:808 +#: library/idle.rst:794 msgid "" "When user code raises SystemExit either directly or by calling sys.exit, " "IDLE returns to a Shell prompt instead of exiting." msgstr "" -#: library/idle.rst:812 +#: library/idle.rst:798 msgid "User output in Shell" msgstr "" -#: library/idle.rst:814 +#: library/idle.rst:800 msgid "" "When a program outputs text, the result is determined by the corresponding " "output device. When IDLE executes user code, ``sys.stdout`` and ``sys." @@ -1391,7 +1355,7 @@ msgid "" "rather than production runs." msgstr "" -#: library/idle.rst:821 +#: library/idle.rst:807 msgid "" "For instance, Shell never throws away output. A program that sends " "unlimited output to Shell will eventually fill memory, resulting in a memory " @@ -1400,7 +1364,7 @@ msgid "" "lines, with 300 the default." msgstr "" -#: library/idle.rst:827 +#: library/idle.rst:813 msgid "" "A Tk Text widget, and hence IDLE's Shell, displays characters (codepoints) " "in the BMP (Basic Multilingual Plane) subset of Unicode. Which characters " @@ -1414,7 +1378,7 @@ msgid "" "spacing behavior.) ::" msgstr "" -#: library/idle.rst:845 +#: library/idle.rst:831 msgid "" "The ``repr`` function is used for interactive echo of expression values. It " "returns an altered version of the input string in which control codes, some " @@ -1423,13 +1387,13 @@ msgid "" "regardless of how they are displayed." msgstr "" -#: library/idle.rst:851 +#: library/idle.rst:837 msgid "" "Normal and error output are generally kept separate (on separate lines) from " "code input and each other. They each get different highlight colors." msgstr "" -#: library/idle.rst:854 +#: library/idle.rst:840 msgid "" "For SyntaxError tracebacks, the normal '^' marking where the error was " "detected is replaced by coloring the text with an error highlight. When code " @@ -1438,7 +1402,7 @@ msgid "" "opened if necessary." msgstr "" -#: library/idle.rst:860 +#: library/idle.rst:846 msgid "" "Shell has a special facility for squeezing output lines down to a 'Squeezed " "text' label. This is done automatically for output over N lines (N = 50 by " @@ -1447,18 +1411,18 @@ msgid "" "on the output. This can be useful lines long enough to slow down scrolling." msgstr "" -#: library/idle.rst:868 +#: library/idle.rst:854 msgid "" "Squeezed output is expanded in place by double-clicking the label. It can " "also be sent to the clipboard or a separate view window by right-clicking " "the label." msgstr "" -#: library/idle.rst:873 +#: library/idle.rst:859 msgid "Developing tkinter applications" msgstr "" -#: library/idle.rst:875 +#: library/idle.rst:861 msgid "" "IDLE is intentionally different from standard Python in order to facilitate " "development of tkinter programs. Enter ``import tkinter as tk; root = tk." @@ -1470,7 +1434,7 @@ msgid "" "changes in standard Python until one enters ``root.update()``." msgstr "" -#: library/idle.rst:884 +#: library/idle.rst:870 msgid "" "Most tkinter programs run ``root.mainloop()``, which usually does not return " "until the tk app is destroyed. If the program is run with ``python -i`` or " @@ -1478,7 +1442,7 @@ msgid "" "``mainloop()`` returns, at which time there is nothing left to interact with." msgstr "" -#: library/idle.rst:890 +#: library/idle.rst:876 msgid "" "When running a tkinter program from an IDLE editor, one can comment out the " "mainloop call. One then gets a shell prompt immediately and can interact " @@ -1486,11 +1450,11 @@ msgid "" "mainloop call when running in standard Python." msgstr "" -#: library/idle.rst:896 +#: library/idle.rst:882 msgid "Running without a subprocess" msgstr "" -#: library/idle.rst:898 +#: library/idle.rst:884 msgid "" "By default, IDLE executes user code in a separate subprocess via a socket, " "which uses the internal loopback interface. This connection is not " @@ -1498,7 +1462,7 @@ msgid "" "firewall software complains anyway, you can ignore it." msgstr "" -#: library/idle.rst:903 +#: library/idle.rst:889 msgid "" "If the attempt to make the socket connection fails, Idle will notify you. " "Such failures are sometimes transient, but if persistent, the problem may be " @@ -1507,7 +1471,7 @@ msgid "" "command line switch." msgstr "" -#: library/idle.rst:909 +#: library/idle.rst:895 msgid "" "If IDLE is started with the -n command line switch it will run in a single " "process and will not create the subprocess which runs the RPC Python " @@ -1521,15 +1485,15 @@ msgid "" "at all possible." msgstr "" -#: library/idle.rst:924 +#: library/idle.rst:910 msgid "Help and Preferences" msgstr "" -#: library/idle.rst:929 +#: library/idle.rst:915 msgid "Help sources" msgstr "" -#: library/idle.rst:931 +#: library/idle.rst:917 msgid "" "Help menu entry \"IDLE Help\" displays a formatted html version of the IDLE " "chapter of the Library Reference. The result, in a read-only tkinter text " @@ -1539,7 +1503,7 @@ msgid "" "the opened box." msgstr "" -#: library/idle.rst:939 +#: library/idle.rst:925 msgid "" "Help menu entry \"Python Docs\" opens the extensive sources of help, " "including tutorials, available at ``docs.python.org/x.y``, where 'x.y' is " @@ -1548,17 +1512,17 @@ msgid "" "instead." msgstr "" -#: library/idle.rst:945 +#: library/idle.rst:931 msgid "" "Selected URLs can be added or removed from the help menu at any time using " "the General tab of the Configure IDLE dialog." msgstr "" -#: library/idle.rst:951 +#: library/idle.rst:937 msgid "Setting preferences" msgstr "" -#: library/idle.rst:953 +#: library/idle.rst:939 msgid "" "The font preferences, highlighting, keys, and general preferences can be " "changed via Configure IDLE on the Option menu. Non-default user settings are " @@ -1567,7 +1531,7 @@ msgid "" "or more of the files in ``.idlerc``." msgstr "" -#: library/idle.rst:959 +#: library/idle.rst:945 msgid "" "On the Font tab, see the text sample for the effect of font face and size on " "multiple characters in multiple languages. Edit the sample to add other " @@ -1576,7 +1540,7 @@ msgid "" "them to the top of the sample and try changing first size and then font." msgstr "" -#: library/idle.rst:966 +#: library/idle.rst:952 msgid "" "On the Highlights and Keys tab, select a built-in or custom color theme and " "key set. To use a newer built-in color theme or key set with older IDLEs, " @@ -1584,22 +1548,22 @@ msgid "" "IDLEs." msgstr "" -#: library/idle.rst:972 +#: library/idle.rst:958 msgid "IDLE on macOS" msgstr "" -#: library/idle.rst:974 +#: library/idle.rst:960 msgid "" "Under System Preferences: Dock, one can set \"Prefer tabs when opening " "documents\" to \"Always\". This setting is not compatible with the tk/" "tkinter GUI framework used by IDLE, and it breaks a few IDLE features." msgstr "" -#: library/idle.rst:979 +#: library/idle.rst:965 msgid "Extensions" msgstr "" -#: library/idle.rst:981 +#: library/idle.rst:967 msgid "" "IDLE contains an extension facility. Preferences for extensions can be " "changed with the Extensions tab of the preferences dialog. See the beginning " @@ -1608,21 +1572,21 @@ msgid "" "testing." msgstr "" -#: library/idle.rst:989 +#: library/idle.rst:975 msgid "idlelib" msgstr "" -#: library/idle.rst:994 +#: library/idle.rst:980 msgid "**Source code:** :source:`Lib/idlelib`" msgstr "" -#: library/idle.rst:998 +#: library/idle.rst:984 msgid "" "The Lib/idlelib package implements the IDLE application. See the rest of " "this page for how to use IDLE." msgstr "" -#: library/idle.rst:1001 +#: library/idle.rst:987 msgid "" "The files in idlelib are described in idlelib/README.txt. Access it either " "in idlelib or click Help => About IDLE on the IDLE menu. This file also " @@ -1639,26 +1603,26 @@ msgstr "" msgid "Integrated Development Environment" msgstr "" -#: library/idle.rst:70 +#: library/idle.rst:68 msgid "Module browser" msgstr "" -#: library/idle.rst:70 +#: library/idle.rst:68 msgid "Path browser" msgstr "" -#: library/idle.rst:212 +#: library/idle.rst:210 msgid "Run script" msgstr "" -#: library/idle.rst:279 +#: library/idle.rst:277 msgid "debugger" msgstr "" -#: library/idle.rst:279 +#: library/idle.rst:277 msgid "stack viewer" msgstr "" -#: library/idle.rst:355 +#: library/idle.rst:353 msgid "breakpoints" msgstr "" diff --git a/library/imaplib.po b/library/imaplib.po index 3c205db4b..f2e5e4737 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -415,7 +415,7 @@ msgid "" "method." msgstr "" -#: library/imaplib.rst:380 +#: library/imaplib.rst:382 msgid "" "Raises an :ref:`auditing event ` ``imaplib.open`` with arguments " "``self``, ``host``, ``port``." @@ -487,7 +487,7 @@ msgstr "" msgid "Sends ``data`` to the remote server. You may override this method." msgstr "" -#: library/imaplib.rst:453 +#: library/imaplib.rst:455 msgid "" "Raises an :ref:`auditing event ` ``imaplib.send`` with arguments " "``self``, ``data``." diff --git a/library/io.po b/library/io.po index a30514308..4ca330f20 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: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -661,7 +661,7 @@ msgid "" msgstr "" #: library/io.rst:469 -msgid "Base class for raw binary streams. It inherits :class:`IOBase`." +msgid "Base class for raw binary streams. It inherits from :class:`IOBase`." msgstr "" #: library/io.rst:471 @@ -726,7 +726,7 @@ msgstr "" #: library/io.rst:521 msgid "" "Base class for binary streams that support some kind of buffering. It " -"inherits :class:`IOBase`." +"inherits from :class:`IOBase`." msgstr "" #: library/io.rst:524 @@ -872,7 +872,7 @@ msgstr "" #: library/io.rst:635 msgid "" "A raw binary stream representing an OS-level file containing bytes data. It " -"inherits :class:`RawIOBase`." +"inherits from :class:`RawIOBase`." msgstr "" #: library/io.rst:638 @@ -967,7 +967,7 @@ msgstr "" #: library/io.rst:699 msgid "" -"A binary stream using an in-memory bytes buffer. It inherits :class:" +"A binary stream using an in-memory bytes buffer. It inherits from :class:" "`BufferedIOBase`. The buffer is discarded when the :meth:`~IOBase.close` " "method is called." msgstr "" @@ -1017,7 +1017,7 @@ msgstr "" #: library/io.rst:747 msgid "" "A buffered binary stream providing higher-level access to a readable, non " -"seekable :class:`RawIOBase` raw binary stream. It inherits :class:" +"seekable :class:`RawIOBase` raw binary stream. It inherits from :class:" "`BufferedIOBase`." msgstr "" @@ -1064,7 +1064,7 @@ msgstr "" #: library/io.rst:785 msgid "" "A buffered binary stream providing higher-level access to a writeable, non " -"seekable :class:`RawIOBase` raw binary stream. It inherits :class:" +"seekable :class:`RawIOBase` raw binary stream. It inherits from :class:" "`BufferedIOBase`." msgstr "" @@ -1122,8 +1122,8 @@ msgstr "" #: library/io.rst:820 msgid "" "A buffered binary stream providing higher-level access to a seekable :class:" -"`RawIOBase` raw binary stream. It inherits :class:`BufferedReader` and :" -"class:`BufferedWriter`." +"`RawIOBase` raw binary stream. It inherits from :class:`BufferedReader` " +"and :class:`BufferedWriter`." msgstr "" #: library/io.rst:824 @@ -1144,7 +1144,7 @@ msgstr "" msgid "" "A buffered binary stream providing higher-level access to two non seekable :" "class:`RawIOBase` raw binary streams---one readable, the other writeable. It " -"inherits :class:`BufferedIOBase`." +"inherits from :class:`BufferedIOBase`." msgstr "" #: library/io.rst:839 @@ -1171,7 +1171,7 @@ msgstr "" #: library/io.rst:859 msgid "" "Base class for text streams. This class provides a character and line based " -"interface to stream I/O. It inherits :class:`IOBase`." +"interface to stream I/O. It inherits from :class:`IOBase`." msgstr "" #: library/io.rst:862 @@ -1283,7 +1283,8 @@ msgstr "" #: library/io.rst:948 msgid "" "A buffered text stream providing higher-level access to a :class:" -"`BufferedIOBase` buffered binary stream. It inherits :class:`TextIOBase`." +"`BufferedIOBase` buffered binary stream. It inherits from :class:" +"`TextIOBase`." msgstr "" #: library/io.rst:952 @@ -1454,7 +1455,7 @@ msgstr "" #: library/io.rst:1076 msgid "" -"A text stream using an in-memory text buffer. It inherits :class:" +"A text stream using an in-memory text buffer. It inherits from :class:" "`TextIOBase`." msgstr "" @@ -1502,7 +1503,7 @@ msgstr "" #: library/io.rst:1126 msgid "" "A helper codec that decodes newlines for :term:`universal newlines` mode. It " -"inherits :class:`codecs.IncrementalDecoder`." +"inherits from :class:`codecs.IncrementalDecoder`." msgstr "" #: library/io.rst:1131 diff --git a/library/locale.po b/library/locale.po index e94ee6e08..ebcf2b1b8 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -34,8 +34,8 @@ msgstr "" #: library/locale.rst:21 msgid "" -"The :mod:`locale` module is implemented on top of the :mod:`_locale` module, " -"which in turn uses an ANSI C locale implementation if available." +"The :mod:`locale` module is implemented on top of the :mod:`!_locale` " +"module, which in turn uses an ANSI C locale implementation if available." msgstr "" #: library/locale.rst:24 @@ -364,67 +364,67 @@ msgid "" "format." msgstr "" -#: library/locale.rst:197 +#: library/locale.rst:203 msgid "Get the name of the n-th day of the week." msgstr "" -#: library/locale.rst:201 +#: library/locale.rst:207 msgid "" "This follows the US convention of :const:`DAY_1` being Sunday, not the " "international convention (ISO 8601) that Monday is the first day of the week." msgstr "" -#: library/locale.rst:207 +#: library/locale.rst:219 msgid "Get the abbreviated name of the n-th day of the week." msgstr "" -#: library/locale.rst:211 +#: library/locale.rst:234 msgid "Get the name of the n-th month." msgstr "" -#: library/locale.rst:215 +#: library/locale.rst:249 msgid "Get the abbreviated name of the n-th month." msgstr "" -#: library/locale.rst:219 +#: library/locale.rst:253 msgid "Get the radix character (decimal dot, decimal comma, etc.)." msgstr "" -#: library/locale.rst:223 +#: library/locale.rst:257 msgid "Get the separator character for thousands (groups of three digits)." msgstr "" -#: library/locale.rst:227 +#: library/locale.rst:261 msgid "" "Get a regular expression that can be used with the regex function to " "recognize a positive response to a yes/no question." msgstr "" -#: library/locale.rst:232 +#: library/locale.rst:266 msgid "" -"Get a regular expression that can be used with the regex(3) function to " +"Get a regular expression that can be used with the ``regex(3)`` function to " "recognize a negative response to a yes/no question." msgstr "" -#: library/locale.rst:237 +#: library/locale.rst:271 msgid "" "The regular expressions for :const:`YESEXPR` and :const:`NOEXPR` use syntax " -"suitable for the :c:func:`regex` function from the C library, which might " -"differ from the syntax used in :mod:`re`." +"suitable for the ``regex`` function from the C library, which might differ " +"from the syntax used in :mod:`re`." msgstr "" -#: library/locale.rst:244 +#: library/locale.rst:278 msgid "" "Get the currency symbol, preceded by \"-\" if the symbol should appear " "before the value, \"+\" if the symbol should appear after the value, or \"." "\" if the symbol should replace the radix character." msgstr "" -#: library/locale.rst:250 +#: library/locale.rst:284 msgid "Get a string that represents the era used in the current locale." msgstr "" -#: library/locale.rst:252 +#: library/locale.rst:286 msgid "" "Most locales do not define this value. An example of a locale which does " "define this value is the Japanese one. In Japan, the traditional " @@ -432,7 +432,7 @@ msgid "" "then-emperor's reign." msgstr "" -#: library/locale.rst:257 +#: library/locale.rst:291 msgid "" "Normally it should not be necessary to use this value directly. Specifying " "the ``E`` modifier in their format strings causes the :func:`time.strftime` " @@ -441,37 +441,37 @@ msgid "" "systems." msgstr "" -#: library/locale.rst:265 +#: library/locale.rst:299 msgid "" "Get a format string for :func:`time.strftime` to represent date and time in " "a locale-specific era-based way." msgstr "" -#: library/locale.rst:270 +#: library/locale.rst:304 msgid "" "Get a format string for :func:`time.strftime` to represent a date in a " "locale-specific era-based way." msgstr "" -#: library/locale.rst:275 +#: library/locale.rst:309 msgid "" "Get a format string for :func:`time.strftime` to represent a time in a " "locale-specific era-based way." msgstr "" -#: library/locale.rst:280 +#: library/locale.rst:314 msgid "" "Get a representation of up to 100 values used to represent the values 0 to " "99." msgstr "" -#: library/locale.rst:286 +#: library/locale.rst:320 msgid "" "Tries to determine the default locale settings and returns them as a tuple " "of the form ``(language code, encoding)``." msgstr "" -#: library/locale.rst:289 +#: library/locale.rst:323 msgid "" "According to POSIX, a program which has not called ``setlocale(LC_ALL, '')`` " "runs using the portable ``'C'`` locale. Calling ``setlocale(LC_ALL, '')`` " @@ -480,7 +480,7 @@ msgid "" "emulate the behavior in the way described above." msgstr "" -#: library/locale.rst:295 +#: library/locale.rst:329 msgid "" "To maintain compatibility with other platforms, not only the :envvar:`LANG` " "variable is tested, but a list of variables given as envvars parameter. The " @@ -490,21 +490,21 @@ msgid "" "``'LC_CTYPE'``, ``'LANG'`` and ``'LANGUAGE'``, in that order." msgstr "" -#: library/locale.rst:315 +#: library/locale.rst:349 msgid "" "Except for the code ``'C'``, the language code corresponds to :rfc:`1766`. " "*language code* and *encoding* may be ``None`` if their values cannot be " "determined." msgstr "" -#: library/locale.rst:311 +#: library/locale.rst:345 msgid "" "Returns the current setting for the given locale category as sequence " "containing *language code*, *encoding*. *category* may be one of the :const:" "`!LC_\\*` values except :const:`LC_ALL`. It defaults to :const:`LC_CTYPE`." msgstr "" -#: library/locale.rst:322 +#: library/locale.rst:356 msgid "" "Return the :term:`locale encoding` used for text data, according to user " "preferences. User preferences are expressed differently on different " @@ -512,82 +512,82 @@ msgid "" "this function only returns a guess." msgstr "" -#: library/locale.rst:327 +#: library/locale.rst:361 msgid "" "On some systems, it is necessary to invoke :func:`setlocale` to obtain the " "user preferences, so this function is not thread-safe. If invoking setlocale " "is not necessary or desired, *do_setlocale* should be set to ``False``." msgstr "" -#: library/locale.rst:331 +#: library/locale.rst:365 msgid "" "On Android or if the :ref:`Python UTF-8 Mode ` is enabled, always " "return ``'utf-8'``, the :term:`locale encoding` and the *do_setlocale* " "argument are ignored." msgstr "" -#: library/locale.rst:353 +#: library/locale.rst:387 msgid "" "The :ref:`Python preinitialization ` configures the LC_CTYPE " "locale. See also the :term:`filesystem encoding and error handler`." msgstr "" -#: library/locale.rst:338 +#: library/locale.rst:372 msgid "" "The function now always returns ``\"utf-8\"`` on Android or if the :ref:" "`Python UTF-8 Mode ` is enabled." msgstr "" -#: library/locale.rst:345 +#: library/locale.rst:379 msgid "Get the current :term:`locale encoding`:" msgstr "" -#: library/locale.rst:347 +#: library/locale.rst:381 msgid "On Android and VxWorks, return ``\"utf-8\"``." msgstr "" -#: library/locale.rst:348 +#: library/locale.rst:382 msgid "" "On Unix, return the encoding of the current :data:`LC_CTYPE` locale. Return " "``\"utf-8\"`` if ``nl_langinfo(CODESET)`` returns an empty string: for " "example, if the current LC_CTYPE locale is not supported." msgstr "" -#: library/locale.rst:351 +#: library/locale.rst:385 msgid "On Windows, return the ANSI code page." msgstr "" -#: library/locale.rst:356 +#: library/locale.rst:390 msgid "" "This function is similar to :func:`getpreferredencoding(False) " "` except this function ignores the :ref:`Python UTF-8 " "Mode `." msgstr "" -#: library/locale.rst:365 +#: library/locale.rst:399 msgid "" "Returns a normalized locale code for the given locale name. The returned " "locale code is formatted for use with :func:`setlocale`. If normalization " "fails, the original name is returned unchanged." msgstr "" -#: library/locale.rst:369 +#: library/locale.rst:403 msgid "" "If the given encoding is not known, the function defaults to the default " "encoding for the locale code just like :func:`setlocale`." msgstr "" -#: library/locale.rst:375 +#: library/locale.rst:409 msgid "Sets the locale for *category* to the default setting." msgstr "" -#: library/locale.rst:377 +#: library/locale.rst:411 msgid "" "The default setting is determined by calling :func:`getdefaultlocale`. " "*category* defaults to :const:`LC_ALL`." msgstr "" -#: library/locale.rst:385 +#: library/locale.rst:419 msgid "" "Compares two strings according to the current :const:`LC_COLLATE` setting. " "As any other compare function, returns a negative, or a positive value, or " @@ -595,7 +595,7 @@ msgid "" "is equal to it." msgstr "" -#: library/locale.rst:393 +#: library/locale.rst:427 msgid "" "Transforms a string to one that can be used in locale-aware comparisons. " "For example, ``strxfrm(s1) < strxfrm(s2)`` is equivalent to ``strcoll(s1, " @@ -603,7 +603,7 @@ msgid "" "repeatedly, e.g. when collating a sequence of strings." msgstr "" -#: library/locale.rst:402 +#: 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 " @@ -611,29 +611,29 @@ msgid "" "is ``True``, also takes the grouping into account." msgstr "" -#: library/locale.rst:407 +#: library/locale.rst:441 msgid "" "If *monetary* is true, the conversion uses monetary thousands separator and " "grouping strings." msgstr "" -#: library/locale.rst:410 +#: library/locale.rst:444 msgid "" "Processes formatting specifiers as in ``format % val``, but takes the " "current locale settings into account." msgstr "" -#: library/locale.rst:413 +#: library/locale.rst:447 msgid "The *monetary* keyword parameter was added." msgstr "" -#: library/locale.rst:419 +#: library/locale.rst:453 msgid "" "Formats a number *val* according to the current :const:`LC_MONETARY` " "settings." msgstr "" -#: library/locale.rst:421 +#: library/locale.rst:455 msgid "" "The returned string includes the currency symbol if *symbol* is true, which " "is the default. If *grouping* is ``True`` (which is not the default), " @@ -641,43 +641,43 @@ msgid "" "not the default), the international currency symbol is used." msgstr "" -#: library/locale.rst:428 +#: library/locale.rst:462 msgid "" "This function will not work with the 'C' locale, so you have to set a locale " "via :func:`setlocale` first." msgstr "" -#: library/locale.rst:434 +#: library/locale.rst:468 msgid "" "Formats a floating point number using the same format as the built-in " "function ``str(float)``, but takes the decimal point into account." msgstr "" -#: library/locale.rst:440 +#: library/locale.rst:474 msgid "" "Converts a string into a normalized number string, following the :const:" "`LC_NUMERIC` settings." msgstr "" -#: library/locale.rst:448 +#: library/locale.rst:482 msgid "" "Converts a normalized number string into a formatted string following the :" "const:`LC_NUMERIC` settings." msgstr "" -#: library/locale.rst:456 +#: library/locale.rst:490 msgid "" "Converts a string to a number, following the :const:`LC_NUMERIC` settings, " "by calling *func* on the result of calling :func:`delocalize` on *string*." msgstr "" -#: library/locale.rst:462 +#: library/locale.rst:496 msgid "" "Converts a string to an integer, following the :const:`LC_NUMERIC` " "conventions." msgstr "" -#: library/locale.rst:467 +#: library/locale.rst:501 msgid "" "Locale category for the character type functions. Most importantly, this " "category defines the text encoding, i.e. how bytes are interpreted as " @@ -687,32 +687,32 @@ msgid "" "SSH connections." msgstr "" -#: library/locale.rst:474 +#: library/locale.rst:508 msgid "" "Python doesn't internally use locale-dependent character transformation " "functions from ``ctype.h``. Instead, an internal ``pyctype.h`` provides " "locale-independent equivalents like :c:macro:`!Py_TOLOWER`." msgstr "" -#: library/locale.rst:481 +#: library/locale.rst:515 msgid "" "Locale category for sorting strings. The functions :func:`strcoll` and :" "func:`strxfrm` of the :mod:`locale` module are affected." msgstr "" -#: library/locale.rst:487 +#: library/locale.rst:521 msgid "" "Locale category for the formatting of time. The function :func:`time." "strftime` follows these conventions." msgstr "" -#: library/locale.rst:493 +#: library/locale.rst:527 msgid "" "Locale category for formatting of monetary values. The available options " "are available from the :func:`localeconv` function." msgstr "" -#: library/locale.rst:499 +#: library/locale.rst:533 msgid "" "Locale category for message display. Python currently does not support " "application specific locale-aware messages. Messages displayed by the " @@ -720,13 +720,13 @@ msgid "" "affected by this category." msgstr "" -#: library/locale.rst:504 +#: library/locale.rst:538 msgid "" "This value may not be available on operating systems not conforming to the " "POSIX standard, most notably Windows." msgstr "" -#: library/locale.rst:510 +#: library/locale.rst:544 msgid "" "Locale category for formatting numbers. The functions :func:" "`format_string`, :func:`atoi`, :func:`atof` and :func:`.str` of the :mod:" @@ -734,7 +734,7 @@ msgid "" "operations are not affected." msgstr "" -#: library/locale.rst:518 +#: library/locale.rst:552 msgid "" "Combination of all locale settings. If this flag is used when the locale is " "changed, setting the locale for all categories is attempted. If that fails " @@ -744,21 +744,21 @@ msgid "" "settings." msgstr "" -#: library/locale.rst:527 +#: library/locale.rst:561 msgid "" "This is a symbolic constant used for different values returned by :func:" "`localeconv`." msgstr "" -#: library/locale.rst:531 +#: library/locale.rst:565 msgid "Example::" msgstr "" -#: library/locale.rst:544 +#: library/locale.rst:578 msgid "Background, details, hints, tips and caveats" msgstr "" -#: library/locale.rst:546 +#: library/locale.rst:580 msgid "" "The C standard defines the locale as a program-wide property that may be " "relatively expensive to change. On top of that, some implementations are " @@ -766,7 +766,7 @@ msgid "" "This makes the locale somewhat painful to use correctly." msgstr "" -#: library/locale.rst:551 +#: library/locale.rst:585 msgid "" "Initially, when a program is started, the locale is the ``C`` locale, no " "matter what the user's preferred locale is. There is one exception: the :" @@ -776,7 +776,7 @@ msgid "" "categories by calling ``setlocale(LC_ALL, '')``." msgstr "" -#: library/locale.rst:558 +#: library/locale.rst:592 msgid "" "It is generally a bad idea to call :func:`setlocale` in some library " "routine, since as a side effect it affects the entire program. Saving and " @@ -784,7 +784,7 @@ msgid "" "that happen to run before the settings have been restored." msgstr "" -#: library/locale.rst:563 +#: library/locale.rst:597 msgid "" "If, when coding a module for general use, you need a locale independent " "version of an operation that is affected by the locale (such as certain " @@ -795,14 +795,14 @@ msgid "" "settings." msgstr "" -#: library/locale.rst:570 +#: library/locale.rst:604 msgid "" "The only way to perform numeric operations according to the locale is to use " "the special functions defined by this module: :func:`atof`, :func:`atoi`, :" "func:`format_string`, :func:`.str`." msgstr "" -#: library/locale.rst:574 +#: library/locale.rst:608 msgid "" "There is no way to perform case conversions and character classifications " "according to the locale. For (Unicode) text strings these are done " @@ -813,11 +813,11 @@ msgid "" "whitespace." msgstr "" -#: library/locale.rst:585 +#: library/locale.rst:619 msgid "For extension writers and programs that embed Python" msgstr "" -#: library/locale.rst:587 +#: library/locale.rst:621 msgid "" "Extension modules should never call :func:`setlocale`, except to find out " "what the current locale is. But since the return value can only be used " @@ -825,37 +825,37 @@ msgid "" "whether or not the locale is ``C``)." msgstr "" -#: library/locale.rst:592 +#: library/locale.rst:626 msgid "" "When Python code uses the :mod:`locale` module to change the locale, this " "also affects the embedding application. If the embedding application " -"doesn't want this to happen, it should remove the :mod:`_locale` extension " +"doesn't want this to happen, it should remove the :mod:`!_locale` extension " "module (which does all the work) from the table of built-in modules in the :" -"file:`config.c` file, and make sure that the :mod:`_locale` module is not " +"file:`config.c` file, and make sure that the :mod:`!_locale` module is not " "accessible as a shared library." msgstr "" -#: library/locale.rst:603 +#: library/locale.rst:637 msgid "Access to message catalogs" msgstr "" -#: library/locale.rst:611 +#: library/locale.rst:646 msgid "" "The locale module exposes the C library's gettext interface on systems that " -"provide this interface. It consists of the functions :func:`!gettext`, :" -"func:`!dgettext`, :func:`!dcgettext`, :func:`!textdomain`, :func:`!" -"bindtextdomain`, and :func:`!bind_textdomain_codeset`. These are similar to " -"the same functions in the :mod:`gettext` module, but use the C library's " -"binary format for message catalogs, and the C library's search algorithms " -"for locating message catalogs." +"provide this interface. It consists of the functions :func:`gettext`, :func:" +"`dgettext`, :func:`dcgettext`, :func:`textdomain`, :func:`bindtextdomain`, " +"and :func:`bind_textdomain_codeset`. These are similar to the same " +"functions in the :mod:`gettext` module, but use the C library's binary " +"format for message catalogs, and the C library's search algorithms for " +"locating message catalogs." msgstr "" -#: library/locale.rst:618 +#: library/locale.rst:653 msgid "" "Python applications should normally find no need to invoke these functions, " "and should use :mod:`gettext` instead. A known exception to this rule are " -"applications that link with additional C libraries which internally invoke :" -"c:func:`gettext` or :c:func:`dcgettext`. For these applications, it may be " +"applications that link with additional C libraries which internally invoke C " +"functions ``gettext`` or ``dcgettext``. For these applications, it may be " "necessary to bind the text domain, so that the libraries can properly locate " "their message catalogs." msgstr "" diff --git a/library/logging.config.po b/library/logging.config.po index 057047950..62629e51f 100644 --- a/library/logging.config.po +++ b/library/logging.config.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -196,7 +196,7 @@ msgid "" msgstr "" #: library/logging.config.rst:130 -msgid "The *encoding* parameter is added." +msgid "Added the *encoding* parameter." msgstr "" #: library/logging.config.rst:133 diff --git a/library/logging.handlers.po b/library/logging.handlers.po index 1b22df0ff..473f978d2 100644 --- a/library/logging.handlers.po +++ b/library/logging.handlers.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1245,7 +1245,7 @@ msgid "" msgstr "" #: library/logging.handlers.rst:874 -msgid "The *timeout* argument was added." +msgid "Added the *timeout* parameter." msgstr "" #: library/logging.handlers.rst:879 diff --git a/library/logging.po b/library/logging.po index 7bcfde9bf..10dc080e9 100644 --- a/library/logging.po +++ b/library/logging.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -664,14 +664,14 @@ msgstr "" #: library/logging.rst:532 msgid "" "This method should be called from handlers when an exception is encountered " -"during an :meth:`emit` call. If the module-level attribute " -"``raiseExceptions`` is ``False``, exceptions get silently ignored. This is " +"during an :meth:`emit` call. If the module-level attribute :data:" +"`raiseExceptions` is ``False``, exceptions get silently ignored. This is " "what is mostly wanted for a logging system - most users will not care about " "errors in the logging system, they are more interested in application " "errors. You could, however, replace this with a custom handler if you wish. " "The specified record is the one which was being processed when the exception " -"occurred. (The default value of ``raiseExceptions`` is ``True``, as that is " -"more useful during development)." +"occurred. (The default value of :data:`raiseExceptions` is ``True``, as that " +"is more useful during development)." msgstr "" #: library/logging.rst:545 @@ -771,15 +771,15 @@ msgid "" msgstr "" #: library/logging.rst:618 -msgid "The *style* parameter." +msgid "Added the *style* parameter." msgstr "" #: library/logging.rst:621 -msgid "The *validate* parameter." +msgid "Added the *validate* parameter." msgstr "" #: library/logging.rst:624 -msgid "The *defaults* parameter." +msgid "Added the *defaults* parameter." msgstr "" #: library/logging.rst:630 @@ -1124,7 +1124,7 @@ msgstr "" msgid "Description" msgstr "" -#: library/logging.rst:0 +#: library/logging.rst:917 msgid "args" msgstr "" @@ -1168,7 +1168,7 @@ msgid "" "time`)." msgstr "" -#: library/logging.rst:0 +#: library/logging.rst:931 msgid "exc_info" msgstr "" @@ -1281,7 +1281,7 @@ msgid "" "Millisecond portion of the time when the :class:`LogRecord` was created." msgstr "" -#: library/logging.rst:0 +#: library/logging.rst:959 msgid "msg" msgstr "" @@ -1292,7 +1292,7 @@ msgid "" "messages`)." msgstr "" -#: library/logging.rst:0 +#: library/logging.rst:964 msgid "name" msgstr "" @@ -2053,22 +2053,38 @@ msgid "" "reason, ``lastResort`` can be set to ``None``." msgstr "" -#: library/logging.rst:1481 +#: library/logging.rst:1482 +msgid "Used to see if exceptions during handling should be propagated." +msgstr "" + +#: library/logging.rst:1484 +msgid "Default: ``True``." +msgstr "" + +#: library/logging.rst:1486 +msgid "" +"If :data:`raiseExceptions` is ``False``, exceptions get silently ignored. " +"This is what is mostly wanted for a logging system - most users will not " +"care about errors in the logging system, they are more interested in " +"application errors." +msgstr "" + +#: library/logging.rst:1493 msgid "Integration with the warnings module" msgstr "" -#: library/logging.rst:1483 +#: library/logging.rst:1495 msgid "" "The :func:`captureWarnings` function can be used to integrate :mod:`logging` " "with the :mod:`warnings` module." msgstr "" -#: library/logging.rst:1488 +#: library/logging.rst:1500 msgid "" "This function is used to turn the capture of warnings by logging on and off." msgstr "" -#: library/logging.rst:1491 +#: library/logging.rst:1503 msgid "" "If *capture* is ``True``, warnings issued by the :mod:`warnings` module will " "be redirected to the logging system. Specifically, a warning will be " @@ -2077,46 +2093,46 @@ msgid "" "`WARNING`." msgstr "" -#: library/logging.rst:1496 +#: library/logging.rst:1508 msgid "" "If *capture* is ``False``, the redirection of warnings to the logging system " "will stop, and warnings will be redirected to their original destinations (i." "e. those in effect before ``captureWarnings(True)`` was called)." msgstr "" -#: library/logging.rst:1504 +#: library/logging.rst:1516 msgid "Module :mod:`logging.config`" msgstr "" -#: library/logging.rst:1504 +#: library/logging.rst:1516 msgid "Configuration API for the logging module." msgstr "" -#: library/logging.rst:1507 +#: library/logging.rst:1519 msgid "Module :mod:`logging.handlers`" msgstr "" -#: library/logging.rst:1507 +#: library/logging.rst:1519 msgid "Useful handlers included with the logging module." msgstr "" -#: library/logging.rst:1511 +#: library/logging.rst:1523 msgid ":pep:`282` - A Logging System" msgstr "" -#: library/logging.rst:1510 +#: library/logging.rst:1522 msgid "" "The proposal which described this feature for inclusion in the Python " "standard library." msgstr "" -#: library/logging.rst:1516 +#: library/logging.rst:1528 msgid "" "`Original Python logging package `_" msgstr "" -#: library/logging.rst:1514 +#: library/logging.rst:1526 msgid "" "This is the original source for the :mod:`logging` package. The version of " "the package available from this site is suitable for use with Python 1.5.2, " diff --git a/library/mailbox.po b/library/mailbox.po index 260692375..c1caf3689 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1299,8 +1299,8 @@ msgid "" "leading \"From \" or trailing newline. For convenience, *time_* may be " "specified and will be formatted appropriately and appended to *from_*. If " "*time_* is specified, it should be a :class:`time.struct_time` instance, a " -"tuple suitable for passing to :meth:`time.strftime`, or ``True`` (to use :" -"meth:`time.gmtime`)." +"tuple suitable for passing to :func:`time.strftime`, or ``True`` (to use :" +"func:`time.gmtime`)." msgstr "" #: library/mailbox.rst:1408 diff --git a/library/math.po b/library/math.po index 2508fe54b..4b700c64f 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: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: 2023-03-31 00:00+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -409,7 +409,7 @@ msgstr "``math.nextafter(x, math.copysign(math.inf, x))`` sıfırdan uzaklaşır msgid "See also :func:`math.ulp`." msgstr "Ayrıca bakınız :func:`math.ulp`." -#: library/math.rst:242 +#: library/math.rst:244 msgid "Added the *steps* argument." msgstr "" @@ -987,7 +987,7 @@ msgstr "" "``==`` yerine NaN'leri test etmek için :func:`isnan` fonksiyonunu kullanın. " "Örnek::" -#: library/math.rst:683 +#: library/math.rst:685 msgid "It is now always available." msgstr "Artık her zaman kullanılabilir." diff --git a/library/mmap.po b/library/mmap.po index 3ec05b3df..1db7461db 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -105,8 +105,8 @@ msgid "" "same file. If you specify the name of an existing tag, that tag is opened, " "otherwise a new tag of this name is created. If this parameter is omitted " "or ``None``, the mapping is created without a name. Avoiding the use of the " -"tag parameter will assist in keeping your code portable between Unix and " -"Windows." +"*tagname* parameter will assist in keeping your code portable between Unix " +"and Windows." msgstr "" #: library/mmap.rst:68 @@ -117,7 +117,7 @@ msgid "" "`ALLOCATIONGRANULARITY`." msgstr "" -#: library/mmap.rst:172 +#: library/mmap.rst:174 msgid "" "Raises an :ref:`auditing event ` ``mmap.__new__`` with arguments " "``fileno``, ``length``, ``access``, ``offset``." diff --git a/library/msvcrt.po b/library/msvcrt.po index 29fa3b219..8dcb773a4 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: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -176,5 +176,19 @@ msgstr "" #: library/msvcrt.rst:159 msgid "" "Force the :c:func:`malloc` heap to clean itself up and return unused blocks " -"to the operating system. On failure, this raises :exc:`OSError`." +"to the operating system. On failure, this raises :exc:`OSError`." +msgstr "" + +#: library/msvcrt.rst:164 +msgid "The CRT Assembly version, from the :file:`crtassem.h` header file." +msgstr "" + +#: library/msvcrt.rst:169 +msgid "" +"The VC Assembly public key token, from the :file:`crtassem.h` header file." +msgstr "" + +#: library/msvcrt.rst:174 +msgid "" +"The Libraries Assembly name prefix, from the :file:`crtassem.h` header file." msgstr "" diff --git a/library/multiprocessing.po b/library/multiprocessing.po index 842a84781..9e52912e7 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: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -181,20 +181,20 @@ msgid "" "Unix pipes such as Linux." msgstr "" -#: library/multiprocessing.rst:155 -msgid "" -"On macOS, the *spawn* start method is now the default. The *fork* start " -"method should be considered unsafe as it can lead to crashes of the " -"subprocess as macOS system libraries may start threads. See :issue:`33725`." -msgstr "" - -#: library/multiprocessing.rst:159 +#: library/multiprocessing.rst:153 msgid "" "*spawn* added on all POSIX platforms, and *forkserver* added for some POSIX " "platforms. Child processes no longer inherit all of the parents inheritable " "handles on Windows." msgstr "" +#: library/multiprocessing.rst:161 +msgid "" +"On macOS, the *spawn* start method is now the default. The *fork* start " +"method should be considered unsafe as it can lead to crashes of the " +"subprocess as macOS system libraries may start threads. See :issue:`33725`." +msgstr "" + #: library/multiprocessing.rst:165 msgid "" "On POSIX using the *spawn* or *forkserver* start methods will also start a " @@ -472,7 +472,7 @@ msgid "" msgstr "" #: library/multiprocessing.rst:521 -msgid "Added the *daemon* argument." +msgid "Added the *daemon* parameter." msgstr "" #: library/multiprocessing.rst:526 @@ -650,9 +650,9 @@ msgstr "" #: library/multiprocessing.rst:652 msgid "" -"Terminate the process. On POSIX this is done using the ``SIGTERM`` signal; " -"on Windows :c:func:`TerminateProcess` is used. Note that exit handlers and " -"finally clauses, etc., will not be executed." +"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 @@ -1163,7 +1163,7 @@ msgid "" "``None``. See :ref:`multiprocessing-start-methods`." msgstr "" -#: library/multiprocessing.rst:1082 +#: library/multiprocessing.rst:1084 msgid "" "On macOS, the *spawn* start method is now the default. The *fork* start " "method should be considered unsafe as it can lead to crashes of the " @@ -1364,23 +1364,23 @@ msgstr "" #: library/multiprocessing.rst:1241 msgid "" -"Connection objects now support the context management protocol -- see :ref:" -"`typecontextmanager`. :meth:`~contextmanager.__enter__` returns the " +"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:1246 +#: library/multiprocessing.rst:1245 msgid "For example:" msgstr "" -#: library/multiprocessing.rst:1271 +#: library/multiprocessing.rst:1270 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:1275 +#: library/multiprocessing.rst:1274 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 +1388,71 @@ msgid "" "`multiprocessing-auth-keys`." msgstr "" -#: library/multiprocessing.rst:1282 +#: library/multiprocessing.rst:1281 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:1288 +#: library/multiprocessing.rst:1287 msgid "Synchronization primitives" msgstr "" -#: library/multiprocessing.rst:1292 +#: library/multiprocessing.rst:1291 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:1296 +#: library/multiprocessing.rst:1295 msgid "" "Note that one can also create synchronization primitives by using a manager " "object -- see :ref:`multiprocessing-managers`." msgstr "" -#: library/multiprocessing.rst:1301 +#: library/multiprocessing.rst:1300 msgid "A barrier object: a clone of :class:`threading.Barrier`." msgstr "" -#: library/multiprocessing.rst:1307 +#: library/multiprocessing.rst:1306 msgid "" "A bounded semaphore object: a close analog of :class:`threading." "BoundedSemaphore`." msgstr "" -#: library/multiprocessing.rst:1310 library/multiprocessing.rst:1448 +#: library/multiprocessing.rst:1309 library/multiprocessing.rst:1447 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:1314 +#: library/multiprocessing.rst:1313 msgid "" "On macOS, this is indistinguishable from :class:`Semaphore` because " "``sem_getvalue()`` is not implemented on that platform." msgstr "" -#: library/multiprocessing.rst:1319 +#: library/multiprocessing.rst:1318 msgid "A condition variable: an alias for :class:`threading.Condition`." msgstr "" -#: library/multiprocessing.rst:1321 +#: library/multiprocessing.rst:1320 msgid "" "If *lock* is specified then it should be a :class:`Lock` or :class:`RLock` " "object from :mod:`multiprocessing`." msgstr "" -#: library/multiprocessing.rst:1324 library/multiprocessing.rst:1873 +#: library/multiprocessing.rst:1323 library/multiprocessing.rst:1872 msgid "The :meth:`~threading.Condition.wait_for` method was added." msgstr "" -#: library/multiprocessing.rst:1329 +#: library/multiprocessing.rst:1328 msgid "A clone of :class:`threading.Event`." msgstr "" -#: library/multiprocessing.rst:1334 +#: library/multiprocessing.rst:1333 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 +1463,24 @@ msgid "" "as noted." msgstr "" -#: library/multiprocessing.rst:1342 +#: library/multiprocessing.rst:1341 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:1346 +#: library/multiprocessing.rst:1345 msgid "" ":class:`Lock` supports the :term:`context manager` protocol and thus may be " "used in :keyword:`with` statements." msgstr "" -#: library/multiprocessing.rst:1351 library/multiprocessing.rst:1402 +#: library/multiprocessing.rst:1350 library/multiprocessing.rst:1401 msgid "Acquire a lock, blocking or non-blocking." msgstr "" -#: library/multiprocessing.rst:1353 +#: library/multiprocessing.rst:1352 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 +1488,14 @@ msgid "" "that in :meth:`threading.Lock.acquire`." msgstr "" -#: library/multiprocessing.rst:1358 +#: library/multiprocessing.rst:1357 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:1362 +#: library/multiprocessing.rst:1361 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 +1509,19 @@ msgid "" "acquired or ``False`` if the timeout period has elapsed." msgstr "" -#: library/multiprocessing.rst:1377 +#: library/multiprocessing.rst:1376 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:1380 +#: library/multiprocessing.rst:1379 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:1386 +#: library/multiprocessing.rst:1385 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 +1530,20 @@ msgid "" "release it once for each time it has been acquired." msgstr "" -#: library/multiprocessing.rst:1392 +#: library/multiprocessing.rst:1391 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:1396 +#: library/multiprocessing.rst:1395 msgid "" ":class:`RLock` supports the :term:`context manager` protocol and thus may be " "used in :keyword:`with` statements." msgstr "" -#: library/multiprocessing.rst:1404 +#: library/multiprocessing.rst:1403 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 +1556,7 @@ msgid "" "itself." msgstr "" -#: library/multiprocessing.rst:1414 +#: library/multiprocessing.rst:1413 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 +1567,14 @@ msgid "" "a return value of ``True``." msgstr "" -#: library/multiprocessing.rst:1422 +#: library/multiprocessing.rst:1421 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:1429 +#: library/multiprocessing.rst:1428 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 +1584,7 @@ msgid "" "locked and owned by the calling process or thread." msgstr "" -#: library/multiprocessing.rst:1437 +#: library/multiprocessing.rst:1436 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,17 +1593,17 @@ msgid "" "from the implemented behavior in :meth:`threading.RLock.release`." msgstr "" -#: library/multiprocessing.rst:1446 +#: library/multiprocessing.rst:1445 msgid "A semaphore object: a close analog of :class:`threading.Semaphore`." msgstr "" -#: library/multiprocessing.rst:1453 +#: library/multiprocessing.rst:1452 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:1458 +#: 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." @@ -1612,13 +1612,13 @@ msgid "" "interrupted and :exc:`KeyboardInterrupt` will be raised." msgstr "" -#: library/multiprocessing.rst:1464 +#: 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:1469 +#: library/multiprocessing.rst:1468 msgid "" "Some of this package's functionality requires a functioning shared semaphore " "implementation on the host operating system. Without one, the :mod:" @@ -1627,31 +1627,31 @@ msgid "" "additional information." msgstr "" -#: library/multiprocessing.rst:1477 +#: library/multiprocessing.rst:1476 msgid "Shared :mod:`ctypes` Objects" msgstr "" -#: library/multiprocessing.rst:1479 +#: library/multiprocessing.rst:1478 msgid "" "It is possible to create shared objects using shared memory which can be " "inherited by child processes." msgstr "" -#: library/multiprocessing.rst:1484 +#: library/multiprocessing.rst:1483 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:1488 library/multiprocessing.rst:1575 +#: library/multiprocessing.rst:1487 library/multiprocessing.rst:1574 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:1492 +#: library/multiprocessing.rst:1491 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 +1661,31 @@ msgid "" "\"process-safe\"." msgstr "" -#: library/multiprocessing.rst:1499 +#: library/multiprocessing.rst:1498 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:1505 +#: library/multiprocessing.rst:1504 msgid "" "Assuming the associated lock is recursive (which it is by default) you can " "instead do ::" msgstr "" -#: library/multiprocessing.rst:1511 library/multiprocessing.rst:1601 -#: library/multiprocessing.rst:1616 +#: library/multiprocessing.rst:1510 library/multiprocessing.rst:1600 +#: library/multiprocessing.rst:1615 msgid "Note that *lock* is a keyword-only argument." msgstr "" -#: library/multiprocessing.rst:1515 +#: library/multiprocessing.rst:1514 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:1518 +#: library/multiprocessing.rst:1517 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 +1695,7 @@ msgid "" "initialize the array and whose length determines the length of the array." msgstr "" -#: library/multiprocessing.rst:1525 +#: library/multiprocessing.rst:1524 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 +1705,28 @@ msgid "" "safe\"." msgstr "" -#: library/multiprocessing.rst:1532 +#: library/multiprocessing.rst:1531 msgid "Note that *lock* is a keyword only argument." msgstr "" -#: library/multiprocessing.rst:1534 +#: library/multiprocessing.rst:1533 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:1539 +#: library/multiprocessing.rst:1538 msgid "The :mod:`multiprocessing.sharedctypes` module" msgstr "" -#: library/multiprocessing.rst:1544 +#: library/multiprocessing.rst:1543 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:1550 +#: library/multiprocessing.rst:1549 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 +1735,11 @@ msgid "" "may cause a crash." msgstr "" -#: library/multiprocessing.rst:1558 +#: library/multiprocessing.rst:1557 msgid "Return a ctypes array allocated from shared memory." msgstr "" -#: library/multiprocessing.rst:1560 +#: library/multiprocessing.rst:1559 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 +1749,39 @@ msgid "" "initialize the array and whose length determines the length of the array." msgstr "" -#: library/multiprocessing.rst:1567 +#: library/multiprocessing.rst:1566 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:1573 +#: library/multiprocessing.rst:1572 msgid "Return a ctypes object allocated from shared memory." msgstr "" -#: library/multiprocessing.rst:1579 +#: library/multiprocessing.rst:1578 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:1583 +#: library/multiprocessing.rst:1582 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:1589 +#: library/multiprocessing.rst:1588 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:1593 library/multiprocessing.rst:1609 +#: library/multiprocessing.rst:1592 library/multiprocessing.rst:1608 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 +1791,121 @@ msgid "" "not necessarily be \"process-safe\"." msgstr "" -#: library/multiprocessing.rst:1605 +#: library/multiprocessing.rst:1604 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:1620 +#: library/multiprocessing.rst:1619 msgid "" "Return a ctypes object allocated from shared memory which is a copy of the " "ctypes object *obj*." msgstr "" -#: library/multiprocessing.rst:1625 +#: library/multiprocessing.rst:1624 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:1629 +#: library/multiprocessing.rst:1628 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:1633 +#: library/multiprocessing.rst:1632 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:1636 +#: library/multiprocessing.rst:1635 msgid "Synchronized objects support the :term:`context manager` protocol." msgstr "" -#: library/multiprocessing.rst:1640 +#: library/multiprocessing.rst:1639 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:1645 +#: library/multiprocessing.rst:1644 msgid "ctypes" msgstr "" -#: library/multiprocessing.rst:1645 +#: library/multiprocessing.rst:1644 msgid "sharedctypes using type" msgstr "" -#: library/multiprocessing.rst:1645 +#: library/multiprocessing.rst:1644 msgid "sharedctypes using typecode" msgstr "" -#: library/multiprocessing.rst:1647 +#: library/multiprocessing.rst:1646 msgid "c_double(2.4)" msgstr "" -#: library/multiprocessing.rst:1647 +#: library/multiprocessing.rst:1646 msgid "RawValue(c_double, 2.4)" msgstr "" -#: library/multiprocessing.rst:1647 +#: library/multiprocessing.rst:1646 msgid "RawValue('d', 2.4)" msgstr "" -#: library/multiprocessing.rst:1648 +#: library/multiprocessing.rst:1647 msgid "MyStruct(4, 6)" msgstr "" -#: library/multiprocessing.rst:1648 +#: library/multiprocessing.rst:1647 msgid "RawValue(MyStruct, 4, 6)" msgstr "" -#: library/multiprocessing.rst:1649 +#: library/multiprocessing.rst:1648 msgid "(c_short * 7)()" msgstr "" -#: library/multiprocessing.rst:1649 +#: library/multiprocessing.rst:1648 msgid "RawArray(c_short, 7)" msgstr "" -#: library/multiprocessing.rst:1649 +#: library/multiprocessing.rst:1648 msgid "RawArray('h', 7)" msgstr "" -#: library/multiprocessing.rst:1650 +#: library/multiprocessing.rst:1649 msgid "(c_int * 3)(9, 2, 8)" msgstr "" -#: library/multiprocessing.rst:1650 +#: library/multiprocessing.rst:1649 msgid "RawArray(c_int, (9, 2, 8))" msgstr "" -#: library/multiprocessing.rst:1650 +#: library/multiprocessing.rst:1649 msgid "RawArray('i', (9, 2, 8))" msgstr "" -#: library/multiprocessing.rst:1654 +#: library/multiprocessing.rst:1653 msgid "" "Below is an example where a number of ctypes objects are modified by a child " "process::" msgstr "" -#: library/multiprocessing.rst:1692 +#: library/multiprocessing.rst:1691 msgid "The results printed are ::" msgstr "" -#: library/multiprocessing.rst:1705 +#: library/multiprocessing.rst:1704 msgid "Managers" msgstr "" -#: library/multiprocessing.rst:1707 +#: library/multiprocessing.rst:1706 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 +1914,7 @@ msgid "" "proxies." msgstr "" -#: library/multiprocessing.rst:1716 +#: library/multiprocessing.rst:1715 msgid "" "Returns a started :class:`~multiprocessing.managers.SyncManager` object " "which can be used for sharing objects between processes. The returned " @@ -1922,31 +1922,31 @@ msgid "" "will create shared objects and return corresponding proxies." msgstr "" -#: library/multiprocessing.rst:1724 +#: library/multiprocessing.rst:1723 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:1730 +#: library/multiprocessing.rst:1729 msgid "Create a BaseManager object." msgstr "" -#: library/multiprocessing.rst:1732 +#: library/multiprocessing.rst:1731 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:1735 +#: library/multiprocessing.rst:1734 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:1738 +#: library/multiprocessing.rst:1737 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 +1954,19 @@ msgid "" "it must be a byte string." msgstr "" -#: library/multiprocessing.rst:1743 +#: library/multiprocessing.rst:1742 msgid "" "*serializer* must be ``'pickle'`` (use :mod:`pickle` serialization) or " "``'xmlrpclib'`` (use :mod:`xmlrpc.client` serialization)." msgstr "" -#: library/multiprocessing.rst:1746 +#: library/multiprocessing.rst:1745 msgid "" "*ctx* is a context object, or ``None`` (use the current context). See the :" "func:`get_context` function." msgstr "" -#: library/multiprocessing.rst:1749 +#: library/multiprocessing.rst:1748 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 +1974,54 @@ msgid "" "also times out, the process is killed." msgstr "" -#: library/multiprocessing.rst:1754 +#: library/multiprocessing.rst:1753 msgid "Added the *shutdown_timeout* parameter." msgstr "" -#: library/multiprocessing.rst:1759 +#: library/multiprocessing.rst:1758 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:1764 +#: library/multiprocessing.rst:1763 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:1773 +#: library/multiprocessing.rst:1772 msgid ":class:`Server` additionally has an :attr:`address` attribute." msgstr "" -#: library/multiprocessing.rst:1777 +#: library/multiprocessing.rst:1776 msgid "Connect a local manager object to a remote manager process::" msgstr "" -#: library/multiprocessing.rst:1785 +#: library/multiprocessing.rst:1784 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:1788 +#: library/multiprocessing.rst:1787 msgid "This can be called multiple times." msgstr "" -#: library/multiprocessing.rst:1792 +#: library/multiprocessing.rst:1791 msgid "" "A classmethod which can be used for registering a type or callable with the " "manager class." msgstr "" -#: library/multiprocessing.rst:1795 +#: library/multiprocessing.rst:1794 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:1798 +#: library/multiprocessing.rst:1797 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 +2029,14 @@ msgid "" "then this can be left as ``None``." msgstr "" -#: library/multiprocessing.rst:1804 +#: library/multiprocessing.rst:1803 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:1808 +#: library/multiprocessing.rst:1807 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 +2047,7 @@ msgid "" "method and whose name does not begin with ``'_'``.)" msgstr "" -#: library/multiprocessing.rst:1817 +#: library/multiprocessing.rst:1816 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 +2057,22 @@ msgid "" "returned by the method will be copied by value." msgstr "" -#: library/multiprocessing.rst:1824 +#: library/multiprocessing.rst:1823 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:1828 +#: library/multiprocessing.rst:1827 msgid ":class:`BaseManager` instances also have one read-only property:" msgstr "" -#: library/multiprocessing.rst:1832 +#: library/multiprocessing.rst:1831 msgid "The address used by the manager." msgstr "" -#: library/multiprocessing.rst:1834 +#: library/multiprocessing.rst:1833 msgid "" "Manager objects support the context management protocol -- see :ref:" "`typecontextmanager`. :meth:`~contextmanager.__enter__` starts the server " @@ -2080,173 +2080,173 @@ msgid "" "object. :meth:`~contextmanager.__exit__` calls :meth:`shutdown`." msgstr "" -#: library/multiprocessing.rst:1840 +#: library/multiprocessing.rst:1839 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:1845 +#: library/multiprocessing.rst:1844 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:1849 +#: library/multiprocessing.rst:1848 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:1855 +#: library/multiprocessing.rst:1854 msgid "" "Create a shared :class:`threading.Barrier` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1862 +#: library/multiprocessing.rst:1861 msgid "" "Create a shared :class:`threading.BoundedSemaphore` object and return a " "proxy for it." msgstr "" -#: library/multiprocessing.rst:1867 +#: library/multiprocessing.rst:1866 msgid "" "Create a shared :class:`threading.Condition` object and return a proxy for " "it." msgstr "" -#: library/multiprocessing.rst:1870 +#: library/multiprocessing.rst:1869 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:1878 +#: library/multiprocessing.rst:1877 msgid "" "Create a shared :class:`threading.Event` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1882 +#: library/multiprocessing.rst:1881 msgid "" "Create a shared :class:`threading.Lock` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1886 +#: library/multiprocessing.rst:1885 msgid "Create a shared :class:`Namespace` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1890 +#: library/multiprocessing.rst:1889 msgid "Create a shared :class:`queue.Queue` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1894 +#: library/multiprocessing.rst:1893 msgid "" "Create a shared :class:`threading.RLock` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1898 +#: library/multiprocessing.rst:1897 msgid "" "Create a shared :class:`threading.Semaphore` object and return a proxy for " "it." msgstr "" -#: library/multiprocessing.rst:1903 +#: library/multiprocessing.rst:1902 msgid "Create an array and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1907 +#: library/multiprocessing.rst:1906 msgid "" "Create an object with a writable ``value`` attribute and return a proxy for " "it." msgstr "" -#: library/multiprocessing.rst:1914 +#: library/multiprocessing.rst:1913 msgid "Create a shared :class:`dict` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1919 +#: library/multiprocessing.rst:1918 msgid "Create a shared :class:`list` object and return a proxy for it." msgstr "" -#: library/multiprocessing.rst:1921 +#: library/multiprocessing.rst:1920 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:1928 +#: library/multiprocessing.rst:1927 msgid "A type that can register with :class:`SyncManager`." msgstr "" -#: library/multiprocessing.rst:1930 +#: library/multiprocessing.rst:1929 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:1933 +#: library/multiprocessing.rst:1932 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:1950 +#: library/multiprocessing.rst:1949 msgid "Customized managers" msgstr "" -#: library/multiprocessing.rst:1952 +#: library/multiprocessing.rst:1951 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:1977 +#: library/multiprocessing.rst:1976 msgid "Using a remote manager" msgstr "" -#: library/multiprocessing.rst:1979 +#: library/multiprocessing.rst:1978 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:1982 +#: library/multiprocessing.rst:1981 msgid "" "Running the following commands creates a server for a single shared queue " "which remote clients can access::" msgstr "" -#: library/multiprocessing.rst:1994 +#: library/multiprocessing.rst:1993 msgid "One client can access the server as follows::" msgstr "" -#: library/multiprocessing.rst:2004 +#: library/multiprocessing.rst:2003 msgid "Another client can also use it::" msgstr "" -#: library/multiprocessing.rst:2015 +#: library/multiprocessing.rst:2014 msgid "" "Local processes can also access that queue, using the code from above on the " "client to access it remotely::" msgstr "" -#: library/multiprocessing.rst:2040 +#: library/multiprocessing.rst:2039 msgid "Proxy Objects" msgstr "" -#: library/multiprocessing.rst:2042 +#: library/multiprocessing.rst:2041 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:2046 +#: library/multiprocessing.rst:2045 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 +2254,14 @@ msgid "" "its referent can:" msgstr "" -#: library/multiprocessing.rst:2064 +#: library/multiprocessing.rst:2063 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:2068 +#: library/multiprocessing.rst:2067 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 +2269,11 @@ msgid "" "lists, dicts, and other :ref:`multiprocessing-proxy_objects`:" msgstr "" -#: library/multiprocessing.rst:2084 +#: library/multiprocessing.rst:2083 msgid "Similarly, dict and list proxies may be nested inside one another::" msgstr "" -#: library/multiprocessing.rst:2097 +#: library/multiprocessing.rst:2096 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 +2284,53 @@ msgid "" "assign the modified value to the container proxy::" msgstr "" -#: library/multiprocessing.rst:2116 +#: library/multiprocessing.rst:2115 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:2122 +#: library/multiprocessing.rst:2121 msgid "" "The proxy types in :mod:`multiprocessing` do nothing to support comparisons " "by value. So, for instance, we have:" msgstr "" -#: library/multiprocessing.rst:2130 +#: library/multiprocessing.rst:2129 msgid "" "One should just use a copy of the referent instead when making comparisons." msgstr "" -#: library/multiprocessing.rst:2134 +#: library/multiprocessing.rst:2133 msgid "Proxy objects are instances of subclasses of :class:`BaseProxy`." msgstr "" -#: library/multiprocessing.rst:2138 +#: library/multiprocessing.rst:2137 msgid "Call and return the result of a method of the proxy's referent." msgstr "" -#: library/multiprocessing.rst:2140 +#: library/multiprocessing.rst:2139 msgid "" "If ``proxy`` is a proxy whose referent is ``obj`` then the expression ::" msgstr "" -#: library/multiprocessing.rst:2144 +#: library/multiprocessing.rst:2143 msgid "will evaluate the expression ::" msgstr "" -#: library/multiprocessing.rst:2148 +#: library/multiprocessing.rst:2147 msgid "in the manager's process." msgstr "" -#: library/multiprocessing.rst:2150 +#: library/multiprocessing.rst:2149 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:2154 +#: library/multiprocessing.rst:2153 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 +2338,78 @@ msgid "" "meth:`_callmethod`." msgstr "" -#: library/multiprocessing.rst:2159 +#: library/multiprocessing.rst:2158 msgid "" "Note in particular that an exception will be raised if *methodname* has not " "been *exposed*." msgstr "" -#: library/multiprocessing.rst:2162 +#: library/multiprocessing.rst:2161 msgid "An example of the usage of :meth:`_callmethod`:" msgstr "" -#: library/multiprocessing.rst:2178 +#: library/multiprocessing.rst:2177 msgid "Return a copy of the referent." msgstr "" -#: library/multiprocessing.rst:2180 +#: library/multiprocessing.rst:2179 msgid "If the referent is unpicklable then this will raise an exception." msgstr "" -#: library/multiprocessing.rst:2184 +#: library/multiprocessing.rst:2183 msgid "Return a representation of the proxy object." msgstr "" -#: library/multiprocessing.rst:2188 +#: library/multiprocessing.rst:2187 msgid "Return the representation of the referent." msgstr "" -#: library/multiprocessing.rst:2192 +#: library/multiprocessing.rst:2191 msgid "Cleanup" msgstr "" -#: library/multiprocessing.rst:2194 +#: library/multiprocessing.rst:2193 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:2197 +#: library/multiprocessing.rst:2196 msgid "" "A shared object gets deleted from the manager process when there are no " "longer any proxies referring to it." msgstr "" -#: library/multiprocessing.rst:2202 +#: library/multiprocessing.rst:2201 msgid "Process Pools" msgstr "" -#: library/multiprocessing.rst:2207 +#: library/multiprocessing.rst:2206 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:2212 +#: library/multiprocessing.rst:2211 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:2216 +#: library/multiprocessing.rst:2215 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:2219 library/multiprocessing.rst:2780 +#: library/multiprocessing.rst:2218 library/multiprocessing.rst:2779 msgid "" "If *initializer* is not ``None`` then each worker process will call " "``initializer(*initargs)`` when it starts." msgstr "" -#: library/multiprocessing.rst:2222 +#: library/multiprocessing.rst:2221 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 +2417,7 @@ msgid "" "which means worker processes will live as long as the pool." msgstr "" -#: library/multiprocessing.rst:2227 +#: library/multiprocessing.rst:2226 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 +2425,13 @@ msgid "" "both cases *context* is set appropriately." msgstr "" -#: library/multiprocessing.rst:2233 +#: library/multiprocessing.rst:2232 msgid "" "Note that the methods of the pool object should only be called by the " "process which created the pool." msgstr "" -#: library/multiprocessing.rst:2237 +#: library/multiprocessing.rst:2236 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 +2439,22 @@ msgid "" "to do this can lead to the process hanging on finalization." msgstr "" -#: library/multiprocessing.rst:2242 +#: library/multiprocessing.rst:2241 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:2246 -msgid "*maxtasksperchild*" +#: library/multiprocessing.rst:2245 +msgid "Added the *maxtasksperchild* parameter." msgstr "" -#: library/multiprocessing.rst:2249 -msgid "*context*" +#: library/multiprocessing.rst:2248 +msgid "Added the *context* parameter." msgstr "" -#: library/multiprocessing.rst:2254 +#: library/multiprocessing.rst:2253 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 +2465,7 @@ msgid "" "ability to the end user." msgstr "" -#: library/multiprocessing.rst:2264 +#: library/multiprocessing.rst:2263 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 +2473,13 @@ msgid "" "executed in one of the workers of the pool." msgstr "" -#: library/multiprocessing.rst:2271 +#: library/multiprocessing.rst:2270 msgid "" "A variant of the :meth:`apply` method which returns a :class:" "`~multiprocessing.pool.AsyncResult` object." msgstr "" -#: library/multiprocessing.rst:2274 library/multiprocessing.rst:2305 +#: library/multiprocessing.rst:2273 library/multiprocessing.rst:2304 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 +2487,58 @@ msgid "" "applied instead." msgstr "" -#: library/multiprocessing.rst:2279 library/multiprocessing.rst:2310 +#: library/multiprocessing.rst:2278 library/multiprocessing.rst:2309 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:2283 library/multiprocessing.rst:2314 +#: library/multiprocessing.rst:2282 library/multiprocessing.rst:2313 msgid "" "Callbacks should complete immediately since otherwise the thread which " "handles the results will get blocked." msgstr "" -#: library/multiprocessing.rst:2288 +#: library/multiprocessing.rst:2287 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:2292 +#: library/multiprocessing.rst:2291 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:2296 +#: library/multiprocessing.rst:2295 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:2302 +#: library/multiprocessing.rst:2301 msgid "" "A variant of the :meth:`.map` method which returns a :class:" "`~multiprocessing.pool.AsyncResult` object." msgstr "" -#: library/multiprocessing.rst:2319 +#: library/multiprocessing.rst:2318 msgid "A lazier version of :meth:`.map`." msgstr "" -#: library/multiprocessing.rst:2321 +#: library/multiprocessing.rst:2320 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:2326 +#: library/multiprocessing.rst:2325 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 +2546,65 @@ msgid "" "result cannot be returned within *timeout* seconds." msgstr "" -#: library/multiprocessing.rst:2333 +#: library/multiprocessing.rst:2332 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:2339 +#: library/multiprocessing.rst:2338 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:2343 +#: library/multiprocessing.rst:2342 msgid "" "Hence an *iterable* of ``[(1,2), (3, 4)]`` results in ``[func(1,2), " "func(3,4)]``." msgstr "" -#: library/multiprocessing.rst:2350 +#: library/multiprocessing.rst:2349 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:2358 +#: library/multiprocessing.rst:2357 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:2363 +#: library/multiprocessing.rst:2362 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:2369 +#: library/multiprocessing.rst:2368 msgid "" "Wait for the worker processes to exit. One must call :meth:`close` or :meth:" "`terminate` before using :meth:`join`." msgstr "" -#: library/multiprocessing.rst:2372 +#: library/multiprocessing.rst:2371 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:2380 +#: library/multiprocessing.rst:2379 msgid "" "The class of the result returned by :meth:`Pool.apply_async` and :meth:`Pool." "map_async`." msgstr "" -#: library/multiprocessing.rst:2385 +#: library/multiprocessing.rst:2384 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 +2612,41 @@ msgid "" "exception will be reraised by :meth:`get`." msgstr "" -#: library/multiprocessing.rst:2392 +#: library/multiprocessing.rst:2391 msgid "Wait until the result is available or until *timeout* seconds pass." msgstr "" -#: library/multiprocessing.rst:2396 +#: library/multiprocessing.rst:2395 msgid "Return whether the call has completed." msgstr "" -#: library/multiprocessing.rst:2400 +#: library/multiprocessing.rst:2399 msgid "" "Return whether the call completed without raising an exception. Will raise :" "exc:`ValueError` if the result is not ready." msgstr "" -#: library/multiprocessing.rst:2403 +#: library/multiprocessing.rst:2402 msgid "" "If the result is not ready, :exc:`ValueError` is raised instead of :exc:" "`AssertionError`." msgstr "" -#: library/multiprocessing.rst:2407 +#: library/multiprocessing.rst:2406 msgid "The following example demonstrates the use of a pool::" msgstr "" -#: library/multiprocessing.rst:2434 +#: library/multiprocessing.rst:2433 msgid "Listeners and Clients" msgstr "" -#: library/multiprocessing.rst:2439 +#: library/multiprocessing.rst:2438 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:2443 +#: library/multiprocessing.rst:2442 msgid "" "However, the :mod:`multiprocessing.connection` module allows some extra " "flexibility. It basically gives a high level message oriented API for " @@ -2655,45 +2655,45 @@ msgid "" "multiple connections at the same time." msgstr "" -#: library/multiprocessing.rst:2452 +#: library/multiprocessing.rst:2451 msgid "" "Send a randomly generated message to the other end of the connection and " "wait for a reply." msgstr "" -#: library/multiprocessing.rst:2455 +#: library/multiprocessing.rst:2454 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:2461 +#: library/multiprocessing.rst:2460 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:2464 +#: library/multiprocessing.rst:2463 msgid "" "If a welcome message is not received, then :exc:`~multiprocessing." "AuthenticationError` is raised." msgstr "" -#: library/multiprocessing.rst:2469 +#: library/multiprocessing.rst:2468 msgid "" "Attempt to set up a connection to the listener which is using address " "*address*, returning a :class:`~Connection`." msgstr "" -#: library/multiprocessing.rst:2472 +#: library/multiprocessing.rst:2471 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:2476 library/multiprocessing.rst:2511 +#: library/multiprocessing.rst:2475 library/multiprocessing.rst:2510 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 +2702,26 @@ msgid "" "`multiprocessing-auth-keys`." msgstr "" -#: library/multiprocessing.rst:2484 +#: library/multiprocessing.rst:2483 msgid "" "A wrapper for a bound socket or Windows named pipe which is 'listening' for " "connections." msgstr "" -#: library/multiprocessing.rst:2487 +#: library/multiprocessing.rst:2486 msgid "" "*address* is the address to be used by the bound socket or named pipe of the " "listener object." msgstr "" -#: library/multiprocessing.rst:2492 +#: library/multiprocessing.rst:2491 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:2496 +#: library/multiprocessing.rst:2495 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 +2735,49 @@ msgid "" "using :func:`tempfile.mkstemp`." msgstr "" -#: library/multiprocessing.rst:2507 +#: library/multiprocessing.rst:2506 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:2519 +#: library/multiprocessing.rst:2518 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:2526 +#: library/multiprocessing.rst:2525 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:2530 +#: library/multiprocessing.rst:2529 msgid "Listener objects have the following read-only properties:" msgstr "" -#: library/multiprocessing.rst:2534 +#: library/multiprocessing.rst:2533 msgid "The address which is being used by the Listener object." msgstr "" -#: library/multiprocessing.rst:2538 +#: library/multiprocessing.rst:2537 msgid "" "The address from which the last accepted connection came. If this is " "unavailable then it is ``None``." msgstr "" -#: library/multiprocessing.rst:2541 +#: library/multiprocessing.rst:2540 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:2548 +#: library/multiprocessing.rst:2547 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 +2786,32 @@ msgid "" "zero timeout." msgstr "" -#: library/multiprocessing.rst:2554 +#: library/multiprocessing.rst:2553 msgid "" "For both POSIX and Windows, an object can appear in *object_list* if it is" msgstr "" -#: library/multiprocessing.rst:2557 +#: library/multiprocessing.rst:2556 msgid "a readable :class:`~multiprocessing.connection.Connection` object;" msgstr "" -#: library/multiprocessing.rst:2558 +#: library/multiprocessing.rst:2557 msgid "a connected and readable :class:`socket.socket` object; or" msgstr "" -#: library/multiprocessing.rst:2559 +#: library/multiprocessing.rst:2558 msgid "" "the :attr:`~multiprocessing.Process.sentinel` attribute of a :class:" "`~multiprocessing.Process` object." msgstr "" -#: library/multiprocessing.rst:2562 +#: library/multiprocessing.rst:2561 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:2565 +#: library/multiprocessing.rst:2564 msgid "" "**POSIX**: ``wait(object_list, timeout)`` almost equivalent ``select." "select(object_list, [], [], timeout)``. The difference is that, if :func:" @@ -2819,7 +2819,7 @@ msgid "" "an error number of ``EINTR``, whereas :func:`wait` will not." msgstr "" -#: library/multiprocessing.rst:2571 +#: library/multiprocessing.rst:2570 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 +2829,46 @@ msgid "" "handles.)" msgstr "" -#: library/multiprocessing.rst:2581 +#: library/multiprocessing.rst:2580 msgid "**Examples**" msgstr "" -#: library/multiprocessing.rst:2583 +#: library/multiprocessing.rst:2582 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:2602 +#: library/multiprocessing.rst:2601 msgid "" "The following code connects to the server and receives some data from the " "server::" msgstr "" -#: library/multiprocessing.rst:2619 +#: library/multiprocessing.rst:2618 msgid "" "The following code uses :func:`~multiprocessing.connection.wait` to wait for " "messages from multiple processes at once::" msgstr "" -#: library/multiprocessing.rst:2658 +#: library/multiprocessing.rst:2657 msgid "Address Formats" msgstr "" -#: library/multiprocessing.rst:2660 +#: library/multiprocessing.rst:2659 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:2663 +#: library/multiprocessing.rst:2662 msgid "" "An ``'AF_UNIX'`` address is a string representing a filename on the " "filesystem." msgstr "" -#: library/multiprocessing.rst:2666 +#: library/multiprocessing.rst:2665 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 +2877,17 @@ msgid "" "instead." msgstr "" -#: library/multiprocessing.rst:2671 +#: library/multiprocessing.rst:2670 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:2678 +#: library/multiprocessing.rst:2677 msgid "Authentication keys" msgstr "" -#: library/multiprocessing.rst:2680 +#: library/multiprocessing.rst:2679 msgid "" "When one uses :meth:`Connection.recv `, the data received " "is automatically unpickled. Unfortunately unpickling data from an untrusted " @@ -2895,7 +2895,7 @@ msgid "" "use the :mod:`hmac` module to provide digest authentication." msgstr "" -#: library/multiprocessing.rst:2686 +#: library/multiprocessing.rst:2685 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 +2903,7 @@ msgid "" "using the same key does **not** involve sending the key over the connection.)" msgstr "" -#: library/multiprocessing.rst:2692 +#: library/multiprocessing.rst:2691 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 +2914,17 @@ msgid "" "setting up connections between themselves." msgstr "" -#: library/multiprocessing.rst:2700 +#: library/multiprocessing.rst:2699 msgid "" "Suitable authentication keys can also be generated by using :func:`os." "urandom`." msgstr "" -#: library/multiprocessing.rst:2704 +#: library/multiprocessing.rst:2703 msgid "Logging" msgstr "" -#: library/multiprocessing.rst:2706 +#: library/multiprocessing.rst:2705 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 +2932,27 @@ msgid "" "mixed up." msgstr "" -#: library/multiprocessing.rst:2713 +#: library/multiprocessing.rst:2712 msgid "" "Returns the logger used by :mod:`multiprocessing`. If necessary, a new one " "will be created." msgstr "" -#: library/multiprocessing.rst:2716 +#: library/multiprocessing.rst:2715 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:2720 +#: library/multiprocessing.rst:2719 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:2727 +#: library/multiprocessing.rst:2726 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 +2961,25 @@ msgid "" "``level`` argument." msgstr "" -#: library/multiprocessing.rst:2733 +#: library/multiprocessing.rst:2732 msgid "Below is an example session with logging turned on::" msgstr "" -#: library/multiprocessing.rst:2748 +#: library/multiprocessing.rst:2747 msgid "For a full table of logging levels, see the :mod:`logging` module." msgstr "" -#: library/multiprocessing.rst:2752 +#: library/multiprocessing.rst:2751 msgid "The :mod:`multiprocessing.dummy` module" msgstr "" -#: library/multiprocessing.rst:2757 +#: library/multiprocessing.rst:2756 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:2762 +#: library/multiprocessing.rst:2761 msgid "" "In particular, the ``Pool`` function provided by :mod:`multiprocessing." "dummy` returns an instance of :class:`ThreadPool`, which is a subclass of :" @@ -2987,7 +2987,7 @@ msgid "" "worker threads rather than worker processes." msgstr "" -#: library/multiprocessing.rst:2770 +#: library/multiprocessing.rst:2769 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 +2997,18 @@ msgid "" "pool.Pool.terminate` manually." msgstr "" -#: library/multiprocessing.rst:2777 +#: library/multiprocessing.rst:2776 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:2783 +#: library/multiprocessing.rst:2782 msgid "" "Unlike :class:`Pool`, *maxtasksperchild* and *context* cannot be provided." msgstr "" -#: library/multiprocessing.rst:2787 +#: library/multiprocessing.rst:2786 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 +3018,7 @@ msgid "" "is not understood by any other libraries." msgstr "" -#: library/multiprocessing.rst:2794 +#: library/multiprocessing.rst:2793 msgid "" "Users should generally prefer to use :class:`concurrent.futures." "ThreadPoolExecutor`, which has a simpler interface that was designed around " @@ -3027,69 +3027,69 @@ msgid "" "`asyncio`." msgstr "" -#: library/multiprocessing.rst:2804 +#: library/multiprocessing.rst:2803 msgid "Programming guidelines" msgstr "" -#: library/multiprocessing.rst:2806 +#: library/multiprocessing.rst:2805 msgid "" "There are certain guidelines and idioms which should be adhered to when " "using :mod:`multiprocessing`." msgstr "" -#: library/multiprocessing.rst:2811 +#: library/multiprocessing.rst:2810 msgid "All start methods" msgstr "" -#: library/multiprocessing.rst:2813 +#: library/multiprocessing.rst:2812 msgid "The following applies to all start methods." msgstr "" -#: library/multiprocessing.rst:2815 +#: library/multiprocessing.rst:2814 msgid "Avoid shared state" msgstr "" -#: library/multiprocessing.rst:2817 +#: library/multiprocessing.rst:2816 msgid "" "As far as possible one should try to avoid shifting large amounts of data " "between processes." msgstr "" -#: library/multiprocessing.rst:2820 +#: library/multiprocessing.rst:2819 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:2824 +#: library/multiprocessing.rst:2823 msgid "Picklability" msgstr "" -#: library/multiprocessing.rst:2826 +#: library/multiprocessing.rst:2825 msgid "Ensure that the arguments to the methods of proxies are picklable." msgstr "" -#: library/multiprocessing.rst:2828 +#: library/multiprocessing.rst:2827 msgid "Thread safety of proxies" msgstr "" -#: library/multiprocessing.rst:2830 +#: library/multiprocessing.rst:2829 msgid "" "Do not use a proxy object from more than one thread unless you protect it " "with a lock." msgstr "" -#: library/multiprocessing.rst:2833 +#: library/multiprocessing.rst:2832 msgid "" "(There is never a problem with different processes using the *same* proxy.)" msgstr "" -#: library/multiprocessing.rst:2835 +#: library/multiprocessing.rst:2834 msgid "Joining zombie processes" msgstr "" -#: library/multiprocessing.rst:2837 +#: library/multiprocessing.rst:2836 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 +3100,11 @@ msgid "" "explicitly join all the processes that you start." msgstr "" -#: library/multiprocessing.rst:2845 +#: library/multiprocessing.rst:2844 msgid "Better to inherit than pickle/unpickle" msgstr "" -#: library/multiprocessing.rst:2847 +#: library/multiprocessing.rst:2846 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 +3114,11 @@ msgid "" "inherit it from an ancestor process." msgstr "" -#: library/multiprocessing.rst:2855 +#: library/multiprocessing.rst:2854 msgid "Avoid terminating processes" msgstr "" -#: library/multiprocessing.rst:2857 +#: library/multiprocessing.rst:2856 msgid "" "Using the :meth:`Process.terminate ` " "method to stop a process is liable to cause any shared resources (such as " @@ -3126,18 +3126,18 @@ msgid "" "become broken or unavailable to other processes." msgstr "" -#: library/multiprocessing.rst:2863 +#: library/multiprocessing.rst:2862 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:2867 +#: library/multiprocessing.rst:2866 msgid "Joining processes that use queues" msgstr "" -#: library/multiprocessing.rst:2869 +#: library/multiprocessing.rst:2868 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 +3146,7 @@ msgid "" "queue to avoid this behaviour.)" msgstr "" -#: library/multiprocessing.rst:2875 +#: library/multiprocessing.rst:2874 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 +3155,21 @@ msgid "" "processes will be joined automatically." msgstr "" -#: library/multiprocessing.rst:2881 +#: library/multiprocessing.rst:2880 msgid "An example which will deadlock is the following::" msgstr "" -#: library/multiprocessing.rst:2895 +#: library/multiprocessing.rst:2894 msgid "" "A fix here would be to swap the last two lines (or simply remove the ``p." "join()`` line)." msgstr "" -#: library/multiprocessing.rst:2898 +#: library/multiprocessing.rst:2897 msgid "Explicitly pass resources to child processes" msgstr "" -#: library/multiprocessing.rst:2900 +#: library/multiprocessing.rst:2899 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 +3177,7 @@ msgid "" "for the child process." msgstr "" -#: library/multiprocessing.rst:2905 +#: library/multiprocessing.rst:2904 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 +3186,29 @@ msgid "" "collected in the parent process." msgstr "" -#: library/multiprocessing.rst:2912 +#: library/multiprocessing.rst:2911 msgid "So for instance ::" msgstr "" -#: library/multiprocessing.rst:2924 +#: library/multiprocessing.rst:2923 msgid "should be rewritten as ::" msgstr "" -#: library/multiprocessing.rst:2936 +#: library/multiprocessing.rst:2935 msgid "Beware of replacing :data:`sys.stdin` with a \"file like object\"" msgstr "" -#: library/multiprocessing.rst:2938 +#: library/multiprocessing.rst:2937 msgid ":mod:`multiprocessing` originally unconditionally called::" msgstr "" -#: library/multiprocessing.rst:2942 +#: library/multiprocessing.rst:2941 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:2948 +#: library/multiprocessing.rst:2947 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 +3218,33 @@ msgid "" "data being flushed to the object multiple times, resulting in corruption." msgstr "" -#: library/multiprocessing.rst:2955 +#: library/multiprocessing.rst:2954 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:2967 +#: library/multiprocessing.rst:2966 msgid "" "For more information, see :issue:`5155`, :issue:`5313` and :issue:`5331`" msgstr "" -#: library/multiprocessing.rst:2970 +#: library/multiprocessing.rst:2969 msgid "The *spawn* and *forkserver* start methods" msgstr "" -#: library/multiprocessing.rst:2972 +#: library/multiprocessing.rst:2971 msgid "" -"There are a few extra restriction which don't apply to the *fork* start " +"There are a few extra restrictions which don't apply to the *fork* start " "method." msgstr "" -#: library/multiprocessing.rst:2975 +#: library/multiprocessing.rst:2974 msgid "More picklability" msgstr "" -#: library/multiprocessing.rst:2977 +#: library/multiprocessing.rst:2976 msgid "" "Ensure that all arguments to :meth:`Process.__init__` are picklable. Also, " "if you subclass :class:`~multiprocessing.Process` then make sure that " @@ -3252,11 +3252,11 @@ msgid "" "Process.start>` method is called." msgstr "" -#: library/multiprocessing.rst:2982 +#: library/multiprocessing.rst:2981 msgid "Global variables" msgstr "" -#: library/multiprocessing.rst:2984 +#: library/multiprocessing.rst:2983 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 +3264,66 @@ msgid "" "Process.start>` was called." msgstr "" -#: library/multiprocessing.rst:2989 +#: library/multiprocessing.rst:2988 msgid "" "However, global variables which are just module level constants cause no " "problems." msgstr "" -#: library/multiprocessing.rst:2994 +#: library/multiprocessing.rst:2993 msgid "Safe importing of main module" msgstr "" -#: library/multiprocessing.rst:2996 +#: library/multiprocessing.rst:2995 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:3000 +#: library/multiprocessing.rst:2999 msgid "" "For example, using the *spawn* or *forkserver* start method running the " "following module would fail with a :exc:`RuntimeError`::" msgstr "" -#: library/multiprocessing.rst:3012 +#: library/multiprocessing.rst:3011 msgid "" "Instead one should protect the \"entry point\" of the program by using ``if " "__name__ == '__main__':`` as follows::" msgstr "" -#: library/multiprocessing.rst:3026 +#: library/multiprocessing.rst:3025 msgid "" "(The ``freeze_support()`` line can be omitted if the program will be run " "normally instead of frozen.)" msgstr "" -#: library/multiprocessing.rst:3029 +#: library/multiprocessing.rst:3028 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:3032 +#: library/multiprocessing.rst:3031 msgid "" "Similar restrictions apply if a pool or manager is created in the main " "module." msgstr "" -#: library/multiprocessing.rst:3039 +#: library/multiprocessing.rst:3038 msgid "Examples" msgstr "" -#: library/multiprocessing.rst:3041 +#: library/multiprocessing.rst:3040 msgid "Demonstration of how to create and use customized managers and proxies:" msgstr "" -#: library/multiprocessing.rst:3047 +#: library/multiprocessing.rst:3046 msgid "Using :class:`~multiprocessing.pool.Pool`:" msgstr "" -#: library/multiprocessing.rst:3053 +#: library/multiprocessing.rst:3052 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/multiprocessing.shared_memory.po b/library/multiprocessing.shared_memory.po index 8f2133dd8..ef8f0465d 100644 --- a/library/multiprocessing.shared_memory.po +++ b/library/multiprocessing.shared_memory.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -33,19 +33,19 @@ msgid "" "multicore or symmetric multiprocessor (SMP) machine. To assist with the " "life-cycle management of shared memory especially across distinct processes, " "a :class:`~multiprocessing.managers.BaseManager` subclass, :class:" -"`SharedMemoryManager`, is also provided in the ``multiprocessing.managers`` " -"module." +"`~multiprocessing.managers.SharedMemoryManager`, is also provided in the :" +"mod:`multiprocessing.managers` module." msgstr "" #: library/multiprocessing.shared_memory.rst:26 msgid "" -"In this module, shared memory refers to \"System V style\" shared memory " -"blocks (though is not necessarily implemented explicitly as such) and does " -"not refer to \"distributed shared memory\". This style of shared memory " -"permits distinct processes to potentially read and write to a common (or " -"shared) region of volatile memory. Processes are conventionally limited to " -"only have access to their own process memory space but shared memory permits " -"the sharing of data between processes, avoiding the need to instead send " +"In this module, shared memory refers to \"POSIX style\" shared memory blocks " +"(though is not necessarily implemented explicitly as such) and does not " +"refer to \"distributed shared memory\". This style of shared memory permits " +"distinct processes to potentially read and write to a common (or shared) " +"region of volatile memory. Processes are conventionally limited to only " +"have access to their own process memory space but shared memory permits the " +"sharing of data between processes, avoiding the need to instead send " "messages between processes containing that data. Sharing data directly via " "memory can provide significant performance benefits compared to sharing data " "via disk or socket or other communications requiring the serialization/" @@ -54,242 +54,276 @@ msgstr "" #: library/multiprocessing.shared_memory.rst:41 msgid "" -"Creates a new shared memory block or attaches to an existing shared memory " -"block. Each shared memory block is assigned a unique name. In this way, one " -"process can create a shared memory block with a particular name and a " -"different process can attach to that same shared memory block using that " -"same name." +"Create an instance of the :class:`!SharedMemory` class for either creating a " +"new shared memory block or attaching to an existing shared memory block. " +"Each shared memory block is assigned a unique name. In this way, one process " +"can create a shared memory block with a particular name and a different " +"process can attach to that same shared memory block using that same name." msgstr "" -#: library/multiprocessing.shared_memory.rst:47 +#: library/multiprocessing.shared_memory.rst:48 msgid "" "As a resource for sharing data across processes, shared memory blocks may " "outlive the original process that created them. When one process no longer " "needs access to a shared memory block that might still be needed by other " -"processes, the :meth:`close()` method should be called. When a shared memory " -"block is no longer needed by any process, the :meth:`unlink()` method should " +"processes, the :meth:`close` method should be called. When a shared memory " +"block is no longer needed by any process, the :meth:`unlink` method should " "be called to ensure proper cleanup." msgstr "" -#: library/multiprocessing.shared_memory.rst:54 -msgid "" -"*name* is the unique name for the requested shared memory, specified as a " -"string. When creating a new shared memory block, if ``None`` (the default) " -"is supplied for the name, a novel name will be generated." +#: library/multiprocessing.shared_memory.rst:0 +msgid "Parameters" msgstr "" -#: library/multiprocessing.shared_memory.rst:58 +#: library/multiprocessing.shared_memory.rst:55 msgid "" -"*create* controls whether a new shared memory block is created (``True``) or " -"an existing shared memory block is attached (``False``)." +"The unique name for the requested shared memory, specified as a string. When " +"creating a new shared memory block, if ``None`` (the default) is supplied " +"for the name, a novel name will be generated." msgstr "" #: library/multiprocessing.shared_memory.rst:61 msgid "" -"*size* specifies the requested number of bytes when creating a new shared " -"memory block. Because some platforms choose to allocate chunks of memory " -"based upon that platform's memory page size, the exact size of the shared " -"memory block may be larger or equal to the size requested. When attaching " -"to an existing shared memory block, the ``size`` parameter is ignored." +"Control whether a new shared memory block is created (``True``) or an " +"existing shared memory block is attached (``False``)." +msgstr "" + +#: library/multiprocessing.shared_memory.rst:65 +msgid "" +"The requested number of bytes when creating a new shared memory block. " +"Because some platforms choose to allocate chunks of memory based upon that " +"platform's memory page size, the exact size of the shared memory block may " +"be larger or equal to the size requested. When attaching to an existing " +"shared memory block, the *size* parameter is ignored." msgstr "" -#: library/multiprocessing.shared_memory.rst:69 +#: library/multiprocessing.shared_memory.rst:75 msgid "" -"Closes access to the shared memory from this instance. In order to ensure " -"proper cleanup of resources, all instances should call ``close()`` once the " -"instance is no longer needed. Note that calling ``close()`` does not cause " -"the shared memory block itself to be destroyed." +"Close access to the shared memory from this instance. In order to ensure " +"proper cleanup of resources, all instances should call :meth:`close` once " +"the instance is no longer needed. Note that calling :meth:`!close` does not " +"cause the shared memory block itself to be destroyed." msgstr "" -#: library/multiprocessing.shared_memory.rst:77 +#: library/multiprocessing.shared_memory.rst:83 msgid "" -"Requests that the underlying shared memory block be destroyed. In order to " -"ensure proper cleanup of resources, ``unlink()`` should be called once (and " -"only once) across all processes which have need for the shared memory " +"Request that the underlying shared memory block be destroyed. In order to " +"ensure proper cleanup of resources, :meth:`unlink` should be called once " +"(and only once) across all processes which have need for the shared memory " "block. After requesting its destruction, a shared memory block may or may " "not be immediately destroyed and this behavior may differ across platforms. " -"Attempts to access data inside the shared memory block after ``unlink()`` " +"Attempts to access data inside the shared memory block after :meth:`!unlink` " "has been called may result in memory access errors. Note: the last process " -"relinquishing its hold on a shared memory block may call ``unlink()`` and :" -"meth:`close()` in either order." +"relinquishing its hold on a shared memory block may call :meth:`!unlink` " +"and :meth:`close` in either order." msgstr "" -#: library/multiprocessing.shared_memory.rst:90 +#: library/multiprocessing.shared_memory.rst:96 msgid "A memoryview of contents of the shared memory block." msgstr "" -#: library/multiprocessing.shared_memory.rst:94 +#: library/multiprocessing.shared_memory.rst:100 msgid "Read-only access to the unique name of the shared memory block." msgstr "" -#: library/multiprocessing.shared_memory.rst:98 +#: library/multiprocessing.shared_memory.rst:104 msgid "Read-only access to size in bytes of the shared memory block." msgstr "" -#: library/multiprocessing.shared_memory.rst:101 +#: library/multiprocessing.shared_memory.rst:107 msgid "" "The following example demonstrates low-level use of :class:`SharedMemory` " "instances::" msgstr "" -#: library/multiprocessing.shared_memory.rst:127 +#: library/multiprocessing.shared_memory.rst:133 msgid "" "The following example demonstrates a practical use of the :class:" "`SharedMemory` class with `NumPy arrays `_, accessing " -"the same ``numpy.ndarray`` from two distinct Python shells:" +"the same :class:`!numpy.ndarray` from two distinct Python shells:" msgstr "" -#: library/multiprocessing.shared_memory.rst:181 +#: library/multiprocessing.shared_memory.rst:187 msgid "" -"A subclass of :class:`~multiprocessing.managers.BaseManager` which can be " +"A subclass of :class:`multiprocessing.managers.BaseManager` which can be " "used for the management of shared memory blocks across processes." msgstr "" -#: library/multiprocessing.shared_memory.rst:184 +#: library/multiprocessing.shared_memory.rst:190 msgid "" -"A call to :meth:`~multiprocessing.managers.BaseManager.start` on a :class:" -"`SharedMemoryManager` instance causes a new process to be started. This new " +"A call to :meth:`~multiprocessing.managers.BaseManager.start` on a :class:`!" +"SharedMemoryManager` instance causes a new process to be started. This new " "process's sole purpose is to manage the life cycle of all shared memory " "blocks created through it. To trigger the release of all shared memory " "blocks managed by that process, call :meth:`~multiprocessing.managers." -"BaseManager.shutdown()` on the instance. This triggers a :meth:`SharedMemory." -"unlink()` call on all of the :class:`SharedMemory` objects managed by that " -"process and then stops the process itself. By creating ``SharedMemory`` " -"instances through a ``SharedMemoryManager``, we avoid the need to manually " -"track and trigger the freeing of shared memory resources." +"BaseManager.shutdown` on the instance. This triggers a :meth:" +"`~multiprocessing.shared_memory.SharedMemory.unlink` call on all of the :" +"class:`SharedMemory` objects managed by that process and then stops the " +"process itself. By creating :class:`!SharedMemory` instances through a :" +"class:`!SharedMemoryManager`, we avoid the need to manually track and " +"trigger the freeing of shared memory resources." msgstr "" -#: library/multiprocessing.shared_memory.rst:196 +#: library/multiprocessing.shared_memory.rst:202 msgid "" "This class provides methods for creating and returning :class:`SharedMemory` " "instances and for creating a list-like object (:class:`ShareableList`) " "backed by shared memory." msgstr "" -#: library/multiprocessing.shared_memory.rst:200 +#: library/multiprocessing.shared_memory.rst:206 msgid "" -"Refer to :class:`multiprocessing.managers.BaseManager` for a description of " +"Refer to :class:`~multiprocessing.managers.BaseManager` for a description of " "the inherited *address* and *authkey* optional input arguments and how they " -"may be used to connect to an existing ``SharedMemoryManager`` service from " -"other processes." +"may be used to connect to an existing :class:`!SharedMemoryManager` service " +"from other processes." msgstr "" -#: library/multiprocessing.shared_memory.rst:207 +#: library/multiprocessing.shared_memory.rst:213 msgid "" "Create and return a new :class:`SharedMemory` object with the specified " -"``size`` in bytes." +"*size* in bytes." msgstr "" -#: library/multiprocessing.shared_memory.rst:212 +#: library/multiprocessing.shared_memory.rst:218 msgid "" "Create and return a new :class:`ShareableList` object, initialized by the " -"values from the input ``sequence``." +"values from the input *sequence*." msgstr "" -#: library/multiprocessing.shared_memory.rst:216 +#: library/multiprocessing.shared_memory.rst:222 msgid "" "The following example demonstrates the basic mechanisms of a :class:" -"`SharedMemoryManager`:" +"`~multiprocessing.managers.SharedMemoryManager`:" msgstr "" -#: library/multiprocessing.shared_memory.rst:234 +#: library/multiprocessing.shared_memory.rst:240 msgid "" "The following example depicts a potentially more convenient pattern for " -"using :class:`SharedMemoryManager` objects via the :keyword:`with` statement " -"to ensure that all shared memory blocks are released after they are no " -"longer needed:" +"using :class:`~multiprocessing.managers.SharedMemoryManager` objects via " +"the :keyword:`with` statement to ensure that all shared memory blocks are " +"released after they are no longer needed:" msgstr "" -#: library/multiprocessing.shared_memory.rst:253 +#: library/multiprocessing.shared_memory.rst:259 msgid "" -"When using a :class:`SharedMemoryManager` in a :keyword:`with` statement, " -"the shared memory blocks created using that manager are all released when " -"the :keyword:`with` statement's code block finishes execution." +"When using a :class:`~multiprocessing.managers.SharedMemoryManager` in a :" +"keyword:`with` statement, the shared memory blocks created using that " +"manager are all released when the :keyword:`!with` statement's code block " +"finishes execution." msgstr "" -#: library/multiprocessing.shared_memory.rst:260 +#: library/multiprocessing.shared_memory.rst:267 msgid "" -"Provides a mutable list-like object where all values stored within are " -"stored in a shared memory block. This constrains storable values to only " -"the ``int`` (signed 64-bit), ``float``, ``bool``, ``str`` (less than 10M " -"bytes each when encoded as utf-8), ``bytes`` (less than 10M bytes each), and " -"``None`` built-in data types. It also notably differs from the built-in " -"``list`` type in that these lists can not change their overall length (i.e. " -"no append, insert, etc.) and do not support the dynamic creation of new :" -"class:`ShareableList` instances via slicing." +"Provide a mutable list-like object where all values stored within are stored " +"in a shared memory block. This constrains storable values to the following " +"built-in data types:" msgstr "" -#: library/multiprocessing.shared_memory.rst:270 -msgid "" -"*sequence* is used in populating a new ``ShareableList`` full of values. Set " -"to ``None`` to instead attach to an already existing ``ShareableList`` by " -"its unique shared memory name." +#: library/multiprocessing.shared_memory.rst:271 +msgid ":class:`int` (signed 64-bit)" +msgstr "" + +#: library/multiprocessing.shared_memory.rst:272 +msgid ":class:`float`" +msgstr "" + +#: library/multiprocessing.shared_memory.rst:273 +msgid ":class:`bool`" msgstr "" #: library/multiprocessing.shared_memory.rst:274 +msgid ":class:`str` (less than 10M bytes each when encoded as UTF-8)" +msgstr "" + +#: library/multiprocessing.shared_memory.rst:275 +msgid ":class:`bytes` (less than 10M bytes each)" +msgstr "" + +#: library/multiprocessing.shared_memory.rst:276 +msgid "``None``" +msgstr "" + +#: library/multiprocessing.shared_memory.rst:278 +msgid "" +"It also notably differs from the built-in :class:`list` type in that these " +"lists can not change their overall length (i.e. no :meth:`!append`, :meth:`!" +"insert`, etc.) and do not support the dynamic creation of new :class:`!" +"ShareableList` instances via slicing." +msgstr "" + +#: library/multiprocessing.shared_memory.rst:284 +msgid "" +"*sequence* is used in populating a new :class:`!ShareableList` full of " +"values. Set to ``None`` to instead attach to an already existing :class:`!" +"ShareableList` by its unique shared memory name." +msgstr "" + +#: library/multiprocessing.shared_memory.rst:288 msgid "" "*name* is the unique name for the requested shared memory, as described in " -"the definition for :class:`SharedMemory`. When attaching to an existing " -"``ShareableList``, specify its shared memory block's unique name while " -"leaving ``sequence`` set to ``None``." +"the definition for :class:`SharedMemory`. When attaching to an existing :" +"class:`!ShareableList`, specify its shared memory block's unique name while " +"leaving *sequence* set to ``None``." msgstr "" -#: library/multiprocessing.shared_memory.rst:281 +#: library/multiprocessing.shared_memory.rst:295 msgid "" "A known issue exists for :class:`bytes` and :class:`str` values. If they end " "with ``\\x00`` nul bytes or characters, those may be *silently stripped* " -"when fetching them by index from the :class:`ShareableList`. This ``." +"when fetching them by index from the :class:`!ShareableList`. This ``." "rstrip(b'\\x00')`` behavior is considered a bug and may go away in the " "future. See :gh:`106939`." msgstr "" -#: library/multiprocessing.shared_memory.rst:287 +#: library/multiprocessing.shared_memory.rst:301 msgid "" "For applications where rstripping of trailing nulls is a problem, work " "around it by always unconditionally appending an extra non-0 byte to the end " "of such values when storing and unconditionally removing it when fetching:" msgstr "" -#: library/multiprocessing.shared_memory.rst:310 -msgid "Returns the number of occurrences of ``value``." +#: library/multiprocessing.shared_memory.rst:324 +msgid "Return the number of occurrences of *value*." msgstr "" -#: library/multiprocessing.shared_memory.rst:314 +#: library/multiprocessing.shared_memory.rst:328 msgid "" -"Returns first index position of ``value``. Raises :exc:`ValueError` if " -"``value`` is not present." +"Return first index position of *value*. Raise :exc:`ValueError` if *value* " +"is not present." msgstr "" -#: library/multiprocessing.shared_memory.rst:319 +#: library/multiprocessing.shared_memory.rst:333 msgid "" "Read-only attribute containing the :mod:`struct` packing format used by all " "currently stored values." msgstr "" -#: library/multiprocessing.shared_memory.rst:324 +#: library/multiprocessing.shared_memory.rst:338 msgid "The :class:`SharedMemory` instance where the values are stored." msgstr "" -#: library/multiprocessing.shared_memory.rst:327 +#: library/multiprocessing.shared_memory.rst:341 msgid "" "The following example demonstrates basic use of a :class:`ShareableList` " "instance:" msgstr "" -#: library/multiprocessing.shared_memory.rst:360 +#: library/multiprocessing.shared_memory.rst:374 msgid "" "The following example depicts how one, two, or many processes may access the " "same :class:`ShareableList` by supplying the name of the shared memory block " "behind it:" msgstr "" -#: library/multiprocessing.shared_memory.rst:375 +#: library/multiprocessing.shared_memory.rst:389 msgid "" -"The following examples demonstrates that ``ShareableList`` (and underlying " -"``SharedMemory``) objects can be pickled and unpickled if needed. Note, that " -"it will still be the same shared object. This happens, because the " -"deserialized object has the same unique name and is just attached to an " -"existing object with the same name (if the object is still alive):" +"The following examples demonstrates that :class:`ShareableList` (and " +"underlying :class:`SharedMemory`) objects can be pickled and unpickled if " +"needed. Note, that it will still be the same shared object. This happens, " +"because the deserialized object has the same unique name and is just " +"attached to an existing object with the same name (if the object is still " +"alive):" msgstr "" #: library/multiprocessing.shared_memory.rst:11 diff --git a/library/nntplib.po b/library/nntplib.po index 75872bc7d..df48185e7 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -81,13 +81,13 @@ msgid "" "close the NNTP connection when done, e.g.:" msgstr "" -#: library/nntplib.rst:146 +#: library/nntplib.rst:148 msgid "" "Raises an :ref:`auditing event ` ``nntplib.connect`` with " "arguments ``self``, ``host``, ``port``." msgstr "" -#: library/nntplib.rst:148 +#: library/nntplib.rst:150 msgid "" "Raises an :ref:`auditing event ` ``nntplib.putline`` with " "arguments ``self``, ``line``." diff --git a/library/os.po b/library/os.po index 09a8565e3..8f0344b61 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -287,14 +287,14 @@ msgstr "" #: library/os.rst:661 library/os.rst:687 library/os.rst:703 library/os.rst:719 #: library/os.rst:735 library/os.rst:1345 library/os.rst:1608 #: library/os.rst:1637 library/os.rst:2110 library/os.rst:2433 -#: library/os.rst:4039 library/os.rst:4053 library/os.rst:4067 -#: library/os.rst:4081 library/os.rst:4097 library/os.rst:4111 -#: library/os.rst:4128 library/os.rst:4143 library/os.rst:4226 -#: library/os.rst:4273 library/os.rst:4430 library/os.rst:4716 -#: library/os.rst:4811 library/os.rst:4842 library/os.rst:4868 -#: library/os.rst:4893 library/os.rst:4912 library/os.rst:4976 -#: library/os.rst:4999 library/os.rst:5015 library/os.rst:5033 -#: library/os.rst:5042 +#: library/os.rst:4040 library/os.rst:4054 library/os.rst:4068 +#: library/os.rst:4082 library/os.rst:4098 library/os.rst:4112 +#: library/os.rst:4129 library/os.rst:4144 library/os.rst:4227 +#: library/os.rst:4274 library/os.rst:4431 library/os.rst:4717 +#: library/os.rst:4812 library/os.rst:4843 library/os.rst:4869 +#: library/os.rst:4894 library/os.rst:4913 library/os.rst:4977 +#: library/os.rst:5000 library/os.rst:5016 library/os.rst:5034 +#: library/os.rst:5043 msgid ":ref:`Availability `: Unix, not Emscripten, not WASI." msgstr "" @@ -450,8 +450,8 @@ msgid "" msgstr "" #: library/os.rst:1086 library/os.rst:1110 library/os.rst:1649 -#: library/os.rst:2533 library/os.rst:3415 library/os.rst:4567 -#: library/os.rst:4695 +#: library/os.rst:2533 library/os.rst:3416 library/os.rst:4568 +#: library/os.rst:4696 msgid ":ref:`Availability `: Unix, Windows." msgstr "" @@ -473,9 +473,9 @@ msgstr "" #: library/os.rst:376 library/os.rst:787 library/os.rst:1019 #: library/os.rst:1053 library/os.rst:1138 library/os.rst:1396 #: library/os.rst:1424 library/os.rst:1708 library/os.rst:1770 -#: library/os.rst:2124 library/os.rst:2499 library/os.rst:3244 -#: library/os.rst:3634 library/os.rst:5199 library/os.rst:5230 -#: library/os.rst:5239 +#: library/os.rst:2124 library/os.rst:2499 library/os.rst:3245 +#: library/os.rst:3635 library/os.rst:5200 library/os.rst:5231 +#: library/os.rst:5240 msgid ":ref:`Availability `: Unix." msgstr "" @@ -546,8 +546,8 @@ msgid "" "getpwuid(os.getuid())[0]`` to get the login name of the current real user id." msgstr "" -#: library/os.rst:462 library/os.rst:4250 library/os.rst:4672 -#: library/os.rst:4960 +#: library/os.rst:462 library/os.rst:4251 library/os.rst:4673 +#: library/os.rst:4961 msgid "" ":ref:`Availability `: Unix, Windows, not Emscripten, not WASI." msgstr "" @@ -843,7 +843,7 @@ msgid "" "or even ``socket.gethostbyaddr(socket.gethostname())``." msgstr "" -#: library/os.rst:4697 +#: library/os.rst:4698 msgid "" "Return type changed from a tuple to a tuple-like object with named " "attributes." @@ -1078,7 +1078,7 @@ msgid "" msgstr "" #: library/os.rst:1021 library/os.rst:1651 library/os.rst:2095 -#: library/os.rst:3380 +#: library/os.rst:3381 msgid "" "The function is limited on Emscripten and WASI, see :ref:`wasm-availability` " "for more information." @@ -1178,7 +1178,7 @@ msgid "" "``fd``, ``length``." msgstr "" -#: library/os.rst:3419 +#: library/os.rst:3420 msgid "Added support for Windows" msgstr "" @@ -1372,11 +1372,12 @@ msgid "" "a file descriptor in a file object, use :func:`fdopen`." msgstr "" -#: library/os.rst:2367 library/os.rst:2457 library/os.rst:2569 -msgid "The *dir_fd* argument." +#: library/os.rst:2331 library/os.rst:2435 library/os.rst:2538 +#: library/os.rst:2676 library/os.rst:3436 +msgid "Added the *dir_fd* parameter." msgstr "" -#: library/os.rst:1576 library/os.rst:4793 +#: library/os.rst:1576 library/os.rst:4794 msgid "" "If the system call is interrupted and the signal handler does not raise an " "exception, the function now retries the system call instead of raising an :" @@ -1386,8 +1387,8 @@ msgstr "" #: library/os.rst:1963 library/os.rst:2026 library/os.rst:2112 #: library/os.rst:2170 library/os.rst:2242 library/os.rst:2370 #: library/os.rst:2438 library/os.rst:2501 library/os.rst:2591 -#: library/os.rst:2969 library/os.rst:3422 library/os.rst:3478 -#: library/os.rst:3638 library/os.rst:4002 library/os.rst:4555 +#: library/os.rst:2969 library/os.rst:3423 library/os.rst:3479 +#: library/os.rst:3639 library/os.rst:4003 library/os.rst:4556 msgid "Accepts a :term:`path-like object`." msgstr "" @@ -1925,7 +1926,7 @@ msgstr "" msgid "Get the \"inheritable\" flag of the specified handle (a boolean)." msgstr "" -#: library/os.rst:1855 library/os.rst:4590 library/os.rst:4635 +#: library/os.rst:1855 library/os.rst:4591 library/os.rst:4636 msgid ":ref:`Availability `: Windows." msgstr "" @@ -2154,7 +2155,7 @@ msgid "" msgstr "" #: library/os.rst:2023 -msgid "The *follow_symlinks* argument." +msgid "Added the *follow_symlinks* parameter." msgstr "" #: library/os.rst:2032 @@ -2240,7 +2241,7 @@ msgstr "" msgid ":const:`stat.S_IXOTH`" msgstr "" -#: library/os.rst:2084 library/os.rst:3468 +#: library/os.rst:2084 library/os.rst:3469 msgid "" "This function can support :ref:`specifying a file descriptor `, :" "ref:`paths relative to directory descriptors ` and :ref:`not " @@ -2357,15 +2358,15 @@ msgstr "" msgid ":ref:`Availability `: Unix, Windows, not Emscripten." msgstr "" -#: library/os.rst:2199 +#: library/os.rst:4253 msgid "Added Windows support." msgstr "" #: library/os.rst:2202 -msgid "Added the *src_dir_fd*, *dst_dir_fd*, and *follow_symlinks* arguments." +msgid "Added the *src_dir_fd*, *dst_dir_fd*, and *follow_symlinks* parameters." msgstr "" -#: library/os.rst:2623 library/os.rst:3390 +#: library/os.rst:2623 library/os.rst:3391 msgid "Accepts a :term:`path-like object` for *src* and *dst*." msgstr "" @@ -2412,7 +2413,7 @@ msgstr "" msgid "The *path* parameter became optional." msgstr "" -#: library/os.rst:3249 +#: library/os.rst:3250 msgid "Added support for specifying *path* as an open file descriptor." msgstr "" @@ -2521,14 +2522,10 @@ msgid "" "`." msgstr "" -#: library/os.rst:2535 library/os.rst:3383 +#: library/os.rst:2535 library/os.rst:3384 msgid "Added support for Windows 6.0 (Vista) symbolic links." msgstr "" -#: library/os.rst:2331 -msgid "Added the *dir_fd* parameter." -msgstr "" - #: library/os.rst:2337 msgid "" "On Windows, now opens reparse points that represent another path (name " @@ -2601,7 +2598,7 @@ msgid "This function handles UNC paths correctly." msgstr "" #: library/os.rst:2401 -msgid "The *exist_ok* parameter." +msgid "Added the *exist_ok* parameter." msgstr "" #: library/os.rst:2406 @@ -2672,7 +2669,7 @@ msgid "" "included in that mapping, passing an integer for *name* is also accepted." msgstr "" -#: library/os.rst:3242 library/os.rst:3411 +#: library/os.rst:3243 library/os.rst:3412 msgid "" "This function can support :ref:`specifying a file descriptor `." msgstr "" @@ -2728,7 +2725,7 @@ msgid "" "does not exist, a :exc:`FileNotFoundError` is raised." msgstr "" -#: library/os.rst:2671 library/os.rst:3362 +#: library/os.rst:2671 library/os.rst:3363 msgid "" "This function can support :ref:`paths relative to directory descriptors " "`." @@ -2746,7 +2743,7 @@ msgstr "" msgid "This function is semantically identical to :func:`unlink`." msgstr "" -#: library/os.rst:2589 library/os.rst:3433 +#: library/os.rst:2589 library/os.rst:3434 msgid "" "Raises an :ref:`auditing event ` ``os.remove`` with arguments " "``path``, ``dir_fd``." @@ -2808,7 +2805,7 @@ msgid "" msgstr "" #: library/os.rst:2620 -msgid "The *src_dir_fd* and *dst_dir_fd* arguments." +msgid "Added the *src_dir_fd* and *dst_dir_fd* parameters." msgstr "" #: library/os.rst:2629 @@ -2853,10 +2850,6 @@ msgid "" "``path``, ``dir_fd``." msgstr "" -#: library/os.rst:3435 -msgid "The *dir_fd* parameter." -msgstr "" - #: library/os.rst:2685 msgid "" "Return an iterator of :class:`os.DirEntry` objects corresponding to the " @@ -3186,7 +3179,7 @@ msgid "" "``follow_symlinks=False``, or use :func:`lstat`." msgstr "" -#: library/os.rst:3801 library/os.rst:3833 library/os.rst:3853 +#: library/os.rst:3802 library/os.rst:3834 library/os.rst:3854 msgid "" "This function can support :ref:`specifying a file descriptor ` and :" "ref:`not following symlinks `." @@ -3206,7 +3199,7 @@ msgid "" "junction points, which will raise the usual exceptions." msgstr "" -#: library/os.rst:3721 +#: library/os.rst:3722 msgid "Example::" msgstr "" @@ -3216,7 +3209,7 @@ msgstr "" #: library/os.rst:2965 msgid "" -"Added the *dir_fd* and *follow_symlinks* arguments, specifying a file " +"Added the *dir_fd* and *follow_symlinks* parameters, specifying a file " "descriptor instead of a path." msgstr "" @@ -3311,41 +3304,41 @@ msgstr "" msgid "Time of most recent access expressed in nanoseconds as an integer." msgstr "" -#: library/os.rst:3050 +#: library/os.rst:3052 msgid "" "Time of most recent content modification expressed in nanoseconds as an " "integer." msgstr "" -#: library/os.rst:3055 +#: library/os.rst:3059 msgid "" "Time of most recent metadata change expressed in nanoseconds as an integer." msgstr "" -#: library/os.rst:3058 +#: library/os.rst:3064 msgid "" "``st_ctime_ns`` is deprecated on Windows. Use ``st_birthtime_ns`` for the " "file creation time. In the future, ``st_ctime`` will contain the time of the " "most recent metadata change, as for other platforms." msgstr "" -#: library/os.rst:3065 +#: library/os.rst:3071 msgid "" "Time of file creation expressed in seconds. This attribute is not always " "available, and may raise :exc:`AttributeError`." msgstr "" -#: library/os.rst:3068 +#: library/os.rst:3074 msgid "``st_birthtime`` is now available on Windows." msgstr "" -#: library/os.rst:3073 +#: library/os.rst:3079 msgid "" "Time of file creation expressed in nanoseconds as an integer. This attribute " "is not always available, and may raise :exc:`AttributeError`." msgstr "" -#: library/os.rst:3081 +#: library/os.rst:3087 msgid "" "The exact meaning and resolution of the :attr:`st_atime`, :attr:`st_mtime`, :" "attr:`st_ctime` and :attr:`st_birthtime` attributes depend on the operating " @@ -3355,7 +3348,7 @@ msgid "" "details." msgstr "" -#: library/os.rst:3088 +#: library/os.rst:3094 msgid "" "Similarly, although :attr:`st_atime_ns`, :attr:`st_mtime_ns`, :attr:" "`st_ctime_ns` and :attr:`st_birthtime_ns` are always expressed in " @@ -3368,74 +3361,74 @@ msgid "" "`st_birthtime_ns`." msgstr "" -#: library/os.rst:3098 +#: library/os.rst:3104 msgid "" "On some Unix systems (such as Linux), the following attributes may also be " "available:" msgstr "" -#: library/os.rst:3103 +#: library/os.rst:3109 msgid "" "Number of 512-byte blocks allocated for file. This may be smaller than :attr:" "`st_size`/512 when the file has holes." msgstr "" -#: library/os.rst:3108 +#: library/os.rst:3114 msgid "" "\"Preferred\" blocksize for efficient file system I/O. Writing to a file in " "smaller chunks may cause an inefficient read-modify-rewrite." msgstr "" -#: library/os.rst:3113 +#: library/os.rst:3119 msgid "Type of device if an inode device." msgstr "" -#: library/os.rst:3117 +#: library/os.rst:3123 msgid "User defined flags for file." msgstr "" -#: library/os.rst:3119 +#: library/os.rst:3125 msgid "" "On other Unix systems (such as FreeBSD), the following attributes may be " "available (but may be only filled out if root tries to use them):" msgstr "" -#: library/os.rst:3124 +#: library/os.rst:3130 msgid "File generation number." msgstr "" -#: library/os.rst:3126 +#: library/os.rst:3132 msgid "" "On Solaris and derivatives, the following attributes may also be available:" msgstr "" -#: library/os.rst:3131 +#: library/os.rst:3137 msgid "" "String that uniquely identifies the type of the filesystem that contains the " "file." msgstr "" -#: library/os.rst:3134 +#: library/os.rst:3140 msgid "On macOS systems, the following attributes may also be available:" msgstr "" -#: library/os.rst:3138 +#: library/os.rst:3144 msgid "Real size of the file." msgstr "" -#: library/os.rst:3142 +#: library/os.rst:3148 msgid "Creator of the file." msgstr "" -#: library/os.rst:3146 +#: library/os.rst:3152 msgid "File type." msgstr "" -#: library/os.rst:3148 +#: library/os.rst:3154 msgid "On Windows systems, the following attributes are also available:" msgstr "" -#: library/os.rst:3152 +#: library/os.rst:3158 msgid "" "Windows file attributes: ``dwFileAttributes`` member of the " "``BY_HANDLE_FILE_INFORMATION`` structure returned by :c:func:`!" @@ -3443,7 +3436,7 @@ msgid "" "FILE_ATTRIBUTE_ARCHIVE>` constants in the :mod:`stat` module." msgstr "" -#: library/os.rst:3160 +#: library/os.rst:3168 msgid "" "When :attr:`st_file_attributes` has the :const:`~stat." "FILE_ATTRIBUTE_REPARSE_POINT` set, this field contains the tag identifying " @@ -3451,14 +3444,14 @@ msgid "" "IO_REPARSE_TAG_SYMLINK>` constants in the :mod:`stat` module." msgstr "" -#: library/os.rst:3165 +#: library/os.rst:3173 msgid "" "The standard module :mod:`stat` defines functions and constants that are " "useful for extracting information from a :c:struct:`stat` structure. (On " "Windows, some items are filled with dummy values.)" msgstr "" -#: library/os.rst:3169 +#: library/os.rst:3177 msgid "" "For backward compatibility, a :class:`stat_result` instance is also " "accessible as a tuple of at least 10 integers giving the most important (and " @@ -3470,59 +3463,49 @@ msgid "" "class:`stat_result` as a tuple always returns integers." msgstr "" -#: library/os.rst:3178 -msgid "" -"Added the :attr:`st_atime_ns`, :attr:`st_mtime_ns`, and :attr:`st_ctime_ns` " -"members." -msgstr "" - -#: library/os.rst:3182 -msgid "Added the :attr:`st_file_attributes` member on Windows." -msgstr "" - -#: library/os.rst:3185 +#: library/os.rst:3186 msgid "Windows now returns the file index as :attr:`st_ino` when available." msgstr "" -#: library/os.rst:3189 +#: library/os.rst:3190 msgid "Added the :attr:`st_fstype` member to Solaris/derivatives." msgstr "" -#: library/os.rst:3192 +#: library/os.rst:3193 msgid "Added the :attr:`st_reparse_tag` member on Windows." msgstr "" -#: library/os.rst:3195 +#: library/os.rst:3196 msgid "" "On Windows, the :attr:`st_mode` member now identifies special files as :" "const:`S_IFCHR`, :const:`S_IFIFO` or :const:`S_IFBLK` as appropriate." msgstr "" -#: library/os.rst:3200 +#: library/os.rst:3201 msgid "" "On Windows, :attr:`st_ctime` is deprecated. Eventually, it will contain the " "last metadata change time, for consistency with other platforms, but for now " "still contains creation time. Use :attr:`st_birthtime` for the creation time." msgstr "" -#: library/os.rst:3206 +#: library/os.rst:3207 msgid "" "On Windows, :attr:`st_ino` may now be up to 128 bits, depending on the file " "system. Previously it would not be above 64 bits, and larger file " "identifiers would be arbitrarily packed." msgstr "" -#: library/os.rst:3211 +#: library/os.rst:3212 msgid "" "On Windows, :attr:`st_rdev` no longer returns a value. Previously it would " "contain the same as :attr:`st_dev`, which was incorrect." msgstr "" -#: library/os.rst:3215 +#: library/os.rst:3216 msgid "Added the :attr:`st_birthtime` member on Windows." msgstr "" -#: library/os.rst:3221 +#: library/os.rst:3222 msgid "" "Perform a :c:func:`!statvfs` system call on the given path. The return " "value is an object whose attributes describe the filesystem on the given " @@ -3532,7 +3515,7 @@ msgid "" "`f_favail`, :attr:`f_flag`, :attr:`f_namemax`, :attr:`f_fsid`." msgstr "" -#: library/os.rst:3228 +#: library/os.rst:3229 msgid "" "Two module-level constants are defined for the :attr:`f_flag` attribute's " "bit-flags: if :const:`ST_RDONLY` is set, the filesystem is mounted read-" @@ -3540,7 +3523,7 @@ msgid "" "are disabled or not supported." msgstr "" -#: library/os.rst:3233 +#: library/os.rst:3234 msgid "" "Additional module-level constants are defined for GNU/glibc based systems. " "These are :const:`ST_NODEV` (disallow access to device special files), :" @@ -3553,11 +3536,11 @@ msgid "" "relative to mtime/ctime)." msgstr "" -#: library/os.rst:3246 +#: library/os.rst:3247 msgid "The :const:`ST_RDONLY` and :const:`ST_NOSUID` constants were added." msgstr "" -#: library/os.rst:3252 +#: library/os.rst:3253 msgid "" "The :const:`ST_NODEV`, :const:`ST_NOEXEC`, :const:`ST_SYNCHRONOUS`, :const:" "`ST_MANDLOCK`, :const:`ST_WRITE`, :const:`ST_APPEND`, :const:" @@ -3565,11 +3548,11 @@ msgid "" "`ST_RELATIME` constants were added." msgstr "" -#: library/os.rst:3261 -msgid "Added :attr:`f_fsid`." +#: library/os.rst:3262 +msgid "Added the :attr:`f_fsid` attribute." msgstr "" -#: library/os.rst:3267 +#: library/os.rst:3268 msgid "" "A :class:`set` object indicating which functions in the :mod:`os` module " "accept an open file descriptor for their *dir_fd* parameter. Different " @@ -3581,7 +3564,7 @@ msgid "" "(Specifying ``None`` for *dir_fd* is always supported on all platforms.)" msgstr "" -#: library/os.rst:3277 +#: library/os.rst:3278 msgid "" "To check whether a particular function accepts an open file descriptor for " "its *dir_fd* parameter, use the ``in`` operator on ``supports_dir_fd``. As " @@ -3589,13 +3572,13 @@ msgid "" "open file descriptors for *dir_fd* on the local platform::" msgstr "" -#: library/os.rst:3284 +#: library/os.rst:3285 msgid "" "Currently *dir_fd* parameters only work on Unix platforms; none of them work " "on Windows." msgstr "" -#: library/os.rst:3292 +#: library/os.rst:3293 msgid "" "A :class:`set` object indicating whether :func:`os.access` permits " "specifying ``True`` for its *effective_ids* parameter on the local platform. " @@ -3604,19 +3587,19 @@ msgid "" "func:`os.access`; otherwise it will be empty." msgstr "" -#: library/os.rst:3298 +#: library/os.rst:3299 msgid "" "This expression evaluates to ``True`` if :func:`os.access` supports " "``effective_ids=True`` on the local platform::" msgstr "" -#: library/os.rst:3303 +#: library/os.rst:3304 msgid "" "Currently *effective_ids* is only supported on Unix platforms; it does not " "work on Windows." msgstr "" -#: library/os.rst:3311 +#: library/os.rst:3312 msgid "" "A :class:`set` object indicating which functions in the :mod:`os` module " "permit specifying their *path* parameter as an open file descriptor on the " @@ -3625,7 +3608,7 @@ msgid "" "*path* arguments is not available on all platforms Python supports." msgstr "" -#: library/os.rst:3318 +#: library/os.rst:3319 msgid "" "To determine whether a particular function permits specifying an open file " "descriptor for its *path* parameter, use the ``in`` operator on " @@ -3634,7 +3617,7 @@ msgid "" "platform::" msgstr "" -#: library/os.rst:3331 +#: library/os.rst:3332 msgid "" "A :class:`set` object indicating which functions in the :mod:`os` module " "accept ``False`` for their *follow_symlinks* parameter on the local " @@ -3647,7 +3630,7 @@ msgid "" "on all platforms.)" msgstr "" -#: library/os.rst:3341 +#: library/os.rst:3342 msgid "" "To check whether a particular function accepts ``False`` for its " "*follow_symlinks* parameter, use the ``in`` operator on " @@ -3656,11 +3639,11 @@ msgid "" "stat` on the local platform::" msgstr "" -#: library/os.rst:3354 +#: library/os.rst:3355 msgid "Create a symbolic link pointing to *src* named *dst*." msgstr "" -#: library/os.rst:3356 +#: library/os.rst:3357 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 " @@ -3670,7 +3653,7 @@ msgid "" "ignored." msgstr "" -#: library/os.rst:3367 +#: library/os.rst:3368 msgid "" "On newer versions of Windows 10, unprivileged accounts can create symlinks " "if Developer Mode is enabled. When Developer Mode is not available/enabled, " @@ -3678,83 +3661,83 @@ msgid "" "must be run as an administrator." msgstr "" -#: library/os.rst:3373 +#: library/os.rst:3374 msgid "" ":exc:`OSError` is raised when the function is called by an unprivileged user." msgstr "" -#: library/os.rst:3376 +#: library/os.rst:3377 msgid "" "Raises an :ref:`auditing event ` ``os.symlink`` with arguments " "``src``, ``dst``, ``dir_fd``." msgstr "" -#: library/os.rst:3386 +#: library/os.rst:3387 msgid "" -"Added the *dir_fd* argument, and now allow *target_is_directory* on non-" +"Added the *dir_fd* parameter, and now allow *target_is_directory* on non-" "Windows platforms." msgstr "" -#: library/os.rst:3393 +#: library/os.rst:3394 msgid "Added support for unelevated symlinks on Windows with Developer Mode." msgstr "" -#: library/os.rst:3399 +#: library/os.rst:3400 msgid "Force write of everything to disk." msgstr "" -#: library/os.rst:3408 +#: library/os.rst:3409 msgid "" "Truncate the file corresponding to *path*, so that it is at most *length* " "bytes in size." msgstr "" -#: library/os.rst:3413 +#: library/os.rst:3414 msgid "" "Raises an :ref:`auditing event ` ``os.truncate`` with arguments " "``path``, ``length``." msgstr "" -#: library/os.rst:3428 +#: library/os.rst:3429 msgid "" "Remove (delete) the file *path*. This function is semantically identical " "to :func:`remove`; the ``unlink`` name is its traditional Unix name. Please " "see the documentation for :func:`remove` for further information." msgstr "" -#: library/os.rst:3444 +#: library/os.rst:3445 msgid "Set the access and modified times of the file specified by *path*." msgstr "" -#: library/os.rst:3446 +#: library/os.rst:3447 msgid "" ":func:`utime` takes two optional parameters, *times* and *ns*. These specify " "the times set on *path* and are used as follows:" msgstr "" -#: library/os.rst:3449 +#: library/os.rst:3450 msgid "" "If *ns* is specified, it must be a 2-tuple of the form ``(atime_ns, " "mtime_ns)`` where each member is an int expressing nanoseconds." msgstr "" -#: library/os.rst:3452 +#: library/os.rst:3453 msgid "" "If *times* is not ``None``, it must be a 2-tuple of the form ``(atime, " "mtime)`` where each member is an int or float expressing seconds." msgstr "" -#: library/os.rst:3455 +#: library/os.rst:3456 msgid "" "If *times* is ``None`` and *ns* is unspecified, this is equivalent to " "specifying ``ns=(atime_ns, mtime_ns)`` where both times are the current time." msgstr "" -#: library/os.rst:3459 +#: library/os.rst:3460 msgid "It is an error to specify tuples for both *times* and *ns*." msgstr "" -#: library/os.rst:3461 +#: library/os.rst:3462 msgid "" "Note that the exact times you set here may not be returned by a subsequent :" "func:`~os.stat` call, depending on the resolution with which your operating " @@ -3764,19 +3747,19 @@ msgid "" "func:`utime`." msgstr "" -#: library/os.rst:3472 +#: library/os.rst:3473 msgid "" "Raises an :ref:`auditing event ` ``os.utime`` with arguments " "``path``, ``times``, ``ns``, ``dir_fd``." msgstr "" -#: library/os.rst:3474 +#: library/os.rst:3475 msgid "" "Added support for specifying *path* as an open file descriptor, and the " "*dir_fd*, *follow_symlinks*, and *ns* parameters." msgstr "" -#: library/os.rst:3488 +#: library/os.rst:3489 msgid "" "Generate the file names in a directory tree by walking the tree either top-" "down or bottom-up. For each directory in the tree rooted at directory *top* " @@ -3784,7 +3767,7 @@ msgid "" "filenames)``." msgstr "" -#: library/os.rst:3493 +#: library/os.rst:3494 msgid "" "*dirpath* is a string, the path to the directory. *dirnames* is a list of " "the names of the subdirectories in *dirpath* (including symlinks to " @@ -3798,7 +3781,7 @@ msgid "" "unspecified." msgstr "" -#: library/os.rst:3504 +#: library/os.rst:3505 msgid "" "If optional argument *topdown* is ``True`` or not specified, the triple for " "a directory is generated before the triples for any of its subdirectories " @@ -3809,7 +3792,7 @@ msgid "" "its subdirectories are generated." msgstr "" -#: library/os.rst:3512 +#: library/os.rst:3513 msgid "" "When *topdown* is ``True``, the caller can modify the *dirnames* list in-" "place (perhaps using :keyword:`del` or slice assignment), and :func:`walk` " @@ -3822,7 +3805,7 @@ msgid "" "itself is generated." msgstr "" -#: library/os.rst:3521 +#: library/os.rst:3522 msgid "" "By default, errors from the :func:`scandir` call are ignored. If optional " "argument *onerror* is specified, it should be a function; it will be called " @@ -3832,66 +3815,66 @@ msgid "" "object." msgstr "" -#: library/os.rst:3527 +#: library/os.rst:3528 msgid "" "By default, :func:`walk` will not walk down into symbolic links that resolve " "to directories. Set *followlinks* to ``True`` to visit directories pointed " "to by symlinks, on systems that support them." msgstr "" -#: library/os.rst:3533 +#: library/os.rst:3534 msgid "" "Be aware that setting *followlinks* to ``True`` can lead to infinite " "recursion if a link points to a parent directory of itself. :func:`walk` " "does not keep track of the directories it visited already." msgstr "" -#: library/os.rst:3539 +#: library/os.rst:3540 msgid "" "If you pass a relative pathname, don't change the current working directory " "between resumptions of :func:`walk`. :func:`walk` never changes the current " "directory, and assumes that its caller doesn't either." msgstr "" -#: library/os.rst:3604 +#: library/os.rst:3605 msgid "" "This example displays the number of bytes taken by non-directory files in " "each directory under the starting directory, except that it doesn't look " "under any CVS subdirectory::" msgstr "" -#: library/os.rst:3556 +#: library/os.rst:3557 msgid "" "In the next example (simple implementation of :func:`shutil.rmtree`), " "walking the tree bottom-up is essential, :func:`rmdir` doesn't allow " "deleting a directory before the directory is empty::" msgstr "" -#: library/os.rst:3571 +#: library/os.rst:3572 msgid "" "Raises an :ref:`auditing event ` ``os.walk`` with arguments " "``top``, ``topdown``, ``onerror``, ``followlinks``." msgstr "" -#: library/os.rst:3573 +#: library/os.rst:3574 msgid "" "This function now calls :func:`os.scandir` instead of :func:`os.listdir`, " "making it faster by reducing the number of calls to :func:`os.stat`." msgstr "" -#: library/os.rst:3587 +#: library/os.rst:3588 msgid "" "This behaves exactly like :func:`walk`, except that it yields a 4-tuple " "``(dirpath, dirnames, filenames, dirfd)``, and it supports ``dir_fd``." msgstr "" -#: library/os.rst:3590 +#: library/os.rst:3591 msgid "" "*dirpath*, *dirnames* and *filenames* are identical to :func:`walk` output, " "and *dirfd* is a file descriptor referring to the directory *dirpath*." msgstr "" -#: library/os.rst:3593 +#: library/os.rst:3594 msgid "" "This function always supports :ref:`paths relative to directory descriptors " "` and :ref:`not following symlinks `. Note however " @@ -3899,30 +3882,30 @@ msgid "" "*follow_symlinks* is ``False``." msgstr "" -#: library/os.rst:3600 +#: library/os.rst:3601 msgid "" "Since :func:`fwalk` yields file descriptors, those are only valid until the " "next iteration step, so you should duplicate them (e.g. with :func:`dup`) if " "you want to keep them longer." msgstr "" -#: library/os.rst:3617 +#: library/os.rst:3618 msgid "" "In the next example, walking the tree bottom-up is essential: :func:`rmdir` " "doesn't allow deleting a directory before the directory is empty::" msgstr "" -#: library/os.rst:3632 +#: library/os.rst:3633 msgid "" "Raises an :ref:`auditing event ` ``os.fwalk`` with arguments " "``top``, ``topdown``, ``onerror``, ``follow_symlinks``, ``dir_fd``." msgstr "" -#: library/os.rst:3641 +#: library/os.rst:3642 msgid "Added support for :class:`bytes` paths." msgstr "" -#: library/os.rst:3647 +#: library/os.rst:3648 msgid "" "Create an anonymous file and return a file descriptor that refers to it. " "*flags* must be one of the ``os.MFD_*`` constants available on the system " @@ -3930,7 +3913,7 @@ msgid "" "descriptor is :ref:`non-inheritable `." msgstr "" -#: library/os.rst:3652 +#: library/os.rst:3653 msgid "" "The name supplied in *name* is used as a filename and will be displayed as " "the target of the corresponding symbolic link in the directory ``/proc/self/" @@ -3940,23 +3923,23 @@ msgid "" "side effects." msgstr "" -#: library/os.rst:3659 +#: library/os.rst:3660 msgid ":ref:`Availability `: Linux >= 3.17 with glibc >= 2.27." msgstr "" -#: library/os.rst:3682 +#: library/os.rst:3683 msgid "These flags can be passed to :func:`memfd_create`." msgstr "" -#: library/os.rst:3684 +#: library/os.rst:3685 msgid ":ref:`Availability `: Linux >= 3.17 with glibc >= 2.27" msgstr "" -#: library/os.rst:3686 +#: library/os.rst:3687 msgid "The ``MFD_HUGE*`` flags are only available since Linux 4.14." msgstr "" -#: library/os.rst:3693 +#: library/os.rst:3694 msgid "" "Create and return an event file descriptor. The file descriptors supports " "raw :func:`read` and :func:`write` with a buffer size of 8, :func:`~select." @@ -3965,7 +3948,7 @@ msgid "" "ref:`non-inheritable `." msgstr "" -#: library/os.rst:3699 +#: library/os.rst:3700 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 " @@ -3973,86 +3956,86 @@ msgid "" "integer with a maximum value of 2\\ :sup:`64`\\ -\\ 2." msgstr "" -#: library/os.rst:3704 +#: library/os.rst:3705 msgid "" "*flags* can be constructed from :const:`EFD_CLOEXEC`, :const:`EFD_NONBLOCK`, " "and :const:`EFD_SEMAPHORE`." msgstr "" -#: library/os.rst:3707 +#: library/os.rst:3708 msgid "" "If :const:`EFD_SEMAPHORE` is specified and the event counter is non-zero, :" "func:`eventfd_read` returns 1 and decrements the counter by one." msgstr "" -#: library/os.rst:3710 +#: library/os.rst:3711 msgid "" "If :const:`EFD_SEMAPHORE` is not specified and the event counter is non-" "zero, :func:`eventfd_read` returns the current event counter value and " "resets the counter to zero." msgstr "" -#: library/os.rst:3714 +#: library/os.rst:3715 msgid "" "If the event counter is zero and :const:`EFD_NONBLOCK` is not specified, :" "func:`eventfd_read` blocks." msgstr "" -#: library/os.rst:3717 +#: library/os.rst:3718 msgid "" ":func:`eventfd_write` increments the event counter. Write blocks if the " "write operation would increment the counter to a value larger than 2\\ :sup:" "`64`\\ -\\ 2." msgstr "" -#: library/os.rst:3738 +#: library/os.rst:3739 msgid ":ref:`Availability `: Linux >= 2.6.27 with glibc >= 2.8" msgstr "" -#: library/os.rst:3744 +#: library/os.rst:3745 msgid "" "Read value from an :func:`eventfd` file descriptor and return a 64 bit " "unsigned int. The function does not verify that *fd* is an :func:`eventfd`." msgstr "" -#: library/os.rst:3756 library/os.rst:3773 +#: library/os.rst:3757 library/os.rst:3774 msgid ":ref:`Availability `: Linux >= 2.6.27" msgstr "" -#: library/os.rst:3753 +#: library/os.rst:3754 msgid "" "Add value to an :func:`eventfd` file descriptor. *value* must be a 64 bit " "unsigned int. The function does not verify that *fd* is an :func:`eventfd`." msgstr "" -#: library/os.rst:3762 +#: library/os.rst:3763 msgid "Set close-on-exec flag for new :func:`eventfd` file descriptor." msgstr "" -#: library/os.rst:3770 +#: library/os.rst:3771 msgid "" "Set :const:`O_NONBLOCK` status flag for new :func:`eventfd` file descriptor." msgstr "" -#: library/os.rst:3779 +#: library/os.rst:3780 msgid "" "Provide semaphore-like semantics for reads from a :func:`eventfd` file " "descriptor. On read the internal counter is decremented by one." msgstr "" -#: library/os.rst:3782 +#: library/os.rst:3783 msgid ":ref:`Availability `: Linux >= 2.6.30" msgstr "" -#: library/os.rst:3788 +#: library/os.rst:3789 msgid "Linux extended attributes" msgstr "" -#: library/os.rst:3792 +#: library/os.rst:3793 msgid "These functions are all available on Linux only." msgstr "" -#: library/os.rst:3796 +#: library/os.rst:3797 msgid "" "Return the value of the extended filesystem attribute *attribute* for " "*path*. *attribute* can be bytes or str (directly or indirectly through the :" @@ -4060,17 +4043,17 @@ msgid "" "encoding." msgstr "" -#: library/os.rst:3804 +#: library/os.rst:3805 msgid "" "Raises an :ref:`auditing event ` ``os.getxattr`` with arguments " "``path``, ``attribute``." msgstr "" -#: library/os.rst:3838 library/os.rst:3863 +#: library/os.rst:3839 library/os.rst:3864 msgid "Accepts a :term:`path-like object` for *path* and *attribute*." msgstr "" -#: library/os.rst:3812 +#: library/os.rst:3813 msgid "" "Return a list of the extended filesystem attributes on *path*. The " "attributes in the list are represented as strings decoded with the " @@ -4078,13 +4061,13 @@ msgid "" "the current directory." msgstr "" -#: library/os.rst:3820 +#: library/os.rst:3821 msgid "" "Raises an :ref:`auditing event ` ``os.listxattr`` with argument " "``path``." msgstr "" -#: library/os.rst:3828 +#: library/os.rst:3829 msgid "" "Removes the extended filesystem attribute *attribute* from *path*. " "*attribute* should be bytes or str (directly or indirectly through the :" @@ -4092,13 +4075,13 @@ msgid "" "`filesystem encoding and error handler`." msgstr "" -#: library/os.rst:3836 +#: library/os.rst:3837 msgid "" "Raises an :ref:`auditing event ` ``os.removexattr`` with arguments " "``path``, ``attribute``." msgstr "" -#: library/os.rst:3844 +#: library/os.rst:3845 msgid "" "Set the extended filesystem attribute *attribute* on *path* to *value*. " "*attribute* must be a bytes or str with no embedded NULs (directly or " @@ -4110,45 +4093,45 @@ msgid "" "will not be created and ``EEXISTS`` will be raised." msgstr "" -#: library/os.rst:3858 +#: library/os.rst:3859 msgid "" "A bug in Linux kernel versions less than 2.6.39 caused the flags argument to " "be ignored on some filesystems." msgstr "" -#: library/os.rst:3861 +#: library/os.rst:3862 msgid "" "Raises an :ref:`auditing event ` ``os.setxattr`` with arguments " "``path``, ``attribute``, ``value``, ``flags``." msgstr "" -#: library/os.rst:3869 +#: library/os.rst:3870 msgid "" "The maximum size the value of an extended attribute can be. Currently, this " "is 64 KiB on Linux." msgstr "" -#: library/os.rst:3875 +#: library/os.rst:3876 msgid "" "This is a possible value for the flags argument in :func:`setxattr`. It " "indicates the operation must create an attribute." msgstr "" -#: library/os.rst:3881 +#: library/os.rst:3882 msgid "" "This is a possible value for the flags argument in :func:`setxattr`. It " "indicates the operation must replace an existing attribute." msgstr "" -#: library/os.rst:3888 +#: library/os.rst:3889 msgid "Process Management" msgstr "" -#: library/os.rst:3890 +#: library/os.rst:3891 msgid "These functions may be used to create and manage processes." msgstr "" -#: library/os.rst:3892 +#: library/os.rst:3893 msgid "" "The various :func:`exec\\* ` functions take a list of arguments for " "the new program loaded into the process. In each case, the first of these " @@ -4159,7 +4142,7 @@ msgid "" "standard output; ``foo`` will seem to be ignored." msgstr "" -#: library/os.rst:3903 +#: library/os.rst:3904 msgid "" "Generate a :const:`SIGABRT` signal to the current process. On Unix, the " "default behavior is to produce a core dump; on Windows, the process " @@ -4168,37 +4151,37 @@ msgid "" "`SIGABRT` with :func:`signal.signal`." msgstr "" -#: library/os.rst:3912 +#: library/os.rst:3913 msgid "Add a path to the DLL search path." msgstr "" -#: library/os.rst:3914 +#: library/os.rst:3915 msgid "" "This search path is used when resolving dependencies for imported extension " "modules (the module itself is resolved through :data:`sys.path`), and also " "by :mod:`ctypes`." msgstr "" -#: library/os.rst:3918 +#: library/os.rst:3919 msgid "" "Remove the directory by calling **close()** on the returned object or using " "it in a :keyword:`with` statement." msgstr "" -#: library/os.rst:3921 +#: library/os.rst:3922 msgid "" "See the `Microsoft documentation `_ for more information about how " "DLLs are loaded." msgstr "" -#: library/os.rst:3925 +#: library/os.rst:3926 msgid "" "Raises an :ref:`auditing event ` ``os.add_dll_directory`` with " "argument ``path``." msgstr "" -#: library/os.rst:3929 +#: library/os.rst:3930 msgid "" "Previous versions of CPython would resolve DLLs using the default behavior " "for the current process. This led to inconsistencies, such as only sometimes " @@ -4206,14 +4189,14 @@ msgid "" "such as ``AddDllDirectory`` having no effect." msgstr "" -#: library/os.rst:3936 +#: library/os.rst:3937 msgid "" "In 3.8, the two primary ways DLLs are loaded now explicitly override the " "process-wide behavior to ensure consistency. See the :ref:`porting notes " "` for information on updating libraries." msgstr "" -#: library/os.rst:3951 +#: library/os.rst:3952 msgid "" "These functions all execute a new program, replacing the current process; " "they do not return. On Unix, the new executable is loaded into the current " @@ -4221,7 +4204,7 @@ msgid "" "reported as :exc:`OSError` exceptions." msgstr "" -#: library/os.rst:3956 +#: library/os.rst:3957 msgid "" "The current process is replaced immediately. Open file objects and " "descriptors are not flushed, so if there may be data buffered on these open " @@ -4229,7 +4212,7 @@ msgid "" "fsync` before calling an :func:`exec\\* ` function." msgstr "" -#: library/os.rst:3962 +#: library/os.rst:3963 msgid "" "The \"l\" and \"v\" variants of the :func:`exec\\* ` functions differ " "in how command-line arguments are passed. The \"l\" variants are perhaps " @@ -4242,7 +4225,7 @@ msgid "" "is not enforced." msgstr "" -#: library/os.rst:3971 +#: library/os.rst:3972 msgid "" "The variants which include a \"p\" near the end (:func:`execlp`, :func:" "`execlpe`, :func:`execvp`, and :func:`execvpe`) will use the :envvar:`PATH` " @@ -4256,7 +4239,7 @@ msgid "" "even on Windows, as plain names will not be resolved." msgstr "" -#: library/os.rst:3982 +#: library/os.rst:3983 msgid "" "For :func:`execle`, :func:`execlpe`, :func:`execve`, and :func:`execvpe` " "(note that these all end in \"e\"), the *env* parameter must be a mapping " @@ -4266,7 +4249,7 @@ msgid "" "process to inherit the environment of the current process." msgstr "" -#: library/os.rst:3989 +#: library/os.rst:3990 msgid "" "For :func:`execve` on some platforms, *path* may also be specified as an " "open file descriptor. This functionality may not be supported on your " @@ -4275,31 +4258,31 @@ msgid "" "`NotImplementedError`." msgstr "" -#: library/os.rst:3994 +#: library/os.rst:3995 msgid "" "Raises an :ref:`auditing event ` ``os.exec`` with arguments " "``path``, ``args``, ``env``." msgstr "" -#: library/os.rst:3998 +#: library/os.rst:3999 msgid "" "Added support for specifying *path* as an open file descriptor for :func:" "`execve`." msgstr "" -#: library/os.rst:4007 +#: library/os.rst:4008 msgid "" "Exit the process with status *n*, without calling cleanup handlers, flushing " "stdio buffers, etc." msgstr "" -#: library/os.rst:4012 +#: library/os.rst:4013 msgid "" "The standard way to exit is :func:`sys.exit(n) `. :func:`!_exit` " "should normally only be used in the child process after a :func:`fork`." msgstr "" -#: library/os.rst:4015 +#: library/os.rst:4016 msgid "" "The following exit codes are defined and can be used with :func:`_exit`, " "although they are not required. These are typically used for system " @@ -4307,139 +4290,139 @@ msgid "" "delivery program." msgstr "" -#: library/os.rst:4021 +#: library/os.rst:4022 msgid "" "Some of these may not be available on all Unix platforms, since there is " "some variation. These constants are defined where they are defined by the " "underlying platform." msgstr "" -#: library/os.rst:4028 +#: library/os.rst:4029 msgid "" "Exit code that means no error occurred. May be taken from the defined value " "of ``EXIT_SUCCESS`` on some platforms. Generally has a value of zero." msgstr "" -#: library/os.rst:4036 +#: library/os.rst:4037 msgid "" "Exit code that means the command was used incorrectly, such as when the " "wrong number of arguments are given." msgstr "" -#: library/os.rst:4044 +#: library/os.rst:4045 msgid "Exit code that means the input data was incorrect." msgstr "" -#: library/os.rst:4051 +#: library/os.rst:4052 msgid "Exit code that means an input file did not exist or was not readable." msgstr "" -#: library/os.rst:4058 +#: library/os.rst:4059 msgid "Exit code that means a specified user did not exist." msgstr "" -#: library/os.rst:4065 +#: library/os.rst:4066 msgid "Exit code that means a specified host did not exist." msgstr "" -#: library/os.rst:4072 +#: library/os.rst:4073 msgid "Exit code that means that a required service is unavailable." msgstr "" -#: library/os.rst:4079 +#: library/os.rst:4080 msgid "Exit code that means an internal software error was detected." msgstr "" -#: library/os.rst:4086 +#: library/os.rst:4087 msgid "" "Exit code that means an operating system error was detected, such as the " "inability to fork or create a pipe." msgstr "" -#: library/os.rst:4094 +#: library/os.rst:4095 msgid "" "Exit code that means some system file did not exist, could not be opened, or " "had some other kind of error." msgstr "" -#: library/os.rst:4102 +#: library/os.rst:4103 msgid "Exit code that means a user specified output file could not be created." msgstr "" -#: library/os.rst:4109 +#: library/os.rst:4110 msgid "" "Exit code that means that an error occurred while doing I/O on some file." msgstr "" -#: library/os.rst:4116 +#: library/os.rst:4117 msgid "" "Exit code that means a temporary failure occurred. This indicates something " "that may not really be an error, such as a network connection that couldn't " "be made during a retryable operation." msgstr "" -#: library/os.rst:4125 +#: library/os.rst:4126 msgid "" "Exit code that means that a protocol exchange was illegal, invalid, or not " "understood." msgstr "" -#: library/os.rst:4133 +#: library/os.rst:4134 msgid "" "Exit code that means that there were insufficient permissions to perform the " "operation (but not intended for file system problems)." msgstr "" -#: library/os.rst:4141 +#: library/os.rst:4142 msgid "Exit code that means that some kind of configuration error occurred." msgstr "" -#: library/os.rst:4148 +#: library/os.rst:4149 msgid "Exit code that means something like \"an entry was not found\"." msgstr "" -#: library/os.rst:4155 +#: library/os.rst:4156 msgid "" "Fork a child process. Return ``0`` in the child and the child's process id " "in the parent. If an error occurs :exc:`OSError` is raised." msgstr "" -#: library/os.rst:4158 +#: library/os.rst:4159 msgid "" "Note that some platforms including FreeBSD <= 6.3 and Cygwin have known " "issues when using ``fork()`` from a thread." msgstr "" -#: library/os.rst:4161 +#: library/os.rst:4162 msgid "" "Raises an :ref:`auditing event ` ``os.fork`` with no arguments." msgstr "" -#: library/os.rst:4165 +#: library/os.rst:4166 msgid "" "If you use TLS sockets in an application calling ``fork()``, see the warning " "in the :mod:`ssl` documentation." msgstr "" -#: library/os.rst:4214 +#: library/os.rst:4215 msgid "" "On macOS the use of this function is unsafe when mixed with using higher-" "level system APIs, and that includes using :mod:`urllib.request`." msgstr "" -#: library/os.rst:4173 +#: library/os.rst:4174 msgid "" "Calling ``fork()`` in a subinterpreter is no longer supported (:exc:" "`RuntimeError` is raised)." msgstr "" -#: library/os.rst:4177 +#: library/os.rst:4178 msgid "" "If Python is able to detect that your process has multiple threads, :func:" "`os.fork` now raises a :exc:`DeprecationWarning`." msgstr "" -#: library/os.rst:4181 +#: library/os.rst:4182 msgid "" "We chose to surface this as a warning, when detectable, to better inform " "developers of a design problem that the POSIX platform specifically notes as " @@ -4450,25 +4433,25 @@ msgid "" "``free``)." msgstr "" -#: library/os.rst:4190 +#: library/os.rst:4191 msgid "" "Users of macOS or users of libc or malloc implementations other than those " "typically found in glibc to date are among those already more likely to " "experience deadlocks running such code." msgstr "" -#: library/os.rst:4194 +#: library/os.rst:4195 msgid "" "See `this discussion on fork being incompatible with threads `_ for technical details of why we're surfacing " "this longstanding platform compatibility problem to developers." msgstr "" -#: library/os.rst:4446 +#: library/os.rst:4447 msgid ":ref:`Availability `: POSIX, not Emscripten, not WASI." msgstr "" -#: library/os.rst:4204 +#: library/os.rst:4205 msgid "" "Fork a child process, using a new pseudo-terminal as the child's controlling " "terminal. Return a pair of ``(pid, fd)``, where *pid* is ``0`` in the child, " @@ -4477,31 +4460,31 @@ msgid "" "the :mod:`pty` module. If an error occurs :exc:`OSError` is raised." msgstr "" -#: library/os.rst:4210 +#: library/os.rst:4211 msgid "" "Raises an :ref:`auditing event ` ``os.forkpty`` with no arguments." msgstr "" -#: library/os.rst:4217 +#: library/os.rst:4218 msgid "" "If Python is able to detect that your process has multiple threads, this now " "raises a :exc:`DeprecationWarning`. See the longer explanation on :func:`os." "fork`." msgstr "" -#: library/os.rst:4222 +#: library/os.rst:4223 msgid "" "Calling ``forkpty()`` in a subinterpreter is no longer supported (:exc:" "`RuntimeError` is raised)." msgstr "" -#: library/os.rst:4235 +#: library/os.rst:4236 msgid "" "Send signal *sig* to the process *pid*. Constants for the specific signals " "available on the host platform are defined in the :mod:`signal` module." msgstr "" -#: library/os.rst:4238 +#: library/os.rst:4239 msgid "" "Windows: The :const:`signal.CTRL_C_EVENT` and :const:`signal." "CTRL_BREAK_EVENT` signals are special signals which can only be sent to " @@ -4512,51 +4495,47 @@ msgid "" "process handles to be killed." msgstr "" -#: library/os.rst:4246 +#: library/os.rst:4247 msgid "See also :func:`signal.pthread_kill`." msgstr "" -#: library/os.rst:4248 +#: library/os.rst:4249 msgid "" "Raises an :ref:`auditing event ` ``os.kill`` with arguments " "``pid``, ``sig``." msgstr "" -#: library/os.rst:4252 -msgid "Windows support." -msgstr "" - -#: library/os.rst:4262 +#: library/os.rst:4263 msgid "Send the signal *sig* to the process group *pgid*." msgstr "" -#: library/os.rst:4264 +#: library/os.rst:4265 msgid "" "Raises an :ref:`auditing event ` ``os.killpg`` with arguments " "``pgid``, ``sig``." msgstr "" -#: library/os.rst:4271 +#: library/os.rst:4272 msgid "" "Add *increment* to the process's \"niceness\". Return the new niceness." msgstr "" -#: library/os.rst:4278 +#: library/os.rst:4279 msgid "" "Return a file descriptor referring to the process *pid* with *flags* set. " "This descriptor can be used to perform process management without races and " "signals." msgstr "" -#: library/os.rst:4282 +#: library/os.rst:4283 msgid "See the :manpage:`pidfd_open(2)` man page for more details." msgstr "" -#: library/os.rst:4284 +#: library/os.rst:4285 msgid ":ref:`Availability `: Linux >= 5.3" msgstr "" -#: library/os.rst:4289 +#: library/os.rst:4290 msgid "" "This flag indicates that the file descriptor will be non-blocking. If the " "process referred to by the file descriptor has not yet terminated, then an " @@ -4564,17 +4543,17 @@ msgid "" "immediately return the error :const:`~errno.EAGAIN` rather than blocking." msgstr "" -#: library/os.rst:4294 +#: library/os.rst:4295 msgid ":ref:`Availability `: Linux >= 5.10" msgstr "" -#: library/os.rst:4300 +#: library/os.rst:4301 msgid "" "Lock program segments into memory. The value of *op* (defined in ````) determines which segments are locked." msgstr "" -#: library/os.rst:4308 +#: library/os.rst:4309 msgid "" "Open a pipe to or from command *cmd*. The return value is an open file " "object connected to the pipe, which can be read or written depending on " @@ -4584,7 +4563,7 @@ msgid "" "rather than bytes." msgstr "" -#: library/os.rst:4316 +#: library/os.rst:4317 msgid "" "The ``close`` method returns :const:`None` if the subprocess exited " "successfully, or the subprocess's return code if there was an error. On " @@ -4596,60 +4575,60 @@ msgid "" "contains the signed integer return code from the child process." msgstr "" -#: library/os.rst:4326 +#: library/os.rst:4327 msgid "" "On Unix, :func:`waitstatus_to_exitcode` can be used to convert the ``close`` " "method result (exit status) into an exit code if it is not ``None``. On " "Windows, the ``close`` method result is directly the exit code (or ``None``)." msgstr "" -#: library/os.rst:4331 +#: library/os.rst:4332 msgid "" "This is implemented using :class:`subprocess.Popen`; see that class's " "documentation for more powerful ways to manage and communicate with " "subprocesses." msgstr "" -#: library/os.rst:4335 +#: library/os.rst:4336 msgid ":ref:`Availability `: not Emscripten, not WASI." msgstr "" -#: library/os.rst:4338 +#: library/os.rst:4339 msgid "" "The :ref:`Python UTF-8 Mode ` affects encodings used for *cmd* " "and pipe contents." msgstr "" -#: library/os.rst:4341 +#: library/os.rst:4342 msgid "" ":func:`popen` is a simple wrapper around :class:`subprocess.Popen`. Use :" "class:`subprocess.Popen` or :func:`subprocess.run` to control options like " "encodings." msgstr "" -#: library/os.rst:4350 +#: library/os.rst:4351 msgid "Wraps the :c:func:`!posix_spawn` C library API for use from Python." msgstr "" -#: library/os.rst:4352 +#: library/os.rst:4353 msgid "" "Most users should use :func:`subprocess.run` instead of :func:`posix_spawn`." msgstr "" -#: library/os.rst:4354 +#: library/os.rst:4355 msgid "" "The positional-only arguments *path*, *args*, and *env* are similar to :func:" "`execve`." msgstr "" -#: library/os.rst:4357 +#: library/os.rst:4358 msgid "" "The *path* parameter is the path to the executable file. The *path* should " "contain a directory. Use :func:`posix_spawnp` to pass an executable file " "without directory." msgstr "" -#: library/os.rst:4361 +#: library/os.rst:4362 msgid "" "The *file_actions* argument may be a sequence of tuples describing actions " "to take on specific file descriptors in the child process between the C " @@ -4658,31 +4637,31 @@ msgid "" "describing the remaining tuple elements:" msgstr "" -#: library/os.rst:4369 +#: library/os.rst:4370 msgid "(``os.POSIX_SPAWN_OPEN``, *fd*, *path*, *flags*, *mode*)" msgstr "" -#: library/os.rst:4371 +#: library/os.rst:4372 msgid "Performs ``os.dup2(os.open(path, flags, mode), fd)``." msgstr "" -#: library/os.rst:4375 +#: library/os.rst:4376 msgid "(``os.POSIX_SPAWN_CLOSE``, *fd*)" msgstr "" -#: library/os.rst:4377 +#: library/os.rst:4378 msgid "Performs ``os.close(fd)``." msgstr "" -#: library/os.rst:4381 +#: library/os.rst:4382 msgid "(``os.POSIX_SPAWN_DUP2``, *fd*, *new_fd*)" msgstr "" -#: library/os.rst:4383 +#: library/os.rst:4384 msgid "Performs ``os.dup2(fd, new_fd)``." msgstr "" -#: library/os.rst:4385 +#: library/os.rst:4386 msgid "" "These tuples correspond to the C library :c:func:`!" "posix_spawn_file_actions_addopen`, :c:func:`!" @@ -4691,7 +4670,7 @@ msgid "" "`!posix_spawn` call itself." msgstr "" -#: library/os.rst:4391 +#: library/os.rst:4392 msgid "" "The *setpgroup* argument will set the process group of the child to the " "value specified. If the value specified is 0, the child's process group ID " @@ -4700,7 +4679,7 @@ msgid "" "corresponds to the C library :c:macro:`!POSIX_SPAWN_SETPGROUP` flag." msgstr "" -#: library/os.rst:4397 +#: library/os.rst:4398 msgid "" "If the *resetids* argument is ``True`` it will reset the effective UID and " "GID of the child to the real UID and GID of the parent process. If the " @@ -4711,7 +4690,7 @@ msgid "" "library :c:macro:`!POSIX_SPAWN_RESETIDS` flag." msgstr "" -#: library/os.rst:4405 +#: library/os.rst:4406 msgid "" "If the *setsid* argument is ``True``, it will create a new session ID for " "``posix_spawn``. *setsid* requires :c:macro:`!POSIX_SPAWN_SETSID` or :c:" @@ -4719,7 +4698,7 @@ msgid "" "is raised." msgstr "" -#: library/os.rst:4410 +#: library/os.rst:4411 msgid "" "The *setsigmask* argument will set the signal mask to the signal set " "specified. If the parameter is not used, then the child inherits the " @@ -4727,14 +4706,14 @@ msgid "" "POSIX_SPAWN_SETSIGMASK` flag." msgstr "" -#: library/os.rst:4415 +#: library/os.rst:4416 msgid "" "The *sigdef* argument will reset the disposition of all signals in the set " "specified. This argument corresponds to the C library :c:macro:`!" "POSIX_SPAWN_SETSIGDEF` flag." msgstr "" -#: library/os.rst:4419 +#: library/os.rst:4420 msgid "" "The *scheduler* argument must be a tuple containing the (optional) scheduler " "policy and an instance of :class:`sched_param` with the scheduler " @@ -4744,78 +4723,78 @@ msgid "" "POSIX_SPAWN_SETSCHEDULER` flags." msgstr "" -#: library/os.rst:4442 +#: library/os.rst:4443 msgid "" "Raises an :ref:`auditing event ` ``os.posix_spawn`` with arguments " "``path``, ``argv``, ``env``." msgstr "" -#: library/os.rst:4436 +#: library/os.rst:4437 msgid "Wraps the :c:func:`!posix_spawnp` C library API for use from Python." msgstr "" -#: library/os.rst:4438 +#: library/os.rst:4439 msgid "" "Similar to :func:`posix_spawn` except that the system searches for the " "*executable* file in the list of directories specified by the :envvar:`PATH` " "environment variable (in the same way as for ``execvp(3)``)." msgstr "" -#: library/os.rst:4448 +#: library/os.rst:4449 msgid "See :func:`posix_spawn` documentation." msgstr "" -#: library/os.rst:4454 +#: library/os.rst:4455 msgid "" "Register callables to be executed when a new child process is forked using :" "func:`os.fork` or similar process cloning APIs. The parameters are optional " "and keyword-only. Each specifies a different call point." msgstr "" -#: library/os.rst:4459 +#: library/os.rst:4460 msgid "*before* is a function called before forking a child process." msgstr "" -#: library/os.rst:4460 +#: library/os.rst:4461 msgid "" "*after_in_parent* is a function called from the parent process after forking " "a child process." msgstr "" -#: library/os.rst:4462 +#: library/os.rst:4463 msgid "*after_in_child* is a function called from the child process." msgstr "" -#: library/os.rst:4464 +#: library/os.rst:4465 msgid "" "These calls are only made if control is expected to return to the Python " "interpreter. A typical :mod:`subprocess` launch will not trigger them as " "the child is not going to re-enter the interpreter." msgstr "" -#: library/os.rst:4468 +#: library/os.rst:4469 msgid "" "Functions registered for execution before forking are called in reverse " "registration order. Functions registered for execution after forking " "(either in the parent or in the child) are called in registration order." msgstr "" -#: library/os.rst:4473 +#: library/os.rst:4474 msgid "" "Note that :c:func:`fork` calls made by third-party C code may not call those " "functions, unless it explicitly calls :c:func:`PyOS_BeforeFork`, :c:func:" "`PyOS_AfterFork_Parent` and :c:func:`PyOS_AfterFork_Child`." msgstr "" -#: library/os.rst:4477 +#: library/os.rst:4478 msgid "There is no way to unregister a function." msgstr "" -#: library/os.rst:4493 +#: library/os.rst:4494 msgid "Execute the program *path* in a new process." msgstr "" -#: library/os.rst:4495 +#: library/os.rst:4496 msgid "" "(Note that the :mod:`subprocess` module provides more powerful facilities " "for spawning new processes and retrieving their results; using that module " @@ -4823,7 +4802,7 @@ msgid "" "`subprocess-replacements` section.)" msgstr "" -#: library/os.rst:4500 +#: library/os.rst:4501 msgid "" "If *mode* is :const:`P_NOWAIT`, this function returns the process id of the " "new process; if *mode* is :const:`P_WAIT`, returns the process's exit code " @@ -4832,13 +4811,13 @@ msgid "" "handle, so can be used with the :func:`waitpid` function." msgstr "" -#: library/os.rst:4506 +#: library/os.rst:4507 msgid "" "Note on VxWorks, this function doesn't return ``-signal`` when the new " "process is killed. Instead it raises OSError exception." msgstr "" -#: library/os.rst:4509 +#: library/os.rst:4510 msgid "" "The \"l\" and \"v\" variants of the :func:`spawn\\* ` functions " "differ in how command-line arguments are passed. The \"l\" variants are " @@ -4850,7 +4829,7 @@ msgid "" "to the child process must start with the name of the command being run." msgstr "" -#: library/os.rst:4518 +#: library/os.rst:4519 msgid "" "The variants which include a second \"p\" near the end (:func:`spawnlp`, :" "func:`spawnlpe`, :func:`spawnvp`, and :func:`spawnvpe`) will use the :envvar:" @@ -4863,7 +4842,7 @@ msgid "" "appropriate absolute or relative path." msgstr "" -#: library/os.rst:4528 +#: library/os.rst:4529 msgid "" "For :func:`spawnle`, :func:`spawnlpe`, :func:`spawnve`, and :func:`spawnvpe` " "(note that these all end in \"e\"), the *env* parameter must be a mapping " @@ -4875,19 +4854,19 @@ msgid "" "values will cause the function to fail, with a return value of ``127``." msgstr "" -#: library/os.rst:4537 +#: library/os.rst:4538 msgid "" "As an example, the following calls to :func:`spawnlp` and :func:`spawnvpe` " "are equivalent::" msgstr "" -#: library/os.rst:4546 +#: library/os.rst:4547 msgid "" "Raises an :ref:`auditing event ` ``os.spawn`` with arguments " "``mode``, ``path``, ``args``, ``env``." msgstr "" -#: library/os.rst:4550 +#: library/os.rst:4551 msgid "" ":func:`spawnlp`, :func:`spawnlpe`, :func:`spawnvp` and :func:`spawnvpe` are " "not available on Windows. :func:`spawnle` and :func:`spawnve` are not " @@ -4895,7 +4874,7 @@ msgid "" "instead." msgstr "" -#: library/os.rst:4562 +#: library/os.rst:4563 msgid "" "Possible values for the *mode* parameter to the :func:`spawn\\* ` " "family of functions. If either of these values is given, the :func:" @@ -4903,7 +4882,7 @@ msgid "" "been created, with the process id as the return value." msgstr "" -#: library/os.rst:4572 +#: library/os.rst:4573 msgid "" "Possible value for the *mode* parameter to the :func:`spawn\\* ` " "family of functions. If this is given as *mode*, the :func:`spawn\\* " @@ -4912,7 +4891,7 @@ msgid "" "successful, or ``-signal`` if a signal kills the process." msgstr "" -#: library/os.rst:4584 +#: library/os.rst:4585 msgid "" "Possible values for the *mode* parameter to the :func:`spawn\\* ` " "family of functions. These are less portable than those listed above. :" @@ -4922,11 +4901,11 @@ msgid "" "function will not return." msgstr "" -#: library/os.rst:4595 +#: library/os.rst:4596 msgid "Start a file with its associated application." msgstr "" -#: library/os.rst:4597 +#: library/os.rst:4598 msgid "" "When *operation* is not specified, this acts like double-clicking the file " "in Windows Explorer, or giving the file name as an argument to the :program:" @@ -4934,7 +4913,7 @@ msgid "" "whatever application (if any) its extension is associated." msgstr "" -#: library/os.rst:4602 +#: library/os.rst:4603 msgid "" "When another *operation* is given, it must be a \"command verb\" that " "specifies what should be done with the file. Common verbs documented by " @@ -4942,28 +4921,28 @@ msgid "" "as well as ``'explore'`` and ``'find'`` (to be used on directories)." msgstr "" -#: library/os.rst:4607 +#: library/os.rst:4608 msgid "" "When launching an application, specify *arguments* to be passed as a single " "string. This argument may have no effect when using this function to launch " "a document." msgstr "" -#: library/os.rst:4611 +#: library/os.rst:4612 msgid "" "The default working directory is inherited, but may be overridden by the " "*cwd* argument. This should be an absolute path. A relative *path* will be " "resolved against this argument." msgstr "" -#: library/os.rst:4615 +#: library/os.rst:4616 msgid "" "Use *show_cmd* to override the default window style. Whether this has any " "effect will depend on the application being launched. Values are integers as " "supported by the Win32 :c:func:`!ShellExecute` function." msgstr "" -#: library/os.rst:4619 +#: library/os.rst:4620 msgid "" ":func:`startfile` returns as soon as the associated application is launched. " "There is no option to wait for the application to close, and no way to " @@ -4974,32 +4953,32 @@ msgid "" "encoded for Win32." msgstr "" -#: library/os.rst:4627 +#: library/os.rst:4628 msgid "" "To reduce interpreter startup overhead, the Win32 :c:func:`!ShellExecute` " "function is not resolved until this function is first called. If the " "function cannot be resolved, :exc:`NotImplementedError` will be raised." msgstr "" -#: library/os.rst:4631 +#: library/os.rst:4632 msgid "" "Raises an :ref:`auditing event ` ``os.startfile`` with arguments " "``path``, ``operation``." msgstr "" -#: library/os.rst:4633 +#: library/os.rst:4634 msgid "" "Raises an :ref:`auditing event ` ``os.startfile/2`` with arguments " "``path``, ``operation``, ``arguments``, ``cwd``, ``show_cmd``." msgstr "" -#: library/os.rst:4637 +#: library/os.rst:4638 msgid "" "Added the *arguments*, *cwd* and *show_cmd* arguments, and the ``os." "startfile/2`` audit event." msgstr "" -#: library/os.rst:4644 +#: library/os.rst:4645 msgid "" "Execute the command (a string) in a subshell. This is implemented by " "calling the Standard C function :c:func:`system`, and has the same " @@ -5010,13 +4989,13 @@ msgid "" "value of the Python function is system-dependent." msgstr "" -#: library/os.rst:4652 +#: library/os.rst:4653 msgid "" "On Unix, the return value is the exit status of the process encoded in the " "format specified for :func:`wait`." msgstr "" -#: library/os.rst:4655 +#: library/os.rst:4656 msgid "" "On Windows, the return value is that returned by the system shell after " "running *command*. The shell is given by the Windows environment variable :" @@ -5025,7 +5004,7 @@ msgid "" "shell documentation." msgstr "" -#: library/os.rst:4661 +#: library/os.rst:4662 msgid "" "The :mod:`subprocess` module provides more powerful facilities for spawning " "new processes and retrieving their results; using that module is preferable " @@ -5033,53 +5012,53 @@ msgid "" "the :mod:`subprocess` documentation for some helpful recipes." msgstr "" -#: library/os.rst:4666 +#: library/os.rst:4667 msgid "" "On Unix, :func:`waitstatus_to_exitcode` can be used to convert the result " "(exit status) into an exit code. On Windows, the result is directly the exit " "code." msgstr "" -#: library/os.rst:4670 +#: library/os.rst:4671 msgid "" "Raises an :ref:`auditing event ` ``os.system`` with argument " "``command``." msgstr "" -#: library/os.rst:4677 +#: library/os.rst:4678 msgid "" "Returns the current global process times. The return value is an object with " "five attributes:" msgstr "" -#: library/os.rst:4680 +#: library/os.rst:4681 msgid ":attr:`!user` - user time" msgstr "" -#: library/os.rst:4681 +#: library/os.rst:4682 msgid ":attr:`!system` - system time" msgstr "" -#: library/os.rst:4682 +#: library/os.rst:4683 msgid ":attr:`!children_user` - user time of all child processes" msgstr "" -#: library/os.rst:4683 +#: library/os.rst:4684 msgid ":attr:`!children_system` - system time of all child processes" msgstr "" -#: library/os.rst:4684 +#: library/os.rst:4685 msgid ":attr:`!elapsed` - elapsed real time since a fixed point in the past" msgstr "" -#: library/os.rst:4686 +#: library/os.rst:4687 msgid "" "For backwards compatibility, this object also behaves like a five-tuple " "containing :attr:`!user`, :attr:`!system`, :attr:`!children_user`, :attr:`!" "children_system`, and :attr:`!elapsed` in that order." msgstr "" -#: library/os.rst:4690 +#: library/os.rst:4691 msgid "" "See the Unix manual page :manpage:`times(2)` and `times(3) `_ manual page on Unix or `the " @@ -5089,7 +5068,7 @@ msgid "" "attributes are zero." msgstr "" -#: library/os.rst:4704 +#: library/os.rst:4705 msgid "" "Wait for completion of a child process, and return a tuple containing its " "pid and exit status indication: a 16-bit number, whose low byte is the " @@ -5098,87 +5077,87 @@ msgid "" "if a core file was produced." msgstr "" -#: library/os.rst:4710 +#: library/os.rst:4711 msgid "" "If there are no children that could be waited for, :exc:`ChildProcessError` " "is raised." msgstr "" -#: library/os.rst:4788 +#: library/os.rst:4789 msgid "" ":func:`waitstatus_to_exitcode` can be used to convert the exit status into " "an exit code." msgstr "" -#: library/os.rst:4720 +#: library/os.rst:4721 msgid "" "The other :func:`!wait*` functions documented below can be used to wait for " "the completion of a specific child process and have more options. :func:" "`waitpid` is the only one also available on Windows." msgstr "" -#: library/os.rst:4727 +#: library/os.rst:4728 msgid "Wait for the completion of a child process." msgstr "" -#: library/os.rst:4729 +#: library/os.rst:4730 msgid "" "*idtype* can be :data:`P_PID`, :data:`P_PGID`, :data:`P_ALL`, or (on Linux) :" "data:`P_PIDFD`. The interpretation of *id* depends on it; see their " "individual descriptions." msgstr "" -#: library/os.rst:4732 +#: library/os.rst:4733 msgid "" "*options* is an OR combination of flags. At least one of :data:`WEXITED`, :" "data:`WSTOPPED` or :data:`WCONTINUED` is required; :data:`WNOHANG` and :data:" "`WNOWAIT` are additional optional flags." msgstr "" -#: library/os.rst:4736 +#: library/os.rst:4737 msgid "" "The return value is an object representing the data contained in the :c:type:" "`siginfo_t` structure with the following attributes:" msgstr "" -#: library/os.rst:4739 +#: library/os.rst:4740 msgid ":attr:`!si_pid` (process ID)" msgstr "" -#: library/os.rst:4740 +#: library/os.rst:4741 msgid ":attr:`!si_uid` (real user ID of the child)" msgstr "" -#: library/os.rst:4741 +#: library/os.rst:4742 msgid ":attr:`!si_signo` (always :const:`~signal.SIGCHLD`)" msgstr "" -#: library/os.rst:4742 +#: library/os.rst:4743 msgid "" ":attr:`!si_status` (the exit status or signal number, depending on :attr:`!" "si_code`)" msgstr "" -#: library/os.rst:4743 +#: library/os.rst:4744 msgid ":attr:`!si_code` (see :data:`CLD_EXITED` for possible values)" msgstr "" -#: library/os.rst:4745 +#: library/os.rst:4746 msgid "" "If :data:`WNOHANG` is specified and there are no matching children in the " "requested state, ``None`` is returned. Otherwise, if there are no matching " "children that could be waited for, :exc:`ChildProcessError` is raised." msgstr "" -#: library/os.rst:4753 +#: library/os.rst:4754 msgid "This function is not available on macOS." msgstr "" -#: library/os.rst:4760 +#: library/os.rst:4761 msgid "The details of this function differ on Unix and Windows." msgstr "" -#: library/os.rst:4762 +#: library/os.rst:4763 msgid "" "On Unix: Wait for completion of a child process given by process id *pid*, " "and return a tuple containing its process id and exit status indication " @@ -5187,7 +5166,7 @@ msgid "" "operation." msgstr "" -#: library/os.rst:4767 +#: library/os.rst:4768 msgid "" "If *pid* is greater than ``0``, :func:`waitpid` requests status information " "for that specific process. If *pid* is ``0``, the request is for the status " @@ -5197,7 +5176,7 @@ msgid "" "group ``-pid`` (the absolute value of *pid*)." msgstr "" -#: library/os.rst:4774 +#: library/os.rst:4775 msgid "" "*options* is an OR combination of flags. If it contains :data:`WNOHANG` and " "there are no matching children in the requested state, ``(0, 0)`` is " @@ -5206,7 +5185,7 @@ msgid "" "are :data:`WUNTRACED` and :data:`WCONTINUED`." msgstr "" -#: library/os.rst:4780 +#: library/os.rst:4781 msgid "" "On Windows: Wait for completion of a process given by process handle *pid*, " "and return a tuple containing *pid*, and its exit status shifted left by 8 " @@ -5218,7 +5197,7 @@ msgid "" "process handles." msgstr "" -#: library/os.rst:4801 +#: library/os.rst:4802 msgid "" "Similar to :func:`waitpid`, except no process id argument is given and a 3-" "element tuple containing the child's process id, exit status indication, and " @@ -5227,13 +5206,13 @@ msgid "" "same as that provided to :func:`waitpid` and :func:`wait4`." msgstr "" -#: library/os.rst:4822 +#: library/os.rst:4823 msgid "" ":func:`waitstatus_to_exitcode` can be used to convert the exit status into " "an exitcode." msgstr "" -#: library/os.rst:4816 +#: library/os.rst:4817 msgid "" "Similar to :func:`waitpid`, except a 3-element tuple, containing the child's " "process id, exit status indication, and resource usage information is " @@ -5242,118 +5221,118 @@ msgid "" "to :func:`waitpid`." msgstr "" -#: library/os.rst:4833 +#: library/os.rst:4834 msgid "" "These are the possible values for *idtype* in :func:`waitid`. They affect " "how *id* is interpreted:" msgstr "" -#: library/os.rst:4836 +#: library/os.rst:4837 msgid ":data:`!P_PID` - wait for the child whose PID is *id*." msgstr "" -#: library/os.rst:4837 +#: library/os.rst:4838 msgid ":data:`!P_PGID` - wait for any child whose progress group ID is *id*." msgstr "" -#: library/os.rst:4838 +#: library/os.rst:4839 msgid ":data:`!P_ALL` - wait for any child; *id* is ignored." msgstr "" -#: library/os.rst:4839 +#: library/os.rst:4840 msgid "" ":data:`!P_PIDFD` - wait for the child identified by the file descriptor *id* " "(a process file descriptor created with :func:`pidfd_open`)." msgstr "" -#: library/os.rst:4844 +#: library/os.rst:4845 msgid ":data:`!P_PIDFD` is only available on Linux >= 5.4." msgstr "" -#: library/os.rst:4847 +#: library/os.rst:4848 msgid "The :data:`!P_PIDFD` constant." msgstr "" -#: library/os.rst:4853 +#: library/os.rst:4854 msgid "" "This *options* flag for :func:`waitpid`, :func:`wait3`, :func:`wait4`, and :" "func:`waitid` causes child processes to be reported if they have been " "continued from a job control stop since they were last reported." msgstr "" -#: library/os.rst:4862 +#: library/os.rst:4863 msgid "" "This *options* flag for :func:`waitid` causes child processes that have " "terminated to be reported." msgstr "" -#: library/os.rst:4865 +#: library/os.rst:4866 msgid "" "The other ``wait*`` functions always report children that have terminated, " "so this option is not available for them." msgstr "" -#: library/os.rst:4875 +#: library/os.rst:4876 msgid "" "This *options* flag for :func:`waitid` causes child processes that have been " "stopped by the delivery of a signal to be reported." msgstr "" -#: library/os.rst:4910 +#: library/os.rst:4911 msgid "This option is not available for the other ``wait*`` functions." msgstr "" -#: library/os.rst:4887 +#: library/os.rst:4888 msgid "" "This *options* flag for :func:`waitpid`, :func:`wait3`, and :func:`wait4` " "causes child processes to also be reported if they have been stopped but " "their current state has not been reported since they were stopped." msgstr "" -#: library/os.rst:4891 +#: library/os.rst:4892 msgid "This option is not available for :func:`waitid`." msgstr "" -#: library/os.rst:4898 +#: library/os.rst:4899 msgid "" "This *options* flag causes :func:`waitpid`, :func:`wait3`, :func:`wait4`, " "and :func:`waitid` to return right away if no child process status is " "available immediately." msgstr "" -#: library/os.rst:4907 +#: library/os.rst:4908 msgid "" "This *options* flag causes :func:`waitid` to leave the child in a waitable " "state, so that a later :func:`!wait*` call can be used to retrieve the child " "status information again." msgstr "" -#: library/os.rst:4922 +#: library/os.rst:4923 msgid "" "These are the possible values for :attr:`!si_code` in the result returned " "by :func:`waitid`." msgstr "" -#: library/os.rst:4929 +#: library/os.rst:4930 msgid "Added :data:`CLD_KILLED` and :data:`CLD_STOPPED` values." msgstr "" -#: library/os.rst:4935 +#: library/os.rst:4936 msgid "Convert a wait status to an exit code." msgstr "" -#: library/os.rst:4937 +#: library/os.rst:4938 msgid "On Unix:" msgstr "" -#: library/os.rst:4939 +#: library/os.rst:4940 msgid "" "If the process exited normally (if ``WIFEXITED(status)`` is true), return " "the process exit status (return ``WEXITSTATUS(status)``): result greater " "than or equal to 0." msgstr "" -#: library/os.rst:4942 +#: library/os.rst:4943 msgid "" "If the process was terminated by a signal (if ``WIFSIGNALED(status)`` is " "true), return ``-signum`` where *signum* is the number of the signal that " @@ -5361,15 +5340,15 @@ msgid "" "than 0." msgstr "" -#: library/os.rst:4946 +#: library/os.rst:4947 msgid "Otherwise, raise a :exc:`ValueError`." msgstr "" -#: library/os.rst:4948 +#: library/os.rst:4949 msgid "On Windows, return *status* shifted right by 8 bits." msgstr "" -#: library/os.rst:4950 +#: library/os.rst:4951 msgid "" "On Unix, if the process is being traced or if :func:`waitpid` was called " "with :data:`WUNTRACED` option, the caller must first check if " @@ -5377,221 +5356,221 @@ msgid "" "``WIFSTOPPED(status)`` is true." msgstr "" -#: library/os.rst:4957 +#: library/os.rst:4958 msgid "" ":func:`WIFEXITED`, :func:`WEXITSTATUS`, :func:`WIFSIGNALED`, :func:" "`WTERMSIG`, :func:`WIFSTOPPED`, :func:`WSTOPSIG` functions." msgstr "" -#: library/os.rst:4965 +#: library/os.rst:4966 msgid "" "The following functions take a process status code as returned by :func:" "`system`, :func:`wait`, or :func:`waitpid` as a parameter. They may be used " "to determine the disposition of a process." msgstr "" -#: library/os.rst:4971 +#: library/os.rst:4972 msgid "" "Return ``True`` if a core dump was generated for the process, otherwise " "return ``False``." msgstr "" -#: library/os.rst:5040 +#: library/os.rst:5041 msgid "This function should be employed only if :func:`WIFSIGNALED` is true." msgstr "" -#: library/os.rst:4981 +#: library/os.rst:4982 msgid "" "Return ``True`` if a stopped child has been resumed by delivery of :const:" "`~signal.SIGCONT` (if the process has been continued from a job control " "stop), otherwise return ``False``." msgstr "" -#: library/os.rst:4985 +#: library/os.rst:4986 msgid "See :data:`WCONTINUED` option." msgstr "" -#: library/os.rst:4992 +#: library/os.rst:4993 msgid "" "Return ``True`` if the process was stopped by delivery of a signal, " "otherwise return ``False``." msgstr "" -#: library/os.rst:4995 +#: library/os.rst:4996 msgid "" ":func:`WIFSTOPPED` only returns ``True`` if the :func:`waitpid` call was " "done using :data:`WUNTRACED` option or when the process is being traced " "(see :manpage:`ptrace(2)`)." msgstr "" -#: library/os.rst:5003 +#: library/os.rst:5004 msgid "" "Return ``True`` if the process was terminated by a signal, otherwise return " "``False``." msgstr "" -#: library/os.rst:5011 +#: library/os.rst:5012 msgid "" "Return ``True`` if the process exited terminated normally, that is, by " "calling ``exit()`` or ``_exit()``, or by returning from ``main()``; " "otherwise return ``False``." msgstr "" -#: library/os.rst:5020 +#: library/os.rst:5021 msgid "Return the process exit status." msgstr "" -#: library/os.rst:5022 +#: library/os.rst:5023 msgid "This function should be employed only if :func:`WIFEXITED` is true." msgstr "" -#: library/os.rst:5029 +#: library/os.rst:5030 msgid "Return the signal which caused the process to stop." msgstr "" -#: library/os.rst:5031 +#: library/os.rst:5032 msgid "This function should be employed only if :func:`WIFSTOPPED` is true." msgstr "" -#: library/os.rst:5038 +#: library/os.rst:5039 msgid "Return the number of the signal that caused the process to terminate." msgstr "" -#: library/os.rst:5046 +#: library/os.rst:5047 msgid "Interface to the scheduler" msgstr "" -#: library/os.rst:5048 +#: library/os.rst:5049 msgid "" "These functions control how a process is allocated CPU time by the operating " "system. They are only available on some Unix platforms. For more detailed " "information, consult your Unix manpages." msgstr "" -#: library/os.rst:5054 +#: library/os.rst:5055 msgid "" "The following scheduling policies are exposed if they are supported by the " "operating system." msgstr "" -#: library/os.rst:5059 +#: library/os.rst:5060 msgid "The default scheduling policy." msgstr "" -#: library/os.rst:5063 +#: library/os.rst:5064 msgid "" "Scheduling policy for CPU-intensive processes that tries to preserve " "interactivity on the rest of the computer." msgstr "" -#: library/os.rst:5068 +#: library/os.rst:5069 msgid "Scheduling policy for extremely low priority background tasks." msgstr "" -#: library/os.rst:5072 +#: library/os.rst:5073 msgid "Scheduling policy for sporadic server programs." msgstr "" -#: library/os.rst:5076 +#: library/os.rst:5077 msgid "A First In First Out scheduling policy." msgstr "" -#: library/os.rst:5080 +#: library/os.rst:5081 msgid "A round-robin scheduling policy." msgstr "" -#: library/os.rst:5084 +#: library/os.rst:5085 msgid "" "This flag can be OR'ed with any other scheduling policy. When a process with " "this flag set forks, its child's scheduling policy and priority are reset to " "the default." msgstr "" -#: library/os.rst:5091 +#: library/os.rst:5092 msgid "" "This class represents tunable scheduling parameters used in :func:" "`sched_setparam`, :func:`sched_setscheduler`, and :func:`sched_getparam`. It " "is immutable." msgstr "" -#: library/os.rst:5095 +#: library/os.rst:5096 msgid "At the moment, there is only one possible parameter:" msgstr "" -#: library/os.rst:5099 +#: library/os.rst:5100 msgid "The scheduling priority for a scheduling policy." msgstr "" -#: library/os.rst:5104 +#: library/os.rst:5105 msgid "" "Get the minimum priority value for *policy*. *policy* is one of the " "scheduling policy constants above." msgstr "" -#: library/os.rst:5110 +#: library/os.rst:5111 msgid "" "Get the maximum priority value for *policy*. *policy* is one of the " "scheduling policy constants above." msgstr "" -#: library/os.rst:5116 +#: library/os.rst:5117 msgid "" "Set the scheduling policy for the process with PID *pid*. A *pid* of 0 means " "the calling process. *policy* is one of the scheduling policy constants " "above. *param* is a :class:`sched_param` instance." msgstr "" -#: library/os.rst:5123 +#: library/os.rst:5124 msgid "" "Return the scheduling policy for the process with PID *pid*. A *pid* of 0 " "means the calling process. The result is one of the scheduling policy " "constants above." msgstr "" -#: library/os.rst:5130 +#: library/os.rst:5131 msgid "" "Set the scheduling parameters for the process with PID *pid*. A *pid* of 0 " "means the calling process. *param* is a :class:`sched_param` instance." msgstr "" -#: library/os.rst:5136 +#: library/os.rst:5137 msgid "" "Return the scheduling parameters as a :class:`sched_param` instance for the " "process with PID *pid*. A *pid* of 0 means the calling process." msgstr "" -#: library/os.rst:5142 +#: library/os.rst:5143 msgid "" "Return the round-robin quantum in seconds for the process with PID *pid*. A " "*pid* of 0 means the calling process." msgstr "" -#: library/os.rst:5148 +#: library/os.rst:5149 msgid "Voluntarily relinquish the CPU." msgstr "" -#: library/os.rst:5153 +#: library/os.rst:5154 msgid "" "Restrict the process with PID *pid* (or the current process if zero) to a " "set of CPUs. *mask* is an iterable of integers representing the set of CPUs " "to which the process should be restricted." msgstr "" -#: library/os.rst:5160 +#: library/os.rst:5161 msgid "Return the set of CPUs the process with PID *pid* is restricted to." msgstr "" -#: library/os.rst:5162 +#: library/os.rst:5163 msgid "" "If *pid* is zero, return the set of CPUs the calling thread of the current " "process is restricted to." msgstr "" -#: library/os.rst:5169 +#: library/os.rst:5170 msgid "Miscellaneous System Information" msgstr "" -#: library/os.rst:5174 +#: library/os.rst:5175 msgid "" "Return string-valued system configuration values. *name* specifies the " "configuration value to retrieve; it may be a string which is the name of a " @@ -5602,13 +5581,13 @@ msgid "" "included in that mapping, passing an integer for *name* is also accepted." msgstr "" -#: library/os.rst:5182 +#: library/os.rst:5183 msgid "" "If the configuration value specified by *name* isn't defined, ``None`` is " "returned." msgstr "" -#: library/os.rst:5185 +#: library/os.rst:5186 msgid "" "If *name* is a string and is not known, :exc:`ValueError` is raised. If a " "specific value for *name* is not supported by the host system, even if it is " @@ -5616,34 +5595,34 @@ msgid "" "`errno.EINVAL` for the error number." msgstr "" -#: library/os.rst:5195 +#: library/os.rst:5196 msgid "" "Dictionary mapping names accepted by :func:`confstr` to the integer values " "defined for those names by the host operating system. This can be used to " "determine the set of names known to the system." msgstr "" -#: library/os.rst:5204 +#: library/os.rst:5205 msgid "" "Return the number of logical CPUs in the system. Returns ``None`` if " "undetermined." msgstr "" -#: library/os.rst:5207 +#: library/os.rst:5208 msgid "" "This number is not equivalent to the number of logical CPUs the current " "process can use. ``len(os.sched_getaffinity(0))`` gets the number of logical " "CPUs the calling thread of the current process is restricted to" msgstr "" -#: library/os.rst:5216 +#: library/os.rst:5217 msgid "" "Return the number of processes in the system run queue averaged over the " "last 1, 5, and 15 minutes or raises :exc:`OSError` if the load average was " "unobtainable." msgstr "" -#: library/os.rst:5225 +#: library/os.rst:5226 msgid "" "Return integer-valued system configuration values. If the configuration " "value specified by *name* isn't defined, ``-1`` is returned. The comments " @@ -5652,44 +5631,44 @@ msgid "" "``sysconf_names``." msgstr "" -#: library/os.rst:5235 +#: library/os.rst:5236 msgid "" "Dictionary mapping names accepted by :func:`sysconf` to the integer values " "defined for those names by the host operating system. This can be used to " "determine the set of names known to the system." msgstr "" -#: library/os.rst:5241 +#: library/os.rst:5242 msgid "Add ``'SC_MINSIGSTKSZ'`` name." msgstr "" -#: library/os.rst:5244 +#: library/os.rst:5245 msgid "" "The following data values are used to support path manipulation operations. " "These are defined for all platforms." msgstr "" -#: library/os.rst:5247 +#: library/os.rst:5248 msgid "" "Higher-level operations on pathnames are defined in the :mod:`os.path` " "module." msgstr "" -#: library/os.rst:5253 +#: library/os.rst:5254 msgid "" "The constant string used by the operating system to refer to the current " "directory. This is ``'.'`` for Windows and POSIX. Also available via :mod:" "`os.path`." msgstr "" -#: library/os.rst:5261 +#: library/os.rst:5262 msgid "" "The constant string used by the operating system to refer to the parent " "directory. This is ``'..'`` for Windows and POSIX. Also available via :mod:" "`os.path`." msgstr "" -#: library/os.rst:5270 +#: library/os.rst:5271 msgid "" "The character used by the operating system to separate pathname components. " "This is ``'/'`` for POSIX and ``'\\\\'`` for Windows. Note that knowing " @@ -5698,7 +5677,7 @@ msgid "" "useful. Also available via :mod:`os.path`." msgstr "" -#: library/os.rst:5280 +#: library/os.rst:5281 msgid "" "An alternative character used by the operating system to separate pathname " "components, or ``None`` if only one separator character exists. This is set " @@ -5706,27 +5685,27 @@ msgid "" "via :mod:`os.path`." msgstr "" -#: library/os.rst:5289 +#: library/os.rst:5290 msgid "" "The character which separates the base filename from the extension; for " "example, the ``'.'`` in :file:`os.py`. Also available via :mod:`os.path`." msgstr "" -#: library/os.rst:5297 +#: library/os.rst:5298 msgid "" "The character conventionally used by the operating system to separate search " "path components (as in :envvar:`PATH`), such as ``':'`` for POSIX or ``';'`` " "for Windows. Also available via :mod:`os.path`." msgstr "" -#: library/os.rst:5304 +#: library/os.rst:5305 msgid "" "The default search path used by :func:`exec\\*p\\* ` and :func:" "`spawn\\*p\\* ` if the environment doesn't have a ``'PATH'`` key. " "Also available via :mod:`os.path`." msgstr "" -#: library/os.rst:5311 +#: library/os.rst:5312 msgid "" "The string used to separate (or, rather, terminate) lines on the current " "platform. This may be a single character, such as ``'\\n'`` for POSIX, or " @@ -5735,36 +5714,36 @@ msgid "" "default); use a single ``'\\n'`` instead, on all platforms." msgstr "" -#: library/os.rst:5320 +#: library/os.rst:5321 msgid "" "The file path of the null device. For example: ``'/dev/null'`` for POSIX, " "``'nul'`` for Windows. Also available via :mod:`os.path`." msgstr "" -#: library/os.rst:5331 +#: library/os.rst:5332 msgid "" "Flags for use with the :func:`~sys.setdlopenflags` and :func:`~sys." "getdlopenflags` functions. See the Unix manual page :manpage:`dlopen(3)` " "for what the different flags mean." msgstr "" -#: library/os.rst:5339 +#: library/os.rst:5340 msgid "Random numbers" msgstr "" -#: library/os.rst:5344 +#: library/os.rst:5345 msgid "" "Get up to *size* random bytes. The function can return less bytes than " "requested." msgstr "" -#: library/os.rst:5347 +#: library/os.rst:5348 msgid "" "These bytes can be used to seed user-space random number generators or for " "cryptographic purposes." msgstr "" -#: library/os.rst:5350 +#: library/os.rst:5351 msgid "" "``getrandom()`` relies on entropy gathered from device drivers and other " "sources of environmental noise. Unnecessarily reading large quantities of " @@ -5772,36 +5751,36 @@ msgid "" "``/dev/urandom`` devices." msgstr "" -#: library/os.rst:5355 +#: library/os.rst:5356 msgid "" "The flags argument is a bit mask that can contain zero or more of the " "following values ORed together: :py:const:`os.GRND_RANDOM` and :py:data:" "`GRND_NONBLOCK`." msgstr "" -#: library/os.rst:5359 +#: library/os.rst:5360 msgid "" "See also the `Linux getrandom() manual page `_." msgstr "" -#: library/os.rst:5362 +#: library/os.rst:5363 msgid ":ref:`Availability `: Linux >= 3.17." msgstr "" -#: library/os.rst:5368 +#: library/os.rst:5369 msgid "" "Return a bytestring of *size* random bytes suitable for cryptographic use." msgstr "" -#: library/os.rst:5370 +#: library/os.rst:5371 msgid "" "This function returns random bytes from an OS-specific randomness source. " "The returned data should be unpredictable enough for cryptographic " "applications, though its exact quality depends on the OS implementation." msgstr "" -#: library/os.rst:5374 +#: library/os.rst:5375 msgid "" "On Linux, if the ``getrandom()`` syscall is available, it is used in " "blocking mode: block until the system urandom entropy pool is initialized " @@ -5811,63 +5790,63 @@ msgid "" "to poll until the system urandom entropy pool is initialized." msgstr "" -#: library/os.rst:5381 +#: library/os.rst:5382 msgid "" "On a Unix-like system, random bytes are read from the ``/dev/urandom`` " "device. If the ``/dev/urandom`` device is not available or not readable, " "the :exc:`NotImplementedError` exception is raised." msgstr "" -#: library/os.rst:5385 +#: library/os.rst:5386 msgid "On Windows, it will use ``BCryptGenRandom()``." msgstr "" -#: library/os.rst:5388 +#: library/os.rst:5389 msgid "" "The :mod:`secrets` module provides higher level functions. For an easy-to-" "use interface to the random number generator provided by your platform, " "please see :class:`random.SystemRandom`." msgstr "" -#: library/os.rst:5392 +#: library/os.rst:5393 msgid "" "On Linux, ``getrandom()`` is now used in blocking mode to increase the " "security." msgstr "" -#: library/os.rst:5396 +#: library/os.rst:5397 msgid "" "On Linux, if the ``getrandom()`` syscall blocks (the urandom entropy pool is " "not initialized yet), fall back on reading ``/dev/urandom``." msgstr "" -#: library/os.rst:5400 +#: library/os.rst:5401 msgid "" "On Linux 3.17 and newer, the ``getrandom()`` syscall is now used when " "available. On OpenBSD 5.6 and newer, the C ``getentropy()`` function is now " "used. These functions avoid the usage of an internal file descriptor." msgstr "" -#: library/os.rst:5406 +#: library/os.rst:5407 msgid "" "On Windows, ``BCryptGenRandom()`` is used instead of ``CryptGenRandom()`` " "which is deprecated." msgstr "" -#: library/os.rst:5412 +#: library/os.rst:5413 msgid "" "By default, when reading from ``/dev/random``, :func:`getrandom` blocks if " "no random bytes are available, and when reading from ``/dev/urandom``, it " "blocks if the entropy pool has not yet been initialized." msgstr "" -#: library/os.rst:5416 +#: library/os.rst:5417 msgid "" "If the :py:data:`GRND_NONBLOCK` flag is set, then :func:`getrandom` does not " "block in these cases, but instead immediately raises :exc:`BlockingIOError`." msgstr "" -#: library/os.rst:5423 +#: library/os.rst:5424 msgid "" "If this bit is set, then random bytes are drawn from the ``/dev/" "random`` pool instead of the ``/dev/urandom`` pool." @@ -5881,7 +5860,7 @@ msgstr "" msgid "effective id" msgstr "" -#: library/os.rst:438 library/os.rst:456 library/os.rst:666 library/os.rst:4258 +#: library/os.rst:438 library/os.rst:456 library/os.rst:666 library/os.rst:4259 msgid "process" msgstr "" @@ -5933,7 +5912,7 @@ msgstr "" msgid "pty" msgstr "" -#: library/os.rst:2376 library/os.rst:3484 library/os.rst:3583 +#: library/os.rst:2376 library/os.rst:3485 library/os.rst:3584 msgid "directory" msgstr "" @@ -5957,54 +5936,54 @@ msgstr "" msgid "stat" msgstr "" -#: library/os.rst:3583 +#: library/os.rst:3584 msgid "walking" msgstr "" -#: library/os.rst:3583 +#: library/os.rst:3584 msgid "traversal" msgstr "" -#: library/os.rst:4258 +#: library/os.rst:4259 msgid "killing" msgstr "" -#: library/os.rst:4258 +#: library/os.rst:4259 msgid "signalling" msgstr "" -#: library/os.rst:5286 +#: library/os.rst:5287 msgid ". (dot)" msgstr "" -#: library/os.rst:5258 library/os.rst:5277 library/os.rst:5286 +#: library/os.rst:5259 library/os.rst:5278 library/os.rst:5287 msgid "in pathnames" msgstr "" -#: library/os.rst:5258 +#: library/os.rst:5259 msgid ".." msgstr "" -#: library/os.rst:5277 +#: library/os.rst:5278 msgid "/ (slash)" msgstr "" -#: library/os.rst:5267 +#: library/os.rst:5268 msgid "\\ (backslash)" msgstr "" -#: library/os.rst:5267 +#: library/os.rst:5268 msgid "in pathnames (Windows)" msgstr "" -#: library/os.rst:5293 +#: library/os.rst:5294 msgid ": (colon)" msgstr "" -#: library/os.rst:5293 +#: library/os.rst:5294 msgid "path separator (POSIX)" msgstr "" -#: library/os.rst:5293 +#: library/os.rst:5294 msgid "; (semicolon)" msgstr "" diff --git a/library/pathlib.po b/library/pathlib.po index 0bb2e8a9a..0cbebc413 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -168,7 +168,7 @@ msgid "" "filesystem paths::" msgstr "" -#: library/pathlib.rst:180 library/pathlib.rst:752 library/pathlib.rst:762 +#: library/pathlib.rst:180 library/pathlib.rst:759 library/pathlib.rst:769 msgid "*pathsegments* is specified similarly to :class:`PurePath`." msgstr "" @@ -375,79 +375,85 @@ msgstr "" msgid "Return whether or not this path is relative to the *other* path." msgstr "" -#: library/pathlib.rst:516 +#: library/pathlib.rst:512 +msgid "" +"This method is string-based; it neither accesses the filesystem nor treats " +"\"``..``\" segments specially. The following code is equivalent:" +msgstr "" + +#: library/pathlib.rst:523 msgid "" "Passing additional arguments is deprecated; if supplied, they are joined " "with *other*." msgstr "" -#: library/pathlib.rst:521 +#: library/pathlib.rst:528 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:530 +#: library/pathlib.rst:537 msgid "" "File system calls on reserved paths can fail mysteriously or have unintended " "effects." msgstr "" -#: library/pathlib.rst:536 +#: library/pathlib.rst:543 msgid "" "Calling this method is equivalent to combining the path with each of the " "given *pathsegments* in turn::" msgstr "" -#: library/pathlib.rst:551 +#: library/pathlib.rst:558 msgid "" "Match this path against the provided glob-style pattern. Return ``True`` if " "matching is successful, ``False`` otherwise." msgstr "" -#: library/pathlib.rst:554 +#: library/pathlib.rst:561 msgid "" "If *pattern* is relative, the path can be either relative or absolute, and " "matching is done from the right::" msgstr "" -#: library/pathlib.rst:564 +#: library/pathlib.rst:571 msgid "" "If *pattern* is absolute, the path must be absolute, and the whole path must " "match::" msgstr "" -#: library/pathlib.rst:572 +#: library/pathlib.rst:579 msgid "" "The *pattern* may be another path object; this speeds up matching the same " "pattern against multiple files::" msgstr "" -#: library/pathlib.rst:579 +#: library/pathlib.rst:586 msgid "Accepts an object implementing the :class:`os.PathLike` interface." msgstr "" -#: library/pathlib.rst:582 +#: library/pathlib.rst:589 msgid "As with other methods, case-sensitivity follows platform defaults::" msgstr "" -#: library/pathlib.rst:589 +#: library/pathlib.rst:596 msgid "" "Set *case_sensitive* to ``True`` or ``False`` to override this behaviour." msgstr "" -#: library/pathlib.rst:934 library/pathlib.rst:1347 +#: library/pathlib.rst:945 library/pathlib.rst:1358 msgid "The *case_sensitive* parameter was added." msgstr "" -#: library/pathlib.rst:597 +#: library/pathlib.rst:604 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:612 +#: library/pathlib.rst:619 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 " @@ -455,7 +461,7 @@ msgid "" "exc:`ValueError` is raised.::" msgstr "" -#: library/pathlib.rst:627 +#: library/pathlib.rst:634 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 " @@ -463,38 +469,38 @@ msgid "" "call :meth:`~Path.resolve` first if necessary to resolve symlinks." msgstr "" -#: library/pathlib.rst:633 +#: library/pathlib.rst:640 msgid "" "The *walk_up* parameter was added (old behavior is the same as " "``walk_up=False``)." msgstr "" -#: library/pathlib.rst:638 +#: library/pathlib.rst:645 msgid "" "Passing additional positional arguments is deprecated; if supplied, they are " "joined with *other*." msgstr "" -#: library/pathlib.rst:643 +#: library/pathlib.rst:650 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:660 +#: library/pathlib.rst:667 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:684 +#: library/pathlib.rst:691 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:701 +#: library/pathlib.rst:708 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, " @@ -502,55 +508,55 @@ msgid "" "this method to pass information to derivative paths, for example::" msgstr "" -#: library/pathlib.rst:727 +#: library/pathlib.rst:734 msgid "Concrete paths" msgstr "" -#: library/pathlib.rst:729 +#: library/pathlib.rst:736 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:735 +#: library/pathlib.rst:742 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:746 +#: library/pathlib.rst:753 msgid "" "A subclass of :class:`Path` and :class:`PurePosixPath`, this class " "represents concrete non-Windows filesystem paths::" msgstr "" -#: library/pathlib.rst:756 +#: library/pathlib.rst:763 msgid "" "A subclass of :class:`Path` and :class:`PureWindowsPath`, this class " "represents concrete Windows filesystem paths::" msgstr "" -#: library/pathlib.rst:764 +#: library/pathlib.rst:771 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:784 +#: library/pathlib.rst:791 msgid "Methods" msgstr "" -#: library/pathlib.rst:786 +#: library/pathlib.rst:793 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 " "fails (for example because the path doesn't exist)." msgstr "" -#: library/pathlib.rst:792 +#: library/pathlib.rst:799 msgid "" ":meth:`~Path.exists()`, :meth:`~Path.is_dir()`, :meth:`~Path.is_file()`, :" "meth:`~Path.is_mount()`, :meth:`~Path.is_symlink()`, :meth:`~Path." @@ -560,78 +566,85 @@ msgid "" "the OS level." msgstr "" -#: library/pathlib.rst:802 +#: library/pathlib.rst:809 msgid "" "Return a new path object representing the current directory (as returned by :" "func:`os.getcwd`)::" msgstr "" -#: library/pathlib.rst:811 +#: library/pathlib.rst:818 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." msgstr "" -#: library/pathlib.rst:825 +#: library/pathlib.rst:832 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." msgstr "" -#: library/pathlib.rst:828 +#: library/pathlib.rst:835 msgid "" "This method normally follows symlinks; to stat a symlink add the argument " "``follow_symlinks=False``, or use :meth:`~Path.lstat`." msgstr "" -#: library/pathlib.rst:859 library/pathlib.rst:880 +#: library/pathlib.rst:866 library/pathlib.rst:887 msgid "The *follow_symlinks* parameter was added." msgstr "" -#: library/pathlib.rst:844 +#: library/pathlib.rst:851 msgid "Change the file mode and permissions, like :func:`os.chmod`." msgstr "" -#: library/pathlib.rst:846 +#: library/pathlib.rst:853 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`." msgstr "" -#: library/pathlib.rst:864 +#: library/pathlib.rst:871 msgid "Return ``True`` if the path points to an existing file or directory." msgstr "" -#: library/pathlib.rst:866 +#: library/pathlib.rst:873 msgid "" "This method normally follows symlinks; to check if a symlink exists, add the " "argument ``follow_symlinks=False``." msgstr "" -#: library/pathlib.rst:885 +#: library/pathlib.rst:892 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." msgstr "" -#: library/pathlib.rst:900 +#: library/pathlib.rst:907 msgid "" "Glob the given relative *pattern* in the directory represented by this path, " "yielding all matching files (of any kind)::" msgstr "" -#: library/pathlib.rst:908 +#: library/pathlib.rst:915 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:1336 +#: library/pathlib.rst:926 +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:1347 msgid "" "By default, or when the *case_sensitive* keyword-only argument is set to " "``None``, this method matches paths using platform-specific casing rules: " @@ -639,55 +652,55 @@ msgid "" "*case_sensitive* to ``True`` or ``False`` to override this behaviour." msgstr "" -#: library/pathlib.rst:925 +#: library/pathlib.rst:936 msgid "" "Using the \"``**``\" pattern in large directory trees may consume an " "inordinate amount of time." msgstr "" -#: library/pathlib.rst:928 +#: library/pathlib.rst:939 msgid "" "Raises an :ref:`auditing event ` ``pathlib.Path.glob`` with " "arguments ``self``, ``pattern``." msgstr "" -#: library/pathlib.rst:1343 +#: library/pathlib.rst:1354 msgid "" "Return only directories if *pattern* ends with a pathname components " "separator (:data:`~os.sep` or :data:`~os.altsep`)." msgstr "" -#: library/pathlib.rst:940 +#: library/pathlib.rst:951 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." msgstr "" -#: library/pathlib.rst:946 +#: library/pathlib.rst:957 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:958 library/pathlib.rst:1009 library/pathlib.rst:1027 +#: library/pathlib.rst:969 library/pathlib.rst:1020 library/pathlib.rst:1038 msgid "" "``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:955 +#: library/pathlib.rst:966 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." msgstr "" -#: library/pathlib.rst:964 +#: library/pathlib.rst:975 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:972 +#: library/pathlib.rst:983 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 " @@ -699,53 +712,53 @@ msgid "" "mounted filesystem directory." msgstr "" -#: library/pathlib.rst:983 +#: library/pathlib.rst:994 msgid "Windows support was added." msgstr "" -#: library/pathlib.rst:989 +#: library/pathlib.rst:1000 msgid "" "Return ``True`` if the path points to a symbolic link, ``False`` otherwise." msgstr "" -#: library/pathlib.rst:991 +#: library/pathlib.rst:1002 msgid "" "``False`` is also returned if the path doesn't exist; other errors (such as " "permission errors) are propagated." msgstr "" -#: library/pathlib.rst:997 +#: library/pathlib.rst:1008 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:1006 +#: library/pathlib.rst:1017 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:1015 +#: library/pathlib.rst:1026 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:1024 +#: library/pathlib.rst:1035 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:1033 +#: library/pathlib.rst:1044 msgid "" "When the path points to a directory, yield path objects of the directory " "contents::" msgstr "" -#: library/pathlib.rst:1047 +#: library/pathlib.rst:1058 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 " @@ -753,20 +766,20 @@ msgid "" "be included is unspecified." msgstr "" -#: library/pathlib.rst:1054 +#: library/pathlib.rst:1065 msgid "" "Generate the file names in a directory tree by walking the tree either top-" "down or bottom-up." msgstr "" -#: library/pathlib.rst:1057 +#: library/pathlib.rst:1068 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:1061 +#: library/pathlib.rst:1072 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* " @@ -776,7 +789,7 @@ msgid "" "name``. Whether or not the lists are sorted is file system-dependent." msgstr "" -#: library/pathlib.rst:1069 +#: library/pathlib.rst:1080 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 " @@ -787,7 +800,7 @@ msgid "" "the directory and its subdirectories are walked." msgstr "" -#: library/pathlib.rst:1077 +#: library/pathlib.rst:1088 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." @@ -800,7 +813,7 @@ msgid "" "generated by the time *dirnames* is yielded to the caller." msgstr "" -#: library/pathlib.rst:1087 +#: library/pathlib.rst:1098 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 " @@ -809,7 +822,7 @@ msgid "" "filename is available as the ``filename`` attribute of the exception object." msgstr "" -#: library/pathlib.rst:1093 +#: library/pathlib.rst:1104 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 " @@ -818,14 +831,14 @@ msgid "" "(where supported)." msgstr "" -#: library/pathlib.rst:1100 +#: library/pathlib.rst:1111 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:1105 +#: library/pathlib.rst:1116 msgid "" ":meth:`Path.walk` assumes the directories it walks are not modified during " "execution. For example, if a directory from *dirnames* has been replaced " @@ -834,107 +847,107 @@ msgid "" "*dirnames* as appropriate." msgstr "" -#: library/pathlib.rst:1113 +#: library/pathlib.rst:1124 msgid "" "Unlike :func:`os.walk`, :meth:`Path.walk` lists symlinks to directories in " "*filenames* if *follow_symlinks* is false." msgstr "" -#: library/pathlib.rst:1116 +#: library/pathlib.rst:1127 msgid "" "This example displays the number of bytes used by all files in each " "directory, while ignoring ``__pycache__`` directories::" msgstr "" -#: library/pathlib.rst:1132 +#: library/pathlib.rst:1143 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:1149 +#: library/pathlib.rst:1160 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." msgstr "" -#: library/pathlib.rst:1155 +#: library/pathlib.rst:1166 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." msgstr "" -#: library/pathlib.rst:1161 +#: library/pathlib.rst:1172 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 " "access flags. If the path already exists, :exc:`FileExistsError` is raised." msgstr "" -#: library/pathlib.rst:1166 +#: library/pathlib.rst:1177 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:1170 +#: library/pathlib.rst:1181 msgid "" "If *parents* is false (the default), a missing parent raises :exc:" "`FileNotFoundError`." msgstr "" -#: library/pathlib.rst:1173 +#: library/pathlib.rst:1184 msgid "" "If *exist_ok* is false (the default), :exc:`FileExistsError` is raised if " "the target directory already exists." msgstr "" -#: library/pathlib.rst:1176 +#: library/pathlib.rst:1187 msgid "" -"If *exist_ok* is true, :exc:`FileExistsError` exceptions will be ignored " -"(same behavior as the POSIX ``mkdir -p`` command), but only if the last path " -"component is not an existing non-directory file." +"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:1180 +#: library/pathlib.rst:1191 msgid "The *exist_ok* parameter was added." msgstr "" -#: library/pathlib.rst:1186 +#: library/pathlib.rst:1197 msgid "" "Open the file pointed to by the path, like the built-in :func:`open` " "function does::" msgstr "" -#: library/pathlib.rst:1198 +#: library/pathlib.rst:1209 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." msgstr "" -#: library/pathlib.rst:1204 +#: library/pathlib.rst:1215 msgid "Return the binary contents of the pointed-to file as a bytes object::" msgstr "" -#: library/pathlib.rst:1217 +#: library/pathlib.rst:1228 msgid "Return the decoded contents of the pointed-to file as a string::" msgstr "" -#: library/pathlib.rst:1225 +#: library/pathlib.rst:1236 msgid "" "The file is opened and then closed. The optional parameters have the same " "meaning as in :func:`open`." msgstr "" -#: library/pathlib.rst:1233 +#: library/pathlib.rst:1244 msgid "" "Return the path to which the symbolic link points (as returned by :func:`os." "readlink`)::" msgstr "" -#: library/pathlib.rst:1246 +#: library/pathlib.rst:1257 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, " @@ -943,49 +956,49 @@ msgid "" "either a string or another path object::" msgstr "" -#: library/pathlib.rst:1277 +#: library/pathlib.rst:1288 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." msgstr "" -#: library/pathlib.rst:1265 +#: library/pathlib.rst:1276 msgid "" "It is implemented in terms of :func:`os.rename` and gives the same " "guarantees." msgstr "" -#: library/pathlib.rst:1281 +#: library/pathlib.rst:1292 msgid "Added return value, return the new Path instance." msgstr "" -#: library/pathlib.rst:1273 +#: library/pathlib.rst:1284 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." msgstr "" -#: library/pathlib.rst:1287 +#: library/pathlib.rst:1298 msgid "" "Make the path absolute, without normalization or resolving symlinks. Returns " "a new path object::" msgstr "" -#: library/pathlib.rst:1299 +#: library/pathlib.rst:1310 msgid "" "Make the path absolute, resolving any symlinks. A new path object is " "returned::" msgstr "" -#: library/pathlib.rst:1308 +#: library/pathlib.rst:1319 msgid "" "\"``..``\" components are also eliminated (this is the only method to do " "so)::" msgstr "" -#: library/pathlib.rst:1314 +#: library/pathlib.rst:1325 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 " @@ -994,62 +1007,69 @@ msgid "" "`RuntimeError` is raised." msgstr "" -#: library/pathlib.rst:1320 +#: library/pathlib.rst:1331 msgid "The *strict* parameter was added (pre-3.6 behavior is strict)." msgstr "" -#: library/pathlib.rst:1325 +#: library/pathlib.rst:1336 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:1341 +#: library/pathlib.rst:1352 msgid "" "Raises an :ref:`auditing event ` ``pathlib.Path.rglob`` with " "arguments ``self``, ``pattern``." msgstr "" -#: library/pathlib.rst:1353 +#: library/pathlib.rst:1364 msgid "Remove this directory. The directory must be empty." msgstr "" -#: library/pathlib.rst:1358 +#: library/pathlib.rst:1369 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:1362 +#: library/pathlib.rst:1373 msgid "" "An :exc:`OSError` can be raised if either file cannot be accessed for some " "reason." msgstr "" -#: library/pathlib.rst:1379 +#: library/pathlib.rst:1390 +msgid "Make this path a symbolic link pointing to *target*." +msgstr "" + +#: library/pathlib.rst:1392 msgid "" -"Make this path a symbolic link to *target*. Under Windows, " -"*target_is_directory* must be true (default ``False``) if the link's target " -"is a directory. Under POSIX, *target_is_directory*'s value is ignored." +"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:1395 +#: library/pathlib.rst:1410 msgid "" "The order of arguments (link, target) is the reverse of :func:`os.symlink`'s." msgstr "" -#: library/pathlib.rst:1400 +#: library/pathlib.rst:1415 msgid "Make this path a hard link to the same file as *target*." msgstr "" -#: library/pathlib.rst:1403 +#: library/pathlib.rst:1418 msgid "" "The order of arguments (link, target) is the reverse of :func:`os.link`'s." msgstr "" -#: library/pathlib.rst:1411 +#: library/pathlib.rst:1426 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. " @@ -1058,65 +1078,65 @@ msgid "" "`FileExistsError` is raised." msgstr "" -#: library/pathlib.rst:1420 +#: library/pathlib.rst:1435 msgid "" "Remove this file or symbolic link. If the path points to a directory, use :" "func:`Path.rmdir` instead." msgstr "" -#: library/pathlib.rst:1423 +#: library/pathlib.rst:1438 msgid "" "If *missing_ok* is false (the default), :exc:`FileNotFoundError` is raised " "if the path does not exist." msgstr "" -#: library/pathlib.rst:1426 +#: library/pathlib.rst:1441 msgid "" "If *missing_ok* is true, :exc:`FileNotFoundError` exceptions will be ignored " "(same behavior as the POSIX ``rm -f`` command)." msgstr "" -#: library/pathlib.rst:1429 +#: library/pathlib.rst:1444 msgid "The *missing_ok* parameter was added." msgstr "" -#: library/pathlib.rst:1435 +#: library/pathlib.rst:1450 msgid "" "Open the file pointed to in bytes mode, write *data* to it, and close the " "file::" msgstr "" -#: library/pathlib.rst:1444 +#: library/pathlib.rst:1459 msgid "An existing file of the same name is overwritten." msgstr "" -#: library/pathlib.rst:1451 +#: library/pathlib.rst:1466 msgid "" "Open the file pointed to in text mode, write *data* to it, and close the " "file::" msgstr "" -#: library/pathlib.rst:1460 +#: library/pathlib.rst:1475 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:1465 +#: library/pathlib.rst:1480 msgid "The *newline* parameter was added." msgstr "" -#: library/pathlib.rst:1469 +#: library/pathlib.rst:1484 msgid "Correspondence to tools in the :mod:`os` module" msgstr "" -#: library/pathlib.rst:1471 +#: library/pathlib.rst:1486 msgid "" "Below is a table mapping various :mod:`os` functions to their corresponding :" "class:`PurePath`/:class:`Path` equivalent." msgstr "" -#: library/pathlib.rst:1476 +#: library/pathlib.rst:1491 msgid "" "Not all pairs of functions/methods below are equivalent. Some of them, " "despite having some overlapping use-cases, have different semantics. They " @@ -1124,245 +1144,245 @@ msgid "" "relpath` and :meth:`PurePath.relative_to`." msgstr "" -#: library/pathlib.rst:1482 +#: library/pathlib.rst:1497 msgid ":mod:`os` and :mod:`os.path`" msgstr "" -#: library/pathlib.rst:1482 +#: library/pathlib.rst:1497 msgid ":mod:`pathlib`" msgstr "" -#: library/pathlib.rst:1484 +#: library/pathlib.rst:1499 msgid ":func:`os.path.abspath`" msgstr "" -#: library/pathlib.rst:1484 +#: library/pathlib.rst:1499 msgid ":meth:`Path.absolute` [#]_" msgstr "" -#: library/pathlib.rst:1485 +#: library/pathlib.rst:1500 msgid ":func:`os.path.realpath`" msgstr "" -#: library/pathlib.rst:1485 +#: library/pathlib.rst:1500 msgid ":meth:`Path.resolve`" msgstr "" -#: library/pathlib.rst:1486 +#: library/pathlib.rst:1501 msgid ":func:`os.chmod`" msgstr "" -#: library/pathlib.rst:1486 +#: library/pathlib.rst:1501 msgid ":meth:`Path.chmod`" msgstr "" -#: library/pathlib.rst:1487 +#: library/pathlib.rst:1502 msgid ":func:`os.mkdir`" msgstr "" -#: library/pathlib.rst:1488 +#: library/pathlib.rst:1503 msgid ":meth:`Path.mkdir`" msgstr "" -#: library/pathlib.rst:1488 +#: library/pathlib.rst:1503 msgid ":func:`os.makedirs`" msgstr "" -#: library/pathlib.rst:1489 +#: library/pathlib.rst:1504 msgid ":func:`os.rename`" msgstr "" -#: library/pathlib.rst:1489 +#: library/pathlib.rst:1504 msgid ":meth:`Path.rename`" msgstr "" -#: library/pathlib.rst:1490 +#: library/pathlib.rst:1505 msgid ":func:`os.replace`" msgstr "" -#: library/pathlib.rst:1490 +#: library/pathlib.rst:1505 msgid ":meth:`Path.replace`" msgstr "" -#: library/pathlib.rst:1491 +#: library/pathlib.rst:1506 msgid ":func:`os.rmdir`" msgstr "" -#: library/pathlib.rst:1491 +#: library/pathlib.rst:1506 msgid ":meth:`Path.rmdir`" msgstr "" -#: library/pathlib.rst:1492 +#: library/pathlib.rst:1507 msgid ":func:`os.remove`, :func:`os.unlink`" msgstr "" -#: library/pathlib.rst:1492 +#: library/pathlib.rst:1507 msgid ":meth:`Path.unlink`" msgstr "" -#: library/pathlib.rst:1493 +#: library/pathlib.rst:1508 msgid ":func:`os.getcwd`" msgstr "" -#: library/pathlib.rst:1493 +#: library/pathlib.rst:1508 msgid ":func:`Path.cwd`" msgstr "" -#: library/pathlib.rst:1494 +#: library/pathlib.rst:1509 msgid ":func:`os.path.exists`" msgstr "" -#: library/pathlib.rst:1494 +#: library/pathlib.rst:1509 msgid ":meth:`Path.exists`" msgstr "" -#: library/pathlib.rst:1495 +#: library/pathlib.rst:1510 msgid ":func:`os.path.expanduser`" msgstr "" -#: library/pathlib.rst:1495 +#: library/pathlib.rst:1510 msgid ":meth:`Path.expanduser` and :meth:`Path.home`" msgstr "" -#: library/pathlib.rst:1497 +#: library/pathlib.rst:1512 msgid ":func:`os.listdir`" msgstr "" -#: library/pathlib.rst:1497 +#: library/pathlib.rst:1512 msgid ":meth:`Path.iterdir`" msgstr "" -#: library/pathlib.rst:1498 +#: library/pathlib.rst:1513 msgid ":func:`os.walk`" msgstr "" -#: library/pathlib.rst:1498 +#: library/pathlib.rst:1513 msgid ":meth:`Path.walk`" msgstr "" -#: library/pathlib.rst:1499 +#: library/pathlib.rst:1514 msgid ":func:`os.path.isdir`" msgstr "" -#: library/pathlib.rst:1499 +#: library/pathlib.rst:1514 msgid ":meth:`Path.is_dir`" msgstr "" -#: library/pathlib.rst:1500 +#: library/pathlib.rst:1515 msgid ":func:`os.path.isfile`" msgstr "" -#: library/pathlib.rst:1500 +#: library/pathlib.rst:1515 msgid ":meth:`Path.is_file`" msgstr "" -#: library/pathlib.rst:1501 +#: library/pathlib.rst:1516 msgid ":func:`os.path.islink`" msgstr "" -#: library/pathlib.rst:1501 +#: library/pathlib.rst:1516 msgid ":meth:`Path.is_symlink`" msgstr "" -#: library/pathlib.rst:1502 +#: library/pathlib.rst:1517 msgid ":func:`os.link`" msgstr "" -#: library/pathlib.rst:1502 +#: library/pathlib.rst:1517 msgid ":meth:`Path.hardlink_to`" msgstr "" -#: library/pathlib.rst:1503 +#: library/pathlib.rst:1518 msgid ":func:`os.symlink`" msgstr "" -#: library/pathlib.rst:1503 +#: library/pathlib.rst:1518 msgid ":meth:`Path.symlink_to`" msgstr "" -#: library/pathlib.rst:1504 +#: library/pathlib.rst:1519 msgid ":func:`os.readlink`" msgstr "" -#: library/pathlib.rst:1504 +#: library/pathlib.rst:1519 msgid ":meth:`Path.readlink`" msgstr "" -#: library/pathlib.rst:1505 +#: library/pathlib.rst:1520 msgid ":func:`os.path.relpath`" msgstr "" -#: library/pathlib.rst:1505 +#: library/pathlib.rst:1520 msgid ":meth:`PurePath.relative_to` [#]_" msgstr "" -#: library/pathlib.rst:1506 +#: library/pathlib.rst:1521 msgid ":func:`os.stat`" msgstr "" -#: library/pathlib.rst:1506 +#: library/pathlib.rst:1521 msgid ":meth:`Path.stat`, :meth:`Path.owner`, :meth:`Path.group`" msgstr "" -#: library/pathlib.rst:1509 +#: library/pathlib.rst:1524 msgid ":func:`os.path.isabs`" msgstr "" -#: library/pathlib.rst:1509 +#: library/pathlib.rst:1524 msgid ":meth:`PurePath.is_absolute`" msgstr "" -#: library/pathlib.rst:1510 +#: library/pathlib.rst:1525 msgid ":func:`os.path.join`" msgstr "" -#: library/pathlib.rst:1510 +#: library/pathlib.rst:1525 msgid ":func:`PurePath.joinpath`" msgstr "" -#: library/pathlib.rst:1511 +#: library/pathlib.rst:1526 msgid ":func:`os.path.basename`" msgstr "" -#: library/pathlib.rst:1511 +#: library/pathlib.rst:1526 msgid ":attr:`PurePath.name`" msgstr "" -#: library/pathlib.rst:1512 +#: library/pathlib.rst:1527 msgid ":func:`os.path.dirname`" msgstr "" -#: library/pathlib.rst:1512 +#: library/pathlib.rst:1527 msgid ":attr:`PurePath.parent`" msgstr "" -#: library/pathlib.rst:1513 +#: library/pathlib.rst:1528 msgid ":func:`os.path.samefile`" msgstr "" -#: library/pathlib.rst:1513 +#: library/pathlib.rst:1528 msgid ":meth:`Path.samefile`" msgstr "" -#: library/pathlib.rst:1514 +#: library/pathlib.rst:1529 msgid ":func:`os.path.splitext`" msgstr "" -#: library/pathlib.rst:1514 +#: library/pathlib.rst:1529 msgid ":attr:`PurePath.stem` and :attr:`PurePath.suffix`" msgstr "" -#: library/pathlib.rst:1519 +#: library/pathlib.rst:1534 msgid "Footnotes" msgstr "" -#: library/pathlib.rst:1520 +#: library/pathlib.rst:1535 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." msgstr "" -#: library/pathlib.rst:1521 +#: library/pathlib.rst:1536 msgid "" ":meth:`PurePath.relative_to` requires ``self`` to be the subpath of the " "argument, but :func:`os.path.relpath` does not." diff --git a/library/pdb.po b/library/pdb.po index 7fa42fb3f..1b0948f4f 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: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -112,15 +112,15 @@ msgstr "" #: library/pdb.rst:89 msgid "" -"``-c`` option is introduced to execute commands as if given in a :file:`." -"pdbrc` file, see :ref:`debugger-commands`." +"Added the ``-c`` option to execute commands as if given in a :file:`.pdbrc` " +"file; see :ref:`debugger-commands`." msgstr "" #: library/pdb.rst:93 msgid "" -"``-m`` option is introduced to execute modules similar to the way ``python -" -"m`` does. As with a script, the debugger will pause execution just before " -"the first line of the module." +"Added the ``-m`` option to execute modules similar to the way ``python -m`` " +"does. As with a script, the debugger will pause execution just before the " +"first line of the module." msgstr "" #: library/pdb.rst:98 @@ -239,12 +239,13 @@ msgid "" msgstr "" #: library/pdb.rst:212 -msgid "The *skip* argument." +msgid "Added the *skip* parameter." msgstr "" #: library/pdb.rst:215 msgid "" -"The *nosigint* argument. Previously, a SIGINT handler was never set by Pdb." +"Added the *nosigint* parameter. Previously, a SIGINT handler was never set " +"by Pdb." msgstr "" #: library/pdb.rst:219 @@ -564,7 +565,7 @@ msgid "" msgstr "" #: library/pdb.rst:466 -msgid "The ``>>`` marker." +msgid "Added the ``>>`` marker." msgstr "" #: library/pdb.rst:471 diff --git a/library/pickle.po b/library/pickle.po index 2df9d5155..b19f6bb55 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: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -375,14 +375,14 @@ msgstr "" #: library/pickle.rst:275 msgid "" -"Common base class for the other pickling exceptions. It inherits :exc:" +"Common base class for the other pickling exceptions. It inherits from :exc:" "`Exception`." msgstr "" #: library/pickle.rst:280 msgid "" "Error raised when an unpicklable object is encountered by :class:`Pickler`. " -"It inherits :exc:`PickleError`." +"It inherits from :exc:`PickleError`." msgstr "" #: library/pickle.rst:283 @@ -394,7 +394,7 @@ msgstr "" #: library/pickle.rst:288 msgid "" "Error raised when there is a problem unpickling an object, such as a data " -"corruption or a security violation. It inherits :exc:`PickleError`." +"corruption or a security violation. It inherits from :exc:`PickleError`." msgstr "" #: library/pickle.rst:291 @@ -486,7 +486,7 @@ msgid "" "the kind which can be declared using :func:`copyreg.pickle`. It is a " "mapping whose keys are classes and whose values are reduction functions. A " "reduction function takes a single argument of the associated class and " -"should conform to the same interface as a :meth:`__reduce__` method." +"should conform to the same interface as a :meth:`~object.__reduce__` method." msgstr "" #: library/pickle.rst:358 @@ -508,9 +508,9 @@ msgstr "" msgid "" "Special reducer that can be defined in :class:`Pickler` subclasses. This " "method has priority over any reducer in the :attr:`dispatch_table`. It " -"should conform to the same interface as a :meth:`__reduce__` method, and can " -"optionally return ``NotImplemented`` to fallback on :attr:`dispatch_table`-" -"registered reducers to pickle ``obj``." +"should conform to the same interface as a :meth:`~object.__reduce__` method, " +"and can optionally return ``NotImplemented`` to fallback on :attr:" +"`dispatch_table`-registered reducers to pickle ``obj``." msgstr "" #: library/pickle.rst:379 @@ -690,8 +690,8 @@ msgstr "" #: library/pickle.rst:511 msgid "" -"instances of such classes whose the result of calling :meth:`__getstate__` " -"is picklable (see section :ref:`pickle-inst` for details)." +"instances of such classes whose the result of calling :meth:`~object." +"__getstate__` is picklable (see section :ref:`pickle-inst` for details)." msgstr "" #: library/pickle.rst:514 @@ -737,8 +737,8 @@ msgid "" "and still load objects that were created with an earlier version of the " "class. If you plan to have long-lived objects that will see many versions " "of a class, it may be worthwhile to put a version number in the objects so " -"that suitable conversions can be made by the class's :meth:`__setstate__` " -"method." +"that suitable conversions can be made by the class's :meth:`~object." +"__setstate__` method." msgstr "" #: library/pickle.rst:553 @@ -755,10 +755,10 @@ msgstr "" msgid "" "In most cases, no additional code is needed to make instances picklable. By " "default, pickle will retrieve the class and the attributes of an instance " -"via introspection. When a class instance is unpickled, its :meth:`__init__` " -"method is usually *not* invoked. The default behaviour first creates an " -"uninitialized instance and then restores the saved attributes. The " -"following code shows an implementation of this behaviour::" +"via introspection. When a class instance is unpickled, its :meth:`~object." +"__init__` method is usually *not* invoked. The default behaviour first " +"creates an uninitialized instance and then restores the saved attributes. " +"The following code shows an implementation of this behaviour::" msgstr "" #: library/pickle.rst:575 @@ -859,42 +859,44 @@ msgstr "" #: library/pickle.rst:648 msgid "" -"If :meth:`__getstate__` returns a false value, the :meth:`__setstate__` " -"method will not be called upon unpickling." +"If :meth:`__reduce__` returns a state with value ``None`` at pickling, the :" +"meth:`__setstate__` method will not be called upon unpickling." msgstr "" #: library/pickle.rst:652 msgid "" "Refer to the section :ref:`pickle-state` for more information about how to " -"use the methods :meth:`__getstate__` and :meth:`__setstate__`." +"use the methods :meth:`~object.__getstate__` and :meth:`~object." +"__setstate__`." msgstr "" #: library/pickle.rst:657 msgid "" -"At unpickling time, some methods like :meth:`__getattr__`, :meth:" -"`__getattribute__`, or :meth:`__setattr__` may be called upon the instance. " -"In case those methods rely on some internal invariant being true, the type " -"should implement :meth:`__new__` to establish such an invariant, as :meth:" -"`__init__` is not called when unpickling an instance." +"At unpickling time, some methods like :meth:`~object.__getattr__`, :meth:" +"`~object.__getattribute__`, or :meth:`~object.__setattr__` may be called " +"upon the instance. In case those methods rely on some internal invariant " +"being true, the type should implement :meth:`~object.__new__` to establish " +"such an invariant, as :meth:`~object.__init__` is not called when unpickling " +"an instance." msgstr "" #: library/pickle.rst:666 msgid "" "As we shall see, pickle does not use directly the methods described above. " "In fact, these methods are part of the copy protocol which implements the :" -"meth:`__reduce__` special method. The copy protocol provides a unified " -"interface for retrieving the data necessary for pickling and copying " +"meth:`~object.__reduce__` special method. The copy protocol provides a " +"unified interface for retrieving the data necessary for pickling and copying " "objects. [#]_" msgstr "" #: library/pickle.rst:672 msgid "" -"Although powerful, implementing :meth:`__reduce__` directly in your classes " -"is error prone. For this reason, class designers should use the high-level " -"interface (i.e., :meth:`__getnewargs_ex__`, :meth:`__getstate__` and :meth:" -"`__setstate__`) whenever possible. We will show, however, cases where " -"using :meth:`__reduce__` is the only option or leads to more efficient " -"pickling or both." +"Although powerful, implementing :meth:`~object.__reduce__` directly in your " +"classes is error prone. For this reason, class designers should use the " +"high-level interface (i.e., :meth:`~object.__getnewargs_ex__`, :meth:" +"`~object.__getstate__` and :meth:`~object.__setstate__`) whenever possible. " +"We will show, however, cases where using :meth:`!__reduce__` is the only " +"option or leads to more efficient pickling or both." msgstr "" #: library/pickle.rst:681 @@ -945,13 +947,13 @@ msgid "" "These items will be appended to the object either using ``obj.append(item)`` " "or, in batch, using ``obj.extend(list_of_items)``. This is primarily used " "for list subclasses, but may be used by other classes as long as they have :" -"meth:`append` and :meth:`extend` methods with the appropriate signature. " -"(Whether :meth:`append` or :meth:`extend` is used depends on which pickle " -"protocol version is used as well as the number of items to append, so both " -"must be supported.)" +"ref:`append and extend methods ` with the appropriate " +"signature. (Whether :meth:`!append` or :meth:`!extend` is used depends on " +"which pickle protocol version is used as well as the number of items to " +"append, so both must be supported.)" msgstr "" -#: library/pickle.rst:716 +#: library/pickle.rst:717 msgid "" "Optionally, an iterator (not a sequence) yielding successive key-value " "pairs. These items will be stored to the object using ``obj[key] = " @@ -959,7 +961,7 @@ msgid "" "by other classes as long as they implement :meth:`__setitem__`." msgstr "" -#: library/pickle.rst:721 +#: library/pickle.rst:722 msgid "" "Optionally, a callable with a ``(obj, state)`` signature. This callable " "allows the user to programmatically control the state-updating behavior of a " @@ -968,11 +970,11 @@ msgid "" "meth:`__setstate__`." msgstr "" -#: library/pickle.rst:727 +#: library/pickle.rst:728 msgid "The optional sixth tuple item, ``(obj, state)``, was added." msgstr "" -#: library/pickle.rst:733 +#: library/pickle.rst:734 msgid "" "Alternatively, a :meth:`__reduce_ex__` method may be defined. The only " "difference is this method should take a single integer argument, the " @@ -982,11 +984,11 @@ msgid "" "provide backwards-compatible reduce values for older Python releases." msgstr "" -#: library/pickle.rst:745 +#: library/pickle.rst:746 msgid "Persistence of External Objects" msgstr "" -#: library/pickle.rst:751 +#: library/pickle.rst:752 msgid "" "For the benefit of object persistence, the :mod:`pickle` module supports the " "notion of a reference to an object outside the pickled data stream. Such " @@ -995,7 +997,7 @@ msgid "" "(for any newer protocol)." msgstr "" -#: library/pickle.rst:757 +#: library/pickle.rst:758 msgid "" "The resolution of such persistent IDs is not defined by the :mod:`pickle` " "module; it will delegate this resolution to the user-defined methods on the " @@ -1003,7 +1005,7 @@ msgid "" "persistent_load` respectively." msgstr "" -#: library/pickle.rst:762 +#: library/pickle.rst:763 msgid "" "To pickle objects that have an external persistent ID, the pickler must have " "a custom :meth:`~Pickler.persistent_id` method that takes an object as an " @@ -1014,84 +1016,84 @@ msgid "" "persistent ID." msgstr "" -#: library/pickle.rst:769 +#: library/pickle.rst:770 msgid "" "To unpickle external objects, the unpickler must have a custom :meth:" "`~Unpickler.persistent_load` method that takes a persistent ID object and " "returns the referenced object." msgstr "" -#: library/pickle.rst:773 +#: library/pickle.rst:774 msgid "" "Here is a comprehensive example presenting how persistent ID can be used to " "pickle external objects by reference." msgstr "" -#: library/pickle.rst:781 +#: library/pickle.rst:782 msgid "Dispatch Tables" msgstr "" -#: library/pickle.rst:783 +#: library/pickle.rst:784 msgid "" "If one wants to customize pickling of some classes without disturbing any " "other code which depends on pickling, then one can create a pickler with a " "private dispatch table." msgstr "" -#: library/pickle.rst:787 +#: library/pickle.rst:788 msgid "" "The global dispatch table managed by the :mod:`copyreg` module is available " -"as :data:`copyreg.dispatch_table`. Therefore, one may choose to use a " -"modified copy of :data:`copyreg.dispatch_table` as a private dispatch table." +"as :data:`!copyreg.dispatch_table`. Therefore, one may choose to use a " +"modified copy of :data:`!copyreg.dispatch_table` as a private dispatch table." msgstr "" -#: library/pickle.rst:792 +#: library/pickle.rst:793 msgid "For example ::" msgstr "" -#: library/pickle.rst:799 +#: library/pickle.rst:800 msgid "" "creates an instance of :class:`pickle.Pickler` with a private dispatch table " "which handles the ``SomeClass`` class specially. Alternatively, the code ::" msgstr "" -#: library/pickle.rst:809 +#: library/pickle.rst:810 msgid "" "does the same but all instances of ``MyPickler`` will by default share the " "private dispatch table. On the other hand, the code ::" msgstr "" -#: library/pickle.rst:816 +#: library/pickle.rst:817 msgid "" "modifies the global dispatch table shared by all users of the :mod:`copyreg` " "module." msgstr "" -#: library/pickle.rst:821 +#: library/pickle.rst:822 msgid "Handling Stateful Objects" msgstr "" -#: library/pickle.rst:827 +#: library/pickle.rst:828 msgid "" "Here's an example that shows how to modify pickling behavior for a class. " -"The :class:`TextReader` class opens a text file, and returns the line number " -"and line contents each time its :meth:`!readline` method is called. If a :" -"class:`TextReader` instance is pickled, all attributes *except* the file " -"object member are saved. When the instance is unpickled, the file is " -"reopened, and reading resumes from the last location. The :meth:" -"`__setstate__` and :meth:`__getstate__` methods are used to implement this " +"The :class:`!TextReader` class below opens a text file, and returns the line " +"number and line contents each time its :meth:`!readline` method is called. " +"If a :class:`!TextReader` instance is pickled, all attributes *except* the " +"file object member are saved. When the instance is unpickled, the file is " +"reopened, and reading resumes from the last location. The :meth:`!" +"__setstate__` and :meth:`!__getstate__` methods are used to implement this " "behavior. ::" msgstr "" -#: library/pickle.rst:873 +#: library/pickle.rst:874 msgid "A sample usage might be something like this::" msgstr "" -#: library/pickle.rst:887 +#: library/pickle.rst:888 msgid "Custom Reduction for Types, Functions, and Other Objects" msgstr "" -#: library/pickle.rst:891 +#: library/pickle.rst:892 msgid "" "Sometimes, :attr:`~Pickler.dispatch_table` may not be flexible enough. In " "particular we may want to customize pickling based on another criterion than " @@ -1099,23 +1101,23 @@ msgid "" "classes." msgstr "" -#: library/pickle.rst:896 +#: library/pickle.rst:897 msgid "" "For those cases, it is possible to subclass from the :class:`Pickler` class " "and implement a :meth:`~Pickler.reducer_override` method. This method can " -"return an arbitrary reduction tuple (see :meth:`__reduce__`). It can " +"return an arbitrary reduction tuple (see :meth:`~object.__reduce__`). It can " "alternatively return ``NotImplemented`` to fallback to the traditional " "behavior." msgstr "" -#: library/pickle.rst:901 +#: library/pickle.rst:902 msgid "" "If both the :attr:`~Pickler.dispatch_table` and :meth:`~Pickler." "reducer_override` are defined, then :meth:`~Pickler.reducer_override` method " "takes priority." msgstr "" -#: library/pickle.rst:906 +#: library/pickle.rst:907 msgid "" "For performance reasons, :meth:`~Pickler.reducer_override` may not be called " "for the following objects: ``None``, ``True``, ``False``, and exact " @@ -1124,17 +1126,17 @@ msgid "" "`tuple`." msgstr "" -#: library/pickle.rst:912 +#: library/pickle.rst:913 msgid "" "Here is a simple example where we allow pickling and reconstructing a given " "class::" msgstr "" -#: library/pickle.rst:947 +#: library/pickle.rst:948 msgid "Out-of-band Buffers" msgstr "" -#: library/pickle.rst:951 +#: library/pickle.rst:952 msgid "" "In some contexts, the :mod:`pickle` module is used to transfer massive " "amounts of data. Therefore, it can be important to minimize the number of " @@ -1144,7 +1146,7 @@ msgid "" "involves copying data to and from the pickle stream." msgstr "" -#: library/pickle.rst:958 +#: library/pickle.rst:959 msgid "" "This constraint can be eschewed if both the *provider* (the implementation " "of the object types to be transferred) and the *consumer* (the " @@ -1152,19 +1154,19 @@ msgid "" "transfer facilities provided by pickle protocol 5 and higher." msgstr "" -#: library/pickle.rst:964 +#: library/pickle.rst:965 msgid "Provider API" msgstr "" -#: library/pickle.rst:966 +#: library/pickle.rst:967 msgid "" -"The large data objects to be pickled must implement a :meth:`__reduce_ex__` " -"method specialized for protocol 5 and higher, which returns a :class:" -"`PickleBuffer` instance (instead of e.g. a :class:`bytes` object) for any " -"large data." +"The large data objects to be pickled must implement a :meth:`~object." +"__reduce_ex__` method specialized for protocol 5 and higher, which returns " +"a :class:`PickleBuffer` instance (instead of e.g. a :class:`bytes` object) " +"for any large data." msgstr "" -#: library/pickle.rst:971 +#: library/pickle.rst:972 msgid "" "A :class:`PickleBuffer` object *signals* that the underlying buffer is " "eligible for out-of-band data transfer. Those objects remain compatible " @@ -1173,17 +1175,17 @@ msgid "" "themselves." msgstr "" -#: library/pickle.rst:978 +#: library/pickle.rst:979 msgid "Consumer API" msgstr "" -#: library/pickle.rst:980 +#: library/pickle.rst:981 msgid "" "A communications system can enable custom handling of the :class:" "`PickleBuffer` objects generated when serializing an object graph." msgstr "" -#: library/pickle.rst:983 +#: library/pickle.rst:984 msgid "" "On the sending side, it needs to pass a *buffer_callback* argument to :class:" "`Pickler` (or to the :func:`dump` or :func:`dumps` function), which will be " @@ -1192,7 +1194,7 @@ msgid "" "copied into the pickle stream, only a cheap marker will be inserted." msgstr "" -#: library/pickle.rst:990 +#: library/pickle.rst:991 msgid "" "On the receiving side, it needs to pass a *buffers* argument to :class:" "`Unpickler` (or to the :func:`load` or :func:`loads` function), which is an " @@ -1203,7 +1205,7 @@ msgid "" "`PickleBuffer` objects." msgstr "" -#: library/pickle.rst:998 +#: library/pickle.rst:999 msgid "" "Between the sending side and the receiving side, the communications system " "is free to implement its own transfer mechanism for out-of-band buffers. " @@ -1211,36 +1213,36 @@ msgid "" "dependent compression." msgstr "" -#: library/pickle.rst:1004 +#: library/pickle.rst:1005 msgid "Example" msgstr "" -#: library/pickle.rst:1006 +#: library/pickle.rst:1007 msgid "" "Here is a trivial example where we implement a :class:`bytearray` subclass " "able to participate in out-of-band buffer pickling::" msgstr "" -#: library/pickle.rst:1030 +#: library/pickle.rst:1031 msgid "" "The reconstructor (the ``_reconstruct`` class method) returns the buffer's " "providing object if it has the right type. This is an easy way to simulate " "zero-copy behaviour on this toy example." msgstr "" -#: library/pickle.rst:1034 +#: library/pickle.rst:1035 msgid "" "On the consumer side, we can pickle those objects the usual way, which when " "unserialized will give us a copy of the original object::" msgstr "" -#: library/pickle.rst:1043 +#: library/pickle.rst:1044 msgid "" "But if we pass a *buffer_callback* and then give back the accumulated " "buffers when unserializing, we are able to get back the original object::" msgstr "" -#: library/pickle.rst:1053 +#: library/pickle.rst:1054 msgid "" "This example is limited by the fact that :class:`bytearray` allocates its " "own memory: you cannot create a :class:`bytearray` instance that is backed " @@ -1250,15 +1252,15 @@ msgid "" "processes or systems." msgstr "" -#: library/pickle.rst:1060 +#: library/pickle.rst:1061 msgid ":pep:`574` -- Pickle protocol 5 with out-of-band data" msgstr "" -#: library/pickle.rst:1066 +#: library/pickle.rst:1067 msgid "Restricting Globals" msgstr "" -#: library/pickle.rst:1071 +#: library/pickle.rst:1072 msgid "" "By default, unpickling will import any class or function that it finds in " "the pickle data. For many applications, this behaviour is unacceptable as " @@ -1266,7 +1268,7 @@ msgid "" "what this hand-crafted pickle data stream does when loaded::" msgstr "" -#: library/pickle.rst:1081 +#: library/pickle.rst:1082 msgid "" "In this example, the unpickler imports the :func:`os.system` function and " "then apply the string argument \"echo hello world\". Although this example " @@ -1274,7 +1276,7 @@ msgid "" "system." msgstr "" -#: library/pickle.rst:1085 +#: library/pickle.rst:1086 msgid "" "For this reason, you may want to control what gets unpickled by customizing :" "meth:`Unpickler.find_class`. Unlike its name suggests, :meth:`Unpickler." @@ -1283,17 +1285,17 @@ msgid "" "restrict them to a safe subset." msgstr "" -#: library/pickle.rst:1091 +#: library/pickle.rst:1092 msgid "" "Here is an example of an unpickler allowing only few safe classes from the :" "mod:`builtins` module to be loaded::" msgstr "" -#: library/pickle.rst:1120 +#: library/pickle.rst:1121 msgid "A sample usage of our unpickler working as intended::" msgstr "" -#: library/pickle.rst:1139 +#: library/pickle.rst:1140 msgid "" "As our examples shows, you have to be careful with what you allow to be " "unpickled. Therefore if security is a concern, you may want to consider " @@ -1301,97 +1303,97 @@ msgid "" "party solutions." msgstr "" -#: library/pickle.rst:1146 +#: library/pickle.rst:1147 msgid "Performance" msgstr "" -#: library/pickle.rst:1148 +#: library/pickle.rst:1149 msgid "" "Recent versions of the pickle protocol (from protocol 2 and upwards) feature " "efficient binary encodings for several common features and built-in types. " "Also, the :mod:`pickle` module has a transparent optimizer written in C." msgstr "" -#: library/pickle.rst:1156 +#: library/pickle.rst:1157 msgid "Examples" msgstr "" -#: library/pickle.rst:1158 +#: library/pickle.rst:1159 msgid "" "For the simplest code, use the :func:`dump` and :func:`load` functions. ::" msgstr "" -#: library/pickle.rst:1174 +#: library/pickle.rst:1175 msgid "The following example reads the resulting pickled data. ::" msgstr "" -#: library/pickle.rst:1191 +#: library/pickle.rst:1192 msgid "Module :mod:`copyreg`" msgstr "" -#: library/pickle.rst:1191 +#: library/pickle.rst:1192 msgid "Pickle interface constructor registration for extension types." msgstr "" -#: library/pickle.rst:1194 +#: library/pickle.rst:1195 msgid "Module :mod:`pickletools`" msgstr "" -#: library/pickle.rst:1194 +#: library/pickle.rst:1195 msgid "Tools for working with and analyzing pickled data." msgstr "" -#: library/pickle.rst:1197 +#: library/pickle.rst:1198 msgid "Module :mod:`shelve`" msgstr "" -#: library/pickle.rst:1197 +#: library/pickle.rst:1198 msgid "Indexed databases of objects; uses :mod:`pickle`." msgstr "" -#: library/pickle.rst:1200 +#: library/pickle.rst:1201 msgid "Module :mod:`copy`" msgstr "" -#: library/pickle.rst:1200 +#: library/pickle.rst:1201 msgid "Shallow and deep object copying." msgstr "" -#: library/pickle.rst:1202 +#: library/pickle.rst:1203 msgid "Module :mod:`marshal`" msgstr "" -#: library/pickle.rst:1203 +#: library/pickle.rst:1204 msgid "High-performance serialization of built-in types." msgstr "" -#: library/pickle.rst:1207 +#: library/pickle.rst:1208 msgid "Footnotes" msgstr "" -#: library/pickle.rst:1208 +#: library/pickle.rst:1209 msgid "Don't confuse this with the :mod:`marshal` module" msgstr "" -#: library/pickle.rst:1210 +#: library/pickle.rst:1211 msgid "" "This is why :keyword:`lambda` functions cannot be pickled: all :keyword:`!" "lambda` functions share the same name: ````." msgstr "" -#: library/pickle.rst:1213 +#: library/pickle.rst:1214 msgid "" "The exception raised will likely be an :exc:`ImportError` or an :exc:" "`AttributeError` but it could be something else." msgstr "" -#: library/pickle.rst:1216 +#: library/pickle.rst:1217 msgid "" "The :mod:`copy` module uses this protocol for shallow and deep copying " "operations." msgstr "" -#: library/pickle.rst:1219 +#: library/pickle.rst:1220 msgid "" "The limitation on alphanumeric characters is due to the fact that persistent " "IDs in protocol 0 are delimited by the newline character. Therefore if any " @@ -1439,22 +1441,22 @@ msgstr "" msgid "protocol" msgstr "" -#: library/pickle.rst:747 +#: library/pickle.rst:748 msgid "persistent_id (pickle protocol)" msgstr "" -#: library/pickle.rst:747 +#: library/pickle.rst:748 msgid "persistent_load (pickle protocol)" msgstr "" -#: library/pickle.rst:823 +#: library/pickle.rst:824 msgid "__getstate__() (copy protocol)" msgstr "" -#: library/pickle.rst:823 +#: library/pickle.rst:824 msgid "__setstate__() (copy protocol)" msgstr "" -#: library/pickle.rst:1068 +#: library/pickle.rst:1069 msgid "find_class() (pickle protocol)" msgstr "" diff --git a/library/pickletools.po b/library/pickletools.po index c05601462..8749311d0 100644 --- a/library/pickletools.po +++ b/library/pickletools.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -97,7 +97,7 @@ msgid "" msgstr "" #: library/pickletools.rst:97 -msgid "The *annotate* argument." +msgid "Added the *annotate* parameter." msgstr "" #: library/pickletools.rst:102 diff --git a/library/poplib.po b/library/poplib.po index 6dde642df..132152812 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -73,13 +73,13 @@ msgid "" "timeout setting will be used)." msgstr "" -#: library/poplib.rst:75 +#: library/poplib.rst:77 msgid "" "Raises an :ref:`auditing event ` ``poplib.connect`` with arguments " "``self``, ``host``, ``port``." msgstr "" -#: library/poplib.rst:77 +#: library/poplib.rst:79 msgid "" "Raises an :ref:`auditing event ` ``poplib.putline`` with arguments " "``self``, ``line``." diff --git a/library/pyclbr.po b/library/pyclbr.po index e58c45923..4cbec9087 100644 --- a/library/pyclbr.po +++ b/library/pyclbr.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -79,79 +79,87 @@ msgstr "" msgid "Function Objects" msgstr "" -#: library/pyclbr.rst:61 +#: library/pyclbr.rst:64 msgid "" -"Class :class:`Function` instances describe functions defined by def " +"Class :class:`!Function` instances describe functions defined by def " "statements. They have the following attributes:" msgstr "" -#: library/pyclbr.rst:67 +#: library/pyclbr.rst:70 msgid "Name of the file in which the function is defined." msgstr "" -#: library/pyclbr.rst:72 +#: library/pyclbr.rst:75 msgid "The name of the module defining the function described." msgstr "" -#: library/pyclbr.rst:77 +#: library/pyclbr.rst:80 msgid "The name of the function." msgstr "" -#: library/pyclbr.rst:132 +#: library/pyclbr.rst:140 msgid "The line number in the file where the definition starts." msgstr "" -#: library/pyclbr.rst:87 -msgid "For top-level functions, None. For nested functions, the parent." +#: library/pyclbr.rst:90 +msgid "For top-level functions, ``None``. For nested functions, the parent." msgstr "" -#: library/pyclbr.rst:144 +#: library/pyclbr.rst:97 msgid "" -"A dictionary mapping names to descriptors for nested functions and classes." +"A :class:`dictionary ` mapping names to descriptors for nested " +"functions and classes." msgstr "" -#: library/pyclbr.rst:102 +#: library/pyclbr.rst:105 msgid "" -"``True`` for functions that are defined with the ``async`` prefix, ``False`` " -"otherwise." +"``True`` for functions that are defined with the :keyword:`async ` prefix, ``False`` otherwise." msgstr "" -#: library/pyclbr.rst:110 +#: library/pyclbr.rst:114 msgid "Class Objects" msgstr "" -#: library/pyclbr.rst:111 +#: library/pyclbr.rst:118 msgid "" -"Class :class:`Class` instances describe classes defined by class " -"statements. They have the same attributes as Functions and two more." +"Class :class:`!Class` instances describe classes defined by class " +"statements. They have the same attributes as :class:`Functions ` " +"and two more." msgstr "" -#: library/pyclbr.rst:117 +#: library/pyclbr.rst:125 msgid "Name of the file in which the class is defined." msgstr "" -#: library/pyclbr.rst:122 +#: library/pyclbr.rst:130 msgid "The name of the module defining the class described." msgstr "" -#: library/pyclbr.rst:127 +#: library/pyclbr.rst:135 msgid "The name of the class." msgstr "" -#: library/pyclbr.rst:137 +#: library/pyclbr.rst:145 msgid "For top-level classes, None. For nested classes, the parent." msgstr "" #: library/pyclbr.rst:152 msgid "" -"A list of :class:`Class` objects which describe the immediate base classes " +"A dictionary mapping names to descriptors for nested functions and classes." +msgstr "" + +#: library/pyclbr.rst:160 +msgid "" +"A list of :class:`!Class` objects which describe the immediate base classes " "of the class being described. Classes which are named as superclasses but " "which are not discoverable by :func:`readmodule_ex` are listed as a string " -"with the class name instead of as :class:`Class` objects." +"with the class name instead of as :class:`!Class` objects." msgstr "" -#: library/pyclbr.rst:161 +#: library/pyclbr.rst:169 msgid "" -"A dictionary mapping method names to line numbers. This can be derived from " -"the newer children dictionary, but remains for back-compatibility." +"A :class:`dictionary ` mapping method names to line numbers. This can " +"be derived from the newer :attr:`children` dictionary, but remains for back-" +"compatibility." msgstr "" diff --git a/library/pyexpat.po b/library/pyexpat.po index f50884509..455e7d853 100644 --- a/library/pyexpat.po +++ b/library/pyexpat.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -230,17 +230,18 @@ msgid "" "`CharacterDataHandler` callback whenever possible. This can improve " "performance substantially since Expat normally breaks character data into " "chunks at every line ending. This attribute is false by default, and may be " -"changed at any time." +"changed at any time. Note that when it is false, data that does not contain " +"newlines may be chunked too." msgstr "" -#: library/pyexpat.rst:222 +#: library/pyexpat.rst:223 msgid "" "If :attr:`buffer_text` is enabled, the number of bytes stored in the buffer. " "These bytes represent UTF-8 encoded text. This attribute has no meaningful " "interpretation when :attr:`buffer_text` is false." msgstr "" -#: library/pyexpat.rst:229 +#: library/pyexpat.rst:230 msgid "" "Setting this attribute to a non-zero integer causes the attributes to be " "reported as a list rather than a dictionary. The attributes are presented " @@ -250,7 +251,7 @@ msgid "" "is false; it may be changed at any time." msgstr "" -#: library/pyexpat.rst:239 +#: library/pyexpat.rst:240 msgid "" "If set to a non-zero integer, the parser will report only those attributes " "which were specified in the document instance and not those which were " @@ -261,7 +262,7 @@ msgid "" "time." msgstr "" -#: library/pyexpat.rst:247 +#: library/pyexpat.rst:248 msgid "" "The following attributes contain values relating to the most recent error " "encountered by an :class:`xmlparser` object, and will only have correct " @@ -269,26 +270,26 @@ msgid "" "`xml.parsers.expat.ExpatError` exception." msgstr "" -#: library/pyexpat.rst:255 +#: library/pyexpat.rst:256 msgid "Byte index at which an error occurred." msgstr "" -#: library/pyexpat.rst:260 +#: library/pyexpat.rst:261 msgid "" "Numeric code specifying the problem. This value can be passed to the :func:" "`ErrorString` function, or compared to one of the constants defined in the " "``errors`` object." msgstr "" -#: library/pyexpat.rst:267 +#: library/pyexpat.rst:268 msgid "Column number at which an error occurred." msgstr "" -#: library/pyexpat.rst:272 +#: library/pyexpat.rst:273 msgid "Line number at which an error occurred." msgstr "" -#: library/pyexpat.rst:274 +#: library/pyexpat.rst:275 msgid "" "The following attributes contain values relating to the current parse " "location in an :class:`xmlparser` object. During a callback reporting a " @@ -298,19 +299,19 @@ msgid "" "whether there was an associated callback)." msgstr "" -#: library/pyexpat.rst:284 +#: library/pyexpat.rst:285 msgid "Current byte index in the parser input." msgstr "" -#: library/pyexpat.rst:289 +#: library/pyexpat.rst:290 msgid "Current column number in the parser input." msgstr "" -#: library/pyexpat.rst:294 +#: library/pyexpat.rst:295 msgid "Current line number in the parser input." msgstr "" -#: library/pyexpat.rst:296 +#: library/pyexpat.rst:297 msgid "" "Here is the list of handlers that can be set. To set a handler on an :class:" "`xmlparser` object *o*, use ``o.handlername = func``. *handlername* must be " @@ -319,7 +320,7 @@ msgid "" "unless otherwise stated." msgstr "" -#: library/pyexpat.rst:305 +#: library/pyexpat.rst:306 msgid "" "Called when the XML declaration is parsed. The XML declaration is the " "(optional) declaration of the applicable version of the XML recommendation, " @@ -330,7 +331,7 @@ msgid "" "only available with Expat version 1.95.0 or newer." msgstr "" -#: library/pyexpat.rst:316 +#: library/pyexpat.rst:317 msgid "" "Called when Expat begins parsing the document type declaration (``'``." msgstr "" -#: library/pyexpat.rst:430 +#: library/pyexpat.rst:434 msgid "" "Called at the start of a CDATA section. This and :attr:" "`EndCdataSectionHandler` are needed to be able to identify the syntactical " "start and end for CDATA sections." msgstr "" -#: library/pyexpat.rst:437 +#: library/pyexpat.rst:441 msgid "Called at the end of a CDATA section." msgstr "" -#: library/pyexpat.rst:442 +#: library/pyexpat.rst:446 msgid "" "Called for any characters in the XML document for which no applicable " "handler has been specified. This means characters that are part of a " @@ -461,14 +465,14 @@ msgid "" "supplied." msgstr "" -#: library/pyexpat.rst:449 +#: library/pyexpat.rst:453 msgid "" "This is the same as the :func:`DefaultHandler`, but doesn't inhibit " "expansion of internal entities. The entity reference will not be passed to " "the default handler." msgstr "" -#: library/pyexpat.rst:456 +#: library/pyexpat.rst:460 msgid "" "Called if the XML document hasn't been declared as being a standalone " "document. This happens when there is an external subset or a reference to a " @@ -478,7 +482,7 @@ msgid "" "set, no exception is raised by the parser for this condition." msgstr "" -#: library/pyexpat.rst:466 +#: library/pyexpat.rst:470 msgid "" "Called for references to external entities. *base* is the current base, as " "set by a previous call to :meth:`SetBase`. The public and system " @@ -487,7 +491,7 @@ msgid "" "is opaque and should only be used as described below." msgstr "" -#: library/pyexpat.rst:472 +#: library/pyexpat.rst:476 msgid "" "For external entities to be parsed, this handler must be implemented. It is " "responsible for creating the sub-parser using " @@ -497,130 +501,130 @@ msgid "" "`XML_ERROR_EXTERNAL_ENTITY_HANDLING` error, otherwise parsing will continue." msgstr "" -#: library/pyexpat.rst:480 +#: library/pyexpat.rst:484 msgid "" "If this handler is not provided, external entities are reported by the :attr:" "`DefaultHandler` callback, if provided." msgstr "" -#: library/pyexpat.rst:487 +#: library/pyexpat.rst:491 msgid "ExpatError Exceptions" msgstr "" -#: library/pyexpat.rst:492 +#: library/pyexpat.rst:496 msgid ":exc:`ExpatError` exceptions have a number of interesting attributes:" msgstr "" -#: library/pyexpat.rst:497 +#: library/pyexpat.rst:501 msgid "" "Expat's internal error number for the specific error. The :data:`errors." "messages ` dictionary maps these error " "numbers to Expat's error messages. For example::" msgstr "" -#: library/pyexpat.rst:509 +#: library/pyexpat.rst:513 msgid "" "The :mod:`~xml.parsers.expat.errors` module also provides error message " "constants and a dictionary :data:`~xml.parsers.expat.errors.codes` mapping " "these messages back to the error codes, see below." msgstr "" -#: library/pyexpat.rst:516 +#: library/pyexpat.rst:520 msgid "" "Line number on which the error was detected. The first line is numbered " "``1``." msgstr "" -#: library/pyexpat.rst:521 +#: library/pyexpat.rst:525 msgid "" "Character offset into the line where the error occurred. The first column " "is numbered ``0``." msgstr "" -#: library/pyexpat.rst:528 +#: library/pyexpat.rst:532 msgid "Example" msgstr "" -#: library/pyexpat.rst:530 +#: library/pyexpat.rst:534 msgid "" "The following program defines three handlers that just print out their " "arguments. ::" msgstr "" -#: library/pyexpat.rst:554 +#: library/pyexpat.rst:558 msgid "The output from this program is::" msgstr "" -#: library/pyexpat.rst:571 +#: library/pyexpat.rst:575 msgid "Content Model Descriptions" msgstr "" -#: library/pyexpat.rst:577 +#: library/pyexpat.rst:581 msgid "" "Content models are described using nested tuples. Each tuple contains four " "values: the type, the quantifier, the name, and a tuple of children. " "Children are simply additional content model descriptions." msgstr "" -#: library/pyexpat.rst:581 +#: library/pyexpat.rst:585 msgid "" "The values of the first two fields are constants defined in the :mod:`xml." "parsers.expat.model` module. These constants can be collected in two " "groups: the model type group and the quantifier group." msgstr "" -#: library/pyexpat.rst:585 +#: library/pyexpat.rst:589 msgid "The constants in the model type group are:" msgstr "" -#: library/pyexpat.rst:591 +#: library/pyexpat.rst:595 msgid "" "The element named by the model name was declared to have a content model of " "``ANY``." msgstr "" -#: library/pyexpat.rst:598 +#: library/pyexpat.rst:602 msgid "" "The named element allows a choice from a number of options; this is used for " "content models such as ``(A | B | C)``." msgstr "" -#: library/pyexpat.rst:605 +#: library/pyexpat.rst:609 msgid "Elements which are declared to be ``EMPTY`` have this model type." msgstr "" -#: library/pyexpat.rst:619 +#: library/pyexpat.rst:623 msgid "" "Models which represent a series of models which follow one after the other " "are indicated with this model type. This is used for models such as ``(A, " "B, C)``." msgstr "" -#: library/pyexpat.rst:622 +#: library/pyexpat.rst:626 msgid "The constants in the quantifier group are:" msgstr "" -#: library/pyexpat.rst:628 +#: library/pyexpat.rst:632 msgid "No modifier is given, so it can appear exactly once, as for ``A``." msgstr "" -#: library/pyexpat.rst:634 +#: library/pyexpat.rst:638 msgid "The model is optional: it can appear once or not at all, as for ``A?``." msgstr "" -#: library/pyexpat.rst:640 +#: library/pyexpat.rst:644 msgid "The model must occur one or more times (like ``A+``)." msgstr "" -#: library/pyexpat.rst:646 +#: library/pyexpat.rst:650 msgid "The model must occur zero or more times, as for ``A*``." msgstr "" -#: library/pyexpat.rst:652 +#: library/pyexpat.rst:656 msgid "Expat error constants" msgstr "" -#: library/pyexpat.rst:656 +#: library/pyexpat.rst:660 msgid "" "The following constants are provided in the :mod:`xml.parsers.expat.errors` " "module. These constants are useful in interpreting some of the attributes " @@ -631,205 +635,205 @@ msgid "" "XML_ERROR_{CONSTANT_NAME}]`." msgstr "" -#: library/pyexpat.rst:664 +#: library/pyexpat.rst:668 msgid "The ``errors`` module has the following attributes:" msgstr "" -#: library/pyexpat.rst:668 +#: library/pyexpat.rst:672 msgid "A dictionary mapping string descriptions to their error codes." msgstr "" -#: library/pyexpat.rst:675 +#: library/pyexpat.rst:679 msgid "A dictionary mapping numeric error codes to their string descriptions." msgstr "" -#: library/pyexpat.rst:685 +#: library/pyexpat.rst:689 msgid "" "An entity reference in an attribute value referred to an external entity " "instead of an internal entity." msgstr "" -#: library/pyexpat.rst:691 +#: library/pyexpat.rst:695 msgid "" "A character reference referred to a character which is illegal in XML (for " "example, character ``0``, or '``�``')." msgstr "" -#: library/pyexpat.rst:697 +#: library/pyexpat.rst:701 msgid "" "An entity reference referred to an entity which was declared with a " "notation, so cannot be parsed." msgstr "" -#: library/pyexpat.rst:703 +#: library/pyexpat.rst:707 msgid "An attribute was used more than once in a start tag." msgstr "" -#: library/pyexpat.rst:711 +#: library/pyexpat.rst:715 msgid "" "Raised when an input byte could not properly be assigned to a character; for " "example, a NUL byte (value ``0``) in a UTF-8 input stream." msgstr "" -#: library/pyexpat.rst:717 +#: library/pyexpat.rst:721 msgid "Something other than whitespace occurred after the document element." msgstr "" -#: library/pyexpat.rst:722 +#: library/pyexpat.rst:726 msgid "" "An XML declaration was found somewhere other than the start of the input " "data." msgstr "" -#: library/pyexpat.rst:727 +#: library/pyexpat.rst:731 msgid "" "The document contains no elements (XML requires all documents to contain " "exactly one top-level element).." msgstr "" -#: library/pyexpat.rst:733 +#: library/pyexpat.rst:737 msgid "Expat was not able to allocate memory internally." msgstr "" -#: library/pyexpat.rst:738 +#: library/pyexpat.rst:742 msgid "A parameter entity reference was found where it was not allowed." msgstr "" -#: library/pyexpat.rst:743 +#: library/pyexpat.rst:747 msgid "An incomplete character was found in the input." msgstr "" -#: library/pyexpat.rst:748 +#: library/pyexpat.rst:752 msgid "" "An entity reference contained another reference to the same entity; possibly " "via a different name, and possibly indirectly." msgstr "" -#: library/pyexpat.rst:754 +#: library/pyexpat.rst:758 msgid "Some unspecified syntax error was encountered." msgstr "" -#: library/pyexpat.rst:759 +#: library/pyexpat.rst:763 msgid "An end tag did not match the innermost open start tag." msgstr "" -#: library/pyexpat.rst:764 +#: library/pyexpat.rst:768 msgid "" "Some token (such as a start tag) was not closed before the end of the stream " "or the next token was encountered." msgstr "" -#: library/pyexpat.rst:770 +#: library/pyexpat.rst:774 msgid "A reference was made to an entity which was not defined." msgstr "" -#: library/pyexpat.rst:775 +#: library/pyexpat.rst:779 msgid "The document encoding is not supported by Expat." msgstr "" -#: library/pyexpat.rst:780 +#: library/pyexpat.rst:784 msgid "A CDATA marked section was not closed." msgstr "" -#: library/pyexpat.rst:788 +#: library/pyexpat.rst:792 msgid "" "The parser determined that the document was not \"standalone\" though it " "declared itself to be in the XML declaration, and the :attr:" "`NotStandaloneHandler` was set and returned ``0``." msgstr "" -#: library/pyexpat.rst:801 +#: library/pyexpat.rst:805 msgid "" "An operation was requested that requires DTD support to be compiled in, but " "Expat was configured without DTD support. This should never be reported by " "a standard build of the :mod:`xml.parsers.expat` module." msgstr "" -#: library/pyexpat.rst:808 +#: library/pyexpat.rst:812 msgid "" "A behavioral change was requested after parsing started that can only be " "changed before parsing has started. This is (currently) only raised by :" "meth:`UseForeignDTD`." msgstr "" -#: library/pyexpat.rst:815 +#: library/pyexpat.rst:819 msgid "An undeclared prefix was found when namespace processing was enabled." msgstr "" -#: library/pyexpat.rst:820 +#: library/pyexpat.rst:824 msgid "" "The document attempted to remove the namespace declaration associated with a " "prefix." msgstr "" -#: library/pyexpat.rst:826 +#: library/pyexpat.rst:830 msgid "A parameter entity contained incomplete markup." msgstr "" -#: library/pyexpat.rst:831 +#: library/pyexpat.rst:835 msgid "The document contained no document element at all." msgstr "" -#: library/pyexpat.rst:836 +#: library/pyexpat.rst:840 msgid "There was an error parsing a text declaration in an external entity." msgstr "" -#: library/pyexpat.rst:841 +#: library/pyexpat.rst:845 msgid "Characters were found in the public id that are not allowed." msgstr "" -#: library/pyexpat.rst:846 +#: library/pyexpat.rst:850 msgid "" "The requested operation was made on a suspended parser, but isn't allowed. " "This includes attempts to provide additional input or to stop the parser." msgstr "" -#: library/pyexpat.rst:852 +#: library/pyexpat.rst:856 msgid "" "An attempt to resume the parser was made when the parser had not been " "suspended." msgstr "" -#: library/pyexpat.rst:890 library/pyexpat.rst:895 +#: library/pyexpat.rst:894 library/pyexpat.rst:899 msgid "This should not be reported to Python applications." msgstr "" -#: library/pyexpat.rst:862 +#: library/pyexpat.rst:866 msgid "" "The requested operation was made on a parser which was finished parsing " "input, but isn't allowed. This includes attempts to provide additional " "input or to stop the parser." msgstr "" -#: library/pyexpat.rst:872 +#: library/pyexpat.rst:876 msgid "" "An attempt was made to undeclare reserved namespace prefix ``xml`` or to " "bind it to another namespace URI." msgstr "" -#: library/pyexpat.rst:879 +#: library/pyexpat.rst:883 msgid "" "An attempt was made to declare or undeclare reserved namespace prefix " "``xmlns``." msgstr "" -#: library/pyexpat.rst:884 +#: library/pyexpat.rst:888 msgid "" "An attempt was made to bind the URI of one the reserved namespace prefixes " "``xml`` and ``xmlns`` to another namespace prefix." msgstr "" -#: library/pyexpat.rst:900 +#: library/pyexpat.rst:904 msgid "" "The limit on input amplification factor (from DTD and entities) has been " "breached." msgstr "" -#: library/pyexpat.rst:905 +#: library/pyexpat.rst:909 msgid "Footnotes" msgstr "" -#: library/pyexpat.rst:906 +#: library/pyexpat.rst:910 msgid "" "The encoding string included in XML output should conform to the appropriate " "standards. For example, \"UTF-8\" is valid, but \"UTF8\" is not. See https://" diff --git a/library/re.po b/library/re.po index 1307cc056..1a68a3a57 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: 2023-10-01 00:18+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -35,7 +35,7 @@ msgid "" "Both patterns and strings to be searched can be Unicode strings (:class:" "`str`) as well as 8-bit strings (:class:`bytes`). However, Unicode strings " "and 8-bit strings cannot be mixed: that is, you cannot match a Unicode " -"string with a byte pattern or vice-versa; similarly, when asking for a " +"string with a bytes pattern or vice-versa; similarly, when asking for a " "substitution, the replacement string must be of the same type as both the " "pattern and the search string." msgstr "" @@ -144,7 +144,7 @@ msgstr "" msgid "The special characters are:" msgstr "" -#: library/re.rst:1552 +#: library/re.rst:1606 msgid "``.``" msgstr "" @@ -328,7 +328,7 @@ msgid "" "recommended that you use raw strings for all but the simplest expressions." msgstr "" -#: library/re.rst:294 +#: library/re.rst:293 msgid "``[]``" msgstr "" @@ -362,11 +362,11 @@ msgstr "" #: library/re.rst:259 msgid "" "Character classes such as ``\\w`` or ``\\S`` (defined below) are also " -"accepted inside a set, although the characters they match depends on " -"whether :const:`ASCII` or :const:`LOCALE` mode is in force." +"accepted inside a set, although the characters they match depend on the " +"flags_ used." msgstr "" -#: library/re.rst:265 +#: library/re.rst:264 msgid "" "Characters that are not within a range can be matched by :dfn:" "`complementing` the set. If the first character of the set is ``'^'``, all " @@ -376,7 +376,7 @@ msgid "" "first character in the set." msgstr "" -#: library/re.rst:272 +#: library/re.rst:271 msgid "" "To match a literal ``']'`` inside a set, precede it with a backslash, or " "place it at the beginning of the set. For example, both ``[()[\\]{}]`` and " @@ -384,7 +384,7 @@ msgid "" "and parentheses." msgstr "" -#: library/re.rst:282 +#: library/re.rst:281 msgid "" "Support of nested sets and set operations as in `Unicode Technical Standard " "#18`_ might be added in the future. This would change the syntax, so to " @@ -394,17 +394,17 @@ msgid "" "``'||'``. To avoid a warning escape them with a backslash." msgstr "" -#: library/re.rst:292 +#: library/re.rst:291 msgid "" ":exc:`FutureWarning` is raised if a character set contains constructs that " "will change semantically in the future." msgstr "" -#: library/re.rst:307 +#: library/re.rst:306 msgid "``|``" msgstr "" -#: library/re.rst:299 +#: library/re.rst:298 msgid "" "``A|B``, where *A* and *B* can be arbitrary REs, creates a regular " "expression that will match either *A* or *B*. An arbitrary number of REs " @@ -417,11 +417,11 @@ msgid "" "use ``\\|``, or enclose it inside a character class, as in ``[|]``." msgstr "" -#: library/re.rst:317 +#: library/re.rst:316 msgid "``(...)``" msgstr "" -#: library/re.rst:313 +#: library/re.rst:312 msgid "" "Matches whatever regular expression is inside the parentheses, and indicates " "the start and end of a group; the contents of a group can be retrieved after " @@ -431,11 +431,11 @@ msgid "" "character class: ``[(]``, ``[)]``." msgstr "" -#: library/re.rst:326 +#: library/re.rst:325 msgid "``(?...)``" msgstr "" -#: library/re.rst:322 +#: library/re.rst:321 msgid "" "This is an extension notation (a ``'?'`` following a ``'('`` is not " "meaningful otherwise). The first character after the ``'?'`` determines " @@ -444,33 +444,62 @@ msgid "" "rule. Following are the currently supported extensions." msgstr "" -#: library/re.rst:343 +#: library/re.rst:348 msgid "``(?aiLmsux)``" msgstr "" -#: library/re.rst:329 +#: library/re.rst:328 msgid "" "(One or more letters from the set ``'a'``, ``'i'``, ``'L'``, ``'m'``, " -"``'s'``, ``'u'``, ``'x'``.) The group matches the empty string; the letters " -"set the corresponding flags: :const:`re.A` (ASCII-only matching), :const:`re." -"I` (ignore case), :const:`re.L` (locale dependent), :const:`re.M` (multi-" -"line), :const:`re.S` (dot matches all), :const:`re.U` (Unicode matching), " -"and :const:`re.X` (verbose), for the entire regular expression. (The flags " -"are described in :ref:`contents-of-module-re`.) This is useful if you wish " -"to include the flags as part of the regular expression, instead of passing a " -"*flag* argument to the :func:`re.compile` function. Flags should be used " -"first in the expression string." -msgstr "" - -#: library/re.rst:342 +"``'s'``, ``'u'``, ``'x'``.) The group matches the empty string; the letters " +"set the corresponding flags for the entire regular expression:" +msgstr "" + +#: library/re.rst:365 +msgid ":const:`re.A` (ASCII-only matching)" +msgstr "" + +#: library/re.rst:366 +msgid ":const:`re.I` (ignore case)" +msgstr "" + +#: library/re.rst:367 +msgid ":const:`re.L` (locale dependent)" +msgstr "" + +#: library/re.rst:368 +msgid ":const:`re.M` (multi-line)" +msgstr "" + +#: library/re.rst:369 +msgid ":const:`re.S` (dot matches all)" +msgstr "" + +#: library/re.rst:370 +msgid ":const:`re.U` (Unicode matching)" +msgstr "" + +#: library/re.rst:371 +msgid ":const:`re.X` (verbose)" +msgstr "" + +#: library/re.rst:341 +msgid "" +"(The flags are described in :ref:`contents-of-module-re`.) This is useful if " +"you wish to include the flags as part of the regular expression, instead of " +"passing a *flag* argument to the :func:`re.compile` function. Flags should " +"be used first in the expression string." +msgstr "" + +#: library/re.rst:347 msgid "This construction can only be used at the start of the expression." msgstr "" -#: library/re.rst:351 +#: library/re.rst:356 msgid "``(?:...)``" msgstr "" -#: library/re.rst:348 +#: library/re.rst:353 msgid "" "A non-capturing version of regular parentheses. Matches whatever regular " "expression is inside the parentheses, but the substring matched by the group " @@ -478,44 +507,44 @@ msgid "" "pattern." msgstr "" -#: library/re.rst:377 +#: library/re.rst:388 msgid "``(?aiLmsux-imsx:...)``" msgstr "" -#: library/re.rst:354 +#: library/re.rst:359 msgid "" "(Zero or more letters from the set ``'a'``, ``'i'``, ``'L'``, ``'m'``, " "``'s'``, ``'u'``, ``'x'``, optionally followed by ``'-'`` followed by one or " "more letters from the ``'i'``, ``'m'``, ``'s'``, ``'x'``.) The letters set " -"or remove the corresponding flags: :const:`re.A` (ASCII-only matching), :" -"const:`re.I` (ignore case), :const:`re.L` (locale dependent), :const:`re.M` " -"(multi-line), :const:`re.S` (dot matches all), :const:`re.U` (Unicode " -"matching), and :const:`re.X` (verbose), for the part of the expression. (The " -"flags are described in :ref:`contents-of-module-re`.)" +"or remove the corresponding flags for the part of the expression:" +msgstr "" + +#: library/re.rst:373 +msgid "(The flags are described in :ref:`contents-of-module-re`.)" msgstr "" -#: library/re.rst:364 +#: library/re.rst:375 msgid "" "The letters ``'a'``, ``'L'`` and ``'u'`` are mutually exclusive when used as " "inline flags, so they can't be combined or follow ``'-'``. Instead, when " "one of them appears in an inline group, it overrides the matching mode in " "the enclosing group. In Unicode patterns ``(?a:...)`` switches to ASCII-" "only matching, and ``(?u:...)`` switches to Unicode matching (default). In " -"byte pattern ``(?L:...)`` switches to locale depending matching, and ``(?" +"bytes patterns ``(?L:...)`` switches to locale dependent matching, and ``(?" "a:...)`` switches to ASCII-only matching (default). This override is only in " "effect for the narrow inline group, and the original matching mode is " "restored outside of the group." msgstr "" -#: library/re.rst:376 +#: library/re.rst:387 msgid "The letters ``'a'``, ``'L'`` and ``'u'`` also can be used in a group." msgstr "" -#: library/re.rst:392 +#: library/re.rst:403 msgid "``(?>...)``" msgstr "" -#: library/re.rst:380 +#: library/re.rst:391 msgid "" "Attempts to match ``...`` as if it was a separate regular expression, and if " "successful, continues to match the rest of the pattern following it. If the " @@ -529,11 +558,11 @@ msgid "" "thus fail to match." msgstr "" -#: library/re.rst:424 +#: library/re.rst:435 msgid "``(?P...)``" msgstr "" -#: library/re.rst:397 +#: library/re.rst:408 msgid "" "Similar to regular parentheses, but the substring matched by the group is " "accessible via the symbolic group name *name*. Group names must be valid " @@ -543,108 +572,108 @@ msgid "" "the group were not named." msgstr "" -#: library/re.rst:404 +#: library/re.rst:415 msgid "" "Named groups can be referenced in three contexts. If the pattern is ``(?" "P['\"]).*?(?P=quote)`` (i.e. matching a string quoted with either " "single or double quotes):" msgstr "" -#: library/re.rst:409 +#: library/re.rst:420 msgid "Context of reference to group \"quote\"" msgstr "" -#: library/re.rst:409 +#: library/re.rst:420 msgid "Ways to reference it" msgstr "" -#: library/re.rst:411 +#: library/re.rst:422 msgid "in the same pattern itself" msgstr "" -#: library/re.rst:411 +#: library/re.rst:422 msgid "``(?P=quote)`` (as shown)" msgstr "" -#: library/re.rst:419 +#: library/re.rst:430 msgid "``\\1``" msgstr "" -#: library/re.rst:414 +#: library/re.rst:425 msgid "when processing match object *m*" msgstr "" -#: library/re.rst:414 +#: library/re.rst:425 msgid "``m.group('quote')``" msgstr "" -#: library/re.rst:415 +#: library/re.rst:426 msgid "``m.end('quote')`` (etc.)" msgstr "" -#: library/re.rst:417 +#: library/re.rst:428 msgid "in a string passed to the *repl* argument of ``re.sub()``" msgstr "" -#: library/re.rst:417 +#: library/re.rst:428 msgid "``\\g``" msgstr "" -#: library/re.rst:418 +#: library/re.rst:429 msgid "``\\g<1>``" msgstr "" -#: library/re.rst:422 +#: library/re.rst:433 msgid "" "In :class:`bytes` patterns, group *name* can only contain bytes in the ASCII " "range (``b'\\x00'``-``b'\\x7f'``)." msgstr "" -#: library/re.rst:430 +#: library/re.rst:441 msgid "``(?P=name)``" msgstr "" -#: library/re.rst:429 +#: library/re.rst:440 msgid "" "A backreference to a named group; it matches whatever text was matched by " "the earlier group named *name*." msgstr "" -#: library/re.rst:435 +#: library/re.rst:446 msgid "``(?#...)``" msgstr "" -#: library/re.rst:435 +#: library/re.rst:446 msgid "A comment; the contents of the parentheses are simply ignored." msgstr "" -#: library/re.rst:442 +#: library/re.rst:453 msgid "``(?=...)``" msgstr "" -#: library/re.rst:440 +#: library/re.rst:451 msgid "" "Matches if ``...`` matches next, but doesn't consume any of the string. " "This is called a :dfn:`lookahead assertion`. For example, ``Isaac (?" "=Asimov)`` will match ``'Isaac '`` only if it's followed by ``'Asimov'``." msgstr "" -#: library/re.rst:449 +#: library/re.rst:460 msgid "``(?!...)``" msgstr "" -#: library/re.rst:447 +#: library/re.rst:458 msgid "" "Matches if ``...`` doesn't match next. This is a :dfn:`negative lookahead " "assertion`. For example, ``Isaac (?!Asimov)`` will match ``'Isaac '`` only " "if it's *not* followed by ``'Asimov'``." msgstr "" -#: library/re.rst:476 +#: library/re.rst:487 msgid "``(?<=...)``" msgstr "" -#: library/re.rst:454 +#: library/re.rst:465 msgid "" "Matches if the current position in the string is preceded by a match for " "``...`` that ends at the current position. This is called a :dfn:`positive " @@ -658,19 +687,19 @@ msgid "" "func:`match` function:" msgstr "" -#: library/re.rst:469 +#: library/re.rst:480 msgid "This example looks for a word following a hyphen:" msgstr "" -#: library/re.rst:475 +#: library/re.rst:486 msgid "Added support for group references of fixed length." msgstr "" -#: library/re.rst:485 +#: library/re.rst:496 msgid "``(?'``." msgstr "" -#: library/re.rst:498 +#: library/re.rst:509 msgid "" "Group *id* can only contain ASCII digits. In :class:`bytes` patterns, group " "*name* can only contain bytes in the ASCII range (``b'\\x00'``-``b'\\x7f'``)." msgstr "" -#: library/re.rst:506 +#: library/re.rst:517 msgid "" "The special sequences consist of ``'\\'`` and a character from the list " "below. If the ordinary character is not an ASCII digit or an ASCII letter, " @@ -707,11 +736,11 @@ msgid "" "matches the character ``'$'``." msgstr "" -#: library/re.rst:521 +#: library/re.rst:532 msgid "``\\number``" msgstr "" -#: library/re.rst:514 +#: library/re.rst:525 msgid "" "Matches the contents of the group of the same number. Groups are numbered " "starting from 1. For example, ``(.+) \\1`` matches ``'the the'`` or ``'55 " @@ -723,175 +752,209 @@ msgid "" "escapes are treated as characters." msgstr "" -#: library/re.rst:526 +#: library/re.rst:537 msgid "``\\A``" msgstr "" -#: library/re.rst:526 +#: library/re.rst:537 msgid "Matches only at the start of the string." msgstr "" -#: library/re.rst:542 +#: library/re.rst:559 msgid "``\\b``" msgstr "" -#: library/re.rst:531 +#: library/re.rst:542 msgid "" "Matches the empty string, but only at the beginning or end of a word. A word " -"is defined as a sequence of word characters. Note that formally, ``\\b`` is " +"is defined as a sequence of word characters. Note that formally, ``\\b`` is " "defined as the boundary between a ``\\w`` and a ``\\W`` character (or vice " -"versa), or between ``\\w`` and the beginning/end of the string. This means " -"that ``r'\\bfoo\\b'`` matches ``'foo'``, ``'foo.'``, ``'(foo)'``, ``'bar foo " -"baz'`` but not ``'foobar'`` or ``'foo3'``." +"versa), or between ``\\w`` and the beginning or end of the string. This " +"means that ``r'\\bat\\b'`` matches ``'at'``, ``'at.'``, ``'(at)'``, and " +"``'as at ay'`` but not ``'attempt'`` or ``'atlas'``." msgstr "" -#: library/re.rst:538 +#: library/re.rst:550 msgid "" -"By default Unicode alphanumerics are the ones used in Unicode patterns, but " -"this can be changed by using the :const:`ASCII` flag. Word boundaries are " -"determined by the current locale if the :const:`LOCALE` flag is used. Inside " -"a character range, ``\\b`` represents the backspace character, for " +"The default word characters in Unicode (str) patterns are Unicode " +"alphanumerics and the underscore, but this can be changed by using the :py:" +"const:`~re.ASCII` flag. Word boundaries are determined by the current locale " +"if the :py:const:`~re.LOCALE` flag is used." +msgstr "" + +#: library/re.rst:558 +msgid "" +"Inside a character range, ``\\b`` represents the backspace character, for " "compatibility with Python's string literals." msgstr "" -#: library/re.rst:553 +#: library/re.rst:573 msgid "``\\B``" msgstr "" -#: library/re.rst:547 +#: library/re.rst:564 msgid "" "Matches the empty string, but only when it is *not* at the beginning or end " -"of a word. This means that ``r'py\\B'`` matches ``'python'``, ``'py3'``, " -"``'py2'``, but not ``'py'``, ``'py.'``, or ``'py!'``. ``\\B`` is just the " -"opposite of ``\\b``, so word characters in Unicode patterns are Unicode " -"alphanumerics or the underscore, although this can be changed by using the :" -"const:`ASCII` flag. Word boundaries are determined by the current locale if " -"the :const:`LOCALE` flag is used." +"of a word. This means that ``r'at\\B'`` matches ``'athens'``, ``'atom'``, " +"``'attorney'``, but not ``'at'``, ``'at.'``, or ``'at!'``. ``\\B`` is the " +"opposite of ``\\b``, so word characters in Unicode (str) patterns are " +"Unicode alphanumerics or the underscore, although this can be changed by " +"using the :py:const:`~re.ASCII` flag. Word boundaries are determined by the " +"current locale if the :py:const:`~re.LOCALE` flag is used." msgstr "" -#: library/re.rst:565 +#: library/re.rst:589 msgid "``\\d``" msgstr "" -#: library/re.rst:582 library/re.rst:601 +#: library/re.rst:608 library/re.rst:631 msgid "For Unicode (str) patterns:" msgstr "" -#: library/re.rst:559 +#: library/re.rst:579 msgid "" "Matches any Unicode decimal digit (that is, any character in Unicode " -"character category [Nd]). This includes ``[0-9]``, and also many other " -"digit characters. If the :const:`ASCII` flag is used only ``[0-9]`` is " -"matched." +"character category `[Nd]`__). This includes ``[0-9]``, and also many other " +"digit characters." +msgstr "" + +#: library/re.rst:583 +msgid "Matches ``[0-9]`` if the :py:const:`~re.ASCII` flag is used." msgstr "" -#: library/re.rst:586 library/re.rst:607 +#: library/re.rst:612 library/re.rst:637 msgid "For 8-bit (bytes) patterns:" msgstr "" -#: library/re.rst:565 -msgid "Matches any decimal digit; this is equivalent to ``[0-9]``." +#: library/re.rst:588 +msgid "" +"Matches any decimal digit in the ASCII character set; this is equivalent to " +"``[0-9]``." msgstr "" -#: library/re.rst:572 +#: library/re.rst:597 msgid "``\\D``" msgstr "" -#: library/re.rst:570 +#: library/re.rst:594 msgid "" "Matches any character which is not a decimal digit. This is the opposite of " -"``\\d``. If the :const:`ASCII` flag is used this becomes the equivalent of " -"``[^0-9]``." +"``\\d``." +msgstr "" + +#: library/re.rst:597 +msgid "Matches ``[^0-9]`` if the :py:const:`~re.ASCII` flag is used." msgstr "" -#: library/re.rst:586 +#: library/re.rst:612 msgid "``\\s``" msgstr "" -#: library/re.rst:578 +#: library/re.rst:603 msgid "" "Matches Unicode whitespace characters (which includes " "``[ \\t\\n\\r\\f\\v]``, and also many other characters, for example the non-" -"breaking spaces mandated by typography rules in many languages). If the :" -"const:`ASCII` flag is used, only ``[ \\t\\n\\r\\f\\v]`` is matched." +"breaking spaces mandated by typography rules in many languages)." msgstr "" -#: library/re.rst:585 +#: library/re.rst:608 +msgid "" +"Matches ``[ \\t\\n\\r\\f\\v]`` if the :py:const:`~re.ASCII` flag is used." +msgstr "" + +#: library/re.rst:611 msgid "" "Matches characters considered whitespace in the ASCII character set; this is " "equivalent to ``[ \\t\\n\\r\\f\\v]``." msgstr "" -#: library/re.rst:593 +#: library/re.rst:620 msgid "``\\S``" msgstr "" -#: library/re.rst:591 +#: library/re.rst:617 msgid "" "Matches any character which is not a whitespace character. This is the " -"opposite of ``\\s``. If the :const:`ASCII` flag is used this becomes the " -"equivalent of ``[^ \\t\\n\\r\\f\\v]``." +"opposite of ``\\s``." msgstr "" -#: library/re.rst:607 +#: library/re.rst:620 +msgid "" +"Matches ``[^ \\t\\n\\r\\f\\v]`` if the :py:const:`~re.ASCII` flag is used." +msgstr "" + +#: library/re.rst:637 msgid "``\\w``" msgstr "" -#: library/re.rst:599 +#: library/re.rst:626 msgid "" -"Matches Unicode word characters; this includes alphanumeric characters (as " -"defined by :meth:`str.isalnum`) as well as the underscore (``_``). If the :" -"const:`ASCII` flag is used, only ``[a-zA-Z0-9_]`` is matched." +"Matches Unicode word characters; this includes all Unicode alphanumeric " +"characters (as defined by :py:meth:`str.isalnum`), as well as the underscore " +"(``_``)." msgstr "" -#: library/re.rst:604 +#: library/re.rst:631 +msgid "Matches ``[a-zA-Z0-9_]`` if the :py:const:`~re.ASCII` flag is used." +msgstr "" + +#: library/re.rst:634 msgid "" "Matches characters considered alphanumeric in the ASCII character set; this " -"is equivalent to ``[a-zA-Z0-9_]``. If the :const:`LOCALE` flag is used, " -"matches characters considered alphanumeric in the current locale and the " -"underscore." +"is equivalent to ``[a-zA-Z0-9_]``. If the :py:const:`~re.LOCALE` flag is " +"used, matches characters considered alphanumeric in the current locale and " +"the underscore." msgstr "" -#: library/re.rst:616 +#: library/re.rst:651 msgid "``\\W``" msgstr "" -#: library/re.rst:612 +#: library/re.rst:642 msgid "" "Matches any character which is not a word character. This is the opposite of " -"``\\w``. If the :const:`ASCII` flag is used this becomes the equivalent of " -"``[^a-zA-Z0-9_]``. If the :const:`LOCALE` flag is used, matches characters " -"which are neither alphanumeric in the current locale nor the underscore." +"``\\w``. By default, matches non-underscore (``_``) characters for which :py:" +"meth:`str.isalnum` returns ``False``." msgstr "" -#: library/re.rst:621 +#: library/re.rst:647 +msgid "Matches ``[^a-zA-Z0-9_]`` if the :py:const:`~re.ASCII` flag is used." +msgstr "" + +#: library/re.rst:649 +msgid "" +"If the :py:const:`~re.LOCALE` flag is used, matches characters which are " +"neither alphanumeric in the current locale nor the underscore." +msgstr "" + +#: library/re.rst:656 msgid "``\\Z``" msgstr "" -#: library/re.rst:621 +#: library/re.rst:656 msgid "Matches only at the end of the string." msgstr "" -#: library/re.rst:637 +#: library/re.rst:672 msgid "" "Most of the :ref:`escape sequences ` supported by Python " "string literals are also accepted by the regular expression parser::" msgstr "" -#: library/re.rst:644 +#: library/re.rst:679 msgid "" "(Note that ``\\b`` is used to represent word boundaries, and means " "\"backspace\" only inside character classes.)" msgstr "" -#: library/re.rst:647 +#: library/re.rst:682 msgid "" "``'\\u'``, ``'\\U'``, and ``'\\N'`` escape sequences are only recognized in " -"Unicode patterns. In bytes patterns they are errors. Unknown escapes of " -"ASCII letters are reserved for future use and treated as errors." +"Unicode (str) patterns. In bytes patterns they are errors. Unknown escapes " +"of ASCII letters are reserved for future use and treated as errors." msgstr "" -#: library/re.rst:651 +#: library/re.rst:688 msgid "" "Octal escapes are included in a limited form. If the first digit is a 0, or " "if there are three octal digits, it is considered an octal escape. " @@ -899,27 +962,27 @@ msgid "" "are always at most three digits in length." msgstr "" -#: library/re.rst:656 +#: library/re.rst:693 msgid "The ``'\\u'`` and ``'\\U'`` escape sequences have been added." msgstr "" -#: library/re.rst:659 +#: library/re.rst:696 msgid "" "Unknown escapes consisting of ``'\\'`` and an ASCII letter now are errors." msgstr "" -#: library/re.rst:662 +#: library/re.rst:699 msgid "" "The :samp:`'\\\\N\\\\{{name}\\\\}'` escape sequence has been added. As in " "string literals, it expands to the named Unicode character (e.g. ``'\\N{EM " "DASH}'``)." msgstr "" -#: library/re.rst:670 +#: library/re.rst:707 msgid "Module Contents" msgstr "" -#: library/re.rst:672 +#: library/re.rst:709 msgid "" "The module defines several functions, constants, and an exception. Some of " "the functions are simplified versions of the full featured methods for " @@ -927,93 +990,111 @@ msgid "" "compiled form." msgstr "" -#: library/re.rst:679 +#: library/re.rst:716 msgid "Flags" msgstr "" -#: library/re.rst:681 +#: library/re.rst:718 msgid "" "Flag constants are now instances of :class:`RegexFlag`, which is a subclass " "of :class:`enum.IntFlag`." msgstr "" -#: library/re.rst:688 +#: library/re.rst:725 msgid "" "An :class:`enum.IntFlag` class containing the regex options listed below." msgstr "" -#: library/re.rst:690 +#: library/re.rst:727 msgid "- added to ``__all__``" msgstr "" -#: library/re.rst:695 +#: library/re.rst:732 msgid "" "Make ``\\w``, ``\\W``, ``\\b``, ``\\B``, ``\\d``, ``\\D``, ``\\s`` and " "``\\S`` perform ASCII-only matching instead of full Unicode matching. This " -"is only meaningful for Unicode patterns, and is ignored for byte patterns. " -"Corresponds to the inline flag ``(?a)``." +"is only meaningful for Unicode (str) patterns, and is ignored for bytes " +"patterns." msgstr "" -#: library/re.rst:700 -msgid "" -"Note that for backward compatibility, the :const:`re.U` flag still exists " -"(as well as its synonym :const:`re.UNICODE` and its embedded counterpart ``(?" -"u)``), but these are redundant in Python 3 since matches are Unicode by " -"default for strings (and Unicode matching isn't allowed for bytes)." +#: library/re.rst:736 +msgid "Corresponds to the inline flag ``(?a)``." msgstr "" -#: library/re.rst:709 +#: library/re.rst:740 msgid "" -"Display debug information about compiled expression. No corresponding inline " -"flag." +"The :py:const:`~re.U` flag still exists for backward compatibility, but is " +"redundant in Python 3 since matches are Unicode by default for ``str`` " +"patterns, and Unicode matching isn't allowed for bytes patterns. :py:const:" +"`~re.UNICODE` and the inline flag ``(?u)`` are similarly redundant." msgstr "" -#: library/re.rst:716 +#: library/re.rst:749 +msgid "Display debug information about compiled expression." +msgstr "" + +#: library/re.rst:751 +msgid "No corresponding inline flag." +msgstr "" + +#: library/re.rst:757 msgid "" -"Perform case-insensitive matching; expressions like ``[A-Z]`` will also " -"match lowercase letters. Full Unicode matching (such as ``Ü`` matching " -"``ü``) also works unless the :const:`re.ASCII` flag is used to disable non-" -"ASCII matches. The current locale does not change the effect of this flag " -"unless the :const:`re.LOCALE` flag is also used. Corresponds to the inline " -"flag ``(?i)``." +"Perform case-insensitive matching; expressions like ``[A-Z]`` will also " +"match lowercase letters. Full Unicode matching (such as ``Ü`` matching " +"``ü``) also works unless the :py:const:`~re.ASCII` flag is used to disable " +"non-ASCII matches. The current locale does not change the effect of this " +"flag unless the :py:const:`~re.LOCALE` flag is also used." msgstr "" -#: library/re.rst:723 +#: library/re.rst:765 +msgid "Corresponds to the inline flag ``(?i)``." +msgstr "" + +#: library/re.rst:767 msgid "" "Note that when the Unicode patterns ``[a-z]`` or ``[A-Z]`` are used in " "combination with the :const:`IGNORECASE` flag, they will match the 52 ASCII " "letters and 4 additional non-ASCII letters: 'İ' (U+0130, Latin capital " "letter I with dot above), 'ı' (U+0131, Latin small letter dotless i), " "'ſ' (U+017F, Latin small letter long s) and 'K' (U+212A, Kelvin sign). If " -"the :const:`ASCII` flag is used, only letters 'a' to 'z' and 'A' to 'Z' are " -"matched." +"the :py:const:`~re.ASCII` flag is used, only letters 'a' to 'z' and 'A' to " +"'Z' are matched." msgstr "" -#: library/re.rst:734 +#: library/re.rst:778 msgid "" "Make ``\\w``, ``\\W``, ``\\b``, ``\\B`` and case-insensitive matching " -"dependent on the current locale. This flag can be used only with bytes " -"patterns. The use of this flag is discouraged as the locale mechanism is " -"very unreliable, it only handles one \"culture\" at a time, and it only " -"works with 8-bit locales. Unicode matching is already enabled by default in " -"Python 3 for Unicode (str) patterns, and it is able to handle different " -"locales/languages. Corresponds to the inline flag ``(?L)``." +"dependent on the current locale. This flag can be used only with bytes " +"patterns." msgstr "" -#: library/re.rst:743 +#: library/re.rst:782 +msgid "Corresponds to the inline flag ``(?L)``." +msgstr "" + +#: library/re.rst:786 +msgid "" +"This flag is discouraged; consider Unicode matching instead. The locale " +"mechanism is very unreliable as it only handles one \"culture\" at a time " +"and only works with 8-bit locales. Unicode matching is enabled by default " +"for Unicode (str) patterns and it is able to handle different locales and " +"languages." +msgstr "" + +#: library/re.rst:793 msgid "" -":const:`re.LOCALE` can be used only with bytes patterns and is not " -"compatible with :const:`re.ASCII`." +":py:const:`~re.LOCALE` can be used only with bytes patterns and is not " +"compatible with :py:const:`~re.ASCII`." msgstr "" -#: library/re.rst:747 +#: library/re.rst:797 msgid "" -"Compiled regular expression objects with the :const:`re.LOCALE` flag no " -"longer depend on the locale at compile time. Only the locale at matching " +"Compiled regular expression objects with the :py:const:`~re.LOCALE` flag no " +"longer depend on the locale at compile time. Only the locale at matching " "time affects the result of matching." msgstr "" -#: library/re.rst:756 +#: library/re.rst:806 msgid "" "When specified, the pattern character ``'^'`` matches at the beginning of " "the string and at the beginning of each line (immediately following each " @@ -1021,10 +1102,14 @@ msgid "" "and at the end of each line (immediately preceding each newline). By " "default, ``'^'`` matches only at the beginning of the string, and ``'$'`` " "only at the end of the string and immediately before the newline (if any) at " -"the end of the string. Corresponds to the inline flag ``(?m)``." +"the end of the string." msgstr "" -#: library/re.rst:766 +#: library/re.rst:813 +msgid "Corresponds to the inline flag ``(?m)``." +msgstr "" + +#: library/re.rst:817 msgid "" "Indicates no flag being applied, the value is ``0``. This flag may be used " "as a default value for a function keyword argument or as a base value that " @@ -1032,29 +1117,29 @@ msgid "" "value::" msgstr "" -#: library/re.rst:779 +#: library/re.rst:830 msgid "" "Make the ``'.'`` special character match any character at all, including a " -"newline; without this flag, ``'.'`` will match anything *except* a newline. " -"Corresponds to the inline flag ``(?s)``." +"newline; without this flag, ``'.'`` will match anything *except* a newline." msgstr "" -#: library/re.rst:787 -msgid "" -"In Python 2, this flag made :ref:`special sequences ` " -"include Unicode characters in matches. Since Python 3, Unicode characters " -"are matched by default." +#: library/re.rst:833 +msgid "Corresponds to the inline flag ``(?s)``." msgstr "" -#: library/re.rst:791 -msgid "See :const:`A` for restricting matching on ASCII characters instead." +#: library/re.rst:839 +msgid "" +"In Python 3, Unicode characters are matched by default for ``str`` patterns. " +"This flag is therefore redundant with **no effect** and is only kept for " +"backward compatibility." msgstr "" -#: library/re.rst:793 -msgid "This flag is only kept for backward compatibility." +#: library/re.rst:844 +msgid "" +"See :py:const:`~re.ASCII` to restrict matching to ASCII characters instead." msgstr "" -#: library/re.rst:800 +#: library/re.rst:851 msgid "" "This flag allows you to write regular expressions that look nicer and are " "more readable by allowing you to visually separate logical sections of the " @@ -1067,50 +1152,50 @@ msgid "" "ignored." msgstr "" -#: library/re.rst:810 +#: library/re.rst:861 msgid "" "This means that the two following regular expression objects that match a " "decimal number are functionally equal::" msgstr "" -#: library/re.rst:818 +#: library/re.rst:869 msgid "Corresponds to the inline flag ``(?x)``." msgstr "" -#: library/re.rst:822 +#: library/re.rst:873 msgid "Functions" msgstr "" -#: library/re.rst:826 +#: library/re.rst:877 msgid "" "Compile a regular expression pattern into a :ref:`regular expression object " "`, which can be used for matching using its :func:`~Pattern." "match`, :func:`~Pattern.search` and other methods, described below." msgstr "" -#: library/re.rst:831 +#: library/re.rst:882 msgid "" "The expression's behaviour can be modified by specifying a *flags* value. " -"Values can be any of the following variables, combined using bitwise OR (the " +"Values can be any of the `flags`_ variables, combined using bitwise OR (the " "``|`` operator)." msgstr "" -#: library/re.rst:835 +#: library/re.rst:886 msgid "The sequence ::" msgstr "" -#: library/re.rst:840 +#: library/re.rst:891 msgid "is equivalent to ::" msgstr "" -#: library/re.rst:844 +#: library/re.rst:895 msgid "" "but using :func:`re.compile` and saving the resulting regular expression " "object for reuse is more efficient when the expression will be used several " "times in a single program." msgstr "" -#: library/re.rst:850 +#: library/re.rst:901 msgid "" "The compiled versions of the most recent patterns passed to :func:`re." "compile` and the module-level matching functions are cached, so programs " @@ -1118,7 +1203,7 @@ msgid "" "compiling regular expressions." msgstr "" -#: library/re.rst:858 +#: library/re.rst:909 msgid "" "Scan through *string* looking for the first location where the regular " "expression *pattern* produces a match, and return a corresponding :class:" @@ -1127,7 +1212,7 @@ msgid "" "some point in the string." msgstr "" -#: library/re.rst:866 +#: library/re.rst:917 msgid "" "If zero or more characters at the beginning of *string* match the regular " "expression *pattern*, return a corresponding :class:`~re.Match`. Return " @@ -1135,26 +1220,26 @@ msgid "" "different from a zero-length match." msgstr "" -#: library/re.rst:871 +#: library/re.rst:922 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:874 +#: library/re.rst:925 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:880 +#: library/re.rst:931 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:889 +#: library/re.rst:940 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 " @@ -1163,42 +1248,42 @@ msgid "" "final element of the list. ::" msgstr "" -#: library/re.rst:904 +#: library/re.rst:955 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:911 +#: library/re.rst:962 msgid "" "That way, separator components are always found at the same relative indices " "within the result list." msgstr "" -#: library/re.rst:914 +#: library/re.rst:965 msgid "" "Empty matches for the pattern split the string only when not adjacent to a " "previous empty match." msgstr "" -#: library/re.rst:1015 library/re.rst:1044 +#: library/re.rst:1068 library/re.rst:1097 msgid "Added the optional flags argument." msgstr "" -#: library/re.rst:927 +#: library/re.rst:980 msgid "" "Added support of splitting on a pattern that could match an empty string." msgstr "" -#: library/re.rst:933 +#: library/re.rst:986 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:937 +#: library/re.rst:990 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. " @@ -1208,11 +1293,11 @@ msgid "" "result." msgstr "" -#: library/re.rst:960 +#: library/re.rst:1013 msgid "Non-empty matches can now start just after a previous empty match." msgstr "" -#: library/re.rst:955 +#: library/re.rst:1008 msgid "" "Return an :term:`iterator` yielding :class:`~re.Match` objects over all non-" "overlapping matches for the RE *pattern* in *string*. The *string* is " @@ -1220,7 +1305,7 @@ msgid "" "matches are included in the result." msgstr "" -#: library/re.rst:966 +#: library/re.rst:1019 msgid "" "Return the string obtained by replacing the leftmost non-overlapping " "occurrences of *pattern* in *string* by the replacement *repl*. If the " @@ -1234,18 +1319,18 @@ msgid "" "For example::" msgstr "" -#: library/re.rst:982 +#: library/re.rst:1035 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:995 +#: library/re.rst:1048 msgid "The pattern may be a string or a :class:`~re.Pattern`." msgstr "" -#: library/re.rst:997 +#: library/re.rst:1050 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, " @@ -1254,7 +1339,7 @@ msgid "" "'abxd')`` returns ``'-a-b--d-'``." msgstr "" -#: library/re.rst:1005 +#: library/re.rst:1058 msgid "" "In string-type *repl* arguments, in addition to the character escapes and " "backreferences described above, ``\\g`` will use the substring matched " @@ -1267,59 +1352,59 @@ msgid "" "RE." msgstr "" -#: library/re.rst:1047 library/re.rst:1290 +#: library/re.rst:1100 library/re.rst:1344 msgid "Unmatched groups are replaced with an empty string." msgstr "" -#: library/re.rst:1021 +#: library/re.rst:1074 msgid "" "Unknown escapes in *pattern* consisting of ``'\\'`` and an ASCII letter now " "are errors." msgstr "" -#: library/re.rst:1025 +#: library/re.rst:1078 msgid "" "Unknown escapes in *repl* consisting of ``'\\'`` and an ASCII letter now are " "errors." msgstr "" -#: library/re.rst:1029 +#: library/re.rst:1082 msgid "" "Empty matches for the pattern are replaced when adjacent to a previous non-" "empty match." msgstr "" -#: library/re.rst:1033 +#: library/re.rst:1086 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:1041 +#: library/re.rst:1094 msgid "" "Perform the same operation as :func:`sub`, but return a tuple ``(new_string, " "number_of_subs_made)``." msgstr "" -#: library/re.rst:1053 +#: library/re.rst:1106 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:1068 +#: library/re.rst:1121 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:1076 +#: library/re.rst:1129 msgid "The ``'_'`` character is no longer escaped." msgstr "" -#: library/re.rst:1079 +#: library/re.rst:1132 msgid "" "Only characters that can have special meaning in a regular expression are " "escaped. As a result, ``'!'``, ``'\"'``, ``'%'``, ``\"'\"``, ``','``, " @@ -1327,15 +1412,15 @@ msgid "" "are no longer escaped." msgstr "" -#: library/re.rst:1088 +#: library/re.rst:1141 msgid "Clear the regular expression cache." msgstr "" -#: library/re.rst:1092 +#: library/re.rst:1145 msgid "Exceptions" msgstr "" -#: library/re.rst:1096 +#: library/re.rst:1149 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 " @@ -1344,45 +1429,45 @@ msgid "" "pattern. The error instance has the following additional attributes:" msgstr "" -#: library/re.rst:1104 +#: library/re.rst:1157 msgid "The unformatted error message." msgstr "" -#: library/re.rst:1108 +#: library/re.rst:1161 msgid "The regular expression pattern." msgstr "" -#: library/re.rst:1112 +#: library/re.rst:1165 msgid "The index in *pattern* where compilation failed (may be ``None``)." msgstr "" -#: library/re.rst:1116 +#: library/re.rst:1169 msgid "The line corresponding to *pos* (may be ``None``)." msgstr "" -#: library/re.rst:1120 +#: library/re.rst:1173 msgid "The column corresponding to *pos* (may be ``None``)." msgstr "" -#: library/re.rst:1122 +#: library/re.rst:1175 msgid "Added additional attributes." msgstr "" -#: library/re.rst:1128 +#: library/re.rst:1181 msgid "Regular Expression Objects" msgstr "" -#: library/re.rst:1132 +#: library/re.rst:1185 msgid "Compiled regular expression object returned by :func:`re.compile`." msgstr "" -#: library/re.rst:1134 +#: library/re.rst:1187 msgid "" ":py:class:`re.Pattern` supports ``[]`` to indicate a Unicode (str) or bytes " "pattern. See :ref:`types-genericalias`." msgstr "" -#: library/re.rst:1140 +#: library/re.rst:1193 msgid "" "Scan through *string* looking for the first location where this regular " "expression produces a match, and return a corresponding :class:`~re.Match`. " @@ -1391,7 +1476,7 @@ msgid "" "string." msgstr "" -#: library/re.rst:1145 +#: library/re.rst:1198 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 " @@ -1400,7 +1485,7 @@ msgid "" "necessarily at the index where the search is to start." msgstr "" -#: library/re.rst:1151 +#: library/re.rst:1204 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 " @@ -1410,7 +1495,7 @@ msgid "" "equivalent to ``rx.search(string[:50], 0)``. ::" msgstr "" -#: library/re.rst:1166 +#: library/re.rst:1219 msgid "" "If zero or more characters at the *beginning* of *string* match this regular " "expression, return a corresponding :class:`~re.Match`. Return ``None`` if " @@ -1418,110 +1503,111 @@ msgid "" "zero-length match." msgstr "" -#: library/re.rst:1189 +#: library/re.rst:1242 msgid "" "The optional *pos* and *endpos* parameters have the same meaning as for the :" "meth:`~Pattern.search` method. ::" msgstr "" -#: library/re.rst:1179 +#: library/re.rst:1232 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:1185 +#: library/re.rst:1238 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:1203 +#: library/re.rst:1256 msgid "Identical to the :func:`split` function, using the compiled pattern." msgstr "" -#: library/re.rst:1208 +#: library/re.rst:1261 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:1215 +#: library/re.rst:1268 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:1222 +#: library/re.rst:1275 msgid "Identical to the :func:`sub` function, using the compiled pattern." msgstr "" -#: library/re.rst:1227 +#: library/re.rst:1280 msgid "Identical to the :func:`subn` function, using the compiled pattern." msgstr "" -#: library/re.rst:1232 +#: library/re.rst:1285 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 :data:`UNICODE` if the pattern is a Unicode string." +"such as :py:const:`~re.UNICODE` if the pattern is a Unicode string." msgstr "" -#: library/re.rst:1239 +#: library/re.rst:1292 msgid "The number of capturing groups in the pattern." msgstr "" -#: library/re.rst:1244 +#: library/re.rst:1297 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:1251 +#: library/re.rst:1304 msgid "The pattern string from which the pattern object was compiled." msgstr "" -#: library/re.rst:1254 +#: library/re.rst:1307 msgid "" "Added support of :func:`copy.copy` and :func:`copy.deepcopy`. Compiled " "regular expression objects are considered atomic." msgstr "" -#: library/re.rst:1262 +#: library/re.rst:1315 msgid "Match Objects" msgstr "" -#: library/re.rst:1264 +#: library/re.rst:1317 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:1275 +#: library/re.rst:1328 msgid "Match object returned by successful ``match``\\ es and ``search``\\ es." msgstr "" -#: library/re.rst:1277 +#: library/re.rst:1330 msgid "" ":py:class:`re.Match` supports ``[]`` to indicate a Unicode (str) or bytes " "match. See :ref:`types-genericalias`." msgstr "" -#: library/re.rst:1283 +#: library/re.rst:1336 msgid "" "Return the string obtained by doing backslash substitution on the template " "string *template*, as done by the :meth:`~Pattern.sub` method. Escapes such " "as ``\\n`` are converted to the appropriate characters, and numeric " "backreferences (``\\1``, ``\\2``) and named backreferences (``\\g<1>``, " -"``\\g``) are replaced by the contents of the corresponding group." +"``\\g``) are replaced by the contents of the corresponding group. The " +"backreference ``\\g<0>`` will be replaced by the entire match." msgstr "" -#: library/re.rst:1295 +#: library/re.rst:1349 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 " @@ -1536,7 +1622,7 @@ msgid "" "the pattern that matched multiple times, the last match is returned. ::" msgstr "" -#: library/re.rst:1317 +#: library/re.rst:1371 msgid "" "If the regular expression uses the ``(?P...)`` syntax, the *groupN* " "arguments may also be strings identifying groups by their group name. If a " @@ -1544,54 +1630,54 @@ msgid "" "`IndexError` exception is raised." msgstr "" -#: library/re.rst:1322 +#: library/re.rst:1376 msgid "A moderately complicated example::" msgstr "" -#: library/re.rst:1330 +#: library/re.rst:1384 msgid "Named groups can also be referred to by their index::" msgstr "" -#: library/re.rst:1337 +#: library/re.rst:1391 msgid "If a group matches multiple times, only the last match is accessible::" msgstr "" -#: library/re.rst:1346 +#: library/re.rst:1400 msgid "" "This is identical to ``m.group(g)``. This allows easier access to an " "individual group from a match::" msgstr "" -#: library/re.rst:1357 +#: library/re.rst:1411 msgid "Named groups are supported as well::" msgstr "" -#: library/re.rst:1370 +#: library/re.rst:1424 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:1599 +#: library/re.rst:1653 msgid "For example::" msgstr "" -#: library/re.rst:1380 +#: library/re.rst:1434 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:1393 +#: library/re.rst:1447 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:1405 +#: library/re.rst:1459 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 " @@ -1600,7 +1686,7 @@ msgid "" "matched by group *g* (equivalent to ``m.group(g)``) is ::" msgstr "" -#: library/re.rst:1413 +#: library/re.rst:1467 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." @@ -1608,32 +1694,32 @@ msgid "" "2, and ``m.start(2)`` raises an :exc:`IndexError` exception." msgstr "" -#: library/re.rst:1418 +#: library/re.rst:1472 msgid "An example that will remove *remove_this* from email addresses::" msgstr "" -#: library/re.rst:1428 +#: library/re.rst:1482 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:1435 +#: library/re.rst:1489 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:1442 +#: library/re.rst:1496 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:1449 +#: library/re.rst:1503 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)" @@ -1642,43 +1728,43 @@ msgid "" "applied to the same string." msgstr "" -#: library/re.rst:1458 +#: library/re.rst:1512 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:1464 +#: library/re.rst:1518 msgid "" "The :ref:`regular expression object ` whose :meth:`~Pattern." "match` or :meth:`~Pattern.search` method produced this match instance." msgstr "" -#: library/re.rst:1470 +#: library/re.rst:1524 msgid "The string passed to :meth:`~Pattern.match` or :meth:`~Pattern.search`." msgstr "" -#: library/re.rst:1473 +#: library/re.rst:1527 msgid "" "Added support of :func:`copy.copy` and :func:`copy.deepcopy`. Match objects " "are considered atomic." msgstr "" -#: library/re.rst:1481 +#: library/re.rst:1535 msgid "Regular Expression Examples" msgstr "" -#: library/re.rst:1485 +#: library/re.rst:1539 msgid "Checking for a Pair" msgstr "" -#: library/re.rst:1487 +#: library/re.rst:1541 msgid "" "In this example, we'll use the following helper function to display match " "objects a little more gracefully::" msgstr "" -#: library/re.rst:1495 +#: library/re.rst:1549 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 " @@ -1686,28 +1772,28 @@ msgid "" "\"2\" through \"9\" representing the card with that value." msgstr "" -#: library/re.rst:1500 +#: library/re.rst:1554 msgid "To see if a given string is a valid hand, one could do the following::" msgstr "" -#: library/re.rst:1510 +#: library/re.rst:1564 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:1520 +#: library/re.rst:1574 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:1539 +#: library/re.rst:1593 msgid "Simulating scanf()" msgstr "" -#: library/re.rst:1543 +#: library/re.rst:1597 msgid "" "Python does not currently have an equivalent to :c:func:`!scanf`. Regular " "expressions are generally more powerful, though also more verbose, than :c:" @@ -1716,124 +1802,124 @@ msgid "" "expressions." msgstr "" -#: library/re.rst:1550 +#: library/re.rst:1604 msgid ":c:func:`!scanf` Token" msgstr "" -#: library/re.rst:1550 +#: library/re.rst:1604 msgid "Regular Expression" msgstr "" -#: library/re.rst:1552 +#: library/re.rst:1606 msgid "``%c``" msgstr "" -#: library/re.rst:1554 +#: library/re.rst:1608 msgid "``%5c``" msgstr "" -#: library/re.rst:1554 +#: library/re.rst:1608 msgid "``.{5}``" msgstr "" -#: library/re.rst:1556 +#: library/re.rst:1610 msgid "``%d``" msgstr "" -#: library/re.rst:1556 +#: library/re.rst:1610 msgid "``[-+]?\\d+``" msgstr "" -#: library/re.rst:1558 +#: library/re.rst:1612 msgid "``%e``, ``%E``, ``%f``, ``%g``" msgstr "" -#: library/re.rst:1558 +#: library/re.rst:1612 msgid "``[-+]?(\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?``" msgstr "" -#: library/re.rst:1560 +#: library/re.rst:1614 msgid "``%i``" msgstr "" -#: library/re.rst:1560 +#: library/re.rst:1614 msgid "``[-+]?(0[xX][\\dA-Fa-f]+|0[0-7]*|\\d+)``" msgstr "" -#: library/re.rst:1562 +#: library/re.rst:1616 msgid "``%o``" msgstr "" -#: library/re.rst:1562 +#: library/re.rst:1616 msgid "``[-+]?[0-7]+``" msgstr "" -#: library/re.rst:1564 +#: library/re.rst:1618 msgid "``%s``" msgstr "" -#: library/re.rst:1564 +#: library/re.rst:1618 msgid "``\\S+``" msgstr "" -#: library/re.rst:1566 +#: library/re.rst:1620 msgid "``%u``" msgstr "" -#: library/re.rst:1566 +#: library/re.rst:1620 msgid "``\\d+``" msgstr "" -#: library/re.rst:1568 +#: library/re.rst:1622 msgid "``%x``, ``%X``" msgstr "" -#: library/re.rst:1568 +#: library/re.rst:1622 msgid "``[-+]?(0[xX])?[\\dA-Fa-f]+``" msgstr "" -#: library/re.rst:1571 +#: library/re.rst:1625 msgid "To extract the filename and numbers from a string like ::" msgstr "" -#: library/re.rst:1575 +#: library/re.rst:1629 msgid "you would use a :c:func:`!scanf` format like ::" msgstr "" -#: library/re.rst:1579 +#: library/re.rst:1633 msgid "The equivalent regular expression would be ::" msgstr "" -#: library/re.rst:1587 +#: library/re.rst:1641 msgid "search() vs. match()" msgstr "" -#: library/re.rst:1591 +#: library/re.rst:1645 msgid "" "Python offers different primitive operations based on regular expressions:" msgstr "" -#: library/re.rst:1593 +#: library/re.rst:1647 msgid ":func:`re.match` checks for a match only at the beginning of the string" msgstr "" -#: library/re.rst:1594 +#: library/re.rst:1648 msgid "" ":func:`re.search` checks for a match anywhere in the string (this is what " "Perl does by default)" msgstr "" -#: library/re.rst:1596 +#: library/re.rst:1650 msgid ":func:`re.fullmatch` checks for entire string to be a match" msgstr "" -#: library/re.rst:1608 +#: library/re.rst:1662 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:1616 +#: library/re.rst:1670 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 " @@ -1841,11 +1927,11 @@ msgid "" "line. ::" msgstr "" -#: library/re.rst:1626 +#: library/re.rst:1680 msgid "Making a Phonebook" msgstr "" -#: library/re.rst:1628 +#: library/re.rst:1682 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 " @@ -1853,37 +1939,37 @@ msgid "" "following example that creates a phonebook." msgstr "" -#: library/re.rst:1633 +#: library/re.rst:1687 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:1646 +#: library/re.rst:1700 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:1659 +#: library/re.rst:1713 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:1672 +#: library/re.rst:1726 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:1687 +#: library/re.rst:1741 msgid "Text Munging" msgstr "" -#: library/re.rst:1689 +#: library/re.rst:1743 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 " @@ -1891,11 +1977,11 @@ msgid "" "each word of a sentence except for the first and last characters::" msgstr "" -#: library/re.rst:1707 +#: library/re.rst:1761 msgid "Finding all Adverbs" msgstr "" -#: library/re.rst:1709 +#: library/re.rst:1763 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 " @@ -1903,11 +1989,11 @@ msgid "" "manner::" msgstr "" -#: library/re.rst:1720 +#: library/re.rst:1774 msgid "Finding all Adverbs and their Positions" msgstr "" -#: library/re.rst:1722 +#: library/re.rst:1776 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` " @@ -1916,11 +2002,11 @@ msgid "" "they would use :func:`finditer` in the following manner::" msgstr "" -#: library/re.rst:1736 +#: library/re.rst:1790 msgid "Raw String Notation" msgstr "" -#: library/re.rst:1738 +#: library/re.rst:1792 msgid "" "Raw string notation (``r\"text\"``) keeps regular expressions sane. Without " "it, every backslash (``'\\'``) in a regular expression would have to be " @@ -1928,7 +2014,7 @@ msgid "" "lines of code are functionally identical::" msgstr "" -#: library/re.rst:1748 +#: library/re.rst:1802 msgid "" "When one wants to match a literal backslash, it must be escaped in the " "regular expression. With raw string notation, this means ``r\"\\\\\"``. " @@ -1936,29 +2022,29 @@ msgid "" "following lines of code functionally identical::" msgstr "" -#: library/re.rst:1760 +#: library/re.rst:1814 msgid "Writing a Tokenizer" msgstr "" -#: library/re.rst:1762 +#: library/re.rst:1816 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:1766 +#: library/re.rst:1820 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:1822 +#: library/re.rst:1876 msgid "The tokenizer produces the following output::" msgstr "" -#: library/re.rst:1845 +#: library/re.rst:1899 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 " @@ -1971,14 +2057,14 @@ msgid ". (dot)" msgstr "" #: library/re.rst:112 library/re.rst:130 library/re.rst:143 library/re.rst:181 -#: library/re.rst:235 library/re.rst:257 library/re.rst:296 library/re.rst:319 -#: library/re.rst:394 library/re.rst:432 library/re.rst:444 library/re.rst:478 -#: library/re.rst:511 library/re.rst:528 library/re.rst:555 library/re.rst:574 -#: library/re.rst:595 library/re.rst:618 library/re.rst:798 library/re.rst:1003 +#: 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 msgid "in regular expressions" msgstr "" -#: library/re.rst:263 +#: library/re.rst:262 msgid "^ (caret)" msgstr "" @@ -2026,7 +2112,7 @@ msgstr "" msgid "{} (curly brackets)" msgstr "" -#: library/re.rst:257 library/re.rst:511 +#: library/re.rst:257 library/re.rst:522 msgid "\\ (backslash)" msgstr "" @@ -2038,146 +2124,146 @@ msgstr "" msgid "- (minus)" msgstr "" -#: library/re.rst:296 +#: library/re.rst:295 msgid "| (vertical bar)" msgstr "" -#: library/re.rst:309 +#: library/re.rst:308 msgid "() (parentheses)" msgstr "" -#: library/re.rst:319 +#: library/re.rst:318 msgid "(?" msgstr "" -#: library/re.rst:345 +#: library/re.rst:350 msgid "(?:" msgstr "" -#: library/re.rst:394 +#: library/re.rst:405 msgid "(?P<" msgstr "" -#: library/re.rst:426 +#: library/re.rst:437 msgid "(?P=" msgstr "" -#: library/re.rst:432 +#: library/re.rst:443 msgid "(?#" msgstr "" -#: library/re.rst:437 +#: library/re.rst:448 msgid "(?=" msgstr "" -#: library/re.rst:444 +#: library/re.rst:455 msgid "(?!" msgstr "" -#: library/re.rst:451 +#: library/re.rst:462 msgid "(?<=" msgstr "" -#: library/re.rst:478 +#: library/re.rst:489 msgid "(?\n" @@ -241,9 +241,9 @@ msgstr "" #: library/select.rst:187 msgid "" -"Solaris and derivatives have ``/dev/poll``. While :c:func:`!select` is " -"O(highest file descriptor) and :c:func:`!poll` is O(number of file " -"descriptors), ``/dev/poll`` is O(active file descriptors)." +"Solaris and derivatives have ``/dev/poll``. While :c:func:`!select` is *O*\\ " +"(*highest file descriptor*) and :c:func:`!poll` is *O*\\ (*number of file " +"descriptors*), ``/dev/poll`` is *O*\\ (*active file descriptors*)." msgstr "" #: library/select.rst:191 @@ -513,8 +513,8 @@ msgid "" "requires listing the file descriptors of interest, while :c:func:`!select` " "builds a bitmap, turns on bits for the fds of interest, and then afterward " "the whole bitmap has to be linearly scanned again. :c:func:`!select` is " -"O(highest file descriptor), while :c:func:`!poll` is O(number of file " -"descriptors)." +"*O*\\ (*highest file descriptor*), while :c:func:`!poll` is *O*\\ (*number " +"of file descriptors*)." msgstr "" #: library/select.rst:396 diff --git a/library/shutil.po b/library/shutil.po index fe4aaafdf..d6583c658 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: 2023-10-05 21:24+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -53,20 +53,21 @@ msgstr "" #: library/shutil.rst:42 msgid "" -"Copy the contents of the file-like object *fsrc* to the file-like object " -"*fdst*. The integer *length*, if given, is the buffer size. In particular, a " -"negative *length* value means to copy the data without looping over the " -"source data in chunks; by default the data is read in chunks to avoid " -"uncontrolled memory consumption. Note that if the current file position of " -"the *fsrc* object is not 0, only the contents from the current file position " -"to the end of the file will be copied." +"Copy the contents of the :term:`file-like object ` *fsrc* to " +"the file-like object *fdst*. The integer *length*, if given, is the buffer " +"size. In particular, a negative *length* value means to copy the data " +"without looping over the source data in chunks; by default the data is read " +"in chunks to avoid uncontrolled memory consumption. Note that if the current " +"file position of the *fsrc* object is not 0, only the contents from the " +"current file position to the end of the file will be copied." msgstr "" #: library/shutil.rst:53 msgid "" "Copy the contents (no metadata) of the file named *src* to a file named " "*dst* and return *dst* in the most efficient way possible. *src* and *dst* " -"are path-like objects or path names given as strings." +"are :term:`path-like objects ` or path names given as " +"strings." msgstr "" #: library/shutil.rst:57 @@ -108,7 +109,7 @@ msgid "" "subclass of the latter, this change is backward compatible." msgstr "" -#: library/shutil.rst:185 library/shutil.rst:287 library/shutil.rst:387 +#: library/shutil.rst:185 library/shutil.rst:287 library/shutil.rst:390 msgid "" "Platform-specific fast-copy syscalls may be used internally in order to copy " "the file more efficiently. See :ref:`shutil-platform-dependent-efficient-" @@ -124,13 +125,14 @@ msgstr "" #: library/shutil.rst:96 msgid "" "Copy the permission bits from *src* to *dst*. The file contents, owner, and " -"group are unaffected. *src* and *dst* are path-like objects or path names " -"given as strings. If *follow_symlinks* is false, and both *src* and *dst* " -"are symbolic links, :func:`copymode` will attempt to modify the mode of " -"*dst* itself (rather than the file it points to). This functionality is not " -"available on every platform; please see :func:`copystat` for more " -"information. If :func:`copymode` cannot modify symbolic links on the local " -"platform, and it is asked to do so, it will do nothing and return." +"group are unaffected. *src* and *dst* are :term:`path-like objects ` or path names given as strings. If *follow_symlinks* is false, " +"and both *src* and *dst* are symbolic links, :func:`copymode` will attempt " +"to modify the mode of *dst* itself (rather than the file it points to). " +"This functionality is not available on every platform; please see :func:" +"`copystat` for more information. If :func:`copymode` cannot modify symbolic " +"links on the local platform, and it is asked to do so, it will do nothing " +"and return." msgstr "" #: library/shutil.rst:179 @@ -148,8 +150,8 @@ msgid "" "Copy the permission bits, last access time, last modification time, and " "flags from *src* to *dst*. On Linux, :func:`copystat` also copies the " "\"extended attributes\" where possible. The file contents, owner, and group " -"are unaffected. *src* and *dst* are path-like objects or path names given " -"as strings." +"are unaffected. *src* and *dst* are :term:`path-like objects ` or path names given as strings." msgstr "" #: library/shutil.rst:119 @@ -346,18 +348,18 @@ msgid "" msgstr "" #: library/shutil.rst:277 -msgid "Copy metadata when *symlinks* is false. Now returns *dst*." -msgstr "" - -#: library/shutil.rst:281 msgid "" "Added the *copy_function* argument to be able to provide a custom copy " "function. Added the *ignore_dangling_symlinks* argument to silence dangling " "symlinks errors when *symlinks* is false." msgstr "" +#: library/shutil.rst:283 +msgid "Copy metadata when *symlinks* is false. Now returns *dst*." +msgstr "" + #: library/shutil.rst:292 -msgid "The *dirs_exist_ok* parameter." +msgid "Added the *dirs_exist_ok* parameter." msgstr "" #: library/shutil.rst:299 @@ -442,121 +444,127 @@ msgstr "" #: library/shutil.rst:357 msgid "" -"Recursively move a file or directory (*src*) to another location (*dst*) and " -"return the destination." +"Recursively move a file or directory (*src*) to another location and return " +"the destination." msgstr "" #: library/shutil.rst:360 msgid "" -"If the destination is an existing directory, then *src* is moved inside that " -"directory. If the destination already exists but is not a directory, it may " -"be overwritten depending on :func:`os.rename` semantics." +"If *dst* is an existing directory or a symlink to a directory, then *src* is " +"moved inside that directory. The destination path in that directory must not " +"already exist." msgstr "" #: library/shutil.rst:364 msgid "" +"If *dst* already exists but is not a directory, it may be overwritten " +"depending on :func:`os.rename` semantics." +msgstr "" + +#: library/shutil.rst:367 +msgid "" "If the destination is on the current filesystem, then :func:`os.rename` is " -"used. Otherwise, *src* is copied to *dst* using *copy_function* and then " -"removed. In case of symlinks, a new symlink pointing to the target of *src* " -"will be created in or as *dst* and *src* will be removed." +"used. Otherwise, *src* is copied to the destination using *copy_function* " +"and then removed. In case of symlinks, a new symlink pointing to the target " +"of *src* will be created as the destination and *src* will be removed." msgstr "" -#: library/shutil.rst:369 +#: library/shutil.rst:372 msgid "" -"If *copy_function* is given, it must be a callable that takes two arguments " -"*src* and *dst*, and will be used to copy *src* to *dst* if :func:`os." -"rename` cannot be used. If the source is a directory, :func:`copytree` is " -"called, passing it the *copy_function*. The default *copy_function* is :func:" -"`copy2`. Using :func:`~shutil.copy` as the *copy_function* allows the move " -"to succeed when it is not possible to also copy the metadata, at the expense " -"of not copying any of the metadata." +"If *copy_function* is given, it must be a callable that takes two arguments, " +"*src* and the destination, and will be used to copy *src* to the destination " +"if :func:`os.rename` cannot be used. If the source is a directory, :func:" +"`copytree` is called, passing it the *copy_function*. The default " +"*copy_function* is :func:`copy2`. Using :func:`~shutil.copy` as the " +"*copy_function* allows the move to succeed when it is not possible to also " +"copy the metadata, at the expense of not copying any of the metadata." msgstr "" -#: library/shutil.rst:377 +#: library/shutil.rst:380 msgid "" "Raises an :ref:`auditing event ` ``shutil.move`` with arguments " "``src``, ``dst``." msgstr "" -#: library/shutil.rst:379 +#: library/shutil.rst:382 msgid "" "Added explicit symlink handling for foreign filesystems, thus adapting it to " "the behavior of GNU's :program:`mv`. Now returns *dst*." msgstr "" -#: library/shutil.rst:384 +#: library/shutil.rst:387 msgid "Added the *copy_function* keyword argument." msgstr "" -#: library/shutil.rst:392 +#: library/shutil.rst:395 msgid "Accepts a :term:`path-like object` for both *src* and *dst*." msgstr "" -#: library/shutil.rst:397 +#: library/shutil.rst:400 msgid "" "Return disk usage statistics about the given path as a :term:`named tuple` " "with the attributes *total*, *used* and *free*, which are the amount of " "total, used and free space, in bytes. *path* may be a file or a directory." msgstr "" -#: library/shutil.rst:404 +#: library/shutil.rst:407 msgid "" "On Unix filesystems, *path* must point to a path within a **mounted** " "filesystem partition. On those platforms, CPython doesn't attempt to " "retrieve disk usage information from non-mounted filesystems." msgstr "" -#: library/shutil.rst:410 +#: library/shutil.rst:413 msgid "On Windows, *path* can now be a file or directory." msgstr "" -#: library/shutil.rst:413 +#: library/shutil.rst:416 msgid ":ref:`Availability `: Unix, Windows." msgstr "" -#: library/shutil.rst:417 +#: library/shutil.rst:420 msgid "Change owner *user* and/or *group* of the given *path*." msgstr "" -#: library/shutil.rst:419 +#: library/shutil.rst:422 msgid "" "*user* can be a system user name or a uid; the same applies to *group*. At " "least one argument is required." msgstr "" -#: library/shutil.rst:422 +#: library/shutil.rst:425 msgid "See also :func:`os.chown`, the underlying function." msgstr "" -#: library/shutil.rst:424 +#: library/shutil.rst:427 msgid "" "Raises an :ref:`auditing event ` ``shutil.chown`` with arguments " "``path``, ``user``, ``group``." msgstr "" -#: library/shutil.rst:426 +#: library/shutil.rst:429 msgid ":ref:`Availability `: Unix." msgstr "" -#: library/shutil.rst:433 +#: library/shutil.rst:436 msgid "" "Return the path to an executable which would be run if the given *cmd* was " "called. If no *cmd* would be called, return ``None``." msgstr "" -#: library/shutil.rst:436 +#: library/shutil.rst:439 msgid "" "*mode* is a permission mask passed to :func:`os.access`, by default " "determining if the file exists and executable." msgstr "" -#: library/shutil.rst:439 +#: library/shutil.rst:442 msgid "" "When no *path* is specified, the results of :func:`os.environ` are used, " "returning either the \"PATH\" value or a fallback of :data:`os.defpath`." msgstr "" -#: library/shutil.rst:442 +#: library/shutil.rst:445 msgid "" "On Windows, the current directory is prepended to the *path* if *mode* does " "not include ``os.X_OK``. When the *mode* does include ``os.X_OK``, the " @@ -566,7 +574,7 @@ msgid "" "environment variable ``NoDefaultCurrentDirectoryInExePath``." msgstr "" -#: library/shutil.rst:449 +#: library/shutil.rst:452 msgid "" "Also on Windows, the ``PATHEXT`` variable is used to resolve commands that " "may not already include an extension. For example, if you call ``shutil." @@ -575,19 +583,19 @@ msgid "" "on Windows::" msgstr "" -#: library/shutil.rst:458 +#: library/shutil.rst:461 msgid "" "This is also applied when *cmd* is a path that contains a directory " "component::" msgstr "" -#: library/shutil.rst:466 +#: library/shutil.rst:469 msgid "" "The :class:`bytes` type is now accepted. If *cmd* type is :class:`bytes`, " "the result type is also :class:`bytes`." msgstr "" -#: library/shutil.rst:470 +#: library/shutil.rst:473 msgid "" "On Windows, the current directory is no longer prepended to the search path " "if *mode* includes ``os.X_OK`` and WinAPI " @@ -598,25 +606,25 @@ msgid "" "now be found." msgstr "" -#: library/shutil.rst:479 +#: library/shutil.rst:482 msgid "" "On Windows, if *mode* includes ``os.X_OK``, executables with an extension in " "``PATHEXT`` will be preferred over executables without a matching extension. " "This brings behavior closer to that of Python 3.11." msgstr "" -#: library/shutil.rst:487 +#: library/shutil.rst:490 msgid "" "This exception collects exceptions that are raised during a multi-file " "operation. For :func:`copytree`, the exception argument is a list of 3-" "tuples (*srcname*, *dstname*, *exception*)." msgstr "" -#: library/shutil.rst:494 +#: library/shutil.rst:497 msgid "Platform-dependent efficient copy operations" msgstr "" -#: library/shutil.rst:496 +#: library/shutil.rst:499 msgid "" "Starting from Python 3.8, all functions involving a file copy (:func:" "`copyfile`, :func:`~shutil.copy`, :func:`copy2`, :func:`copytree`, and :func:" @@ -626,51 +634,51 @@ msgid "" "buffers in Python as in \"``outfd.write(infd.read())``\"." msgstr "" -#: library/shutil.rst:504 +#: library/shutil.rst:507 msgid "On macOS `fcopyfile`_ is used to copy the file content (not metadata)." msgstr "" -#: library/shutil.rst:506 +#: library/shutil.rst:509 msgid "On Linux :func:`os.sendfile` is used." msgstr "" -#: library/shutil.rst:508 +#: library/shutil.rst:511 msgid "" "On Windows :func:`shutil.copyfile` uses a bigger default buffer size (1 MiB " "instead of 64 KiB) and a :func:`memoryview`-based variant of :func:`shutil." "copyfileobj` is used." msgstr "" -#: library/shutil.rst:512 +#: library/shutil.rst:515 msgid "" "If the fast-copy operation fails and no data was written in the destination " "file then shutil will silently fallback on using less efficient :func:" "`copyfileobj` function internally." msgstr "" -#: library/shutil.rst:521 +#: library/shutil.rst:524 msgid "copytree example" msgstr "" -#: library/shutil.rst:523 +#: library/shutil.rst:526 msgid "An example that uses the :func:`ignore_patterns` helper::" msgstr "" -#: library/shutil.rst:529 +#: library/shutil.rst:532 msgid "" "This will copy everything except ``.pyc`` files and files or directories " "whose name starts with ``tmp``." msgstr "" -#: library/shutil.rst:532 +#: library/shutil.rst:535 msgid "Another example that uses the *ignore* argument to add a logging call::" msgstr "" -#: library/shutil.rst:547 +#: library/shutil.rst:550 msgid "rmtree example" msgstr "" -#: library/shutil.rst:549 +#: library/shutil.rst:552 msgid "" "This example shows how to remove a directory tree on Windows where some of " "the files have their read-only bit set. It uses the onexc callback to clear " @@ -678,41 +686,46 @@ msgid "" "propagate. ::" msgstr "" -#: library/shutil.rst:567 +#: library/shutil.rst:570 msgid "Archiving operations" msgstr "" -#: library/shutil.rst:571 +#: library/shutil.rst:574 msgid "Added support for the *xztar* format." msgstr "" -#: library/shutil.rst:575 +#: library/shutil.rst:578 msgid "" "High-level utilities to create and read compressed and archived files are " "also provided. They rely on the :mod:`zipfile` and :mod:`tarfile` modules." msgstr "" -#: library/shutil.rst:580 +#: library/shutil.rst:583 msgid "Create an archive file (such as zip or tar) and return its name." msgstr "" -#: library/shutil.rst:582 +#: library/shutil.rst:585 msgid "" "*base_name* is the name of the file to create, including the path, minus any " -"format-specific extension. *format* is the archive format: one of " -"\"zip\" (if the :mod:`zlib` module is available), \"tar\", \"gztar\" (if " -"the :mod:`zlib` module is available), \"bztar\" (if the :mod:`bz2` module is " -"available), or \"xztar\" (if the :mod:`lzma` module is available)." +"format-specific extension." msgstr "" #: library/shutil.rst:588 msgid "" +"*format* is the archive format: one of \"zip\" (if the :mod:`zlib` module is " +"available), \"tar\", \"gztar\" (if the :mod:`zlib` module is available), " +"\"bztar\" (if the :mod:`bz2` module is available), or \"xztar\" (if the :mod:" +"`lzma` module is available)." +msgstr "" + +#: library/shutil.rst:593 +msgid "" "*root_dir* is a directory that will be the root directory of the archive, " "all paths in the archive will be relative to it; for example, we typically " "chdir into *root_dir* before creating the archive." msgstr "" -#: library/shutil.rst:592 +#: library/shutil.rst:597 msgid "" "*base_dir* is the directory where we start archiving from; i.e. *base_dir* " "will be the common prefix of all files and directories in the archive. " @@ -720,39 +733,39 @@ msgid "" "example-with-basedir` for how to use *base_dir* and *root_dir* together." msgstr "" -#: library/shutil.rst:598 +#: library/shutil.rst:603 msgid "*root_dir* and *base_dir* both default to the current directory." msgstr "" -#: library/shutil.rst:600 +#: library/shutil.rst:605 msgid "" "If *dry_run* is true, no archive is created, but the operations that would " "be executed are logged to *logger*." msgstr "" -#: library/shutil.rst:603 +#: library/shutil.rst:608 msgid "" "*owner* and *group* are used when creating a tar archive. By default, uses " "the current owner and group." msgstr "" -#: library/shutil.rst:606 +#: library/shutil.rst:611 msgid "" "*logger* must be an object compatible with :pep:`282`, usually an instance " "of :class:`logging.Logger`." msgstr "" -#: library/shutil.rst:609 +#: library/shutil.rst:614 msgid "The *verbose* argument is unused and deprecated." msgstr "" -#: library/shutil.rst:611 +#: library/shutil.rst:616 msgid "" "Raises an :ref:`auditing event ` ``shutil.make_archive`` with " "arguments ``base_name``, ``format``, ``root_dir``, ``base_dir``." msgstr "" -#: library/shutil.rst:615 +#: library/shutil.rst:620 msgid "" "This function is not thread-safe when custom archivers registered with :func:" "`register_archive_format` do not support the *root_dir* argument. In this " @@ -760,60 +773,60 @@ msgid "" "*root_dir* to perform archiving." msgstr "" -#: library/shutil.rst:621 +#: library/shutil.rst:626 msgid "" "The modern pax (POSIX.1-2001) format is now used instead of the legacy GNU " "format for archives created with ``format=\"tar\"``." msgstr "" -#: library/shutil.rst:625 +#: library/shutil.rst:630 msgid "" "This function is now made thread-safe during creation of standard ``.zip`` " "and tar archives." msgstr "" -#: library/shutil.rst:631 +#: library/shutil.rst:636 msgid "" "Return a list of supported formats for archiving. Each element of the " "returned sequence is a tuple ``(name, description)``." msgstr "" -#: library/shutil.rst:745 +#: library/shutil.rst:750 msgid "By default :mod:`shutil` provides these formats:" msgstr "" -#: library/shutil.rst:636 +#: library/shutil.rst:641 msgid "*zip*: ZIP file (if the :mod:`zlib` module is available)." msgstr "" -#: library/shutil.rst:637 +#: library/shutil.rst:642 msgid "" "*tar*: Uncompressed tar file. Uses POSIX.1-2001 pax format for new archives." msgstr "" -#: library/shutil.rst:750 +#: library/shutil.rst:755 msgid "*gztar*: gzip'ed tar-file (if the :mod:`zlib` module is available)." msgstr "" -#: library/shutil.rst:751 +#: library/shutil.rst:756 msgid "*bztar*: bzip2'ed tar-file (if the :mod:`bz2` module is available)." msgstr "" -#: library/shutil.rst:752 +#: library/shutil.rst:757 msgid "*xztar*: xz'ed tar-file (if the :mod:`lzma` module is available)." msgstr "" -#: library/shutil.rst:642 +#: library/shutil.rst:647 msgid "" "You can register new formats or provide your own archiver for any existing " "formats, by using :func:`register_archive_format`." msgstr "" -#: library/shutil.rst:648 +#: library/shutil.rst:653 msgid "Register an archiver for the format *name*." msgstr "" -#: library/shutil.rst:650 +#: library/shutil.rst:655 msgid "" "*function* is the callable that will be used to unpack archives. The " "callable will receive the *base_name* of the file to create, followed by the " @@ -822,7 +835,7 @@ msgid "" "*dry_run* and *logger* (as passed in :func:`make_archive`)." msgstr "" -#: library/shutil.rst:656 +#: library/shutil.rst:661 msgid "" "If *function* has the custom attribute ``function.supports_root_dir`` set to " "``True``, the *root_dir* argument is passed as a keyword argument. Otherwise " @@ -831,37 +844,37 @@ msgid "" "not thread-safe." msgstr "" -#: library/shutil.rst:662 +#: library/shutil.rst:667 msgid "" "If given, *extra_args* is a sequence of ``(name, value)`` pairs that will be " "used as extra keywords arguments when the archiver callable is used." msgstr "" -#: library/shutil.rst:665 +#: library/shutil.rst:670 msgid "" "*description* is used by :func:`get_archive_formats` which returns the list " "of archivers. Defaults to an empty string." msgstr "" -#: library/shutil.rst:668 +#: library/shutil.rst:673 msgid "Added support for functions supporting the *root_dir* argument." msgstr "" -#: library/shutil.rst:674 +#: library/shutil.rst:679 msgid "Remove the archive format *name* from the list of supported formats." msgstr "" -#: library/shutil.rst:679 +#: library/shutil.rst:684 msgid "Unpack an archive. *filename* is the full path of the archive." msgstr "" -#: library/shutil.rst:681 +#: library/shutil.rst:686 msgid "" "*extract_dir* is the name of the target directory where the archive is " "unpacked. If not provided, the current working directory is used." msgstr "" -#: library/shutil.rst:684 +#: library/shutil.rst:689 msgid "" "*format* is the archive format: one of \"zip\", \"tar\", \"gztar\", " "\"bztar\", or \"xztar\". Or any other format registered with :func:" @@ -870,7 +883,7 @@ msgid "" "that extension. In case none is found, a :exc:`ValueError` is raised." msgstr "" -#: library/shutil.rst:691 +#: library/shutil.rst:696 msgid "" "The keyword-only *filter* argument is passed to the underlying unpacking " "function. For zip files, *filter* is not accepted. For tar files, it is " @@ -880,13 +893,13 @@ msgid "" "Python 3.14." msgstr "" -#: library/shutil.rst:699 +#: library/shutil.rst:704 msgid "" "Raises an :ref:`auditing event ` ``shutil.unpack_archive`` with " "arguments ``filename``, ``extract_dir``, ``format``." msgstr "" -#: library/shutil.rst:703 +#: library/shutil.rst:708 msgid "" "Never extract archives from untrusted sources without prior inspection. It " "is possible that files are created outside of the path specified in the " @@ -894,138 +907,138 @@ msgid "" "with \"/\" or filenames with two dots \"..\"." msgstr "" -#: library/shutil.rst:708 +#: library/shutil.rst:713 msgid "Accepts a :term:`path-like object` for *filename* and *extract_dir*." msgstr "" -#: library/shutil.rst:711 +#: library/shutil.rst:716 msgid "Added the *filter* argument." msgstr "" -#: library/shutil.rst:716 +#: library/shutil.rst:721 msgid "" "Registers an unpack format. *name* is the name of the format and " "*extensions* is a list of extensions corresponding to the format, like ``." "zip`` for Zip files." msgstr "" -#: library/shutil.rst:720 +#: library/shutil.rst:725 msgid "" "*function* is the callable that will be used to unpack archives. The " "callable will receive:" msgstr "" -#: library/shutil.rst:723 +#: library/shutil.rst:728 msgid "the path of the archive, as a positional argument;" msgstr "" -#: library/shutil.rst:724 +#: library/shutil.rst:729 msgid "" "the directory the archive must be extracted to, as a positional argument;" msgstr "" -#: library/shutil.rst:725 +#: library/shutil.rst:730 msgid "" "possibly a *filter* keyword argument, if it was given to :func:" "`unpack_archive`;" msgstr "" -#: library/shutil.rst:727 +#: library/shutil.rst:732 msgid "" "additional keyword arguments, specified by *extra_args* as a sequence of " "``(name, value)`` tuples." msgstr "" -#: library/shutil.rst:730 +#: library/shutil.rst:735 msgid "" "*description* can be provided to describe the format, and will be returned " "by the :func:`get_unpack_formats` function." msgstr "" -#: library/shutil.rst:736 +#: library/shutil.rst:741 msgid "Unregister an unpack format. *name* is the name of the format." msgstr "" -#: library/shutil.rst:741 +#: library/shutil.rst:746 msgid "" "Return a list of all registered formats for unpacking. Each element of the " "returned sequence is a tuple ``(name, extensions, description)``." msgstr "" -#: library/shutil.rst:747 +#: library/shutil.rst:752 msgid "" "*zip*: ZIP file (unpacking compressed files works only if the corresponding " "module is available)." msgstr "" -#: library/shutil.rst:749 +#: library/shutil.rst:754 msgid "*tar*: uncompressed tar file." msgstr "" -#: library/shutil.rst:754 +#: library/shutil.rst:759 msgid "" "You can register new formats or provide your own unpacker for any existing " "formats, by using :func:`register_unpack_format`." msgstr "" -#: library/shutil.rst:761 +#: library/shutil.rst:766 msgid "Archiving example" msgstr "" -#: library/shutil.rst:763 +#: library/shutil.rst:768 msgid "" "In this example, we create a gzip'ed tar-file archive containing all files " "found in the :file:`.ssh` directory of the user::" msgstr "" -#: library/shutil.rst:773 +#: library/shutil.rst:778 msgid "The resulting archive contains:" msgstr "" -#: library/shutil.rst:791 +#: library/shutil.rst:796 msgid "Archiving example with *base_dir*" msgstr "" -#: library/shutil.rst:793 +#: library/shutil.rst:798 msgid "" "In this example, similar to the `one above `_, we " "show how to use :func:`make_archive`, but this time with the usage of " "*base_dir*. We now have the following directory structure:" msgstr "" -#: library/shutil.rst:807 +#: library/shutil.rst:812 msgid "" "In the final archive, :file:`please_add.txt` should be included, but :file:" "`do_not_add.txt` should not. Therefore we use the following::" msgstr "" -#: library/shutil.rst:821 +#: library/shutil.rst:826 msgid "Listing the files in the resulting archive gives us:" msgstr "" -#: library/shutil.rst:831 +#: library/shutil.rst:836 msgid "Querying the size of the output terminal" msgstr "" -#: library/shutil.rst:835 +#: library/shutil.rst:840 msgid "Get the size of the terminal window." msgstr "" -#: library/shutil.rst:837 +#: library/shutil.rst:842 msgid "" "For each of the two dimensions, the environment variable, ``COLUMNS`` and " "``LINES`` respectively, is checked. If the variable is defined and the value " "is a positive integer, it is used." msgstr "" -#: library/shutil.rst:841 +#: library/shutil.rst:846 msgid "" "When ``COLUMNS`` or ``LINES`` is not defined, which is the common case, the " "terminal connected to :data:`sys.__stdout__` is queried by invoking :func:" "`os.get_terminal_size`." msgstr "" -#: library/shutil.rst:845 +#: library/shutil.rst:850 msgid "" "If the terminal size cannot be successfully queried, either because the " "system doesn't support querying, or because we are not connected to a " @@ -1034,17 +1047,17 @@ msgid "" "emulators." msgstr "" -#: library/shutil.rst:851 +#: library/shutil.rst:856 msgid "The value returned is a named tuple of type :class:`os.terminal_size`." msgstr "" -#: library/shutil.rst:853 +#: library/shutil.rst:858 msgid "" "See also: The Single UNIX Specification, Version 2, `Other Environment " "Variables`_." msgstr "" -#: library/shutil.rst:858 +#: library/shutil.rst:863 msgid "" "The ``fallback`` values are also used if :func:`os.get_terminal_size` " "returns zeroes." diff --git a/library/smtplib.po b/library/smtplib.po index 55fd66058..b1dec6638 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -76,7 +76,7 @@ msgid "" "keyword:`!with` statement exits. E.g.::" msgstr "" -#: library/smtplib.rst:68 +#: library/smtplib.rst:70 msgid "" "Raises an :ref:`auditing event ` ``smtplib.send`` with arguments " "``self``, ``data``." @@ -308,7 +308,7 @@ msgid "" "connection response." msgstr "" -#: library/smtplib.rst:262 +#: library/smtplib.rst:264 msgid "" "Raises an :ref:`auditing event ` ``smtplib.connect`` with " "arguments ``self``, ``host``, ``port``." diff --git a/library/socket.po b/library/socket.po index 489c291d8..ffcf9c008 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -109,7 +109,7 @@ msgid "" "Previously, :const:`AF_UNIX` socket paths were assumed to use UTF-8 encoding." msgstr "" -#: library/socket.rst:1148 library/socket.rst:1949 +#: library/socket.rst:1148 library/socket.rst:1950 msgid "Writable :term:`bytes-like object` is now accepted." msgstr "" @@ -283,7 +283,7 @@ msgstr "" msgid "*feat* and *mask* are unsigned 32bit integers." msgstr "" -#: library/socket.rst:589 library/socket.rst:1871 +#: library/socket.rst:589 library/socket.rst:1872 msgid ":ref:`Availability `: Linux >= 2.6.38." msgstr "" @@ -827,7 +827,7 @@ msgstr "" msgid "Constants for Windows Hyper-V sockets for host/guest communications." msgstr "" -#: library/socket.rst:886 library/socket.rst:1977 +#: library/socket.rst:886 library/socket.rst:1978 msgid ":ref:`Availability `: Windows." msgstr "" @@ -882,7 +882,7 @@ msgstr "" msgid "The newly created socket is :ref:`non-inheritable `." msgstr "" -#: library/socket.rst:740 +#: library/socket.rst:742 msgid "" "Raises an :ref:`auditing event ` ``socket.__new__`` with arguments " "``self``, ``family``, ``type``, ``protocol``." @@ -1114,7 +1114,7 @@ msgid "" "`AF_INET6`), and is meant to be passed to the :meth:`socket.connect` method." msgstr "" -#: library/socket.rst:951 +#: library/socket.rst:953 msgid "" "Raises an :ref:`auditing event ` ``socket.getaddrinfo`` with " "arguments ``host``, ``port``, ``family``, ``type``, ``protocol``." @@ -1158,7 +1158,7 @@ msgid "" "stack support." msgstr "" -#: library/socket.rst:1005 +#: library/socket.rst:1007 msgid "" "Raises an :ref:`auditing event ` ``socket.gethostbyname`` with " "argument ``hostname``." @@ -1166,7 +1166,7 @@ msgstr "" #: library/socket.rst:998 library/socket.rst:1026 library/socket.rst:1054 #: library/socket.rst:1076 library/socket.rst:1447 library/socket.rst:1481 -#: library/socket.rst:1573 library/socket.rst:1965 +#: library/socket.rst:1573 library/socket.rst:1966 msgid ":ref:`Availability `: not WASI." msgstr "" @@ -1188,7 +1188,7 @@ msgid "" "interpreter is currently executing." msgstr "" -#: library/socket.rst:1015 +#: library/socket.rst:1017 msgid "" "Raises an :ref:`auditing event ` ``socket.gethostname`` with no " "arguments." @@ -1211,7 +1211,7 @@ msgid "" "`gethostbyaddr` supports both IPv4 and IPv6." msgstr "" -#: library/socket.rst:1033 +#: library/socket.rst:1035 msgid "" "Raises an :ref:`auditing event ` ``socket.gethostbyaddr`` with " "argument ``ip_address``." @@ -1236,7 +1236,7 @@ msgid "" "For more information about *flags* you can consult :manpage:`getnameinfo(3)`." msgstr "" -#: library/socket.rst:1050 +#: library/socket.rst:1052 msgid "" "Raises an :ref:`auditing event ` ``socket.getnameinfo`` with " "argument ``sockaddr``." @@ -1258,7 +1258,7 @@ msgid "" "``'udp'``, otherwise any protocol will match." msgstr "" -#: library/socket.rst:1072 +#: library/socket.rst:1074 msgid "" "Raises an :ref:`auditing event ` ``socket.getservbyname`` with " "arguments ``servicename``, ``protocolname``." @@ -1271,7 +1271,7 @@ msgid "" "``'udp'``, otherwise any protocol will match." msgstr "" -#: library/socket.rst:1083 +#: library/socket.rst:1085 msgid "" "Raises an :ref:`auditing event ` ``socket.getservbyport`` with " "arguments ``port``, ``protocolname``." @@ -1413,7 +1413,7 @@ msgstr "" msgid ":ref:`Availability `: Unix, not Emscripten, not WASI." msgstr "" -#: library/socket.rst:1703 library/socket.rst:1855 +#: library/socket.rst:1704 library/socket.rst:1856 msgid "Most Unix platforms." msgstr "" @@ -1459,13 +1459,13 @@ msgid "" "you don't have enough rights." msgstr "" -#: library/socket.rst:1270 +#: library/socket.rst:1272 msgid "" "Raises an :ref:`auditing event ` ``socket.sethostname`` with " "argument ``name``." msgstr "" -#: library/socket.rst:1701 library/socket.rst:1745 +#: library/socket.rst:1702 library/socket.rst:1746 msgid ":ref:`Availability `: Unix." msgstr "" @@ -1581,8 +1581,8 @@ msgstr "" msgid "The socket is now non-inheritable." msgstr "" -#: library/socket.rst:1616 library/socket.rst:1707 library/socket.rst:1799 -#: library/socket.rst:1861 +#: library/socket.rst:1617 library/socket.rst:1708 library/socket.rst:1800 +#: library/socket.rst:1862 msgid "" "If the system call is interrupted and the signal handler does not raise an " "exception, the method now retries the system call instead of raising an :exc:" @@ -1595,7 +1595,7 @@ msgid "" "format of *address* depends on the address family --- see above.)" msgstr "" -#: library/socket.rst:1407 +#: library/socket.rst:1409 msgid "" "Raises an :ref:`auditing event ` ``socket.bind`` with arguments " "``self``, ``address``." @@ -1647,7 +1647,7 @@ msgid "" "(or the exception raised by the signal handler)." msgstr "" -#: library/socket.rst:1468 +#: library/socket.rst:1470 msgid "" "Raises an :ref:`auditing event ` ``socket.connect`` with arguments " "``self``, ``address``." @@ -1819,18 +1819,19 @@ msgstr "" msgid "" "Receive data from the socket. The return value is a bytes object " "representing the data received. The maximum amount of data to be received " -"at once is specified by *bufsize*. See the Unix manual page :manpage:" +"at once is specified by *bufsize*. A returned empty bytes object indicates " +"that the client has disconnected. See the Unix manual page :manpage:" "`recv(2)` for the meaning of the optional argument *flags*; it defaults to " "zero." msgstr "" -#: library/socket.rst:1613 +#: library/socket.rst:1614 msgid "" "For best match with hardware and network realities, the value of *bufsize* " "should be a relatively small power of 2, for example, 4096." msgstr "" -#: library/socket.rst:1624 +#: library/socket.rst:1625 msgid "" "Receive data from the socket. The return value is a pair ``(bytes, " "address)`` where *bytes* is a bytes object representing the data received " @@ -1840,14 +1841,14 @@ msgid "" "address family --- see above.)" msgstr "" -#: library/socket.rst:1635 +#: library/socket.rst:1636 msgid "" "For multicast IPv6 address, first item of *address* does not contain " "``%scope_id`` part anymore. In order to get full IPv6 address use :func:" "`getnameinfo`." msgstr "" -#: library/socket.rst:1642 +#: library/socket.rst:1643 msgid "" "Receive normal data (up to *bufsize* bytes) and ancillary data from the " "socket. The *ancbufsize* argument sets the size in bytes of the internal " @@ -1858,7 +1859,7 @@ msgid "" "*flags* argument defaults to 0 and has the same meaning as for :meth:`recv`." msgstr "" -#: library/socket.rst:1652 +#: library/socket.rst:1653 msgid "" "The return value is a 4-tuple: ``(data, ancdata, msg_flags, address)``. The " "*data* item is a :class:`bytes` object holding the non-ancillary data " @@ -1873,7 +1874,7 @@ msgid "" "socket, if available; otherwise, its value is unspecified." msgstr "" -#: library/socket.rst:1666 +#: library/socket.rst:1667 msgid "" "On some systems, :meth:`sendmsg` and :meth:`recvmsg` can be used to pass " "file descriptors between processes over an :const:`AF_UNIX` socket. When " @@ -1886,7 +1887,7 @@ msgid "" "descriptors received via this mechanism." msgstr "" -#: library/socket.rst:1677 +#: library/socket.rst:1678 msgid "" "Some systems do not indicate the truncated length of ancillary data items " "which have been only partially received. If an item appears to extend " @@ -1895,7 +1896,7 @@ msgid "" "provided it has not been truncated before the start of its associated data." msgstr "" -#: library/socket.rst:1684 +#: library/socket.rst:1685 msgid "" "On systems which support the :const:`SCM_RIGHTS` mechanism, the following " "function will receive up to *maxfds* file descriptors, returning the message " @@ -1904,7 +1905,7 @@ msgid "" "meth:`sendmsg`. ::" msgstr "" -#: library/socket.rst:1715 +#: library/socket.rst:1716 msgid "" "Receive normal data and ancillary data from the socket, behaving as :meth:" "`recvmsg` would, but scatter the non-ancillary data into a series of buffers " @@ -1917,7 +1918,7 @@ msgid "" "arguments have the same meaning as for :meth:`recvmsg`." msgstr "" -#: library/socket.rst:1726 +#: library/socket.rst:1727 msgid "" "The return value is a 4-tuple: ``(nbytes, ancdata, msg_flags, address)``, " "where *nbytes* is the total number of bytes of non-ancillary data written " @@ -1925,11 +1926,11 @@ msgid "" "for :meth:`recvmsg`." msgstr "" -#: library/socket.rst:1731 +#: library/socket.rst:1732 msgid "Example::" msgstr "" -#: library/socket.rst:1754 +#: library/socket.rst:1755 msgid "" "Receive data from the socket, writing it into *buffer* instead of creating a " "new bytestring. The return value is a pair ``(nbytes, address)`` where " @@ -1939,7 +1940,7 @@ msgid "" "format of *address* depends on the address family --- see above.)" msgstr "" -#: library/socket.rst:1764 +#: library/socket.rst:1765 msgid "" "Receive up to *nbytes* bytes from the socket, storing the data into a buffer " "rather than creating a new bytestring. If *nbytes* is not specified (or 0), " @@ -1948,7 +1949,7 @@ msgid "" "of the optional argument *flags*; it defaults to zero." msgstr "" -#: library/socket.rst:1773 +#: library/socket.rst:1774 msgid "" "Send data to the socket. The socket must be connected to a remote socket. " "The optional *flags* argument has the same meaning as for :meth:`recv` " @@ -1958,7 +1959,7 @@ msgid "" "data. For further information on this topic, consult the :ref:`socket-howto`." msgstr "" -#: library/socket.rst:1788 +#: library/socket.rst:1789 msgid "" "Send data to the socket. The socket must be connected to a remote socket. " "The optional *flags* argument has the same meaning as for :meth:`recv` " @@ -1968,13 +1969,13 @@ msgid "" "to determine how much data, if any, was successfully sent." msgstr "" -#: library/socket.rst:1795 +#: library/socket.rst:1796 msgid "" "The socket timeout is no longer reset each time data is sent successfully. " "The socket timeout is now the maximum total duration to send all data." msgstr "" -#: library/socket.rst:1808 +#: library/socket.rst:1809 msgid "" "Send data to the socket. The socket should not be connected to a remote " "socket, since the destination socket is specified by *address*. The " @@ -1983,13 +1984,13 @@ msgid "" "address family --- see above.)" msgstr "" -#: library/socket.rst:1823 +#: library/socket.rst:1826 msgid "" "Raises an :ref:`auditing event ` ``socket.sendto`` with arguments " "``self``, ``address``." msgstr "" -#: library/socket.rst:1824 +#: library/socket.rst:1825 msgid "" "Send normal and ancillary data to the socket, gathering the non-ancillary " "data from a series of buffers and concatenating it into a single message. " @@ -2009,31 +2010,31 @@ msgid "" "bytes of non-ancillary data sent." msgstr "" -#: library/socket.rst:1844 +#: library/socket.rst:1845 msgid "" "The following function sends the list of file descriptors *fds* over an :" "const:`AF_UNIX` socket, on systems which support the :const:`SCM_RIGHTS` " "mechanism. See also :meth:`recvmsg`. ::" msgstr "" -#: library/socket.rst:1853 +#: library/socket.rst:1854 msgid ":ref:`Availability `: Unix, not WASI." msgstr "" -#: library/socket.rst:1866 +#: library/socket.rst:1869 msgid "" "Raises an :ref:`auditing event ` ``socket.sendmsg`` with arguments " "``self``, ``address``." msgstr "" -#: library/socket.rst:1868 +#: library/socket.rst:1869 msgid "" "Specialized version of :meth:`~socket.sendmsg` for :const:`AF_ALG` socket. " "Set mode, IV, AEAD associated data length and flags for :const:`AF_ALG` " "socket." msgstr "" -#: library/socket.rst:1877 +#: library/socket.rst:1878 msgid "" "Send a file until EOF is reached by using high-performance :mod:`os." "sendfile` and return the total number of bytes which were sent. *file* must " @@ -2047,38 +2048,38 @@ msgid "" "be of :const:`SOCK_STREAM` type. Non-blocking sockets are not supported." msgstr "" -#: library/socket.rst:1893 +#: library/socket.rst:1894 msgid "" "Set the :ref:`inheritable flag ` of the socket's file " "descriptor or socket's handle." msgstr "" -#: library/socket.rst:1901 +#: library/socket.rst:1902 msgid "" "Set blocking or non-blocking mode of the socket: if *flag* is false, the " "socket is set to non-blocking, else to blocking mode." msgstr "" -#: library/socket.rst:1904 +#: library/socket.rst:1905 msgid "" "This method is a shorthand for certain :meth:`~socket.settimeout` calls:" msgstr "" -#: library/socket.rst:1906 +#: library/socket.rst:1907 msgid "``sock.setblocking(True)`` is equivalent to ``sock.settimeout(None)``" msgstr "" -#: library/socket.rst:1908 +#: library/socket.rst:1909 msgid "``sock.setblocking(False)`` is equivalent to ``sock.settimeout(0.0)``" msgstr "" -#: library/socket.rst:1910 +#: library/socket.rst:1911 msgid "" "The method no longer applies :const:`SOCK_NONBLOCK` flag on :attr:`socket." "type`." msgstr "" -#: library/socket.rst:1917 +#: library/socket.rst:1918 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-" @@ -2088,19 +2089,19 @@ msgid "" "blocking mode. If ``None`` is given, the socket is put in blocking mode." msgstr "" -#: library/socket.rst:1924 +#: library/socket.rst:1925 msgid "" "For further information, please consult the :ref:`notes on socket timeouts " "`." msgstr "" -#: library/socket.rst:1926 +#: library/socket.rst:1927 msgid "" "The method no longer toggles :const:`SOCK_NONBLOCK` flag on :attr:`socket." "type`." msgstr "" -#: library/socket.rst:1939 +#: library/socket.rst:1940 msgid "" "Set the value of the given socket option (see the Unix manual page :manpage:" "`setsockopt(2)`). The needed symbolic constants are defined in this module " @@ -2113,11 +2114,11 @@ msgid "" "C function with ``optval=NULL`` and ``optlen=optlen``." msgstr "" -#: library/socket.rst:1952 +#: library/socket.rst:1953 msgid "setsockopt(level, optname, None, optlen: int) form added." msgstr "" -#: library/socket.rst:1960 +#: library/socket.rst:1961 msgid "" "Shut down one or both halves of the connection. If *how* is :const:" "`SHUT_RD`, further receives are disallowed. If *how* is :const:`SHUT_WR`, " @@ -2125,7 +2126,7 @@ msgid "" "and receives are disallowed." msgstr "" -#: library/socket.rst:1970 +#: library/socket.rst:1971 msgid "" "Duplicate a socket and prepare it for sharing with a target process. The " "target process must be provided with *process_id*. The resulting bytes " @@ -2136,48 +2137,48 @@ msgid "" "process." msgstr "" -#: library/socket.rst:1982 +#: library/socket.rst:1983 msgid "" "Note that there are no methods :meth:`read` or :meth:`write`; use :meth:" "`~socket.recv` and :meth:`~socket.send` without *flags* argument instead." msgstr "" -#: library/socket.rst:1985 +#: library/socket.rst:1986 msgid "" "Socket objects also have these (read-only) attributes that correspond to the " "values given to the :class:`~socket.socket` constructor." msgstr "" -#: library/socket.rst:1991 +#: library/socket.rst:1992 msgid "The socket family." msgstr "" -#: library/socket.rst:1996 +#: library/socket.rst:1997 msgid "The socket type." msgstr "" -#: library/socket.rst:2001 +#: library/socket.rst:2002 msgid "The socket protocol." msgstr "" -#: library/socket.rst:2008 +#: library/socket.rst:2009 msgid "Notes on socket timeouts" msgstr "" -#: library/socket.rst:2010 +#: library/socket.rst:2011 msgid "" "A socket object can be in one of three modes: blocking, non-blocking, or " "timeout. Sockets are by default always created in blocking mode, but this " "can be changed by calling :func:`setdefaulttimeout`." msgstr "" -#: library/socket.rst:2014 +#: library/socket.rst:2015 msgid "" "In *blocking mode*, operations block until complete or the system returns an " "error (such as connection timed out)." msgstr "" -#: library/socket.rst:2017 +#: library/socket.rst:2018 msgid "" "In *non-blocking mode*, operations fail (with an error that is unfortunately " "system-dependent) if they cannot be completed immediately: functions from " @@ -2185,14 +2186,14 @@ msgid "" "available for reading or writing." msgstr "" -#: library/socket.rst:2022 +#: library/socket.rst:2023 msgid "" "In *timeout mode*, operations fail if they cannot be completed within the " "timeout specified for the socket (they raise a :exc:`timeout` exception) or " "if the system returns an error." msgstr "" -#: library/socket.rst:2027 +#: library/socket.rst:2028 msgid "" "At the operating system level, sockets in *timeout mode* are internally set " "in non-blocking mode. Also, the blocking and timeout modes are shared " @@ -2201,11 +2202,11 @@ msgid "" "you decide to use the :meth:`~socket.fileno()` of a socket." msgstr "" -#: library/socket.rst:2034 +#: library/socket.rst:2035 msgid "Timeouts and the ``connect`` method" msgstr "" -#: library/socket.rst:2036 +#: library/socket.rst:2037 msgid "" "The :meth:`~socket.connect` operation is also subject to the timeout " "setting, and in general it is recommended to call :meth:`~socket.settimeout` " @@ -2215,24 +2216,24 @@ msgid "" "setting." msgstr "" -#: library/socket.rst:2044 +#: library/socket.rst:2045 msgid "Timeouts and the ``accept`` method" msgstr "" -#: library/socket.rst:2046 +#: library/socket.rst:2047 msgid "" "If :func:`getdefaulttimeout` is not :const:`None`, sockets returned by the :" "meth:`~socket.accept` method inherit that timeout. Otherwise, the behaviour " "depends on settings of the listening socket:" msgstr "" -#: library/socket.rst:2050 +#: library/socket.rst:2051 msgid "" "if the listening socket is in *blocking mode* or in *timeout mode*, the " "socket returned by :meth:`~socket.accept` is in *blocking mode*;" msgstr "" -#: library/socket.rst:2053 +#: library/socket.rst:2054 msgid "" "if the listening socket is in *non-blocking mode*, whether the socket " "returned by :meth:`~socket.accept` is in blocking or non-blocking mode is " @@ -2240,11 +2241,11 @@ msgid "" "it is recommended you manually override this setting." msgstr "" -#: library/socket.rst:2062 +#: library/socket.rst:2063 msgid "Example" msgstr "" -#: library/socket.rst:2064 +#: library/socket.rst:2065 msgid "" "Here are four minimal example programs using the TCP/IP protocol: a server " "that echoes all data that it receives back (servicing only one client), and " @@ -2257,11 +2258,11 @@ msgid "" "on the new socket returned by :meth:`~socket.accept`." msgstr "" -#: library/socket.rst:2074 +#: library/socket.rst:2075 msgid "The first two examples support IPv4 only. ::" msgstr "" -#: library/socket.rst:2105 +#: library/socket.rst:2106 msgid "" "The next two examples are identical to the above two, but support both IPv4 " "and IPv6. The server side will listen to the first address family available " @@ -2271,73 +2272,73 @@ msgid "" "resolution, and sends traffic to the first one connected successfully. ::" msgstr "" -#: library/socket.rst:2177 +#: library/socket.rst:2178 msgid "" "The next example shows how to write a very simple network sniffer with raw " "sockets on Windows. The example requires administrator privileges to modify " "the interface::" msgstr "" -#: library/socket.rst:2202 +#: library/socket.rst:2203 msgid "" "The next example shows how to use the socket interface to communicate to a " "CAN network using the raw socket protocol. To use CAN with the broadcast " "manager protocol instead, open a socket with::" msgstr "" -#: library/socket.rst:2208 +#: library/socket.rst:2209 msgid "" "After binding (:const:`CAN_RAW`) or connecting (:const:`CAN_BCM`) the " "socket, you can use the :meth:`socket.send` and :meth:`socket.recv` " "operations (and their counterparts) on the socket object as usual." msgstr "" -#: library/socket.rst:2212 +#: library/socket.rst:2213 msgid "This last example might require special privileges::" msgstr "" -#: library/socket.rst:2252 +#: library/socket.rst:2253 msgid "" "Running an example several times with too small delay between executions, " "could lead to this error::" msgstr "" -#: library/socket.rst:2257 +#: library/socket.rst:2258 msgid "" "This is because the previous execution has left the socket in a " "``TIME_WAIT`` state, and can't be immediately reused." msgstr "" -#: library/socket.rst:2260 +#: library/socket.rst:2261 msgid "" "There is a :mod:`socket` flag to set, in order to prevent this, :const:" "`socket.SO_REUSEADDR`::" msgstr "" -#: library/socket.rst:2267 +#: library/socket.rst:2268 msgid "" "the :data:`SO_REUSEADDR` flag tells the kernel to reuse a local socket in " "``TIME_WAIT`` state, without waiting for its natural timeout to expire." msgstr "" -#: library/socket.rst:2273 +#: library/socket.rst:2274 msgid "" "For an introduction to socket programming (in C), see the following papers:" msgstr "" -#: library/socket.rst:2275 +#: library/socket.rst:2276 msgid "" "*An Introductory 4.3BSD Interprocess Communication Tutorial*, by Stuart " "Sechrest" msgstr "" -#: library/socket.rst:2277 +#: library/socket.rst:2278 msgid "" "*An Advanced 4.3BSD Interprocess Communication Tutorial*, by Samuel J. " "Leffler et al," msgstr "" -#: library/socket.rst:2280 +#: library/socket.rst:2281 msgid "" "both in the UNIX Programmer's Manual, Supplementary Documents 1 (sections " "PS1:7 and PS1:8). The platform-specific reference material for the various " @@ -2364,10 +2365,10 @@ msgstr "" msgid "buffering" msgstr "" -#: library/socket.rst:1937 +#: library/socket.rst:1938 msgid "module" msgstr "" -#: library/socket.rst:1937 +#: library/socket.rst:1938 msgid "struct" msgstr "" diff --git a/library/socketserver.po b/library/socketserver.po index edbc70946..ae3b01ddc 100644 --- a/library/socketserver.po +++ b/library/socketserver.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -524,7 +524,7 @@ msgstr "" msgid ":class:`socketserver.TCPServer` Example" msgstr "" -#: library/socketserver.rst:580 +#: library/socketserver.rst:581 msgid "This is the server side::" msgstr "" @@ -540,50 +540,51 @@ msgid "" "The difference is that the ``readline()`` call in the second handler will " "call ``recv()`` multiple times until it encounters a newline character, " "while the single ``recv()`` call in the first handler will just return what " -"has been sent from the client in one ``sendall()`` call." +"has been received so far from the client's ``sendall()`` call (typically all " +"of it, but this is not guaranteed by the TCP protocol)." msgstr "" -#: library/socketserver.rst:604 +#: library/socketserver.rst:605 msgid "This is the client side::" msgstr "" -#: library/socketserver.rst:679 +#: library/socketserver.rst:680 msgid "The output of the example should look something like this:" msgstr "" -#: library/socketserver.rst:555 +#: library/socketserver.rst:556 msgid "Server:" msgstr "" -#: library/socketserver.rst:565 +#: library/socketserver.rst:566 msgid "Client:" msgstr "" -#: library/socketserver.rst:578 +#: library/socketserver.rst:579 msgid ":class:`socketserver.UDPServer` Example" msgstr "" -#: library/socketserver.rst:623 +#: library/socketserver.rst:624 msgid "" "The output of the example should look exactly like for the TCP server " "example." msgstr "" -#: library/socketserver.rst:627 +#: library/socketserver.rst:628 msgid "Asynchronous Mixins" msgstr "" -#: library/socketserver.rst:629 +#: library/socketserver.rst:630 msgid "" "To build asynchronous handlers, use the :class:`ThreadingMixIn` and :class:" "`ForkingMixIn` classes." msgstr "" -#: library/socketserver.rst:632 +#: library/socketserver.rst:633 msgid "An example for the :class:`ThreadingMixIn` class::" msgstr "" -#: library/socketserver.rst:690 +#: library/socketserver.rst:691 msgid "" "The :class:`ForkingMixIn` class is used in the same way, except that the " "server will spawn a new process for each request. Available only on POSIX " diff --git a/library/sqlite3.po b/library/sqlite3.po index e93d6865d..d3e97bc49 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: 2023-12-01 14:57+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -357,7 +357,7 @@ msgid "" msgstr "" #: library/sqlite3.rst:346 -msgid "The *uri* parameter." +msgid "Added the *uri* parameter." msgstr "" #: library/sqlite3.rst:349 @@ -366,11 +366,11 @@ msgid "" msgstr "" #: library/sqlite3.rst:352 -msgid "The ``sqlite3.connect/handle`` auditing event." +msgid "Added the ``sqlite3.connect/handle`` auditing event." msgstr "" #: library/sqlite3.rst:355 -msgid "The *autocommit* parameter." +msgid "Added the *autocommit* parameter." msgstr "" #: library/sqlite3.rst:360 @@ -802,7 +802,7 @@ msgid "If *deterministic* is used with SQLite versions older than 3.8.3." msgstr "" #: library/sqlite3.rst:741 -msgid "The *deterministic* parameter." +msgid "Added the *deterministic* parameter." msgstr "" #: library/sqlite3.rst:782 library/sqlite3.rst:1115 library/sqlite3.rst:1568 @@ -1093,7 +1093,7 @@ msgid "Added the ``sqlite3.load_extension`` auditing event." msgstr "" #: library/sqlite3.rst:1104 -msgid "The *entrypoint* parameter." +msgid "Added the *entrypoint* parameter." msgstr "" #: library/sqlite3.rst:1111 diff --git a/library/ssl.po b/library/ssl.po index 8debb590c..5ad443b19 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2158,7 +2158,7 @@ msgstr "" #: library/ssl.rst:1953 msgid "" -"The flag had no effect with OpenSSL before version 1.1.1k. Python 3.8.9, " +"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 "" @@ -2679,83 +2679,76 @@ msgstr "" #: library/ssl.rst:2456 msgid "" -"There is no module-level ``wrap_bio()`` call like there is for :meth:" -"`~SSLContext.wrap_socket`. An :class:`SSLObject` is always created via an :" -"class:`SSLContext`." -msgstr "" - -#: library/ssl.rst:2460 -msgid "" -":class:`SSLObject` instances must to created with :meth:`~SSLContext." +":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:2466 +#: library/ssl.rst:2462 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:2472 +#: library/ssl.rst:2468 msgid "" "A memory buffer that can be used to pass data between Python and an SSL " "protocol instance." msgstr "" -#: library/ssl.rst:2477 +#: library/ssl.rst:2473 msgid "Return the number of bytes currently in the memory buffer." msgstr "" -#: library/ssl.rst:2481 +#: library/ssl.rst:2477 msgid "" "A boolean indicating whether the memory BIO is current at the end-of-file " "position." msgstr "" -#: library/ssl.rst:2486 +#: library/ssl.rst:2482 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:2491 +#: library/ssl.rst:2487 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:2494 +#: library/ssl.rst:2490 msgid "" "The return value is the number of bytes written, which is always equal to " "the length of *buf*." msgstr "" -#: library/ssl.rst:2499 +#: library/ssl.rst:2495 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:2505 +#: library/ssl.rst:2501 msgid "SSL session" msgstr "" -#: library/ssl.rst:2511 +#: library/ssl.rst:2507 msgid "Session object used by :attr:`~SSLSocket.session`." msgstr "" -#: library/ssl.rst:2523 +#: library/ssl.rst:2519 msgid "Security considerations" msgstr "" -#: library/ssl.rst:2526 +#: library/ssl.rst:2522 msgid "Best defaults" msgstr "" -#: library/ssl.rst:2528 +#: library/ssl.rst:2524 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:" @@ -2765,19 +2758,19 @@ msgid "" "settings." msgstr "" -#: library/ssl.rst:2535 +#: library/ssl.rst:2531 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:2544 +#: library/ssl.rst:2540 msgid "" "If a client certificate is needed for the connection, it can be added with :" "meth:`SSLContext.load_cert_chain`." msgstr "" -#: library/ssl.rst:2547 +#: library/ssl.rst:2543 msgid "" "By contrast, if you create the SSL context by calling the :class:" "`SSLContext` constructor yourself, it will not have certificate validation " @@ -2785,15 +2778,15 @@ msgid "" "paragraphs below to achieve a good security level." msgstr "" -#: library/ssl.rst:2553 +#: library/ssl.rst:2549 msgid "Manual settings" msgstr "" -#: library/ssl.rst:2556 +#: library/ssl.rst:2552 msgid "Verifying certificates" msgstr "" -#: library/ssl.rst:2558 +#: library/ssl.rst:2554 msgid "" "When calling the :class:`SSLContext` constructor directly, :const:" "`CERT_NONE` is the default. Since it does not authenticate the other peer, " @@ -2808,13 +2801,13 @@ msgid "" "enabled." msgstr "" -#: library/ssl.rst:2570 +#: library/ssl.rst:2566 msgid "" "Hostname matchings is now performed by OpenSSL. Python no longer uses :func:" "`match_hostname`." msgstr "" -#: library/ssl.rst:2574 +#: library/ssl.rst:2570 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 " @@ -2822,11 +2815,11 @@ msgid "" "certificate." msgstr "" -#: library/ssl.rst:2580 +#: library/ssl.rst:2576 msgid "Protocol versions" msgstr "" -#: library/ssl.rst:2582 +#: library/ssl.rst:2578 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 " @@ -2835,7 +2828,7 @@ msgid "" "by default." msgstr "" -#: library/ssl.rst:2595 +#: library/ssl.rst:2591 msgid "" "The SSL context created above will only allow TLSv1.3 and later (if " "supported by your system) connections to a server. :const:" @@ -2843,11 +2836,11 @@ msgid "" "default. You have to load certificates into the context." msgstr "" -#: library/ssl.rst:2602 +#: library/ssl.rst:2598 msgid "Cipher selection" msgstr "" -#: library/ssl.rst:2604 +#: library/ssl.rst:2600 msgid "" "If you have advanced security requirements, fine-tuning of the ciphers " "enabled when negotiating a SSL session is possible through the :meth:" @@ -2860,11 +2853,11 @@ msgid "" "ciphers`` command on your system." msgstr "" -#: library/ssl.rst:2615 +#: library/ssl.rst:2611 msgid "Multi-processing" msgstr "" -#: library/ssl.rst:2617 +#: library/ssl.rst:2613 msgid "" "If using this module as part of a multi-processed application (using, for " "example the :mod:`multiprocessing` or :mod:`concurrent.futures` modules), be " @@ -2875,17 +2868,17 @@ msgid "" "sufficient." msgstr "" -#: library/ssl.rst:2629 +#: library/ssl.rst:2625 msgid "TLS 1.3" msgstr "" -#: library/ssl.rst:2633 +#: library/ssl.rst:2629 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:2636 +#: library/ssl.rst:2632 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." @@ -2893,14 +2886,14 @@ msgid "" "`SSLContext.get_ciphers` returns them." msgstr "" -#: library/ssl.rst:2640 +#: library/ssl.rst:2636 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:2643 +#: library/ssl.rst:2639 msgid "" "Client-side certificates are also no longer verified during the initial " "handshake. A server can request a certificate at any time. Clients process " @@ -2908,103 +2901,103 @@ msgid "" "server." msgstr "" -#: library/ssl.rst:2647 +#: library/ssl.rst:2643 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:2654 +#: library/ssl.rst:2650 msgid "Class :class:`socket.socket`" msgstr "" -#: library/ssl.rst:2654 +#: library/ssl.rst:2650 msgid "Documentation of underlying :mod:`socket` class" msgstr "" -#: library/ssl.rst:2657 +#: library/ssl.rst:2653 msgid "" "`SSL/TLS Strong Encryption: An Introduction `_" msgstr "" -#: library/ssl.rst:2657 +#: library/ssl.rst:2653 msgid "Intro from the Apache HTTP Server documentation" msgstr "" -#: library/ssl.rst:2660 +#: library/ssl.rst:2656 msgid "" ":rfc:`RFC 1422: Privacy Enhancement for Internet Electronic Mail: Part II: " "Certificate-Based Key Management <1422>`" msgstr "" -#: library/ssl.rst:2660 +#: library/ssl.rst:2656 msgid "Steve Kent" msgstr "" -#: library/ssl.rst:2663 +#: library/ssl.rst:2659 msgid ":rfc:`RFC 4086: Randomness Requirements for Security <4086>`" msgstr "" -#: library/ssl.rst:2663 +#: library/ssl.rst:2659 msgid "Donald E., Jeffrey I. Schiller" msgstr "" -#: library/ssl.rst:2666 +#: library/ssl.rst:2662 msgid "" ":rfc:`RFC 5280: Internet X.509 Public Key Infrastructure Certificate and " "Certificate Revocation List (CRL) Profile <5280>`" msgstr "" -#: library/ssl.rst:2666 +#: library/ssl.rst:2662 msgid "D. Cooper" msgstr "" -#: library/ssl.rst:2669 +#: library/ssl.rst:2665 msgid "" ":rfc:`RFC 5246: The Transport Layer Security (TLS) Protocol Version 1.2 " "<5246>`" msgstr "" -#: library/ssl.rst:2669 +#: library/ssl.rst:2665 msgid "T. Dierks et. al." msgstr "" -#: library/ssl.rst:2672 +#: library/ssl.rst:2668 msgid ":rfc:`RFC 6066: Transport Layer Security (TLS) Extensions <6066>`" msgstr "" -#: library/ssl.rst:2672 +#: library/ssl.rst:2668 msgid "D. Eastlake" msgstr "" -#: library/ssl.rst:2675 +#: library/ssl.rst:2671 msgid "" "`IANA TLS: Transport Layer Security (TLS) Parameters `_" msgstr "" -#: library/ssl.rst:2675 +#: library/ssl.rst:2671 msgid "IANA" msgstr "" -#: library/ssl.rst:2678 +#: library/ssl.rst:2674 msgid "" ":rfc:`RFC 7525: Recommendations for Secure Use of Transport Layer Security " "(TLS) and Datagram Transport Layer Security (DTLS) <7525>`" msgstr "" -#: library/ssl.rst:2678 +#: library/ssl.rst:2674 msgid "IETF" msgstr "" -#: library/ssl.rst:2680 +#: library/ssl.rst:2676 msgid "" "`Mozilla's Server Side TLS recommendations `_" msgstr "" -#: library/ssl.rst:2681 +#: library/ssl.rst:2677 msgid "Mozilla" msgstr "" diff --git a/library/statistics.po b/library/statistics.po index f3d10e717..5a8b4c38a 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1086,15 +1086,15 @@ msgid "" "probability that the Python room will stay within its capacity limits?" msgstr "" -#: library/statistics.rst:1035 +#: library/statistics.rst:1032 msgid "Naive bayesian classifier" msgstr "" -#: library/statistics.rst:1037 +#: library/statistics.rst:1034 msgid "Normal distributions commonly arise in machine learning problems." msgstr "" -#: library/statistics.rst:1039 +#: library/statistics.rst:1036 msgid "" "Wikipedia has a `nice example of a Naive Bayesian Classifier `_. The " @@ -1102,20 +1102,20 @@ msgid "" "distributed features including height, weight, and foot size." msgstr "" -#: library/statistics.rst:1044 +#: library/statistics.rst:1041 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:1057 +#: library/statistics.rst:1054 msgid "" "Next, we encounter a new person whose feature measurements are known but " "whose gender is unknown:" msgstr "" -#: library/statistics.rst:1066 +#: library/statistics.rst:1063 msgid "" "Starting with a 50% `prior probability `_ of being male or female, we compute the posterior as " @@ -1123,34 +1123,34 @@ msgid "" "given the gender:" msgstr "" -#: library/statistics.rst:1081 +#: library/statistics.rst:1078 msgid "" "The final prediction goes to the largest posterior. This is known as the " "`maximum a posteriori `_ or MAP:" msgstr "" -#: library/statistics.rst:1092 +#: library/statistics.rst:1089 msgid "Kernel density estimation" msgstr "" -#: library/statistics.rst:1094 +#: library/statistics.rst:1091 msgid "" "It is possible to estimate a continuous probability density function from a " "fixed number of discrete samples." msgstr "" -#: library/statistics.rst:1097 +#: library/statistics.rst:1094 msgid "" "The basic idea is to smooth the data using `a kernel function such as a " "normal distribution, triangular distribution, or uniform distribution " "`_. The degree of " -"smoothing is controlled by a single parameter, ``h``, representing the " -"variance of the kernel function." +"smoothing is controlled by a scaling parameter, ``h``, which is called the " +"*bandwidth*." msgstr "" -#: library/statistics.rst:1116 +#: library/statistics.rst:1111 msgid "" "`Wikipedia has an example `_ where we can use the ``kde_normal()`` " @@ -1158,10 +1158,10 @@ msgid "" "small sample:" msgstr "" -#: library/statistics.rst:1128 +#: library/statistics.rst:1123 msgid "The points in ``xarr`` and ``yarr`` can be used to make a PDF plot:" msgstr "" -#: library/statistics.rst:None +#: library/statistics.rst:-1 msgid "Scatter plot of the estimated probability density function." msgstr "" diff --git a/library/stdtypes.po b/library/stdtypes.po index 406f1fccd..7a21ca7a8 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: 2023-02-01 18:55-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2484,10 +2484,11 @@ msgstr "" "``(\"spam\" \"yumurtalar\") == \"spam yumurtalar\"``." #: library/stdtypes.rst:1530 +#, fuzzy msgid "" "See :ref:`strings` for more about the various forms of string literal, " -"including supported escape sequences, and the ``r`` (\"raw\") prefix that " -"disables most escape sequence processing." +"including supported :ref:`escape sequences `, and the " +"``r`` (\"raw\") prefix that disables most escape sequence processing." msgstr "" "Desteklenen kaçış dizileri ve çoğu kaçış dizisi işlemeyi devre dışı bırakan " "``r`` (\"raw\", Türkçesiyle \"ham\") ön eki dahil olmak üzere dize " diff --git a/library/string.po b/library/string.po index e0751bcdd..b361b1a5b 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -474,7 +474,7 @@ msgid "" "default behavior)." msgstr "" -#: library/string.rst:367 +#: library/string.rst:381 msgid "space" msgstr "" diff --git a/library/struct.po b/library/struct.po index efc615291..b0f5dc2d9 100644 --- a/library/struct.po +++ b/library/struct.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -221,7 +221,25 @@ msgstr "" msgid "If the first character is not one of these, ``'@'`` is assumed." msgstr "" -#: library/struct.rst:159 +#: library/struct.rst:161 +msgid "" +"The number 1023 (``0x3ff`` in hexadecimal) has the following byte " +"representations:" +msgstr "" + +#: library/struct.rst:163 +msgid "``03 ff`` in big-endian (``>``)" +msgstr "" + +#: library/struct.rst:164 +msgid "``ff 03`` in little-endian (``<``)" +msgstr "" + +#: library/struct.rst:166 +msgid "Python example:" +msgstr "" + +#: library/struct.rst:174 msgid "" "Native byte order is big-endian or little-endian, depending on the host " "system. For example, Intel x86, AMD64 (x86-64), and Apple M1 are little-" @@ -229,64 +247,64 @@ msgid "" "byteorder` to check the endianness of your system." msgstr "" -#: library/struct.rst:164 +#: library/struct.rst:179 msgid "" "Native size and alignment are determined using the C compiler's ``sizeof`` " "expression. This is always combined with native byte order." msgstr "" -#: library/struct.rst:167 +#: library/struct.rst:182 msgid "" "Standard size depends only on the format character; see the table in the :" "ref:`format-characters` section." msgstr "" -#: library/struct.rst:170 +#: library/struct.rst:185 msgid "" "Note the difference between ``'@'`` and ``'='``: both use native byte order, " "but the size and alignment of the latter is standardized." msgstr "" -#: library/struct.rst:173 +#: library/struct.rst:188 msgid "" "The form ``'!'`` represents the network byte order which is always big-" "endian as defined in `IETF RFC 1700 `_." msgstr "" -#: library/struct.rst:176 +#: library/struct.rst:191 msgid "" "There is no way to indicate non-native byte order (force byte-swapping); use " "the appropriate choice of ``'<'`` or ``'>'``." msgstr "" -#: library/struct.rst:258 +#: library/struct.rst:273 msgid "Notes:" msgstr "" -#: library/struct.rst:181 +#: library/struct.rst:196 msgid "" "Padding is only automatically added between successive structure members. No " "padding is added at the beginning or the end of the encoded struct." msgstr "" -#: library/struct.rst:184 +#: library/struct.rst:199 msgid "" "No padding is added when using non-native size and alignment, e.g. with '<', " "'>', '=', and '!'." msgstr "" -#: library/struct.rst:187 +#: library/struct.rst:202 msgid "" "To align the end of a structure to the alignment requirement of a particular " "type, end the format with the code for that type with a repeat count of " "zero. See :ref:`struct-examples`." msgstr "" -#: library/struct.rst:195 +#: library/struct.rst:210 msgid "Format Characters" msgstr "" -#: library/struct.rst:197 +#: library/struct.rst:212 msgid "" "Format characters have the following meaning; the conversion between C and " "Python values should be obvious given their types. The 'Standard size' " @@ -296,296 +314,296 @@ msgid "" "platform-dependent." msgstr "" -#: library/struct.rst:205 +#: library/struct.rst:220 msgid "Format" msgstr "" -#: library/struct.rst:205 +#: library/struct.rst:220 msgid "C Type" msgstr "" -#: library/struct.rst:205 +#: library/struct.rst:220 msgid "Python type" msgstr "" -#: library/struct.rst:205 +#: library/struct.rst:220 msgid "Standard size" msgstr "" -#: library/struct.rst:205 +#: library/struct.rst:220 msgid "Notes" msgstr "" -#: library/struct.rst:207 +#: library/struct.rst:222 msgid "``x``" msgstr "" -#: library/struct.rst:207 +#: library/struct.rst:222 msgid "pad byte" msgstr "" -#: library/struct.rst:207 +#: library/struct.rst:222 msgid "no value" msgstr "" -#: library/struct.rst:207 +#: library/struct.rst:222 msgid "\\(7)" msgstr "" -#: library/struct.rst:209 +#: library/struct.rst:224 msgid "``c``" msgstr "" -#: library/struct.rst:209 +#: library/struct.rst:224 msgid ":c:expr:`char`" msgstr "" -#: library/struct.rst:209 +#: library/struct.rst:224 msgid "bytes of length 1" msgstr "" -#: library/struct.rst:211 library/struct.rst:215 +#: library/struct.rst:226 library/struct.rst:230 msgid "1" msgstr "" -#: library/struct.rst:211 +#: library/struct.rst:226 msgid "``b``" msgstr "" -#: library/struct.rst:211 +#: library/struct.rst:226 msgid ":c:expr:`signed char`" msgstr "" -#: library/struct.rst:213 library/struct.rst:219 library/struct.rst:223 -#: library/struct.rst:227 library/struct.rst:231 library/struct.rst:236 -#: library/struct.rst:248 +#: library/struct.rst:228 library/struct.rst:234 library/struct.rst:238 +#: library/struct.rst:242 library/struct.rst:246 library/struct.rst:251 +#: library/struct.rst:263 msgid "integer" msgstr "" -#: library/struct.rst:211 +#: library/struct.rst:226 msgid "\\(1), \\(2)" msgstr "" -#: library/struct.rst:213 +#: library/struct.rst:228 msgid "``B``" msgstr "" -#: library/struct.rst:213 +#: library/struct.rst:228 msgid ":c:expr:`unsigned char`" msgstr "" -#: library/struct.rst:217 library/struct.rst:221 library/struct.rst:225 -#: library/struct.rst:229 library/struct.rst:231 +#: library/struct.rst:232 library/struct.rst:236 library/struct.rst:240 +#: library/struct.rst:244 library/struct.rst:246 msgid "\\(2)" msgstr "" -#: library/struct.rst:215 +#: library/struct.rst:230 msgid "``?``" msgstr "" -#: library/struct.rst:215 +#: library/struct.rst:230 msgid ":c:expr:`_Bool`" msgstr "" -#: library/struct.rst:215 +#: library/struct.rst:230 msgid "bool" msgstr "" -#: library/struct.rst:215 +#: library/struct.rst:230 msgid "\\(1)" msgstr "" -#: library/struct.rst:217 +#: library/struct.rst:232 msgid "``h``" msgstr "" -#: library/struct.rst:217 +#: library/struct.rst:232 msgid ":c:expr:`short`" msgstr "" -#: library/struct.rst:219 library/struct.rst:238 +#: library/struct.rst:234 library/struct.rst:253 msgid "2" msgstr "" -#: library/struct.rst:219 +#: library/struct.rst:234 msgid "``H``" msgstr "" -#: library/struct.rst:219 +#: library/struct.rst:234 msgid ":c:expr:`unsigned short`" msgstr "" -#: library/struct.rst:221 +#: library/struct.rst:236 msgid "``i``" msgstr "" -#: library/struct.rst:221 +#: library/struct.rst:236 msgid ":c:expr:`int`" msgstr "" -#: library/struct.rst:223 library/struct.rst:227 library/struct.rst:240 +#: library/struct.rst:238 library/struct.rst:242 library/struct.rst:255 msgid "4" msgstr "" -#: library/struct.rst:223 +#: library/struct.rst:238 msgid "``I``" msgstr "" -#: library/struct.rst:223 +#: library/struct.rst:238 msgid ":c:expr:`unsigned int`" msgstr "" -#: library/struct.rst:225 +#: library/struct.rst:240 msgid "``l``" msgstr "" -#: library/struct.rst:225 +#: library/struct.rst:240 msgid ":c:expr:`long`" msgstr "" -#: library/struct.rst:227 +#: library/struct.rst:242 msgid "``L``" msgstr "" -#: library/struct.rst:227 +#: library/struct.rst:242 msgid ":c:expr:`unsigned long`" msgstr "" -#: library/struct.rst:229 +#: library/struct.rst:244 msgid "``q``" msgstr "" -#: library/struct.rst:229 +#: library/struct.rst:244 msgid ":c:expr:`long long`" msgstr "" -#: library/struct.rst:231 library/struct.rst:242 +#: library/struct.rst:246 library/struct.rst:257 msgid "8" msgstr "" -#: library/struct.rst:231 +#: library/struct.rst:246 msgid "``Q``" msgstr "" -#: library/struct.rst:231 +#: library/struct.rst:246 msgid ":c:expr:`unsigned long long`" msgstr "" -#: library/struct.rst:234 +#: library/struct.rst:249 msgid "``n``" msgstr "" -#: library/struct.rst:234 +#: library/struct.rst:249 msgid ":c:type:`ssize_t`" msgstr "" -#: library/struct.rst:236 +#: library/struct.rst:251 msgid "\\(3)" msgstr "" -#: library/struct.rst:236 +#: library/struct.rst:251 msgid "``N``" msgstr "" -#: library/struct.rst:236 +#: library/struct.rst:251 msgid ":c:type:`size_t`" msgstr "" -#: library/struct.rst:238 +#: library/struct.rst:253 msgid "``e``" msgstr "" -#: library/struct.rst:238 +#: library/struct.rst:253 msgid "\\(6)" msgstr "" -#: library/struct.rst:240 library/struct.rst:242 +#: library/struct.rst:255 library/struct.rst:257 msgid "float" msgstr "" -#: library/struct.rst:240 library/struct.rst:242 +#: library/struct.rst:255 library/struct.rst:257 msgid "\\(4)" msgstr "" -#: library/struct.rst:240 +#: library/struct.rst:255 msgid "``f``" msgstr "" -#: library/struct.rst:240 +#: library/struct.rst:255 msgid ":c:expr:`float`" msgstr "" -#: library/struct.rst:242 +#: library/struct.rst:257 msgid "``d``" msgstr "" -#: library/struct.rst:242 +#: library/struct.rst:257 msgid ":c:expr:`double`" msgstr "" -#: library/struct.rst:244 +#: library/struct.rst:259 msgid "``s``" msgstr "" -#: library/struct.rst:246 +#: library/struct.rst:261 msgid ":c:expr:`char[]`" msgstr "" -#: library/struct.rst:246 +#: library/struct.rst:261 msgid "bytes" msgstr "" -#: library/struct.rst:244 +#: library/struct.rst:259 msgid "\\(9)" msgstr "" -#: library/struct.rst:246 +#: library/struct.rst:261 msgid "``p``" msgstr "" -#: library/struct.rst:246 +#: library/struct.rst:261 msgid "\\(8)" msgstr "" -#: library/struct.rst:248 +#: library/struct.rst:263 msgid "``P``" msgstr "" -#: library/struct.rst:248 +#: library/struct.rst:263 msgid ":c:expr:`void \\*`" msgstr "" -#: library/struct.rst:248 +#: library/struct.rst:263 msgid "\\(5)" msgstr "" -#: library/struct.rst:251 +#: library/struct.rst:266 msgid "Added support for the ``'n'`` and ``'N'`` formats." msgstr "" -#: library/struct.rst:254 +#: library/struct.rst:269 msgid "Added support for the ``'e'`` format." msgstr "" -#: library/struct.rst:263 +#: library/struct.rst:278 msgid "" "The ``'?'`` conversion code corresponds to the :c:expr:`_Bool` type defined " "by C99. If this type is not available, it is simulated using a :c:expr:" "`char`. In standard mode, it is always represented by one byte." msgstr "" -#: library/struct.rst:268 +#: library/struct.rst:283 msgid "" "When attempting to pack a non-integer using any of the integer conversion " "codes, if the non-integer has a :meth:`~object.__index__` method then that " "method is called to convert the argument to an integer before packing." msgstr "" -#: library/struct.rst:272 +#: library/struct.rst:287 msgid "Added use of the :meth:`~object.__index__` method for non-integers." msgstr "" -#: library/struct.rst:276 +#: library/struct.rst:291 msgid "" "The ``'n'`` and ``'N'`` conversion codes are only available for the native " "size (selected as the default or with the ``'@'`` byte order character). For " @@ -593,7 +611,7 @@ msgid "" "your application." msgstr "" -#: library/struct.rst:282 +#: library/struct.rst:297 msgid "" "For the ``'f'``, ``'d'`` and ``'e'`` conversion codes, the packed " "representation uses the IEEE 754 binary32, binary64 or binary16 format (for " @@ -601,7 +619,7 @@ msgid "" "format used by the platform." msgstr "" -#: library/struct.rst:288 +#: library/struct.rst:303 msgid "" "The ``'P'`` format character is only available for the native byte ordering " "(selected as the default or with the ``'@'`` byte order character). The byte " @@ -610,7 +628,7 @@ msgid "" "ordering, so the ``'P'`` format is not available." msgstr "" -#: library/struct.rst:295 +#: library/struct.rst:310 msgid "" "The IEEE 754 binary16 \"half precision\" type was introduced in the 2008 " "revision of the `IEEE 754 standard `_. It has a sign " @@ -622,11 +640,11 @@ msgid "" "format `_ for more information." msgstr "" -#: library/struct.rst:305 +#: library/struct.rst:320 msgid "When packing, ``'x'`` inserts one NUL byte." msgstr "" -#: library/struct.rst:308 +#: library/struct.rst:323 msgid "" "The ``'p'`` format character encodes a \"Pascal string\", meaning a short " "variable-length string stored in a *fixed number of bytes*, given by the " @@ -640,7 +658,7 @@ msgid "" "more than 255 bytes." msgstr "" -#: library/struct.rst:320 +#: library/struct.rst:335 msgid "" "For the ``'s'`` format character, the count is interpreted as the length of " "the bytes, not a repeat count like for the other format characters; for " @@ -655,19 +673,19 @@ msgid "" "(while ``'0c'`` means 0 characters)." msgstr "" -#: library/struct.rst:333 +#: library/struct.rst:348 msgid "" "A format character may be preceded by an integral repeat count. For " "example, the format string ``'4h'`` means exactly the same as ``'hhhh'``." msgstr "" -#: library/struct.rst:336 +#: library/struct.rst:351 msgid "" "Whitespace characters between formats are ignored; a count and its format " "must not contain whitespace though." msgstr "" -#: library/struct.rst:339 +#: library/struct.rst:354 msgid "" "When packing a value ``x`` using one of the integer formats (``'b'``, " "``'B'``, ``'h'``, ``'H'``, ``'i'``, ``'I'``, ``'l'``, ``'L'``, ``'q'``, " @@ -675,13 +693,13 @@ msgid "" "`struct.error` is raised." msgstr "" -#: library/struct.rst:344 +#: library/struct.rst:359 msgid "" "Previously, some of the integer formats wrapped out-of-range values and " "raised :exc:`DeprecationWarning` instead of :exc:`struct.error`." msgstr "" -#: library/struct.rst:350 +#: library/struct.rst:365 msgid "" "For the ``'?'`` format character, the return value is either :const:`True` " "or :const:`False`. When packing, the truth value of the argument object is " @@ -689,39 +707,39 @@ msgid "" "packed, and any non-zero value will be ``True`` when unpacking." msgstr "" -#: library/struct.rst:360 +#: library/struct.rst:375 msgid "Examples" msgstr "" -#: library/struct.rst:363 +#: library/struct.rst:378 msgid "" "Native byte order examples (designated by the ``'@'`` format prefix or lack " "of any prefix character) may not match what the reader's machine produces as " "that depends on the platform and compiler." msgstr "" -#: library/struct.rst:368 +#: library/struct.rst:383 msgid "" "Pack and unpack integers of three different sizes, using big endian " "ordering::" msgstr "" -#: library/struct.rst:379 +#: library/struct.rst:394 msgid "Attempt to pack an integer which is too large for the defined field::" msgstr "" -#: library/struct.rst:386 +#: library/struct.rst:401 msgid "" "Demonstrate the difference between ``'s'`` and ``'c'`` format characters::" msgstr "" -#: library/struct.rst:394 +#: library/struct.rst:409 msgid "" "Unpacked fields can be named by assigning them to variables or by wrapping " "the result in a named tuple::" msgstr "" -#: library/struct.rst:405 +#: library/struct.rst:420 msgid "" "The ordering of format characters may have an impact on size in native mode " "since padding is implicit. In standard mode, the user is responsible for " @@ -731,41 +749,41 @@ msgid "" "a little endian machine::" msgstr "" -#: library/struct.rst:422 +#: library/struct.rst:437 msgid "" "The following format ``'llh0l'`` results in two pad bytes being added at the " "end, assuming the platform's longs are aligned on 4-byte boundaries::" msgstr "" -#: library/struct.rst:432 +#: library/struct.rst:447 msgid "Module :mod:`array`" msgstr "" -#: library/struct.rst:432 +#: library/struct.rst:447 msgid "Packed binary storage of homogeneous data." msgstr "" -#: library/struct.rst:435 +#: library/struct.rst:450 msgid "Module :mod:`json`" msgstr "" -#: library/struct.rst:435 +#: library/struct.rst:450 msgid "JSON encoder and decoder." msgstr "" -#: library/struct.rst:437 +#: library/struct.rst:452 msgid "Module :mod:`pickle`" msgstr "" -#: library/struct.rst:438 +#: library/struct.rst:453 msgid "Python object serialization." msgstr "" -#: library/struct.rst:444 +#: library/struct.rst:459 msgid "Applications" msgstr "" -#: library/struct.rst:446 +#: library/struct.rst:461 msgid "" "Two main applications for the :mod:`struct` module exist, data interchange " "between Python and C code within an application or another application " @@ -775,11 +793,11 @@ msgid "" "speaking, the format strings constructed for these two domains are distinct." msgstr "" -#: library/struct.rst:457 +#: library/struct.rst:472 msgid "Native Formats" msgstr "" -#: library/struct.rst:459 +#: library/struct.rst:474 msgid "" "When constructing format strings which mimic native layouts, the compiler " "and machine architecture determine byte ordering and padding. In such cases, " @@ -790,35 +808,35 @@ msgid "" "of consecutive chunks of data." msgstr "" -#: library/struct.rst:467 +#: library/struct.rst:482 msgid "" "Consider these two simple examples (on a 64-bit, little-endian machine)::" msgstr "" -#: library/struct.rst:475 +#: library/struct.rst:490 msgid "" "Data is not padded to an 8-byte boundary at the end of the second format " "string without the use of extra padding. A zero-repeat format code solves " "that problem::" msgstr "" -#: library/struct.rst:482 +#: library/struct.rst:497 msgid "" "The ``'x'`` format code can be used to specify the repeat, but for native " "formats it is better to use a zero-repeat format like ``'0l'``." msgstr "" -#: library/struct.rst:485 +#: library/struct.rst:500 msgid "" "By default, native byte ordering and alignment is used, but it is better to " "be explicit and use the ``'@'`` prefix character." msgstr "" -#: library/struct.rst:492 +#: library/struct.rst:507 msgid "Standard Formats" msgstr "" -#: library/struct.rst:494 +#: library/struct.rst:509 msgid "" "When exchanging data beyond your process such as networking or storage, be " "precise. Specify the exact byte order, size, and alignment. Do not assume " @@ -832,22 +850,22 @@ msgid "" "from the previous section, we have::" msgstr "" -#: library/struct.rst:521 +#: library/struct.rst:536 msgid "" "The above results (executed on a 64-bit machine) aren't guaranteed to match " "when executed on different machines. For example, the examples below were " "executed on a 32-bit machine::" msgstr "" -#: library/struct.rst:536 +#: library/struct.rst:551 msgid "Classes" msgstr "" -#: library/struct.rst:538 +#: library/struct.rst:553 msgid "The :mod:`struct` module also defines the following type:" msgstr "" -#: library/struct.rst:543 +#: library/struct.rst:558 msgid "" "Return a new Struct object which writes and reads binary data according to " "the format string *format*. Creating a ``Struct`` object once and calling " @@ -855,55 +873,55 @@ msgid "" "same format since the format string is only compiled once." msgstr "" -#: library/struct.rst:550 +#: library/struct.rst:565 msgid "" "The compiled versions of the most recent format strings passed to the module-" "level functions are cached, so programs that use only a few format strings " "needn't worry about reusing a single :class:`Struct` instance." msgstr "" -#: library/struct.rst:555 +#: library/struct.rst:570 msgid "Compiled Struct objects support the following methods and attributes:" msgstr "" -#: library/struct.rst:559 +#: library/struct.rst:574 msgid "" "Identical to the :func:`pack` function, using the compiled format. " "(``len(result)`` will equal :attr:`size`.)" msgstr "" -#: library/struct.rst:565 +#: library/struct.rst:580 msgid "Identical to the :func:`pack_into` function, using the compiled format." msgstr "" -#: library/struct.rst:570 +#: library/struct.rst:585 msgid "" "Identical to the :func:`unpack` function, using the compiled format. The " "buffer's size in bytes must equal :attr:`size`." msgstr "" -#: library/struct.rst:576 +#: library/struct.rst:591 msgid "" "Identical to the :func:`unpack_from` function, using the compiled format. " "The buffer's size in bytes, starting at position *offset*, must be at least :" "attr:`size`." msgstr "" -#: library/struct.rst:583 +#: library/struct.rst:598 msgid "" "Identical to the :func:`iter_unpack` function, using the compiled format. " "The buffer's size in bytes must be a multiple of :attr:`size`." msgstr "" -#: library/struct.rst:590 +#: library/struct.rst:605 msgid "The format string used to construct this Struct object." msgstr "" -#: library/struct.rst:592 +#: library/struct.rst:607 msgid "The format string type is now :class:`str` instead of :class:`bytes`." msgstr "" -#: library/struct.rst:597 +#: library/struct.rst:612 msgid "" "The calculated size of the struct (and hence of the bytes object produced by " "the :meth:`pack` method) corresponding to :attr:`format`." @@ -933,7 +951,7 @@ msgstr "" msgid "@ (at)" msgstr "" -#: library/struct.rst:261 library/struct.rst:348 +#: library/struct.rst:276 library/struct.rst:363 msgid "in struct format strings" msgstr "" @@ -953,6 +971,6 @@ msgstr "" msgid "! (exclamation)" msgstr "" -#: library/struct.rst:348 +#: library/struct.rst:363 msgid "? (question mark)" msgstr "" diff --git a/library/subprocess.po b/library/subprocess.po index 0a1319403..d06097191 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -149,8 +149,8 @@ msgid "" "*universal_newlines*. Added the *capture_output* parameter." msgstr "" -#: library/subprocess.rst:503 library/subprocess.rst:1226 -#: library/subprocess.rst:1289 +#: library/subprocess.rst:503 library/subprocess.rst:1227 +#: library/subprocess.rst:1290 msgid "" "Changed Windows shell search order for ``shell=True``. The current directory " "and ``%PATH%`` are replaced with ``%COMSPEC%`` and ``%SystemRoot%" @@ -174,7 +174,7 @@ msgid "" "that it ran successfully." msgstr "" -#: library/subprocess.rst:933 +#: library/subprocess.rst:934 msgid "" "A negative value ``-N`` indicates that the child was terminated by signal " "``N`` (POSIX only)." @@ -351,8 +351,8 @@ msgid "" "binary streams. No encoding or line ending conversion is performed." msgstr "" -#: library/subprocess.rst:311 -msgid "Added *encoding* and *errors* parameters." +#: library/subprocess.rst:1542 library/subprocess.rst:1560 +msgid "Added the *encoding* and *errors* parameters." msgstr "" #: library/subprocess.rst:314 @@ -790,66 +790,69 @@ msgstr "" msgid "*encoding* and *errors* were added." msgstr "" -#: library/subprocess.rst:1284 +#: library/subprocess.rst:1285 msgid "*text* was added as a more readable alias for *universal_newlines*." msgstr "" #: library/subprocess.rst:665 msgid "" "If given, *startupinfo* will be a :class:`STARTUPINFO` object, which is " -"passed to the underlying ``CreateProcess`` function. *creationflags*, if " -"given, can be one or more of the following flags:" +"passed to the underlying ``CreateProcess`` function." msgstr "" -#: library/subprocess.rst:669 -msgid ":data:`CREATE_NEW_CONSOLE`" +#: library/subprocess.rst:668 +msgid "If given, *creationflags*, can be one or more of the following flags:" msgstr "" #: library/subprocess.rst:670 -msgid ":data:`CREATE_NEW_PROCESS_GROUP`" +msgid ":data:`CREATE_NEW_CONSOLE`" msgstr "" #: library/subprocess.rst:671 -msgid ":data:`ABOVE_NORMAL_PRIORITY_CLASS`" +msgid ":data:`CREATE_NEW_PROCESS_GROUP`" msgstr "" #: library/subprocess.rst:672 -msgid ":data:`BELOW_NORMAL_PRIORITY_CLASS`" +msgid ":data:`ABOVE_NORMAL_PRIORITY_CLASS`" msgstr "" #: library/subprocess.rst:673 -msgid ":data:`HIGH_PRIORITY_CLASS`" +msgid ":data:`BELOW_NORMAL_PRIORITY_CLASS`" msgstr "" #: library/subprocess.rst:674 -msgid ":data:`IDLE_PRIORITY_CLASS`" +msgid ":data:`HIGH_PRIORITY_CLASS`" msgstr "" #: library/subprocess.rst:675 -msgid ":data:`NORMAL_PRIORITY_CLASS`" +msgid ":data:`IDLE_PRIORITY_CLASS`" msgstr "" #: library/subprocess.rst:676 -msgid ":data:`REALTIME_PRIORITY_CLASS`" +msgid ":data:`NORMAL_PRIORITY_CLASS`" msgstr "" #: library/subprocess.rst:677 -msgid ":data:`CREATE_NO_WINDOW`" +msgid ":data:`REALTIME_PRIORITY_CLASS`" msgstr "" #: library/subprocess.rst:678 -msgid ":data:`DETACHED_PROCESS`" +msgid ":data:`CREATE_NO_WINDOW`" msgstr "" #: library/subprocess.rst:679 -msgid ":data:`CREATE_DEFAULT_ERROR_MODE`" +msgid ":data:`DETACHED_PROCESS`" msgstr "" #: library/subprocess.rst:680 +msgid ":data:`CREATE_DEFAULT_ERROR_MODE`" +msgstr "" + +#: library/subprocess.rst:681 msgid ":data:`CREATE_BREAKAWAY_FROM_JOB`" msgstr "" -#: library/subprocess.rst:682 +#: library/subprocess.rst:683 msgid "" "*pipesize* can be used to change the size of the pipe when :data:`PIPE` is " "used for *stdin*, *stdout* or *stderr*. The size of the pipe is only changed " @@ -857,24 +860,24 @@ msgid "" "platforms will ignore this parameter." msgstr "" -#: library/subprocess.rst:687 -msgid "The ``pipesize`` parameter was added." +#: library/subprocess.rst:688 +msgid "Added the *pipesize* parameter." msgstr "" -#: library/subprocess.rst:690 +#: library/subprocess.rst:691 msgid "" "Popen objects are supported as context managers via the :keyword:`with` " "statement: on exit, standard file descriptors are closed, and the process is " "waited for. ::" msgstr "" -#: library/subprocess.rst:706 +#: library/subprocess.rst:709 msgid "" "Raises an :ref:`auditing event ` ``subprocess.Popen`` with " "arguments ``executable``, ``args``, ``cwd``, ``env``." msgstr "" -#: library/subprocess.rst:699 +#: library/subprocess.rst:700 msgid "" "Popen and the other functions in this module that use it raise an :ref:" "`auditing event ` ``subprocess.Popen`` with arguments " @@ -882,17 +885,17 @@ msgid "" "be a single string or a list of strings, depending on platform." msgstr "" -#: library/subprocess.rst:704 +#: library/subprocess.rst:705 msgid "Added context manager support." msgstr "" -#: library/subprocess.rst:707 +#: library/subprocess.rst:708 msgid "" "Popen destructor now emits a :exc:`ResourceWarning` warning if the child " "process is still running." msgstr "" -#: library/subprocess.rst:711 +#: library/subprocess.rst:712 msgid "" "Popen can use :func:`os.posix_spawn` in some cases for better performance. " "On Windows Subsystem for Linux and QEMU User Emulation, Popen constructor " @@ -901,17 +904,17 @@ msgid "" "returncode`." msgstr "" -#: library/subprocess.rst:720 +#: library/subprocess.rst:721 msgid "Exceptions" msgstr "" -#: library/subprocess.rst:722 +#: library/subprocess.rst:723 msgid "" "Exceptions raised in the child process, before the new program has started " "to execute, will be re-raised in the parent." msgstr "" -#: library/subprocess.rst:725 +#: library/subprocess.rst:726 msgid "" "The most common exception raised is :exc:`OSError`. This occurs, for " "example, when trying to execute a non-existent file. Applications should " @@ -922,39 +925,39 @@ msgid "" "subprocess." msgstr "" -#: library/subprocess.rst:732 +#: library/subprocess.rst:733 msgid "" "A :exc:`ValueError` will be raised if :class:`Popen` is called with invalid " "arguments." msgstr "" -#: library/subprocess.rst:735 +#: library/subprocess.rst:736 msgid "" ":func:`check_call` and :func:`check_output` will raise :exc:" "`CalledProcessError` if the called process returns a non-zero return code." msgstr "" -#: library/subprocess.rst:739 +#: library/subprocess.rst:740 msgid "" "All of the functions and methods that accept a *timeout* parameter, such as :" "func:`run` and :meth:`Popen.communicate` will raise :exc:`TimeoutExpired` if " "the timeout expires before the process exits." msgstr "" -#: library/subprocess.rst:743 +#: library/subprocess.rst:744 msgid "" "Exceptions defined in this module all inherit from :exc:`SubprocessError`." msgstr "" -#: library/subprocess.rst:745 +#: library/subprocess.rst:746 msgid "The :exc:`SubprocessError` base class was added." msgstr "" -#: library/subprocess.rst:751 +#: library/subprocess.rst:752 msgid "Security Considerations" msgstr "" -#: library/subprocess.rst:753 +#: library/subprocess.rst:754 msgid "" "Unlike some other popen functions, this implementation will never implicitly " "call a system shell. This means that all characters, including shell " @@ -967,34 +970,34 @@ msgid "" "escaping." msgstr "" -#: library/subprocess.rst:765 +#: library/subprocess.rst:766 msgid "Popen Objects" msgstr "" -#: library/subprocess.rst:767 +#: library/subprocess.rst:768 msgid "Instances of the :class:`Popen` class have the following methods:" msgstr "" -#: library/subprocess.rst:772 +#: library/subprocess.rst:773 msgid "" "Check if child process has terminated. Set and return :attr:`~Popen." "returncode` attribute. Otherwise, returns ``None``." msgstr "" -#: library/subprocess.rst:778 +#: library/subprocess.rst:779 msgid "" "Wait for child process to terminate. Set and return :attr:`~Popen." "returncode` attribute." msgstr "" -#: library/subprocess.rst:781 +#: library/subprocess.rst:782 msgid "" "If the process does not terminate after *timeout* seconds, raise a :exc:" "`TimeoutExpired` exception. It is safe to catch this exception and retry " "the wait." msgstr "" -#: library/subprocess.rst:787 +#: library/subprocess.rst:788 msgid "" "This will deadlock when using ``stdout=PIPE`` or ``stderr=PIPE`` and the " "child process generates enough output to a pipe such that it blocks waiting " @@ -1002,7 +1005,7 @@ msgid "" "when using pipes to avoid that." msgstr "" -#: library/subprocess.rst:794 +#: library/subprocess.rst:795 msgid "" "When the ``timeout`` parameter is not ``None``, then (on POSIX) the function " "is implemented using a busy loop (non-blocking call and short sleeps). Use " @@ -1010,12 +1013,12 @@ msgid "" "create_subprocess_exec`." msgstr "" -#: library/subprocess.rst:840 library/subprocess.rst:1221 -#: library/subprocess.rst:1275 +#: library/subprocess.rst:841 library/subprocess.rst:1222 +#: library/subprocess.rst:1276 msgid "*timeout* was added." msgstr "" -#: library/subprocess.rst:804 +#: library/subprocess.rst:805 msgid "" "Interact with process: Send data to stdin. Read data from stdout and " "stderr, until end-of-file is reached. Wait for process to terminate and set " @@ -1025,13 +1028,13 @@ msgid "" "must be a string. Otherwise, it must be bytes." msgstr "" -#: library/subprocess.rst:811 +#: library/subprocess.rst:812 msgid "" ":meth:`communicate` returns a tuple ``(stdout_data, stderr_data)``. The data " "will be strings if streams were opened in text mode; otherwise, bytes." msgstr "" -#: library/subprocess.rst:815 +#: library/subprocess.rst:816 msgid "" "Note that if you want to send data to the process's stdin, you need to " "create the Popen object with ``stdin=PIPE``. Similarly, to get anything " @@ -1039,67 +1042,67 @@ msgid "" "and/or ``stderr=PIPE`` too." msgstr "" -#: library/subprocess.rst:820 +#: library/subprocess.rst:821 msgid "" "If the process does not terminate after *timeout* seconds, a :exc:" "`TimeoutExpired` exception will be raised. Catching this exception and " "retrying communication will not lose any output." msgstr "" -#: library/subprocess.rst:824 +#: library/subprocess.rst:825 msgid "" "The child process is not killed if the timeout expires, so in order to " "cleanup properly a well-behaved application should kill the child process " "and finish communication::" msgstr "" -#: library/subprocess.rst:837 +#: library/subprocess.rst:838 msgid "" "The data read is buffered in memory, so do not use this method if the data " "size is large or unlimited." msgstr "" -#: library/subprocess.rst:846 +#: library/subprocess.rst:847 msgid "Sends the signal *signal* to the child." msgstr "" -#: library/subprocess.rst:848 +#: library/subprocess.rst:849 msgid "Do nothing if the process completed." msgstr "" -#: library/subprocess.rst:852 +#: library/subprocess.rst:853 msgid "" "On Windows, SIGTERM is an alias for :meth:`terminate`. CTRL_C_EVENT and " "CTRL_BREAK_EVENT can be sent to processes started with a *creationflags* " "parameter which includes ``CREATE_NEW_PROCESS_GROUP``." msgstr "" -#: library/subprocess.rst:859 +#: library/subprocess.rst:860 msgid "" -"Stop the child. On POSIX OSs the method sends SIGTERM to the child. On " -"Windows the Win32 API function :c:func:`TerminateProcess` is called to stop " -"the child." +"Stop the child. On POSIX OSs the method sends :py:const:`~signal.SIGTERM` to " +"the child. On Windows the Win32 API function :c:func:`!TerminateProcess` is " +"called to stop the child." msgstr "" -#: library/subprocess.rst:866 +#: library/subprocess.rst:867 msgid "" "Kills the child. On POSIX OSs the function sends SIGKILL to the child. On " "Windows :meth:`kill` is an alias for :meth:`terminate`." msgstr "" -#: library/subprocess.rst:870 +#: library/subprocess.rst:871 msgid "" "The following attributes are also set by the class for you to access. " "Reassigning them to new values is unsupported:" msgstr "" -#: library/subprocess.rst:875 +#: library/subprocess.rst:876 msgid "" "The *args* argument as it was passed to :class:`Popen` -- a sequence of " "program arguments or else a single string." msgstr "" -#: library/subprocess.rst:882 +#: library/subprocess.rst:883 msgid "" "If the *stdin* argument was :data:`PIPE`, this attribute is a writeable " "stream object as returned by :func:`open`. If the *encoding* or *errors* " @@ -1108,7 +1111,7 @@ msgid "" "*stdin* argument was not :data:`PIPE`, this attribute is ``None``." msgstr "" -#: library/subprocess.rst:891 +#: library/subprocess.rst:892 msgid "" "If the *stdout* argument was :data:`PIPE`, this attribute is a readable " "stream object as returned by :func:`open`. Reading from the stream provides " @@ -1118,7 +1121,7 @@ msgid "" "argument was not :data:`PIPE`, this attribute is ``None``." msgstr "" -#: library/subprocess.rst:901 +#: library/subprocess.rst:902 msgid "" "If the *stderr* argument was :data:`PIPE`, this attribute is a readable " "stream object as returned by :func:`open`. Reading from the stream provides " @@ -1128,7 +1131,7 @@ msgid "" "argument was not :data:`PIPE`, this attribute is ``None``." msgstr "" -#: library/subprocess.rst:910 +#: library/subprocess.rst:911 msgid "" "Use :meth:`~Popen.communicate` rather than :attr:`.stdin.write `, :attr:`.stdout.read ` or :attr:`.stderr.read `__ structure is used for :class:`Popen` " @@ -1177,38 +1180,38 @@ msgid "" "only arguments." msgstr "" -#: library/subprocess.rst:951 +#: library/subprocess.rst:952 msgid "Keyword-only argument support was added." msgstr "" -#: library/subprocess.rst:956 +#: library/subprocess.rst:957 msgid "" "A bit field that determines whether certain :class:`STARTUPINFO` attributes " "are used when the process creates a window. ::" msgstr "" -#: library/subprocess.rst:964 +#: library/subprocess.rst:965 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute is " "the standard input handle for the process. If :data:`STARTF_USESTDHANDLES` " "is not specified, the default for standard input is the keyboard buffer." msgstr "" -#: library/subprocess.rst:971 +#: library/subprocess.rst:972 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute is " "the standard output handle for the process. Otherwise, this attribute is " "ignored and the default for standard output is the console window's buffer." msgstr "" -#: library/subprocess.rst:978 +#: library/subprocess.rst:979 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute is " "the standard error handle for the process. Otherwise, this attribute is " "ignored and the default for standard error is the console window's buffer." msgstr "" -#: library/subprocess.rst:984 +#: library/subprocess.rst:985 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESHOWWINDOW`, this attribute " "can be any of the values that can be specified in the ``nCmdShow`` parameter " @@ -1217,34 +1220,34 @@ msgid "" "Otherwise, this attribute is ignored." msgstr "" -#: library/subprocess.rst:991 +#: library/subprocess.rst:992 msgid "" ":data:`SW_HIDE` is provided for this attribute. It is used when :class:" "`Popen` is called with ``shell=True``." msgstr "" -#: library/subprocess.rst:996 +#: library/subprocess.rst:997 msgid "" "A dictionary of additional attributes for process creation as given in " "``STARTUPINFOEX``, see `UpdateProcThreadAttribute `__." msgstr "" -#: library/subprocess.rst:1000 +#: library/subprocess.rst:1001 msgid "Supported attributes:" msgstr "" -#: library/subprocess.rst:1018 +#: library/subprocess.rst:1019 msgid "**handle_list**" msgstr "" -#: library/subprocess.rst:1003 +#: library/subprocess.rst:1004 msgid "" "Sequence of handles that will be inherited. *close_fds* must be true if non-" "empty." msgstr "" -#: library/subprocess.rst:1006 +#: library/subprocess.rst:1007 msgid "" "The handles must be temporarily made inheritable by :func:`os." "set_handle_inheritable` when passed to the :class:`Popen` constructor, else :" @@ -1252,7 +1255,7 @@ msgid "" "``ERROR_INVALID_PARAMETER`` (87)." msgstr "" -#: library/subprocess.rst:1013 +#: library/subprocess.rst:1014 msgid "" "In a multithreaded process, use caution to avoid leaking handles that are " "marked inheritable when combining this feature with concurrent calls to " @@ -1261,97 +1264,97 @@ msgid "" "temporarily creates inheritable handles." msgstr "" -#: library/subprocess.rst:1023 +#: library/subprocess.rst:1024 msgid "Windows Constants" msgstr "" -#: library/subprocess.rst:1025 +#: library/subprocess.rst:1026 msgid "The :mod:`subprocess` module exposes the following constants." msgstr "" -#: library/subprocess.rst:1029 +#: library/subprocess.rst:1030 msgid "" "The standard input device. Initially, this is the console input buffer, " "``CONIN$``." msgstr "" -#: library/subprocess.rst:1034 +#: library/subprocess.rst:1035 msgid "" "The standard output device. Initially, this is the active console screen " "buffer, ``CONOUT$``." msgstr "" -#: library/subprocess.rst:1039 +#: library/subprocess.rst:1040 msgid "" "The standard error device. Initially, this is the active console screen " "buffer, ``CONOUT$``." msgstr "" -#: library/subprocess.rst:1044 +#: library/subprocess.rst:1045 msgid "Hides the window. Another window will be activated." msgstr "" -#: library/subprocess.rst:1048 +#: library/subprocess.rst:1049 msgid "" "Specifies that the :attr:`STARTUPINFO.hStdInput`, :attr:`STARTUPINFO." "hStdOutput`, and :attr:`STARTUPINFO.hStdError` attributes contain additional " "information." msgstr "" -#: library/subprocess.rst:1054 +#: library/subprocess.rst:1055 msgid "" "Specifies that the :attr:`STARTUPINFO.wShowWindow` attribute contains " "additional information." msgstr "" -#: library/subprocess.rst:1059 +#: library/subprocess.rst:1060 msgid "" "The new process has a new console, instead of inheriting its parent's " "console (the default)." msgstr "" -#: library/subprocess.rst:1064 +#: library/subprocess.rst:1065 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "group will be created. This flag is necessary for using :func:`os.kill` on " "the subprocess." msgstr "" -#: library/subprocess.rst:1068 +#: library/subprocess.rst:1069 msgid "This flag is ignored if :data:`CREATE_NEW_CONSOLE` is specified." msgstr "" -#: library/subprocess.rst:1072 +#: library/subprocess.rst:1073 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will have an above average priority." msgstr "" -#: library/subprocess.rst:1079 +#: library/subprocess.rst:1080 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will have a below average priority." msgstr "" -#: library/subprocess.rst:1086 +#: library/subprocess.rst:1087 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will have a high priority." msgstr "" -#: library/subprocess.rst:1093 +#: library/subprocess.rst:1094 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will have an idle (lowest) priority." msgstr "" -#: library/subprocess.rst:1100 +#: library/subprocess.rst:1101 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will have an normal priority. (default)" msgstr "" -#: library/subprocess.rst:1107 +#: library/subprocess.rst:1108 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will have realtime priority. You should almost never use " @@ -1361,20 +1364,20 @@ msgid "" "perform brief tasks that should have limited interruptions." msgstr "" -#: library/subprocess.rst:1118 +#: library/subprocess.rst:1119 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will not create a window." msgstr "" -#: library/subprocess.rst:1125 +#: library/subprocess.rst:1126 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "will not inherit its parent's console. This value cannot be used with " "CREATE_NEW_CONSOLE." msgstr "" -#: library/subprocess.rst:1133 +#: library/subprocess.rst:1134 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "does not inherit the error mode of the calling process. Instead, the new " @@ -1382,39 +1385,39 @@ msgid "" "multithreaded shell applications that run with hard errors disabled." msgstr "" -#: library/subprocess.rst:1143 +#: library/subprocess.rst:1144 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "is not associated with the job." msgstr "" -#: library/subprocess.rst:1151 +#: library/subprocess.rst:1152 msgid "Older high-level API" msgstr "" -#: library/subprocess.rst:1153 +#: library/subprocess.rst:1154 msgid "" "Prior to Python 3.5, these three functions comprised the high level API to " "subprocess. You can now use :func:`run` in many cases, but lots of existing " "code calls these functions." msgstr "" -#: library/subprocess.rst:1160 +#: library/subprocess.rst:1161 msgid "" "Run the command described by *args*. Wait for command to complete, then " "return the :attr:`~Popen.returncode` attribute." msgstr "" -#: library/subprocess.rst:1203 +#: library/subprocess.rst:1204 msgid "" "Code needing to capture stdout or stderr should use :func:`run` instead::" msgstr "" -#: library/subprocess.rst:1207 +#: library/subprocess.rst:1208 msgid "To suppress stdout or stderr, supply a value of :data:`DEVNULL`." msgstr "" -#: library/subprocess.rst:1209 +#: library/subprocess.rst:1210 msgid "" "The arguments shown above are merely some common ones. The full function " "signature is the same as that of the :class:`Popen` constructor - this " @@ -1422,14 +1425,14 @@ msgid "" "to that interface." msgstr "" -#: library/subprocess.rst:1216 +#: library/subprocess.rst:1217 msgid "" "Do not use ``stdout=PIPE`` or ``stderr=PIPE`` with this function. The child " "process will block if it generates enough output to a pipe to fill up the OS " "pipe buffer as the pipes are not being read from." msgstr "" -#: library/subprocess.rst:1196 +#: library/subprocess.rst:1197 msgid "" "Run command with arguments. Wait for command to complete. If the return " "code was zero then return, otherwise raise :exc:`CalledProcessError`. The :" @@ -1438,11 +1441,11 @@ msgid "" "to start the process it will propagate the exception that was raised." msgstr "" -#: library/subprocess.rst:1238 +#: library/subprocess.rst:1239 msgid "Run command with arguments and return its output." msgstr "" -#: library/subprocess.rst:1240 +#: library/subprocess.rst:1241 msgid "" "If the return code was non-zero it raises a :exc:`CalledProcessError`. The :" "exc:`CalledProcessError` object will have the return code in the :attr:" @@ -1450,11 +1453,11 @@ msgid "" "`~CalledProcessError.output` attribute." msgstr "" -#: library/subprocess.rst:1245 +#: library/subprocess.rst:1246 msgid "This is equivalent to::" msgstr "" -#: library/subprocess.rst:1249 +#: library/subprocess.rst:1250 msgid "" "The arguments shown above are merely some common ones. The full function " "signature is largely the same as that of :func:`run` - most arguments are " @@ -1464,52 +1467,52 @@ msgid "" "using the parent's standard input file handle." msgstr "" -#: library/subprocess.rst:1256 +#: library/subprocess.rst:1257 msgid "" "By default, this function will return the data as encoded bytes. The actual " "encoding of the output data may depend on the command being invoked, so the " "decoding to text will often need to be handled at the application level." msgstr "" -#: library/subprocess.rst:1260 +#: library/subprocess.rst:1261 msgid "" "This behaviour may be overridden by setting *text*, *encoding*, *errors*, or " "*universal_newlines* to ``True`` as described in :ref:`frequently-used-" "arguments` and :func:`run`." msgstr "" -#: library/subprocess.rst:1264 +#: library/subprocess.rst:1265 msgid "" "To also capture standard error in the result, use ``stderr=subprocess." "STDOUT``::" msgstr "" -#: library/subprocess.rst:1278 +#: library/subprocess.rst:1279 msgid "Support for the *input* keyword argument was added." msgstr "" -#: library/subprocess.rst:1281 +#: library/subprocess.rst:1282 msgid "*encoding* and *errors* were added. See :func:`run` for details." msgstr "" -#: library/subprocess.rst:1299 +#: library/subprocess.rst:1300 msgid "Replacing Older Functions with the :mod:`subprocess` Module" msgstr "" -#: library/subprocess.rst:1301 +#: library/subprocess.rst:1302 msgid "" "In this section, \"a becomes b\" means that b can be used as a replacement " "for a." msgstr "" -#: library/subprocess.rst:1305 +#: library/subprocess.rst:1306 msgid "" "All \"a\" functions in this section fail (more or less) silently if the " "executed program cannot be found; the \"b\" replacements raise :exc:" "`OSError` instead." msgstr "" -#: library/subprocess.rst:1309 +#: library/subprocess.rst:1310 msgid "" "In addition, the replacements using :func:`check_output` will fail with a :" "exc:`CalledProcessError` if the requested operation produces a non-zero " @@ -1517,133 +1520,133 @@ msgid "" "output` attribute of the raised exception." msgstr "" -#: library/subprocess.rst:1314 +#: library/subprocess.rst:1315 msgid "" "In the following examples, we assume that the relevant functions have " "already been imported from the :mod:`subprocess` module." msgstr "" -#: library/subprocess.rst:1319 +#: library/subprocess.rst:1320 msgid "Replacing :program:`/bin/sh` shell command substitution" msgstr "" -#: library/subprocess.rst:1336 library/subprocess.rst:1353 +#: library/subprocess.rst:1337 library/subprocess.rst:1354 msgid "becomes::" msgstr "" -#: library/subprocess.rst:1330 +#: library/subprocess.rst:1331 msgid "Replacing shell pipeline" msgstr "" -#: library/subprocess.rst:1343 +#: library/subprocess.rst:1344 msgid "" "The ``p1.stdout.close()`` call after starting the p2 is important in order " "for p1 to receive a SIGPIPE if p2 exits before p1." msgstr "" -#: library/subprocess.rst:1346 +#: library/subprocess.rst:1347 msgid "" "Alternatively, for trusted input, the shell's own pipeline support may still " "be used directly:" msgstr "" -#: library/subprocess.rst:1359 +#: library/subprocess.rst:1360 msgid "Replacing :func:`os.system`" msgstr "" -#: library/subprocess.rst:1367 +#: library/subprocess.rst:1368 msgid "Notes:" msgstr "" -#: library/subprocess.rst:1369 +#: library/subprocess.rst:1370 msgid "Calling the program through the shell is usually not required." msgstr "" -#: library/subprocess.rst:1370 +#: library/subprocess.rst:1371 msgid "" "The :func:`call` return value is encoded differently to that of :func:`os." "system`." msgstr "" -#: library/subprocess.rst:1373 +#: library/subprocess.rst:1374 msgid "" "The :func:`os.system` function ignores SIGINT and SIGQUIT signals while the " "command is running, but the caller must do this separately when using the :" "mod:`subprocess` module." msgstr "" -#: library/subprocess.rst:1377 +#: library/subprocess.rst:1378 msgid "A more realistic example would look like this::" msgstr "" -#: library/subprocess.rst:1390 +#: library/subprocess.rst:1391 msgid "Replacing the :func:`os.spawn ` family" msgstr "" -#: library/subprocess.rst:1392 +#: library/subprocess.rst:1393 msgid "P_NOWAIT example::" msgstr "" -#: library/subprocess.rst:1398 +#: library/subprocess.rst:1399 msgid "P_WAIT example::" msgstr "" -#: library/subprocess.rst:1404 +#: library/subprocess.rst:1405 msgid "Vector example::" msgstr "" -#: library/subprocess.rst:1410 +#: library/subprocess.rst:1411 msgid "Environment example::" msgstr "" -#: library/subprocess.rst:1419 +#: library/subprocess.rst:1420 msgid "Replacing :func:`os.popen`, :func:`os.popen2`, :func:`os.popen3`" msgstr "" -#: library/subprocess.rst:1449 +#: library/subprocess.rst:1450 msgid "Return code handling translates as follows::" msgstr "" -#: library/subprocess.rst:1465 -msgid "Replacing functions from the :mod:`popen2` module" +#: library/subprocess.rst:1466 +msgid "Replacing functions from the :mod:`!popen2` module" msgstr "" -#: library/subprocess.rst:1469 +#: library/subprocess.rst:1470 msgid "" "If the cmd argument to popen2 functions is a string, the command is executed " "through /bin/sh. If it is a list, the command is directly executed." msgstr "" -#: library/subprocess.rst:1488 +#: library/subprocess.rst:1489 msgid "" ":class:`popen2.Popen3` and :class:`popen2.Popen4` basically work as :class:" "`subprocess.Popen`, except that:" msgstr "" -#: library/subprocess.rst:1491 +#: library/subprocess.rst:1492 msgid ":class:`Popen` raises an exception if the execution fails." msgstr "" -#: library/subprocess.rst:1493 +#: library/subprocess.rst:1494 msgid "The *capturestderr* argument is replaced with the *stderr* argument." msgstr "" -#: library/subprocess.rst:1495 +#: library/subprocess.rst:1496 msgid "``stdin=PIPE`` and ``stdout=PIPE`` must be specified." msgstr "" -#: library/subprocess.rst:1497 +#: library/subprocess.rst:1498 msgid "" "popen2 closes all file descriptors by default, but you have to specify " "``close_fds=True`` with :class:`Popen` to guarantee this behavior on all " "platforms or past Python versions." msgstr "" -#: library/subprocess.rst:1503 +#: library/subprocess.rst:1504 msgid "Legacy Shell Invocation Functions" msgstr "" -#: library/subprocess.rst:1505 +#: library/subprocess.rst:1506 msgid "" "This module also provides the following legacy functions from the 2.x " "``commands`` module. These operations implicitly invoke the system shell and " @@ -1651,11 +1654,11 @@ msgid "" "handling consistency are valid for these functions." msgstr "" -#: library/subprocess.rst:1512 +#: library/subprocess.rst:1513 msgid "Return ``(exitcode, output)`` of executing *cmd* in a shell." msgstr "" -#: library/subprocess.rst:1514 +#: library/subprocess.rst:1515 msgid "" "Execute the string *cmd* in a shell with :meth:`Popen.check_output` and " "return a 2-tuple ``(exitcode, output)``. *encoding* and *errors* are used to " @@ -1663,85 +1666,81 @@ msgid "" "details." msgstr "" -#: library/subprocess.rst:1519 +#: library/subprocess.rst:1520 msgid "" "A trailing newline is stripped from the output. The exit code for the " "command can be interpreted as the return code of subprocess. Example::" msgstr "" -#: library/subprocess.rst:1554 +#: library/subprocess.rst:1555 msgid ":ref:`Availability `: Unix, Windows." msgstr "" -#: library/subprocess.rst:1534 +#: library/subprocess.rst:1535 msgid "Windows support was added." msgstr "" -#: library/subprocess.rst:1537 +#: library/subprocess.rst:1538 msgid "" "The function now returns (exitcode, output) instead of (status, output) as " "it did in Python 3.3.3 and earlier. exitcode has the same value as :attr:" "`~Popen.returncode`." msgstr "" -#: library/subprocess.rst:1559 -msgid "Added *encoding* and *errors* arguments." -msgstr "" - -#: library/subprocess.rst:1546 +#: library/subprocess.rst:1547 msgid "Return output (stdout and stderr) of executing *cmd* in a shell." msgstr "" -#: library/subprocess.rst:1548 +#: library/subprocess.rst:1549 msgid "" "Like :func:`getstatusoutput`, except the exit code is ignored and the return " "value is a string containing the command's output. Example::" msgstr "" -#: library/subprocess.rst:1556 +#: library/subprocess.rst:1557 msgid "Windows support added" msgstr "" -#: library/subprocess.rst:1564 +#: library/subprocess.rst:1565 msgid "Notes" msgstr "" -#: library/subprocess.rst:1569 +#: library/subprocess.rst:1570 msgid "Converting an argument sequence to a string on Windows" msgstr "" -#: library/subprocess.rst:1571 +#: library/subprocess.rst:1572 msgid "" "On Windows, an *args* sequence is converted to a string that can be parsed " "using the following rules (which correspond to the rules used by the MS C " "runtime):" msgstr "" -#: library/subprocess.rst:1575 +#: library/subprocess.rst:1576 msgid "" "Arguments are delimited by white space, which is either a space or a tab." msgstr "" -#: library/subprocess.rst:1578 +#: library/subprocess.rst:1579 msgid "" "A string surrounded by double quotation marks is interpreted as a single " "argument, regardless of white space contained within. A quoted string can " "be embedded in an argument." msgstr "" -#: library/subprocess.rst:1583 +#: library/subprocess.rst:1584 msgid "" "A double quotation mark preceded by a backslash is interpreted as a literal " "double quotation mark." msgstr "" -#: library/subprocess.rst:1586 +#: library/subprocess.rst:1587 msgid "" "Backslashes are interpreted literally, unless they immediately precede a " "double quotation mark." msgstr "" -#: library/subprocess.rst:1589 +#: library/subprocess.rst:1590 msgid "" "If backslashes immediately precede a double quotation mark, every pair of " "backslashes is interpreted as a literal backslash. If the number of " @@ -1749,33 +1748,33 @@ msgid "" "mark as described in rule 3." msgstr "" -#: library/subprocess.rst:1598 +#: library/subprocess.rst:1599 msgid ":mod:`shlex`" msgstr "" -#: library/subprocess.rst:1599 +#: library/subprocess.rst:1600 msgid "Module which provides function to parse and escape command lines." msgstr "" -#: library/subprocess.rst:1606 +#: library/subprocess.rst:1607 msgid "Disabling use of ``vfork()`` or ``posix_spawn()``" msgstr "" -#: library/subprocess.rst:1608 +#: library/subprocess.rst:1609 msgid "" "On Linux, :mod:`subprocess` defaults to using the ``vfork()`` system call " "internally when it is safe to do so rather than ``fork()``. This greatly " "improves performance." msgstr "" -#: library/subprocess.rst:1612 +#: library/subprocess.rst:1613 msgid "" "If you ever encounter a presumed highly unusual situation where you need to " "prevent ``vfork()`` from being used by Python, you can set the :const:" "`subprocess._USE_VFORK` attribute to a false value." msgstr "" -#: library/subprocess.rst:1620 +#: library/subprocess.rst:1621 msgid "" "Setting this has no impact on use of ``posix_spawn()`` which could use " "``vfork()`` internally within its libc implementation. There is a similar :" @@ -1783,7 +1782,7 @@ msgid "" "that." msgstr "" -#: library/subprocess.rst:1629 +#: library/subprocess.rst:1630 msgid "" "It is safe to set these to false on any Python version. They will have no " "effect on older versions when unsupported. Do not assume the attributes are " @@ -1791,18 +1790,18 @@ msgid "" "the corresponding function will be used, only that it may be." msgstr "" -#: library/subprocess.rst:1634 +#: library/subprocess.rst:1635 msgid "" "Please file issues any time you have to use these private knobs with a way " "to reproduce the issue you were seeing. Link to that issue from a comment in " "your code." msgstr "" -#: library/subprocess.rst:1638 +#: library/subprocess.rst:1639 msgid "``_USE_POSIX_SPAWN``" msgstr "" -#: library/subprocess.rst:1639 +#: library/subprocess.rst:1640 msgid "``_USE_VFORK``" msgstr "" diff --git a/library/symtable.po b/library/symtable.po index 5ffa349e6..9c95e387b 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: 2023-10-01 00:18+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -118,7 +118,7 @@ msgstr "" #: library/symtable.rst:100 msgid "" -"A namespace for a function or method. This class inherits :class:" +"A namespace for a function or method. This class inherits from :class:" "`SymbolTable`." msgstr "" @@ -143,7 +143,7 @@ msgid "Return a tuple containing names of free variables in this function." msgstr "" #: library/symtable.rst:126 -msgid "A namespace of a class. This class inherits :class:`SymbolTable`." +msgid "A namespace of a class. This class inherits from :class:`SymbolTable`." msgstr "" #: library/symtable.rst:130 diff --git a/library/sys.po b/library/sys.po index d3e4a6596..4a4b48bc7 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -33,19 +33,23 @@ msgid "" "script, this contains the ABI flags as specified by :pep:`3149`." msgstr "" -#: library/sys.rst:19 +#: library/sys.rst:21 msgid "" "Default flags became an empty string (``m`` flag for pymalloc has been " "removed)." msgstr "" -#: library/sys.rst:28 +#: library/sys.rst:765 library/sys.rst:1459 +msgid ":ref:`Availability `: Unix." +msgstr "" + +#: library/sys.rst:30 msgid "" "Append the callable *hook* to the list of active auditing hooks for the " "current (sub)interpreter." msgstr "" -#: library/sys.rst:31 +#: library/sys.rst:33 msgid "" "When an auditing event is raised through the :func:`sys.audit` function, " "each hook will be called in the order it was added with the event name and " @@ -55,7 +59,7 @@ msgid "" "terminate the process entirely." msgstr "" -#: library/sys.rst:38 +#: library/sys.rst:40 msgid "" "Note that audit hooks are primarily for collecting information about " "internal or otherwise unobservable actions, whether by Python or libraries " @@ -67,13 +71,13 @@ msgid "" "mod:`ctypes`) should be completely removed or closely monitored." msgstr "" -#: library/sys.rst:47 +#: library/sys.rst:49 msgid "" "Raises an :ref:`auditing event ` ``sys.addaudithook`` with no " "arguments." msgstr "" -#: library/sys.rst:49 +#: library/sys.rst:51 msgid "" "Calling :func:`sys.addaudithook` will itself raise an auditing event named " "``sys.addaudithook`` with no arguments. If any existing hooks raise an " @@ -82,26 +86,26 @@ msgid "" "hook has been added unless they control all existing hooks." msgstr "" -#: library/sys.rst:56 +#: library/sys.rst:58 msgid "" "See the :ref:`audit events table ` for all events raised by " "CPython, and :pep:`578` for the original design discussion." msgstr "" -#: library/sys.rst:63 +#: library/sys.rst:65 msgid "" "Exceptions derived from :class:`Exception` but not :class:`RuntimeError` are " "no longer suppressed." msgstr "" -#: library/sys.rst:68 +#: library/sys.rst:70 msgid "" "When tracing is enabled (see :func:`settrace`), Python hooks are only traced " "if the callable has a ``__cantrace__`` member that is set to a true value. " "Otherwise, trace functions will skip the hook." msgstr "" -#: library/sys.rst:75 +#: library/sys.rst:77 msgid "" "The list of command line arguments passed to a Python script. ``argv[0]`` is " "the script name (it is operating system dependent whether this is a full " @@ -111,17 +115,17 @@ msgid "" "is the empty string." msgstr "" -#: library/sys.rst:81 +#: library/sys.rst:83 msgid "" "To loop over the standard input, or the list of files given on the command " "line, see the :mod:`fileinput` module." msgstr "" -#: library/sys.rst:84 +#: library/sys.rst:86 msgid "See also :data:`sys.orig_argv`." msgstr "" -#: library/sys.rst:87 +#: library/sys.rst:89 msgid "" "On Unix, command line arguments are passed by bytes from OS. Python decodes " "them with filesystem encoding and \"surrogateescape\" error handler. When " @@ -129,7 +133,7 @@ msgid "" "sys.argv]``." msgstr "" -#: library/sys.rst:99 +#: library/sys.rst:101 msgid "" "Raise an auditing event and trigger any active auditing hooks. *event* is a " "string identifying the event, and *args* may contain optional arguments with " @@ -138,13 +142,13 @@ msgid "" "modified between releases." msgstr "" -#: library/sys.rst:105 +#: library/sys.rst:107 msgid "" "For example, one auditing event is named ``os.chdir``. This event has one " "argument called *path* that will contain the requested new working directory." msgstr "" -#: library/sys.rst:109 +#: library/sys.rst:111 msgid "" ":func:`sys.audit` will call the existing auditing hooks, passing the event " "name and arguments, and will re-raise the first exception from any hook. In " @@ -154,25 +158,25 @@ msgid "" "merely log the event or abort the operation by raising an exception." msgstr "" -#: library/sys.rst:117 +#: library/sys.rst:119 msgid "" "Hooks are added using the :func:`sys.addaudithook` or :c:func:" "`PySys_AddAuditHook` functions." msgstr "" -#: library/sys.rst:120 +#: library/sys.rst:122 msgid "" "The native equivalent of this function is :c:func:`PySys_Audit`. Using the " "native function is preferred when possible." msgstr "" -#: library/sys.rst:123 +#: library/sys.rst:125 msgid "" "See the :ref:`audit events table ` for all events raised by " "CPython." msgstr "" -#: library/sys.rst:131 +#: library/sys.rst:133 msgid "" "Set during Python startup, before ``site.py`` is run, to the same value as :" "data:`exec_prefix`. If not running in a :ref:`virtual environment `, " @@ -194,55 +198,55 @@ msgid "" "Python installation (the one which the virtual environment was created from)." msgstr "" -#: library/sys.rst:158 +#: library/sys.rst:160 msgid "" "An indicator of the native byte order. This will have the value ``'big'`` " "on big-endian (most-significant byte first) platforms, and ``'little'`` on " "little-endian (least-significant byte first) platforms." msgstr "" -#: library/sys.rst:165 +#: library/sys.rst:167 msgid "" "A tuple of strings containing the names of all modules that are compiled " "into this Python interpreter. (This information is not available in any " "other way --- ``modules.keys()`` only lists the imported modules.)" msgstr "" -#: library/sys.rst:169 +#: library/sys.rst:171 msgid "See also the :data:`sys.stdlib_module_names` list." msgstr "" -#: library/sys.rst:174 +#: library/sys.rst:176 msgid "" "Call ``func(*args)``, while tracing is enabled. The tracing state is saved, " "and restored afterwards. This is intended to be called from a debugger from " "a checkpoint, to recursively debug or profile some other code." msgstr "" -#: library/sys.rst:178 +#: library/sys.rst:180 msgid "" "Tracing is suspended while calling a tracing function set by :func:" "`settrace` or :func:`setprofile` to avoid infinite recursion. :func:`!" "call_tracing` enables explicit recursion of the tracing function." msgstr "" -#: library/sys.rst:185 +#: library/sys.rst:187 msgid "A string containing the copyright pertaining to the Python interpreter." msgstr "" -#: library/sys.rst:190 +#: library/sys.rst:192 msgid "" "Clear the internal type cache. The type cache is used to speed up attribute " "and method lookups. Use the function *only* to drop unnecessary references " "during reference leak debugging." msgstr "" -#: library/sys.rst:210 library/sys.rst:223 +#: library/sys.rst:212 library/sys.rst:225 msgid "" "This function should be used for internal and specialized purposes only." msgstr "" -#: library/sys.rst:199 +#: library/sys.rst:201 msgid "" "Return a dictionary mapping each thread's identifier to the topmost stack " "frame currently active in that thread at the time the function is called. " @@ -250,7 +254,7 @@ msgid "" "given such a frame." msgstr "" -#: library/sys.rst:204 +#: library/sys.rst:206 msgid "" "This is most useful for debugging deadlock: this function does not require " "the deadlocked threads' cooperation, and such threads' call stacks are " @@ -259,13 +263,13 @@ msgid "" "by the time calling code examines the frame." msgstr "" -#: library/sys.rst:212 +#: library/sys.rst:214 msgid "" "Raises an :ref:`auditing event ` ``sys._current_frames`` with no " "arguments." msgstr "" -#: library/sys.rst:216 +#: library/sys.rst:218 msgid "" "Return a dictionary mapping each thread's identifier to the topmost " "exception currently active in that thread at the time the function is " @@ -273,30 +277,30 @@ msgid "" "included in the result dictionary." msgstr "" -#: library/sys.rst:221 +#: library/sys.rst:223 msgid "This is most useful for statistical profiling." msgstr "" -#: library/sys.rst:225 +#: library/sys.rst:227 msgid "" "Raises an :ref:`auditing event ` ``sys._current_exceptions`` with " "no arguments." msgstr "" -#: library/sys.rst:227 +#: library/sys.rst:229 msgid "" "Each value in the dictionary is now a single exception instance, rather than " "a 3-tuple as returned from ``sys.exc_info()``." msgstr "" -#: library/sys.rst:233 +#: library/sys.rst:235 msgid "" "This hook function is called by built-in :func:`breakpoint`. By default, it " "drops you into the :mod:`pdb` debugger, but it can be set to any other " "function so that you can choose which debugger gets used." msgstr "" -#: library/sys.rst:237 +#: library/sys.rst:239 msgid "" "The signature of this function is dependent on what it calls. For example, " "the default binding (e.g. ``pdb.set_trace()``) expects no arguments, but you " @@ -306,7 +310,7 @@ msgid "" "returns is returned from ``breakpoint()``." msgstr "" -#: library/sys.rst:244 +#: library/sys.rst:246 msgid "" "The default implementation first consults the environment variable :envvar:" "`PYTHONBREAKPOINT`. If that is set to ``\"0\"`` then this function returns " @@ -320,47 +324,47 @@ msgid "" "breakpointhook()`` returns to the built-in :func:`breakpoint` function." msgstr "" -#: library/sys.rst:256 +#: library/sys.rst:258 msgid "" "Note that if anything goes wrong while importing the callable named by :" "envvar:`PYTHONBREAKPOINT`, a :exc:`RuntimeWarning` is reported and the " "breakpoint is ignored." msgstr "" -#: library/sys.rst:260 +#: library/sys.rst:262 msgid "" "Also note that if ``sys.breakpointhook()`` is overridden programmatically, :" "envvar:`PYTHONBREAKPOINT` is *not* consulted." msgstr "" -#: library/sys.rst:267 +#: library/sys.rst:269 msgid "" "Print low-level information to stderr about the state of CPython's memory " "allocator." msgstr "" -#: library/sys.rst:270 +#: library/sys.rst:272 msgid "" "If Python is :ref:`built in debug mode ` (:option:`configure --" "with-pydebug option <--with-pydebug>`), it also performs some expensive " "internal consistency checks." msgstr "" -#: library/sys.rst:278 +#: library/sys.rst:280 msgid "" "This function is specific to CPython. The exact output format is not " "defined here, and may change." msgstr "" -#: library/sys.rst:284 +#: library/sys.rst:286 msgid "Integer specifying the handle of the Python DLL." msgstr "" -#: library/sys.rst:976 library/sys.rst:1967 +#: library/sys.rst:978 library/sys.rst:1981 msgid ":ref:`Availability `: Windows." msgstr "" -#: library/sys.rst:291 +#: library/sys.rst:293 msgid "" "If *value* is not ``None``, this function prints ``repr(value)`` to ``sys." "stdout``, and saves *value* in ``builtins._``. If ``repr(value)`` is not " @@ -369,7 +373,7 @@ msgid "" "encoding`` with ``'backslashreplace'`` error handler." msgstr "" -#: library/sys.rst:297 +#: library/sys.rst:299 msgid "" "``sys.displayhook`` is called on the result of evaluating an :term:" "`expression` entered in an interactive Python session. The display of these " @@ -377,15 +381,15 @@ msgid "" "displayhook``." msgstr "" -#: library/sys.rst:301 +#: library/sys.rst:303 msgid "Pseudo-code::" msgstr "" -#: library/sys.rst:321 +#: library/sys.rst:323 msgid "Use ``'backslashreplace'`` error handler on :exc:`UnicodeEncodeError`." msgstr "" -#: library/sys.rst:327 +#: library/sys.rst:329 msgid "" "If this is true, Python won't try to write ``.pyc`` files on the import of " "source modules. This value is initially set to ``True`` or ``False`` " @@ -394,38 +398,38 @@ msgid "" "to control bytecode file generation." msgstr "" -#: library/sys.rst:336 +#: library/sys.rst:338 msgid "" "A :term:`named tuple` holding information about the environment on the " "*wasm32-emscripten* platform. The named tuple is provisional and may change " "in the future." msgstr "" -#: library/sys.rst:342 +#: library/sys.rst:344 msgid "" "Emscripten version as tuple of ints (major, minor, micro), e.g. ``(3, 1, " "8)``." msgstr "" -#: library/sys.rst:346 +#: library/sys.rst:348 msgid "" "Runtime string, e.g. browser user agent, ``'Node.js v14.18.2'``, or " "``'UNKNOWN'``." msgstr "" -#: library/sys.rst:350 +#: library/sys.rst:352 msgid "``True`` if Python is compiled with Emscripten pthreads support." msgstr "" -#: library/sys.rst:354 +#: library/sys.rst:356 msgid "``True`` if Python is compiled with shared memory support." msgstr "" -#: library/sys.rst:356 +#: library/sys.rst:358 msgid ":ref:`Availability `: Emscripten." msgstr "" -#: library/sys.rst:363 +#: library/sys.rst:365 msgid "" "If this is set (not ``None``), Python will write bytecode-cache ``.pyc`` " "files to (and read them from) a parallel directory tree rooted at this " @@ -436,12 +440,12 @@ msgid "" "with the same pycache prefix (if any) that you will use at runtime." msgstr "" -#: library/sys.rst:371 +#: library/sys.rst:373 msgid "" "A relative path is interpreted relative to the current working directory." msgstr "" -#: library/sys.rst:373 +#: library/sys.rst:375 msgid "" "This value is initially set based on the value of the :option:`-X` " "``pycache_prefix=PATH`` command-line option or the :envvar:" @@ -449,12 +453,12 @@ msgid "" "If neither are set, it is ``None``." msgstr "" -#: library/sys.rst:383 +#: library/sys.rst:385 msgid "" "This function prints out a given traceback and exception to ``sys.stderr``." msgstr "" -#: library/sys.rst:385 +#: library/sys.rst:387 msgid "" "When an exception other than :exc:`SystemExit` is raised and uncaught, the " "interpreter calls ``sys.excepthook`` with three arguments, the exception " @@ -465,13 +469,13 @@ msgid "" "argument function to ``sys.excepthook``." msgstr "" -#: library/sys.rst:392 +#: library/sys.rst:394 msgid "" "Raises an :ref:`auditing event ` ``sys.excepthook`` with arguments " "``hook``, ``type``, ``value``, ``traceback``." msgstr "" -#: library/sys.rst:394 +#: library/sys.rst:396 msgid "" "Raise an auditing event ``sys.excepthook`` with arguments ``hook``, " "``type``, ``value``, ``traceback`` when an uncaught exception occurs. If no " @@ -481,14 +485,14 @@ msgid "" "excepthook`` will be called." msgstr "" -#: library/sys.rst:403 +#: library/sys.rst:405 msgid "" "The :func:`sys.unraisablehook` function handles unraisable exceptions and " "the :func:`threading.excepthook` function handles exception raised by :func:" "`threading.Thread.run`." msgstr "" -#: library/sys.rst:413 +#: library/sys.rst:415 msgid "" "These objects contain the original values of ``breakpointhook``, " "``displayhook``, ``excepthook``, and ``unraisablehook`` at the start of the " @@ -497,15 +501,15 @@ msgid "" "get replaced with broken or alternative objects." msgstr "" -#: library/sys.rst:419 +#: library/sys.rst:421 msgid "__breakpointhook__" msgstr "" -#: library/sys.rst:422 +#: library/sys.rst:424 msgid "__unraisablehook__" msgstr "" -#: library/sys.rst:428 +#: library/sys.rst:430 msgid "" "This function, when called while an exception handler is executing (such as " "an ``except`` or ``except*`` clause), returns the exception instance that " @@ -513,11 +517,11 @@ msgid "" "another, only the exception handled by the innermost handler is accessible." msgstr "" -#: library/sys.rst:433 +#: library/sys.rst:435 msgid "If no exception handler is executing, this function returns ``None``." msgstr "" -#: library/sys.rst:440 +#: library/sys.rst:442 msgid "" "This function returns the old-style representation of the handled exception. " "If an exception ``e`` is currently handled (so :func:`exception` would " @@ -528,13 +532,13 @@ msgid "" "stack at the point where the exception last occurred." msgstr "" -#: library/sys.rst:451 +#: library/sys.rst:453 msgid "" "If no exception is being handled anywhere on the stack, this function return " "a tuple containing three ``None`` values." msgstr "" -#: library/sys.rst:454 +#: library/sys.rst:456 msgid "" "The ``type`` and ``traceback`` fields are now derived from the ``value`` " "(the exception instance), so when an exception is modified while it is being " @@ -542,7 +546,7 @@ msgid "" "func:`exc_info`." msgstr "" -#: library/sys.rst:462 +#: library/sys.rst:464 msgid "" "A string giving the site-specific directory prefix where the platform-" "dependent Python files are installed; by default, this is also ``'/usr/" @@ -554,7 +558,7 @@ msgid "" "is the version number of Python, for example ``3.2``." msgstr "" -#: library/sys.rst:473 +#: library/sys.rst:475 msgid "" "If a :ref:`virtual environment ` is in effect, this value will be " "changed in ``site.py`` to point to the virtual environment. The value for " @@ -562,7 +566,7 @@ msgid "" "`base_exec_prefix`." msgstr "" -#: library/sys.rst:481 +#: library/sys.rst:483 msgid "" "A string giving the absolute path of the executable binary for the Python " "interpreter, on systems where this makes sense. If Python is unable to " @@ -570,13 +574,13 @@ msgid "" "empty string or ``None``." msgstr "" -#: library/sys.rst:489 +#: library/sys.rst:491 msgid "" "Raise a :exc:`SystemExit` exception, signaling an intention to exit the " "interpreter." msgstr "" -#: library/sys.rst:491 +#: library/sys.rst:493 msgid "" "The optional argument *arg* can be an integer giving the exit status " "(defaulting to zero), or another type of object. If it is an integer, zero " @@ -592,7 +596,7 @@ msgid "" "way to exit a program when an error occurs." msgstr "" -#: library/sys.rst:504 +#: library/sys.rst:506 msgid "" "Since :func:`exit` ultimately \"only\" raises an exception, it will only " "exit the process when called from the main thread, and the exception is not " @@ -601,127 +605,127 @@ msgid "" "an outer level." msgstr "" -#: library/sys.rst:509 +#: library/sys.rst:511 msgid "" "If an error occurs in the cleanup after the Python interpreter has caught :" "exc:`SystemExit` (such as an error flushing buffered data in the standard " "streams), the exit status is changed to 120." msgstr "" -#: library/sys.rst:517 +#: library/sys.rst:519 msgid "" "The :term:`named tuple` *flags* exposes the status of command line flags. " "The attributes are read only." msgstr "" -#: library/sys.rst:523 +#: library/sys.rst:525 msgid ":option:`-d`" msgstr "" -#: library/sys.rst:529 +#: library/sys.rst:531 msgid ":option:`-i`" msgstr "" -#: library/sys.rst:532 +#: library/sys.rst:534 msgid ":option:`-I`" msgstr "" -#: library/sys.rst:535 +#: library/sys.rst:537 msgid ":option:`-O` or :option:`-OO`" msgstr "" -#: library/sys.rst:538 +#: library/sys.rst:540 msgid ":option:`-B`" msgstr "" -#: library/sys.rst:541 +#: library/sys.rst:543 msgid ":option:`-s`" msgstr "" -#: library/sys.rst:544 +#: library/sys.rst:546 msgid ":option:`-S`" msgstr "" -#: library/sys.rst:547 +#: library/sys.rst:549 msgid ":option:`-E`" msgstr "" -#: library/sys.rst:550 +#: library/sys.rst:552 msgid ":option:`-v`" msgstr "" -#: library/sys.rst:553 +#: library/sys.rst:555 msgid ":option:`-b`" msgstr "" -#: library/sys.rst:556 +#: library/sys.rst:558 msgid ":option:`-q`" msgstr "" -#: library/sys.rst:559 +#: library/sys.rst:561 msgid ":option:`-R`" msgstr "" -#: library/sys.rst:562 +#: library/sys.rst:564 msgid ":option:`-X dev <-X>` (:ref:`Python Development Mode `)" msgstr "" -#: library/sys.rst:565 +#: library/sys.rst:567 msgid ":option:`-X utf8 <-X>`" msgstr "" -#: library/sys.rst:568 +#: library/sys.rst:570 msgid ":option:`-P`" msgstr "" -#: library/sys.rst:571 +#: library/sys.rst:573 msgid "" ":option:`-X int_max_str_digits <-X>` (:ref:`integer string conversion length " "limitation `)" msgstr "" -#: library/sys.rst:575 +#: library/sys.rst:577 msgid ":option:`-X warn_default_encoding <-X>`" msgstr "" -#: library/sys.rst:577 +#: library/sys.rst:579 msgid "Added ``quiet`` attribute for the new :option:`-q` flag." msgstr "" -#: library/sys.rst:580 +#: library/sys.rst:582 msgid "The ``hash_randomization`` attribute." msgstr "" -#: library/sys.rst:583 +#: library/sys.rst:585 msgid "Removed obsolete ``division_warning`` attribute." msgstr "" -#: library/sys.rst:586 +#: library/sys.rst:588 msgid "Added ``isolated`` attribute for :option:`-I` ``isolated`` flag." msgstr "" -#: library/sys.rst:589 +#: library/sys.rst:591 msgid "" "Added the ``dev_mode`` attribute for the new :ref:`Python Development Mode " "` and the ``utf8_mode`` attribute for the new :option:`-X` " "``utf8`` flag." msgstr "" -#: library/sys.rst:594 +#: library/sys.rst:596 msgid "" "Added ``warn_default_encoding`` attribute for :option:`-X` " "``warn_default_encoding`` flag." msgstr "" -#: library/sys.rst:597 +#: library/sys.rst:599 msgid "Added the ``safe_path`` attribute for :option:`-P` option." msgstr "" -#: library/sys.rst:600 +#: library/sys.rst:602 msgid "Added the ``int_max_str_digits`` attribute." msgstr "" -#: library/sys.rst:606 +#: library/sys.rst:608 msgid "" "A :term:`named tuple` holding information about the float type. It contains " "low level information about the precision and internal representation. The " @@ -731,161 +735,161 @@ msgid "" "floating types', for details." msgstr "" -#: library/sys.rst:613 +#: library/sys.rst:615 msgid "Attributes of the :data:`!float_info` :term:`named tuple`" msgstr "" -#: library/sys.rst:616 +#: library/sys.rst:618 msgid "attribute" msgstr "" -#: library/sys.rst:617 +#: library/sys.rst:619 msgid "float.h macro" msgstr "" -#: library/sys.rst:618 +#: library/sys.rst:620 msgid "explanation" msgstr "" -#: library/sys.rst:621 +#: library/sys.rst:623 msgid ":c:macro:`!DBL_EPSILON`" msgstr "" -#: library/sys.rst:622 +#: library/sys.rst:624 msgid "" "difference between 1.0 and the least value greater than 1.0 that is " "representable as a float." msgstr "" -#: library/sys.rst:625 +#: library/sys.rst:627 msgid "See also :func:`math.ulp`." msgstr "" -#: library/sys.rst:628 +#: library/sys.rst:630 msgid ":c:macro:`!DBL_DIG`" msgstr "" -#: library/sys.rst:629 +#: library/sys.rst:631 msgid "" "The maximum number of decimal digits that can be faithfully represented in a " "float; see below." msgstr "" -#: library/sys.rst:633 +#: library/sys.rst:635 msgid ":c:macro:`!DBL_MANT_DIG`" msgstr "" -#: library/sys.rst:634 +#: library/sys.rst:636 msgid "" "Float precision: the number of base-``radix`` digits in the significand of a " "float." msgstr "" -#: library/sys.rst:638 +#: library/sys.rst:640 msgid ":c:macro:`!DBL_MAX`" msgstr "" -#: library/sys.rst:639 +#: library/sys.rst:641 msgid "The maximum representable positive finite float." msgstr "" -#: library/sys.rst:642 +#: library/sys.rst:644 msgid ":c:macro:`!DBL_MAX_EXP`" msgstr "" -#: library/sys.rst:643 +#: library/sys.rst:645 msgid "" "The maximum integer *e* such that ``radix**(e-1)`` is a representable finite " "float." msgstr "" -#: library/sys.rst:647 +#: library/sys.rst:649 msgid ":c:macro:`!DBL_MAX_10_EXP`" msgstr "" -#: library/sys.rst:648 +#: library/sys.rst:650 msgid "" "The maximum integer *e* such that ``10**e`` is in the range of representable " "finite floats." msgstr "" -#: library/sys.rst:652 +#: library/sys.rst:654 msgid ":c:macro:`!DBL_MIN`" msgstr "" -#: library/sys.rst:653 +#: library/sys.rst:655 msgid "The minimum representable positive *normalized* float." msgstr "" -#: library/sys.rst:655 +#: library/sys.rst:657 msgid "" "Use :func:`math.ulp(0.0) ` to get the smallest positive " "*denormalized* representable float." msgstr "" -#: library/sys.rst:659 +#: library/sys.rst:661 msgid ":c:macro:`!DBL_MIN_EXP`" msgstr "" -#: library/sys.rst:660 +#: library/sys.rst:662 msgid "" "The minimum integer *e* such that ``radix**(e-1)`` is a normalized float." msgstr "" -#: library/sys.rst:664 +#: library/sys.rst:666 msgid ":c:macro:`!DBL_MIN_10_EXP`" msgstr "" -#: library/sys.rst:665 +#: library/sys.rst:667 msgid "The minimum integer *e* such that ``10**e`` is a normalized float." msgstr "" -#: library/sys.rst:668 +#: library/sys.rst:670 msgid ":c:macro:`!FLT_RADIX`" msgstr "" -#: library/sys.rst:669 +#: library/sys.rst:671 msgid "The radix of exponent representation." msgstr "" -#: library/sys.rst:672 +#: library/sys.rst:674 msgid ":c:macro:`!FLT_ROUNDS`" msgstr "" -#: library/sys.rst:673 +#: library/sys.rst:675 msgid "" "An integer representing the rounding mode for floating-point arithmetic. " "This reflects the value of the system :c:macro:`!FLT_ROUNDS` macro at " "interpreter startup time:" msgstr "" -#: library/sys.rst:677 +#: library/sys.rst:679 msgid "``-1``: indeterminable" msgstr "" -#: library/sys.rst:678 +#: library/sys.rst:680 msgid "``0``: toward zero" msgstr "" -#: library/sys.rst:679 +#: library/sys.rst:681 msgid "``1``: to nearest" msgstr "" -#: library/sys.rst:680 +#: library/sys.rst:682 msgid "``2``: toward positive infinity" msgstr "" -#: library/sys.rst:681 +#: library/sys.rst:683 msgid "``3``: toward negative infinity" msgstr "" -#: library/sys.rst:683 +#: library/sys.rst:685 msgid "" "All other values for :c:macro:`!FLT_ROUNDS` characterize implementation-" "defined rounding behavior." msgstr "" -#: library/sys.rst:686 +#: library/sys.rst:688 msgid "" "The attribute :attr:`sys.float_info.dig` needs further explanation. If " "``s`` is any string representing a decimal number with at most :attr:`!sys." @@ -893,13 +897,13 @@ msgid "" "back again will recover a string representing the same decimal value::" msgstr "" -#: library/sys.rst:699 +#: library/sys.rst:701 msgid "" "But for strings with more than :attr:`sys.float_info.dig` significant " "digits, this isn't always true::" msgstr "" -#: library/sys.rst:708 +#: library/sys.rst:710 msgid "" "A string indicating how the :func:`repr` function behaves for floats. If " "the string has value ``'short'`` then for a finite float ``x``, ``repr(x)`` " @@ -909,7 +913,7 @@ msgid "" "same way as it did in versions of Python prior to 3.1." msgstr "" -#: library/sys.rst:721 +#: library/sys.rst:723 msgid "" "Return the number of memory blocks currently allocated by the interpreter, " "regardless of their size. This function is mainly useful for tracking and " @@ -919,42 +923,38 @@ msgid "" "results." msgstr "" -#: library/sys.rst:728 +#: library/sys.rst:730 msgid "" "If a Python build or implementation cannot reasonably compute this " "information, :func:`getallocatedblocks()` is allowed to return 0 instead." msgstr "" -#: library/sys.rst:736 +#: library/sys.rst:738 msgid "Return the number of unicode objects that have been interned." msgstr "" -#: library/sys.rst:743 +#: library/sys.rst:745 msgid "Return the build time API version of Android as an integer." msgstr "" -#: library/sys.rst:745 +#: library/sys.rst:747 msgid ":ref:`Availability `: Android." msgstr "" -#: library/sys.rst:752 +#: library/sys.rst:754 msgid "" "Return the name of the current default string encoding used by the Unicode " "implementation." msgstr "" -#: library/sys.rst:758 +#: library/sys.rst:760 msgid "" "Return the current value of the flags that are used for :c:func:`dlopen` " "calls. Symbolic names for the flag values can be found in the :mod:`os` " "module (:samp:`RTLD_{xxx}` constants, e.g. :const:`os.RTLD_LAZY`)." msgstr "" -#: library/sys.rst:1451 -msgid ":ref:`Availability `: Unix." -msgstr "" - -#: library/sys.rst:768 +#: library/sys.rst:770 msgid "" "Get the :term:`filesystem encoding `: " "the encoding used with the :term:`filesystem error handler ` is enabled." msgstr "" -#: library/sys.rst:801 +#: library/sys.rst:803 msgid "" "Get the :term:`filesystem error handler `: the error handler used with the :term:`filesystem encoding " @@ -1009,20 +1009,20 @@ msgid "" "func:`getfilesystemencoding`." msgstr "" -#: library/sys.rst:819 +#: library/sys.rst:821 msgid "" "Returns the current value for the :ref:`integer string conversion length " "limitation `. See also :func:`set_int_max_str_digits`." msgstr "" -#: library/sys.rst:826 +#: library/sys.rst:828 msgid "" "Return the reference count of the *object*. The count returned is generally " "one higher than you might expect, because it includes the (temporary) " "reference as an argument to :func:`getrefcount`." msgstr "" -#: library/sys.rst:830 +#: library/sys.rst:832 msgid "" "Note that the returned value may not actually reflect how many references to " "the object are actually held. For example, some objects are \"immortal\" " @@ -1031,13 +1031,13 @@ msgid "" "other than a value of 0 or 1." msgstr "" -#: library/sys.rst:836 +#: library/sys.rst:838 msgid "" "Immortal objects have very large refcounts that do not match the actual " "number of references to the object." msgstr "" -#: library/sys.rst:842 +#: library/sys.rst:844 msgid "" "Return the current value of the recursion limit, the maximum depth of the " "Python interpreter stack. This limit prevents infinite recursion from " @@ -1045,46 +1045,46 @@ msgid "" "func:`setrecursionlimit`." msgstr "" -#: library/sys.rst:850 +#: library/sys.rst:852 msgid "" "Return the size of an object in bytes. The object can be any type of object. " "All built-in objects will return correct results, but this does not have to " "hold true for third-party extensions as it is implementation specific." msgstr "" -#: library/sys.rst:855 +#: library/sys.rst:857 msgid "" "Only the memory consumption directly attributed to the object is accounted " "for, not the memory consumption of objects it refers to." msgstr "" -#: library/sys.rst:858 +#: library/sys.rst:860 msgid "" "If given, *default* will be returned if the object does not provide means to " "retrieve the size. Otherwise a :exc:`TypeError` will be raised." msgstr "" -#: library/sys.rst:861 +#: library/sys.rst:863 msgid "" ":func:`getsizeof` calls the object's ``__sizeof__`` method and adds an " "additional garbage collector overhead if the object is managed by the " "garbage collector." msgstr "" -#: library/sys.rst:865 +#: library/sys.rst:867 msgid "" "See `recursive sizeof recipe `_ for an example of using :func:`getsizeof` recursively to find the size " "of containers and all their contents." msgstr "" -#: library/sys.rst:871 +#: library/sys.rst:873 msgid "" "Return the interpreter's \"thread switch interval\"; see :func:" "`setswitchinterval`." msgstr "" -#: library/sys.rst:879 +#: library/sys.rst:881 msgid "" "Return a frame object from the call stack. If optional integer *depth* is " "given, return the frame object that many calls below the top of the stack. " @@ -1093,19 +1093,19 @@ msgid "" "stack." msgstr "" -#: library/sys.rst:884 +#: library/sys.rst:886 msgid "" "Raises an :ref:`auditing event ` ``sys._getframe`` with argument " "``frame``." msgstr "" -#: library/sys.rst:904 +#: library/sys.rst:906 msgid "" "This function should be used for internal and specialized purposes only. It " "is not guaranteed to exist in all implementations of Python." msgstr "" -#: library/sys.rst:894 +#: library/sys.rst:896 msgid "" "Return the name of a module from the call stack. If optional integer " "*depth* is given, return the module that many calls below the top of the " @@ -1114,21 +1114,21 @@ msgid "" "returning the module at the top of the call stack." msgstr "" -#: library/sys.rst:900 +#: library/sys.rst:902 msgid "" "Raises an :ref:`auditing event ` ``sys._getframemodulename`` with " "argument ``depth``." msgstr "" -#: library/sys.rst:914 +#: library/sys.rst:916 msgid "Get the profiler function as set by :func:`setprofile`." msgstr "" -#: library/sys.rst:923 +#: library/sys.rst:925 msgid "Get the trace function as set by :func:`settrace`." msgstr "" -#: library/sys.rst:927 +#: library/sys.rst:929 msgid "" "The :func:`gettrace` function is intended only for implementing debuggers, " "profilers, coverage tools and the like. Its behavior is part of the " @@ -1136,7 +1136,7 @@ msgid "" "thus may not be available in all Python implementations." msgstr "" -#: library/sys.rst:935 +#: library/sys.rst:937 msgid "" "Return a named tuple describing the Windows version currently running. The " "named elements are *major*, *minor*, *build*, *platform*, *service_pack*, " @@ -1148,54 +1148,54 @@ msgid "" "first 5 elements are retrievable by indexing." msgstr "" -#: library/sys.rst:946 +#: library/sys.rst:948 msgid "*platform* will be ``2`` (VER_PLATFORM_WIN32_NT)." msgstr "" -#: library/sys.rst:948 +#: library/sys.rst:950 msgid "*product_type* may be one of the following values:" msgstr "" -#: library/sys.rst:951 +#: library/sys.rst:953 msgid "Constant" msgstr "" -#: library/sys.rst:951 +#: library/sys.rst:953 msgid "Meaning" msgstr "" -#: library/sys.rst:953 +#: library/sys.rst:955 msgid "``1`` (VER_NT_WORKSTATION)" msgstr "" -#: library/sys.rst:953 +#: library/sys.rst:955 msgid "The system is a workstation." msgstr "" -#: library/sys.rst:955 +#: library/sys.rst:957 msgid "``2`` (VER_NT_DOMAIN_CONTROLLER)" msgstr "" -#: library/sys.rst:955 +#: library/sys.rst:957 msgid "The system is a domain controller." msgstr "" -#: library/sys.rst:958 +#: library/sys.rst:960 msgid "``3`` (VER_NT_SERVER)" msgstr "" -#: library/sys.rst:958 +#: library/sys.rst:960 msgid "The system is a server, but not a domain controller." msgstr "" -#: library/sys.rst:962 +#: library/sys.rst:964 msgid "" "This function wraps the Win32 :c:func:`!GetVersionEx` function; see the " "Microsoft documentation on :c:func:`!OSVERSIONINFOEX` for more information " "about these fields." msgstr "" -#: library/sys.rst:966 +#: library/sys.rst:968 msgid "" "*platform_version* returns the major version, minor version and build number " "of the current operating system, rather than the version that is being " @@ -1203,24 +1203,24 @@ msgid "" "feature detection." msgstr "" -#: library/sys.rst:972 +#: library/sys.rst:974 msgid "" "*platform_version* derives the version from kernel32.dll which can be of a " "different version than the OS version. Please use :mod:`platform` module for " "achieving accurate OS version." msgstr "" -#: library/sys.rst:978 +#: library/sys.rst:980 msgid "" "Changed to a named tuple and added *service_pack_minor*, " "*service_pack_major*, *suite_mask*, and *product_type*." msgstr "" -#: library/sys.rst:982 +#: library/sys.rst:984 msgid "Added *platform_version*" msgstr "" -#: library/sys.rst:988 +#: library/sys.rst:990 msgid "" "Returns an *asyncgen_hooks* object, which is similar to a :class:" "`~collections.namedtuple` of the form ``(firstiter, finalizer)``, where " @@ -1230,71 +1230,71 @@ msgid "" "loop." msgstr "" -#: library/sys.rst:995 +#: library/sys.rst:997 msgid "See :pep:`525` for more details." msgstr "" -#: library/sys.rst:1663 +#: library/sys.rst:1677 msgid "" "This function has been added on a provisional basis (see :pep:`411` for " "details.)" msgstr "" -#: library/sys.rst:1005 +#: library/sys.rst:1007 msgid "" "Get the current coroutine origin tracking depth, as set by :func:" "`set_coroutine_origin_tracking_depth`." msgstr "" -#: library/sys.rst:1684 +#: library/sys.rst:1698 msgid "" "This function has been added on a provisional basis (see :pep:`411` for " "details.) Use it only for debugging purposes." msgstr "" -#: library/sys.rst:1017 +#: library/sys.rst:1019 msgid "" "A :term:`named tuple` giving parameters of the numeric hash implementation. " "For more details about hashing of numeric types, see :ref:`numeric-hash`." msgstr "" -#: library/sys.rst:1023 +#: library/sys.rst:1025 msgid "The width in bits used for hash values" msgstr "" -#: library/sys.rst:1027 +#: library/sys.rst:1029 msgid "The prime modulus P used for numeric hash scheme" msgstr "" -#: library/sys.rst:1031 +#: library/sys.rst:1033 msgid "The hash value returned for a positive infinity" msgstr "" -#: library/sys.rst:1035 +#: library/sys.rst:1037 msgid "(This attribute is no longer used)" msgstr "" -#: library/sys.rst:1039 +#: library/sys.rst:1041 msgid "The multiplier used for the imaginary part of a complex number" msgstr "" -#: library/sys.rst:1043 +#: library/sys.rst:1045 msgid "The name of the algorithm for hashing of str, bytes, and memoryview" msgstr "" -#: library/sys.rst:1047 +#: library/sys.rst:1049 msgid "The internal output size of the hash algorithm" msgstr "" -#: library/sys.rst:1051 +#: library/sys.rst:1053 msgid "The size of the seed key of the hash algorithm" msgstr "" -#: library/sys.rst:1055 +#: library/sys.rst:1057 msgid "Added *algorithm*, *hash_bits* and *seed_bits*" msgstr "" -#: library/sys.rst:1061 +#: library/sys.rst:1063 msgid "" "The version number encoded as a single integer. This is guaranteed to " "increase with each version, including proper support for non-production " @@ -1302,7 +1302,7 @@ msgid "" "version 1.5.2, use::" msgstr "" -#: library/sys.rst:1072 +#: library/sys.rst:1074 msgid "" "This is called ``hexversion`` since it only really looks meaningful when " "viewed as the result of passing it to the built-in :func:`hex` function. " @@ -1310,25 +1310,25 @@ msgid "" "human-friendly encoding of the same information." msgstr "" -#: library/sys.rst:1077 +#: library/sys.rst:1079 msgid "More details of ``hexversion`` can be found at :ref:`apiabiversion`." msgstr "" -#: library/sys.rst:1082 +#: library/sys.rst:1084 msgid "" "An object containing information about the implementation of the currently " "running Python interpreter. The following attributes are required to exist " "in all Python implementations." msgstr "" -#: library/sys.rst:1086 +#: library/sys.rst:1088 msgid "" "*name* is the implementation's identifier, e.g. ``'cpython'``. The actual " "string is defined by the Python implementation, but it is guaranteed to be " "lower case." msgstr "" -#: library/sys.rst:1090 +#: library/sys.rst:1092 msgid "" "*version* is a named tuple, in the same format as :data:`sys.version_info`. " "It represents the version of the Python *implementation*. This has a " @@ -1340,13 +1340,13 @@ msgid "" "the same value, since it is the reference implementation." msgstr "" -#: library/sys.rst:1100 +#: library/sys.rst:1102 msgid "" "*hexversion* is the implementation version in hexadecimal format, like :data:" "`sys.hexversion`." msgstr "" -#: library/sys.rst:1103 +#: library/sys.rst:1105 msgid "" "*cache_tag* is the tag used by the import machinery in the filenames of " "cached modules. By convention, it would be a composite of the " @@ -1355,7 +1355,7 @@ msgid "" "set to ``None``, it indicates that module caching should be disabled." msgstr "" -#: library/sys.rst:1110 +#: library/sys.rst:1112 msgid "" ":data:`sys.implementation` may contain additional attributes specific to the " "Python implementation. These non-standard attributes must start with an " @@ -1365,47 +1365,47 @@ msgid "" "versions, however.) See :pep:`421` for more information." msgstr "" -#: library/sys.rst:1121 +#: library/sys.rst:1123 msgid "" "The addition of new required attributes must go through the normal PEP " "process. See :pep:`421` for more information." msgstr "" -#: library/sys.rst:1126 +#: library/sys.rst:1128 msgid "" "A :term:`named tuple` that holds information about Python's internal " "representation of integers. The attributes are read only." msgstr "" -#: library/sys.rst:1131 +#: library/sys.rst:1133 msgid "" "The number of bits held in each digit. Python integers are stored internally " "in base ``2**int_info.bits_per_digit``." msgstr "" -#: library/sys.rst:1136 +#: library/sys.rst:1138 msgid "The size in bytes of the C type used to represent a digit." msgstr "" -#: library/sys.rst:1140 +#: library/sys.rst:1142 msgid "" "The default value for :func:`sys.get_int_max_str_digits` when it is not " "otherwise explicitly configured." msgstr "" -#: library/sys.rst:1145 +#: library/sys.rst:1147 msgid "" "The minimum non-zero value for :func:`sys.set_int_max_str_digits`, :envvar:" "`PYTHONINTMAXSTRDIGITS`, or :option:`-X int_max_str_digits <-X>`." msgstr "" -#: library/sys.rst:1152 +#: library/sys.rst:1154 msgid "" "Added :attr:`~int_info.default_max_str_digits` and :attr:`~int_info." "str_digits_check_threshold`." msgstr "" -#: library/sys.rst:1158 +#: library/sys.rst:1160 msgid "" "When this attribute exists, its value is automatically called (with no " "arguments) when the interpreter is launched in :ref:`interactive mode `." msgstr "" -#: library/sys.rst:1164 +#: library/sys.rst:1166 msgid "" "Raises an :ref:`auditing event ` ``cpython.run_interactivehook`` " "with argument ``hook``." msgstr "" -#: library/sys.rst:1166 +#: library/sys.rst:1168 msgid "" "Raises an :ref:`auditing event ` ``cpython.run_interactivehook`` " "with the hook object as the argument when the hook is called on startup." msgstr "" -#: library/sys.rst:1175 +#: library/sys.rst:1177 msgid "" "Enter *string* in the table of \"interned\" strings and return the interned " "string -- which is *string* itself or a copy. Interning strings is useful to " @@ -1438,19 +1438,19 @@ msgid "" "attributes have interned keys." msgstr "" -#: library/sys.rst:1183 +#: library/sys.rst:1185 msgid "" "Interned strings are not immortal; you must keep a reference to the return " "value of :func:`intern` around to benefit from it." msgstr "" -#: library/sys.rst:1189 +#: library/sys.rst:1191 msgid "" "Return :const:`True` if the Python interpreter is :term:`shutting down " "`, :const:`False` otherwise." msgstr "" -#: library/sys.rst:1196 +#: library/sys.rst:1198 msgid "" "This variable is not always defined; it is set to the exception instance " "when an exception is not handled and the interpreter prints an error message " @@ -1461,34 +1461,34 @@ msgid "" "more information.)" msgstr "" -#: library/sys.rst:1210 +#: library/sys.rst:1212 msgid "" "These three variables are deprecated; use :data:`sys.last_exc` instead. They " "hold the legacy representation of ``sys.last_exc``, as returned from :func:" "`exc_info` above." msgstr "" -#: library/sys.rst:1216 +#: library/sys.rst:1218 msgid "" "An integer giving the maximum value a variable of type :c:type:`Py_ssize_t` " "can take. It's usually ``2**31 - 1`` on a 32-bit platform and ``2**63 - 1`` " "on a 64-bit platform." msgstr "" -#: library/sys.rst:1223 +#: library/sys.rst:1225 msgid "" "An integer giving the value of the largest Unicode code point, i.e. " "``1114111`` (``0x10FFFF`` in hexadecimal)." msgstr "" -#: library/sys.rst:1226 +#: library/sys.rst:1228 msgid "" "Before :pep:`393`, ``sys.maxunicode`` used to be either ``0xFFFF`` or " "``0x10FFFF``, depending on the configuration option that specified whether " "Unicode characters were stored as UCS-2 or UCS-4." msgstr "" -#: library/sys.rst:1234 +#: library/sys.rst:1236 msgid "" "A list of :term:`meta path finder` objects that have their :meth:`~importlib." "abc.MetaPathFinder.find_spec` methods called to see if one of the objects " @@ -1501,35 +1501,40 @@ msgid "" "if the module cannot be found." msgstr "" -#: library/sys.rst:1247 +#: library/sys.rst:1249 msgid ":class:`importlib.abc.MetaPathFinder`" msgstr "" -#: library/sys.rst:1247 +#: library/sys.rst:1249 msgid "" "The abstract base class defining the interface of finder objects on :data:" "`meta_path`." msgstr "" -#: library/sys.rst:1251 +#: library/sys.rst:1253 msgid ":class:`importlib.machinery.ModuleSpec`" msgstr "" -#: library/sys.rst:1250 +#: library/sys.rst:1252 msgid "" "The concrete class which :meth:`~importlib.abc.MetaPathFinder.find_spec` " "should return instances of." msgstr "" -#: library/sys.rst:1256 +#: library/sys.rst:1258 msgid "" ":term:`Module specs ` were introduced in Python 3.4, by :pep:" -"`451`. Earlier versions of Python looked for a method called :meth:`!" -"find_module`. This is still called as a fallback if a :data:`meta_path` " -"entry doesn't have a :meth:`~importlib.abc.MetaPathFinder.find_spec` method." +"`451`." +msgstr "" + +#: library/sys.rst:1263 +msgid "" +"Removed the fallback that looked for a :meth:`!find_module` method if a :" +"data:`meta_path` entry didn't have a :meth:`~importlib.abc.MetaPathFinder." +"find_spec` method." msgstr "" -#: library/sys.rst:1264 +#: library/sys.rst:1269 msgid "" "This is a dictionary that maps module names to modules which have already " "been loaded. This can be manipulated to force reloading of modules and " @@ -1541,78 +1546,82 @@ msgid "" "other threads." msgstr "" -#: library/sys.rst:1276 +#: library/sys.rst:1281 msgid "" "The list of the original command line arguments passed to the Python " "executable." msgstr "" -#: library/sys.rst:1279 -msgid "See also :data:`sys.argv`." +#: library/sys.rst:1284 +msgid "" +"The elements of :data:`sys.orig_argv` are the arguments to the Python " +"interpreter, while the elements of :data:`sys.argv` are the arguments to the " +"user's program. Arguments consumed by the interpreter itself will be present " +"in :data:`sys.orig_argv` and missing from :data:`sys.argv`." msgstr "" -#: library/sys.rst:1288 +#: library/sys.rst:1296 msgid "" "A list of strings that specifies the search path for modules. Initialized " "from the environment variable :envvar:`PYTHONPATH`, plus an installation-" "dependent default." msgstr "" -#: library/sys.rst:1292 +#: library/sys.rst:1300 msgid "" "By default, as initialized upon program startup, a potentially unsafe path " "is prepended to :data:`sys.path` (*before* the entries inserted as a result " "of :envvar:`PYTHONPATH`):" msgstr "" -#: library/sys.rst:1296 +#: library/sys.rst:1304 msgid "" "``python -m module`` command line: prepend the current working directory." msgstr "" -#: library/sys.rst:1298 +#: library/sys.rst:1306 msgid "" "``python script.py`` command line: prepend the script's directory. If it's a " "symbolic link, resolve symbolic links." msgstr "" -#: library/sys.rst:1300 +#: library/sys.rst:1308 msgid "" "``python -c code`` and ``python`` (REPL) command lines: prepend an empty " "string, which means the current working directory." msgstr "" -#: library/sys.rst:1303 +#: library/sys.rst:1311 msgid "" "To not prepend this potentially unsafe path, use the :option:`-P` command " "line option or the :envvar:`PYTHONSAFEPATH` environment variable." msgstr "" -#: library/sys.rst:1306 +#: library/sys.rst:1314 msgid "" "A program is free to modify this list for its own purposes. Only strings " "should be added to :data:`sys.path`; all other data types are ignored during " "import." msgstr "" -#: library/sys.rst:1312 +#: library/sys.rst:1320 msgid "" "Module :mod:`site` This describes how to use .pth files to extend :data:`sys." "path`." msgstr "" -#: library/sys.rst:1317 +#: library/sys.rst:1325 msgid "" "A list of callables that take a path argument to try to create a :term:" "`finder` for the path. If a finder can be created, it is to be returned by " "the callable, else raise :exc:`ImportError`." msgstr "" -#: library/sys.rst:1332 +#: library/sys.rst:1340 msgid "Originally specified in :pep:`302`." msgstr "" -#: library/sys.rst:1326 +#: library/sys.rst:1334 msgid "" "A dictionary acting as a cache for :term:`finder` objects. The keys are " "paths that have been passed to :data:`sys.path_hooks` and the values are the " @@ -1620,13 +1629,13 @@ msgid "" "is found on :data:`sys.path_hooks` then ``None`` is stored." msgstr "" -#: library/sys.rst:1337 +#: library/sys.rst:1345 msgid "" "This string contains a platform identifier that can be used to append " "platform-specific components to :data:`sys.path`, for instance." msgstr "" -#: library/sys.rst:1340 +#: library/sys.rst:1348 msgid "" "For Unix systems, except on Linux and AIX, this is the lowercased OS name as " "returned by ``uname -s`` with the first part of the version as returned by " @@ -1635,75 +1644,75 @@ msgid "" "version, it is therefore recommended to use the following idiom::" msgstr "" -#: library/sys.rst:1353 +#: library/sys.rst:1361 msgid "For other systems, the values are:" msgstr "" -#: library/sys.rst:1356 +#: library/sys.rst:1364 msgid "System" msgstr "" -#: library/sys.rst:1356 +#: library/sys.rst:1364 msgid "``platform`` value" msgstr "" -#: library/sys.rst:1358 +#: library/sys.rst:1366 msgid "AIX" msgstr "" -#: library/sys.rst:1358 +#: library/sys.rst:1366 msgid "``'aix'``" msgstr "" -#: library/sys.rst:1359 +#: library/sys.rst:1367 msgid "Emscripten" msgstr "" -#: library/sys.rst:1359 +#: library/sys.rst:1367 msgid "``'emscripten'``" msgstr "" -#: library/sys.rst:1360 +#: library/sys.rst:1368 msgid "Linux" msgstr "" -#: library/sys.rst:1360 +#: library/sys.rst:1368 msgid "``'linux'``" msgstr "" -#: library/sys.rst:1361 +#: library/sys.rst:1369 msgid "WASI" msgstr "" -#: library/sys.rst:1361 +#: library/sys.rst:1369 msgid "``'wasi'``" msgstr "" -#: library/sys.rst:1362 +#: library/sys.rst:1370 msgid "Windows" msgstr "" -#: library/sys.rst:1362 +#: library/sys.rst:1370 msgid "``'win32'``" msgstr "" -#: library/sys.rst:1363 +#: library/sys.rst:1371 msgid "Windows/Cygwin" msgstr "" -#: library/sys.rst:1363 +#: library/sys.rst:1371 msgid "``'cygwin'``" msgstr "" -#: library/sys.rst:1364 +#: library/sys.rst:1372 msgid "macOS" msgstr "" -#: library/sys.rst:1364 +#: library/sys.rst:1372 msgid "``'darwin'``" msgstr "" -#: library/sys.rst:1367 +#: library/sys.rst:1375 msgid "" "On Linux, :data:`sys.platform` doesn't contain the major version anymore. It " "is always ``'linux'``, instead of ``'linux2'`` or ``'linux3'``. Since older " @@ -1711,7 +1720,7 @@ msgid "" "the ``startswith`` idiom presented above." msgstr "" -#: library/sys.rst:1373 +#: library/sys.rst:1381 msgid "" "On AIX, :data:`sys.platform` doesn't contain the major version anymore. It " "is always ``'aix'``, instead of ``'aix5'`` or ``'aix7'``. Since older " @@ -1719,57 +1728,57 @@ msgid "" "the ``startswith`` idiom presented above." msgstr "" -#: library/sys.rst:1381 +#: library/sys.rst:1389 msgid "" ":data:`os.name` has a coarser granularity. :func:`os.uname` gives system-" "dependent version information." msgstr "" -#: library/sys.rst:1384 +#: library/sys.rst:1392 msgid "" "The :mod:`platform` module provides detailed checks for the system's " "identity." msgstr "" -#: library/sys.rst:1390 +#: library/sys.rst:1398 msgid "" "Name of the platform-specific library directory. It is used to build the " "path of standard library and the paths of installed extension modules." msgstr "" -#: library/sys.rst:1393 +#: library/sys.rst:1401 msgid "" "It is equal to ``\"lib\"`` on most platforms. On Fedora and SuSE, it is " "equal to ``\"lib64\"`` on 64-bit platforms which gives the following ``sys." "path`` paths (where ``X.Y`` is the Python ``major.minor`` version):" msgstr "" -#: library/sys.rst:1397 +#: library/sys.rst:1405 msgid "" "``/usr/lib64/pythonX.Y/``: Standard library (like ``os.py`` of the :mod:`os` " "module)" msgstr "" -#: library/sys.rst:1399 +#: library/sys.rst:1407 msgid "" "``/usr/lib64/pythonX.Y/lib-dynload/``: C extension modules of the standard " "library (like the :mod:`errno` module, the exact filename is platform " "specific)" msgstr "" -#: library/sys.rst:1402 +#: library/sys.rst:1410 msgid "" "``/usr/lib/pythonX.Y/site-packages/`` (always use ``lib``, not :data:`sys." "platlibdir`): Third-party modules" msgstr "" -#: library/sys.rst:1404 +#: library/sys.rst:1412 msgid "" "``/usr/lib64/pythonX.Y/site-packages/``: C extension modules of third-party " "packages" msgstr "" -#: library/sys.rst:1412 +#: library/sys.rst:1420 msgid "" "A string giving the site-specific directory prefix where the platform " "independent Python files are installed; on Unix, the default is :file:`/usr/" @@ -1778,14 +1787,14 @@ msgid "" "derived paths." msgstr "" -#: library/sys.rst:1418 +#: library/sys.rst:1426 msgid "" "If a :ref:`virtual environment ` is in effect, this value will be " "changed in ``site.py`` to point to the virtual environment. The value for " "the Python installation will still be available, via :data:`base_prefix`." msgstr "" -#: library/sys.rst:1433 +#: library/sys.rst:1441 msgid "" "Strings specifying the primary and secondary prompt of the interpreter. " "These are only defined if the interpreter is in interactive mode. Their " @@ -1795,7 +1804,7 @@ msgid "" "used to implement a dynamic prompt." msgstr "" -#: library/sys.rst:1443 +#: library/sys.rst:1451 msgid "" "Set the flags used by the interpreter for :c:func:`dlopen` calls, such as " "when the interpreter loads extension modules. Among other things, this will " @@ -1806,14 +1815,14 @@ msgid "" "g. :const:`os.RTLD_LAZY`)." msgstr "" -#: library/sys.rst:1455 +#: library/sys.rst:1463 msgid "" "Set the :ref:`integer string conversion length limitation " "` used by this interpreter. See also :func:" "`get_int_max_str_digits`." msgstr "" -#: library/sys.rst:1467 +#: library/sys.rst:1475 msgid "" "Set the system's profile function, which allows you to implement a Python " "source code profiler in Python. See chapter :ref:`profile` for more " @@ -1828,14 +1837,14 @@ msgid "" "in the profile function will cause itself unset." msgstr "" -#: library/sys.rst:1479 +#: library/sys.rst:1487 msgid "" "The same tracing mechanism is used for :func:`!setprofile` as :func:" "`settrace`. To trace calls with :func:`!setprofile` inside a tracing " "function (e.g. in a debugger breakpoint), see :func:`call_tracing`." msgstr "" -#: library/sys.rst:1483 +#: library/sys.rst:1491 msgid "" "Profile functions should have three arguments: *frame*, *event*, and *arg*. " "*frame* is the current stack frame. *event* is a string: ``'call'``, " @@ -1843,71 +1852,71 @@ msgid "" "depends on the event type." msgstr "" -#: library/sys.rst:1575 +#: library/sys.rst:1583 msgid "The events have the following meaning:" msgstr "" -#: library/sys.rst:1580 +#: library/sys.rst:1588 msgid "``'call'``" msgstr "" -#: library/sys.rst:1491 +#: library/sys.rst:1499 msgid "" "A function is called (or some other code block entered). The profile " "function is called; *arg* is ``None``." msgstr "" -#: library/sys.rst:1596 +#: library/sys.rst:1604 msgid "``'return'``" msgstr "" -#: library/sys.rst:1495 +#: library/sys.rst:1503 msgid "" "A function (or other code block) is about to return. The profile function " "is called; *arg* is the value that will be returned, or ``None`` if the " "event is caused by an exception being raised." msgstr "" -#: library/sys.rst:1501 +#: library/sys.rst:1509 msgid "``'c_call'``" msgstr "" -#: library/sys.rst:1500 +#: library/sys.rst:1508 msgid "" "A C function is about to be called. This may be an extension function or a " "built-in. *arg* is the C function object." msgstr "" -#: library/sys.rst:1504 +#: library/sys.rst:1512 msgid "``'c_return'``" msgstr "" -#: library/sys.rst:1504 +#: library/sys.rst:1512 msgid "A C function has returned. *arg* is the C function object." msgstr "" -#: library/sys.rst:1507 +#: library/sys.rst:1515 msgid "``'c_exception'``" msgstr "" -#: library/sys.rst:1507 +#: library/sys.rst:1515 msgid "A C function has raised an exception. *arg* is the C function object." msgstr "" -#: library/sys.rst:1509 +#: library/sys.rst:1517 msgid "" "Raises an :ref:`auditing event ` ``sys.setprofile`` with no " "arguments." msgstr "" -#: library/sys.rst:1514 +#: library/sys.rst:1522 msgid "" "Set the maximum depth of the Python interpreter stack to *limit*. This " "limit prevents infinite recursion from causing an overflow of the C stack " "and crashing Python." msgstr "" -#: library/sys.rst:1518 +#: library/sys.rst:1526 msgid "" "The highest possible limit is platform-dependent. A user may need to set " "the limit higher when they have a program that requires deep recursion and a " @@ -1915,19 +1924,19 @@ msgid "" "because a too-high limit can lead to a crash." msgstr "" -#: library/sys.rst:1523 +#: library/sys.rst:1531 msgid "" "If the new limit is too low at the current recursion depth, a :exc:" "`RecursionError` exception is raised." msgstr "" -#: library/sys.rst:1526 +#: library/sys.rst:1534 msgid "" "A :exc:`RecursionError` exception is now raised if the new limit is too low " "at the current recursion depth." msgstr "" -#: library/sys.rst:1533 +#: library/sys.rst:1541 msgid "" "Set the interpreter's thread switch interval (in seconds). This floating-" "point value determines the ideal duration of the \"timeslices\" allocated to " @@ -1938,7 +1947,7 @@ msgid "" "scheduler." msgstr "" -#: library/sys.rst:1550 +#: library/sys.rst:1558 msgid "" "Set the system's trace function, which allows you to implement a Python " "source code debugger in Python. The function is thread-specific; for a " @@ -1947,7 +1956,7 @@ msgid "" "`threading.settrace`." msgstr "" -#: library/sys.rst:1555 +#: library/sys.rst:1563 msgid "" "Trace functions should have three arguments: *frame*, *event*, and *arg*. " "*frame* is the current stack frame. *event* is a string: ``'call'``, " @@ -1955,7 +1964,7 @@ msgid "" "the event type." msgstr "" -#: library/sys.rst:1560 +#: library/sys.rst:1568 msgid "" "The trace function is invoked (with *event* set to ``'call'``) whenever a " "new local scope is entered; it should return a reference to a local trace " @@ -1963,36 +1972,36 @@ msgid "" "traced." msgstr "" -#: library/sys.rst:1565 +#: library/sys.rst:1573 msgid "" "The local trace function should return a reference to itself, or to another " "function which would then be used as the local trace function for the scope." msgstr "" -#: library/sys.rst:1568 +#: library/sys.rst:1576 msgid "" "If there is any error occurred in the trace function, it will be unset, just " "like ``settrace(None)`` is called." msgstr "" -#: library/sys.rst:1572 +#: library/sys.rst:1580 msgid "" "Tracing is disabled while calling the trace function (e.g. a function set " "by :func:`!settrace`). For recursive tracing see :func:`call_tracing`." msgstr "" -#: library/sys.rst:1578 +#: library/sys.rst:1586 msgid "" "A function is called (or some other code block entered). The global trace " "function is called; *arg* is ``None``; the return value specifies the local " "trace function." msgstr "" -#: library/sys.rst:1590 +#: library/sys.rst:1598 msgid "``'line'``" msgstr "" -#: library/sys.rst:1583 +#: library/sys.rst:1591 msgid "" "The interpreter is about to execute a new line of code or re-execute the " "condition of a loop. The local trace function is called; *arg* is ``None``; " @@ -2002,7 +2011,7 @@ msgid "" "to :const:`False` on that :ref:`frame `." msgstr "" -#: library/sys.rst:1593 +#: library/sys.rst:1601 msgid "" "A function (or other code block) is about to return. The local trace " "function is called; *arg* is the value that will be returned, or ``None`` if " @@ -2010,22 +2019,22 @@ msgid "" "return value is ignored." msgstr "" -#: library/sys.rst:1601 +#: library/sys.rst:1609 msgid "``'exception'``" msgstr "" -#: library/sys.rst:1599 +#: library/sys.rst:1607 msgid "" "An exception has occurred. The local trace function is called; *arg* is a " "tuple ``(exception, value, traceback)``; the return value specifies the new " "local trace function." msgstr "" -#: library/sys.rst:1609 +#: library/sys.rst:1617 msgid "``'opcode'``" msgstr "" -#: library/sys.rst:1604 +#: library/sys.rst:1612 msgid "" "The interpreter is about to execute a new opcode (see :mod:`dis` for opcode " "details). The local trace function is called; *arg* is ``None``; the return " @@ -2035,13 +2044,13 @@ msgid "" "objects>`." msgstr "" -#: library/sys.rst:1611 +#: library/sys.rst:1619 msgid "" "Note that as an exception is propagated down the chain of callers, an " "``'exception'`` event is generated at each level." msgstr "" -#: library/sys.rst:1614 +#: library/sys.rst:1622 msgid "" "For more fine-grained usage, it's possible to set a trace function by " "assigning ``frame.f_trace = tracefunc`` explicitly, rather than relying on " @@ -2055,17 +2064,17 @@ msgid "" "on each frame)." msgstr "" -#: library/sys.rst:1625 +#: library/sys.rst:1633 msgid "For more information on code and frame objects, refer to :ref:`types`." msgstr "" -#: library/sys.rst:1627 +#: library/sys.rst:1635 msgid "" "Raises an :ref:`auditing event ` ``sys.settrace`` with no " "arguments." msgstr "" -#: library/sys.rst:1631 +#: library/sys.rst:1639 msgid "" "The :func:`settrace` function is intended only for implementing debuggers, " "profilers, coverage tools and the like. Its behavior is part of the " @@ -2073,13 +2082,21 @@ msgid "" "thus may not be available in all Python implementations." msgstr "" -#: library/sys.rst:1638 +#: library/sys.rst:1646 msgid "" "``'opcode'`` event type added; :attr:`~frame.f_trace_lines` and :attr:" "`~frame.f_trace_opcodes` attributes added to frames" msgstr "" -#: library/sys.rst:1643 +#: library/sys.rst:1649 +msgid "" +"``'opcode'`` event will only be emitted if :attr:`~frame.f_trace_opcodes` of " +"at least one frame has been set to :const:`True` before :func:`settrace` is " +"called. This behavior will be changed back in 3.13 to be consistent with " +"previous versions." +msgstr "" + +#: library/sys.rst:1657 msgid "" "Accepts two optional keyword arguments which are callables that accept an :" "term:`asynchronous generator iterator` as an argument. The *firstiter* " @@ -2088,32 +2105,32 @@ msgid "" "about to be garbage collected." msgstr "" -#: library/sys.rst:1649 +#: library/sys.rst:1663 msgid "" "Raises an :ref:`auditing event ` ``sys." "set_asyncgen_hooks_firstiter`` with no arguments." msgstr "" -#: library/sys.rst:1651 +#: library/sys.rst:1665 msgid "" "Raises an :ref:`auditing event ` ``sys." "set_asyncgen_hooks_finalizer`` with no arguments." msgstr "" -#: library/sys.rst:1653 +#: library/sys.rst:1667 msgid "" "Two auditing events are raised because the underlying API consists of two " "calls, each of which must raise its own event." msgstr "" -#: library/sys.rst:1656 +#: library/sys.rst:1670 msgid "" "See :pep:`525` for more details, and for a reference example of a " "*finalizer* method see the implementation of ``asyncio.Loop." "shutdown_asyncgens`` in :source:`Lib/asyncio/base_events.py`" msgstr "" -#: library/sys.rst:1668 +#: library/sys.rst:1682 msgid "" "Allows enabling or disabling coroutine origin tracking. When enabled, the " "``cr_origin`` attribute on coroutine objects will contain a tuple of " @@ -2122,104 +2139,104 @@ msgid "" "disabled, ``cr_origin`` will be None." msgstr "" -#: library/sys.rst:1675 +#: library/sys.rst:1689 msgid "" "To enable, pass a *depth* value greater than zero; this sets the number of " "frames whose information will be captured. To disable, pass set *depth* to " "zero." msgstr "" -#: library/sys.rst:1679 +#: library/sys.rst:1693 msgid "This setting is thread-specific." msgstr "" -#: library/sys.rst:1689 +#: library/sys.rst:1703 msgid "" "Activate the stack profiler trampoline *backend*. The only supported backend " "is ``\"perf\"``." msgstr "" -#: library/sys.rst:1707 library/sys.rst:1715 +#: library/sys.rst:1721 library/sys.rst:1729 msgid ":ref:`Availability `: Linux." msgstr "" -#: library/sys.rst:1698 +#: library/sys.rst:1712 msgid ":ref:`perf_profiling`" msgstr "" -#: library/sys.rst:1699 +#: library/sys.rst:1713 msgid "https://perf.wiki.kernel.org" msgstr "" -#: library/sys.rst:1703 +#: library/sys.rst:1717 msgid "Deactivate the current stack profiler trampoline backend." msgstr "" -#: library/sys.rst:1705 +#: library/sys.rst:1719 msgid "If no stack profiler is activated, this function has no effect." msgstr "" -#: library/sys.rst:1713 +#: library/sys.rst:1727 msgid "Return ``True`` if a stack profiler trampoline is active." msgstr "" -#: library/sys.rst:1721 +#: library/sys.rst:1735 msgid "" "Changes the :term:`filesystem encoding and error handler` to 'mbcs' and " "'replace' respectively, for consistency with versions of Python prior to 3.6." msgstr "" -#: library/sys.rst:1725 +#: library/sys.rst:1739 msgid "" "This is equivalent to defining the :envvar:`PYTHONLEGACYWINDOWSFSENCODING` " "environment variable before launching Python." msgstr "" -#: library/sys.rst:1728 +#: library/sys.rst:1742 msgid "" "See also :func:`sys.getfilesystemencoding` and :func:`sys." "getfilesystemencodeerrors`." msgstr "" -#: library/sys.rst:1733 +#: library/sys.rst:1747 msgid "See :pep:`529` for more details." msgstr "" -#: library/sys.rst:1740 +#: library/sys.rst:1754 msgid "" ":term:`File objects ` used by the interpreter for standard " "input, output and errors:" msgstr "" -#: library/sys.rst:1743 +#: library/sys.rst:1757 msgid "" "``stdin`` is used for all interactive input (including calls to :func:" "`input`);" msgstr "" -#: library/sys.rst:1745 +#: library/sys.rst:1759 msgid "" "``stdout`` is used for the output of :func:`print` and :term:`expression` " "statements and for the prompts of :func:`input`;" msgstr "" -#: library/sys.rst:1747 +#: library/sys.rst:1761 msgid "The interpreter's own prompts and its error messages go to ``stderr``." msgstr "" -#: library/sys.rst:1749 +#: library/sys.rst:1763 msgid "" "These streams are regular :term:`text files ` like those returned " "by the :func:`open` function. Their parameters are chosen as follows:" msgstr "" -#: library/sys.rst:1753 +#: library/sys.rst:1767 msgid "" "The encoding and error handling are is initialized from :c:member:`PyConfig." "stdio_encoding` and :c:member:`PyConfig.stdio_errors`." msgstr "" -#: library/sys.rst:1756 +#: library/sys.rst:1770 msgid "" "On Windows, UTF-8 is used for the console device. Non-character devices " "such as disk files and pipes use the system locale encoding (i.e. the ANSI " @@ -2230,14 +2247,14 @@ msgid "" "initially attached to a console." msgstr "" -#: library/sys.rst:1765 +#: library/sys.rst:1779 msgid "" "The special behaviour of the console can be overridden by setting the " "environment variable PYTHONLEGACYWINDOWSSTDIO before starting Python. In " "that case, the console codepages are used as for any other character device." msgstr "" -#: library/sys.rst:1770 +#: library/sys.rst:1784 msgid "" "Under all platforms, you can override the character encoding by setting the :" "envvar:`PYTHONIOENCODING` environment variable before starting Python or by " @@ -2246,7 +2263,7 @@ msgid "" "only applies when :envvar:`PYTHONLEGACYWINDOWSSTDIO` is also set." msgstr "" -#: library/sys.rst:1777 +#: library/sys.rst:1791 msgid "" "When interactive, the ``stdout`` stream is line-buffered. Otherwise, it is " "block-buffered like regular text files. The ``stderr`` stream is line-" @@ -2255,19 +2272,19 @@ msgid "" "`PYTHONUNBUFFERED` environment variable." msgstr "" -#: library/sys.rst:1783 +#: library/sys.rst:1797 msgid "" "Non-interactive ``stderr`` is now line-buffered instead of fully buffered." msgstr "" -#: library/sys.rst:1789 +#: library/sys.rst:1803 msgid "" "To write or read binary data from/to the standard streams, use the " "underlying binary :data:`~io.TextIOBase.buffer` object. For example, to " "write bytes to :data:`stdout`, use ``sys.stdout.buffer.write(b'abc')``." msgstr "" -#: library/sys.rst:1793 +#: library/sys.rst:1807 msgid "" "However, if you are writing a library (and do not control in which context " "its code will be executed), be aware that the standard streams may be " @@ -2275,7 +2292,7 @@ msgid "" "support the :attr:`!buffer` attribute." msgstr "" -#: library/sys.rst:1803 +#: library/sys.rst:1817 msgid "" "These objects contain the original values of ``stdin``, ``stderr`` and " "``stdout`` at the start of the program. They are used during finalization, " @@ -2283,7 +2300,7 @@ msgid "" "``sys.std*`` object has been redirected." msgstr "" -#: library/sys.rst:1808 +#: library/sys.rst:1822 msgid "" "It can also be used to restore the actual files to known working file " "objects in case they have been overwritten with a broken object. However, " @@ -2291,7 +2308,7 @@ msgid "" "before replacing it, and restore the saved object." msgstr "" -#: library/sys.rst:1814 +#: library/sys.rst:1828 msgid "" "Under some conditions ``stdin``, ``stdout`` and ``stderr`` as well as the " "original values ``__stdin__``, ``__stdout__`` and ``__stderr__`` can be " @@ -2299,12 +2316,12 @@ msgid "" "to a console and Python apps started with :program:`pythonw`." msgstr "" -#: library/sys.rst:1822 +#: library/sys.rst:1836 msgid "" "A frozenset of strings containing the names of standard library modules." msgstr "" -#: library/sys.rst:1824 +#: library/sys.rst:1838 msgid "" "It is the same on all platforms. Modules which are not available on some " "platforms and modules disabled at Python build are also listed. All module " @@ -2312,7 +2329,7 @@ msgid "" "modules are excluded." msgstr "" -#: library/sys.rst:1829 +#: library/sys.rst:1843 msgid "" "For packages, only the main package is listed: sub-packages and sub-modules " "are not listed. For example, the ``email`` package is listed, but the " @@ -2320,60 +2337,60 @@ msgid "" "listed." msgstr "" -#: library/sys.rst:1834 +#: library/sys.rst:1848 msgid "See also the :data:`sys.builtin_module_names` list." msgstr "" -#: library/sys.rst:1841 +#: library/sys.rst:1855 msgid "" "A :term:`named tuple` holding information about the thread implementation." msgstr "" -#: library/sys.rst:1846 +#: library/sys.rst:1860 msgid "The name of the thread implementation:" msgstr "" -#: library/sys.rst:1848 +#: library/sys.rst:1862 msgid "``\"nt\"``: Windows threads" msgstr "" -#: library/sys.rst:1849 +#: library/sys.rst:1863 msgid "``\"pthread\"``: POSIX threads" msgstr "" -#: library/sys.rst:1850 +#: library/sys.rst:1864 msgid "" "``\"pthread-stubs\"``: stub POSIX threads (on WebAssembly platforms without " "threading support)" msgstr "" -#: library/sys.rst:1852 +#: library/sys.rst:1866 msgid "``\"solaris\"``: Solaris threads" msgstr "" -#: library/sys.rst:1856 +#: library/sys.rst:1870 msgid "The name of the lock implementation:" msgstr "" -#: library/sys.rst:1858 +#: library/sys.rst:1872 msgid "``\"semaphore\"``: a lock uses a semaphore" msgstr "" -#: library/sys.rst:1859 +#: library/sys.rst:1873 msgid "``\"mutex+cond\"``: a lock uses a mutex and a condition variable" msgstr "" -#: library/sys.rst:1860 +#: library/sys.rst:1874 msgid "``None`` if this information is unknown" msgstr "" -#: library/sys.rst:1864 +#: library/sys.rst:1878 msgid "" "The name and version of the thread library. It is a string, or ``None`` if " "this information is unknown." msgstr "" -#: library/sys.rst:1872 +#: library/sys.rst:1886 msgid "" "When this variable is set to an integer value, it determines the maximum " "number of levels of traceback information printed when an unhandled " @@ -2382,79 +2399,79 @@ msgid "" "are printed." msgstr "" -#: library/sys.rst:1880 +#: library/sys.rst:1894 msgid "Handle an unraisable exception." msgstr "" -#: library/sys.rst:1882 +#: library/sys.rst:1896 msgid "" "Called when an exception has occurred but there is no way for Python to " "handle it. For example, when a destructor raises an exception or during " "garbage collection (:func:`gc.collect`)." msgstr "" -#: library/sys.rst:1886 +#: library/sys.rst:1900 msgid "The *unraisable* argument has the following attributes:" msgstr "" -#: library/sys.rst:1888 +#: library/sys.rst:1902 msgid ":attr:`!exc_type`: Exception type." msgstr "" -#: library/sys.rst:1889 +#: library/sys.rst:1903 msgid ":attr:`!exc_value`: Exception value, can be ``None``." msgstr "" -#: library/sys.rst:1890 +#: library/sys.rst:1904 msgid ":attr:`!exc_traceback`: Exception traceback, can be ``None``." msgstr "" -#: library/sys.rst:1891 +#: library/sys.rst:1905 msgid ":attr:`!err_msg`: Error message, can be ``None``." msgstr "" -#: library/sys.rst:1892 +#: library/sys.rst:1906 msgid ":attr:`!object`: Object causing the exception, can be ``None``." msgstr "" -#: library/sys.rst:1894 +#: library/sys.rst:1908 msgid "" "The default hook formats :attr:`!err_msg` and :attr:`!object` as: " "``f'{err_msg}: {object!r}'``; use \"Exception ignored in\" error message if :" "attr:`!err_msg` is ``None``." msgstr "" -#: library/sys.rst:1898 +#: library/sys.rst:1912 msgid "" ":func:`sys.unraisablehook` can be overridden to control how unraisable " "exceptions are handled." msgstr "" -#: library/sys.rst:1903 +#: library/sys.rst:1917 msgid ":func:`excepthook` which handles uncaught exceptions." msgstr "" -#: library/sys.rst:1907 +#: library/sys.rst:1921 msgid "" "Storing :attr:`!exc_value` using a custom hook can create a reference cycle. " "It should be cleared explicitly to break the reference cycle when the " "exception is no longer needed." msgstr "" -#: library/sys.rst:1911 +#: library/sys.rst:1925 msgid "" "Storing :attr:`!object` using a custom hook can resurrect it if it is set to " "an object which is being finalized. Avoid storing :attr:`!object` after the " "custom hook completes to avoid resurrecting objects." msgstr "" -#: library/sys.rst:1915 +#: library/sys.rst:1929 msgid "" "Raises an :ref:`auditing event ` ``sys.unraisablehook`` with " "arguments ``hook``, ``unraisable``." msgstr "" -#: library/sys.rst:1917 +#: library/sys.rst:1931 msgid "" "Raise an auditing event ``sys.unraisablehook`` with arguments *hook*, " "*unraisable* when an exception that cannot be handled occurs. The " @@ -2462,7 +2479,7 @@ msgid "" "hook has been set, *hook* may be ``None``." msgstr "" -#: library/sys.rst:1926 +#: library/sys.rst:1940 msgid "" "A string containing the version number of the Python interpreter plus " "additional information on the build number and compiler used. This string " @@ -2471,13 +2488,13 @@ msgid "" "functions provided by the :mod:`platform` module." msgstr "" -#: library/sys.rst:1935 +#: library/sys.rst:1949 msgid "" "The C API version for this interpreter. Programmers may find this useful " "when debugging version conflicts between Python and extension modules." msgstr "" -#: library/sys.rst:1941 +#: library/sys.rst:1955 msgid "" "A tuple containing the five components of the version number: *major*, " "*minor*, *micro*, *releaselevel*, and *serial*. All values except " @@ -2488,18 +2505,18 @@ msgid "" "version_info.major`` and so on." msgstr "" -#: library/sys.rst:1949 +#: library/sys.rst:1963 msgid "Added named component attributes." msgstr "" -#: library/sys.rst:1954 +#: library/sys.rst:1968 msgid "" "This is an implementation detail of the warnings framework; do not modify " "this value. Refer to the :mod:`warnings` module for more information on the " "warnings framework." msgstr "" -#: library/sys.rst:1961 +#: library/sys.rst:1975 msgid "" "The version number used to form registry keys on Windows platforms. This is " "stored as string resource 1000 in the Python DLL. The value is normally the " @@ -2508,93 +2525,93 @@ msgid "" "has no effect on the registry keys used by Python." msgstr "" -#: library/sys.rst:1973 +#: library/sys.rst:1987 msgid "" "Namespace containing functions and constants for register callbacks and " "controlling monitoring events. See :mod:`sys.monitoring` for details." msgstr "" -#: library/sys.rst:1979 +#: library/sys.rst:1993 msgid "" "A dictionary of the various implementation-specific flags passed through " "the :option:`-X` command-line option. Option names are either mapped to " "their values, if given explicitly, or to :const:`True`. Example:" msgstr "" -#: library/sys.rst:1995 +#: library/sys.rst:2009 msgid "" "This is a CPython-specific way of accessing options passed through :option:`-" "X`. Other implementations may export them through other means, or not at " "all." msgstr "" -#: library/sys.rst:2003 +#: library/sys.rst:2017 msgid "Citations" msgstr "" -#: library/sys.rst:2004 +#: library/sys.rst:2018 msgid "" "ISO/IEC 9899:1999. \"Programming languages -- C.\" A public draft of this " "standard is available at https://www.open-std.org/jtc1/sc22/wg14/www/docs/" "n1256.pdf\\ ." msgstr "" -#: library/sys.rst:97 +#: library/sys.rst:99 msgid "auditing" msgstr "" -#: library/sys.rst:449 +#: library/sys.rst:451 msgid "object" msgstr "" -#: library/sys.rst:449 +#: library/sys.rst:451 msgid "traceback" msgstr "" -#: library/sys.rst:1463 +#: library/sys.rst:1471 msgid "profile function" msgstr "" -#: library/sys.rst:1463 +#: library/sys.rst:1471 msgid "profiler" msgstr "" -#: library/sys.rst:1546 +#: library/sys.rst:1554 msgid "trace function" msgstr "" -#: library/sys.rst:1546 +#: library/sys.rst:1554 msgid "debugger" msgstr "" -#: library/sys.rst:1286 +#: library/sys.rst:1294 msgid "module" msgstr "" -#: library/sys.rst:1286 +#: library/sys.rst:1294 msgid "search" msgstr "" -#: library/sys.rst:1286 +#: library/sys.rst:1294 msgid "path" msgstr "" -#: library/sys.rst:1427 +#: library/sys.rst:1435 msgid "interpreter prompts" msgstr "" -#: library/sys.rst:1427 +#: library/sys.rst:1435 msgid "prompts, interpreter" msgstr "" -#: library/sys.rst:1427 +#: library/sys.rst:1435 msgid ">>>" msgstr "" -#: library/sys.rst:1427 +#: library/sys.rst:1435 msgid "interpreter prompt" msgstr "" -#: library/sys.rst:1427 +#: library/sys.rst:1435 msgid "..." msgstr "" diff --git a/library/tarfile.po b/library/tarfile.po index 1604ec914..09d1e016a 100644 --- a/library/tarfile.po +++ b/library/tarfile.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -665,7 +665,7 @@ msgid "" "be added as a pax global header if *format* is :const:`PAX_FORMAT`." msgstr "" -#: library/tarfile.rst:728 +#: library/tarfile.rst:729 msgid "Use ``'surrogateescape'`` as the default for the *errors* argument." msgstr "" @@ -932,15 +932,15 @@ msgid "" "appended to the archive." msgstr "" -#: library/tarfile.rst:672 +#: library/tarfile.rst:673 msgid "A dictionary containing key-value pairs of pax global headers." msgstr "" -#: library/tarfile.rst:679 +#: library/tarfile.rst:680 msgid "TarInfo Objects" msgstr "" -#: library/tarfile.rst:681 +#: library/tarfile.rst:682 msgid "" "A :class:`TarInfo` object represents one member in a :class:`TarFile`. Aside " "from storing all required attributes of a file (like file type, size, time, " @@ -948,14 +948,14 @@ msgid "" "type. It does *not* contain the file's data itself." msgstr "" -#: library/tarfile.rst:686 +#: library/tarfile.rst:687 msgid "" ":class:`TarInfo` objects are returned by :class:`TarFile`'s methods :meth:" "`~TarFile.getmember`, :meth:`~TarFile.getmembers` and :meth:`~TarFile." "gettarinfo`." msgstr "" -#: library/tarfile.rst:690 +#: library/tarfile.rst:691 msgid "" "Modifying the objects returned by :meth:`~TarFile.getmember` or :meth:" "`~TarFile.getmembers` will affect all subsequent operations on the archive. " @@ -964,80 +964,80 @@ msgid "" "step." msgstr "" -#: library/tarfile.rst:696 +#: library/tarfile.rst:697 msgid "" "Several attributes can be set to ``None`` to indicate that a piece of " "metadata is unused or unknown. Different :class:`TarInfo` methods handle " "``None`` differently:" msgstr "" -#: library/tarfile.rst:700 +#: library/tarfile.rst:701 msgid "" "The :meth:`~TarFile.extract` or :meth:`~TarFile.extractall` methods will " "ignore the corresponding metadata, leaving it set to a default." msgstr "" -#: library/tarfile.rst:702 +#: library/tarfile.rst:703 msgid ":meth:`~TarFile.addfile` will fail." msgstr "" -#: library/tarfile.rst:703 +#: library/tarfile.rst:704 msgid ":meth:`~TarFile.list` will print a placeholder string." msgstr "" -#: library/tarfile.rst:707 +#: library/tarfile.rst:708 msgid "Create a :class:`TarInfo` object." msgstr "" -#: library/tarfile.rst:712 +#: library/tarfile.rst:713 msgid "Create and return a :class:`TarInfo` object from string buffer *buf*." msgstr "" -#: library/tarfile.rst:714 +#: library/tarfile.rst:715 msgid "Raises :exc:`HeaderError` if the buffer is invalid." msgstr "" -#: library/tarfile.rst:719 +#: library/tarfile.rst:720 msgid "" "Read the next member from the :class:`TarFile` object *tarfile* and return " "it as a :class:`TarInfo` object." msgstr "" -#: library/tarfile.rst:725 +#: library/tarfile.rst:726 msgid "" "Create a string buffer from a :class:`TarInfo` object. For information on " "the arguments see the constructor of the :class:`TarFile` class." msgstr "" -#: library/tarfile.rst:732 +#: library/tarfile.rst:733 msgid "A ``TarInfo`` object has the following public data attributes:" msgstr "" -#: library/tarfile.rst:738 +#: library/tarfile.rst:739 msgid "Name of the archive member." msgstr "" -#: library/tarfile.rst:744 +#: library/tarfile.rst:745 msgid "Size in bytes." msgstr "" -#: library/tarfile.rst:750 +#: library/tarfile.rst:751 msgid "" "Time of last modification in seconds since the :ref:`epoch `, as in :" "attr:`os.stat_result.st_mtime`." msgstr "" -#: library/tarfile.rst:766 library/tarfile.rst:809 library/tarfile.rst:831 +#: library/tarfile.rst:767 library/tarfile.rst:810 library/tarfile.rst:832 msgid "" "Can be set to ``None`` for :meth:`~TarFile.extract` and :meth:`~TarFile." "extractall`, causing extraction to skip applying this attribute." msgstr "" -#: library/tarfile.rst:762 +#: library/tarfile.rst:763 msgid "Permission bits, as for :func:`os.chmod`." msgstr "" -#: library/tarfile.rst:772 +#: library/tarfile.rst:773 msgid "" "File type. *type* is usually one of these constants: :const:`REGTYPE`, :" "const:`AREGTYPE`, :const:`LNKTYPE`, :const:`SYMTYPE`, :const:`DIRTYPE`, :" @@ -1046,100 +1046,124 @@ msgid "" "more conveniently, use the ``is*()`` methods below." msgstr "" -#: library/tarfile.rst:782 +#: library/tarfile.rst:783 msgid "" "Name of the target file name, which is only present in :class:`TarInfo` " "objects of type :const:`LNKTYPE` and :const:`SYMTYPE`." msgstr "" -#: library/tarfile.rst:785 +#: library/tarfile.rst:786 msgid "" "For symbolic links (``SYMTYPE``), the *linkname* is relative to the " "directory that contains the link. For hard links (``LNKTYPE``), the " "*linkname* is relative to the root of the archive." msgstr "" -#: library/tarfile.rst:794 +#: library/tarfile.rst:795 msgid "User ID of the user who originally stored this member." msgstr "" -#: library/tarfile.rst:805 +#: library/tarfile.rst:806 msgid "Group ID of the user who originally stored this member." msgstr "" -#: library/tarfile.rst:816 +#: library/tarfile.rst:817 msgid "User name." msgstr "" -#: library/tarfile.rst:827 +#: library/tarfile.rst:828 msgid "Group name." msgstr "" -#: library/tarfile.rst:838 +#: library/tarfile.rst:839 +msgid "Header checksum." +msgstr "" + +#: library/tarfile.rst:845 +msgid "Device major number." +msgstr "" + +#: library/tarfile.rst:851 +msgid "Device minor number." +msgstr "" + +#: library/tarfile.rst:857 +msgid "The tar header starts here." +msgstr "" + +#: library/tarfile.rst:863 +msgid "The file's data starts here." +msgstr "" + +#: library/tarfile.rst:868 +msgid "Sparse member information." +msgstr "" + +#: library/tarfile.rst:874 msgid "" "A dictionary containing key-value pairs of an associated pax extended header." msgstr "" -#: library/tarfile.rst:846 +#: library/tarfile.rst:882 msgid "" "Return a *new* copy of the :class:`!TarInfo` object with the given " "attributes changed. For example, to return a ``TarInfo`` with the group name " "set to ``'staff'``, use::" msgstr "" -#: library/tarfile.rst:852 +#: library/tarfile.rst:888 msgid "" "By default, a deep copy is made. If *deep* is false, the copy is shallow, i." "e. ``pax_headers`` and any custom attributes are shared with the original " "``TarInfo`` object." msgstr "" -#: library/tarfile.rst:856 +#: library/tarfile.rst:892 msgid "A :class:`TarInfo` object also provides some convenient query methods:" msgstr "" -#: library/tarfile.rst:861 +#: library/tarfile.rst:897 msgid "Return :const:`True` if the :class:`TarInfo` object is a regular file." msgstr "" -#: library/tarfile.rst:866 +#: library/tarfile.rst:902 msgid "Same as :meth:`isfile`." msgstr "" -#: library/tarfile.rst:871 +#: library/tarfile.rst:907 msgid "Return :const:`True` if it is a directory." msgstr "" -#: library/tarfile.rst:876 +#: library/tarfile.rst:912 msgid "Return :const:`True` if it is a symbolic link." msgstr "" -#: library/tarfile.rst:881 +#: library/tarfile.rst:917 msgid "Return :const:`True` if it is a hard link." msgstr "" -#: library/tarfile.rst:886 +#: library/tarfile.rst:922 msgid "Return :const:`True` if it is a character device." msgstr "" -#: library/tarfile.rst:891 +#: library/tarfile.rst:927 msgid "Return :const:`True` if it is a block device." msgstr "" -#: library/tarfile.rst:896 +#: library/tarfile.rst:932 msgid "Return :const:`True` if it is a FIFO." msgstr "" -#: library/tarfile.rst:901 +#: library/tarfile.rst:937 msgid "" "Return :const:`True` if it is one of character device, block device or FIFO." msgstr "" -#: library/tarfile.rst:907 +#: library/tarfile.rst:943 msgid "Extraction filters" msgstr "" -#: library/tarfile.rst:911 +#: library/tarfile.rst:947 msgid "" "The *tar* format is designed to capture all details of a UNIX-like " "filesystem, which makes it very powerful. Unfortunately, the features make " @@ -1149,66 +1173,66 @@ msgid "" "components, or symlinks that affect later members)." msgstr "" -#: library/tarfile.rst:919 +#: library/tarfile.rst:955 msgid "" "In most cases, the full functionality is not needed. Therefore, *tarfile* " "supports extraction filters: a mechanism to limit functionality, and thus " "mitigate some of the security issues." msgstr "" -#: library/tarfile.rst:925 +#: library/tarfile.rst:961 msgid ":pep:`706`" msgstr "" -#: library/tarfile.rst:926 +#: library/tarfile.rst:962 msgid "Contains further motivation and rationale behind the design." msgstr "" -#: library/tarfile.rst:928 +#: library/tarfile.rst:964 msgid "" "The *filter* argument to :meth:`TarFile.extract` or :meth:`~TarFile." "extractall` can be:" msgstr "" -#: library/tarfile.rst:931 +#: library/tarfile.rst:967 msgid "" "the string ``'fully_trusted'``: Honor all metadata as specified in the " "archive. Should be used if the user trusts the archive completely, or " "implements their own complex verification." msgstr "" -#: library/tarfile.rst:936 +#: library/tarfile.rst:972 msgid "" "the string ``'tar'``: Honor most *tar*-specific features (i.e. features of " "UNIX-like filesystems), but block features that are very likely to be " "surprising or malicious. See :func:`tar_filter` for details." msgstr "" -#: library/tarfile.rst:940 +#: library/tarfile.rst:976 msgid "" "the string ``'data'``: Ignore or block most features specific to UNIX-like " "filesystems. Intended for extracting cross-platform data archives. See :func:" "`data_filter` for details." msgstr "" -#: library/tarfile.rst:944 +#: library/tarfile.rst:980 msgid "``None`` (default): Use :attr:`TarFile.extraction_filter`." msgstr "" -#: library/tarfile.rst:946 +#: library/tarfile.rst:982 msgid "" "If that is also ``None`` (the default), raise a ``DeprecationWarning``, and " "fall back to the ``'fully_trusted'`` filter, whose dangerous behavior " "matches previous versions of Python." msgstr "" -#: library/tarfile.rst:950 +#: library/tarfile.rst:986 msgid "" "In Python 3.14, the ``'data'`` filter will become the default instead. It's " "possible to switch earlier; see :attr:`TarFile.extraction_filter`." msgstr "" -#: library/tarfile.rst:953 +#: library/tarfile.rst:989 msgid "" "A callable which will be called for each extracted member with a :ref:" "`TarInfo ` describing the member and the destination path " @@ -1216,23 +1240,23 @@ msgid "" "members)::" msgstr "" -#: library/tarfile.rst:960 +#: library/tarfile.rst:996 msgid "" "The callable is called just before each member is extracted, so it can take " "the current state of the disk into account. It can:" msgstr "" -#: library/tarfile.rst:964 +#: library/tarfile.rst:1000 msgid "" "return a :class:`TarInfo` object which will be used instead of the metadata " "in the archive, or" msgstr "" -#: library/tarfile.rst:966 +#: library/tarfile.rst:1002 msgid "return ``None``, in which case the member will be skipped, or" msgstr "" -#: library/tarfile.rst:967 +#: library/tarfile.rst:1003 msgid "" "raise an exception to abort the operation or skip the member, depending on :" "attr:`~TarFile.errorlevel`. Note that when extraction is aborted, :meth:" @@ -1240,118 +1264,118 @@ msgid "" "attempt to clean up." msgstr "" -#: library/tarfile.rst:973 +#: library/tarfile.rst:1009 msgid "Default named filters" msgstr "" -#: library/tarfile.rst:975 +#: library/tarfile.rst:1011 msgid "" "The pre-defined, named filters are available as functions, so they can be " "reused in custom filters:" msgstr "" -#: library/tarfile.rst:980 +#: library/tarfile.rst:1016 msgid "Return *member* unchanged." msgstr "" -#: library/tarfile.rst:982 +#: library/tarfile.rst:1018 msgid "This implements the ``'fully_trusted'`` filter." msgstr "" -#: library/tarfile.rst:986 +#: library/tarfile.rst:1022 msgid "Implements the ``'tar'`` filter." msgstr "" -#: library/tarfile.rst:988 +#: library/tarfile.rst:1024 msgid "Strip leading slashes (``/`` and :data:`os.sep`) from filenames." msgstr "" -#: library/tarfile.rst:989 +#: library/tarfile.rst:1025 msgid "" ":ref:`Refuse ` to extract files with absolute " "paths (in case the name is absolute even after stripping slashes, e.g. ``C:/" "foo`` on Windows). This raises :class:`~tarfile.AbsolutePathError`." msgstr "" -#: library/tarfile.rst:993 +#: library/tarfile.rst:1029 msgid "" ":ref:`Refuse ` to extract files whose absolute " "path (after following symlinks) would end up outside the destination. This " "raises :class:`~tarfile.OutsideDestinationError`." msgstr "" -#: library/tarfile.rst:996 +#: library/tarfile.rst:1032 msgid "" "Clear high mode bits (setuid, setgid, sticky) and group/other write bits (:" "const:`~stat.S_IWGRP` | :const:`~stat.S_IWOTH`)." msgstr "" -#: library/tarfile.rst:1032 +#: library/tarfile.rst:1068 msgid "Return the modified ``TarInfo`` member." msgstr "" -#: library/tarfile.rst:1003 +#: library/tarfile.rst:1039 msgid "" "Implements the ``'data'`` filter. In addition to what ``tar_filter`` does:" msgstr "" -#: library/tarfile.rst:1006 +#: library/tarfile.rst:1042 msgid "" ":ref:`Refuse ` to extract links (hard or soft) " "that link to absolute paths, or ones that link outside the destination." msgstr "" -#: library/tarfile.rst:1009 +#: library/tarfile.rst:1045 msgid "" "This raises :class:`~tarfile.AbsoluteLinkError` or :class:`~tarfile." "LinkOutsideDestinationError`." msgstr "" -#: library/tarfile.rst:1012 +#: library/tarfile.rst:1048 msgid "" "Note that such files are refused even on platforms that do not support " "symbolic links." msgstr "" -#: library/tarfile.rst:1015 +#: library/tarfile.rst:1051 msgid "" ":ref:`Refuse ` to extract device files (including " "pipes). This raises :class:`~tarfile.SpecialFileError`." msgstr "" -#: library/tarfile.rst:1019 +#: library/tarfile.rst:1055 msgid "For regular files, including hard links:" msgstr "" -#: library/tarfile.rst:1021 +#: library/tarfile.rst:1057 msgid "" "Set the owner read and write permissions (:const:`~stat.S_IRUSR` | :const:" "`~stat.S_IWUSR`)." msgstr "" -#: library/tarfile.rst:1023 +#: library/tarfile.rst:1059 msgid "" "Remove the group & other executable permission (:const:`~stat.S_IXGRP` | :" "const:`~stat.S_IXOTH`) if the owner doesn’t have it (:const:`~stat.S_IXUSR`)." msgstr "" -#: library/tarfile.rst:1027 +#: library/tarfile.rst:1063 msgid "" "For other files (directories), set ``mode`` to ``None``, so that extraction " "methods skip applying permission bits." msgstr "" -#: library/tarfile.rst:1029 +#: library/tarfile.rst:1065 msgid "" "Set user and group info (``uid``, ``gid``, ``uname``, ``gname``) to " "``None``, so that extraction methods skip setting it." msgstr "" -#: library/tarfile.rst:1038 +#: library/tarfile.rst:1074 msgid "Filter errors" msgstr "" -#: library/tarfile.rst:1040 +#: library/tarfile.rst:1076 msgid "" "When a filter refuses to extract a file, it will raise an appropriate " "exception, a subclass of :class:`~tarfile.FilterError`. This will abort the " @@ -1360,11 +1384,11 @@ msgid "" "continue." msgstr "" -#: library/tarfile.rst:1048 +#: library/tarfile.rst:1084 msgid "Hints for further verification" msgstr "" -#: library/tarfile.rst:1050 +#: library/tarfile.rst:1086 msgid "" "Even with ``filter='data'``, *tarfile* is not suited for extracting " "untrusted files without prior inspection. Among other issues, the pre-" @@ -1372,69 +1396,69 @@ msgid "" "additional checks." msgstr "" -#: library/tarfile.rst:1055 +#: library/tarfile.rst:1091 msgid "Here is an incomplete list of things to consider:" msgstr "" -#: library/tarfile.rst:1057 +#: library/tarfile.rst:1093 msgid "" "Extract to a :func:`new temporary directory ` to prevent e." "g. exploiting pre-existing links, and to make it easier to clean up after a " "failed extraction." msgstr "" -#: library/tarfile.rst:1060 +#: library/tarfile.rst:1096 msgid "" "When working with untrusted data, use external (e.g. OS-level) limits on " "disk, memory and CPU usage." msgstr "" -#: library/tarfile.rst:1062 +#: library/tarfile.rst:1098 msgid "" "Check filenames against an allow-list of characters (to filter out control " "characters, confusables, foreign path separators, etc.)." msgstr "" -#: library/tarfile.rst:1065 +#: library/tarfile.rst:1101 msgid "" "Check that filenames have expected extensions (discouraging files that " "execute when you “click on them”, or extension-less files like Windows " "special device names)." msgstr "" -#: library/tarfile.rst:1067 +#: library/tarfile.rst:1103 msgid "" "Limit the number of extracted files, total size of extracted data, filename " "length (including symlink length), and size of individual files." msgstr "" -#: library/tarfile.rst:1069 +#: library/tarfile.rst:1105 msgid "Check for files that would be shadowed on case-insensitive filesystems." msgstr "" -#: library/tarfile.rst:1071 +#: library/tarfile.rst:1107 msgid "Also note that:" msgstr "" -#: library/tarfile.rst:1073 +#: library/tarfile.rst:1109 msgid "" "Tar files may contain multiple versions of the same file. Later ones are " "expected to overwrite any earlier ones. This feature is crucial to allow " "updating tape archives, but can be abused maliciously." msgstr "" -#: library/tarfile.rst:1077 +#: library/tarfile.rst:1113 msgid "" "*tarfile* does not protect against issues with “live” data, e.g. an attacker " "tinkering with the destination (or source) directory while extraction (or " "archiving) is in progress." msgstr "" -#: library/tarfile.rst:1083 +#: library/tarfile.rst:1119 msgid "Supporting older Python versions" msgstr "" -#: library/tarfile.rst:1085 +#: library/tarfile.rst:1121 msgid "" "Extraction filters were added to Python 3.12, but may be backported to older " "versions as security updates. To check whether the feature is available, use " @@ -1442,163 +1466,163 @@ msgid "" "version." msgstr "" -#: library/tarfile.rst:1090 +#: library/tarfile.rst:1126 msgid "" "The following examples show how to support Python versions with and without " "the feature. Note that setting ``extraction_filter`` will affect any " "subsequent operations." msgstr "" -#: library/tarfile.rst:1094 +#: library/tarfile.rst:1130 msgid "Fully trusted archive::" msgstr "" -#: library/tarfile.rst:1099 +#: library/tarfile.rst:1135 msgid "" "Use the ``'data'`` filter if available, but revert to Python 3.11 behavior " "(``'fully_trusted'``) if this feature is not available::" msgstr "" -#: library/tarfile.rst:1106 +#: library/tarfile.rst:1142 msgid "Use the ``'data'`` filter; *fail* if it is not available::" msgstr "" -#: library/tarfile.rst:1110 +#: library/tarfile.rst:1146 msgid "or::" msgstr "" -#: library/tarfile.rst:1115 +#: library/tarfile.rst:1151 msgid "Use the ``'data'`` filter; *warn* if it is not available::" msgstr "" -#: library/tarfile.rst:1126 +#: library/tarfile.rst:1162 msgid "Stateful extraction filter example" msgstr "" -#: library/tarfile.rst:1128 +#: library/tarfile.rst:1164 msgid "" "While *tarfile*'s extraction methods take a simple *filter* callable, custom " "filters may be more complex objects with an internal state. It may be useful " "to write these as context managers, to be used like this::" msgstr "" -#: library/tarfile.rst:1135 +#: library/tarfile.rst:1171 msgid "Such a filter can be written as, for example::" msgstr "" -#: library/tarfile.rst:1157 +#: library/tarfile.rst:1193 msgid "Command-Line Interface" msgstr "" -#: library/tarfile.rst:1161 +#: library/tarfile.rst:1197 msgid "" "The :mod:`tarfile` module provides a simple command-line interface to " "interact with tar archives." msgstr "" -#: library/tarfile.rst:1164 +#: library/tarfile.rst:1200 msgid "" "If you want to create a new tar archive, specify its name after the :option:" "`-c` option and then list the filename(s) that should be included:" msgstr "" -#: library/tarfile.rst:1171 +#: library/tarfile.rst:1207 msgid "Passing a directory is also acceptable:" msgstr "" -#: library/tarfile.rst:1177 +#: library/tarfile.rst:1213 msgid "" "If you want to extract a tar archive into the current directory, use the :" "option:`-e` option:" msgstr "" -#: library/tarfile.rst:1184 +#: library/tarfile.rst:1220 msgid "" "You can also extract a tar archive into a different directory by passing the " "directory's name:" msgstr "" -#: library/tarfile.rst:1191 +#: library/tarfile.rst:1227 msgid "For a list of the files in a tar archive, use the :option:`-l` option:" msgstr "" -#: library/tarfile.rst:1199 +#: library/tarfile.rst:1235 msgid "Command-line options" msgstr "" -#: library/tarfile.rst:1204 +#: library/tarfile.rst:1240 msgid "List files in a tarfile." msgstr "" -#: library/tarfile.rst:1209 +#: library/tarfile.rst:1245 msgid "Create tarfile from source files." msgstr "" -#: library/tarfile.rst:1214 +#: library/tarfile.rst:1250 msgid "" "Extract tarfile into the current directory if *output_dir* is not specified." msgstr "" -#: library/tarfile.rst:1219 +#: library/tarfile.rst:1255 msgid "Test whether the tarfile is valid or not." msgstr "" -#: library/tarfile.rst:1223 +#: library/tarfile.rst:1259 msgid "Verbose output." msgstr "" -#: library/tarfile.rst:1227 +#: library/tarfile.rst:1263 msgid "" "Specifies the *filter* for ``--extract``. See :ref:`tarfile-extraction-" "filter` for details. Only string names are accepted (that is, " "``fully_trusted``, ``tar``, and ``data``)." msgstr "" -#: library/tarfile.rst:1235 +#: library/tarfile.rst:1271 msgid "Examples" msgstr "" -#: library/tarfile.rst:1237 +#: library/tarfile.rst:1273 msgid "How to extract an entire tar archive to the current working directory::" msgstr "" -#: library/tarfile.rst:1244 +#: library/tarfile.rst:1280 msgid "" "How to extract a subset of a tar archive with :meth:`TarFile.extractall` " "using a generator function instead of a list::" msgstr "" -#: library/tarfile.rst:1259 +#: library/tarfile.rst:1295 msgid "How to create an uncompressed tar archive from a list of filenames::" msgstr "" -#: library/tarfile.rst:1267 +#: library/tarfile.rst:1303 msgid "The same example using the :keyword:`with` statement::" msgstr "" -#: library/tarfile.rst:1274 +#: library/tarfile.rst:1310 msgid "" "How to read a gzip compressed tar archive and display some member " "information::" msgstr "" -#: library/tarfile.rst:1288 +#: library/tarfile.rst:1324 msgid "" "How to create an archive and reset the user information using the *filter* " "parameter in :meth:`TarFile.add`::" msgstr "" -#: library/tarfile.rst:1304 +#: library/tarfile.rst:1340 msgid "Supported tar formats" msgstr "" -#: library/tarfile.rst:1306 +#: library/tarfile.rst:1342 msgid "" "There are three tar formats that can be created with the :mod:`tarfile` " "module:" msgstr "" -#: library/tarfile.rst:1308 +#: library/tarfile.rst:1344 msgid "" "The POSIX.1-1988 ustar format (:const:`USTAR_FORMAT`). It supports filenames " "up to a length of at best 256 characters and linknames up to 100 characters. " @@ -1606,7 +1630,7 @@ msgid "" "supported format." msgstr "" -#: library/tarfile.rst:1313 +#: library/tarfile.rst:1349 msgid "" "The GNU tar format (:const:`GNU_FORMAT`). It supports long filenames and " "linknames, files bigger than 8 GiB and sparse files. It is the de facto " @@ -1614,7 +1638,7 @@ msgid "" "extensions for long names, sparse file support is read-only." msgstr "" -#: library/tarfile.rst:1318 +#: library/tarfile.rst:1354 msgid "" "The POSIX.1-2001 pax format (:const:`PAX_FORMAT`). It is the most flexible " "format with virtually no limits. It supports long filenames and linknames, " @@ -1625,7 +1649,7 @@ msgid "" "*ustar* format. It is the current default format for new archives." msgstr "" -#: library/tarfile.rst:1326 +#: library/tarfile.rst:1362 msgid "" "It extends the existing *ustar* format with extra headers for information " "that cannot be stored otherwise. There are two flavours of pax headers: " @@ -1634,13 +1658,13 @@ msgid "" "in a pax header is encoded in *UTF-8* for portability reasons." msgstr "" -#: library/tarfile.rst:1332 +#: library/tarfile.rst:1368 msgid "" "There are some more variants of the tar format which can be read, but not " "created:" msgstr "" -#: library/tarfile.rst:1335 +#: library/tarfile.rst:1371 msgid "" "The ancient V7 format. This is the first tar format from Unix Seventh " "Edition, storing only regular files and directories. Names must not be " @@ -1649,17 +1673,17 @@ msgid "" "ASCII characters." msgstr "" -#: library/tarfile.rst:1340 +#: library/tarfile.rst:1376 msgid "" "The SunOS tar extended format. This format is a variant of the POSIX.1-2001 " "pax format, but is not compatible." msgstr "" -#: library/tarfile.rst:1346 +#: library/tarfile.rst:1382 msgid "Unicode issues" msgstr "" -#: library/tarfile.rst:1348 +#: library/tarfile.rst:1384 msgid "" "The tar format was originally conceived to make backups on tape drives with " "the main focus on preserving file system information. Nowadays tar archives " @@ -1674,13 +1698,13 @@ msgid "" "It stores non-ASCII metadata using the universal character encoding *UTF-8*." msgstr "" -#: library/tarfile.rst:1360 +#: library/tarfile.rst:1396 msgid "" "The details of character conversion in :mod:`tarfile` are controlled by the " "*encoding* and *errors* keyword arguments of the :class:`TarFile` class." msgstr "" -#: library/tarfile.rst:1363 +#: library/tarfile.rst:1399 msgid "" "*encoding* defines the character encoding to use for the metadata in the " "archive. The default value is :func:`sys.getfilesystemencoding` or " @@ -1689,7 +1713,7 @@ msgid "" "not set appropriately, this conversion may fail." msgstr "" -#: library/tarfile.rst:1369 +#: library/tarfile.rst:1405 msgid "" "The *errors* argument defines how characters are treated that cannot be " "converted. Possible values are listed in section :ref:`error-handlers`. The " @@ -1697,7 +1721,7 @@ msgid "" "system calls, see :ref:`os-filenames`." msgstr "" -#: library/tarfile.rst:1374 +#: library/tarfile.rst:1410 msgid "" "For :const:`PAX_FORMAT` archives (the default), *encoding* is generally not " "needed because all the metadata is stored using *UTF-8*. *encoding* is only " diff --git a/library/telnetlib.po b/library/telnetlib.po index 0ed9acd52..3d48c2401 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -189,7 +189,7 @@ msgstr "" msgid "Do not try to reopen an already connected instance." msgstr "" -#: library/telnetlib.rst:159 +#: library/telnetlib.rst:161 msgid "" "Raises an :ref:`auditing event ` ``telnetlib.Telnet.open`` with " "arguments ``self``, ``host``, ``port``." @@ -227,7 +227,7 @@ msgid "" "connection is closed." msgstr "" -#: library/telnetlib.rst:196 +#: library/telnetlib.rst:198 msgid "" "Raises an :ref:`auditing event ` ``telnetlib.Telnet.write`` with " "arguments ``self``, ``buffer``." diff --git a/library/test.po b/library/test.po index 708506e99..5f9b1b5be 100644 --- a/library/test.po +++ b/library/test.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -161,9 +161,10 @@ msgstr "" #: library/test.rst:145 msgid "" "When using this pattern, remember that all classes that inherit from :class:" -"`unittest.TestCase` are run as tests. The :class:`Mixin` class in the " -"example above does not have any data and so can't be run by itself, thus it " -"does not inherit from :class:`unittest.TestCase`." +"`unittest.TestCase` are run as tests. The :class:`!" +"TestFuncAcceptsSequencesMixin` class in the example above does not have any " +"data and so can't be run by itself, thus it does not inherit from :class:" +"`unittest.TestCase`." msgstr "" #: library/test.rst:153 @@ -381,9 +382,8 @@ msgstr "" #: library/test.rst:327 msgid "" -"True if Python is built with the :c:macro:`Py_DEBUG` macro defined: if " -"Python is :ref:`built in debug mode ` (:option:`./configure --" -"with-pydebug <--with-pydebug>`)." +"True if Python was built with the :c:macro:`Py_DEBUG` macro defined, that " +"is, if Python was :ref:`built in debug mode `." msgstr "" #: library/test.rst:336 diff --git a/library/time.po b/library/time.po index 1e16aa6b2..2761db304 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: 2023-03-01 11:44+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -195,7 +195,7 @@ msgstr "Karşı" msgid "Use" msgstr "Kullan" -#: library/time.rst:105 library/time.rst:111 library/time.rst:29 +#: library/time.rst:102 library/time.rst:108 library/time.rst:111 msgid "seconds since the epoch" msgstr "zamanın başlangıcından beri geçen saniye" diff --git a/library/tkinter.ttk.po b/library/tkinter.ttk.po index 07b720e65..573b4e060 100644 --- a/library/tkinter.ttk.po +++ b/library/tkinter.ttk.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1716,7 +1716,7 @@ msgid "" msgstr "" #: library/tkinter.ttk.rst:1121 -msgid "See `Item Options`_ for the list of available points." +msgid "See `Item Options`_ for the list of available options." msgstr "" #: library/tkinter.ttk.rst:1126 diff --git a/library/tty.po b/library/tty.po index 220b37dff..c97dd40d6 100644 --- a/library/tty.po +++ b/library/tty.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -55,19 +55,31 @@ msgid "" "by :func:`termios.tcgetattr`, to that of a tty in cbreak mode." msgstr "" +#: library/tty.rst:38 +msgid "" +"This clears the ``ECHO`` and ``ICANON`` local mode flags in *mode* as well " +"as setting the minimum input to 1 byte with no delay." +msgstr "" + #: library/tty.rst:43 msgid "" +"The ``ICRNL`` flag is no longer cleared. This matches Linux and macOS ``stty " +"cbreak`` behavior and what :func:`setcbreak` historically did." +msgstr "" + +#: library/tty.rst:50 +msgid "" "Change the mode of the file descriptor *fd* to raw. If *when* is omitted, it " "defaults to :const:`termios.TCSAFLUSH`, and is passed to :func:`termios." "tcsetattr`. The return value of :func:`termios.tcgetattr` is saved before " "setting *fd* to raw mode; this value is returned." msgstr "" -#: library/tty.rst:59 +#: library/tty.rst:69 msgid "The return value is now the original tty attributes, instead of None." msgstr "" -#: library/tty.rst:54 +#: library/tty.rst:61 msgid "" "Change the mode of file descriptor *fd* to cbreak. If *when* is omitted, it " "defaults to :const:`termios.TCSAFLUSH`, and is passed to :func:`termios." @@ -75,10 +87,23 @@ msgid "" "setting *fd* to cbreak mode; this value is returned." msgstr "" -#: library/tty.rst:65 +#: library/tty.rst:66 +msgid "" +"This clears the ``ECHO`` and ``ICANON`` local mode flags as well as setting " +"the minimum input to 1 byte with no delay." +msgstr "" + +#: library/tty.rst:72 +msgid "" +"The ``ICRNL`` flag is no longer cleared. This restores the behavior of " +"Python 3.11 and earlier as well as matching what Linux, macOS, & BSDs " +"describe in their ``stty(1)`` man pages regarding cbreak mode." +msgstr "" + +#: library/tty.rst:80 msgid "Module :mod:`termios`" msgstr "" -#: library/tty.rst:66 +#: library/tty.rst:81 msgid "Low-level terminal control interface." msgstr "" diff --git a/library/types.po b/library/types.po index 499cfd506..ac7c48210 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -219,7 +219,9 @@ msgid "" msgstr "" #: library/types.rst:191 -msgid "The type for code objects such as returned by :func:`compile`." +msgid "" +"The type of :ref:`code objects ` such as returned by :func:" +"`compile`." msgstr "" #: library/types.rst:193 @@ -238,80 +240,75 @@ msgstr "" #: library/types.rst:201 msgid "" -"Return a copy of the code object with new values for the specified fields." -msgstr "" - -#: library/types.rst:207 -msgid "" "The type for cell objects: such objects are used as containers for a " "function's free variables." msgstr "" -#: library/types.rst:215 +#: library/types.rst:209 msgid "The type of methods of user-defined class instances." msgstr "" -#: library/types.rst:221 +#: library/types.rst:215 msgid "" "The type of built-in functions like :func:`len` or :func:`sys.exit`, and " "methods of built-in classes. (Here, the term \"built-in\" means \"written " "in C\".)" msgstr "" -#: library/types.rst:228 +#: library/types.rst:222 msgid "" "The type of methods of some built-in data types and base classes such as :" "meth:`object.__init__` or :meth:`object.__lt__`." msgstr "" -#: library/types.rst:236 +#: library/types.rst:230 msgid "" "The type of *bound* methods of some built-in data types and base classes. " "For example it is the type of :code:`object().__str__`." msgstr "" -#: library/types.rst:244 +#: library/types.rst:238 msgid "The type of :data:`NotImplemented`." msgstr "" -#: library/types.rst:251 +#: library/types.rst:245 msgid "" "The type of methods of some built-in data types such as :meth:`str.join`." msgstr "" -#: library/types.rst:258 +#: library/types.rst:252 msgid "" "The type of *unbound* class methods of some built-in data types such as " "``dict.__dict__['fromkeys']``." msgstr "" -#: library/types.rst:266 +#: library/types.rst:260 msgid "" "The type of :term:`modules `. The constructor takes the name of the " "module to be created and optionally its :term:`docstring`." msgstr "" -#: library/types.rst:270 +#: library/types.rst:264 msgid "" "Use :func:`importlib.util.module_from_spec` to create a new module if you " "wish to set the various import-controlled attributes." msgstr "" -#: library/types.rst:275 +#: library/types.rst:269 msgid "The :term:`docstring` of the module. Defaults to ``None``." msgstr "" -#: library/types.rst:279 +#: library/types.rst:273 msgid "The :term:`loader` which loaded the module. Defaults to ``None``." msgstr "" -#: library/types.rst:281 +#: library/types.rst:275 msgid "" "This attribute is to match :attr:`importlib.machinery.ModuleSpec.loader` as " "stored in the :attr:`__spec__` object." msgstr "" -#: library/types.rst:285 +#: library/types.rst:279 msgid "" "A future version of Python may stop setting this attribute by default. To " "guard against this potential change, preferably read from the :attr:" @@ -319,17 +316,17 @@ msgid "" "None)`` if you explicitly need to use this attribute." msgstr "" -#: library/types.rst:316 +#: library/types.rst:310 msgid "Defaults to ``None``. Previously the attribute was optional." msgstr "" -#: library/types.rst:296 +#: library/types.rst:290 msgid "" "The name of the module. Expected to match :attr:`importlib.machinery." "ModuleSpec.name`." msgstr "" -#: library/types.rst:301 +#: library/types.rst:295 msgid "" "Which :term:`package` a module belongs to. If the module is top-level (i.e. " "not a part of any specific package) then the attribute should be set to " @@ -337,13 +334,13 @@ msgid "" "`__name__` if the module is a package itself). Defaults to ``None``." msgstr "" -#: library/types.rst:306 +#: library/types.rst:300 msgid "" "This attribute is to match :attr:`importlib.machinery.ModuleSpec.parent` as " "stored in the :attr:`__spec__` object." msgstr "" -#: library/types.rst:310 +#: library/types.rst:304 msgid "" "A future version of Python may stop setting this attribute by default. To " "guard against this potential change, preferably read from the :attr:" @@ -351,73 +348,73 @@ msgid "" "None)`` if you explicitly need to use this attribute." msgstr "" -#: library/types.rst:321 +#: library/types.rst:315 msgid "" "A record of the module's import-system-related state. Expected to be an " "instance of :class:`importlib.machinery.ModuleSpec`." msgstr "" -#: library/types.rst:329 +#: library/types.rst:323 msgid "The type of :data:`Ellipsis`." msgstr "" -#: library/types.rst:335 +#: library/types.rst:329 msgid "" "The type of :ref:`parameterized generics ` such as " "``list[int]``." msgstr "" -#: library/types.rst:338 +#: library/types.rst:332 msgid "" "``t_origin`` should be a non-parameterized generic class, such as ``list``, " "``tuple`` or ``dict``. ``t_args`` should be a :class:`tuple` (possibly of " "length 1) of types which parameterize ``t_origin``::" msgstr "" -#: library/types.rst:351 +#: library/types.rst:345 msgid "This type can now be subclassed." msgstr "" -#: library/types.rst:357 +#: library/types.rst:351 msgid ":ref:`Generic Alias Types`" msgstr "" -#: library/types.rst:357 +#: library/types.rst:351 msgid "In-depth documentation on instances of :class:`!types.GenericAlias`" msgstr "" -#: library/types.rst:359 +#: library/types.rst:353 msgid ":pep:`585` - Type Hinting Generics In Standard Collections" msgstr "" -#: library/types.rst:360 +#: library/types.rst:354 msgid "Introducing the :class:`!types.GenericAlias` class" msgstr "" -#: library/types.rst:364 +#: library/types.rst:358 msgid "The type of :ref:`union type expressions`." msgstr "" -#: library/types.rst:370 +#: library/types.rst:364 msgid "" "The type of traceback objects such as found in ``sys.exception()." "__traceback__``." msgstr "" -#: library/types.rst:372 +#: library/types.rst:366 msgid "" "See :ref:`the language reference ` for details of the " "available attributes and operations, and guidance on creating tracebacks " "dynamically." msgstr "" -#: library/types.rst:379 +#: library/types.rst:373 msgid "" "The type of :ref:`frame objects ` such as found in :attr:`tb." "tb_frame ` if ``tb`` is a traceback object." msgstr "" -#: library/types.rst:385 +#: library/types.rst:379 msgid "" "The type of objects defined in extension modules with ``PyGetSetDef``, such " "as :attr:`FrameType.f_locals ` or ``array.array.typecode``. " @@ -426,7 +423,7 @@ msgid "" "modules." msgstr "" -#: library/types.rst:394 +#: library/types.rst:388 msgid "" "The type of objects defined in extension modules with ``PyMemberDef``, such " "as ``datetime.timedelta.days``. This type is used as descriptor for simple " @@ -435,117 +432,125 @@ msgid "" "modules." msgstr "" -#: library/types.rst:401 +#: library/types.rst:393 +msgid "" +"In addition, when a class is defined with a :attr:`~object.__slots__` " +"attribute, then for each slot, an instance of :class:`!MemberDescriptorType` " +"will be added as an attribute on the class. This allows the slot to appear " +"in the class's :attr:`~object.__dict__`." +msgstr "" + +#: library/types.rst:399 msgid "" "In other implementations of Python, this type may be identical to " "``GetSetDescriptorType``." msgstr "" -#: library/types.rst:406 +#: library/types.rst:404 msgid "" "Read-only proxy of a mapping. It provides a dynamic view on the mapping's " "entries, which means that when the mapping changes, the view reflects these " "changes." msgstr "" -#: library/types.rst:414 +#: library/types.rst:412 msgid "" "Updated to support the new union (``|``) operator from :pep:`584`, which " "simply delegates to the underlying mapping." msgstr "" -#: library/types.rst:419 +#: library/types.rst:417 msgid "" "Return ``True`` if the underlying mapping has a key *key*, else ``False``." msgstr "" -#: library/types.rst:424 +#: library/types.rst:422 msgid "" "Return the item of the underlying mapping with key *key*. Raises a :exc:" "`KeyError` if *key* is not in the underlying mapping." msgstr "" -#: library/types.rst:429 +#: library/types.rst:427 msgid "" "Return an iterator over the keys of the underlying mapping. This is a " "shortcut for ``iter(proxy.keys())``." msgstr "" -#: library/types.rst:434 +#: library/types.rst:432 msgid "Return the number of items in the underlying mapping." msgstr "" -#: library/types.rst:438 +#: library/types.rst:436 msgid "Return a shallow copy of the underlying mapping." msgstr "" -#: library/types.rst:442 +#: library/types.rst:440 msgid "" "Return the value for *key* if *key* is in the underlying mapping, else " "*default*. If *default* is not given, it defaults to ``None``, so that this " "method never raises a :exc:`KeyError`." msgstr "" -#: library/types.rst:448 +#: library/types.rst:446 msgid "" "Return a new view of the underlying mapping's items (``(key, value)`` pairs)." msgstr "" -#: library/types.rst:453 +#: library/types.rst:451 msgid "Return a new view of the underlying mapping's keys." msgstr "" -#: library/types.rst:457 +#: library/types.rst:455 msgid "Return a new view of the underlying mapping's values." msgstr "" -#: library/types.rst:461 +#: library/types.rst:459 msgid "Return a reverse iterator over the keys of the underlying mapping." msgstr "" -#: library/types.rst:467 +#: library/types.rst:465 msgid "Return a hash of the underlying mapping." msgstr "" -#: library/types.rst:473 +#: library/types.rst:471 msgid "Additional Utility Classes and Functions" msgstr "" -#: library/types.rst:477 +#: library/types.rst:475 msgid "" "A simple :class:`object` subclass that provides attribute access to its " "namespace, as well as a meaningful repr." msgstr "" -#: library/types.rst:480 +#: library/types.rst:478 msgid "" "Unlike :class:`object`, with ``SimpleNamespace`` you can add and remove " "attributes. If a ``SimpleNamespace`` object is initialized with keyword " "arguments, those are directly added to the underlying namespace." msgstr "" -#: library/types.rst:484 +#: library/types.rst:482 msgid "The type is roughly equivalent to the following code::" msgstr "" -#: library/types.rst:499 +#: library/types.rst:497 msgid "" "``SimpleNamespace`` may be useful as a replacement for ``class NS: pass``. " "However, for a structured record type use :func:`~collections.namedtuple` " "instead." msgstr "" -#: library/types.rst:505 +#: library/types.rst:503 msgid "" "Attribute order in the repr changed from alphabetical to insertion (like " "``dict``)." msgstr "" -#: library/types.rst:511 +#: library/types.rst:509 msgid "Route attribute access on a class to __getattr__." msgstr "" -#: library/types.rst:513 +#: library/types.rst:511 msgid "" "This is a descriptor, used to define attributes that act differently when " "accessed through an instance and through a class. Instance access remains " @@ -553,18 +558,18 @@ msgid "" "class's __getattr__ method; this is done by raising AttributeError." msgstr "" -#: library/types.rst:518 +#: library/types.rst:516 msgid "" "This allows one to have properties active on an instance, and have virtual " "attributes on the class with the same name (see :class:`enum.Enum` for an " "example)." msgstr "" -#: library/types.rst:525 +#: library/types.rst:523 msgid "Coroutine Utility Functions" msgstr "" -#: library/types.rst:529 +#: library/types.rst:527 msgid "" "This function transforms a :term:`generator` function into a :term:" "`coroutine function` which returns a generator-based coroutine. The " @@ -574,11 +579,11 @@ msgid "" "method." msgstr "" -#: library/types.rst:536 +#: library/types.rst:534 msgid "If *gen_func* is a generator function, it will be modified in-place." msgstr "" -#: library/types.rst:538 +#: library/types.rst:536 msgid "" "If *gen_func* is not a generator function, it will be wrapped. If it returns " "an instance of :class:`collections.abc.Generator`, the instance will be " diff --git a/library/unittest.mock.po b/library/unittest.mock.po index 3273d7a6a..b9044b4e2 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1522,9 +1522,9 @@ msgstr "" #: library/unittest.mock.rst:1962 msgid "" -":class:`Mock` supports mocking the Python protocol methods, also known as " -"\"magic methods\". This allows mock objects to replace containers or other " -"objects that implement Python protocols." +":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:1966 @@ -1670,8 +1670,8 @@ msgstr "" #: library/unittest.mock.rst:2061 msgid "" "``MagicMock`` is a subclass of :class:`Mock` with default implementations of " -"most of the magic methods. You can use ``MagicMock`` without having to " -"configure the magic methods yourself." +"most of the :term:`magic methods `. You can use ``MagicMock`` " +"without having to configure the magic methods yourself." msgstr "" #: library/unittest.mock.rst:2065 @@ -2046,11 +2046,17 @@ msgid "" "`~Mock.mock_calls`:" msgstr "" -#: library/unittest.mock.rst:2383 +#: library/unittest.mock.rst:2380 +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:2391 msgid "FILTER_DIR" msgstr "" -#: library/unittest.mock.rst:2387 +#: library/unittest.mock.rst:2395 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 " @@ -2059,7 +2065,7 @@ msgid "" "FILTER_DIR = False``." msgstr "" -#: library/unittest.mock.rst:2393 +#: library/unittest.mock.rst:2401 msgid "" "With filtering on, ``dir(some_mock)`` shows only useful attributes and will " "include any dynamically created attributes that wouldn't normally be shown. " @@ -2068,7 +2074,7 @@ msgid "" "yet:" msgstr "" -#: library/unittest.mock.rst:2420 +#: library/unittest.mock.rst:2428 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 " @@ -2077,31 +2083,31 @@ msgid "" "switch :data:`FILTER_DIR`:" msgstr "" -#: library/unittest.mock.rst:2441 +#: library/unittest.mock.rst:2449 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:2447 +#: library/unittest.mock.rst:2455 msgid "mock_open" msgstr "" -#: library/unittest.mock.rst:2451 +#: library/unittest.mock.rst:2459 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:2454 +#: library/unittest.mock.rst:2462 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:2458 +#: library/unittest.mock.rst:2466 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 " @@ -2114,51 +2120,51 @@ msgid "" "realistic filesystem for testing." msgstr "" -#: library/unittest.mock.rst:2468 +#: library/unittest.mock.rst:2476 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:2473 +#: library/unittest.mock.rst:2481 msgid "*read_data* is now reset on each call to the *mock*." msgstr "" -#: library/unittest.mock.rst:2476 +#: library/unittest.mock.rst:2484 msgid "" "Added :meth:`~container.__iter__` to implementation so that iteration (such " "as in for loops) correctly consumes *read_data*." msgstr "" -#: library/unittest.mock.rst:2480 +#: library/unittest.mock.rst:2488 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:2486 +#: library/unittest.mock.rst:2494 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:2490 +#: library/unittest.mock.rst:2498 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:2507 +#: library/unittest.mock.rst:2515 msgid "And for reading files::" msgstr "" -#: library/unittest.mock.rst:2520 +#: library/unittest.mock.rst:2528 msgid "Autospeccing" msgstr "" -#: library/unittest.mock.rst:2522 +#: library/unittest.mock.rst:2530 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 " @@ -2168,11 +2174,11 @@ msgid "" "`TypeError` if they are called incorrectly." msgstr "" -#: library/unittest.mock.rst:2529 +#: library/unittest.mock.rst:2537 msgid "Before I explain how auto-speccing works, here's why it is needed." msgstr "" -#: library/unittest.mock.rst:2531 +#: library/unittest.mock.rst:2539 msgid "" ":class:`Mock` is a very powerful and flexible object, but it suffers from " "two flaws when used to mock out objects from a system under test. One of " @@ -2180,25 +2186,25 @@ msgid "" "general problem with using mock objects." msgstr "" -#: library/unittest.mock.rst:2536 +#: library/unittest.mock.rst:2544 msgid "" "First the problem specific to :class:`Mock`. :class:`Mock` has two assert " "methods that are extremely handy: :meth:`~Mock.assert_called_with` and :meth:" "`~Mock.assert_called_once_with`." msgstr "" -#: library/unittest.mock.rst:2549 +#: library/unittest.mock.rst:2557 msgid "" "Because mocks auto-create attributes on demand, and allow you to call them " "with arbitrary arguments, if you misspell one of these assert methods then " "your assertion is gone:" msgstr "" -#: library/unittest.mock.rst:2559 +#: library/unittest.mock.rst:2567 msgid "Your tests can pass silently and incorrectly because of the typo." msgstr "" -#: library/unittest.mock.rst:2561 +#: library/unittest.mock.rst:2569 msgid "" "The second issue is more general to mocking. If you refactor some of your " "code, rename members and so on, any tests for code that is still using the " @@ -2206,7 +2212,7 @@ msgid "" "means your tests can all pass even though your code is broken." msgstr "" -#: library/unittest.mock.rst:2566 +#: library/unittest.mock.rst:2574 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 " @@ -2214,20 +2220,20 @@ msgid "" "room for bugs that tests might have caught." msgstr "" -#: library/unittest.mock.rst:2571 +#: library/unittest.mock.rst:2579 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:2582 +#: library/unittest.mock.rst:2590 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:2591 +#: library/unittest.mock.rst:2599 msgid "" "Auto-speccing solves this problem. You can either pass ``autospec=True`` to :" "func:`patch` / :func:`patch.object` or use the :func:`create_autospec` " @@ -2239,24 +2245,24 @@ msgid "" "import modules) without a big performance hit." msgstr "" -#: library/unittest.mock.rst:2600 +#: library/unittest.mock.rst:2608 msgid "Here's an example of it in use::" msgstr "" -#: library/unittest.mock.rst:2610 +#: library/unittest.mock.rst:2618 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:2619 +#: library/unittest.mock.rst:2627 msgid "" "The spec also applies to instantiated classes (i.e. the return value of " "specced mocks)::" msgstr "" -#: library/unittest.mock.rst:2626 +#: library/unittest.mock.rst:2634 msgid "" ":class:`Request` objects are not callable, so the return value of " "instantiating our mocked out :class:`request.Request` is a non-callable " @@ -2264,20 +2270,20 @@ msgid "" "error::" msgstr "" -#: library/unittest.mock.rst:2638 +#: library/unittest.mock.rst:2646 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:2642 +#: library/unittest.mock.rst:2650 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:2650 +#: library/unittest.mock.rst:2658 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 " @@ -2289,7 +2295,7 @@ msgid "" "objects so that introspection is safe [#]_." msgstr "" -#: library/unittest.mock.rst:2659 +#: library/unittest.mock.rst:2667 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 " @@ -2297,7 +2303,7 @@ msgid "" "restricts the api to visible attributes. ::" msgstr "" -#: library/unittest.mock.rst:2676 +#: library/unittest.mock.rst:2684 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 " @@ -2306,7 +2312,7 @@ msgid "" "setting them::" msgstr "" -#: library/unittest.mock.rst:2687 +#: library/unittest.mock.rst:2695 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 " @@ -2314,7 +2320,7 @@ msgid "" "this particular scenario:" msgstr "" -#: library/unittest.mock.rst:2700 +#: library/unittest.mock.rst:2708 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__`. " @@ -2323,7 +2329,7 @@ msgid "" "course) is faster too. e.g." msgstr "" -#: library/unittest.mock.rst:2711 +#: library/unittest.mock.rst:2719 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 " @@ -2334,7 +2340,7 @@ msgid "" "These will just be ordinary mocks (well - MagicMocks):" msgstr "" -#: library/unittest.mock.rst:2726 +#: library/unittest.mock.rst:2734 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 " @@ -2345,25 +2351,25 @@ msgid "" "alternative object as the *autospec* argument::" msgstr "" -#: library/unittest.mock.rst:2747 +#: library/unittest.mock.rst:2755 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:2752 +#: library/unittest.mock.rst:2760 msgid "Sealing mocks" msgstr "" -#: library/unittest.mock.rst:2761 +#: library/unittest.mock.rst:2769 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:2764 +#: library/unittest.mock.rst:2772 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 " diff --git a/library/unittest.po b/library/unittest.po index 5f771fd84..261dcf134 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2500,7 +2500,7 @@ msgid "" msgstr "" #: library/unittest.rst:2191 -msgid "Added *durations* keyword argument." +msgid "Added the *durations* keyword parameter." msgstr "" #: library/unittest.rst:2196 @@ -2606,7 +2606,7 @@ msgid "" "The *testRunner* argument can either be a test runner class or an already " "created instance of it. By default ``main`` calls :func:`sys.exit` with an " "exit code indicating success (0) or failure (1) of the tests run. An exit " -"code of 5 indicates that no tests were run." +"code of 5 indicates that no tests were run or skipped." msgstr "" #: library/unittest.rst:2287 diff --git a/library/urllib.parse.po b/library/urllib.parse.po index 015686258..e8b0b49d1 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: 2023-10-01 00:18+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -860,7 +860,7 @@ msgid "*query* supports bytes and string objects." msgstr "" #: library/urllib.parse.rst:732 -msgid "*quote_via* parameter." +msgid "Added the *quote_via* parameter." msgstr "" #: library/urllib.parse.rst:740 diff --git a/library/urllib.request.po b/library/urllib.request.po index bd1617f06..5b2d393fe 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -145,7 +145,7 @@ msgstr "" #: library/urllib.request.rst:88 msgid "" "In addition, if proxy settings are detected (for example, when a ``*_proxy`` " -"environment variable like :envvar:`http_proxy` is set), :class:" +"environment variable like :envvar:`!http_proxy` is set), :class:" "`ProxyHandler` is default installed and makes sure the requests are handled " "through the proxy." msgstr "" @@ -159,7 +159,7 @@ msgid "" "`ProxyHandler` objects." msgstr "" -#: library/urllib.request.rst:108 +#: library/urllib.request.rst:110 msgid "" "Raises an :ref:`auditing event ` ``urllib.Request`` with arguments " "``fullurl``, ``data``, ``headers``, ``method``." @@ -198,7 +198,7 @@ msgstr "" msgid "" "HTTPS connection now send an ALPN extension with protocol indicator " "``http/1.1`` when no *context* is given. Custom *context* should set ALPN " -"protocols with :meth:`~ssl.SSLContext.set_alpn_protocol`." +"protocols with :meth:`~ssl.SSLContext.set_alpn_protocols`." msgstr "" #: library/urllib.request.rst:128 @@ -742,7 +742,7 @@ msgstr "" #: library/urllib.request.rst:632 msgid "" -":meth:`_open` --- signal that the handler knows how to open " +":meth:`!_open` --- signal that the handler knows how to open " "*protocol* URLs." msgstr "" @@ -752,7 +752,7 @@ msgstr "" #: library/urllib.request.rst:637 msgid "" -":meth:`http_error_\\` --- signal that the handler knows how to " +":meth:`!http_error_\\` --- signal that the handler knows how to " "handle HTTP errors with HTTP error code *type*." msgstr "" @@ -762,13 +762,13 @@ msgstr "" #: library/urllib.request.rst:642 msgid "" -":meth:`_error` --- signal that the handler knows how to handle " +":meth:`!_error` --- signal that the handler knows how to handle " "errors from (non-\\ ``http``) *protocol*." msgstr "" #: library/urllib.request.rst:645 msgid "" -":meth:`_request` --- signal that the handler knows how to pre-" +":meth:`!_request` --- signal that the handler knows how to pre-" "process *protocol* requests." msgstr "" @@ -778,7 +778,7 @@ msgstr "" #: library/urllib.request.rst:650 msgid "" -":meth:`_response` --- signal that the handler knows how to post-" +":meth:`!_response` --- signal that the handler knows how to post-" "process *protocol* responses." msgstr "" @@ -803,8 +803,8 @@ msgid "" "Handle an error of the given protocol. This will call the registered error " "handlers for the given protocol with the given arguments (which are protocol " "specific). The HTTP protocol is a special case which uses the HTTP response " -"code to determine the specific error handler; refer to the :meth:" -"`http_error_\\` methods of the handler classes." +"code to determine the specific error handler; refer to the :meth:`!" +"http_error_\\` methods of the handler classes." msgstr "" #: library/urllib.request.rst:680 @@ -824,13 +824,13 @@ msgstr "" #: library/urllib.request.rst:687 msgid "" -"Every handler with a method named like :meth:`_request` has that " +"Every handler with a method named like :meth:`!_request` has that " "method called to pre-process the request." msgstr "" #: library/urllib.request.rst:690 msgid "" -"Handlers with a method named like :meth:`_open` are called to " +"Handlers with a method named like :meth:`!_open` are called to " "handle the request. This stage ends when a handler either returns a non-\\ :" "const:`None` value (ie. a response), or raises an exception (usually :exc:" "`~urllib.error.URLError`). Exceptions are allowed to propagate." @@ -839,10 +839,10 @@ msgstr "" #: library/urllib.request.rst:695 msgid "" "In fact, the above algorithm is first tried for methods named :meth:" -"`default_open`. If all such methods return :const:`None`, the algorithm is " -"repeated for methods named like :meth:`_open`. If all such " -"methods return :const:`None`, the algorithm is repeated for methods named :" -"meth:`unknown_open`." +"`~BaseHandler.default_open`. If all such methods return :const:`None`, the " +"algorithm is repeated for methods named like :meth:`!_open`. If " +"all such methods return :const:`None`, the algorithm is repeated for methods " +"named :meth:`~BaseHandler.unknown_open`." msgstr "" #: library/urllib.request.rst:701 @@ -854,7 +854,7 @@ msgstr "" #: library/urllib.request.rst:705 msgid "" -"Every handler with a method named like :meth:`_response` has that " +"Every handler with a method named like :meth:`!_response` has that " "method called to post-process the response." msgstr "" @@ -909,7 +909,7 @@ msgid "" "return value of the :meth:`~OpenerDirector.open` method of :class:" "`OpenerDirector`, or ``None``. It should raise :exc:`~urllib.error." "URLError`, unless a truly exceptional thing happens (for example, :exc:" -"`MemoryError` should not be mapped to :exc:`URLError`)." +"`MemoryError` should not be mapped to :exc:`~urllib.error.URLError`)." msgstr "" #: library/urllib.request.rst:756 @@ -926,7 +926,7 @@ msgstr "" msgid "" "This method, if defined, will be called by the parent :class:" "`OpenerDirector`. Return values should be the same as for :meth:" -"`default_open`." +"`~BaseHandler.default_open`." msgstr "" #: library/urllib.request.rst:772 @@ -980,7 +980,7 @@ msgstr "" #: library/urllib.request.rst:806 msgid "" "Arguments, return values and exceptions raised should be the same as for :" -"meth:`http_error_default`." +"meth:`~BaseHandler.http_error_default`." msgstr "" #: library/urllib.request.rst:814 @@ -1024,9 +1024,9 @@ msgstr "" #: library/urllib.request.rst:847 msgid "" -"An :class:`HTTPError` exception raised as a security consideration if the " -"HTTPRedirectHandler is presented with a redirected URL which is not an HTTP, " -"HTTPS or FTP URL." +"An :exc:`~urllib.error.HTTPError` exception raised as a security " +"consideration if the HTTPRedirectHandler is presented with a redirected URL " +"which is not an HTTP, HTTPS or FTP URL." msgstr "" #: library/urllib.request.rst:854 @@ -1098,7 +1098,7 @@ msgstr "" #: library/urllib.request.rst:924 msgid "" -"The :class:`ProxyHandler` will have a method :meth:`_open` for " +"The :class:`ProxyHandler` will have a method :meth:`!_open` for " "every *protocol* which has a proxy in the *proxies* dictionary given in the " "constructor. The method will modify requests to go through the proxy, by " "calling ``request.set_proxy()``, and call the next handler in the chain to " @@ -1318,8 +1318,8 @@ msgstr "" #: library/urllib.request.rst:1179 msgid "" -"For non-200 error codes, this simply passes the job on to the :meth:" -"`http_error_\\` handler methods, via :meth:`OpenerDirector.error`. " +"For non-200 error codes, this simply passes the job on to the :meth:`!" +"http_error_\\` handler methods, via :meth:`OpenerDirector.error`. " "Eventually, :class:`HTTPDefaultErrorHandler` will raise an :exc:`~urllib." "error.HTTPError` if no other handler handles the error." msgstr "" @@ -1400,7 +1400,7 @@ msgid "" ":func:`build_opener` provides many handlers by default, including a :class:" "`ProxyHandler`. By default, :class:`ProxyHandler` uses the environment " "variables named ``_proxy``, where ```` is the URL scheme " -"involved. For example, the :envvar:`http_proxy` environment variable is " +"involved. For example, the :envvar:`!http_proxy` environment variable is " "read to obtain the HTTP proxy's URL." msgstr "" @@ -1474,8 +1474,8 @@ msgid "" "a local file, the object will not be copied unless filename is supplied. " "Return a tuple ``(filename, headers)`` where *filename* is the local file " "name under which the object can be found, and *headers* is whatever the :" -"meth:`info` method of the object returned by :func:`urlopen` returned (for a " -"remote object). Exceptions are the same as for :func:`urlopen`." +"meth:`!info` method of the object returned by :func:`urlopen` returned (for " +"a remote object). Exceptions are the same as for :func:`urlopen`." msgstr "" #: library/urllib.request.rst:1385 @@ -1505,10 +1505,10 @@ msgstr "" #: library/urllib.request.rst:1407 msgid "" -":func:`urlretrieve` will raise :exc:`ContentTooShortError` when it detects " -"that the amount of data available was less than the expected amount (which " -"is the size reported by a *Content-Length* header). This can occur, for " -"example, when the download is interrupted." +":func:`urlretrieve` will raise :exc:`~urllib.error.ContentTooShortError` " +"when it detects that the amount of data available was less than the " +"expected amount (which is the size reported by a *Content-Length* header). " +"This can occur, for example, when the download is interrupted." msgstr "" #: library/urllib.request.rst:1412 @@ -1520,8 +1520,8 @@ msgstr "" #: library/urllib.request.rst:1416 msgid "" -"You can still retrieve the downloaded data in this case, it is stored in " -"the :attr:`content` attribute of the exception instance." +"You can still retrieve the downloaded data in this case, it is stored in " +"the :attr:`!content` attribute of the exception instance." msgstr "" #: library/urllib.request.rst:1419 @@ -1640,9 +1640,9 @@ msgstr "" #: library/urllib.request.rst:1511 msgid "" -"For all other response codes, the method :meth:`http_error_default` is " -"called which you can override in subclasses to handle the error " -"appropriately." +"For all other response codes, the method :meth:`~BaseHandler." +"http_error_default` is called which you can override in subclasses to handle " +"the error appropriately." msgstr "" #: library/urllib.request.rst:1516 diff --git a/library/venv.po b/library/venv.po index c019629bf..5a7223f52 100644 --- a/library/venv.po +++ b/library/venv.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -125,13 +125,13 @@ msgstr "" #: using/venv-create.inc:17 msgid "" -"``pyvenv`` was the recommended tool for creating virtual environments for " -"Python 3.3 and 3.4, and is :ref:`deprecated in Python 3.6 `." +"The use of ``venv`` is now recommended for creating virtual environments." msgstr "" -#: using/venv-create.inc:22 +#: using/venv-create.inc:20 msgid "" -"The use of ``venv`` is now recommended for creating virtual environments." +"``pyvenv`` was the recommended tool for creating virtual environments for " +"Python 3.3 and 3.4, and is :ref:`deprecated in Python 3.6 `." msgstr "" #: using/venv-create.inc:27 @@ -148,7 +148,7 @@ msgstr "" msgid "The command, if run with ``-h``, will show the available options::" msgstr "" -#: library/venv.rst:313 +#: using/venv-create.inc:72 msgid "``setuptools`` is no longer a core venv dependency." msgstr "" @@ -548,14 +548,14 @@ msgstr "" #: library/venv.rst:279 msgid "" -"The attribute ``lib_path`` was added to the context, and the context object " -"was documented." +"The *venv* :ref:`sysconfig installation scheme ` is used " +"to construct the paths of the created directories." msgstr "" -#: library/venv.rst:283 +#: library/venv.rst:284 msgid "" -"The *venv* :ref:`sysconfig installation scheme ` is used " -"to construct the paths of the created directories." +"The attribute ``lib_path`` was added to the context, and the context object " +"was documented." msgstr "" #: library/venv.rst:290 diff --git a/library/webbrowser.po b/library/webbrowser.po index dd80cdfa7..bb19a4773 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -107,7 +107,7 @@ msgid "" "is neither supported nor portable." msgstr "" -#: library/webbrowser.rst:78 +#: library/webbrowser.rst:80 msgid "" "Raises an :ref:`auditing event ` ``webbrowser.open`` with argument " "``url``." diff --git a/library/xml.etree.elementtree.po b/library/xml.etree.elementtree.po index ef6f788c9..85a6f7f2b 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: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -692,9 +692,9 @@ msgstr "" #: library/xml.etree.elementtree.rst:666 msgid "" "Note that :class:`XMLParser` skips over processing instructions in the input " -"instead of creating comment objects for them. An :class:`ElementTree` will " -"only contain processing instruction nodes if they have been inserted into to " -"the tree using one of the :class:`Element` methods." +"instead of creating PI objects for them. An :class:`ElementTree` will only " +"contain processing instruction nodes if they have been inserted into to the " +"tree using one of the :class:`Element` methods." msgstr "" #: library/xml.etree.elementtree.rst:674 @@ -735,11 +735,11 @@ msgstr "" #: library/xml.etree.elementtree.rst:708 library/xml.etree.elementtree.rst:735 #: library/xml.etree.elementtree.rst:1192 -msgid "The *short_empty_elements* parameter." +msgid "Added the *short_empty_elements* parameter." msgstr "" #: library/xml.etree.elementtree.rst:711 library/xml.etree.elementtree.rst:738 -msgid "The *xml_declaration* and *default_namespace* parameters." +msgid "Added the *xml_declaration* and *default_namespace* parameters." msgstr "" #: library/xml.etree.elementtree.rst:714 @@ -871,7 +871,7 @@ msgid "" msgstr "" #: library/xml.etree.elementtree.rst:861 -msgid "The *base_url* and *max_depth* parameters." +msgid "Added the *base_url* and *max_depth* parameters." msgstr "" #: library/xml.etree.elementtree.rst:868 @@ -1282,7 +1282,7 @@ msgstr "" #: library/xml.etree.elementtree.rst:1305 msgid "" -"Creates a comment with the given *target* name and *text*. If " +"Creates a process instruction with the given *target* name and *text*. If " "``insert_pis`` is true, this will also add it to the tree." msgstr "" diff --git a/library/xml.po b/library/xml.po index 4a4b5306f..046bc9d43 100644 --- a/library/xml.po +++ b/library/xml.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -134,7 +134,7 @@ msgstr "" msgid "quadratic blowup" msgstr "" -#: library/xml.rst:103 +#: library/xml.rst:109 msgid "external entity expansion" msgstr "" @@ -154,7 +154,7 @@ msgstr "" msgid "Safe (4)" msgstr "" -#: library/xml.rst:108 +#: library/xml.rst:114 msgid "`DTD`_ retrieval" msgstr "" @@ -162,7 +162,7 @@ msgstr "" msgid "Safe" msgstr "" -#: library/xml.rst:115 +#: library/xml.rst:121 msgid "decompression bomb" msgstr "" @@ -170,7 +170,15 @@ msgstr "" msgid "**Vulnerable**" msgstr "" -#: library/xml.rst:73 +#: library/xml.rst:128 +msgid "large tokens" +msgstr "" + +#: library/xml.rst:71 +msgid "**Vulnerable** (6)" +msgstr "" + +#: library/xml.rst:74 msgid "" "Expat 2.4.1 and newer is not vulnerable to the \"billion laughs\" and " "\"quadratic blowup\" vulnerabilities. Items still listed as vulnerable due " @@ -178,33 +186,41 @@ msgid "" "EXPAT_VERSION`." msgstr "" -#: library/xml.rst:77 +#: library/xml.rst:78 msgid "" ":mod:`xml.etree.ElementTree` doesn't expand external entities and raises a :" "exc:`~xml.etree.ElementTree.ParseError` when an entity occurs." msgstr "" -#: library/xml.rst:79 +#: library/xml.rst:80 msgid "" ":mod:`xml.dom.minidom` doesn't expand external entities and simply returns " "the unexpanded entity verbatim." msgstr "" -#: library/xml.rst:81 +#: library/xml.rst:82 msgid ":mod:`xmlrpc.client` doesn't expand external entities and omits them." msgstr "" -#: library/xml.rst:82 +#: library/xml.rst:83 msgid "" "Since Python 3.7.1, external general entities are no longer processed by " "default." msgstr "" -#: library/xml.rst:91 +#: library/xml.rst:85 +msgid "" +"Expat 2.6.0 and newer is not vulnerable to denial of service through " +"quadratic runtime caused by parsing large tokens. Items still listed as " +"vulnerable due to potential reliance on system-provided libraries. Check :" +"const:`!pyexpat.EXPAT_VERSION`." +msgstr "" + +#: library/xml.rst:97 msgid "billion laughs / exponential entity expansion" msgstr "" -#: library/xml.rst:87 +#: library/xml.rst:93 msgid "" "The `Billion Laughs`_ attack -- also known as exponential entity expansion " "-- uses multiple levels of nested entities. Each entity refers to another " @@ -213,11 +229,11 @@ msgid "" "consumes lots of memory and CPU time." msgstr "" -#: library/xml.rst:98 +#: library/xml.rst:104 msgid "quadratic blowup entity expansion" msgstr "" -#: library/xml.rst:94 +#: library/xml.rst:100 msgid "" "A quadratic blowup attack is similar to a `Billion Laughs`_ attack; it " "abuses entity expansion, too. Instead of nested entities it repeats one " @@ -226,21 +242,21 @@ msgid "" "countermeasures that forbid deeply nested entities." msgstr "" -#: library/xml.rst:101 +#: library/xml.rst:107 msgid "" "Entity declarations can contain more than just text for replacement. They " "can also point to external resources or local files. The XML parser accesses " "the resource and embeds the content into the XML document." msgstr "" -#: library/xml.rst:106 +#: library/xml.rst:112 msgid "" "Some XML libraries like Python's :mod:`xml.dom.pulldom` retrieve document " "type definitions from remote or local locations. The feature has similar " "implications as the external entity expansion issue." msgstr "" -#: library/xml.rst:111 +#: library/xml.rst:117 msgid "" "Decompression bombs (aka `ZIP bomb`_) apply to all XML libraries that can " "parse compressed XML streams such as gzipped HTTP streams or LZMA-compressed " @@ -248,17 +264,26 @@ msgid "" "magnitudes or more." msgstr "" -#: library/xml.rst:117 +#: library/xml.rst:124 +msgid "" +"Expat needs to re-parse unfinished tokens; without the protection introduced " +"in Expat 2.6.0, this can lead to quadratic runtime that can be used to cause " +"denial of service in the application parsing XML. The issue is known as " +"`CVE-2023-52425 `_." +msgstr "" + +#: library/xml.rst:130 msgid "" "The documentation for `defusedxml`_ on PyPI has further information about " "all known attack vectors with examples and references." msgstr "" -#: library/xml.rst:123 +#: library/xml.rst:136 msgid "The :mod:`!defusedxml` Package" msgstr "" -#: library/xml.rst:125 +#: library/xml.rst:138 msgid "" "`defusedxml`_ is a pure Python package with modified subclasses of all " "stdlib XML parsers that prevent any potentially malicious operation. Use of " diff --git a/library/xml.sax.utils.po b/library/xml.sax.utils.po index df3955196..95480fbd7 100644 --- a/library/xml.sax.utils.po +++ b/library/xml.sax.utils.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -95,7 +95,7 @@ msgid "" msgstr "" #: library/xml.sax.utils.rst:74 -msgid "The *short_empty_elements* parameter." +msgid "Added the *short_empty_elements* parameter." msgstr "" #: library/xml.sax.utils.rst:80 diff --git a/library/zipapp.po b/library/zipapp.po index 91f15d3ce..78839e110 100644 --- a/library/zipapp.po +++ b/library/zipapp.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -232,7 +232,7 @@ msgid "" msgstr "" #: library/zipapp.rst:174 -msgid "Added the *filter* and *compressed* arguments." +msgid "Added the *filter* and *compressed* parameters." msgstr "" #: library/zipapp.rst:179 diff --git a/library/zipfile.po b/library/zipfile.po index 702d997d5..17bead1b6 100644 --- a/library/zipfile.po +++ b/library/zipfile.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -281,8 +281,8 @@ msgstr "" msgid "Add the *compresslevel* parameter." msgstr "" -#: library/zipfile.rst:746 -msgid "The *strict_timestamps* keyword-only argument" +#: library/zipfile.rst:239 +msgid "The *strict_timestamps* keyword-only parameter." msgstr "" #: library/zipfile.rst:242 @@ -733,7 +733,7 @@ msgid "" msgstr "" #: library/zipfile.rst:645 -msgid "The *optimize* parameter." +msgid "Added the *optimize* parameter." msgstr "" #: library/zipfile.rst:651 @@ -793,7 +793,7 @@ msgid "The :meth:`writepy` method makes archives with file names like this::" msgstr "" #: library/zipfile.rst:701 -msgid "The *filterfunc* parameter." +msgid "Added the *filterfunc* parameter." msgstr "" #: library/zipfile.rst:704 @@ -842,6 +842,10 @@ msgstr "" msgid "The *filename* parameter accepts a :term:`path-like object`." msgstr "" +#: library/zipfile.rst:746 +msgid "Added the *strict_timestamps* keyword-only parameter." +msgstr "" + #: library/zipfile.rst:750 msgid "Instances have the following methods and attributes:" msgstr "" diff --git a/license.po b/license.po index c94f4d5b3..5a3478ad9 100644 --- a/license.po +++ b/license.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: 2022-12-28 16:31-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -533,7 +533,59 @@ msgid "Audioop" msgstr "Audioop" #: license.rst:1048 +#, fuzzy msgid "" -"The audioop module uses the code base in g771.c file of the SoX project::" +"The audioop module uses the code base in g771.c file of the SoX project. " +"https://sourceforge.net/projects/sox/files/sox/12.17.7/sox-12.17.7.tar.gz" msgstr "" "Audioop modülü, SoX projesinin g771.c dosyasındaki kod tabanını kullanır::" + +#: license.rst:1051 +msgid "" +"This source code is a product of Sun Microsystems, Inc. and is provided for " +"unrestricted use. Users may copy or modify this source code without charge." +msgstr "" + +#: license.rst:1055 +msgid "" +"SUN SOURCE CODE IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING " +"THE WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR " +"PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE." +msgstr "" + +#: license.rst:1059 +msgid "" +"Sun source code is provided with no support and without any obligation on " +"the part of Sun Microsystems, Inc. to assist in its use, correction, " +"modification or enhancement." +msgstr "" + +#: license.rst:1063 +msgid "" +"SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE " +"INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY THIS SOFTWARE OR " +"ANY PART THEREOF." +msgstr "" + +#: license.rst:1067 +msgid "" +"In no event will Sun Microsystems, Inc. be liable for any lost revenue or " +"profits or other special, indirect and consequential damages, even if Sun " +"has been advised of the possibility of such damages." +msgstr "" + +#: license.rst:1071 +msgid "" +"Sun Microsystems, Inc. 2550 Garcia Avenue Mountain View, California 94043" +msgstr "" + +#: license.rst:1077 +msgid "asyncio" +msgstr "" + +#: license.rst:1079 +msgid "" +"Parts of the :mod:`asyncio` module are incorporated from `uvloop 0.16 " +"`_, which is distributed " +"under the MIT license::" +msgstr "" diff --git a/reference/datamodel.po b/reference/datamodel.po index 8092bca82..49073226a 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-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -596,7 +596,7 @@ msgid "" "containing the same number of items as the function's formal parameter list." msgstr "" -#: reference/datamodel.rst:1127 reference/datamodel.rst:1314 +#: reference/datamodel.rst:1127 reference/datamodel.rst:1322 msgid "Special read-only attributes" msgstr "" @@ -627,7 +627,7 @@ msgid "" "the value of the cell, as well as set the value." msgstr "" -#: reference/datamodel.rst:1351 +#: reference/datamodel.rst:1359 msgid "Special writable attributes" msgstr "" @@ -729,7 +729,7 @@ msgid "" "callable object (normally a user-defined function)." msgstr "" -#: reference/datamodel.rst:1442 +#: reference/datamodel.rst:1450 msgid "Special read-only attributes:" msgstr "" @@ -1231,95 +1231,95 @@ msgstr "" msgid "The fully qualified function name" msgstr "" -#: reference/datamodel.rst:1138 +#: reference/datamodel.rst:1140 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:1143 +#: reference/datamodel.rst:1145 msgid "" "The number of positional-only :term:`parameters ` (including " "arguments with default values) that the function has" msgstr "" -#: reference/datamodel.rst:1147 +#: reference/datamodel.rst:1149 msgid "" "The number of keyword-only :term:`parameters ` (including " "arguments with default values) that the function has" msgstr "" -#: reference/datamodel.rst:1151 +#: reference/datamodel.rst:1153 msgid "" "The number of :ref:`local variables ` used by the function " "(including parameters)" msgstr "" -#: reference/datamodel.rst:1155 +#: reference/datamodel.rst:1157 msgid "" "A :class:`tuple` containing the names of the local variables in the function " "(starting with the parameter names)" msgstr "" -#: reference/datamodel.rst:1159 +#: reference/datamodel.rst:1161 msgid "" "A :class:`tuple` containing the names of :ref:`local variables ` " "that are referenced by nested functions inside the function" msgstr "" -#: reference/datamodel.rst:1163 +#: reference/datamodel.rst:1165 msgid "A :class:`tuple` containing the names of free variables in the function" msgstr "" -#: reference/datamodel.rst:1166 +#: reference/datamodel.rst:1168 msgid "" "A string representing the sequence of :term:`bytecode` instructions in the " "function" msgstr "" -#: reference/datamodel.rst:1170 +#: reference/datamodel.rst:1172 msgid "" "A :class:`tuple` containing the literals used by the :term:`bytecode` in the " "function" msgstr "" -#: reference/datamodel.rst:1174 +#: reference/datamodel.rst:1176 msgid "" "A :class:`tuple` containing the names used by the :term:`bytecode` in the " "function" msgstr "" -#: reference/datamodel.rst:1178 +#: reference/datamodel.rst:1180 msgid "The name of the file from which the code was compiled" msgstr "" -#: reference/datamodel.rst:1181 +#: reference/datamodel.rst:1183 msgid "The line number of the first line of the function" msgstr "" -#: reference/datamodel.rst:1184 +#: reference/datamodel.rst:1186 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:1187 +#: reference/datamodel.rst:1189 msgid "" "This attribute of code objects is deprecated, and may be removed in Python " "3.14." msgstr "" -#: reference/datamodel.rst:1192 +#: reference/datamodel.rst:1194 msgid "The required stack size of the code object" msgstr "" -#: reference/datamodel.rst:1195 +#: reference/datamodel.rst:1197 msgid "" "An :class:`integer ` encoding a number of flags for the interpreter." msgstr "" -#: reference/datamodel.rst:1200 +#: reference/datamodel.rst:1202 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 " @@ -1330,7 +1330,7 @@ msgid "" "might be present." msgstr "" -#: reference/datamodel.rst:1208 +#: reference/datamodel.rst:1210 msgid "" "Future feature declarations (``from __future__ import division``) also use " "bits in :attr:`~codeobject.co_flags` to indicate whether a code object was " @@ -1339,29 +1339,29 @@ msgid "" "``0x1000`` were used in earlier versions of Python." msgstr "" -#: reference/datamodel.rst:1214 +#: reference/datamodel.rst:1216 msgid "" "Other bits in :attr:`~codeobject.co_flags` are reserved for internal use." msgstr "" -#: reference/datamodel.rst:1218 +#: reference/datamodel.rst:1220 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:1223 +#: reference/datamodel.rst:1225 msgid "Methods on code objects" msgstr "" -#: reference/datamodel.rst:1227 +#: reference/datamodel.rst:1229 msgid "" "Returns an iterable over the source code positions of each :term:`bytecode` " "instruction in the code object." msgstr "" -#: reference/datamodel.rst:1230 +#: reference/datamodel.rst:1232 msgid "" "The iterator returns :class:`tuple`\\s containing the ``(start_line, " "end_line, start_column, end_column)``. The *i-th* tuple corresponds to the " @@ -1369,37 +1369,37 @@ msgid "" "information is 0-indexed utf-8 byte offsets on the given source line." msgstr "" -#: reference/datamodel.rst:1236 +#: reference/datamodel.rst:1238 msgid "" "This positional information can be missing. A non-exhaustive lists of cases " "where this may happen:" msgstr "" -#: reference/datamodel.rst:1239 +#: reference/datamodel.rst:1241 msgid "Running the interpreter with :option:`-X` ``no_debug_ranges``." msgstr "" -#: reference/datamodel.rst:1240 +#: reference/datamodel.rst:1242 msgid "" "Loading a pyc file compiled while using :option:`-X` ``no_debug_ranges``." msgstr "" -#: reference/datamodel.rst:1241 +#: reference/datamodel.rst:1243 msgid "Position tuples corresponding to artificial instructions." msgstr "" -#: reference/datamodel.rst:1242 +#: reference/datamodel.rst:1244 msgid "" "Line and column numbers that can't be represented due to implementation " "specific limitations." msgstr "" -#: reference/datamodel.rst:1245 +#: reference/datamodel.rst:1247 msgid "" "When this occurs, some or all of the tuple elements can be :const:`None`." msgstr "" -#: reference/datamodel.rst:1251 +#: reference/datamodel.rst:1253 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 " @@ -1409,139 +1409,144 @@ msgid "" "environment variable can be used." msgstr "" -#: reference/datamodel.rst:1260 +#: reference/datamodel.rst:1262 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:1264 +#: reference/datamodel.rst:1266 msgid "" "``start`` (an :class:`int`) represents the offset (inclusive) of the start " "of the :term:`bytecode` range" msgstr "" -#: reference/datamodel.rst:1266 +#: reference/datamodel.rst:1268 msgid "" -"``end`` (an :class:`int`) represents the offset (inclusive) of the end of " +"``end`` (an :class:`int`) represents the offset (exclusive) of the end of " "the :term:`bytecode` range" msgstr "" -#: reference/datamodel.rst:1268 +#: reference/datamodel.rst:1270 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:1272 -msgid "The items yielded generated will have the following properties:" +#: reference/datamodel.rst:1274 +msgid "The items yielded will have the following properties:" msgstr "" -#: reference/datamodel.rst:1274 +#: reference/datamodel.rst:1276 msgid "The first range yielded will have a ``start`` of 0." msgstr "" -#: reference/datamodel.rst:1275 +#: reference/datamodel.rst:1277 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:1278 +#: reference/datamodel.rst:1280 msgid "No range will be backwards: ``end >= start`` for all triples." msgstr "" -#: reference/datamodel.rst:1279 +#: reference/datamodel.rst:1281 msgid "" -"The :class:`tuple` yielded will have ``end`` equal to the size of the :term:" -"`bytecode`." +"The last :class:`tuple` yielded will have ``end`` equal to the size of the :" +"term:`bytecode`." msgstr "" -#: reference/datamodel.rst:1282 +#: reference/datamodel.rst:1284 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:1290 +#: reference/datamodel.rst:1292 msgid ":pep:`626` - Precise line numbers for debugging and other tools." msgstr "" -#: reference/datamodel.rst:1291 +#: reference/datamodel.rst:1293 msgid "The PEP that introduced the :meth:`!co_lines` method." msgstr "" #: reference/datamodel.rst:1297 +msgid "" +"Return a copy of the code object with new values for the specified fields." +msgstr "" + +#: reference/datamodel.rst:1305 msgid "Frame objects" msgstr "" -#: reference/datamodel.rst:1301 +#: reference/datamodel.rst:1309 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:1319 +#: reference/datamodel.rst:1327 msgid "" "Points to the previous stack frame (towards the caller), or ``None`` if this " "is the bottom stack frame" msgstr "" -#: reference/datamodel.rst:1323 +#: reference/datamodel.rst:1331 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:1328 +#: reference/datamodel.rst:1336 msgid "" "The dictionary used by the frame to look up :ref:`local variables `" msgstr "" -#: reference/datamodel.rst:1332 +#: reference/datamodel.rst:1340 msgid "" "The dictionary used by the frame to look up :ref:`global variables `" msgstr "" -#: reference/datamodel.rst:1336 +#: reference/datamodel.rst:1344 msgid "" "The dictionary used by the frame to look up :ref:`built-in (intrinsic) names " "`" msgstr "" -#: reference/datamodel.rst:1340 +#: reference/datamodel.rst:1348 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:1356 +#: reference/datamodel.rst:1364 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:1361 +#: reference/datamodel.rst:1369 msgid "" "Set this attribute to :const:`False` to disable triggering a tracing event " "for each source line." msgstr "" -#: reference/datamodel.rst:1365 +#: reference/datamodel.rst:1373 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:1371 +#: reference/datamodel.rst:1379 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 " @@ -1549,15 +1554,15 @@ msgid "" "this attribute." msgstr "" -#: reference/datamodel.rst:1377 +#: reference/datamodel.rst:1385 msgid "Frame object methods" msgstr "" -#: reference/datamodel.rst:1379 +#: reference/datamodel.rst:1387 msgid "Frame objects support one method:" msgstr "" -#: reference/datamodel.rst:1383 +#: reference/datamodel.rst:1391 msgid "" "This method clears all references to :ref:`local variables ` held by " "the frame. Also, if the frame belonged to a :term:`generator`, the " @@ -1566,26 +1571,26 @@ msgid "" "and storing its :ref:`traceback ` for later use)." msgstr "" -#: reference/datamodel.rst:1389 +#: reference/datamodel.rst:1397 msgid ":exc:`RuntimeError` is raised if the frame is currently executing." msgstr "" -#: reference/datamodel.rst:1397 +#: reference/datamodel.rst:1405 msgid "Traceback objects" msgstr "" -#: reference/datamodel.rst:1410 +#: reference/datamodel.rst:1418 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:1415 +#: reference/datamodel.rst:1423 msgid "Traceback objects can now be explicitly instantiated from Python code." msgstr "" -#: reference/datamodel.rst:1418 +#: reference/datamodel.rst:1426 msgid "" "For implicitly created tracebacks, when the search for an exception handler " "unwinds the execution stack, at each unwound level a traceback object is " @@ -1596,7 +1601,7 @@ msgid "" "the caught exception." msgstr "" -#: reference/datamodel.rst:1427 +#: reference/datamodel.rst:1435 msgid "" "When the program contains no suitable handler, the stack trace is written " "(nicely formatted) to the standard error stream; if the interpreter is " @@ -1604,33 +1609,33 @@ msgid "" "last_traceback`." msgstr "" -#: reference/datamodel.rst:1432 +#: reference/datamodel.rst:1440 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:1447 +#: reference/datamodel.rst:1455 msgid "" "Points to the execution :ref:`frame ` of the current level." msgstr "" -#: reference/datamodel.rst:1450 +#: reference/datamodel.rst:1458 msgid "" "Accessing this attribute raises an :ref:`auditing event ` ``object." "__getattr__`` with arguments ``obj`` and ``\"tb_frame\"``." msgstr "" -#: reference/datamodel.rst:1455 +#: reference/datamodel.rst:1463 msgid "Gives the line number where the exception occurred" msgstr "" -#: reference/datamodel.rst:1458 +#: reference/datamodel.rst:1466 msgid "Indicates the \"precise instruction\"." msgstr "" -#: reference/datamodel.rst:1460 +#: reference/datamodel.rst:1468 msgid "" "The line number and last instruction in the traceback may differ from the " "line number of its :ref:`frame object ` if the exception " @@ -1638,39 +1643,39 @@ msgid "" "with a :keyword:`finally` clause." msgstr "" -#: reference/datamodel.rst:1471 +#: reference/datamodel.rst:1479 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:1475 +#: reference/datamodel.rst:1483 msgid "This attribute is now writable" msgstr "" -#: reference/datamodel.rst:1480 +#: reference/datamodel.rst:1488 msgid "Slice objects" msgstr "" -#: reference/datamodel.rst:1484 +#: reference/datamodel.rst:1492 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:1493 +#: reference/datamodel.rst:1501 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:1497 +#: reference/datamodel.rst:1505 msgid "Slice objects support one method:" msgstr "" -#: reference/datamodel.rst:1501 +#: reference/datamodel.rst:1509 msgid "" "This method takes a single integer argument *length* and computes " "information about the slice that the slice object would describe if applied " @@ -1680,11 +1685,11 @@ msgid "" "a manner consistent with regular slices." msgstr "" -#: reference/datamodel.rst:1510 +#: reference/datamodel.rst:1518 msgid "Static method objects" msgstr "" -#: reference/datamodel.rst:1512 +#: reference/datamodel.rst:1520 msgid "" "Static method objects provide a way of defeating the transformation of " "function objects to method objects described above. A static method object " @@ -1695,24 +1700,25 @@ msgid "" "method objects are created by the built-in :func:`staticmethod` constructor." msgstr "" -#: reference/datamodel.rst:1522 +#: reference/datamodel.rst:1530 msgid "Class method objects" msgstr "" -#: reference/datamodel.rst:1524 +#: reference/datamodel.rst:1532 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 " "classes and class instances. The behaviour of class method objects upon such " -"retrieval is described above, under \"User-defined methods\". Class method " -"objects are created by the built-in :func:`classmethod` constructor." +"retrieval is described above, under :ref:`\"instance methods\" `. Class method objects are created by the built-in :func:" +"`classmethod` constructor." msgstr "" -#: reference/datamodel.rst:1534 +#: reference/datamodel.rst:1542 msgid "Special method names" msgstr "" -#: reference/datamodel.rst:1540 +#: reference/datamodel.rst:1548 msgid "" "A class can implement certain operations that are invoked by special syntax " "(such as arithmetic operations or subscripting and slicing) by defining " @@ -1726,7 +1732,7 @@ msgid "" "`TypeError`)." msgstr "" -#: reference/datamodel.rst:1551 +#: reference/datamodel.rst:1559 msgid "" "Setting a special method to ``None`` indicates that the corresponding " "operation is not available. For example, if a class sets :meth:`~object." @@ -1735,7 +1741,7 @@ msgid "" "`~object.__getitem__`). [#]_" msgstr "" -#: reference/datamodel.rst:1557 +#: reference/datamodel.rst:1565 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 " @@ -1745,11 +1751,11 @@ msgid "" "the W3C's Document Object Model.)" msgstr "" -#: reference/datamodel.rst:1568 +#: reference/datamodel.rst:1576 msgid "Basic customization" msgstr "" -#: reference/datamodel.rst:1574 +#: reference/datamodel.rst:1582 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 " @@ -1759,7 +1765,7 @@ msgid "" "new object instance (usually an instance of *cls*)." msgstr "" -#: reference/datamodel.rst:1581 +#: reference/datamodel.rst:1589 msgid "" "Typical implementations create a new instance of the class by invoking the " "superclass's :meth:`__new__` method using ``super().__new__(cls[, ...])`` " @@ -1767,7 +1773,7 @@ msgid "" "necessary before returning it." msgstr "" -#: reference/datamodel.rst:1586 +#: reference/datamodel.rst:1594 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 " @@ -1776,13 +1782,13 @@ msgid "" "constructor." msgstr "" -#: reference/datamodel.rst:1591 +#: reference/datamodel.rst:1599 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:1594 +#: reference/datamodel.rst:1602 msgid "" ":meth:`__new__` is intended mainly to allow subclasses of immutable types " "(like int, str, or tuple) to customize instance creation. It is also " @@ -1790,7 +1796,7 @@ msgid "" "creation." msgstr "" -#: reference/datamodel.rst:1603 +#: reference/datamodel.rst:1611 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 " @@ -1800,7 +1806,7 @@ msgid "" "example: ``super().__init__([args...])``." msgstr "" -#: reference/datamodel.rst:1610 +#: reference/datamodel.rst:1618 msgid "" "Because :meth:`__new__` and :meth:`__init__` work together in constructing " "objects (:meth:`__new__` to create it, and :meth:`__init__` to customize " @@ -1808,7 +1814,7 @@ msgid "" "will cause a :exc:`TypeError` to be raised at runtime." msgstr "" -#: reference/datamodel.rst:1623 +#: reference/datamodel.rst:1631 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:" @@ -1817,7 +1823,7 @@ msgid "" "instance." msgstr "" -#: reference/datamodel.rst:1629 +#: reference/datamodel.rst:1637 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. " @@ -1827,20 +1833,20 @@ msgid "" "it once." msgstr "" -#: reference/datamodel.rst:1636 +#: reference/datamodel.rst:1644 msgid "" "It is not guaranteed that :meth:`__del__` methods are called for objects " "that still exist when the interpreter exits." msgstr "" -#: reference/datamodel.rst:1641 +#: reference/datamodel.rst:1649 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:1646 +#: reference/datamodel.rst:1654 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 " @@ -1851,18 +1857,18 @@ msgid "" "caught in the traceback." msgstr "" -#: reference/datamodel.rst:1656 +#: reference/datamodel.rst:1664 msgid "Documentation for the :mod:`gc` module." msgstr "" -#: reference/datamodel.rst:1660 +#: reference/datamodel.rst:1668 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:1664 +#: reference/datamodel.rst:1672 msgid "" ":meth:`__del__` can be invoked when arbitrary code is being executed, " "including from any arbitrary thread. If :meth:`__del__` needs to take a " @@ -1871,7 +1877,7 @@ msgid "" "`__del__`." msgstr "" -#: reference/datamodel.rst:1670 +#: reference/datamodel.rst:1678 msgid "" ":meth:`__del__` can be executed during interpreter shutdown. As a " "consequence, the global variables it needs to access (including other " @@ -1882,7 +1888,7 @@ msgid "" "still available at the time when the :meth:`__del__` method is called." msgstr "" -#: reference/datamodel.rst:1685 +#: reference/datamodel.rst:1693 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 " @@ -1894,13 +1900,13 @@ msgid "" "an \"informal\" string representation of instances of that class is required." msgstr "" -#: reference/datamodel.rst:1694 +#: reference/datamodel.rst:1702 msgid "" "This is typically used for debugging, so it is important that the " "representation is information-rich and unambiguous." msgstr "" -#: reference/datamodel.rst:1705 +#: reference/datamodel.rst:1713 msgid "" "Called by :func:`str(object) ` and the built-in functions :func:" "`format` and :func:`print` to compute the \"informal\" or nicely printable " @@ -1908,26 +1914,26 @@ msgid "" "` object." msgstr "" -#: reference/datamodel.rst:1710 +#: reference/datamodel.rst:1718 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:1714 +#: reference/datamodel.rst:1722 msgid "" "The default implementation defined by the built-in type :class:`object` " "calls :meth:`object.__repr__`." msgstr "" -#: reference/datamodel.rst:1724 +#: reference/datamodel.rst:1732 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:1735 +#: reference/datamodel.rst:1743 msgid "" "Called by the :func:`format` built-in function, and by extension, evaluation " "of :ref:`formatted string literals ` and the :meth:`str.format` " @@ -1939,28 +1945,28 @@ msgid "" "formatting option syntax." msgstr "" -#: reference/datamodel.rst:1745 +#: reference/datamodel.rst:1753 msgid "" "See :ref:`formatspec` for a description of the standard formatting syntax." msgstr "" -#: reference/datamodel.rst:1747 +#: reference/datamodel.rst:1755 msgid "The return value must be a string object." msgstr "" -#: reference/datamodel.rst:1749 +#: reference/datamodel.rst:1757 msgid "" "The __format__ method of ``object`` itself raises a :exc:`TypeError` if " "passed any non-empty string." msgstr "" -#: reference/datamodel.rst:1753 +#: reference/datamodel.rst:1761 msgid "" "``object.__format__(x, '')`` is now equivalent to ``str(x)`` rather than " "``format(str(x), '')``." msgstr "" -#: reference/datamodel.rst:1769 +#: reference/datamodel.rst:1777 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:1858 +#: reference/datamodel.rst:1866 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 " @@ -2079,7 +2085,7 @@ msgid "" "``isinstance(obj, collections.abc.Hashable)`` call." msgstr "" -#: reference/datamodel.rst:1867 +#: reference/datamodel.rst:1875 msgid "" "By default, the :meth:`__hash__` values of str and bytes objects are " "\"salted\" with an unpredictable random value. Although they remain " @@ -2087,30 +2093,30 @@ msgid "" "between repeated invocations of Python." msgstr "" -#: reference/datamodel.rst:1872 +#: reference/datamodel.rst:1880 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 " -"insertion, O(n\\ :sup:`2`) complexity. See http://ocert.org/advisories/" -"ocert-2011-003.html for details." +"insertion, *O*\\ (*n*\\ :sup:`2`) complexity. See http://ocert.org/" +"advisories/ocert-2011-003.html for details." msgstr "" -#: reference/datamodel.rst:1877 +#: reference/datamodel.rst:1885 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:1881 +#: reference/datamodel.rst:1889 msgid "See also :envvar:`PYTHONHASHSEED`." msgstr "" -#: reference/datamodel.rst:1883 +#: reference/datamodel.rst:1891 msgid "Hash randomization is enabled by default." msgstr "" -#: reference/datamodel.rst:1891 +#: reference/datamodel.rst:1899 msgid "" "Called to implement truth value testing and the built-in operation " "``bool()``; should return ``False`` or ``True``. When this method is not " @@ -2119,18 +2125,18 @@ msgid "" "meth:`!__len__` nor :meth:`!__bool__`, all its instances are considered true." msgstr "" -#: reference/datamodel.rst:1902 +#: reference/datamodel.rst:1910 msgid "Customizing attribute access" msgstr "" -#: reference/datamodel.rst:1904 +#: reference/datamodel.rst:1912 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:1912 +#: reference/datamodel.rst:1920 msgid "" "Called when the default attribute access fails with an :exc:`AttributeError` " "(either :meth:`__getattribute__` raises an :exc:`AttributeError` because " @@ -2140,7 +2146,7 @@ msgid "" "attribute value or raise an :exc:`AttributeError` exception." msgstr "" -#: reference/datamodel.rst:1919 +#: reference/datamodel.rst:1927 msgid "" "Note that if the attribute is found through the normal mechanism, :meth:" "`__getattr__` is not called. (This is an intentional asymmetry between :" @@ -2153,7 +2159,7 @@ msgid "" "actually get total control over attribute access." msgstr "" -#: reference/datamodel.rst:1932 +#: reference/datamodel.rst:1940 msgid "" "Called unconditionally to implement attribute accesses for instances of the " "class. If the class also defines :meth:`__getattr__`, the latter will not be " @@ -2165,82 +2171,82 @@ msgid "" "example, ``object.__getattribute__(self, name)``." msgstr "" -#: reference/datamodel.rst:1943 +#: reference/datamodel.rst:1951 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:1948 +#: reference/datamodel.rst:1956 msgid "" "Raises an :ref:`auditing event ` ``object.__getattr__`` with " "arguments ``obj``, ``name``." msgstr "" -#: reference/datamodel.rst:1950 +#: reference/datamodel.rst:1958 msgid "" "For certain sensitive attribute accesses, raises an :ref:`auditing event " "` ``object.__getattr__`` with arguments ``obj`` and ``name``." msgstr "" -#: reference/datamodel.rst:1957 +#: reference/datamodel.rst:1965 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:1961 +#: reference/datamodel.rst:1969 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:1965 +#: reference/datamodel.rst:1973 msgid "" "Raises an :ref:`auditing event ` ``object.__setattr__`` with " "arguments ``obj``, ``name``, ``value``." msgstr "" -#: reference/datamodel.rst:1967 +#: reference/datamodel.rst:1975 msgid "" "For certain sensitive attribute assignments, raises an :ref:`auditing event " "` ``object.__setattr__`` with arguments ``obj``, ``name``, " "``value``." msgstr "" -#: reference/datamodel.rst:1974 +#: reference/datamodel.rst:1982 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:1977 +#: reference/datamodel.rst:1985 msgid "" "Raises an :ref:`auditing event ` ``object.__delattr__`` with " "arguments ``obj``, ``name``." msgstr "" -#: reference/datamodel.rst:1979 +#: reference/datamodel.rst:1987 msgid "" "For certain sensitive attribute deletions, raises an :ref:`auditing event " "` ``object.__delattr__`` with arguments ``obj`` and ``name``." msgstr "" -#: reference/datamodel.rst:1986 +#: reference/datamodel.rst:1994 msgid "" -"Called when :func:`dir` is called on the object. A sequence must be " -"returned. :func:`dir` converts the returned sequence to a list and sorts it." +"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:1991 +#: reference/datamodel.rst:1999 msgid "Customizing module attribute access" msgstr "" -#: reference/datamodel.rst:1998 +#: reference/datamodel.rst:2006 msgid "" "Special names ``__getattr__`` and ``__dir__`` can be also used to customize " "access to module attributes. The ``__getattr__`` function at the module " @@ -2252,21 +2258,21 @@ msgid "" "with the attribute name and the result is returned." msgstr "" -#: reference/datamodel.rst:2007 +#: reference/datamodel.rst:2015 msgid "" -"The ``__dir__`` function should accept no arguments, and return a sequence " +"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:2011 +#: reference/datamodel.rst:2019 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:2029 +#: reference/datamodel.rst:2037 msgid "" "Defining module ``__getattr__`` and setting module ``__class__`` only affect " "lookups made using the attribute access syntax -- directly accessing the " @@ -2274,27 +2280,27 @@ msgid "" "module's globals dictionary) is unaffected." msgstr "" -#: reference/datamodel.rst:2034 +#: reference/datamodel.rst:2042 msgid "``__class__`` module attribute is now writable." msgstr "" -#: reference/datamodel.rst:2037 +#: reference/datamodel.rst:2045 msgid "``__getattr__`` and ``__dir__`` module attributes." msgstr "" -#: reference/datamodel.rst:2042 +#: reference/datamodel.rst:2050 msgid ":pep:`562` - Module __getattr__ and __dir__" msgstr "" -#: reference/datamodel.rst:2043 +#: reference/datamodel.rst:2051 msgid "Describes the ``__getattr__`` and ``__dir__`` functions on modules." msgstr "" -#: reference/datamodel.rst:2049 +#: reference/datamodel.rst:2057 msgid "Implementing Descriptors" msgstr "" -#: reference/datamodel.rst:2051 +#: reference/datamodel.rst:2059 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 " @@ -2304,7 +2310,7 @@ msgid "" "the owner class' :attr:`~object.__dict__`." msgstr "" -#: reference/datamodel.rst:2061 +#: reference/datamodel.rst:2069 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 " @@ -2313,13 +2319,13 @@ msgid "" "accessed through the *owner*." msgstr "" -#: reference/datamodel.rst:2067 +#: reference/datamodel.rst:2075 msgid "" "This method should return the computed attribute value or raise an :exc:" "`AttributeError` exception." msgstr "" -#: reference/datamodel.rst:2070 +#: reference/datamodel.rst:2078 msgid "" ":PEP:`252` specifies that :meth:`__get__` is callable with one or two " "arguments. Python's own built-in descriptors support this specification; " @@ -2329,31 +2335,31 @@ msgid "" "not." msgstr "" -#: reference/datamodel.rst:2079 +#: reference/datamodel.rst:2087 msgid "" "Called to set the attribute on an instance *instance* of the owner class to " "a new value, *value*." msgstr "" -#: reference/datamodel.rst:2082 +#: reference/datamodel.rst:2090 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:2088 +#: reference/datamodel.rst:2096 msgid "" "Called to delete the attribute on an instance *instance* of the owner class." msgstr "" -#: reference/datamodel.rst:2090 +#: reference/datamodel.rst:2098 msgid "" "Instances of descriptors may also have the :attr:`!__objclass__` attribute " "present:" msgstr "" -#: reference/datamodel.rst:2095 +#: reference/datamodel.rst:2103 msgid "" "The attribute :attr:`!__objclass__` is interpreted by the :mod:`inspect` " "module as specifying the class where this object was defined (setting this " @@ -2364,11 +2370,11 @@ msgid "" "are implemented in C)." msgstr "" -#: reference/datamodel.rst:2106 +#: reference/datamodel.rst:2114 msgid "Invoking Descriptors" msgstr "" -#: reference/datamodel.rst:2108 +#: reference/datamodel.rst:2116 msgid "" "In general, a descriptor is an object attribute with \"binding behavior\", " "one whose attribute access has been overridden by methods in the descriptor " @@ -2377,7 +2383,7 @@ msgid "" "is said to be a descriptor." msgstr "" -#: reference/datamodel.rst:2114 +#: reference/datamodel.rst:2122 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 " @@ -2385,7 +2391,7 @@ msgid "" "continuing through the base classes of ``type(a)`` excluding metaclasses." msgstr "" -#: reference/datamodel.rst:2119 +#: reference/datamodel.rst:2127 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 " @@ -2393,54 +2399,54 @@ msgid "" "depends on which descriptor methods were defined and how they were called." msgstr "" -#: reference/datamodel.rst:2124 +#: reference/datamodel.rst:2132 msgid "" "The starting point for descriptor invocation is a binding, ``a.x``. How the " "arguments are assembled depends on ``a``:" msgstr "" -#: reference/datamodel.rst:2129 +#: reference/datamodel.rst:2137 msgid "Direct Call" msgstr "" -#: reference/datamodel.rst:2128 +#: reference/datamodel.rst:2136 msgid "" "The simplest and least common call is when user code directly invokes a " "descriptor method: ``x.__get__(a)``." msgstr "" -#: reference/datamodel.rst:2133 +#: reference/datamodel.rst:2141 msgid "Instance Binding" msgstr "" -#: reference/datamodel.rst:2132 +#: reference/datamodel.rst:2140 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:2137 +#: reference/datamodel.rst:2145 msgid "Class Binding" msgstr "" -#: reference/datamodel.rst:2136 +#: reference/datamodel.rst:2144 msgid "" "If binding to a class, ``A.x`` is transformed into the call: ``A." "__dict__['x'].__get__(None, A)``." msgstr "" -#: reference/datamodel.rst:2143 +#: reference/datamodel.rst:2151 msgid "Super Binding" msgstr "" -#: reference/datamodel.rst:2140 +#: reference/datamodel.rst:2148 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:2177 +#: reference/datamodel.rst:2185 msgid "" "For instance bindings, the precedence of descriptor invocation depends on " "which descriptor methods are defined. A descriptor can define any " @@ -2458,7 +2464,7 @@ msgid "" "instances." msgstr "" -#: reference/datamodel.rst:2192 +#: reference/datamodel.rst:2200 msgid "" "Python methods (including those decorated with :func:`@staticmethod " "` and :func:`@classmethod `) are implemented as " @@ -2467,30 +2473,30 @@ msgid "" "from other instances of the same class." msgstr "" -#: reference/datamodel.rst:2198 +#: reference/datamodel.rst:2206 msgid "" "The :func:`property` function is implemented as a data descriptor. " "Accordingly, instances cannot override the behavior of a property." msgstr "" -#: reference/datamodel.rst:2205 +#: reference/datamodel.rst:2213 msgid "__slots__" msgstr "" -#: reference/datamodel.rst:2207 +#: reference/datamodel.rst:2215 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:2211 +#: reference/datamodel.rst:2219 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:2216 +#: reference/datamodel.rst:2224 msgid "" "This class variable can be assigned a string, iterable, or sequence of " "strings with variable names used by instances. *__slots__* reserves space " @@ -2498,18 +2504,18 @@ msgid "" "`~object.__dict__` and *__weakref__* for each instance." msgstr "" -#: reference/datamodel.rst:2225 +#: reference/datamodel.rst:2233 msgid "Notes on using *__slots__*:" msgstr "" -#: reference/datamodel.rst:2227 +#: reference/datamodel.rst:2235 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:2231 +#: reference/datamodel.rst:2239 msgid "" "Without a :attr:`~object.__dict__` variable, instances cannot be assigned " "new variables not listed in the *__slots__* definition. Attempts to assign " @@ -2518,7 +2524,7 @@ msgid "" "sequence of strings in the *__slots__* declaration." msgstr "" -#: reference/datamodel.rst:2238 +#: reference/datamodel.rst:2246 msgid "" "Without a *__weakref__* variable for each instance, classes defining " "*__slots__* do not support :mod:`weak references ` to its " @@ -2526,7 +2532,7 @@ msgid "" "to the sequence of strings in the *__slots__* declaration." msgstr "" -#: reference/datamodel.rst:2244 +#: reference/datamodel.rst:2252 msgid "" "*__slots__* are implemented at the class level by creating :ref:`descriptors " "` for each variable name. As a result, class attributes cannot " @@ -2534,7 +2540,7 @@ msgid "" "otherwise, the class attribute would overwrite the descriptor assignment." msgstr "" -#: reference/datamodel.rst:2250 +#: reference/datamodel.rst:2258 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. " @@ -2543,7 +2549,7 @@ msgid "" "names of any *additional* slots)." msgstr "" -#: reference/datamodel.rst:2256 +#: reference/datamodel.rst:2264 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 " @@ -2552,7 +2558,7 @@ msgid "" "prevent this." msgstr "" -#: reference/datamodel.rst:2261 +#: reference/datamodel.rst:2269 msgid "" ":exc:`TypeError` will be raised if nonempty *__slots__* are defined for a " "class derived from a :c:member:`\"variable-length\" built-in type " @@ -2560,11 +2566,11 @@ msgid "" "`tuple`." msgstr "" -#: reference/datamodel.rst:2266 +#: reference/datamodel.rst:2274 msgid "Any non-string :term:`iterable` may be assigned to *__slots__*." msgstr "" -#: reference/datamodel.rst:2268 +#: reference/datamodel.rst:2276 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 " @@ -2572,13 +2578,13 @@ msgid "" "func:`inspect.getdoc` and displayed in the output of :func:`help`." msgstr "" -#: reference/datamodel.rst:2273 +#: reference/datamodel.rst:2281 msgid "" ":attr:`~instance.__class__` assignment works only if both classes have the " "same *__slots__*." msgstr "" -#: reference/datamodel.rst:2276 +#: reference/datamodel.rst:2284 msgid "" ":ref:`Multiple inheritance ` with multiple slotted parent " "classes can be used, but only one parent is allowed to have attributes " @@ -2586,18 +2592,18 @@ msgid "" "raise :exc:`TypeError`." msgstr "" -#: reference/datamodel.rst:2282 +#: reference/datamodel.rst:2290 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:2290 +#: reference/datamodel.rst:2298 msgid "Customizing class creation" msgstr "" -#: reference/datamodel.rst:2292 +#: reference/datamodel.rst:2300 msgid "" "Whenever a class inherits from another class, :meth:`~object." "__init_subclass__` is called on the parent class. This way, it is possible " @@ -2607,28 +2613,28 @@ msgid "" "future subclasses of the class defining the method." msgstr "" -#: reference/datamodel.rst:2301 +#: reference/datamodel.rst:2309 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:2305 +#: reference/datamodel.rst:2313 msgid "" -"Keyword arguments which are given to a new class are passed to the parent's " -"class ``__init_subclass__``. For compatibility with other classes using " +"Keyword arguments which are given to a new class are passed to the parent " +"class's ``__init_subclass__``. For compatibility with other classes using " "``__init_subclass__``, one should take out the needed keyword arguments and " "pass the others over to the base class, as in::" msgstr "" -#: reference/datamodel.rst:2319 +#: reference/datamodel.rst:2327 msgid "" "The default implementation ``object.__init_subclass__`` does nothing, but " "raises an error if it is called with any arguments." msgstr "" -#: reference/datamodel.rst:2324 +#: reference/datamodel.rst:2332 msgid "" "The metaclass hint ``metaclass`` is consumed by the rest of the type " "machinery, and is never passed to ``__init_subclass__`` implementations. The " @@ -2636,41 +2642,41 @@ msgid "" "``type(cls)``." msgstr "" -#: reference/datamodel.rst:2332 +#: reference/datamodel.rst:2340 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:2337 +#: reference/datamodel.rst:2345 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:2343 +#: reference/datamodel.rst:2351 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:2354 +#: reference/datamodel.rst:2362 msgid "See :ref:`class-object-creation` for more details." msgstr "" -#: reference/datamodel.rst:2362 +#: reference/datamodel.rst:2370 msgid "Metaclasses" msgstr "" -#: reference/datamodel.rst:2369 +#: reference/datamodel.rst:2377 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:2373 +#: reference/datamodel.rst:2381 msgid "" "The class creation process can be customized by passing the ``metaclass`` " "keyword argument in the class definition line, or by inheriting from an " @@ -2678,41 +2684,41 @@ msgid "" "both ``MyClass`` and ``MySubclass`` are instances of ``Meta``::" msgstr "" -#: reference/datamodel.rst:2387 +#: reference/datamodel.rst:2395 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:2390 +#: reference/datamodel.rst:2398 msgid "When a class definition is executed, the following steps occur:" msgstr "" -#: reference/datamodel.rst:2392 +#: reference/datamodel.rst:2400 msgid "MRO entries are resolved;" msgstr "" -#: reference/datamodel.rst:2393 +#: reference/datamodel.rst:2401 msgid "the appropriate metaclass is determined;" msgstr "" -#: reference/datamodel.rst:2394 +#: reference/datamodel.rst:2402 msgid "the class namespace is prepared;" msgstr "" -#: reference/datamodel.rst:2395 +#: reference/datamodel.rst:2403 msgid "the class body is executed;" msgstr "" -#: reference/datamodel.rst:2396 +#: reference/datamodel.rst:2404 msgid "the class object is created." msgstr "" -#: reference/datamodel.rst:2400 +#: reference/datamodel.rst:2408 msgid "Resolving MRO entries" msgstr "" -#: reference/datamodel.rst:2404 +#: reference/datamodel.rst:2412 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 " @@ -2724,59 +2730,59 @@ msgid "" "is ignored." msgstr "" -#: reference/datamodel.rst:2416 +#: reference/datamodel.rst:2424 msgid ":func:`types.resolve_bases`" msgstr "" -#: reference/datamodel.rst:2416 +#: reference/datamodel.rst:2424 msgid "Dynamically resolve bases that are not instances of :class:`type`." msgstr "" -#: reference/datamodel.rst:2420 +#: reference/datamodel.rst:2428 msgid ":func:`types.get_original_bases`" msgstr "" -#: reference/datamodel.rst:2419 +#: reference/datamodel.rst:2427 msgid "" "Retrieve a class's \"original bases\" prior to modifications by :meth:" "`~object.__mro_entries__`." msgstr "" -#: reference/datamodel.rst:2422 +#: reference/datamodel.rst:2430 msgid ":pep:`560`" msgstr "" -#: reference/datamodel.rst:2423 +#: reference/datamodel.rst:2431 msgid "Core support for typing module and generic types." msgstr "" -#: reference/datamodel.rst:2427 +#: reference/datamodel.rst:2435 msgid "Determining the appropriate metaclass" msgstr "" -#: reference/datamodel.rst:2431 +#: reference/datamodel.rst:2439 msgid "" "The appropriate metaclass for a class definition is determined as follows:" msgstr "" -#: reference/datamodel.rst:2433 +#: reference/datamodel.rst:2441 msgid "" "if no bases and no explicit metaclass are given, then :func:`type` is used;" msgstr "" -#: reference/datamodel.rst:2434 +#: reference/datamodel.rst:2442 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:2436 +#: reference/datamodel.rst:2444 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:2439 +#: reference/datamodel.rst:2447 msgid "" "The most derived metaclass is selected from the explicitly specified " "metaclass (if any) and the metaclasses (i.e. ``type(cls)``) of all specified " @@ -2785,11 +2791,11 @@ msgid "" "that criterion, then the class definition will fail with ``TypeError``." msgstr "" -#: reference/datamodel.rst:2449 +#: reference/datamodel.rst:2457 msgid "Preparing the class namespace" msgstr "" -#: reference/datamodel.rst:2454 +#: reference/datamodel.rst:2462 msgid "" "Once the appropriate metaclass has been identified, then the class namespace " "is prepared. If the metaclass has a ``__prepare__`` attribute, it is called " @@ -2801,25 +2807,25 @@ msgid "" "copied into a new ``dict``." msgstr "" -#: reference/datamodel.rst:2463 +#: reference/datamodel.rst:2471 msgid "" "If the metaclass has no ``__prepare__`` attribute, then the class namespace " "is initialised as an empty ordered mapping." msgstr "" -#: reference/datamodel.rst:2468 +#: reference/datamodel.rst:2476 msgid ":pep:`3115` - Metaclasses in Python 3000" msgstr "" -#: reference/datamodel.rst:2469 +#: reference/datamodel.rst:2477 msgid "Introduced the ``__prepare__`` namespace hook" msgstr "" -#: reference/datamodel.rst:2473 +#: reference/datamodel.rst:2481 msgid "Executing the class body" msgstr "" -#: reference/datamodel.rst:2478 +#: reference/datamodel.rst:2486 msgid "" "The class body is executed (approximately) as ``exec(body, globals(), " "namespace)``. The key difference from a normal call to :func:`exec` is that " @@ -2828,7 +2834,7 @@ msgid "" "inside a function." msgstr "" -#: reference/datamodel.rst:2484 +#: reference/datamodel.rst:2492 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. " @@ -2837,11 +2843,11 @@ msgid "" "reference described in the next section." msgstr "" -#: reference/datamodel.rst:2493 +#: reference/datamodel.rst:2501 msgid "Creating the class object" msgstr "" -#: reference/datamodel.rst:2500 +#: reference/datamodel.rst:2508 msgid "" "Once the class namespace has been populated by executing the class body, the " "class object is created by calling ``metaclass(name, bases, namespace, " @@ -2849,7 +2855,7 @@ msgid "" "to ``__prepare__``)." msgstr "" -#: reference/datamodel.rst:2505 +#: reference/datamodel.rst:2513 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 " @@ -2860,7 +2866,7 @@ msgid "" "is identified based on the first argument passed to the method." msgstr "" -#: reference/datamodel.rst:2515 +#: reference/datamodel.rst:2523 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 " @@ -2869,39 +2875,39 @@ msgid "" "in Python 3.8." msgstr "" -#: reference/datamodel.rst:2521 +#: reference/datamodel.rst:2529 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:2525 +#: reference/datamodel.rst:2533 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:2527 +#: reference/datamodel.rst:2535 msgid "" "Those ``__set_name__`` methods are called with the class being defined and " "the assigned name of that particular attribute;" msgstr "" -#: reference/datamodel.rst:2529 +#: reference/datamodel.rst:2537 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:2532 +#: reference/datamodel.rst:2540 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:2536 +#: reference/datamodel.rst:2544 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 " @@ -2909,19 +2915,19 @@ msgid "" "becomes the :attr:`~object.__dict__` attribute of the class object." msgstr "" -#: reference/datamodel.rst:2543 +#: reference/datamodel.rst:2551 msgid ":pep:`3135` - New super" msgstr "" -#: reference/datamodel.rst:2544 +#: reference/datamodel.rst:2552 msgid "Describes the implicit ``__class__`` closure reference" msgstr "" -#: reference/datamodel.rst:2548 +#: reference/datamodel.rst:2556 msgid "Uses for metaclasses" msgstr "" -#: reference/datamodel.rst:2550 +#: reference/datamodel.rst:2558 msgid "" "The potential uses for metaclasses are boundless. Some ideas that have been " "explored include enum, logging, interface checking, automatic delegation, " @@ -2929,17 +2935,17 @@ msgid "" "locking/synchronization." msgstr "" -#: reference/datamodel.rst:2557 +#: reference/datamodel.rst:2565 msgid "Customizing instance and subclass checks" msgstr "" -#: reference/datamodel.rst:2559 +#: reference/datamodel.rst:2567 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:2562 +#: reference/datamodel.rst:2570 msgid "" "In particular, the metaclass :class:`abc.ABCMeta` implements these methods " "in order to allow the addition of Abstract Base Classes (ABCs) as \"virtual " @@ -2947,21 +2953,21 @@ msgid "" "other ABCs." msgstr "" -#: reference/datamodel.rst:2569 +#: reference/datamodel.rst:2577 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:2576 +#: reference/datamodel.rst:2584 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:2581 +#: reference/datamodel.rst:2589 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 " @@ -2969,11 +2975,11 @@ msgid "" "only in this case the instance is itself a class." msgstr "" -#: reference/datamodel.rst:2592 +#: reference/datamodel.rst:2600 msgid ":pep:`3119` - Introducing Abstract Base Classes" msgstr "" -#: reference/datamodel.rst:2589 +#: reference/datamodel.rst:2597 msgid "" "Includes the specification for customizing :func:`isinstance` and :func:" "`issubclass` behavior through :meth:`~class.__instancecheck__` and :meth:" @@ -2982,11 +2988,11 @@ msgid "" "language." msgstr "" -#: reference/datamodel.rst:2597 +#: reference/datamodel.rst:2605 msgid "Emulating generic types" msgstr "" -#: reference/datamodel.rst:2599 +#: reference/datamodel.rst:2607 msgid "" "When using :term:`type annotations`, it is often useful to " "*parameterize* a :term:`generic type` using Python's square-brackets " @@ -2994,65 +3000,65 @@ msgid "" "a :class:`list` in which all the elements are of type :class:`int`." msgstr "" -#: reference/datamodel.rst:2607 +#: reference/datamodel.rst:2615 msgid ":pep:`484` - Type Hints" msgstr "" -#: reference/datamodel.rst:2607 +#: reference/datamodel.rst:2615 msgid "Introducing Python's framework for type annotations" msgstr "" -#: reference/datamodel.rst:2610 +#: reference/datamodel.rst:2618 msgid ":ref:`Generic Alias Types`" msgstr "" -#: reference/datamodel.rst:2610 +#: reference/datamodel.rst:2618 msgid "Documentation for objects representing parameterized generic classes" msgstr "" -#: reference/datamodel.rst:2613 +#: reference/datamodel.rst:2621 msgid "" ":ref:`Generics`, :ref:`user-defined generics` and :" "class:`typing.Generic`" msgstr "" -#: reference/datamodel.rst:2613 +#: reference/datamodel.rst:2621 msgid "" "Documentation on how to implement generic classes that can be parameterized " "at runtime and understood by static type-checkers." msgstr "" -#: reference/datamodel.rst:2616 +#: reference/datamodel.rst:2624 msgid "" "A class can *generally* only be parameterized if it defines the special " "class method ``__class_getitem__()``." msgstr "" -#: reference/datamodel.rst:2621 +#: reference/datamodel.rst:2629 msgid "" "Return an object representing the specialization of a generic class by type " "arguments found in *key*." msgstr "" -#: reference/datamodel.rst:2624 +#: reference/datamodel.rst:2632 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:2630 +#: reference/datamodel.rst:2638 msgid "The purpose of *__class_getitem__*" msgstr "" -#: reference/datamodel.rst:2632 +#: reference/datamodel.rst:2640 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:2636 +#: reference/datamodel.rst:2644 msgid "" "To implement custom generic classes that can be parameterized at runtime and " "understood by static type-checkers, users should either inherit from a " @@ -3061,7 +3067,7 @@ msgid "" "own implementation of ``__class_getitem__()``." msgstr "" -#: reference/datamodel.rst:2642 +#: reference/datamodel.rst:2650 msgid "" "Custom implementations of :meth:`~object.__class_getitem__` on classes " "defined outside of the standard library may not be understood by third-party " @@ -3069,11 +3075,11 @@ msgid "" "purposes other than type hinting is discouraged." msgstr "" -#: reference/datamodel.rst:2652 +#: reference/datamodel.rst:2660 msgid "*__class_getitem__* versus *__getitem__*" msgstr "" -#: reference/datamodel.rst:2654 +#: reference/datamodel.rst:2662 msgid "" "Usually, the :ref:`subscription` of an object using square " "brackets will call the :meth:`~object.__getitem__` instance method defined " @@ -3083,14 +3089,14 @@ msgid "" "genericalias>` object if it is properly defined." msgstr "" -#: reference/datamodel.rst:2661 +#: reference/datamodel.rst:2669 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:2689 +#: reference/datamodel.rst:2697 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 " @@ -3100,40 +3106,40 @@ msgid "" "__class_getitem__` being called::" msgstr "" -#: reference/datamodel.rst:2708 +#: reference/datamodel.rst:2716 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:2733 +#: reference/datamodel.rst:2741 msgid ":pep:`560` - Core Support for typing module and generic types" msgstr "" -#: reference/datamodel.rst:2732 +#: reference/datamodel.rst:2740 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:2740 +#: reference/datamodel.rst:2748 msgid "Emulating callable objects" msgstr "" -#: reference/datamodel.rst:2747 +#: reference/datamodel.rst:2755 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:2754 +#: reference/datamodel.rst:2762 msgid "Emulating container types" msgstr "" -#: reference/datamodel.rst:2756 +#: reference/datamodel.rst:2764 msgid "" "The following methods can be defined to implement container objects. " "Containers usually are :term:`sequences ` (such as :class:`lists " @@ -3169,7 +3175,7 @@ msgid "" "should iterate through the values." msgstr "" -#: reference/datamodel.rst:2797 +#: reference/datamodel.rst:2805 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 " @@ -3177,7 +3183,7 @@ msgid "" "returns zero is considered to be false in a Boolean context." msgstr "" -#: reference/datamodel.rst:2804 +#: reference/datamodel.rst:2812 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:" @@ -3186,7 +3192,7 @@ msgid "" "`~object.__bool__` method." msgstr "" -#: reference/datamodel.rst:2813 +#: reference/datamodel.rst:2821 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). " @@ -3196,20 +3202,20 @@ msgid "" "never required for correctness." msgstr "" -#: reference/datamodel.rst:2827 +#: reference/datamodel.rst:2835 msgid "" "Slicing is done exclusively with the following three methods. A call like ::" msgstr "" -#: reference/datamodel.rst:2831 +#: reference/datamodel.rst:2839 msgid "is translated to ::" msgstr "" -#: reference/datamodel.rst:2835 +#: reference/datamodel.rst:2843 msgid "and so forth. Missing slice items are always filled in with ``None``." msgstr "" -#: reference/datamodel.rst:2840 +#: reference/datamodel.rst:2848 msgid "" "Called to implement evaluation of ``self[key]``. For :term:`sequence` types, " "the accepted keys should be integers. Optionally, they may support :class:" @@ -3221,20 +3227,20 @@ msgid "" "`KeyError` should be raised." msgstr "" -#: reference/datamodel.rst:2852 +#: reference/datamodel.rst:2860 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:2857 +#: reference/datamodel.rst:2865 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:2865 +#: reference/datamodel.rst:2873 msgid "" "Called to implement assignment to ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -3243,7 +3249,7 @@ msgid "" "for improper *key* values as for the :meth:`__getitem__` method." msgstr "" -#: reference/datamodel.rst:2874 +#: reference/datamodel.rst:2882 msgid "" "Called to implement deletion of ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -3252,13 +3258,13 @@ msgid "" "values as for the :meth:`__getitem__` method." msgstr "" -#: reference/datamodel.rst:2883 +#: reference/datamodel.rst:2891 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:2889 +#: reference/datamodel.rst:2897 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 " @@ -3266,14 +3272,14 @@ msgid "" "of the container." msgstr "" -#: reference/datamodel.rst:2897 +#: reference/datamodel.rst:2905 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:2901 +#: reference/datamodel.rst:2909 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 :" @@ -3282,7 +3288,7 @@ msgid "" "more efficient than the one provided by :func:`reversed`." msgstr "" -#: reference/datamodel.rst:2908 +#: reference/datamodel.rst:2916 msgid "" "The membership test operators (:keyword:`in` and :keyword:`not in`) are " "normally implemented as an iteration through a container. However, container " @@ -3290,14 +3296,14 @@ msgid "" "implementation, which also does not require the object be iterable." msgstr "" -#: reference/datamodel.rst:2915 +#: reference/datamodel.rst:2923 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:2919 +#: reference/datamodel.rst:2927 msgid "" "For objects that don't define :meth:`__contains__`, the membership test " "first tries iteration via :meth:`__iter__`, then the old sequence iteration " @@ -3305,11 +3311,11 @@ msgid "" "reference `." msgstr "" -#: reference/datamodel.rst:2928 +#: reference/datamodel.rst:2936 msgid "Emulating numeric types" msgstr "" -#: reference/datamodel.rst:2930 +#: reference/datamodel.rst:2938 msgid "" "The following methods can be defined to emulate numeric objects. Methods " "corresponding to operations that are not supported by the particular kind of " @@ -3317,7 +3323,7 @@ msgid "" "should be left undefined." msgstr "" -#: reference/datamodel.rst:2956 +#: reference/datamodel.rst:2964 msgid "" "These methods are called to implement the binary arithmetic operations " "(``+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:" @@ -3331,13 +3337,13 @@ msgid "" "function is to be supported." msgstr "" -#: reference/datamodel.rst:2967 +#: reference/datamodel.rst:2975 msgid "" "If one of those methods does not support the operation with the supplied " "arguments, it should return ``NotImplemented``." msgstr "" -#: reference/datamodel.rst:2990 +#: reference/datamodel.rst:2998 msgid "" "These methods are called to implement the binary arithmetic operations " "(``+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:" @@ -3350,13 +3356,13 @@ msgid "" "*NotImplemented*." msgstr "" -#: reference/datamodel.rst:3002 +#: reference/datamodel.rst:3010 msgid "" "Note that ternary :func:`pow` will not try calling :meth:`__rpow__` (the " "coercion rules would become too complicated)." msgstr "" -#: reference/datamodel.rst:3007 +#: reference/datamodel.rst:3015 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 " @@ -3365,7 +3371,7 @@ msgid "" "ancestors' operations." msgstr "" -#: reference/datamodel.rst:3028 +#: reference/datamodel.rst:3036 msgid "" "These methods are called to implement the augmented arithmetic assignments " "(``+=``, ``-=``, ``*=``, ``@=``, ``/=``, ``//=``, ``%=``, ``**=``, ``<<=``, " @@ -3381,19 +3387,19 @@ msgid "" "fact part of the data model." msgstr "" -#: reference/datamodel.rst:3049 +#: reference/datamodel.rst:3057 msgid "" "Called to implement the unary arithmetic operations (``-``, ``+``, :func:" "`abs` and ``~``)." msgstr "" -#: reference/datamodel.rst:3062 +#: 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:3069 +#: 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 " @@ -3402,14 +3408,14 @@ msgid "" "integer type. Must return an integer." msgstr "" -#: reference/datamodel.rst:3075 +#: 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:3087 +#: 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`. " @@ -3418,21 +3424,21 @@ msgid "" "(typically an :class:`int`)." msgstr "" -#: reference/datamodel.rst:3093 +#: 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:3096 +#: reference/datamodel.rst:3104 msgid "The delegation of :func:`int` to :meth:`__trunc__` is deprecated." msgstr "" -#: reference/datamodel.rst:3103 +#: reference/datamodel.rst:3111 msgid "With Statement Context Managers" msgstr "" -#: reference/datamodel.rst:3105 +#: 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 " @@ -3442,32 +3448,32 @@ msgid "" "can also be used by directly invoking their methods." msgstr "" -#: reference/datamodel.rst:3116 +#: 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:3119 +#: reference/datamodel.rst:3127 msgid "" "For more information on context managers, see :ref:`typecontextmanager`." msgstr "" -#: reference/datamodel.rst:3124 +#: 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:3131 +#: 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:3135 +#: 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. " @@ -3475,27 +3481,27 @@ msgid "" "method." msgstr "" -#: reference/datamodel.rst:3139 +#: 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:3146 +#: reference/datamodel.rst:3154 msgid ":pep:`343` - The \"with\" statement" msgstr "" -#: reference/datamodel.rst:3146 +#: reference/datamodel.rst:3154 msgid "" "The specification, background, and examples for the Python :keyword:`with` " "statement." msgstr "" -#: reference/datamodel.rst:3153 +#: reference/datamodel.rst:3161 msgid "Customizing positional arguments in class pattern matching" msgstr "" -#: reference/datamodel.rst:3155 +#: 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 " @@ -3503,7 +3509,7 @@ msgid "" "pattern, the class needs to define a *__match_args__* attribute." msgstr "" -#: reference/datamodel.rst:3162 +#: 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 " @@ -3512,7 +3518,7 @@ msgid "" "to setting it to ``()``." msgstr "" -#: reference/datamodel.rst:3168 +#: 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 " @@ -3522,19 +3528,19 @@ msgid "" "exc:`TypeError`." msgstr "" -#: reference/datamodel.rst:3178 +#: reference/datamodel.rst:3186 msgid ":pep:`634` - Structural Pattern Matching" msgstr "" -#: reference/datamodel.rst:3179 +#: reference/datamodel.rst:3187 msgid "The specification for the Python ``match`` statement." msgstr "" -#: reference/datamodel.rst:3185 +#: reference/datamodel.rst:3193 msgid "Emulating buffer types" msgstr "" -#: reference/datamodel.rst:3187 +#: 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 " @@ -3542,13 +3548,13 @@ msgid "" "and third-party libraries may define additional buffer types." msgstr "" -#: reference/datamodel.rst:3192 +#: 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:3197 +#: 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 " @@ -3558,7 +3564,7 @@ msgid "" "`memoryview` object." msgstr "" -#: reference/datamodel.rst:3206 +#: 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." @@ -3567,28 +3573,28 @@ msgid "" "to perform any cleanup are not required to implement this method." msgstr "" -#: reference/datamodel.rst:3218 +#: reference/datamodel.rst:3226 msgid ":pep:`688` - Making the buffer protocol accessible in Python" msgstr "" -#: reference/datamodel.rst:3218 +#: reference/datamodel.rst:3226 msgid "" "Introduces the Python ``__buffer__`` and ``__release_buffer__`` methods." msgstr "" -#: reference/datamodel.rst:3220 +#: reference/datamodel.rst:3228 msgid ":class:`collections.abc.Buffer`" msgstr "" -#: reference/datamodel.rst:3221 +#: reference/datamodel.rst:3229 msgid "ABC for buffer types." msgstr "" -#: reference/datamodel.rst:3226 +#: reference/datamodel.rst:3234 msgid "Special method lookup" msgstr "" -#: reference/datamodel.rst:3228 +#: 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 " @@ -3596,7 +3602,7 @@ msgid "" "following code raises an exception::" msgstr "" -#: reference/datamodel.rst:3243 +#: 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 " @@ -3605,21 +3611,21 @@ msgid "" "invoked on the type object itself::" msgstr "" -#: reference/datamodel.rst:3257 +#: 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:3266 +#: 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:3292 +#: reference/datamodel.rst:3300 msgid "" "Bypassing the :meth:`~object.__getattribute__` machinery in this fashion " "provides significant scope for speed optimisations within the interpreter, " @@ -3628,36 +3634,36 @@ msgid "" "consistently invoked by the interpreter)." msgstr "" -#: reference/datamodel.rst:3303 +#: reference/datamodel.rst:3311 msgid "Coroutines" msgstr "" -#: reference/datamodel.rst:3307 +#: reference/datamodel.rst:3315 msgid "Awaitable Objects" msgstr "" -#: reference/datamodel.rst:3309 +#: 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:3315 +#: 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:3321 +#: 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:3327 +#: 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 " @@ -3665,15 +3671,15 @@ msgid "" "g. :mod:`asyncio`) that will be managing the :term:`awaitable` object." msgstr "" -#: reference/datamodel.rst:3335 +#: reference/datamodel.rst:3343 msgid ":pep:`492` for additional information about awaitable objects." msgstr "" -#: reference/datamodel.rst:3341 +#: reference/datamodel.rst:3349 msgid "Coroutine Objects" msgstr "" -#: reference/datamodel.rst:3343 +#: reference/datamodel.rst:3351 msgid "" ":term:`Coroutine objects ` are :term:`awaitable` objects. A " "coroutine's execution can be controlled by calling :meth:`~object.__await__` " @@ -3684,18 +3690,18 @@ msgid "" "should not directly raise unhandled :exc:`StopIteration` exceptions." msgstr "" -#: reference/datamodel.rst:3351 +#: 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:3355 +#: reference/datamodel.rst:3363 msgid "It is a :exc:`RuntimeError` to await on a coroutine more than once." msgstr "" -#: reference/datamodel.rst:3361 +#: 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." @@ -3706,7 +3712,7 @@ msgid "" "value, described above." msgstr "" -#: reference/datamodel.rst:3372 +#: 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 " @@ -3717,13 +3723,13 @@ msgid "" "not caught in the coroutine, it propagates back to the caller." msgstr "" -#: reference/datamodel.rst:3383 +#: 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:3388 +#: 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` " @@ -3733,99 +3739,99 @@ msgid "" "is marked as having finished executing, even if it was never started." msgstr "" -#: reference/datamodel.rst:3396 +#: 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:3402 +#: reference/datamodel.rst:3410 msgid "Asynchronous Iterators" msgstr "" -#: reference/datamodel.rst:3404 +#: reference/datamodel.rst:3412 msgid "" "An *asynchronous iterator* can call asynchronous code in its ``__anext__`` " "method." msgstr "" -#: reference/datamodel.rst:3407 +#: reference/datamodel.rst:3415 msgid "" "Asynchronous iterators can be used in an :keyword:`async for` statement." msgstr "" -#: reference/datamodel.rst:3411 +#: reference/datamodel.rst:3419 msgid "Must return an *asynchronous iterator* object." msgstr "" -#: reference/datamodel.rst:3415 +#: 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:3418 +#: reference/datamodel.rst:3426 msgid "An example of an asynchronous iterable object::" msgstr "" -#: reference/datamodel.rst:3435 +#: 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:3440 +#: 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:3448 +#: reference/datamodel.rst:3456 msgid "Asynchronous Context Managers" msgstr "" -#: reference/datamodel.rst:3450 +#: 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:3453 +#: reference/datamodel.rst:3461 msgid "" "Asynchronous context managers can be used in an :keyword:`async with` " "statement." msgstr "" -#: reference/datamodel.rst:3457 +#: 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:3462 +#: 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:3465 +#: reference/datamodel.rst:3473 msgid "An example of an asynchronous context manager class::" msgstr "" -#: reference/datamodel.rst:3478 +#: reference/datamodel.rst:3486 msgid "Footnotes" msgstr "" -#: reference/datamodel.rst:3479 +#: 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:3483 +#: reference/datamodel.rst:3491 msgid "" "The :meth:`~object.__hash__`, :meth:`~object.__iter__`, :meth:`~object." "__reversed__`, and :meth:`~object.__contains__` methods have special " @@ -3833,7 +3839,7 @@ msgid "" "by relying on the behavior that ``None`` is not callable." msgstr "" -#: reference/datamodel.rst:3489 +#: reference/datamodel.rst:3497 msgid "" "\"Does not support\" here means that the class has no such method, or the " "method returns ``NotImplemented``. Do not set the method to ``None`` if you " @@ -3841,7 +3847,7 @@ msgid "" "instead have the opposite effect of explicitly *blocking* such fallback." msgstr "" -#: reference/datamodel.rst:3495 +#: 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 " @@ -3855,8 +3861,8 @@ msgstr "" #: reference/datamodel.rst:459 reference/datamodel.rst:512 #: reference/datamodel.rst:654 reference/datamodel.rst:823 #: reference/datamodel.rst:938 reference/datamodel.rst:1034 -#: reference/datamodel.rst:1198 reference/datamodel.rst:1399 -#: reference/datamodel.rst:2823 +#: reference/datamodel.rst:1200 reference/datamodel.rst:1407 +#: reference/datamodel.rst:2831 msgid "object" msgstr "" @@ -3865,10 +3871,10 @@ msgid "data" msgstr "" #: reference/datamodel.rst:292 reference/datamodel.rst:420 -#: reference/datamodel.rst:799 reference/datamodel.rst:1482 -#: reference/datamodel.rst:1727 reference/datamodel.rst:2364 -#: reference/datamodel.rst:2951 reference/datamodel.rst:3000 -#: reference/datamodel.rst:3057 reference/datamodel.rst:3085 +#: reference/datamodel.rst:799 reference/datamodel.rst:1490 +#: reference/datamodel.rst:1735 reference/datamodel.rst:2372 +#: reference/datamodel.rst:2959 reference/datamodel.rst:3008 +#: reference/datamodel.rst:3065 reference/datamodel.rst:3093 msgid "built-in function" msgstr "" @@ -3876,7 +3882,7 @@ msgstr "" msgid "id" msgstr "" -#: reference/datamodel.rst:122 reference/datamodel.rst:2364 +#: reference/datamodel.rst:122 reference/datamodel.rst:2372 msgid "type" msgstr "" @@ -3994,11 +4000,11 @@ msgstr "" msgid "Java" msgstr "" -#: reference/datamodel.rst:3057 +#: reference/datamodel.rst:3065 msgid "complex" msgstr "" -#: reference/datamodel.rst:420 reference/datamodel.rst:2793 +#: reference/datamodel.rst:420 reference/datamodel.rst:2801 msgid "len" msgstr "" @@ -4030,7 +4036,7 @@ msgstr "" msgid "immutable" msgstr "" -#: reference/datamodel.rst:1697 reference/datamodel.rst:1727 +#: reference/datamodel.rst:1705 reference/datamodel.rst:1735 msgid "string" msgstr "" @@ -4066,7 +4072,7 @@ msgstr "" msgid "empty" msgstr "" -#: reference/datamodel.rst:1722 +#: reference/datamodel.rst:1730 msgid "bytes" msgstr "" @@ -4086,8 +4092,8 @@ msgstr "" msgid "assignment" msgstr "" -#: reference/datamodel.rst:856 reference/datamodel.rst:1618 -#: reference/datamodel.rst:3112 +#: reference/datamodel.rst:856 reference/datamodel.rst:1626 +#: reference/datamodel.rst:3120 msgid "statement" msgstr "" @@ -4123,7 +4129,7 @@ msgstr "" msgid "mapping" msgstr "" -#: reference/datamodel.rst:938 reference/datamodel.rst:1808 +#: reference/datamodel.rst:938 reference/datamodel.rst:1816 msgid "dictionary" msgstr "" @@ -4144,7 +4150,7 @@ msgstr "" msgid "function" msgstr "" -#: reference/datamodel.rst:938 reference/datamodel.rst:2745 +#: reference/datamodel.rst:938 reference/datamodel.rst:2753 msgid "call" msgstr "" @@ -4244,7 +4250,7 @@ msgstr "" msgid "__module__ (method attribute)" msgstr "" -#: reference/datamodel.rst:1198 +#: reference/datamodel.rst:1200 msgid "generator" msgstr "" @@ -4252,7 +4258,7 @@ msgstr "" msgid "iterator" msgstr "" -#: reference/datamodel.rst:3299 +#: reference/datamodel.rst:3307 msgid "coroutine" msgstr "" @@ -4296,8 +4302,8 @@ msgstr "" msgid "__dict__ (module attribute)" msgstr "" -#: reference/datamodel.rst:956 reference/datamodel.rst:1601 -#: reference/datamodel.rst:2475 +#: reference/datamodel.rst:956 reference/datamodel.rst:1609 +#: reference/datamodel.rst:2483 msgid "class" msgstr "" @@ -4305,7 +4311,7 @@ msgstr "" msgid "class instance" msgstr "" -#: reference/datamodel.rst:1007 reference/datamodel.rst:2745 +#: reference/datamodel.rst:1007 reference/datamodel.rst:2753 msgid "instance" msgstr "" @@ -4481,290 +4487,290 @@ msgstr "" msgid "co_qualname (code object attribute)" msgstr "" -#: reference/datamodel.rst:1216 +#: reference/datamodel.rst:1218 msgid "documentation string" msgstr "" -#: reference/datamodel.rst:1299 +#: reference/datamodel.rst:1307 msgid "frame" msgstr "" -#: reference/datamodel.rst:1305 +#: reference/datamodel.rst:1313 msgid "f_back (frame attribute)" msgstr "" -#: reference/datamodel.rst:1305 +#: reference/datamodel.rst:1313 msgid "f_code (frame attribute)" msgstr "" -#: reference/datamodel.rst:1305 +#: reference/datamodel.rst:1313 msgid "f_globals (frame attribute)" msgstr "" -#: reference/datamodel.rst:1305 +#: reference/datamodel.rst:1313 msgid "f_locals (frame attribute)" msgstr "" -#: reference/datamodel.rst:1305 +#: reference/datamodel.rst:1313 msgid "f_lasti (frame attribute)" msgstr "" -#: reference/datamodel.rst:1305 +#: reference/datamodel.rst:1313 msgid "f_builtins (frame attribute)" msgstr "" -#: reference/datamodel.rst:1344 +#: reference/datamodel.rst:1352 msgid "f_trace (frame attribute)" msgstr "" -#: reference/datamodel.rst:1344 +#: reference/datamodel.rst:1352 msgid "f_trace_lines (frame attribute)" msgstr "" -#: reference/datamodel.rst:1344 +#: reference/datamodel.rst:1352 msgid "f_trace_opcodes (frame attribute)" msgstr "" -#: reference/datamodel.rst:1344 +#: reference/datamodel.rst:1352 msgid "f_lineno (frame attribute)" msgstr "" -#: reference/datamodel.rst:1399 +#: reference/datamodel.rst:1407 msgid "traceback" msgstr "" -#: reference/datamodel.rst:1399 +#: reference/datamodel.rst:1407 msgid "stack" msgstr "" -#: reference/datamodel.rst:1399 +#: reference/datamodel.rst:1407 msgid "trace" msgstr "" -#: reference/datamodel.rst:1399 +#: reference/datamodel.rst:1407 msgid "exception" msgstr "" -#: reference/datamodel.rst:1399 +#: reference/datamodel.rst:1407 msgid "handler" msgstr "" -#: reference/datamodel.rst:1399 +#: reference/datamodel.rst:1407 msgid "execution" msgstr "" -#: reference/datamodel.rst:1399 +#: reference/datamodel.rst:1407 msgid "exc_info (in module sys)" msgstr "" -#: reference/datamodel.rst:1399 +#: reference/datamodel.rst:1407 msgid "last_traceback (in module sys)" msgstr "" -#: reference/datamodel.rst:1399 +#: reference/datamodel.rst:1407 msgid "sys.exc_info" msgstr "" -#: reference/datamodel.rst:1399 +#: reference/datamodel.rst:1407 msgid "sys.exception" msgstr "" -#: reference/datamodel.rst:1399 +#: reference/datamodel.rst:1407 msgid "sys.last_traceback" msgstr "" -#: reference/datamodel.rst:1436 +#: reference/datamodel.rst:1444 msgid "tb_frame (traceback attribute)" msgstr "" -#: reference/datamodel.rst:1436 +#: reference/datamodel.rst:1444 msgid "tb_lineno (traceback attribute)" msgstr "" -#: reference/datamodel.rst:1436 +#: reference/datamodel.rst:1444 msgid "tb_lasti (traceback attribute)" msgstr "" -#: reference/datamodel.rst:1436 +#: reference/datamodel.rst:1444 msgid "try" msgstr "" -#: reference/datamodel.rst:1466 +#: reference/datamodel.rst:1474 msgid "tb_next (traceback attribute)" msgstr "" -#: reference/datamodel.rst:2823 +#: reference/datamodel.rst:2831 msgid "slice" msgstr "" -#: reference/datamodel.rst:1488 +#: reference/datamodel.rst:1496 msgid "start (slice object attribute)" msgstr "" -#: reference/datamodel.rst:1488 +#: reference/datamodel.rst:1496 msgid "stop (slice object attribute)" msgstr "" -#: reference/datamodel.rst:1488 +#: reference/datamodel.rst:1496 msgid "step (slice object attribute)" msgstr "" -#: reference/datamodel.rst:1536 +#: reference/datamodel.rst:1544 msgid "operator" msgstr "" -#: reference/datamodel.rst:1536 +#: reference/datamodel.rst:1544 msgid "overloading" msgstr "" -#: reference/datamodel.rst:1536 +#: reference/datamodel.rst:1544 msgid "__getitem__() (mapping object method)" msgstr "" -#: reference/datamodel.rst:1572 +#: reference/datamodel.rst:1580 msgid "subclassing" msgstr "" -#: reference/datamodel.rst:1572 +#: reference/datamodel.rst:1580 msgid "immutable types" msgstr "" -#: reference/datamodel.rst:1601 +#: reference/datamodel.rst:1609 msgid "constructor" msgstr "" -#: reference/datamodel.rst:1618 +#: reference/datamodel.rst:1626 msgid "destructor" msgstr "" -#: reference/datamodel.rst:1618 +#: reference/datamodel.rst:1626 msgid "finalizer" msgstr "" -#: reference/datamodel.rst:1618 +#: reference/datamodel.rst:1626 msgid "del" msgstr "" -#: reference/datamodel.rst:1680 +#: reference/datamodel.rst:1688 msgid "repr() (built-in function)" msgstr "" -#: reference/datamodel.rst:1680 +#: reference/datamodel.rst:1688 msgid "__repr__() (object method)" msgstr "" -#: reference/datamodel.rst:1697 +#: reference/datamodel.rst:1705 msgid "__str__() (object method)" msgstr "" -#: reference/datamodel.rst:1697 +#: reference/datamodel.rst:1705 msgid "format() (built-in function)" msgstr "" -#: reference/datamodel.rst:1697 +#: reference/datamodel.rst:1705 msgid "print() (built-in function)" msgstr "" -#: reference/datamodel.rst:1727 +#: reference/datamodel.rst:1735 msgid "__format__() (object method)" msgstr "" -#: reference/datamodel.rst:1727 +#: reference/datamodel.rst:1735 msgid "conversion" msgstr "" -#: reference/datamodel.rst:1727 +#: reference/datamodel.rst:1735 msgid "print" msgstr "" -#: reference/datamodel.rst:1766 +#: reference/datamodel.rst:1774 msgid "comparisons" msgstr "" -#: reference/datamodel.rst:1808 +#: reference/datamodel.rst:1816 msgid "hash" msgstr "" -#: reference/datamodel.rst:1889 +#: reference/datamodel.rst:1897 msgid "__len__() (mapping object method)" msgstr "" -#: reference/datamodel.rst:1993 +#: reference/datamodel.rst:2001 msgid "__getattr__ (module attribute)" msgstr "" -#: reference/datamodel.rst:1993 +#: reference/datamodel.rst:2001 msgid "__dir__ (module attribute)" msgstr "" -#: reference/datamodel.rst:1993 +#: reference/datamodel.rst:2001 msgid "__class__ (module attribute)" msgstr "" -#: reference/datamodel.rst:2364 +#: reference/datamodel.rst:2372 msgid "metaclass" msgstr "" -#: reference/datamodel.rst:2364 +#: reference/datamodel.rst:2372 msgid "= (equals)" msgstr "" -#: reference/datamodel.rst:2364 +#: reference/datamodel.rst:2372 msgid "class definition" msgstr "" -#: reference/datamodel.rst:2428 +#: reference/datamodel.rst:2436 msgid "metaclass hint" msgstr "" -#: reference/datamodel.rst:2451 +#: reference/datamodel.rst:2459 msgid "__prepare__ (metaclass method)" msgstr "" -#: reference/datamodel.rst:2475 +#: reference/datamodel.rst:2483 msgid "body" msgstr "" -#: reference/datamodel.rst:2495 +#: reference/datamodel.rst:2503 msgid "__class__ (method cell)" msgstr "" -#: reference/datamodel.rst:2495 +#: reference/datamodel.rst:2503 msgid "__classcell__ (class namespace entry)" msgstr "" -#: reference/datamodel.rst:2793 +#: reference/datamodel.rst:2801 msgid "__bool__() (object method)" msgstr "" -#: reference/datamodel.rst:2986 +#: reference/datamodel.rst:2994 msgid "divmod" msgstr "" -#: reference/datamodel.rst:2986 reference/datamodel.rst:3000 +#: reference/datamodel.rst:2994 reference/datamodel.rst:3008 msgid "pow" msgstr "" -#: reference/datamodel.rst:3047 +#: reference/datamodel.rst:3055 msgid "abs" msgstr "" -#: reference/datamodel.rst:3057 +#: reference/datamodel.rst:3065 msgid "int" msgstr "" -#: reference/datamodel.rst:3057 +#: reference/datamodel.rst:3065 msgid "float" msgstr "" -#: reference/datamodel.rst:3085 +#: reference/datamodel.rst:3093 msgid "round" msgstr "" -#: reference/datamodel.rst:3112 +#: reference/datamodel.rst:3120 msgid "with" msgstr "" -#: reference/datamodel.rst:3112 +#: reference/datamodel.rst:3120 msgid "context manager" msgstr "" diff --git a/reference/expressions.po b/reference/expressions.po index 53bf9fcbb..046bab2d6 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: 2023-12-01 14:57+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -432,7 +432,7 @@ msgstr "" msgid "Yield expressions" msgstr "" -#: reference/expressions.rst:427 +#: reference/expressions.rst:428 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 +442,27 @@ msgid "" "asynchronous generator function. For example::" msgstr "" -#: reference/expressions.rst:440 +#: reference/expressions.rst:441 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:444 +#: reference/expressions.rst:445 msgid "" "Yield expressions prohibited in the implicitly nested scopes used to " "implement comprehensions and generator expressions." msgstr "" -#: reference/expressions.rst:448 +#: reference/expressions.rst:449 msgid "" "Generator functions are described below, while asynchronous generator " "functions are described separately in section :ref:`asynchronous-generator-" "functions`." msgstr "" -#: reference/expressions.rst:452 +#: reference/expressions.rst:453 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 +483,7 @@ msgid "" "be the value passed in to that method." msgstr "" -#: reference/expressions.rst:472 +#: reference/expressions.rst:473 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 +492,7 @@ msgid "" "the control is always transferred to the generator's caller." msgstr "" -#: reference/expressions.rst:478 +#: reference/expressions.rst:479 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 +501,7 @@ msgid "" "`finally` clauses to execute." msgstr "" -#: reference/expressions.rst:487 +#: reference/expressions.rst:488 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 +513,7 @@ msgid "" "will just raise the passed in exception immediately." msgstr "" -#: reference/expressions.rst:496 +#: reference/expressions.rst:497 msgid "" "When the underlying iterator is complete, the :attr:`~StopIteration.value` " "attribute of the raised :exc:`StopIteration` instance becomes the value of " @@ -522,73 +522,73 @@ msgid "" "returning a value from the subgenerator)." msgstr "" -#: reference/expressions.rst:502 +#: reference/expressions.rst:503 msgid "Added ``yield from `` to delegate control flow to a subiterator." msgstr "" -#: reference/expressions.rst:505 +#: reference/expressions.rst:506 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:512 msgid ":pep:`255` - Simple Generators" msgstr "" -#: reference/expressions.rst:511 +#: reference/expressions.rst:512 msgid "" "The proposal for adding generators and the :keyword:`yield` statement to " "Python." msgstr "" -#: reference/expressions.rst:515 +#: reference/expressions.rst:516 msgid ":pep:`342` - Coroutines via Enhanced Generators" msgstr "" -#: reference/expressions.rst:514 +#: reference/expressions.rst:515 msgid "" "The proposal to enhance the API and syntax of generators, making them usable " "as simple coroutines." msgstr "" -#: reference/expressions.rst:519 +#: reference/expressions.rst:520 msgid ":pep:`380` - Syntax for Delegating to a Subgenerator" msgstr "" -#: reference/expressions.rst:518 +#: reference/expressions.rst:519 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:523 msgid ":pep:`525` - Asynchronous Generators" msgstr "" -#: reference/expressions.rst:522 +#: reference/expressions.rst:523 msgid "" "The proposal that expanded on :pep:`492` by adding generator capabilities to " "coroutine functions." msgstr "" -#: reference/expressions.rst:529 +#: reference/expressions.rst:530 msgid "Generator-iterator methods" msgstr "" -#: reference/expressions.rst:531 +#: reference/expressions.rst:532 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:534 +#: reference/expressions.rst:535 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:542 +#: reference/expressions.rst:543 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 +600,13 @@ msgid "" "`StopIteration` exception is raised." msgstr "" -#: reference/expressions.rst:551 +#: reference/expressions.rst:552 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:557 +#: reference/expressions.rst:558 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 +617,7 @@ msgid "" "expression that could receive the value." msgstr "" -#: reference/expressions.rst:569 +#: reference/expressions.rst:570 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 +626,13 @@ msgid "" "a different exception, then that exception propagates to the caller." msgstr "" -#: reference/expressions.rst:575 +#: reference/expressions.rst:576 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:578 +#: reference/expressions.rst:579 msgid "" "For backwards compatibility, however, the second signature is supported, " "following a convention from older versions of Python. The *type* argument " @@ -643,13 +643,13 @@ msgid "" "*value* may be cleared." msgstr "" -#: reference/expressions.rst:763 +#: reference/expressions.rst:764 msgid "" "The second signature \\(type\\[, value\\[, traceback\\]\\]\\) is deprecated " "and may be removed in a future version of Python." msgstr "" -#: reference/expressions.rst:597 +#: reference/expressions.rst:598 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 +660,34 @@ msgid "" "has already exited due to an exception or normal exit." msgstr "" -#: reference/expressions.rst:608 +#: reference/expressions.rst:609 msgid "Examples" msgstr "" -#: reference/expressions.rst:610 +#: reference/expressions.rst:611 msgid "" "Here is a simple example that demonstrates the behavior of generators and " "generator functions::" msgstr "" -#: reference/expressions.rst:637 +#: reference/expressions.rst:638 msgid "" "For examples using ``yield from``, see :ref:`pep-380` in \"What's New in " "Python.\"" msgstr "" -#: reference/expressions.rst:643 +#: reference/expressions.rst:644 msgid "Asynchronous generator functions" msgstr "" -#: reference/expressions.rst:645 +#: reference/expressions.rst:646 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:649 +#: reference/expressions.rst:650 msgid "" "When an asynchronous generator function is called, it returns an " "asynchronous iterator known as an asynchronous generator object. That object " @@ -697,7 +697,7 @@ msgid "" "keyword:`for` statement." msgstr "" -#: reference/expressions.rst:656 +#: reference/expressions.rst:657 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 +716,7 @@ msgid "" "method." msgstr "" -#: reference/expressions.rst:671 +#: reference/expressions.rst:672 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 +728,7 @@ msgid "" "generator and ultimately detach it from the event loop." msgstr "" -#: reference/expressions.rst:681 +#: reference/expressions.rst:682 msgid "" "In an asynchronous generator function, yield expressions are allowed " "anywhere in a :keyword:`try` construct. However, if an asynchronous " @@ -742,7 +742,7 @@ msgid "" "finally` clauses to execute." msgstr "" -#: reference/expressions.rst:692 +#: reference/expressions.rst:693 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 +755,23 @@ msgid "" "asyncio/base_events.py`." msgstr "" -#: reference/expressions.rst:701 +#: reference/expressions.rst:702 msgid "" "The expression ``yield from `` is a syntax error when used in an " "asynchronous generator function." msgstr "" -#: reference/expressions.rst:708 +#: reference/expressions.rst:709 msgid "Asynchronous generator-iterator methods" msgstr "" -#: reference/expressions.rst:710 +#: reference/expressions.rst:711 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:718 +#: reference/expressions.rst:719 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 +786,12 @@ msgid "" "has completed." msgstr "" -#: reference/expressions.rst:730 +#: reference/expressions.rst:731 msgid "" "This method is normally called implicitly by a :keyword:`async for` loop." msgstr "" -#: reference/expressions.rst:735 +#: reference/expressions.rst:736 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 +806,7 @@ msgid "" "receive the value." msgstr "" -#: reference/expressions.rst:751 +#: reference/expressions.rst:752 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 +818,7 @@ msgid "" "that exception propagates to the caller of the awaitable." msgstr "" -#: reference/expressions.rst:771 +#: reference/expressions.rst:772 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 +834,25 @@ msgid "" "will return an awaitable that does nothing." msgstr "" -#: reference/expressions.rst:787 +#: reference/expressions.rst:788 msgid "Primaries" msgstr "" -#: reference/expressions.rst:791 +#: reference/expressions.rst:792 msgid "" "Primaries represent the most tightly bound operations of the language. Their " "syntax is:" msgstr "" -#: reference/expressions.rst:801 +#: reference/expressions.rst:802 msgid "Attribute references" msgstr "" -#: reference/expressions.rst:807 +#: reference/expressions.rst:808 msgid "An attribute reference is a primary followed by a period and a name:" msgstr "" -#: reference/expressions.rst:817 +#: reference/expressions.rst:818 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 +861,7 @@ msgid "" "reference may yield different objects." msgstr "" -#: reference/expressions.rst:823 +#: reference/expressions.rst:824 msgid "" "This production can be customized by overriding the :meth:`~object." "__getattribute__` method or the :meth:`~object.__getattr__` method. The :" @@ -869,17 +869,17 @@ msgid "" "or raises :exc:`AttributeError` if the attribute is not available." msgstr "" -#: reference/expressions.rst:829 +#: reference/expressions.rst:830 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:835 +#: reference/expressions.rst:836 msgid "Subscriptions" msgstr "" -#: reference/expressions.rst:850 +#: reference/expressions.rst:851 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 +887,13 @@ msgid "" "`GenericAlias ` object." msgstr "" -#: reference/expressions.rst:858 +#: reference/expressions.rst:859 msgid "" "When an object is subscripted, the interpreter will evaluate the primary and " "the expression list." msgstr "" -#: reference/expressions.rst:861 +#: reference/expressions.rst:862 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 +903,20 @@ msgid "" "called instead of ``__getitem__``, see :ref:`classgetitem-versus-getitem`." msgstr "" -#: reference/expressions.rst:868 +#: reference/expressions.rst:869 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:872 +#: reference/expressions.rst:873 msgid "" "For built-in objects, there are two types of objects that support " "subscription via :meth:`~object.__getitem__`:" msgstr "" -#: reference/expressions.rst:875 +#: reference/expressions.rst:876 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 +924,7 @@ msgid "" "An example of a builtin mapping class is the :class:`dict` class." msgstr "" -#: reference/expressions.rst:879 +#: reference/expressions.rst:880 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 +932,7 @@ msgid "" "`str`, :class:`list` and :class:`tuple` classes." msgstr "" -#: reference/expressions.rst:884 +#: reference/expressions.rst:885 msgid "" "The formal syntax makes no special provision for negative indices in :term:" "`sequences `. However, built-in sequences all provide a :meth:" @@ -946,25 +946,25 @@ msgid "" "explicitly add that support." msgstr "" -#: reference/expressions.rst:898 +#: reference/expressions.rst:899 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:906 +#: reference/expressions.rst:907 msgid "Slicings" msgstr "" -#: reference/expressions.rst:920 +#: reference/expressions.rst:921 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:933 +#: reference/expressions.rst:934 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 +974,7 @@ msgid "" "the case if the slice list contains no proper slice)." msgstr "" -#: reference/expressions.rst:945 +#: reference/expressions.rst:946 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,33 +989,33 @@ msgid "" "missing expressions." msgstr "" -#: reference/expressions.rst:969 +#: reference/expressions.rst:970 msgid "Calls" msgstr "" -#: reference/expressions.rst:971 +#: reference/expressions.rst:972 msgid "" "A call calls a callable object (e.g., a :term:`function`) with a possibly " "empty series of :term:`arguments `:" msgstr "" -#: reference/expressions.rst:988 +#: reference/expressions.rst:989 msgid "" "An optional trailing comma may be present after the positional and keyword " "arguments but does not affect the semantics." msgstr "" -#: reference/expressions.rst:994 +#: reference/expressions.rst:995 msgid "" "The primary must evaluate to a callable object (user-defined functions, " "built-in functions, methods of built-in objects, class objects, methods of " -"class instances, and all objects having a :meth:`__call__` method are " -"callable). All argument expressions are evaluated before the call is " +"class instances, and all objects having a :meth:`~object.__call__` method " +"are callable). All argument expressions are evaluated before the call is " "attempted. Please refer to section :ref:`function` for the syntax of " "formal :term:`parameter` lists." msgstr "" -#: reference/expressions.rst:1002 +#: reference/expressions.rst:1003 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 +1036,7 @@ msgid "" "filled slots is used as the argument list for the call." msgstr "" -#: reference/expressions.rst:1022 +#: reference/expressions.rst:1023 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 +1045,7 @@ msgid "" "`PyArg_ParseTuple` to parse their arguments." msgstr "" -#: reference/expressions.rst:1028 +#: reference/expressions.rst:1029 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 +1054,7 @@ msgid "" "empty tuple if there were no excess positional arguments)." msgstr "" -#: reference/expressions.rst:1034 +#: reference/expressions.rst:1035 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 +1064,7 @@ msgid "" "(new) empty dictionary if there were no excess keyword arguments." msgstr "" -#: reference/expressions.rst:1045 +#: reference/expressions.rst:1046 msgid "" "If the syntax ``*expression`` appears in the function call, ``expression`` " "must evaluate to an :term:`iterable`. Elements from these iterables are " @@ -1074,20 +1074,20 @@ msgid "" "*y1*, ..., *yM*, *x3*, *x4*." msgstr "" -#: reference/expressions.rst:1052 +#: reference/expressions.rst:1053 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:1068 +#: reference/expressions.rst:1069 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:1074 +#: reference/expressions.rst:1075 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 +1096,7 @@ msgid "" "a :exc:`TypeError` exception is raised." msgstr "" -#: reference/expressions.rst:1080 +#: reference/expressions.rst:1081 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 +1108,35 @@ msgid "" "is raised." msgstr "" -#: reference/expressions.rst:1090 +#: reference/expressions.rst:1091 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:1093 +#: reference/expressions.rst:1094 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:1099 +#: reference/expressions.rst:1100 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:1103 +#: reference/expressions.rst:1104 msgid "If it is---" msgstr "" -#: reference/expressions.rst:1116 +#: reference/expressions.rst:1117 msgid "a user-defined function:" msgstr "" -#: reference/expressions.rst:1112 +#: reference/expressions.rst:1113 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 +1145,73 @@ msgid "" "value of the function call." msgstr "" -#: reference/expressions.rst:1130 +#: reference/expressions.rst:1131 msgid "a built-in function or method:" msgstr "" -#: reference/expressions.rst:1129 +#: reference/expressions.rst:1130 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:1137 +#: reference/expressions.rst:1138 msgid "a class object:" msgstr "" -#: reference/expressions.rst:1137 +#: reference/expressions.rst:1138 msgid "A new instance of that class is returned." msgstr "" -#: reference/expressions.rst:1147 +#: reference/expressions.rst:1148 msgid "a class instance method:" msgstr "" -#: reference/expressions.rst:1145 +#: reference/expressions.rst:1146 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:1156 +#: reference/expressions.rst:1157 msgid "a class instance:" msgstr "" -#: reference/expressions.rst:1154 +#: reference/expressions.rst:1155 msgid "" -"The class must define a :meth:`__call__` method; the effect is then the same " -"as if that method was called." +"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:1944 +#: reference/expressions.rst:1946 msgid "Await expression" msgstr "" -#: reference/expressions.rst:1164 +#: reference/expressions.rst:1165 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:1176 +#: reference/expressions.rst:1177 msgid "The power operator" msgstr "" -#: reference/expressions.rst:1182 +#: reference/expressions.rst:1183 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:1188 +#: reference/expressions.rst:1189 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:1192 +#: reference/expressions.rst:1193 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 +1219,7 @@ msgid "" "converted to a common type, and the result is of that type." msgstr "" -#: reference/expressions.rst:1197 +#: reference/expressions.rst:1198 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,58 +1227,59 @@ msgid "" "``100``, but ``10**-2`` returns ``0.01``." msgstr "" -#: reference/expressions.rst:1202 +#: reference/expressions.rst:1203 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:1206 +#: reference/expressions.rst:1207 msgid "" -"This operation can be customized using the special :meth:`__pow__` method." +"This operation can be customized using the special :meth:`~object.__pow__` " +"method." msgstr "" -#: reference/expressions.rst:1211 +#: reference/expressions.rst:1212 msgid "Unary arithmetic and bitwise operations" msgstr "" -#: reference/expressions.rst:1217 +#: reference/expressions.rst:1218 msgid "All unary arithmetic and bitwise operations have the same priority:" msgstr "" -#: reference/expressions.rst:1228 +#: reference/expressions.rst:1229 msgid "" "The unary ``-`` (minus) operator yields the negation of its numeric " -"argument; the operation can be overridden with the :meth:`__neg__` special " -"method." +"argument; the operation can be overridden with the :meth:`~object.__neg__` " +"special method." msgstr "" -#: reference/expressions.rst:1236 +#: reference/expressions.rst:1237 msgid "" "The unary ``+`` (plus) operator yields its numeric argument unchanged; the " -"operation can be overridden with the :meth:`__pos__` special method." +"operation can be overridden with the :meth:`~object.__pos__` special method." msgstr "" -#: reference/expressions.rst:1243 +#: reference/expressions.rst:1244 msgid "" "The unary ``~`` (invert) operator yields the bitwise inversion of its " "integer argument. The bitwise inversion of ``x`` is defined as ``-(x+1)``. " "It only applies to integral numbers or to custom objects that override the :" -"meth:`__invert__` special method." +"meth:`~object.__invert__` special method." msgstr "" -#: reference/expressions.rst:1252 +#: reference/expressions.rst:1253 msgid "" "In all three cases, if the argument does not have the proper type, a :exc:" "`TypeError` exception is raised." msgstr "" -#: reference/expressions.rst:1259 +#: reference/expressions.rst:1260 msgid "Binary arithmetic operations" msgstr "" -#: reference/expressions.rst:1263 +#: reference/expressions.rst:1264 msgid "" "The binary arithmetic operations have the conventional priority levels. " "Note that some of these operations also apply to certain non-numeric types. " @@ -1286,7 +1287,7 @@ msgid "" "multiplicative operators and one for additive operators:" msgstr "" -#: reference/expressions.rst:1278 +#: reference/expressions.rst:1279 msgid "" "The ``*`` (multiplication) operator yields the product of its arguments. " "The arguments must either both be numbers, or one argument must be an " @@ -1296,19 +1297,19 @@ msgid "" "an empty sequence." msgstr "" -#: reference/expressions.rst:1284 +#: reference/expressions.rst:1285 msgid "" -"This operation can be customized using the special :meth:`__mul__` and :meth:" -"`__rmul__` methods." +"This operation can be customized using the special :meth:`~object.__mul__` " +"and :meth:`~object.__rmul__` methods." msgstr "" -#: reference/expressions.rst:1291 +#: reference/expressions.rst:1292 msgid "" "The ``@`` (at) operator is intended to be used for matrix multiplication. " "No builtin Python types implement this operator." msgstr "" -#: reference/expressions.rst:1302 +#: reference/expressions.rst:1303 msgid "" "The ``/`` (division) and ``//`` (floor division) operators yield the " "quotient of their arguments. The numeric arguments are first converted to a " @@ -1318,13 +1319,13 @@ msgid "" "the :exc:`ZeroDivisionError` exception." msgstr "" -#: reference/expressions.rst:1309 +#: reference/expressions.rst:1310 msgid "" -"This operation can be customized using the special :meth:`__truediv__` and :" -"meth:`__floordiv__` methods." +"This operation can be customized using the special :meth:`~object." +"__truediv__` and :meth:`~object.__floordiv__` methods." msgstr "" -#: reference/expressions.rst:1316 +#: reference/expressions.rst:1317 msgid "" "The ``%`` (modulo) operator yields the remainder from the division of the " "first argument by the second. The numeric arguments are first converted to " @@ -1336,7 +1337,7 @@ msgid "" "absolute value of the second operand [#]_." msgstr "" -#: reference/expressions.rst:1325 +#: reference/expressions.rst:1326 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 " @@ -1344,7 +1345,7 @@ msgid "" "y, x%y)``. [#]_." msgstr "" -#: reference/expressions.rst:1330 +#: reference/expressions.rst:1331 msgid "" "In addition to performing the modulo operation on numbers, the ``%`` " "operator is also overloaded by string objects to perform old-style string " @@ -1353,20 +1354,20 @@ msgid "" "formatting`." msgstr "" -#: reference/expressions.rst:1335 +#: reference/expressions.rst:1336 msgid "" -"The *modulo* operation can be customized using the special :meth:`__mod__` " -"method." +"The *modulo* operation can be customized using the special :meth:`~object." +"__mod__` method." msgstr "" -#: reference/expressions.rst:1337 +#: reference/expressions.rst:1338 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." msgstr "" -#: reference/expressions.rst:1346 +#: reference/expressions.rst:1347 msgid "" "The ``+`` (addition) operator yields the sum of its arguments. The " "arguments must either both be numbers or both be sequences of the same " @@ -1374,84 +1375,85 @@ msgid "" "then added together. In the latter case, the sequences are concatenated." msgstr "" -#: reference/expressions.rst:1351 +#: reference/expressions.rst:1352 msgid "" -"This operation can be customized using the special :meth:`__add__` and :meth:" -"`__radd__` methods." +"This operation can be customized using the special :meth:`~object.__add__` " +"and :meth:`~object.__radd__` methods." msgstr "" -#: reference/expressions.rst:1359 +#: reference/expressions.rst:1360 msgid "" "The ``-`` (subtraction) operator yields the difference of its arguments. " "The numeric arguments are first converted to a common type." msgstr "" -#: reference/expressions.rst:1362 +#: reference/expressions.rst:1363 msgid "" -"This operation can be customized using the special :meth:`__sub__` method." +"This operation can be customized using the special :meth:`~object.__sub__` " +"method." msgstr "" -#: reference/expressions.rst:1368 +#: reference/expressions.rst:1369 msgid "Shifting operations" msgstr "" -#: reference/expressions.rst:1375 +#: reference/expressions.rst:1376 msgid "" "The shifting operations have lower priority than the arithmetic operations:" msgstr "" -#: reference/expressions.rst:1380 +#: reference/expressions.rst:1381 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:1383 +#: reference/expressions.rst:1384 msgid "" -"This operation can be customized using the special :meth:`__lshift__` and :" -"meth:`__rshift__` methods." +"This operation can be customized using the special :meth:`~object." +"__lshift__` and :meth:`~object.__rshift__` methods." msgstr "" -#: reference/expressions.rst:1388 +#: reference/expressions.rst:1389 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:1395 +#: reference/expressions.rst:1396 msgid "Binary bitwise operations" msgstr "" -#: reference/expressions.rst:1399 +#: reference/expressions.rst:1400 msgid "Each of the three bitwise operations has a different priority level:" msgstr "" -#: reference/expressions.rst:1410 +#: reference/expressions.rst:1411 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:`__and__` " -"or :meth:`__rand__` special methods." +"integers or one of them must be a custom object overriding :meth:`~object." +"__and__` or :meth:`~object.__rand__` special methods." msgstr "" -#: reference/expressions.rst:1419 +#: reference/expressions.rst:1420 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:`__xor__` or :meth:`__rxor__` special methods." +"meth:`~object.__xor__` or :meth:`~object.__rxor__` special methods." msgstr "" -#: reference/expressions.rst:1428 +#: reference/expressions.rst:1429 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:" -"`__or__` or :meth:`__ror__` special methods." +"`~object.__or__` or :meth:`~object.__ror__` special methods." msgstr "" -#: reference/expressions.rst:1436 +#: reference/expressions.rst:1437 msgid "Comparisons" msgstr "" -#: reference/expressions.rst:1448 +#: reference/expressions.rst:1449 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 " @@ -1459,14 +1461,14 @@ msgid "" "conventional in mathematics:" msgstr "" -#: reference/expressions.rst:1458 +#: reference/expressions.rst:1459 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:1464 +#: reference/expressions.rst:1465 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 " @@ -1474,7 +1476,7 @@ msgid "" "false)." msgstr "" -#: reference/expressions.rst:1468 +#: reference/expressions.rst:1469 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 " @@ -1482,24 +1484,24 @@ msgid "" "each expression is evaluated at most once." msgstr "" -#: reference/expressions.rst:1473 +#: reference/expressions.rst:1474 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:1480 +#: reference/expressions.rst:1481 msgid "Value comparisons" msgstr "" -#: reference/expressions.rst:1482 +#: reference/expressions.rst:1483 msgid "" "The operators ``<``, ``>``, ``==``, ``>=``, ``<=``, and ``!=`` compare the " "values of two objects. The objects do not need to have the same type." msgstr "" -#: reference/expressions.rst:1485 +#: reference/expressions.rst:1486 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 " @@ -1511,15 +1513,15 @@ msgid "" "indirectly, by means of their comparison implementation." msgstr "" -#: reference/expressions.rst:1494 +#: reference/expressions.rst:1495 msgid "" "Because all types are (direct or indirect) subtypes of :class:`object`, they " "inherit the default comparison behavior from :class:`object`. Types can " "customize their comparison behavior by implementing :dfn:`rich comparison " -"methods` like :meth:`__lt__`, described in :ref:`customization`." +"methods` like :meth:`~object.__lt__`, described in :ref:`customization`." msgstr "" -#: reference/expressions.rst:1500 +#: reference/expressions.rst:1501 msgid "" "The default behavior for equality comparison (``==`` and ``!=``) is based on " "the identity of the objects. Hence, equality comparison of instances with " @@ -1529,14 +1531,14 @@ msgid "" "``x is y`` implies ``x == y``)." msgstr "" -#: reference/expressions.rst:1507 +#: reference/expressions.rst:1508 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:1511 +#: reference/expressions.rst:1512 msgid "" "The behavior of the default equality comparison, that instances with " "different identities are always unequal, may be in contrast to what types " @@ -1545,13 +1547,13 @@ msgid "" "in fact, a number of built-in types have done that." msgstr "" -#: reference/expressions.rst:1517 +#: reference/expressions.rst:1518 msgid "" "The following list describes the comparison behavior of the most important " "built-in types." msgstr "" -#: reference/expressions.rst:1520 +#: reference/expressions.rst:1521 msgid "" "Numbers of built-in numeric types (:ref:`typesnumeric`) and of the standard " "library types :class:`fractions.Fraction` and :class:`decimal.Decimal` can " @@ -1561,7 +1563,7 @@ msgid "" "of precision." msgstr "" -#: reference/expressions.rst:1527 +#: reference/expressions.rst:1528 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 " @@ -1571,32 +1573,32 @@ msgid "" "is compliant with IEEE 754." msgstr "" -#: reference/expressions.rst:1534 +#: reference/expressions.rst:1535 msgid "" "``None`` and ``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:1538 +#: reference/expressions.rst:1539 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:1542 +#: reference/expressions.rst:1543 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:1546 +#: reference/expressions.rst:1547 msgid "Strings and binary sequences cannot be directly compared." msgstr "" -#: reference/expressions.rst:1548 +#: reference/expressions.rst:1549 msgid "" "Sequences (instances of :class:`tuple`, :class:`list`, or :class:`range`) " "can be compared only within each of their types, with the restriction that " @@ -1605,7 +1607,7 @@ msgid "" "raises :exc:`TypeError`." msgstr "" -#: reference/expressions.rst:1554 +#: reference/expressions.rst:1555 msgid "" "Sequences compare lexicographically using comparison of corresponding " "elements. The built-in containers typically assume identical objects are " @@ -1613,19 +1615,19 @@ msgid "" "objects to improve performance and to maintain their internal invariants." msgstr "" -#: reference/expressions.rst:1559 +#: reference/expressions.rst:1560 msgid "" "Lexicographical comparison between built-in collections works as follows:" msgstr "" -#: reference/expressions.rst:1561 +#: reference/expressions.rst:1562 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:1566 +#: reference/expressions.rst:1567 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 " @@ -1634,25 +1636,25 @@ msgid "" "true)." msgstr "" -#: reference/expressions.rst:1572 +#: reference/expressions.rst:1573 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:1576 +#: reference/expressions.rst:1577 msgid "" "Order comparisons (``<``, ``>``, ``<=``, and ``>=``) raise :exc:`TypeError`." msgstr "" -#: reference/expressions.rst:1578 +#: reference/expressions.rst:1579 msgid "" "Sets (instances of :class:`set` or :class:`frozenset`) can be compared " "within and across their types." msgstr "" -#: reference/expressions.rst:1581 +#: reference/expressions.rst:1582 msgid "" "They define order comparison operators to mean subset and superset tests. " "Those relations do not define total orderings (for example, the two sets " @@ -1663,110 +1665,110 @@ msgid "" "sets as inputs)." msgstr "" -#: reference/expressions.rst:1589 +#: reference/expressions.rst:1590 msgid "Comparison of sets enforces reflexivity of its elements." msgstr "" -#: reference/expressions.rst:1591 +#: reference/expressions.rst:1592 msgid "" "Most other built-in types have no comparison methods implemented, so they " "inherit the default comparison behavior." msgstr "" -#: reference/expressions.rst:1594 +#: reference/expressions.rst:1595 msgid "" "User-defined classes that customize their comparison behavior should follow " "some consistency rules, if possible:" msgstr "" -#: reference/expressions.rst:1597 +#: reference/expressions.rst:1598 msgid "" "Equality comparison should be reflexive. In other words, identical objects " "should compare equal:" msgstr "" -#: reference/expressions.rst:1600 +#: reference/expressions.rst:1601 msgid "``x is y`` implies ``x == y``" msgstr "" -#: reference/expressions.rst:1602 +#: reference/expressions.rst:1603 msgid "" "Comparison should be symmetric. In other words, the following expressions " "should have the same result:" msgstr "" -#: reference/expressions.rst:1605 +#: reference/expressions.rst:1606 msgid "``x == y`` and ``y == x``" msgstr "" -#: reference/expressions.rst:1607 +#: reference/expressions.rst:1608 msgid "``x != y`` and ``y != x``" msgstr "" -#: reference/expressions.rst:1609 +#: reference/expressions.rst:1610 msgid "``x < y`` and ``y > x``" msgstr "" -#: reference/expressions.rst:1611 +#: reference/expressions.rst:1612 msgid "``x <= y`` and ``y >= x``" msgstr "" -#: reference/expressions.rst:1613 +#: reference/expressions.rst:1614 msgid "" "Comparison should be transitive. The following (non-exhaustive) examples " "illustrate that:" msgstr "" -#: reference/expressions.rst:1616 +#: reference/expressions.rst:1617 msgid "``x > y and y > z`` implies ``x > z``" msgstr "" -#: reference/expressions.rst:1618 +#: reference/expressions.rst:1619 msgid "``x < y and y <= z`` implies ``x < z``" msgstr "" -#: reference/expressions.rst:1620 +#: reference/expressions.rst:1621 msgid "" "Inverse comparison should result in the boolean negation. In other words, " "the following expressions should have the same result:" msgstr "" -#: reference/expressions.rst:1623 +#: reference/expressions.rst:1624 msgid "``x == y`` and ``not x != y``" msgstr "" -#: reference/expressions.rst:1625 +#: reference/expressions.rst:1626 msgid "``x < y`` and ``not x >= y`` (for total ordering)" msgstr "" -#: reference/expressions.rst:1627 +#: reference/expressions.rst:1628 msgid "``x > y`` and ``not x <= y`` (for total ordering)" msgstr "" -#: reference/expressions.rst:1629 +#: reference/expressions.rst:1630 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:1633 +#: reference/expressions.rst:1634 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:1637 +#: reference/expressions.rst:1638 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:1646 +#: reference/expressions.rst:1647 msgid "Membership test operations" msgstr "" -#: reference/expressions.rst:1648 +#: reference/expressions.rst:1649 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`` " @@ -1777,7 +1779,7 @@ msgid "" "expression ``x in y`` is equivalent to ``any(x is e or x == e for e in y)``." msgstr "" -#: reference/expressions.rst:1656 +#: reference/expressions.rst:1657 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 " @@ -1785,23 +1787,23 @@ msgid "" "``\"\" in \"abc\"`` will return ``True``." msgstr "" -#: reference/expressions.rst:1661 +#: reference/expressions.rst:1662 msgid "" -"For user-defined classes which define the :meth:`__contains__` method, ``x " -"in y`` returns ``True`` if ``y.__contains__(x)`` returns a true value, and " -"``False`` otherwise." +"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:1665 +#: reference/expressions.rst:1666 msgid "" -"For user-defined classes which do not define :meth:`__contains__` but do " -"define :meth:`__iter__`, ``x in y`` is ``True`` if some value ``z``, for " -"which the expression ``x is z or x == z`` is true, is produced while " -"iterating over ``y``. If an exception is raised during the iteration, it is " -"as if :keyword:`in` raised that exception." +"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 " +"``z``, for which the expression ``x is z or x == z`` is true, is produced " +"while iterating over ``y``. If an exception is raised during the iteration, " +"it is as if :keyword:`in` raised that exception." msgstr "" -#: reference/expressions.rst:1671 +#: reference/expressions.rst:1672 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-" @@ -1810,17 +1812,17 @@ msgid "" "exception is raised, it is as if :keyword:`in` raised that exception)." msgstr "" -#: reference/expressions.rst:1683 +#: reference/expressions.rst:1684 msgid "" "The operator :keyword:`not in` is defined to have the inverse truth value " "of :keyword:`in`." msgstr "" -#: reference/expressions.rst:1696 +#: reference/expressions.rst:1697 msgid "Identity comparisons" msgstr "" -#: reference/expressions.rst:1698 +#: reference/expressions.rst:1699 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 " @@ -1828,11 +1830,11 @@ msgid "" "``x is not y`` yields the inverse truth value. [#]_" msgstr "" -#: reference/expressions.rst:1710 +#: reference/expressions.rst:1711 msgid "Boolean operations" msgstr "" -#: reference/expressions.rst:1721 +#: reference/expressions.rst:1722 msgid "" "In the context of Boolean operations, and also when expressions are used by " "control flow statements, the following values are interpreted as false: " @@ -1843,25 +1845,25 @@ msgid "" "__bool__` method." msgstr "" -#: reference/expressions.rst:1730 +#: reference/expressions.rst:1731 msgid "" "The operator :keyword:`not` yields ``True`` if its argument is false, " "``False`` otherwise." msgstr "" -#: reference/expressions.rst:1735 +#: reference/expressions.rst:1736 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:1740 +#: reference/expressions.rst:1741 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:1743 +#: reference/expressions.rst:1744 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 " @@ -1872,11 +1874,11 @@ msgid "" "argument (for example, ``not 'foo'`` produces ``False`` rather than ``''``.)" msgstr "" -#: reference/expressions.rst:1759 +#: reference/expressions.rst:1760 msgid "Assignment expressions" msgstr "" -#: reference/expressions.rst:1764 +#: reference/expressions.rst:1765 msgid "" "An assignment expression (sometimes also called a \"named expression\" or " "\"walrus\") assigns an :token:`~python-grammar:expression` to an :token:" @@ -1884,15 +1886,15 @@ msgid "" "`~python-grammar:expression`." msgstr "" -#: reference/expressions.rst:1769 +#: reference/expressions.rst:1770 msgid "One common use case is when handling matched regular expressions:" msgstr "" -#: reference/expressions.rst:1776 +#: reference/expressions.rst:1777 msgid "Or, when processing a file stream in chunks:" msgstr "" -#: reference/expressions.rst:1783 +#: reference/expressions.rst:1784 msgid "" "Assignment expressions must be surrounded by parentheses when used as " "expression statements and when used as sub-expressions in slicing, " @@ -1902,36 +1904,36 @@ msgid "" "and ``while`` statements." msgstr "" -#: reference/expressions.rst:1791 +#: reference/expressions.rst:1792 msgid "See :pep:`572` for more details about assignment expressions." msgstr "" -#: reference/expressions.rst:1798 +#: reference/expressions.rst:1799 msgid "Conditional expressions" msgstr "" -#: reference/expressions.rst:1810 +#: reference/expressions.rst:1811 msgid "" "Conditional expressions (sometimes called a \"ternary operator\") have the " "lowest priority of all Python operations." msgstr "" -#: reference/expressions.rst:1813 +#: reference/expressions.rst:1814 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:1817 +#: reference/expressions.rst:1818 msgid "See :pep:`308` for more details about conditional expressions." msgstr "" -#: reference/expressions.rst:1824 +#: reference/expressions.rst:1825 msgid "Lambdas" msgstr "" -#: reference/expressions.rst:1835 +#: reference/expressions.rst:1836 msgid "" "Lambda expressions (sometimes called lambda forms) are used to create " "anonymous functions. The expression ``lambda parameters: expression`` yields " @@ -1939,25 +1941,25 @@ msgid "" "defined with:" msgstr "" -#: reference/expressions.rst:1844 +#: reference/expressions.rst:1845 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:1852 +#: reference/expressions.rst:1853 msgid "Expression lists" msgstr "" -#: reference/expressions.rst:1866 +#: reference/expressions.rst:1867 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:1875 +#: reference/expressions.rst:1876 msgid "" "An asterisk ``*`` denotes :dfn:`iterable unpacking`. Its operand must be " "an :term:`iterable`. The iterable is expanded into a sequence of items, " @@ -1965,42 +1967,42 @@ msgid "" "unpacking." msgstr "" -#: reference/expressions.rst:1880 +#: reference/expressions.rst:1881 msgid "" "Iterable unpacking in expression lists, originally proposed by :pep:`448`." msgstr "" -#: reference/expressions.rst:1885 +#: reference/expressions.rst:1886 msgid "" -"The trailing comma is required only to create a single tuple (a.k.a. a " -"*singleton*); it is optional in all other cases. A single expression " -"without a trailing comma doesn't create a tuple, but rather yields the value " -"of that expression. (To create an empty tuple, use an empty pair of " -"parentheses: ``()``.)" +"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 " +"trailing comma doesn't create a tuple, but rather yields the value of that " +"expression. (To create an empty tuple, use an empty pair of parentheses: " +"``()``.)" msgstr "" -#: reference/expressions.rst:1895 +#: reference/expressions.rst:1897 msgid "Evaluation order" msgstr "" -#: reference/expressions.rst:1899 +#: reference/expressions.rst:1901 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:1902 +#: reference/expressions.rst:1904 msgid "" "In the following lines, expressions will be evaluated in the arithmetic " "order of their suffixes::" msgstr "" -#: reference/expressions.rst:1916 +#: reference/expressions.rst:1918 msgid "Operator precedence" msgstr "" -#: reference/expressions.rst:1921 +#: reference/expressions.rst:1923 msgid "" "The following table summarizes the operator precedence in Python, from " "highest precedence (most binding) to lowest precedence (least binding). " @@ -2010,176 +2012,176 @@ msgid "" "group from right to left)." msgstr "" -#: reference/expressions.rst:1927 +#: reference/expressions.rst:1929 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:1933 +#: reference/expressions.rst:1935 msgid "Operator" msgstr "" -#: reference/expressions.rst:1933 +#: reference/expressions.rst:1935 msgid "Description" msgstr "" -#: reference/expressions.rst:1935 +#: reference/expressions.rst:1937 msgid "``(expressions...)``," msgstr "" -#: reference/expressions.rst:1937 +#: reference/expressions.rst:1939 msgid "``[expressions...]``, ``{key: value...}``, ``{expressions...}``" msgstr "" -#: reference/expressions.rst:1935 +#: reference/expressions.rst:1937 msgid "" "Binding or parenthesized expression, list display, dictionary display, set " "display" msgstr "" -#: reference/expressions.rst:1941 +#: reference/expressions.rst:1943 msgid "``x[index]``, ``x[index:index]``, ``x(arguments...)``, ``x.attribute``" msgstr "" -#: reference/expressions.rst:1941 +#: reference/expressions.rst:1943 msgid "Subscription, slicing, call, attribute reference" msgstr "" -#: reference/expressions.rst:1944 +#: reference/expressions.rst:1946 msgid ":keyword:`await x `" msgstr "" -#: reference/expressions.rst:1946 +#: reference/expressions.rst:1948 msgid "``**``" msgstr "" -#: reference/expressions.rst:1946 +#: reference/expressions.rst:1948 msgid "Exponentiation [#]_" msgstr "" -#: reference/expressions.rst:1948 +#: reference/expressions.rst:1950 msgid "``+x``, ``-x``, ``~x``" msgstr "" -#: reference/expressions.rst:1948 +#: reference/expressions.rst:1950 msgid "Positive, negative, bitwise NOT" msgstr "" -#: reference/expressions.rst:1950 +#: reference/expressions.rst:1952 msgid "``*``, ``@``, ``/``, ``//``, ``%``" msgstr "" -#: reference/expressions.rst:1950 +#: reference/expressions.rst:1952 msgid "" "Multiplication, matrix multiplication, division, floor division, remainder " "[#]_" msgstr "" -#: reference/expressions.rst:1954 +#: reference/expressions.rst:1956 msgid "``+``, ``-``" msgstr "" -#: reference/expressions.rst:1954 +#: reference/expressions.rst:1956 msgid "Addition and subtraction" msgstr "" -#: reference/expressions.rst:1956 +#: reference/expressions.rst:1958 msgid "``<<``, ``>>``" msgstr "" -#: reference/expressions.rst:1956 +#: reference/expressions.rst:1958 msgid "Shifts" msgstr "" -#: reference/expressions.rst:1958 +#: reference/expressions.rst:1960 msgid "``&``" msgstr "" -#: reference/expressions.rst:1958 +#: reference/expressions.rst:1960 msgid "Bitwise AND" msgstr "" -#: reference/expressions.rst:1960 +#: reference/expressions.rst:1962 msgid "``^``" msgstr "" -#: reference/expressions.rst:1960 +#: reference/expressions.rst:1962 msgid "Bitwise XOR" msgstr "" -#: reference/expressions.rst:1962 +#: reference/expressions.rst:1964 msgid "``|``" msgstr "" -#: reference/expressions.rst:1962 +#: reference/expressions.rst:1964 msgid "Bitwise OR" msgstr "" -#: reference/expressions.rst:1964 +#: reference/expressions.rst:1966 msgid "" ":keyword:`in`, :keyword:`not in`, :keyword:`is`, :keyword:`is not`, ``<``, " "``<=``, ``>``, ``>=``, ``!=``, ``==``" msgstr "" -#: reference/expressions.rst:1964 +#: reference/expressions.rst:1966 msgid "Comparisons, including membership tests and identity tests" msgstr "" -#: reference/expressions.rst:1968 +#: reference/expressions.rst:1970 msgid ":keyword:`not x `" msgstr "" -#: reference/expressions.rst:1968 +#: reference/expressions.rst:1970 msgid "Boolean NOT" msgstr "" -#: reference/expressions.rst:1970 +#: reference/expressions.rst:1972 msgid ":keyword:`and`" msgstr "" -#: reference/expressions.rst:1970 +#: reference/expressions.rst:1972 msgid "Boolean AND" msgstr "" -#: reference/expressions.rst:1972 +#: reference/expressions.rst:1974 msgid ":keyword:`or`" msgstr "" -#: reference/expressions.rst:1972 +#: reference/expressions.rst:1974 msgid "Boolean OR" msgstr "" -#: reference/expressions.rst:1974 +#: reference/expressions.rst:1976 msgid ":keyword:`if ` -- :keyword:`!else`" msgstr "" -#: reference/expressions.rst:1974 +#: reference/expressions.rst:1976 msgid "Conditional expression" msgstr "" -#: reference/expressions.rst:1976 +#: reference/expressions.rst:1978 msgid ":keyword:`lambda`" msgstr "" -#: reference/expressions.rst:1976 +#: reference/expressions.rst:1978 msgid "Lambda expression" msgstr "" -#: reference/expressions.rst:1978 +#: reference/expressions.rst:1980 msgid "``:=``" msgstr "" -#: reference/expressions.rst:1978 +#: reference/expressions.rst:1980 msgid "Assignment expression" msgstr "" -#: reference/expressions.rst:1983 +#: reference/expressions.rst:1985 msgid "Footnotes" msgstr "" -#: reference/expressions.rst:1984 +#: reference/expressions.rst:1986 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 " @@ -2191,7 +2193,7 @@ msgid "" "approach is more appropriate depends on the application." msgstr "" -#: reference/expressions.rst:1993 +#: reference/expressions.rst:1995 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, " @@ -2199,7 +2201,7 @@ msgid "" "* y + x % y`` be very close to ``x``." msgstr "" -#: reference/expressions.rst:1998 +#: reference/expressions.rst:2000 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 " @@ -2213,7 +2215,7 @@ msgid "" "(COMBINING CEDILLA)." msgstr "" -#: reference/expressions.rst:2009 +#: reference/expressions.rst:2011 msgid "" "The comparison operators on strings compare at the level of Unicode code " "points. This may be counter-intuitive to humans. For example, ``\"\\u00C7\" " @@ -2221,13 +2223,13 @@ msgid "" "same abstract character \"LATIN CAPITAL LETTER C WITH CEDILLA\"." msgstr "" -#: reference/expressions.rst:2014 +#: reference/expressions.rst:2016 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:2017 +#: reference/expressions.rst:2019 msgid "" "Due to automatic garbage-collection, free lists, and the dynamic nature of " "descriptors, you may notice seemingly unusual behaviour in certain uses of " @@ -2235,20 +2237,20 @@ msgid "" "instance methods, or constants. Check their documentation for more info." msgstr "" -#: reference/expressions.rst:2022 +#: reference/expressions.rst:2024 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:2025 +#: reference/expressions.rst:2027 msgid "" "The ``%`` operator is also used for string formatting; the same precedence " "applies." msgstr "" -#: reference/expressions.rst:362 reference/expressions.rst:1712 -#: reference/expressions.rst:1826 reference/expressions.rst:1854 +#: reference/expressions.rst:362 reference/expressions.rst:1713 +#: reference/expressions.rst:1827 reference/expressions.rst:1855 msgid "expression" msgstr "" @@ -2256,7 +2258,7 @@ msgstr "" msgid "BNF" msgstr "" -#: reference/expressions.rst:1213 reference/expressions.rst:1261 +#: reference/expressions.rst:1214 reference/expressions.rst:1262 msgid "arithmetic" msgstr "" @@ -2276,9 +2278,9 @@ msgstr "" msgid "identifier" msgstr "" -#: reference/expressions.rst:537 reference/expressions.rst:714 -#: reference/expressions.rst:812 reference/expressions.rst:1296 -#: reference/expressions.rst:1386 +#: reference/expressions.rst:538 reference/expressions.rst:715 +#: reference/expressions.rst:813 reference/expressions.rst:1297 +#: reference/expressions.rst:1387 msgid "exception" msgstr "" @@ -2315,10 +2317,10 @@ msgid "type" msgstr "" #: reference/expressions.rst:244 reference/expressions.rst:298 -#: reference/expressions.rst:362 reference/expressions.rst:704 -#: reference/expressions.rst:841 reference/expressions.rst:958 -#: reference/expressions.rst:1119 reference/expressions.rst:1140 -#: reference/expressions.rst:1864 +#: 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 msgid "object" msgstr "" @@ -2326,7 +2328,7 @@ msgstr "" msgid "parenthesized form" msgstr "" -#: reference/expressions.rst:362 reference/expressions.rst:958 +#: reference/expressions.rst:362 reference/expressions.rst:959 msgid "() (parentheses)" msgstr "" @@ -2338,16 +2340,16 @@ msgstr "" msgid "empty" msgstr "" -#: reference/expressions.rst:841 reference/expressions.rst:1864 +#: reference/expressions.rst:842 reference/expressions.rst:1865 msgid "tuple" msgstr "" -#: reference/expressions.rst:1883 +#: reference/expressions.rst:1884 msgid "comma" msgstr "" #: reference/expressions.rst:244 reference/expressions.rst:298 -#: reference/expressions.rst:958 reference/expressions.rst:1854 +#: reference/expressions.rst:959 reference/expressions.rst:1855 msgid ", (comma)" msgstr "" @@ -2363,7 +2365,7 @@ msgstr "" msgid "in comprehensions" msgstr "" -#: reference/expressions.rst:1800 +#: reference/expressions.rst:1801 msgid "if" msgstr "" @@ -2371,12 +2373,12 @@ msgstr "" msgid "async for" msgstr "" -#: reference/expressions.rst:1158 +#: reference/expressions.rst:1159 msgid "await" msgstr "" -#: reference/expressions.rst:812 reference/expressions.rst:914 -#: reference/expressions.rst:1854 +#: reference/expressions.rst:813 reference/expressions.rst:915 +#: reference/expressions.rst:1855 msgid "list" msgstr "" @@ -2384,7 +2386,7 @@ msgstr "" msgid "display" msgstr "" -#: reference/expressions.rst:837 +#: reference/expressions.rst:838 msgid "[] (square brackets)" msgstr "" @@ -2392,7 +2394,7 @@ msgstr "" msgid "list expression" msgstr "" -#: reference/expressions.rst:270 reference/expressions.rst:1854 +#: reference/expressions.rst:270 reference/expressions.rst:1855 msgid "expression list" msgstr "" @@ -2408,7 +2410,7 @@ msgstr "" msgid "set expression" msgstr "" -#: reference/expressions.rst:324 reference/expressions.rst:841 +#: reference/expressions.rst:324 reference/expressions.rst:842 msgid "dictionary" msgstr "" @@ -2428,7 +2430,7 @@ msgstr "" msgid "dictionary expression" msgstr "" -#: reference/expressions.rst:908 reference/expressions.rst:1826 +#: reference/expressions.rst:909 reference/expressions.rst:1827 msgid ": (colon)" msgstr "" @@ -2440,11 +2442,11 @@ msgstr "" msgid "in dictionary displays" msgstr "" -#: reference/expressions.rst:1041 reference/expressions.rst:1871 +#: reference/expressions.rst:1042 reference/expressions.rst:1872 msgid "unpacking" msgstr "" -#: reference/expressions.rst:1071 reference/expressions.rst:1178 +#: reference/expressions.rst:1072 reference/expressions.rst:1179 msgid "**" msgstr "" @@ -2452,7 +2454,7 @@ msgstr "" msgid "hashable" msgstr "" -#: reference/expressions.rst:417 reference/expressions.rst:525 +#: reference/expressions.rst:417 reference/expressions.rst:526 msgid "generator" msgstr "" @@ -2460,514 +2462,514 @@ msgstr "" msgid "generator expression" msgstr "" -#: reference/expressions.rst:1158 +#: reference/expressions.rst:1159 msgid "keyword" msgstr "" -#: reference/expressions.rst:605 +#: reference/expressions.rst:606 msgid "yield" msgstr "" -#: reference/expressions.rst:484 +#: reference/expressions.rst:485 msgid "from" msgstr "" -#: reference/expressions.rst:1106 reference/expressions.rst:1826 +#: reference/expressions.rst:1107 reference/expressions.rst:1827 msgid "function" msgstr "" -#: reference/expressions.rst:470 +#: reference/expressions.rst:471 msgid "coroutine" msgstr "" -#: reference/expressions.rst:484 +#: reference/expressions.rst:485 msgid "yield from expression" msgstr "" -#: reference/expressions.rst:537 +#: reference/expressions.rst:538 msgid "StopIteration" msgstr "" -#: reference/expressions.rst:766 +#: reference/expressions.rst:767 msgid "GeneratorExit" msgstr "" -#: reference/expressions.rst:605 +#: reference/expressions.rst:606 msgid "examples" msgstr "" -#: reference/expressions.rst:704 +#: reference/expressions.rst:705 msgid "asynchronous-generator" msgstr "" -#: reference/expressions.rst:714 +#: reference/expressions.rst:715 msgid "StopAsyncIteration" msgstr "" -#: reference/expressions.rst:789 +#: reference/expressions.rst:790 msgid "primary" msgstr "" -#: reference/expressions.rst:803 +#: reference/expressions.rst:804 msgid "attribute" msgstr "" -#: reference/expressions.rst:803 +#: reference/expressions.rst:804 msgid "reference" msgstr "" -#: reference/expressions.rst:803 +#: reference/expressions.rst:804 msgid ". (dot)" msgstr "" -#: reference/expressions.rst:803 +#: reference/expressions.rst:804 msgid "attribute reference" msgstr "" -#: reference/expressions.rst:812 +#: reference/expressions.rst:813 msgid "AttributeError" msgstr "" -#: reference/expressions.rst:812 +#: reference/expressions.rst:813 msgid "module" msgstr "" -#: reference/expressions.rst:837 +#: reference/expressions.rst:838 msgid "subscription" msgstr "" -#: reference/expressions.rst:914 reference/expressions.rst:1677 +#: reference/expressions.rst:915 reference/expressions.rst:1678 msgid "sequence" msgstr "" -#: reference/expressions.rst:841 +#: reference/expressions.rst:842 msgid "mapping" msgstr "" -#: reference/expressions.rst:894 reference/expressions.rst:914 +#: reference/expressions.rst:895 reference/expressions.rst:915 msgid "string" msgstr "" -#: reference/expressions.rst:894 +#: reference/expressions.rst:895 msgid "item" msgstr "" -#: reference/expressions.rst:894 +#: reference/expressions.rst:895 msgid "character" msgstr "" -#: reference/expressions.rst:908 +#: reference/expressions.rst:909 msgid "slicing" msgstr "" -#: reference/expressions.rst:908 +#: reference/expressions.rst:909 msgid "slice" msgstr "" -#: reference/expressions.rst:940 +#: reference/expressions.rst:941 msgid "start (slice object attribute)" msgstr "" -#: reference/expressions.rst:940 +#: reference/expressions.rst:941 msgid "stop (slice object attribute)" msgstr "" -#: reference/expressions.rst:940 +#: reference/expressions.rst:941 msgid "step (slice object attribute)" msgstr "" -#: reference/expressions.rst:958 +#: reference/expressions.rst:959 msgid "callable" msgstr "" -#: reference/expressions.rst:1106 reference/expressions.rst:1133 -#: reference/expressions.rst:1150 +#: reference/expressions.rst:1107 reference/expressions.rst:1134 +#: reference/expressions.rst:1151 msgid "call" msgstr "" -#: reference/expressions.rst:958 +#: reference/expressions.rst:959 msgid "argument" msgstr "" -#: reference/expressions.rst:991 +#: reference/expressions.rst:992 msgid "call semantics" msgstr "" -#: reference/expressions.rst:958 +#: reference/expressions.rst:959 msgid "argument list" msgstr "" -#: reference/expressions.rst:958 +#: reference/expressions.rst:959 msgid "= (equals)" msgstr "" -#: reference/expressions.rst:1041 reference/expressions.rst:1071 +#: reference/expressions.rst:1042 reference/expressions.rst:1072 msgid "in function calls" msgstr "" -#: reference/expressions.rst:991 +#: reference/expressions.rst:992 msgid "parameter" msgstr "" -#: reference/expressions.rst:1274 reference/expressions.rst:1871 +#: reference/expressions.rst:1275 reference/expressions.rst:1872 msgid "* (asterisk)" msgstr "" -#: reference/expressions.rst:1106 +#: reference/expressions.rst:1107 msgid "user-defined" msgstr "" -#: reference/expressions.rst:1106 +#: reference/expressions.rst:1107 msgid "user-defined function" msgstr "" -#: reference/expressions.rst:1119 +#: reference/expressions.rst:1120 msgid "built-in function" msgstr "" -#: reference/expressions.rst:1119 +#: reference/expressions.rst:1120 msgid "method" msgstr "" -#: reference/expressions.rst:1119 +#: reference/expressions.rst:1120 msgid "built-in method" msgstr "" -#: reference/expressions.rst:1133 +#: reference/expressions.rst:1134 msgid "class" msgstr "" -#: reference/expressions.rst:1133 +#: reference/expressions.rst:1134 msgid "class object" msgstr "" -#: reference/expressions.rst:1140 +#: reference/expressions.rst:1141 msgid "class instance" msgstr "" -#: reference/expressions.rst:1150 +#: reference/expressions.rst:1151 msgid "instance" msgstr "" -#: reference/expressions.rst:1150 +#: reference/expressions.rst:1151 msgid "__call__() (object method)" msgstr "" -#: reference/expressions.rst:1178 +#: reference/expressions.rst:1179 msgid "power" msgstr "" -#: reference/expressions.rst:1213 reference/expressions.rst:1370 -#: reference/expressions.rst:1712 +#: reference/expressions.rst:1214 reference/expressions.rst:1371 +#: reference/expressions.rst:1713 msgid "operation" msgstr "" -#: reference/expressions.rst:1222 reference/expressions.rst:1239 -#: reference/expressions.rst:1287 reference/expressions.rst:1312 -#: reference/expressions.rst:1354 reference/expressions.rst:1406 -#: reference/expressions.rst:1423 reference/expressions.rst:1677 -#: reference/expressions.rst:1728 reference/expressions.rst:1738 -#: reference/expressions.rst:1918 +#: 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 msgid "operator" msgstr "" -#: reference/expressions.rst:1213 +#: reference/expressions.rst:1214 msgid "unary" msgstr "" -#: reference/expressions.rst:1397 reference/expressions.rst:1414 -#: reference/expressions.rst:1423 +#: reference/expressions.rst:1398 reference/expressions.rst:1415 +#: reference/expressions.rst:1424 msgid "bitwise" msgstr "" -#: reference/expressions.rst:1222 +#: reference/expressions.rst:1223 msgid "negation" msgstr "" -#: reference/expressions.rst:1222 +#: reference/expressions.rst:1223 msgid "minus" msgstr "" -#: reference/expressions.rst:1354 +#: reference/expressions.rst:1355 msgid "- (minus)" msgstr "" -#: reference/expressions.rst:1231 +#: reference/expressions.rst:1232 msgid "unary operator" msgstr "" -#: reference/expressions.rst:1231 +#: reference/expressions.rst:1232 msgid "plus" msgstr "" -#: reference/expressions.rst:1341 +#: reference/expressions.rst:1342 msgid "+ (plus)" msgstr "" -#: reference/expressions.rst:1239 +#: reference/expressions.rst:1240 msgid "inversion" msgstr "" -#: reference/expressions.rst:1239 +#: reference/expressions.rst:1240 msgid "~ (tilde)" msgstr "" -#: reference/expressions.rst:1250 +#: reference/expressions.rst:1251 msgid "TypeError" msgstr "" -#: reference/expressions.rst:1397 +#: reference/expressions.rst:1398 msgid "binary" msgstr "" -#: reference/expressions.rst:1274 +#: reference/expressions.rst:1275 msgid "multiplication" msgstr "" -#: reference/expressions.rst:1287 +#: reference/expressions.rst:1288 msgid "matrix multiplication" msgstr "" -#: reference/expressions.rst:1287 +#: reference/expressions.rst:1288 msgid "@ (at)" msgstr "" -#: reference/expressions.rst:1296 +#: reference/expressions.rst:1297 msgid "ZeroDivisionError" msgstr "" -#: reference/expressions.rst:1296 +#: reference/expressions.rst:1297 msgid "division" msgstr "" -#: reference/expressions.rst:1296 +#: reference/expressions.rst:1297 msgid "/ (slash)" msgstr "" -#: reference/expressions.rst:1296 +#: reference/expressions.rst:1297 msgid "//" msgstr "" -#: reference/expressions.rst:1312 +#: reference/expressions.rst:1313 msgid "modulo" msgstr "" -#: reference/expressions.rst:1312 +#: reference/expressions.rst:1313 msgid "% (percent)" msgstr "" -#: reference/expressions.rst:1341 +#: reference/expressions.rst:1342 msgid "addition" msgstr "" -#: reference/expressions.rst:1354 +#: reference/expressions.rst:1355 msgid "binary operator" msgstr "" -#: reference/expressions.rst:1354 +#: reference/expressions.rst:1355 msgid "subtraction" msgstr "" -#: reference/expressions.rst:1370 +#: reference/expressions.rst:1371 msgid "shifting" msgstr "" -#: reference/expressions.rst:1370 +#: reference/expressions.rst:1371 msgid "<<" msgstr "" -#: reference/expressions.rst:1370 +#: reference/expressions.rst:1371 msgid ">>" msgstr "" -#: reference/expressions.rst:1386 +#: reference/expressions.rst:1387 msgid "ValueError" msgstr "" -#: reference/expressions.rst:1733 +#: reference/expressions.rst:1734 msgid "and" msgstr "" -#: reference/expressions.rst:1406 +#: reference/expressions.rst:1407 msgid "& (ampersand)" msgstr "" -#: reference/expressions.rst:1414 +#: reference/expressions.rst:1415 msgid "xor" msgstr "" -#: reference/expressions.rst:1414 +#: reference/expressions.rst:1415 msgid "exclusive" msgstr "" -#: reference/expressions.rst:1423 reference/expressions.rst:1738 +#: reference/expressions.rst:1424 reference/expressions.rst:1739 msgid "or" msgstr "" -#: reference/expressions.rst:1414 +#: reference/expressions.rst:1415 msgid "^ (caret)" msgstr "" -#: reference/expressions.rst:1423 +#: reference/expressions.rst:1424 msgid "inclusive" msgstr "" -#: reference/expressions.rst:1423 +#: reference/expressions.rst:1424 msgid "| (vertical bar)" msgstr "" -#: reference/expressions.rst:1438 +#: reference/expressions.rst:1439 msgid "comparison" msgstr "" -#: reference/expressions.rst:1438 +#: reference/expressions.rst:1439 msgid "C" msgstr "" -#: reference/expressions.rst:1438 +#: reference/expressions.rst:1439 msgid "language" msgstr "" -#: reference/expressions.rst:1438 +#: reference/expressions.rst:1439 msgid "< (less)" msgstr "" -#: reference/expressions.rst:1438 +#: reference/expressions.rst:1439 msgid "> (greater)" msgstr "" -#: reference/expressions.rst:1438 +#: reference/expressions.rst:1439 msgid "<=" msgstr "" -#: reference/expressions.rst:1438 +#: reference/expressions.rst:1439 msgid ">=" msgstr "" -#: reference/expressions.rst:1438 +#: reference/expressions.rst:1439 msgid "==" msgstr "" -#: reference/expressions.rst:1438 +#: reference/expressions.rst:1439 msgid "!=" msgstr "" -#: reference/expressions.rst:1462 +#: reference/expressions.rst:1463 msgid "chaining" msgstr "" -#: reference/expressions.rst:1462 +#: reference/expressions.rst:1463 msgid "comparisons" msgstr "" -#: reference/expressions.rst:1677 +#: reference/expressions.rst:1678 msgid "in" msgstr "" -#: reference/expressions.rst:1677 +#: reference/expressions.rst:1678 msgid "not in" msgstr "" -#: reference/expressions.rst:1677 +#: reference/expressions.rst:1678 msgid "membership" msgstr "" -#: reference/expressions.rst:1686 +#: reference/expressions.rst:1687 msgid "test" msgstr "" -#: reference/expressions.rst:1686 +#: reference/expressions.rst:1687 msgid "is" msgstr "" -#: reference/expressions.rst:1686 +#: reference/expressions.rst:1687 msgid "is not" msgstr "" -#: reference/expressions.rst:1686 +#: reference/expressions.rst:1687 msgid "identity" msgstr "" -#: reference/expressions.rst:1712 +#: reference/expressions.rst:1713 msgid "Conditional" msgstr "" -#: reference/expressions.rst:1712 +#: reference/expressions.rst:1713 msgid "Boolean" msgstr "" -#: reference/expressions.rst:1728 +#: reference/expressions.rst:1729 msgid "not" msgstr "" -#: reference/expressions.rst:1752 +#: reference/expressions.rst:1753 msgid ":= (colon equals)" msgstr "" -#: reference/expressions.rst:1752 +#: reference/expressions.rst:1753 msgid "assignment expression" msgstr "" -#: reference/expressions.rst:1752 +#: reference/expressions.rst:1753 msgid "walrus operator" msgstr "" -#: reference/expressions.rst:1752 +#: reference/expressions.rst:1753 msgid "named expression" msgstr "" -#: reference/expressions.rst:1800 +#: reference/expressions.rst:1801 msgid "conditional" msgstr "" -#: reference/expressions.rst:1800 +#: reference/expressions.rst:1801 msgid "ternary" msgstr "" -#: reference/expressions.rst:1800 +#: reference/expressions.rst:1801 msgid "conditional expression" msgstr "" -#: reference/expressions.rst:1800 +#: reference/expressions.rst:1801 msgid "else" msgstr "" -#: reference/expressions.rst:1826 +#: reference/expressions.rst:1827 msgid "lambda" msgstr "" -#: reference/expressions.rst:1826 +#: reference/expressions.rst:1827 msgid "form" msgstr "" -#: reference/expressions.rst:1826 +#: reference/expressions.rst:1827 msgid "anonymous" msgstr "" -#: reference/expressions.rst:1826 +#: reference/expressions.rst:1827 msgid "lambda expression" msgstr "" -#: reference/expressions.rst:1871 +#: reference/expressions.rst:1872 msgid "iterable" msgstr "" -#: reference/expressions.rst:1871 +#: reference/expressions.rst:1872 msgid "in expression lists" msgstr "" -#: reference/expressions.rst:1883 +#: reference/expressions.rst:1884 msgid "trailing" msgstr "" -#: reference/expressions.rst:1897 +#: reference/expressions.rst:1899 msgid "evaluation" msgstr "" -#: reference/expressions.rst:1897 +#: reference/expressions.rst:1899 msgid "order" msgstr "" -#: reference/expressions.rst:1918 +#: reference/expressions.rst:1920 msgid "precedence" msgstr "" diff --git a/reference/import.po b/reference/import.po index 620265f05..4f3c66853 100644 --- a/reference/import.po +++ b/reference/import.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -416,7 +416,8 @@ msgid "" "The :meth:`~importlib.abc.MetaPathFinder.find_spec` method of meta path " "finders replaced :meth:`!find_module`, which is now deprecated. While it " "will continue to work without change, the import machinery will try it only " -"if the finder does not implement ``find_spec()``." +"if the finder does not implement :meth:`~importlib.abc.MetaPathFinder." +"find_spec`." msgstr "" #: reference/import.rst:332 @@ -426,31 +427,33 @@ msgid "" msgstr "" #: reference/import.rst:336 -msgid "``find_module()`` has been removed. Use :meth:`find_spec` instead." +msgid "" +":meth:`!find_module` has been removed. Use :meth:`~importlib.abc." +"MetaPathFinder.find_spec` instead." msgstr "" -#: reference/import.rst:341 +#: reference/import.rst:342 msgid "Loading" msgstr "" -#: reference/import.rst:343 +#: reference/import.rst:344 msgid "" "If and when a module spec is found, the import machinery will use it (and " "the loader it contains) when loading the module. Here is an approximation " "of what happens during the loading portion of import::" msgstr "" -#: reference/import.rst:376 +#: reference/import.rst:377 msgid "Note the following details:" msgstr "" -#: reference/import.rst:378 +#: reference/import.rst:379 msgid "" "If there is an existing module object with the given name in :data:`sys." "modules`, import will have already returned it." msgstr "" -#: reference/import.rst:381 +#: reference/import.rst:382 msgid "" "The module will exist in :data:`sys.modules` before the loader executes the " "module code. This is crucial because the module code may (directly or " @@ -459,7 +462,7 @@ msgid "" "best." msgstr "" -#: reference/import.rst:387 +#: reference/import.rst:388 msgid "" "If loading fails, the failing module -- and only the failing module -- gets " "removed from :data:`sys.modules`. Any module already in the :data:`sys." @@ -468,7 +471,7 @@ msgid "" "the failing module is left in :data:`sys.modules`." msgstr "" -#: reference/import.rst:393 +#: reference/import.rst:394 msgid "" "After the module is created but before execution, the import machinery sets " "the import-related module attributes (\"_init_module_attrs\" in the pseudo-" @@ -476,31 +479,31 @@ msgid "" "attrs>`." msgstr "" -#: reference/import.rst:398 +#: reference/import.rst:399 msgid "" "Module execution is the key moment of loading in which the module's " "namespace gets populated. Execution is entirely delegated to the loader, " "which gets to decide what gets populated and how." msgstr "" -#: reference/import.rst:402 +#: reference/import.rst:403 msgid "" "The module created during loading and passed to exec_module() may not be the " "one returned at the end of import [#fnlo]_." msgstr "" -#: reference/import.rst:405 +#: reference/import.rst:406 msgid "" "The import system has taken over the boilerplate responsibilities of " "loaders. These were previously performed by the :meth:`importlib.abc.Loader." "load_module` method." msgstr "" -#: reference/import.rst:411 +#: reference/import.rst:412 msgid "Loaders" msgstr "" -#: reference/import.rst:413 +#: reference/import.rst:414 msgid "" "Module loaders provide the critical function of loading: module execution. " "The import machinery calls the :meth:`importlib.abc.Loader.exec_module` " @@ -508,32 +511,32 @@ msgid "" "returned from :meth:`~importlib.abc.Loader.exec_module` is ignored." msgstr "" -#: reference/import.rst:418 +#: reference/import.rst:419 msgid "Loaders must satisfy the following requirements:" msgstr "" -#: reference/import.rst:420 +#: reference/import.rst:421 msgid "" "If the module is a Python module (as opposed to a built-in module or a " "dynamically loaded extension), the loader should execute the module's code " "in the module's global name space (``module.__dict__``)." msgstr "" -#: reference/import.rst:424 +#: reference/import.rst:425 msgid "" "If the loader cannot execute the module, it should raise an :exc:" "`ImportError`, although any other exception raised during :meth:`~importlib." "abc.Loader.exec_module` will be propagated." msgstr "" -#: reference/import.rst:428 +#: reference/import.rst:429 msgid "" "In many cases, the finder and loader can be the same object; in such cases " "the :meth:`~importlib.abc.MetaPathFinder.find_spec` method would just return " "a spec with the loader set to ``self``." msgstr "" -#: reference/import.rst:432 +#: reference/import.rst:433 msgid "" "Module loaders may opt in to creating the module object during loading by " "implementing a :meth:`~importlib.abc.Loader.create_module` method. It takes " @@ -543,18 +546,18 @@ msgid "" "will create the new module itself." msgstr "" -#: reference/import.rst:439 +#: reference/import.rst:440 msgid "The :meth:`~importlib.abc.Loader.create_module` method of loaders." msgstr "" -#: reference/import.rst:442 +#: reference/import.rst:443 msgid "" "The :meth:`~importlib.abc.Loader.load_module` method was replaced by :meth:" "`~importlib.abc.Loader.exec_module` and the import machinery assumed all the " "boilerplate responsibilities of loading." msgstr "" -#: reference/import.rst:447 +#: reference/import.rst:448 msgid "" "For compatibility with existing loaders, the import machinery will use the " "``load_module()`` method of loaders if it exists and the loader does not " @@ -562,14 +565,14 @@ msgid "" "deprecated and loaders should implement ``exec_module()`` instead." msgstr "" -#: reference/import.rst:452 +#: reference/import.rst:453 msgid "" "The ``load_module()`` method must implement all the boilerplate loading " "functionality described above in addition to executing the module. All the " "same constraints apply, with some additional clarification:" msgstr "" -#: reference/import.rst:456 +#: reference/import.rst:457 msgid "" "If there is an existing module object with the given name in :data:`sys." "modules`, the loader must use that existing module. (Otherwise, :func:" @@ -578,40 +581,40 @@ msgid "" "add it to :data:`sys.modules`." msgstr "" -#: reference/import.rst:462 +#: reference/import.rst:463 msgid "" "The module *must* exist in :data:`sys.modules` before the loader executes " "the module code, to prevent unbounded recursion or multiple loading." msgstr "" -#: reference/import.rst:466 +#: reference/import.rst:467 msgid "" "If loading fails, the loader must remove any modules it has inserted into :" "data:`sys.modules`, but it must remove **only** the failing module(s), and " "only if the loader itself has loaded the module(s) explicitly." msgstr "" -#: reference/import.rst:471 +#: reference/import.rst:472 msgid "" "A :exc:`DeprecationWarning` is raised when ``exec_module()`` is defined but " "``create_module()`` is not." msgstr "" -#: reference/import.rst:475 +#: reference/import.rst:476 msgid "" "An :exc:`ImportError` is raised when ``exec_module()`` is defined but " "``create_module()`` is not." msgstr "" -#: reference/import.rst:479 +#: reference/import.rst:480 msgid "Use of ``load_module()`` will raise :exc:`ImportWarning`." msgstr "" -#: reference/import.rst:483 +#: reference/import.rst:484 msgid "Submodules" msgstr "" -#: reference/import.rst:485 +#: reference/import.rst:486 msgid "" "When a submodule is loaded using any mechanism (e.g. ``importlib`` APIs, the " "``import`` or ``import-from`` statements, or built-in ``__import__()``) a " @@ -621,17 +624,17 @@ msgid "" "submodule. Let's say you have the following directory structure::" msgstr "" -#: reference/import.rst:496 +#: reference/import.rst:497 msgid "and ``spam/__init__.py`` has the following line in it::" msgstr "" -#: reference/import.rst:500 +#: reference/import.rst:501 msgid "" "then executing the following puts name bindings for ``foo`` and ``Foo`` in " "the ``spam`` module::" msgstr "" -#: reference/import.rst:509 +#: reference/import.rst:510 msgid "" "Given Python's familiar name binding rules this might seem surprising, but " "it's actually a fundamental feature of the import system. The invariant " @@ -640,11 +643,11 @@ msgid "" "``foo`` attribute of the former." msgstr "" -#: reference/import.rst:516 +#: reference/import.rst:517 msgid "Module spec" msgstr "" -#: reference/import.rst:518 +#: reference/import.rst:519 msgid "" "The import machinery uses a variety of information about each module during " "import, especially before loading. Most of the information is common to all " @@ -652,7 +655,7 @@ msgid "" "related information on a per-module basis." msgstr "" -#: reference/import.rst:523 +#: reference/import.rst:524 msgid "" "Using a spec during import allows state to be transferred between import " "system components, e.g. between the finder that creates the module spec and " @@ -661,37 +664,37 @@ msgid "" "a module spec the loader had that responsibility." msgstr "" -#: reference/import.rst:529 +#: reference/import.rst:530 msgid "" "The module's spec is exposed as the ``__spec__`` attribute on a module " "object. See :class:`~importlib.machinery.ModuleSpec` for details on the " "contents of the module spec." msgstr "" -#: reference/import.rst:538 +#: reference/import.rst:539 msgid "Import-related module attributes" msgstr "" -#: reference/import.rst:540 +#: reference/import.rst:541 msgid "" "The import machinery fills in these attributes on each module object during " "loading, based on the module's spec, before the loader executes the module." msgstr "" -#: reference/import.rst:544 +#: reference/import.rst:545 msgid "" "It is **strongly** recommended that you rely on :attr:`__spec__` and its " "attributes instead of any of the other individual attributes listed below." msgstr "" -#: reference/import.rst:550 +#: reference/import.rst:551 msgid "" "The ``__name__`` attribute must be set to the fully qualified name of the " "module. This name is used to uniquely identify the module in the import " "system." msgstr "" -#: reference/import.rst:556 +#: reference/import.rst:557 msgid "" "The ``__loader__`` attribute must be set to the loader object that the " "import machinery used when loading the module. This is mostly for " @@ -699,20 +702,20 @@ msgid "" "for example getting data associated with a loader." msgstr "" -#: reference/import.rst:582 +#: reference/import.rst:583 msgid "" "It is **strongly** recommended that you rely on :attr:`__spec__` instead of " "this attribute." msgstr "" -#: reference/import.rst:564 +#: reference/import.rst:565 msgid "" "The value of ``__loader__`` is expected to be the same as ``__spec__." "loader``. The use of ``__loader__`` is deprecated and slated for removal in " "Python 3.14." msgstr "" -#: reference/import.rst:571 +#: reference/import.rst:572 msgid "" "The module's ``__package__`` attribute may be set. Its value must be a " "string, but it can be the same value as its ``__name__``. When the module " @@ -722,31 +725,31 @@ msgid "" "name. See :pep:`366` for further details." msgstr "" -#: reference/import.rst:579 +#: reference/import.rst:580 msgid "" "This attribute is used instead of ``__name__`` to calculate explicit " "relative imports for main modules, as defined in :pep:`366`." msgstr "" -#: reference/import.rst:585 +#: reference/import.rst:586 msgid "" "The value of ``__package__`` is expected to be the same as ``__spec__." "parent``." msgstr "" -#: reference/import.rst:589 +#: reference/import.rst:590 msgid "" ":exc:`ImportWarning` is raised if import falls back to ``__package__`` " "instead of :attr:`~importlib.machinery.ModuleSpec.parent`." msgstr "" -#: reference/import.rst:594 +#: reference/import.rst:595 msgid "" "Raise :exc:`DeprecationWarning` instead of :exc:`ImportWarning` when falling " "back to ``__package__``." msgstr "" -#: reference/import.rst:601 +#: reference/import.rst:602 msgid "" "The ``__spec__`` attribute must be set to the module spec that was used when " "importing the module. Setting ``__spec__`` appropriately applies equally to :" @@ -755,18 +758,18 @@ msgid "" "cases `." msgstr "" -#: reference/import.rst:607 +#: reference/import.rst:608 msgid "" "When ``__spec__.parent`` is not set, ``__package__`` is used as a fallback." msgstr "" -#: reference/import.rst:612 +#: reference/import.rst:613 msgid "" "``__spec__.parent`` is used as a fallback when ``__package__`` is not " "defined." msgstr "" -#: reference/import.rst:618 +#: reference/import.rst:619 msgid "" "If the module is a package (either regular or namespace), the module " "object's ``__path__`` attribute must be set. The value must be iterable, " @@ -776,11 +779,11 @@ msgid "" "rules>`." msgstr "" -#: reference/import.rst:625 +#: reference/import.rst:626 msgid "Non-package modules should not have a ``__path__`` attribute." msgstr "" -#: reference/import.rst:630 +#: reference/import.rst:631 msgid "" "``__file__`` is optional (if set, value must be a string). It indicates the " "pathname of the file from which the module was loaded (if loaded from a " @@ -791,7 +794,7 @@ msgid "" "semantic meaning (e.g. a module loaded from a database)." msgstr "" -#: reference/import.rst:639 +#: reference/import.rst:640 msgid "" "If ``__file__`` is set then the ``__cached__`` attribute might also be set, " "which is the path to any compiled version of the code (e.g. byte-compiled " @@ -799,7 +802,7 @@ msgid "" "simply point to where the compiled file would exist (see :pep:`3147`)." msgstr "" -#: reference/import.rst:645 +#: reference/import.rst:646 msgid "" "Note that ``__cached__`` may be set even if ``__file__`` is not set. " "However, that scenario is quite atypical. Ultimately, the loader is what " @@ -809,22 +812,22 @@ msgid "" "be appropriate." msgstr "" -#: reference/import.rst:652 +#: reference/import.rst:653 msgid "" "It is **strongly** recommended that you rely on :attr:`__spec__` instead of " "``__cached__``." msgstr "" -#: reference/import.rst:658 +#: reference/import.rst:659 msgid "module.__path__" msgstr "" -#: reference/import.rst:660 +#: reference/import.rst:661 msgid "" "By definition, if a module has a ``__path__`` attribute, it is a package." msgstr "" -#: reference/import.rst:662 +#: reference/import.rst:663 msgid "" "A package's ``__path__`` attribute is used during imports of its " "subpackages. Within the import machinery, it functions much the same as :" @@ -833,7 +836,7 @@ msgid "" "than :data:`sys.path`." msgstr "" -#: reference/import.rst:668 +#: reference/import.rst:669 msgid "" "``__path__`` must be an iterable of strings, but it may be empty. The same " "rules used for :data:`sys.path` also apply to a package's ``__path__``, and :" @@ -841,7 +844,7 @@ msgid "" "package's ``__path__``." msgstr "" -#: reference/import.rst:673 +#: reference/import.rst:674 msgid "" "A package's ``__init__.py`` file may set or alter the package's ``__path__`` " "attribute, and this was typically the way namespace packages were " @@ -851,18 +854,18 @@ msgid "" "``__path__`` correctly for the namespace package." msgstr "" -#: reference/import.rst:681 +#: reference/import.rst:682 msgid "Module reprs" msgstr "" -#: reference/import.rst:683 +#: reference/import.rst:684 msgid "" "By default, all modules have a usable repr, however depending on the " "attributes set above, and in the module's spec, you can more explicitly " "control the repr of module objects." msgstr "" -#: reference/import.rst:687 +#: reference/import.rst:688 msgid "" "If the module has a spec (``__spec__``), the import machinery will try to " "generate a repr from it. If that fails or there is no spec, the import " @@ -872,45 +875,45 @@ msgid "" "for whatever information is missing." msgstr "" -#: reference/import.rst:694 +#: reference/import.rst:695 msgid "Here are the exact rules used:" msgstr "" -#: reference/import.rst:696 +#: reference/import.rst:697 msgid "" "If the module has a ``__spec__`` attribute, the information in the spec is " "used to generate the repr. The \"name\", \"loader\", \"origin\", and " "\"has_location\" attributes are consulted." msgstr "" -#: reference/import.rst:700 +#: reference/import.rst:701 msgid "" "If the module has a ``__file__`` attribute, this is used as part of the " "module's repr." msgstr "" -#: reference/import.rst:703 +#: reference/import.rst:704 msgid "" "If the module has no ``__file__`` but does have a ``__loader__`` that is not " "``None``, then the loader's repr is used as part of the module's repr." msgstr "" -#: reference/import.rst:706 +#: reference/import.rst:707 msgid "Otherwise, just use the module's ``__name__`` in the repr." msgstr "" -#: reference/import.rst:708 +#: reference/import.rst:709 msgid "" "Use of :meth:`!module_repr`, having been deprecated since Python 3.4, was " "removed in Python 3.12 and is no longer called during the resolution of a " "module's repr." msgstr "" -#: reference/import.rst:716 +#: reference/import.rst:717 msgid "Cached bytecode invalidation" msgstr "" -#: reference/import.rst:718 +#: reference/import.rst:719 msgid "" "Before Python loads cached bytecode from a ``.pyc`` file, it checks whether " "the cache is up-to-date with the source ``.py`` file. By default, Python " @@ -920,7 +923,7 @@ msgid "" "source's metadata." msgstr "" -#: reference/import.rst:725 +#: reference/import.rst:726 msgid "" "Python also supports \"hash-based\" cache files, which store a hash of the " "source file's contents rather than its metadata. There are two variants of " @@ -934,17 +937,17 @@ msgid "" "option:`--check-hash-based-pycs` flag." msgstr "" -#: reference/import.rst:736 +#: reference/import.rst:737 msgid "" "Added hash-based ``.pyc`` files. Previously, Python only supported timestamp-" "based invalidation of bytecode caches." msgstr "" -#: reference/import.rst:742 +#: reference/import.rst:743 msgid "The Path Based Finder" msgstr "" -#: reference/import.rst:747 +#: reference/import.rst:748 msgid "" "As mentioned previously, Python comes with several default meta path " "finders. One of these, called the :term:`path based finder` (:class:" @@ -953,14 +956,14 @@ msgid "" "a location to search for modules." msgstr "" -#: reference/import.rst:753 +#: reference/import.rst:754 msgid "" "The path based finder itself doesn't know how to import anything. Instead, " "it traverses the individual path entries, associating each of them with a " "path entry finder that knows how to handle that particular kind of path." msgstr "" -#: reference/import.rst:757 +#: reference/import.rst:758 msgid "" "The default set of path entry finders implement all the semantics for " "finding modules on the file system, handling special file types such as " @@ -971,14 +974,14 @@ msgid "" "from zipfiles." msgstr "" -#: reference/import.rst:764 +#: reference/import.rst:765 msgid "" "Path entries need not be limited to file system locations. They can refer " "to URLs, database queries, or any other location that can be specified as a " "string." msgstr "" -#: reference/import.rst:768 +#: reference/import.rst:769 msgid "" "The path based finder provides additional hooks and protocols so that you " "can extend and customize the types of searchable path entries. For example, " @@ -989,7 +992,7 @@ msgid "" "from the web." msgstr "" -#: reference/import.rst:776 +#: reference/import.rst:777 msgid "" "A word of warning: this section and the previous both use the term *finder*, " "distinguishing between them by using the terms :term:`meta path finder` and :" @@ -1000,7 +1003,7 @@ msgid "" "process, as keyed off the :data:`sys.meta_path` traversal." msgstr "" -#: reference/import.rst:784 +#: reference/import.rst:785 msgid "" "By contrast, path entry finders are in a sense an implementation detail of " "the path based finder, and in fact, if the path based finder were to be " @@ -1008,11 +1011,11 @@ msgid "" "would be invoked." msgstr "" -#: reference/import.rst:791 +#: reference/import.rst:792 msgid "Path entry finders" msgstr "" -#: reference/import.rst:799 +#: reference/import.rst:800 msgid "" "The :term:`path based finder` is responsible for finding and loading Python " "modules and packages whose location is specified with a string :term:`path " @@ -1020,7 +1023,7 @@ msgid "" "not be limited to this." msgstr "" -#: reference/import.rst:804 +#: reference/import.rst:805 msgid "" "As a meta path finder, the :term:`path based finder` implements the :meth:" "`~importlib.abc.MetaPathFinder.find_spec` protocol previously described, " @@ -1028,7 +1031,7 @@ msgid "" "modules are found and loaded from the :term:`import path`." msgstr "" -#: reference/import.rst:809 +#: reference/import.rst:810 msgid "" "Three variables are used by the :term:`path based finder`, :data:`sys." "path`, :data:`sys.path_hooks` and :data:`sys.path_importer_cache`. The " @@ -1036,10 +1039,10 @@ msgid "" "additional ways that the import machinery can be customized." msgstr "" -#: reference/import.rst:814 +#: reference/import.rst:815 msgid "" ":data:`sys.path` contains a list of strings providing search locations for " -"modules and packages. It is initialized from the :data:`PYTHONPATH` " +"modules and packages. It is initialized from the :envvar:`PYTHONPATH` " "environment variable and various other installation- and implementation-" "specific defaults. Entries in :data:`sys.path` can name directories on the " "file system, zip files, and potentially other \"locations\" (see the :mod:" @@ -1048,7 +1051,7 @@ msgid "" "other data types are ignored." msgstr "" -#: reference/import.rst:823 +#: reference/import.rst:824 msgid "" "The :term:`path based finder` is a :term:`meta path finder`, so the import " "machinery begins the :term:`import path` search by calling the path based " @@ -1060,7 +1063,7 @@ msgid "" "top level import and :data:`sys.path` is used." msgstr "" -#: reference/import.rst:832 +#: reference/import.rst:833 msgid "" "The path based finder iterates over every entry in the search path, and for " "each of these, looks for an appropriate :term:`path entry finder` (:class:" @@ -1076,7 +1079,7 @@ msgid "" "finder to perform the path entry search again." msgstr "" -#: reference/import.rst:845 +#: reference/import.rst:846 msgid "" "If the path entry is not present in the cache, the path based finder " "iterates over every callable in :data:`sys.path_hooks`. Each of the :term:" @@ -1092,7 +1095,7 @@ msgid "" "decode the argument, it should raise :exc:`ImportError`." msgstr "" -#: reference/import.rst:859 +#: reference/import.rst:860 msgid "" "If :data:`sys.path_hooks` iteration ends with no :term:`path entry finder` " "being returned, then the path based finder's :meth:`~importlib.machinery." @@ -1102,7 +1105,7 @@ msgid "" "could not find the module." msgstr "" -#: reference/import.rst:866 +#: reference/import.rst:867 msgid "" "If a :term:`path entry finder` *is* returned by one of the :term:`path entry " "hook` callables on :data:`sys.path_hooks`, then the following protocol is " @@ -1110,7 +1113,7 @@ msgid "" "the module." msgstr "" -#: reference/import.rst:871 +#: reference/import.rst:872 msgid "" "The current working directory -- denoted by an empty string -- is handled " "slightly differently from other entries on :data:`sys.path`. First, if the " @@ -1122,18 +1125,18 @@ msgid "" "and not the empty string." msgstr "" -#: reference/import.rst:881 +#: reference/import.rst:882 msgid "Path entry finder protocol" msgstr "" -#: reference/import.rst:883 +#: reference/import.rst:884 msgid "" "In order to support imports of modules and initialized packages and also to " "contribute portions to namespace packages, path entry finders must implement " "the :meth:`~importlib.abc.PathEntryFinder.find_spec` method." msgstr "" -#: reference/import.rst:887 +#: reference/import.rst:888 msgid "" ":meth:`~importlib.abc.PathEntryFinder.find_spec` takes two arguments: the " "fully qualified name of the module being imported, and the (optional) target " @@ -1141,21 +1144,21 @@ msgid "" "spec will always have \"loader\" set (with one exception)." msgstr "" -#: reference/import.rst:892 +#: reference/import.rst:893 msgid "" "To indicate to the import machinery that the spec represents a namespace :" "term:`portion`, the path entry finder sets ``submodule_search_locations`` to " "a list containing the portion." msgstr "" -#: reference/import.rst:896 +#: reference/import.rst:897 msgid "" ":meth:`~importlib.abc.PathEntryFinder.find_spec` replaced :meth:`!" "find_loader` and :meth:`!find_module`, both of which are now deprecated, but " "will be used if ``find_spec()`` is not defined." msgstr "" -#: reference/import.rst:902 +#: reference/import.rst:903 msgid "" "Older path entry finders may implement one of these two deprecated methods " "instead of ``find_spec()``. The methods are still respected for the sake of " @@ -1163,14 +1166,14 @@ msgid "" "path entry finder, the legacy methods are ignored." msgstr "" -#: reference/import.rst:907 +#: reference/import.rst:908 msgid "" ":meth:`!find_loader` takes one argument, the fully qualified name of the " "module being imported. ``find_loader()`` returns a 2-tuple where the first " "item is the loader and the second item is a namespace :term:`portion`." msgstr "" -#: reference/import.rst:912 +#: reference/import.rst:913 msgid "" "For backwards compatibility with other implementations of the import " "protocol, many path entry finders also support the same, traditional " @@ -1180,7 +1183,7 @@ msgid "" "initial call to the path hook)." msgstr "" -#: reference/import.rst:919 +#: reference/import.rst:920 msgid "" "The ``find_module()`` method on path entry finders is deprecated, as it does " "not allow the path entry finder to contribute portions to namespace " @@ -1189,28 +1192,28 @@ msgid "" "preference to ``find_module()``." msgstr "" -#: reference/import.rst:925 +#: reference/import.rst:926 msgid "" "Calls to :meth:`!find_module` and :meth:`!find_loader` by the import system " "will raise :exc:`ImportWarning`." msgstr "" -#: reference/import.rst:930 +#: reference/import.rst:931 msgid "``find_module()`` and ``find_loader()`` have been removed." msgstr "" -#: reference/import.rst:935 +#: reference/import.rst:936 msgid "Replacing the standard import system" msgstr "" -#: reference/import.rst:937 +#: reference/import.rst:938 msgid "" "The most reliable mechanism for replacing the entire import system is to " "delete the default contents of :data:`sys.meta_path`, replacing them " "entirely with a custom meta path hook." msgstr "" -#: reference/import.rst:941 +#: reference/import.rst:942 msgid "" "If it is acceptable to only alter the behaviour of import statements without " "affecting other APIs that access the import system, then replacing the " @@ -1219,7 +1222,7 @@ msgid "" "statements within that module." msgstr "" -#: reference/import.rst:947 +#: reference/import.rst:948 msgid "" "To selectively prevent the import of some modules from a hook early on the " "meta path (rather than disabling the standard import system entirely), it is " @@ -1229,11 +1232,11 @@ msgid "" "exception terminates it immediately." msgstr "" -#: reference/import.rst:957 +#: reference/import.rst:958 msgid "Package Relative Imports" msgstr "" -#: reference/import.rst:959 +#: reference/import.rst:960 msgid "" "Relative imports use leading dots. A single leading dot indicates a relative " "import, starting with the current package. Two or more leading dots indicate " @@ -1241,30 +1244,30 @@ msgid "" "after the first. For example, given the following package layout::" msgstr "" -#: reference/import.rst:975 +#: reference/import.rst:976 msgid "" "In either ``subpackage1/moduleX.py`` or ``subpackage1/__init__.py``, the " "following are valid relative imports::" msgstr "" -#: reference/import.rst:985 +#: reference/import.rst:986 msgid "" "Absolute imports may use either the ``import <>`` or ``from <> import <>`` " "syntax, but relative imports may only use the second form; the reason for " "this is that::" msgstr "" -#: reference/import.rst:991 +#: reference/import.rst:992 msgid "" "should expose ``XXX.YYY.ZZZ`` as a usable expression, but .moduleY is not a " "valid expression." msgstr "" -#: reference/import.rst:998 +#: reference/import.rst:999 msgid "Special considerations for __main__" msgstr "" -#: reference/import.rst:1000 +#: reference/import.rst:1001 msgid "" "The :mod:`__main__` module is a special case relative to Python's import " "system. As noted :ref:`elsewhere `, the ``__main__`` module is " @@ -1275,17 +1278,17 @@ msgid "" "interpreter is invoked." msgstr "" -#: reference/import.rst:1011 +#: reference/import.rst:1012 msgid "__main__.__spec__" msgstr "" -#: reference/import.rst:1013 +#: reference/import.rst:1014 msgid "" "Depending on how :mod:`__main__` is initialized, ``__main__.__spec__`` gets " "set appropriately or to ``None``." msgstr "" -#: reference/import.rst:1016 +#: reference/import.rst:1017 msgid "" "When Python is started with the :option:`-m` option, ``__spec__`` is set to " "the module spec of the corresponding module or package. ``__spec__`` is also " @@ -1293,30 +1296,30 @@ msgid "" "directory, zipfile or other :data:`sys.path` entry." msgstr "" -#: reference/import.rst:1021 +#: reference/import.rst:1022 msgid "" "In :ref:`the remaining cases ` ``__main__." "__spec__`` is set to ``None``, as the code used to populate the :mod:" "`__main__` does not correspond directly with an importable module:" msgstr "" -#: reference/import.rst:1025 +#: reference/import.rst:1026 msgid "interactive prompt" msgstr "" -#: reference/import.rst:1026 +#: reference/import.rst:1027 msgid ":option:`-c` option" msgstr "" -#: reference/import.rst:1027 +#: reference/import.rst:1028 msgid "running from stdin" msgstr "" -#: reference/import.rst:1028 +#: reference/import.rst:1029 msgid "running directly from a source or bytecode file" msgstr "" -#: reference/import.rst:1030 +#: reference/import.rst:1031 msgid "" "Note that ``__main__.__spec__`` is always ``None`` in the last case, *even " "if* the file could technically be imported directly as a module instead. Use " @@ -1324,7 +1327,7 @@ msgid "" "`__main__`." msgstr "" -#: reference/import.rst:1035 +#: reference/import.rst:1036 msgid "" "Note also that even when ``__main__`` corresponds with an importable module " "and ``__main__.__spec__`` is set accordingly, they're still considered " @@ -1333,11 +1336,11 @@ msgid "" "populate the ``__main__`` namespace, and not during normal import." msgstr "" -#: reference/import.rst:1043 +#: reference/import.rst:1044 msgid "References" msgstr "" -#: reference/import.rst:1045 +#: reference/import.rst:1046 msgid "" "The import machinery has evolved considerably since Python's early days. " "The original `specification for packages ` for " "Python 3.3. :pep:`420` also introduced the :meth:`!find_loader` protocol as " "an alternative to :meth:`!find_module`." msgstr "" -#: reference/import.rst:1057 +#: reference/import.rst:1058 msgid "" ":pep:`366` describes the addition of the ``__package__`` attribute for " "explicit relative imports in main modules." msgstr "" -#: reference/import.rst:1060 +#: reference/import.rst:1061 msgid "" ":pep:`328` introduced absolute and explicit relative imports and initially " "proposed ``__name__`` for semantics :pep:`366` would eventually specify for " "``__package__``." msgstr "" -#: reference/import.rst:1064 +#: reference/import.rst:1065 msgid ":pep:`338` defines executing modules as scripts." msgstr "" -#: reference/import.rst:1066 +#: reference/import.rst:1067 msgid "" ":pep:`451` adds the encapsulation of per-module import state in spec " "objects. It also off-loads most of the boilerplate responsibilities of " @@ -1384,15 +1387,15 @@ msgid "" "finders and loaders." msgstr "" -#: reference/import.rst:1073 +#: reference/import.rst:1074 msgid "Footnotes" msgstr "" -#: reference/import.rst:1074 +#: reference/import.rst:1075 msgid "See :class:`types.ModuleType`." msgstr "" -#: reference/import.rst:1076 +#: reference/import.rst:1077 msgid "" "The importlib implementation avoids using the return value directly. " "Instead, it gets the module object by looking the module name up in :data:" @@ -1473,22 +1476,22 @@ msgstr "" msgid "find_spec" msgstr "" -#: reference/import.rst:744 +#: reference/import.rst:745 msgid "path based finder" msgstr "" -#: reference/import.rst:793 +#: reference/import.rst:794 msgid "sys.path" msgstr "" -#: reference/import.rst:793 +#: reference/import.rst:794 msgid "sys.path_hooks" msgstr "" -#: reference/import.rst:793 +#: reference/import.rst:794 msgid "sys.path_importer_cache" msgstr "" -#: reference/import.rst:793 +#: reference/import.rst:794 msgid "PYTHONPATH" msgstr "" diff --git a/tutorial/appendix.po b/tutorial/appendix.po index cda6c34a3..916e97161 100644 --- a/tutorial/appendix.po +++ b/tutorial/appendix.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 19:05+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: 2022-01-02 19:09+0300\n" "Last-Translator: \n" "Language-Team: TURKISH\n" @@ -30,16 +30,17 @@ msgid "Error Handling" msgstr "Hata İşleme" #: tutorial/appendix.rst:18 +#, fuzzy msgid "" "When an error occurs, the interpreter prints an error message and a stack " "trace. In interactive mode, it then returns to the primary prompt; when " "input came from a file, it exits with a nonzero exit status after printing " "the stack trace. (Exceptions handled by an :keyword:`except` clause in a :" "keyword:`try` statement are not errors in this context.) Some errors are " -"unconditionally fatal and cause an exit with a nonzero exit; this applies to " -"internal inconsistencies and some cases of running out of memory. All error " -"messages are written to the standard error stream; normal output from " -"executed commands is written to standard output." +"unconditionally fatal and cause an exit with a nonzero exit status; this " +"applies to internal inconsistencies and some cases of running out of " +"memory. All error messages are written to the standard error stream; normal " +"output from executed commands is written to standard output." msgstr "" "Bir hata oluştuğunda, yorumlayıcı bir hata iletisi ve yığın izlemesi " "yazdırır. Etkileşimli modda, daha sonra birincil istemi döndürür; bir " diff --git a/tutorial/classes.po b/tutorial/classes.po index 43e73f3f9..1adb4c1fd 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: 2023-02-02 02:32+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -700,16 +700,15 @@ msgstr "" "karşılık gelen fonksiyonu çağırmaya eş değerdir." #: tutorial/classes.rst:389 +#, fuzzy msgid "" -"If you still don't understand how methods work, a look at the implementation " -"can perhaps clarify matters. When a non-data attribute of an instance is " -"referenced, the instance's class is searched. If the name denotes a valid " -"class attribute that is a function object, a method object is created by " -"packing (pointers to) the instance object and the function object just found " -"together in an abstract object: this is the method object. When the method " -"object is called with an argument list, a new argument list is constructed " -"from the instance object and the argument list, and the function object is " -"called with this new argument list." +"In general, methods work as follows. When a non-data attribute of an " +"instance is referenced, the instance's class is searched. If the name " +"denotes a valid class attribute that is a function object, references to " +"both the instance object and the function object are packed into a method " +"object. When the method object is called with an argument list, a new " +"argument list is constructed from the instance object and the argument list, " +"and the function object is called with this new argument list." msgstr "" "Metotların nasıl çalıştığını hala anlamıyorsanız, nasıl uygulandığına bakmak " "belki de sorunları açıklığa kavuşturabilir. Bir örneğin, veri olmayan bir " @@ -721,11 +720,11 @@ msgstr "" "bir argüman listesi oluşturulur ve fonksiyon nesnesi bu yeni argüman " "listesiyle çağrılır." -#: tutorial/classes.rst:403 +#: tutorial/classes.rst:402 msgid "Class and Instance Variables" msgstr "Sınıf ve Örnek Değişkenleri" -#: tutorial/classes.rst:405 +#: tutorial/classes.rst:404 msgid "" "Generally speaking, instance variables are for data unique to each instance " "and class variables are for attributes and methods shared by all instances " @@ -735,7 +734,7 @@ msgstr "" "değişkenleri sınıfın tüm örnekleri tarafından paylaşılan nitelikler ile " "metotlar içindir::" -#: tutorial/classes.rst:427 +#: tutorial/classes.rst:426 msgid "" "As discussed in :ref:`tut-object`, shared data can have possibly surprising " "effects with involving :term:`mutable` objects such as lists and " @@ -749,16 +748,16 @@ msgstr "" "kullanılmamalıdır, çünkü yalnızca tek bir liste tüm *Dog* örnekleri " "tarafından paylaşılacaktır::" -#: tutorial/classes.rst:450 +#: tutorial/classes.rst:449 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:474 +#: tutorial/classes.rst:473 msgid "Random Remarks" msgstr "Rastgele Açıklamalar" -#: tutorial/classes.rst:478 +#: tutorial/classes.rst:477 msgid "" "If the same attribute name occurs in both an instance and in a class, then " "attribute lookup prioritizes the instance::" @@ -766,7 +765,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:493 +#: tutorial/classes.rst:492 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 " @@ -785,7 +784,7 @@ msgstr "" "kontrol edebilir; bu, C ile yazılmış Python uzantıları tarafından " "kullanılabilir.)" -#: tutorial/classes.rst:501 +#: tutorial/classes.rst:500 msgid "" "Clients should use data attributes with care --- clients may mess up " "invariants maintained by the methods by stamping on their data attributes. " @@ -800,7 +799,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:507 +#: tutorial/classes.rst:506 msgid "" "There is no shorthand for referencing data attributes (or other methods!) " "from within methods. I find that this actually increases the readability of " @@ -812,7 +811,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:512 +#: tutorial/classes.rst:511 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 " @@ -828,7 +827,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:518 +#: tutorial/classes.rst:517 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 " @@ -840,7 +839,7 @@ msgstr "" "dahil olması gerekli değildir: sınıftaki yerel bir değişkene fonksiyon " "nesnesi atamak da uygundur. Mesela::" -#: tutorial/classes.rst:535 +#: tutorial/classes.rst:534 #, fuzzy msgid "" "Now ``f``, ``g`` and ``h`` are all attributes of class :class:`!C` that " @@ -854,7 +853,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:540 +#: tutorial/classes.rst:539 msgid "" "Methods may call other methods by using method attributes of the ``self`` " "argument::" @@ -862,7 +861,7 @@ msgstr "" "Metotlar, ``self`` bağımsız değişkeninin metot niteliklerini kullanarak " "diğer metotları çağırabilir::" -#: tutorial/classes.rst:554 +#: tutorial/classes.rst:553 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 " @@ -884,7 +883,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:564 +#: tutorial/classes.rst:563 msgid "" "Each value is an object, and therefore has a *class* (also called its " "*type*). It is stored as ``object.__class__``." @@ -892,11 +891,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:571 +#: tutorial/classes.rst:570 msgid "Inheritance" msgstr "Kalıtım" -#: tutorial/classes.rst:573 +#: tutorial/classes.rst:572 msgid "" "Of course, a language feature would not be worthy of the name \"class\" " "without supporting inheritance. The syntax for a derived class definition " @@ -905,7 +904,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:584 +#: tutorial/classes.rst:583 #, fuzzy msgid "" "The name :class:`!BaseClassName` must be defined in a namespace accessible " @@ -918,7 +917,7 @@ msgstr "" "verilir. Bu, örneğin, temel sınıf başka bir modülde tanımlandığında yararlı " "olabilir::" -#: tutorial/classes.rst:592 +#: tutorial/classes.rst:591 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. " @@ -933,7 +932,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:598 +#: tutorial/classes.rst:597 msgid "" "There's nothing special about instantiation of derived classes: " "``DerivedClassName()`` creates a new instance of the class. Method " @@ -947,7 +946,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:604 +#: tutorial/classes.rst:603 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 " @@ -962,7 +961,7 @@ msgstr "" "çağırabilir. (C++ programcıları için: Python'daki tüm yöntemler etkili bir " "şekilde ``sanal``.)" -#: tutorial/classes.rst:610 +#: tutorial/classes.rst:609 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 " @@ -978,11 +977,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:617 +#: tutorial/classes.rst:616 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:619 +#: tutorial/classes.rst:618 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 " @@ -992,7 +991,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:623 +#: tutorial/classes.rst:622 msgid "" "Use :func:`issubclass` to check class inheritance: ``issubclass(bool, int)`` " "is ``True`` since :class:`bool` is a subclass of :class:`int`. However, " @@ -1004,11 +1003,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:633 +#: tutorial/classes.rst:632 msgid "Multiple Inheritance" msgstr "Çoklu Kalıtım" -#: tutorial/classes.rst:635 +#: tutorial/classes.rst:634 msgid "" "Python supports a form of multiple inheritance as well. A class definition " "with multiple base classes looks like this::" @@ -1016,7 +1015,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:645 +#: tutorial/classes.rst:644 #, fuzzy msgid "" "For most purposes, in the simplest cases, you can think of the search for " @@ -1034,7 +1033,7 @@ msgstr "" "(özyinelemeli olarak) :class:`Base1` temel sınıflarında aranır ve orada " "bulunamazsa :class:`Base2` vb." -#: tutorial/classes.rst:652 +#: tutorial/classes.rst:651 msgid "" "In fact, it is slightly more complex than that; the method resolution order " "changes dynamically to support cooperative calls to :func:`super`. This " @@ -1048,7 +1047,7 @@ msgstr "" "olarak bilinir ve tekli kalıtım dillerinde bulunan süper çağrıdan daha " "güçlüdür." -#: tutorial/classes.rst:658 +#: tutorial/classes.rst:657 msgid "" "Dynamic ordering is necessary because all cases of multiple inheritance " "exhibit one or more diamond relationships (where at least one of the parent " @@ -1077,11 +1076,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:675 +#: tutorial/classes.rst:674 msgid "Private Variables" msgstr "Özel Değişkenler" -#: tutorial/classes.rst:677 +#: tutorial/classes.rst:676 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 " @@ -1097,7 +1096,7 @@ msgstr "" "veya veri üyesi olsun). Bir uygulama detayıdır ve önceden haber " "verilmeksizin değiştirilebilir." -#: tutorial/classes.rst:687 +#: tutorial/classes.rst:686 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 " @@ -1116,7 +1115,7 @@ 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:696 +#: tutorial/classes.rst:695 msgid "" "Name mangling is helpful for letting subclasses override methods without " "breaking intraclass method calls. For example::" @@ -1124,7 +1123,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:718 +#: tutorial/classes.rst:717 msgid "" "The above example would work even if ``MappingSubclass`` were to introduce a " "``__update`` identifier since it is replaced with ``_Mapping__update`` in " @@ -1136,7 +1135,7 @@ msgstr "" "``_MappingSubclass__update`` ile değiştirildiği için ``__update`` " "tanımlayıcısı tanıtsa bile çalışır." -#: tutorial/classes.rst:723 +#: tutorial/classes.rst:722 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 " @@ -1148,7 +1147,7 @@ msgstr "" "hala mümkündür. Bu, hata ayıklayıcı gibi özel durumlarda bile yararlı " "olabilir." -#: tutorial/classes.rst:727 +#: tutorial/classes.rst:726 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 " @@ -1163,11 +1162,11 @@ msgstr "" "benzer. Aynı kısıtlama ``getattr()``, ``setattr()`` ve ``delattr()`` ve " "doğrudan ``__dict__`` atıfta bulunurken de geçerlidir." -#: tutorial/classes.rst:738 +#: tutorial/classes.rst:737 msgid "Odds and Ends" msgstr "Oranlar ve Bitişler" -#: tutorial/classes.rst:740 +#: tutorial/classes.rst:739 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 " @@ -1177,7 +1176,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:760 +#: tutorial/classes.rst:759 #, fuzzy msgid "" "A piece of Python code that expects a particular abstract data type can " @@ -1194,7 +1193,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:772 +#: tutorial/classes.rst:771 #, fuzzy msgid "" ":ref:`Instance method objects ` have attributes, too: :" @@ -1206,11 +1205,11 @@ msgstr "" "örnek nesnedir :meth:`m`, ve ``m.__func__`` yönteme karşılık gelen fonksiyon " "nesnesidir." -#: tutorial/classes.rst:782 +#: tutorial/classes.rst:781 msgid "Iterators" msgstr "Yineleyiciler" -#: tutorial/classes.rst:784 +#: tutorial/classes.rst:783 msgid "" "By now you have probably noticed that most container objects can be looped " "over using a :keyword:`for` statement::" @@ -1218,7 +1217,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:798 +#: tutorial/classes.rst:797 msgid "" "This style of access is clear, concise, and convenient. The use of " "iterators pervades and unifies Python. Behind the scenes, the :keyword:" @@ -1240,7 +1239,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:823 +#: tutorial/classes.rst:822 #, fuzzy msgid "" "Having seen the mechanics behind the iterator protocol, it is easy to add " @@ -1254,11 +1253,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:860 +#: tutorial/classes.rst:859 msgid "Generators" msgstr "Üreteçler" -#: tutorial/classes.rst:862 +#: tutorial/classes.rst:861 msgid "" ":term:`Generators ` are a simple and powerful tool for creating " "iterators. They are written like regular functions but use the :keyword:" @@ -1274,7 +1273,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:883 +#: tutorial/classes.rst:882 #, fuzzy msgid "" "Anything that can be done with generators can also be done with class-based " @@ -1287,7 +1286,7 @@ msgstr "" "şey: :meth:`__iter__` ve :meth:`~generator.__next__` yöntemlerinin otomatik " "olarak oluşturulmasıdır." -#: tutorial/classes.rst:888 +#: tutorial/classes.rst:887 msgid "" "Another key feature is that the local variables and execution state are " "automatically saved between calls. This made the function easier to write " @@ -1299,7 +1298,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:893 +#: tutorial/classes.rst:892 msgid "" "In addition to automatic method creation and saving program state, when " "generators terminate, they automatically raise :exc:`StopIteration`. In " @@ -1311,11 +1310,11 @@ msgstr "" "Birlikte, bu özellikler normal bir işlev yazmaktan daha fazla çaba " "harcamadan yinelemeler oluşturmayı kolaylaştırır." -#: tutorial/classes.rst:902 +#: tutorial/classes.rst:901 msgid "Generator Expressions" msgstr "Üreteç İfadeleri" -#: tutorial/classes.rst:904 +#: tutorial/classes.rst:903 msgid "" "Some simple generators can be coded succinctly as expressions using a syntax " "similar to list comprehensions but with parentheses instead of square " @@ -1331,15 +1330,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:911 +#: tutorial/classes.rst:910 msgid "Examples::" msgstr "Örnekler::" -#: tutorial/classes.rst:932 +#: tutorial/classes.rst:931 msgid "Footnotes" msgstr "Dipnotlar" -#: tutorial/classes.rst:933 +#: tutorial/classes.rst:932 msgid "" "Except for one thing. Module objects have a secret read-only attribute " "called :attr:`~object.__dict__` which returns the dictionary used to " @@ -1364,10 +1363,10 @@ msgstr "Metot Nesneleri" msgid "method" msgstr "" -#: tutorial/classes.rst:684 +#: tutorial/classes.rst:683 msgid "name" msgstr "" -#: tutorial/classes.rst:684 +#: tutorial/classes.rst:683 msgid "mangling" msgstr "" diff --git a/tutorial/datastructures.po b/tutorial/datastructures.po index 22b5b4aeb..ddde42f8c 100644 --- a/tutorial/datastructures.po +++ b/tutorial/datastructures.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 19:05+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: 2022-12-28 21:39+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -73,13 +73,12 @@ msgstr "" "exc:`ValueError` hatası ortaya çıkar." #: tutorial/datastructures.rst:50 +#, fuzzy msgid "" "Remove the item at the given position in the list, and return it. If no " "index is specified, ``a.pop()`` removes and returns the last item in the " -"list. (The square brackets around the *i* in the method signature denote " -"that the parameter is optional, not that you should type square brackets at " -"that position. You will see this notation frequently in the Python Library " -"Reference.)" +"list. It raises an :exc:`IndexError` if the list is empty or the index is " +"outside the list range." msgstr "" "Listede verilen konumdaki öğeyi kaldırır ve geri döndürür. Herhangi bir " "indis belirtilmezse, ``a.pop()`` listedeki son öğeyi kaldırır ve döndürür. " @@ -88,11 +87,11 @@ msgstr "" "yazmanız gerektiğini değil. Bu gösterimi Python Kütüphane Referansında " "sıkça göreceksiniz)" -#: tutorial/datastructures.rst:60 +#: tutorial/datastructures.rst:59 msgid "Remove all items from the list. Equivalent to ``del a[:]``." msgstr "Listeden tüm öğeleri kaldırır. ``del a[:]`` ile eş değerdir." -#: tutorial/datastructures.rst:66 +#: tutorial/datastructures.rst:65 msgid "" "Return zero-based index in the list of the first item whose value is equal " "to *x*. Raises a :exc:`ValueError` if there is no such item." @@ -100,7 +99,7 @@ msgstr "" "Değeri *x*'e eşit olan ilk öğenin listedeki sıfır tabanlı indeksini " "döndürür. Böyle bir öğe yoksa :exc:`ValueError` hatası ortaya çıkar." -#: tutorial/datastructures.rst:69 +#: tutorial/datastructures.rst:68 msgid "" "The optional arguments *start* and *end* are interpreted as in the slice " "notation and are used to limit the search to a particular subsequence of the " @@ -112,11 +111,11 @@ msgstr "" "kullanılır. Döndürülen dizin, *start* bağımsız değişkeni yerine tam dizinin " "başlangıcına göre hesaplanır." -#: tutorial/datastructures.rst:78 +#: tutorial/datastructures.rst:77 msgid "Return the number of times *x* appears in the list." msgstr "Listede *x* öğesinin kaç kez göründüğünü döndürür." -#: tutorial/datastructures.rst:84 +#: tutorial/datastructures.rst:83 msgid "" "Sort the items of the list in place (the arguments can be used for sort " "customization, see :func:`sorted` for their explanation)." @@ -124,19 +123,19 @@ msgstr "" "Listenin öğelerini yerinde sıralayın (argümanlar sıralama özelleştirmesi " "için kullanılabilir, açıklamaları için bkz: :func:`sorted`)." -#: tutorial/datastructures.rst:91 +#: tutorial/datastructures.rst:90 msgid "Reverse the elements of the list in place." msgstr "Listenin öğelerini yerinde ters çevirir." -#: tutorial/datastructures.rst:97 +#: tutorial/datastructures.rst:96 msgid "Return a shallow copy of the list. Equivalent to ``a[:]``." msgstr "Listenin yüzeysel bir kopyasını döndürür. ``a[:]`` ile eş değerdir." -#: tutorial/datastructures.rst:100 +#: tutorial/datastructures.rst:99 msgid "An example that uses most of the list methods::" msgstr "Liste yöntemlerinin çoğunu kullanan bir örnek::" -#: tutorial/datastructures.rst:123 +#: tutorial/datastructures.rst:122 msgid "" "You might have noticed that methods like ``insert``, ``remove`` or ``sort`` " "that only modify the list have no return value printed -- they return the " @@ -148,7 +147,7 @@ msgstr "" "onlar varsayılan ``None`` değerini döndürürler. [#]_ Bu, Python'daki tüm " "değiştirilebilir veri yapıları için bir tasarım ilkesidir." -#: tutorial/datastructures.rst:128 +#: tutorial/datastructures.rst:127 msgid "" "Another thing you might notice is that not all data can be sorted or " "compared. For instance, ``[None, 'hello', 10]`` doesn't sort because " @@ -163,11 +162,11 @@ msgstr "" "olmayan bazı türler de vardır. Örneğin, ``3+4j < 5+7j`` geçerli bir " "karşılaştırma değildir." -#: tutorial/datastructures.rst:139 +#: tutorial/datastructures.rst:138 msgid "Using Lists as Stacks" msgstr "Listeleri Yığın Olarak Kullanma" -#: tutorial/datastructures.rst:144 +#: tutorial/datastructures.rst:143 #, fuzzy msgid "" "The list methods make it very easy to use a list as a stack, where the last " @@ -182,11 +181,11 @@ msgstr "" "üstünden bir öğe almak için, açık bir indeks olmadan :meth:`pop` kullanın. " "Örneğin::" -#: tutorial/datastructures.rst:169 +#: tutorial/datastructures.rst:168 msgid "Using Lists as Queues" msgstr "Listeleri Kuyruk Olarak Kullanma" -#: tutorial/datastructures.rst:173 +#: tutorial/datastructures.rst:172 msgid "" "It is also possible to use a list as a queue, where the first element added " "is the first element retrieved (\"first-in, first-out\"); however, lists are " @@ -200,7 +199,7 @@ msgstr "" "hızlıyken, listenin başından ekleme veya çıkarma yapmak yavaştır (çünkü " "diğer tüm öğelerin bir adım kaydırılması gerekir)." -#: tutorial/datastructures.rst:179 +#: tutorial/datastructures.rst:178 msgid "" "To implement a queue, use :class:`collections.deque` which was designed to " "have fast appends and pops from both ends. For example::" @@ -208,11 +207,11 @@ msgstr "" "Bir kuyruk uygulamak için, her iki uçtan da hızlı ekleme ve çıkarma yapmak " "üzere tasarlanmış :class:`collections.deque` kullanın. Örneğin::" -#: tutorial/datastructures.rst:197 +#: tutorial/datastructures.rst:196 msgid "List Comprehensions" msgstr "Liste Kavramaları" -#: tutorial/datastructures.rst:199 +#: tutorial/datastructures.rst:198 msgid "" "List comprehensions provide a concise way to create lists. Common " "applications are to make new lists where each element is the result of some " @@ -224,13 +223,13 @@ msgstr "" "bir üyesine uygulanan bazı işlemlerin sonucu olduğu yeni listeler oluşturmak " "veya belirli bir koşulu karşılayan öğelerin bir alt dizisini oluşturmaktır." -#: tutorial/datastructures.rst:204 +#: tutorial/datastructures.rst:203 msgid "For example, assume we want to create a list of squares, like::" msgstr "" "Örneğin, aşağıdaki gibi bir kareler listesi oluşturmak istediğimizi " "varsayalım:" -#: tutorial/datastructures.rst:213 +#: tutorial/datastructures.rst:212 msgid "" "Note that this creates (or overwrites) a variable named ``x`` that still " "exists after the loop completes. We can calculate the list of squares " @@ -240,15 +239,15 @@ msgstr "" "değişkenin döngü tamamlandıktan sonra da var olduğuna dikkat edin. Kareler " "listesini, şunu kullanarak herhangi bir yan etki olmadan hesaplayabiliriz:" -#: tutorial/datastructures.rst:219 +#: tutorial/datastructures.rst:218 msgid "or, equivalently::" msgstr "veya aynı şekilde::" -#: tutorial/datastructures.rst:223 +#: tutorial/datastructures.rst:222 msgid "which is more concise and readable." msgstr "ki bu daha kısa ve okunaklıdır." -#: tutorial/datastructures.rst:225 +#: tutorial/datastructures.rst:224 msgid "" "A list comprehension consists of brackets containing an expression followed " "by a :keyword:`!for` clause, then zero or more :keyword:`!for` or :keyword:`!" @@ -264,11 +263,11 @@ msgstr "" "değerlendirilmesiyle elde edilen yeni bir liste olacaktır. Örneğin, " "listcomp, eşit değillerse iki listenin öğelerini birleştirir::" -#: tutorial/datastructures.rst:235 +#: tutorial/datastructures.rst:234 msgid "and it's equivalent to::" msgstr "ve şuna eş değerdir::" -#: tutorial/datastructures.rst:246 +#: tutorial/datastructures.rst:245 msgid "" "Note how the order of the :keyword:`for` and :keyword:`if` statements is the " "same in both these snippets." @@ -276,7 +275,7 @@ msgstr "" "Her iki kod parçacığında da :keyword:`for` ve :keyword:`if` ifadelerinin " "sıralamasının aynı olduğuna dikkat edin." -#: tutorial/datastructures.rst:249 +#: tutorial/datastructures.rst:248 msgid "" "If the expression is a tuple (e.g. the ``(x, y)`` in the previous example), " "it must be parenthesized. ::" @@ -284,18 +283,18 @@ msgstr "" "Eğer ifade bir veri grubu ise (örneğin önceki örnekteki ``(x, y)``), " "parantez içine alınmalıdır. ::" -#: tutorial/datastructures.rst:280 +#: tutorial/datastructures.rst:279 msgid "" "List comprehensions can contain complex expressions and nested functions::" msgstr "" "Liste kavramaları karmaşık ifadeler ve iç içe geçmiş fonksiyonlar " "içerebilir::" -#: tutorial/datastructures.rst:287 +#: tutorial/datastructures.rst:286 msgid "Nested List Comprehensions" msgstr "İç İçe Liste Kavramaları" -#: tutorial/datastructures.rst:289 +#: tutorial/datastructures.rst:288 msgid "" "The initial expression in a list comprehension can be any arbitrary " "expression, including another list comprehension." @@ -303,7 +302,7 @@ msgstr "" "Bir liste kavrayışındaki ilk ifade, başka bir liste kavrayışı da dahil olmak " "üzere rastgele herhangi bir ifade olabilir." -#: tutorial/datastructures.rst:292 +#: tutorial/datastructures.rst:291 msgid "" "Consider the following example of a 3x4 matrix implemented as a list of 3 " "lists of length 4::" @@ -311,11 +310,11 @@ msgstr "" "Uzunluğu 4 olan 3 listeden oluşan bir liste olarak uygulanan 3x4'lük bir " "matrisin aşağıdaki örneğini düşünün::" -#: tutorial/datastructures.rst:301 +#: tutorial/datastructures.rst:300 msgid "The following list comprehension will transpose rows and columns::" msgstr "Aşağıdaki liste kavraması satır ve sütunların yerlerini değiştirir::" -#: tutorial/datastructures.rst:306 +#: tutorial/datastructures.rst:305 msgid "" "As we saw in the previous section, the inner list comprehension is evaluated " "in the context of the :keyword:`for` that follows it, so this example is " @@ -324,11 +323,11 @@ msgstr "" "Önceki bölümde gördüğümüz gibi, iç liste kavrayışı, onu takip eden :keyword:" "`for` bağlamında değerlendirilir, bu nedenle bu örnek şuna eş değerdir::" -#: tutorial/datastructures.rst:317 +#: tutorial/datastructures.rst:316 msgid "which, in turn, is the same as::" msgstr "ki bu da şununla aynıdır::" -#: tutorial/datastructures.rst:330 +#: tutorial/datastructures.rst:329 msgid "" "In the real world, you should prefer built-in functions to complex flow " "statements. The :func:`zip` function would do a great job for this use case::" @@ -337,18 +336,18 @@ msgstr "" "etmelisiniz. Bu kullanım durumu için :func:`zip` fonksiyonu harika bir iş " "çıkaracaktır::" -#: tutorial/datastructures.rst:336 +#: tutorial/datastructures.rst:335 msgid "" "See :ref:`tut-unpacking-arguments` for details on the asterisk in this line." msgstr "" "Bu satırdaki yıldız işaretiyle ilgili ayrıntılar için :ref:`tut-unpacking-" "arguments` bölümüne bakın." -#: tutorial/datastructures.rst:341 +#: tutorial/datastructures.rst:340 msgid "The :keyword:`!del` statement" msgstr ":keyword:`!del` ifadesi" -#: tutorial/datastructures.rst:343 +#: tutorial/datastructures.rst:342 #, fuzzy msgid "" "There is a way to remove an item from a list given its index instead of its " @@ -363,11 +362,11 @@ msgstr "" "kaldırmak veya tüm listeyi temizlemek için de kullanılabilir (bunu daha önce " "dilime boş bir liste atayarak yapmıştık). Örneğin::" -#: tutorial/datastructures.rst:360 +#: tutorial/datastructures.rst:359 msgid ":keyword:`del` can also be used to delete entire variables::" msgstr ":keyword:`del` değişkenlerin tamamını silmek için de kullanılabilir::" -#: tutorial/datastructures.rst:364 +#: tutorial/datastructures.rst:363 msgid "" "Referencing the name ``a`` hereafter is an error (at least until another " "value is assigned to it). We'll find other uses for :keyword:`del` later." @@ -376,11 +375,11 @@ msgstr "" "bir değer atanana kadar). Daha sonra :keyword:`del` için başka kullanımlar " "bulacağız." -#: tutorial/datastructures.rst:371 +#: tutorial/datastructures.rst:370 msgid "Tuples and Sequences" msgstr "Veri Grupları ve Diziler" -#: tutorial/datastructures.rst:373 +#: tutorial/datastructures.rst:372 msgid "" "We saw that lists and strings have many common properties, such as indexing " "and slicing operations. They are two examples of *sequence* data types " @@ -394,12 +393,12 @@ msgstr "" "tipleri de eklenebilir. Ayrıca başka bir standart dizi veri tipi daha " "vardır: *tuple*." -#: tutorial/datastructures.rst:379 +#: tutorial/datastructures.rst:378 msgid "" "A tuple consists of a number of values separated by commas, for instance::" msgstr "Bir veri grubu, virgülle ayrılmış bir dizi değerden oluşur, örneğin::" -#: tutorial/datastructures.rst:401 +#: tutorial/datastructures.rst:400 msgid "" "As you see, on output tuples are always enclosed in parentheses, so that " "nested tuples are interpreted correctly; they may be input with or without " @@ -415,7 +414,7 @@ msgstr "" "grubunun öğelerine tek tek atama yapmak mümkün değildir, ancak listeler gibi " "değiştirilebilir nesneler içeren veri grupları oluşturmak mümkündür." -#: tutorial/datastructures.rst:408 +#: tutorial/datastructures.rst:407 msgid "" "Though tuples may seem similar to lists, they are often used in different " "situations and for different purposes. Tuples are :term:`immutable`, and " @@ -433,7 +432,7 @@ msgstr "" "term:`mutable` 'dır ve elemanları genellikle homojendir ve listenin üzerinde " "yinelenerek erişilir." -#: tutorial/datastructures.rst:416 +#: tutorial/datastructures.rst:415 msgid "" "A special problem is the construction of tuples containing 0 or 1 items: the " "syntax has some extra quirks to accommodate these. Empty tuples are " @@ -447,7 +446,7 @@ msgstr "" "bir değeri virgülle takip ederek oluşturulur (tek bir değeri parantez içine " "almak yeterli değildir). Çirkin olsa da etkilidir. Örneğin::" -#: tutorial/datastructures.rst:431 +#: tutorial/datastructures.rst:430 msgid "" "The statement ``t = 12345, 54321, 'hello!'`` is an example of *tuple " "packing*: the values ``12345``, ``54321`` and ``'hello!'`` are packed " @@ -457,7 +456,7 @@ msgstr "" "``12345``, ``54321`` ve ``'hello!'`` değerleri bir veri grubu içinde bir " "araya getirilmiştir. Bu işlemin tersi de mümkündür::" -#: tutorial/datastructures.rst:437 +#: tutorial/datastructures.rst:436 msgid "" "This is called, appropriately enough, *sequence unpacking* and works for any " "sequence on the right-hand side. Sequence unpacking requires that there are " @@ -471,11 +470,11 @@ msgstr "" "atamanın aslında tuple paketleme ve dizi açmanın bir kombinasyonu olduğunu " "unutmayın." -#: tutorial/datastructures.rst:447 +#: tutorial/datastructures.rst:446 msgid "Sets" msgstr "Kümeler" -#: tutorial/datastructures.rst:449 +#: tutorial/datastructures.rst:448 msgid "" "Python also includes a data type for *sets*. A set is an unordered " "collection with no duplicate elements. Basic uses include membership " @@ -489,7 +488,7 @@ msgstr "" "ayrıca birleşim, kesişim, fark ve simetrik fark gibi matematiksel işlemleri " "de destekler." -#: tutorial/datastructures.rst:454 +#: tutorial/datastructures.rst:453 msgid "" "Curly braces or the :func:`set` function can be used to create sets. Note: " "to create an empty set you have to use ``set()``, not ``{}``; the latter " @@ -501,11 +500,11 @@ msgstr "" "kullanmanız gerekir, çünkü birincisi boş bir sözlük oluşturur, ki bu da bir " "sonraki bölümde tartışacağımız bir veri yapısıdır." -#: tutorial/datastructures.rst:458 +#: tutorial/datastructures.rst:457 msgid "Here is a brief demonstration::" msgstr "İşte kısa bir gösterim::" -#: tutorial/datastructures.rst:483 +#: tutorial/datastructures.rst:482 msgid "" "Similarly to :ref:`list comprehensions `, set comprehensions " "are also supported::" @@ -513,11 +512,11 @@ msgstr "" ":ref:`liste kavramaları ` gibi küme kavramaları da " "desteklenmektedir::" -#: tutorial/datastructures.rst:494 +#: tutorial/datastructures.rst:493 msgid "Dictionaries" msgstr "Sözlükler" -#: tutorial/datastructures.rst:496 +#: tutorial/datastructures.rst:495 #, fuzzy msgid "" "Another useful data type built into Python is the *dictionary* (see :ref:" @@ -543,7 +542,7 @@ msgstr "" "ve :meth:`extend` gibi yöntemler kullanılarak yerinde değiştirilebildiğinden " "listeleri anahtar olarak kullanamazsınız." -#: tutorial/datastructures.rst:507 +#: tutorial/datastructures.rst:506 msgid "" "It is best to think of a dictionary as a set of *key: value* pairs, with the " "requirement that the keys are unique (within one dictionary). A pair of " @@ -558,7 +557,7 @@ msgstr "" "sözlüğe ilk anahtar:değer çiftlerini ekler; sözlükler çıktıda da aynı bu " "şekilde görünürler." -#: tutorial/datastructures.rst:513 +#: tutorial/datastructures.rst:512 msgid "" "The main operations on a dictionary are storing a value with some key and " "extracting the value given the key. It is also possible to delete a key:" @@ -572,7 +571,7 @@ msgstr "" "anahtar kullanarak saklarsanız, bu anahtarla ilişkili eski değer unutulur. " "Var olmayan bir anahtar kullanarak değer çıkarmak bir hatadır." -#: tutorial/datastructures.rst:519 +#: tutorial/datastructures.rst:518 msgid "" "Performing ``list(d)`` on a dictionary returns a list of all the keys used " "in the dictionary, in insertion order (if you want it sorted, just use " @@ -585,11 +584,11 @@ msgstr "" "kullanın). Tek bir anahtarın sözlükte olup olmadığını kontrol etmek için :" "keyword:`in` anahtar sözcüğünü kullanın." -#: tutorial/datastructures.rst:524 +#: tutorial/datastructures.rst:523 msgid "Here is a small example using a dictionary::" msgstr "İşte sözlük kullanılan bir örnek::" -#: tutorial/datastructures.rst:545 +#: tutorial/datastructures.rst:544 msgid "" "The :func:`dict` constructor builds dictionaries directly from sequences of " "key-value pairs::" @@ -597,7 +596,7 @@ msgstr "" ":func:`dict` yapıcısı, doğrudan anahtar-değer dizilerinden sözlükler " "oluşturur::" -#: tutorial/datastructures.rst:551 +#: tutorial/datastructures.rst:550 msgid "" "In addition, dict comprehensions can be used to create dictionaries from " "arbitrary key and value expressions::" @@ -605,7 +604,7 @@ msgstr "" "Buna ek olarak, sözlük kavramaları rastgele anahtar ve değer ifadelerinden " "sözlükler oluşturmak için de kullanılabilir::" -#: tutorial/datastructures.rst:557 +#: tutorial/datastructures.rst:556 msgid "" "When the keys are simple strings, it is sometimes easier to specify pairs " "using keyword arguments::" @@ -613,11 +612,11 @@ msgstr "" "Anahtarlar basit dizgiler olduğunda, anahtar sözcük argümanlarını kullanarak " "çiftleri belirtmek bazen daha kolaydır::" -#: tutorial/datastructures.rst:567 +#: tutorial/datastructures.rst:566 msgid "Looping Techniques" msgstr "Döngü Teknikleri" -#: tutorial/datastructures.rst:569 +#: tutorial/datastructures.rst:568 #, fuzzy msgid "" "When looping through dictionaries, the key and corresponding value can be " @@ -626,7 +625,7 @@ msgstr "" "Sözlükler arasında döngü yaparken, :meth:`items` yöntemi kullanılarak " "anahtar ve karşılık gelen değer aynı anda alınabilir. ::" -#: tutorial/datastructures.rst:579 +#: tutorial/datastructures.rst:578 msgid "" "When looping through a sequence, the position index and corresponding value " "can be retrieved at the same time using the :func:`enumerate` function. ::" @@ -634,7 +633,7 @@ msgstr "" "Bir dizi boyunca döngü yaparken, :func:`enumerate` fonksiyonu kullanılarak " "konum indeksi ve karşılık gelen değer aynı anda alınabilir. ::" -#: tutorial/datastructures.rst:589 +#: tutorial/datastructures.rst:588 msgid "" "To loop over two or more sequences at the same time, the entries can be " "paired with the :func:`zip` function. ::" @@ -642,7 +641,7 @@ msgstr "" "Aynı anda iki veya daha fazla dizi üzerinde döngü yapmak için, girdiler :" "func:`zip` fonksiyonu ile eşleştirilebilir. ::" -#: tutorial/datastructures.rst:601 +#: tutorial/datastructures.rst:600 msgid "" "To loop over a sequence in reverse, first specify the sequence in a forward " "direction and then call the :func:`reversed` function. ::" @@ -650,7 +649,7 @@ msgstr "" "Bir dizi üzerinde ters yönde döngü yapmak için, önce diziyi ileri yönde " "belirtin ve ardından :func:`reversed` fonksiyonunu çağırın. ::" -#: tutorial/datastructures.rst:613 +#: tutorial/datastructures.rst:612 msgid "" "To loop over a sequence in sorted order, use the :func:`sorted` function " "which returns a new sorted list while leaving the source unaltered. ::" @@ -659,7 +658,7 @@ msgstr "" "değiştirmeksizin yeni bir sıralı liste döndüren :func:`sorted` fonksiyonunu " "kullanın. ::" -#: tutorial/datastructures.rst:627 +#: tutorial/datastructures.rst:626 msgid "" "Using :func:`set` on a sequence eliminates duplicate elements. The use of :" "func:`sorted` in combination with :func:`set` over a sequence is an " @@ -671,7 +670,7 @@ msgstr "" "benzersiz öğeleri üzerinde sıralı olarak döngü oluşturmanın deyimsel bir " "yoludur. ::" -#: tutorial/datastructures.rst:640 +#: tutorial/datastructures.rst:639 msgid "" "It is sometimes tempting to change a list while you are looping over it; " "however, it is often simpler and safer to create a new list instead. ::" @@ -680,11 +679,11 @@ msgstr "" "bunun yerine yeni bir liste oluşturmak genellikle daha basit ve daha " "güvenlidir. ::" -#: tutorial/datastructures.rst:657 +#: tutorial/datastructures.rst:656 msgid "More on Conditions" msgstr "Koşullar Üzerine" -#: tutorial/datastructures.rst:659 +#: tutorial/datastructures.rst:658 msgid "" "The conditions used in ``while`` and ``if`` statements can contain any " "operators, not just comparisons." @@ -692,7 +691,7 @@ msgstr "" "``while`` ve ``if`` deyimlerinde kullanılan koşullar sadece karşılaştırma " "değil, herhangi bir operatör içerebilir." -#: tutorial/datastructures.rst:663 +#: tutorial/datastructures.rst:662 msgid "" "The comparison operators ``in`` and ``not in`` are membership tests that " "determine whether a value is in (or not in) a container. The operators " @@ -706,7 +705,7 @@ msgstr "" "operatörleri aynı önceliğe sahiptir, bu öncelik ise tüm sayısal " "operatörlerden daha düşüktür." -#: tutorial/datastructures.rst:669 +#: tutorial/datastructures.rst:668 msgid "" "Comparisons can be chained. For example, ``a < b == c`` tests whether ``a`` " "is less than ``b`` and moreover ``b`` equals ``c``." @@ -715,7 +714,7 @@ msgstr "" "``a`` değerinin ``b`` değerinden küçük olup olmadığını test ederken aynı " "zamanda ``b`` değerinin ``c`` değerine eşit olup olmadığını test eder." -#: tutorial/datastructures.rst:672 +#: tutorial/datastructures.rst:671 msgid "" "Comparisons may be combined using the Boolean operators ``and`` and ``or``, " "and the outcome of a comparison (or of any other Boolean expression) may be " @@ -732,7 +731,7 @@ msgstr "" "veya C``, ``(A ve (B değil)) veya C`` ile eş değerdir. Her zaman olduğu " "gibi, istenen bileşimi ifade etmek için parantezler kullanılabilir." -#: tutorial/datastructures.rst:679 +#: tutorial/datastructures.rst:678 msgid "" "The Boolean operators ``and`` and ``or`` are so-called *short-circuit* " "operators: their arguments are evaluated from left to right, and evaluation " @@ -748,7 +747,7 @@ msgstr "" "Boolean olarak değil de genel bir değer olarak kullanıldığında, kısa devre " "işlecinin dönüş değeri son değerlendirilen bağımsız değişkendir." -#: tutorial/datastructures.rst:686 +#: tutorial/datastructures.rst:685 msgid "" "It is possible to assign the result of a comparison or other Boolean " "expression to a variable. For example, ::" @@ -756,7 +755,7 @@ msgstr "" "Bir değişkene, bir karşılaştırmanın sonucunu veya başka bir Boolean " "ifadesini atamak mümkündür. Örneğin::" -#: tutorial/datastructures.rst:694 +#: tutorial/datastructures.rst:693 msgid "" "Note that in Python, unlike C, assignment inside expressions must be done " "explicitly with the :ref:`walrus operator `` is legal " "provided that the objects have appropriate comparison methods. For example, " @@ -814,11 +813,11 @@ msgstr "" "sahip değillerse, yorumlayıcı rastgele bir sıralama döndürmek yerine :exc:" "`TypeError` hatası verir." -#: tutorial/datastructures.rst:733 +#: tutorial/datastructures.rst:732 msgid "Footnotes" msgstr "Dipnotlar" -#: tutorial/datastructures.rst:734 +#: tutorial/datastructures.rst:733 msgid "" "Other languages may return the mutated object, which allows method chaining, " "such as ``d->insert(\"a\")->remove(\"b\")->sort();``." diff --git a/using/cmdline.po b/using/cmdline.po index 7a557a271..a0f7f33bc 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -477,8 +477,8 @@ msgstr "" msgid "" "Hash randomization is intended to provide protection against a denial-of-" "service caused by carefully chosen inputs that exploit the worst case " -"performance of a dict construction, O(n\\ :sup:`2`) complexity. See http://" -"ocert.org/advisories/ocert-2011-003.html for details." +"performance of a dict construction, *O*\\ (*n*\\ :sup:`2`) complexity. See " +"http://ocert.org/advisories/ocert-2011-003.html for details." msgstr "" #: using/cmdline.rst:375 diff --git a/using/mac.po b/using/mac.po index 0b174788f..6a23a6b78 100644 --- a/using/mac.po +++ b/using/mac.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -32,119 +32,121 @@ msgstr "" msgid "" "Python on a Mac running macOS is in principle very similar to Python on any " "other Unix platform, but there are a number of additional features such as " -"the IDE and the Package Manager that are worth pointing out." +"the integrated development environment (IDE) and the Package Manager that " +"are worth pointing out." msgstr "" -#: using/mac.rst:18 -msgid "Getting and Installing MacPython" +#: using/mac.rst:21 +msgid "Getting and Installing Python" msgstr "" -#: using/mac.rst:20 +#: using/mac.rst:23 msgid "" "macOS used to come with Python 2.7 pre-installed between versions 10.8 and " "`12.3 `_. You are invited to install the most " -"recent version of Python 3 from the Python website (https://www.python." -"org). A current \"universal binary\" build of Python, which runs natively " -"on the Mac's new Intel and legacy PPC CPU's, is available there." +"recent version of Python 3 from the `Python website `__. A current \"universal2 binary\" build of Python, which " +"runs natively on the Mac's new Apple Silicon and legacy Intel processors, is " +"available there." msgstr "" -#: using/mac.rst:27 +#: using/mac.rst:30 msgid "What you get after installing is a number of things:" msgstr "" -#: using/mac.rst:29 +#: using/mac.rst:32 msgid "" -"A :file:`Python 3.12` folder in your :file:`Applications` folder. In here " -"you find IDLE, the development environment that is a standard part of " -"official Python distributions; and PythonLauncher, which handles double-" -"clicking Python scripts from the Finder." +"A |python_version_literal| folder in your :file:`Applications` folder. In " +"here you find IDLE, the development environment that is a standard part of " +"official Python distributions; and :program:`Python Launcher`, which handles " +"double-clicking Python scripts from the Finder." msgstr "" -#: using/mac.rst:34 +#: using/mac.rst:37 msgid "" "A framework :file:`/Library/Frameworks/Python.framework`, which includes the " "Python executable and libraries. The installer adds this location to your " -"shell path. To uninstall MacPython, you can simply remove these three " -"things. A symlink to the Python executable is placed in /usr/local/bin/." +"shell path. To uninstall Python, you can remove these three things. A " +"symlink to the Python executable is placed in :file:`/usr/local/bin/`." msgstr "" -#: using/mac.rst:39 +#: using/mac.rst:44 msgid "" -"The Apple-provided build of Python is installed in :file:`/System/Library/" -"Frameworks/Python.framework` and :file:`/usr/bin/python`, respectively. You " -"should never modify or delete these, as they are Apple-controlled and are " -"used by Apple- or third-party software. Remember that if you choose to " -"install a newer Python version from python.org, you will have two different " -"but functional Python installations on your computer, so it will be " -"important that your paths and usages are consistent with what you want to do." +"On macOS 10.8-12.3, the Apple-provided build of Python is installed in :file:" +"`/System/Library/Frameworks/Python.framework` and :file:`/usr/bin/python`, " +"respectively. You should never modify or delete these, as they are Apple-" +"controlled and are used by Apple- or third-party software. Remember that if " +"you choose to install a newer Python version from python.org, you will have " +"two different but functional Python installations on your computer, so it " +"will be important that your paths and usages are consistent with what you " +"want to do." msgstr "" -#: using/mac.rst:47 +#: using/mac.rst:52 msgid "" -"IDLE includes a help menu that allows you to access Python documentation. If " +"IDLE includes a Help menu that allows you to access Python documentation. If " "you are completely new to Python you should start reading the tutorial " "introduction in that document." msgstr "" -#: using/mac.rst:51 +#: using/mac.rst:56 msgid "" "If you are familiar with Python on other Unix platforms you should read the " "section on running Python scripts from the Unix shell." msgstr "" -#: using/mac.rst:56 +#: using/mac.rst:61 msgid "How to run a Python script" msgstr "" -#: using/mac.rst:58 +#: using/mac.rst:63 msgid "" "Your best way to get started with Python on macOS is through the IDLE " -"integrated development environment, see section :ref:`ide` and use the Help " +"integrated development environment; see section :ref:`ide` and use the Help " "menu when the IDE is running." msgstr "" -#: using/mac.rst:62 +#: using/mac.rst:67 msgid "" "If you want to run Python scripts from the Terminal window command line or " "from the Finder you first need an editor to create your script. macOS comes " -"with a number of standard Unix command line editors, :program:`vim` and :" -"program:`emacs` among them. If you want a more Mac-like editor, :program:" -"`BBEdit` or :program:`TextWrangler` from Bare Bones Software (see http://www." -"barebones.com/products/bbedit/index.html) are good choices, as is :program:" -"`TextMate` (see https://macromates.com/). Other editors include :program:" -"`Gvim` (https://macvim.org/macvim/) and :program:`Aquamacs` (http://aquamacs." -"org/)." +"with a number of standard Unix command line editors, :program:`vim` :program:" +"`nano` among them. If you want a more Mac-like editor, :program:`BBEdit` " +"from Bare Bones Software (see https://www.barebones.com/products/bbedit/" +"index.html) are good choices, as is :program:`TextMate` (see https://" +"macromates.com). Other editors include :program:`MacVim` (https://macvim." +"org) and :program:`Aquamacs` (https://aquamacs.org)." msgstr "" -#: using/mac.rst:72 +#: using/mac.rst:77 msgid "" "To run your script from the Terminal window you must make sure that :file:`/" "usr/local/bin` is in your shell search path." msgstr "" -#: using/mac.rst:75 +#: using/mac.rst:80 msgid "To run your script from the Finder you have two options:" msgstr "" -#: using/mac.rst:77 -msgid "Drag it to :program:`PythonLauncher`" +#: using/mac.rst:82 +msgid "Drag it to :program:`Python Launcher`." msgstr "" -#: using/mac.rst:79 +#: using/mac.rst:84 msgid "" -"Select :program:`PythonLauncher` as the default application to open your " -"script (or any .py script) through the finder Info window and double-click " -"it. :program:`PythonLauncher` has various preferences to control how your " -"script is launched. Option-dragging allows you to change these for one " +"Select :program:`Python Launcher` as the default application to open your " +"script (or any ``.py`` script) through the finder Info window and double-" +"click it. :program:`Python Launcher` has various preferences to control how " +"your script is launched. Option-dragging allows you to change these for one " "invocation, or use its Preferences menu to change things globally." msgstr "" -#: using/mac.rst:89 +#: using/mac.rst:94 msgid "Running scripts with a GUI" msgstr "" -#: using/mac.rst:91 +#: using/mac.rst:96 msgid "" "With older versions of Python, there is one macOS quirk that you need to be " "aware of: programs that talk to the Aqua window manager (in other words, " @@ -152,67 +154,68 @@ msgid "" "`pythonw` instead of :program:`python` to start such scripts." msgstr "" -#: using/mac.rst:96 +#: using/mac.rst:101 msgid "" "With Python 3.9, you can use either :program:`python` or :program:`pythonw`." msgstr "" -#: using/mac.rst:100 +#: using/mac.rst:105 msgid "Configuration" msgstr "" -#: using/mac.rst:102 +#: using/mac.rst:107 msgid "" "Python on macOS honors all standard Unix environment variables such as :" "envvar:`PYTHONPATH`, but setting these variables for programs started from " "the Finder is non-standard as the Finder does not read your :file:`.profile` " "or :file:`.cshrc` at startup. You need to create a file :file:`~/.MacOSX/" -"environment.plist`. See Apple's Technical Document QA1067 for details." +"environment.plist`. See Apple's `Technical Q&A QA1067 `__ for details." msgstr "" -#: using/mac.rst:109 +#: using/mac.rst:115 msgid "" -"For more information on installation Python packages in MacPython, see " -"section :ref:`mac-package-manager`." +"For more information on installation Python packages, see section :ref:`mac-" +"package-manager`." msgstr "" -#: using/mac.rst:116 +#: using/mac.rst:122 msgid "The IDE" msgstr "" -#: using/mac.rst:118 +#: using/mac.rst:124 msgid "" -"MacPython ships with the standard IDLE development environment. A good " -"introduction to using IDLE can be found at http://www.hashcollision.org/hkn/" +"Python ships with the standard IDLE development environment. A good " +"introduction to using IDLE can be found at https://www.hashcollision.org/hkn/" "python/idle_intro/index.html." msgstr "" -#: using/mac.rst:126 +#: using/mac.rst:132 msgid "Installing Additional Python Packages" msgstr "" -#: using/mac.rst:128 +#: using/mac.rst:134 msgid "This section has moved to the `Python Packaging User Guide`_." msgstr "" -#: using/mac.rst:134 -msgid "GUI Programming on the Mac" +#: using/mac.rst:142 +msgid "GUI Programming" msgstr "" -#: using/mac.rst:136 +#: using/mac.rst:144 msgid "" "There are several options for building GUI applications on the Mac with " "Python." msgstr "" -#: using/mac.rst:138 +#: using/mac.rst:146 msgid "" "*PyObjC* is a Python binding to Apple's Objective-C/Cocoa framework, which " "is the foundation of most modern Mac development. Information on PyObjC is " "available from https://pypi.org/project/pyobjc/." msgstr "" -#: using/mac.rst:142 +#: using/mac.rst:150 msgid "" "The standard Python GUI toolkit is :mod:`tkinter`, based on the cross-" "platform Tk toolkit (https://www.tcl.tk). An Aqua-native version of Tk is " @@ -220,49 +223,55 @@ msgid "" "installed from https://www.activestate.com; it can also be built from source." msgstr "" -#: using/mac.rst:147 +#: using/mac.rst:155 msgid "" "*wxPython* is another popular cross-platform GUI toolkit that runs natively " "on macOS. Packages and documentation are available from https://www.wxpython." "org." msgstr "" -#: using/mac.rst:150 +#: using/mac.rst:158 msgid "" "*PyQt* is another popular cross-platform GUI toolkit that runs natively on " "macOS. More information can be found at https://riverbankcomputing.com/" "software/pyqt/intro." msgstr "" -#: using/mac.rst:156 -msgid "Distributing Python Applications on the Mac" +#: using/mac.rst:162 +msgid "" +"*PySide* is another cross-platform Qt-based toolkit. More information at " +"https://www.qt.io/qt-for-python." msgstr "" -#: using/mac.rst:158 +#: using/mac.rst:169 +msgid "Distributing Python Applications" +msgstr "" + +#: using/mac.rst:171 msgid "" "The standard tool for deploying standalone Python applications on the Mac " -"is :program:`py2app`. More information on installing and using py2app can be " -"found at https://pypi.org/project/py2app/." +"is :program:`py2app`. More information on installing and using :program:" +"`py2app` can be found at https://pypi.org/project/py2app/." msgstr "" -#: using/mac.rst:164 +#: using/mac.rst:177 msgid "Other Resources" msgstr "" -#: using/mac.rst:166 +#: using/mac.rst:179 msgid "" -"The MacPython mailing list is an excellent support resource for Python users " -"and developers on the Mac:" +"The Pythonmac-SIG mailing list is an excellent support resource for Python " +"users and developers on the Mac:" msgstr "" -#: using/mac.rst:169 +#: using/mac.rst:182 msgid "https://www.python.org/community/sigs/current/pythonmac-sig/" msgstr "" -#: using/mac.rst:171 +#: using/mac.rst:184 msgid "Another useful resource is the MacPython wiki:" msgstr "" -#: using/mac.rst:173 +#: using/mac.rst:186 msgid "https://wiki.python.org/moin/MacPython" msgstr "" diff --git a/using/windows.po b/using/windows.po index 30b8c875c..e2488bbb0 100644 --- a/using/windows.po +++ b/using/windows.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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -30,12 +30,12 @@ msgstr "" msgid "" "Unlike most Unix systems and services, Windows does not include a system " "supported installation of Python. To make Python available, the CPython team " -"has compiled Windows installers (MSI packages) with every `release `_ for many years. These installers are " -"primarily intended to add a per-user installation of Python, with the core " -"interpreter and library being used by a single user. The installer is also " -"able to install for all users of a single machine, and a separate ZIP file " -"is available for application-local distributions." +"has compiled Windows installers with every `release `_ for many years. These installers are primarily intended to add " +"a per-user installation of Python, with the core interpreter and library " +"being used by a single user. The installer is also able to install for all " +"users of a single machine, and a separate ZIP file is available for " +"application-local distributions." msgstr "" #: using/windows.rst:24 diff --git a/whatsnew/2.0.po b/whatsnew/2.0.po index cadbb29e1..c9cd05780 100644 --- a/whatsnew/2.0.po +++ b/whatsnew/2.0.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -181,7 +181,7 @@ msgid "" "style, and format. PEPs are kept in the Python CVS tree on SourceForge, " "though they're not part of the Python 2.0 distribution, and are also " "available in HTML form from https://peps.python.org/. As of September 2000, " -"there are 25 PEPS, ranging from :pep:`201`, \"Lockstep Iteration\", to PEP " +"there are 25 PEPs, ranging from :pep:`201`, \"Lockstep Iteration\", to PEP " "225, \"Elementwise/Objectwise Operators\"." msgstr "" @@ -1257,15 +1257,15 @@ msgid "" "data being sent over a socket. When compiling Python, you can edit :file:" "`Modules/Setup` to include SSL support, which adds an additional function to " "the :mod:`socket` module: ``socket.ssl(socket, keyfile, certfile)``, which " -"takes a socket object and returns an SSL socket. The :mod:`httplib` and :" -"mod:`urllib` modules were also changed to support ``https://`` URLs, though " -"no one has implemented FTP or SMTP over SSL." +"takes a socket object and returns an SSL socket. The :mod:`httplib ` " +"and :mod:`urllib` modules were also changed to support ``https://`` URLs, " +"though no one has implemented FTP or SMTP over SSL." msgstr "" #: whatsnew/2.0.rst:1046 msgid "" -"The :mod:`httplib` module has been rewritten by Greg Stein to support " -"HTTP/1.1. Backward compatibility with the 1.5 version of :mod:`httplib` is " +"The :mod:`httplib ` module has been rewritten by Greg Stein to support " +"HTTP/1.1. Backward compatibility with the 1.5 version of :mod:`!httplib` is " "provided, though using HTTP/1.1 features such as pipelining will require " "rewriting code to use a different set of interfaces." msgstr "" @@ -1342,9 +1342,9 @@ msgstr "" #: whatsnew/2.0.rst:1098 msgid "" -":mod:`linuxaudiodev`: Support for the :file:`/dev/audio` device on Linux, a " -"twin to the existing :mod:`sunaudiodev` module. (Contributed by Peter Bosch, " -"with fixes by Jeremy Hylton.)" +":mod:`!linuxaudiodev`: Support for the :file:`/dev/audio` device on Linux, a " +"twin to the existing :mod:`!sunaudiodev` module. (Contributed by Peter " +"Bosch, with fixes by Jeremy Hylton.)" msgstr "" #: whatsnew/2.0.rst:1102 @@ -1365,11 +1365,11 @@ msgstr "" #: whatsnew/2.0.rst:1111 msgid "" -":mod:`robotparser`: Parse a :file:`robots.txt` file, which is used for " -"writing web spiders that politely avoid certain areas of a web site. The " -"parser accepts the contents of a :file:`robots.txt` file, builds a set of " -"rules from it, and can then answer questions about the fetchability of a " -"given URL. (Contributed by Skip Montanaro.)" +":mod:`robotparser `: Parse a :file:`robots.txt` file, " +"which is used for writing web spiders that politely avoid certain areas of a " +"web site. The parser accepts the contents of a :file:`robots.txt` file, " +"builds a set of rules from it, and can then answer questions about the " +"fetchability of a given URL. (Contributed by Skip Montanaro.)" msgstr "" #: whatsnew/2.0.rst:1117 @@ -1398,10 +1398,11 @@ msgstr "" #: whatsnew/2.0.rst:1132 msgid "" -":mod:`_winreg`: An interface to the Windows registry. :mod:`_winreg` is an " -"adaptation of functions that have been part of PythonWin since 1995, but has " -"now been added to the core distribution, and enhanced to support Unicode. :" -"mod:`_winreg` was written by Bill Tutt and Mark Hammond." +":mod:`_winreg `: An interface to the Windows registry. :mod:`!" +"_winreg` is an adaptation of functions that have been part of PythonWin " +"since 1995, but has now been added to the core distribution, and enhanced " +"to support Unicode. :mod:`!_winreg` was written by Bill Tutt and Mark " +"Hammond." msgstr "" #: whatsnew/2.0.rst:1137 @@ -1414,8 +1415,8 @@ msgstr "" #: whatsnew/2.0.rst:1142 msgid "" -":mod:`imputil`: A module that provides a simpler way for writing customized " -"import hooks, in comparison to the existing :mod:`ihooks` module. " +":mod:`!imputil`: A module that provides a simpler way for writing customized " +"import hooks, in comparison to the existing :mod:`!ihooks` module. " "(Implemented by Greg Stein, with much discussion on python-dev along the " "way.)" msgstr "" diff --git a/whatsnew/2.2.po b/whatsnew/2.2.po index bacb3f66e..0dbc9c641 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: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -78,10 +78,10 @@ msgid "" "the most significant flaws was that it's impossible to subclass Python types " "implemented in C. In particular, it's not possible to subclass built-in " "types, so you can't just subclass, say, lists in order to add a single " -"useful method to them. The :mod:`UserList` module provides a class that " +"useful method to them. The :mod:`!UserList` module provides a class that " "supports all of the methods of lists and that can be subclassed further, but " "there's lots of C code that expects a regular Python list and won't accept " -"a :class:`UserList` instance." +"a :class:`~collections.UserList` instance." msgstr "" #: whatsnew/2.2.rst:61 @@ -106,9 +106,9 @@ msgstr "" msgid "" "It's also possible to automatically call methods on accessing or setting an " "instance attribute by using a new mechanism called :dfn:`properties`. Many " -"uses of :meth:`__getattr__` can be rewritten to use properties instead, " -"making the resulting code simpler and faster. As a small side benefit, " -"attributes can now have docstrings, too." +"uses of :meth:`~object.__getattr__` can be rewritten to use properties " +"instead, making the resulting code simpler and faster. As a small side " +"benefit, attributes can now have docstrings, too." msgstr "" #: whatsnew/2.2.rst:76 @@ -176,8 +176,8 @@ msgstr "" msgid "" "This means that :keyword:`class` statements that don't have any base classes " "are always classic classes in Python 2.2. (Actually you can also change " -"this by setting a module-level variable named :attr:`__metaclass__` --- see :" -"pep:`253` for the details --- but it's easier to just subclass :class:" +"this by setting a module-level variable named :attr:`!__metaclass__` --- " +"see :pep:`253` for the details --- but it's easier to just subclass :class:" "`object`.)" msgstr "" @@ -192,16 +192,16 @@ msgstr "" #: whatsnew/2.2.rst:136 msgid "" "To make the set of types complete, new type objects such as :func:`dict` " -"and :func:`file` have been added. Here's a more interesting example, adding " -"a :meth:`lock` method to file objects::" +"and :func:`!file` have been added. Here's a more interesting example, " +"adding a :meth:`!lock` method to file objects::" msgstr "" #: whatsnew/2.2.rst:146 msgid "" -"The now-obsolete :mod:`posixfile` module contained a class that emulated all " -"of a file object's methods and also added a :meth:`lock` method, but this " -"class couldn't be passed to internal functions that expected a built-in " -"file, something which is possible with our new :class:`LockableFile`." +"The now-obsolete :mod:`!posixfile` module contained a class that emulated " +"all of a file object's methods and also added a :meth:`!lock` method, but " +"this class couldn't be passed to internal functions that expected a built-in " +"file, something which is possible with our new :class:`!LockableFile`." msgstr "" #: whatsnew/2.2.rst:153 @@ -212,11 +212,11 @@ msgstr "" msgid "" "In previous versions of Python, there was no consistent way to discover what " "attributes and methods were supported by an object. There were some informal " -"conventions, such as defining :attr:`__members__` and :attr:`__methods__` " +"conventions, such as defining :attr:`!__members__` and :attr:`!__methods__` " "attributes that were lists of names, but often the author of an extension " "type or a class wouldn't bother to define them. You could fall back on " "inspecting the :attr:`~object.__dict__` of an object, but when class " -"inheritance or an arbitrary :meth:`__getattr__` hook were in use this could " +"inheritance or an arbitrary :meth:`!__getattr__` hook were in use this could " "still be inaccurate." msgstr "" @@ -240,7 +240,7 @@ msgid ":attr:`~definition.__name__` is the attribute's name." msgstr "" #: whatsnew/2.2.rst:174 -msgid ":attr:`__doc__` is the attribute's docstring." +msgid ":attr:`!__doc__` is the attribute's docstring." msgstr "" #: whatsnew/2.2.rst:176 @@ -266,7 +266,7 @@ msgstr "" #: whatsnew/2.2.rst:189 msgid "" -"For methods, :meth:`descriptor.__get__` returns a temporary object that's " +"For methods, :meth:`!descriptor.__get__` returns a temporary object that's " "callable, and wraps up the instance and the method to be called on it. This " "is also why static methods and class methods are now possible; they have " "descriptors that wrap up just the method, or the method and the class. As a " @@ -278,7 +278,7 @@ msgstr "" #: whatsnew/2.2.rst:207 msgid "" -"The :func:`staticmethod` function takes the function :func:`f`, and returns " +"The :func:`staticmethod` function takes the function :func:`!f`, and returns " "it wrapped up in a descriptor so it can be stored in the class object. You " "might expect there to be special syntax for creating such methods (``def " "static f``, ``defstatic f()``, or something like that) but no such syntax " @@ -297,10 +297,10 @@ msgstr "" #: whatsnew/2.2.rst:235 msgid "" -"Note that a person using the new :func:`eiffelmethod` doesn't have to " +"Note that a person using the new :func:`!eiffelmethod` doesn't have to " "understand anything about descriptors. This is why I think the new features " "don't increase the basic complexity of the language. There will be a few " -"wizards who need to know about it in order to write :func:`eiffelmethod` or " +"wizards who need to know about it in order to write :func:`!eiffelmethod` or " "the ZODB or whatever, but most users will just write code on top of the " "resulting libraries and ignore the implementation details." msgstr "" @@ -320,11 +320,11 @@ msgstr "" msgid "" "The lookup rule for classic classes is simple but not very smart; the base " "classes are searched depth-first, going from left to right. A reference to :" -"meth:`D.save` will search the classes :class:`D`, :class:`B`, and then :" -"class:`A`, where :meth:`save` would be found and returned. :meth:`C.save` " -"would never be found at all. This is bad, because if :class:`C`'s :meth:" -"`save` method is saving some internal state specific to :class:`C`, not " -"calling it will result in that state never getting saved." +"meth:`!D.save` will search the classes :class:`!D`, :class:`!B`, and then :" +"class:`!A`, where :meth:`!save` would be found and returned. :meth:`!C." +"save` would never be found at all. This is bad, because if :class:`!C`'s :" +"meth:`!save` method is saving some internal state specific to :class:`!C`, " +"not calling it will result in that state never getting saved." msgstr "" #: whatsnew/2.2.rst:272 @@ -340,28 +340,29 @@ msgstr "" msgid "" "List all the base classes, following the classic lookup rule and include a " "class multiple times if it's visited repeatedly. In the above example, the " -"list of visited classes is [:class:`D`, :class:`B`, :class:`A`, :class:`C`, :" -"class:`A`]." +"list of visited classes is [:class:`!D`, :class:`!B`, :class:`!A`, :class:`!" +"C`, :class:`!A`]." msgstr "" #: whatsnew/2.2.rst:282 msgid "" "Scan the list for duplicated classes. If any are found, remove all but one " "occurrence, leaving the *last* one in the list. In the above example, the " -"list becomes [:class:`D`, :class:`B`, :class:`C`, :class:`A`] after dropping " -"duplicates." +"list becomes [:class:`!D`, :class:`!B`, :class:`!C`, :class:`!A`] after " +"dropping duplicates." msgstr "" #: whatsnew/2.2.rst:287 msgid "" -"Following this rule, referring to :meth:`D.save` will return :meth:`C.save`, " -"which is the behaviour we're after. This lookup rule is the same as the one " -"followed by Common Lisp. A new built-in function, :func:`super`, provides a " -"way to get at a class's superclasses without having to reimplement Python's " -"algorithm. The most commonly used form will be ``super(class, obj)``, which " -"returns a bound superclass object (not the actual class object). This form " -"will be used in methods to call a method in the superclass; for example, :" -"class:`D`'s :meth:`save` method would look like this::" +"Following this rule, referring to :meth:`!D.save` will return :meth:`!C." +"save`, which is the behaviour we're after. This lookup rule is the same as " +"the one followed by Common Lisp. A new built-in function, :func:`super`, " +"provides a way to get at a class's superclasses without having to " +"reimplement Python's algorithm. The most commonly used form will be " +"``super(class, obj)``, which returns a bound superclass object (not the " +"actual class object). This form will be used in methods to call a method in " +"the superclass; for example, :class:`!D`'s :meth:`!save` method would look " +"like this::" msgstr "" #: whatsnew/2.2.rst:303 @@ -378,7 +379,7 @@ msgstr "" #: whatsnew/2.2.rst:311 msgid "" "A fair number of sophisticated Python classes define hooks for attribute " -"access using :meth:`__getattr__`; most commonly this is done for " +"access using :meth:`~object.__getattr__`; most commonly this is done for " "convenience, to make code more readable by automatically mapping an " "attribute access such as ``obj.parent`` into a method call such as ``obj." "get_parent``. Python 2.2 adds some new ways of controlling attribute access." @@ -396,38 +397,38 @@ msgstr "" msgid "" "New-style classes also support a new method, " "``__getattribute__(attr_name)``. The difference between the two methods is " -"that :meth:`__getattribute__` is *always* called whenever any attribute is " -"accessed, while the old :meth:`__getattr__` is only called if ``foo`` isn't " -"found in the instance's dictionary." +"that :meth:`~object.__getattribute__` is *always* called whenever any " +"attribute is accessed, while the old :meth:`~object.__getattr__` is only " +"called if ``foo`` isn't found in the instance's dictionary." msgstr "" #: whatsnew/2.2.rst:328 msgid "" "However, Python 2.2's support for :dfn:`properties` will often be a simpler " -"way to trap attribute references. Writing a :meth:`__getattr__` method is " +"way to trap attribute references. Writing a :meth:`!__getattr__` method is " "complicated because to avoid recursion you can't use regular attribute " "accesses inside them, and instead have to mess around with the contents of :" -"attr:`~object.__dict__`. :meth:`__getattr__` methods also end up being " -"called by Python when it checks for other methods such as :meth:`__repr__` " -"or :meth:`__coerce__`, and so have to be written with this in mind. Finally, " -"calling a function on every attribute access results in a sizable " -"performance loss." +"attr:`~object.__dict__`. :meth:`~object.__getattr__` methods also end up " +"being called by Python when it checks for other methods such as :meth:" +"`~object.__repr__` or :meth:`!__coerce__`, and so have to be written with " +"this in mind. Finally, calling a function on every attribute access results " +"in a sizable performance loss." msgstr "" #: whatsnew/2.2.rst:337 msgid "" ":class:`property` is a new built-in type that packages up three functions " "that get, set, or delete an attribute, and a docstring. For example, if you " -"want to define a :attr:`size` attribute that's computed, but also settable, " +"want to define a :attr:`!size` attribute that's computed, but also settable, " "you could write::" msgstr "" #: whatsnew/2.2.rst:357 msgid "" -"That is certainly clearer and easier to write than a pair of :meth:" -"`__getattr__`/:meth:`__setattr__` methods that check for the :attr:`size` " +"That is certainly clearer and easier to write than a pair of :meth:`!" +"__getattr__`/:meth:`!__setattr__` methods that check for the :attr:`!size` " "attribute and handle it specially while retrieving all other attributes from " -"the instance's :attr:`~object.__dict__`. Accesses to :attr:`size` are also " +"the instance's :attr:`~object.__dict__`. Accesses to :attr:`!size` are also " "the only ones which have to perform the work of calling a function, so " "references to other attributes run at their usual speed." msgstr "" @@ -534,7 +535,7 @@ msgstr "" #: whatsnew/2.2.rst:450 msgid "" -"Python classes can define an :meth:`__iter__` method, which should create " +"Python classes can define an :meth:`!__iter__` method, which should create " "and return a new iterator for the object; if the object is its own iterator, " "this method can just return ``self``. In particular, iterators will usually " "be their own iterators. Extension types implemented in C can implement a :c:" @@ -556,7 +557,7 @@ msgid "" "In 2.2, Python's :keyword:`for` statement no longer expects a sequence; it " "expects something for which :func:`iter` will return an iterator. For " "backward compatibility and convenience, an iterator is automatically " -"constructed for sequences that don't implement :meth:`__iter__` or a :c:" +"constructed for sequences that don't implement :meth:`!__iter__` or a :c:" "member:`~PyTypeObject.tp_iter` slot, so ``for i in [1,2,3]`` will still " "work. Wherever the Python interpreter loops over a sequence, it's been " "changed to use the iterator protocol. This means you can do things like " @@ -573,8 +574,8 @@ msgstr "" #: whatsnew/2.2.rst:512 msgid "" "That's just the default behaviour. If you want to iterate over keys, " -"values, or key/value pairs, you can explicitly call the :meth:`iterkeys`, :" -"meth:`itervalues`, or :meth:`iteritems` methods to get an appropriate " +"values, or key/value pairs, you can explicitly call the :meth:`!iterkeys`, :" +"meth:`!itervalues`, or :meth:`!iteritems` methods to get an appropriate " "iterator. In a minor related change, the :keyword:`in` operator now works on " "dictionaries, so ``key in dict`` is now equivalent to ``dict.has_key(key)``." msgstr "" @@ -659,7 +660,7 @@ msgid "" msgstr "" #: whatsnew/2.2.rst:583 -msgid "Here's a sample usage of the :func:`generate_ints` generator::" +msgid "Here's a sample usage of the :func:`!generate_ints` generator::" msgstr "" #: whatsnew/2.2.rst:600 @@ -713,11 +714,12 @@ msgstr "" #: whatsnew/2.2.rst:644 msgid "" -"In Icon the :func:`find` function returns the indexes at which the substring " -"\"or\" is found: 3, 23, 33. In the :keyword:`if` statement, ``i`` is first " -"assigned a value of 3, but 3 is less than 5, so the comparison fails, and " -"Icon retries it with the second value of 23. 23 is greater than 5, so the " -"comparison now succeeds, and the code prints the value 23 to the screen." +"In Icon the :func:`!find` function returns the indexes at which the " +"substring \"or\" is found: 3, 23, 33. In the :keyword:`if` statement, ``i`` " +"is first assigned a value of 3, but 3 is less than 5, so the comparison " +"fails, and Icon retries it with the second value of 23. 23 is greater than " +"5, so the comparison now succeeds, and the code prints the value 23 to the " +"screen." msgstr "" #: whatsnew/2.2.rst:650 @@ -751,7 +753,7 @@ msgid "" "In recent versions, the distinction between regular integers, which are 32-" "bit values on most machines, and long integers, which can be of arbitrary " "size, was becoming an annoyance. For example, on platforms that support " -"files larger than ``2**32`` bytes, the :meth:`tell` method of file objects " +"files larger than ``2**32`` bytes, the :meth:`!tell` method of file objects " "has to return a long integer. However, there were various bits of Python " "that expected plain integers and would raise an error if a long integer was " "provided instead. For example, in Python 1.5, only regular integers could " @@ -861,10 +863,10 @@ msgstr "" #: whatsnew/2.2.rst:755 msgid "" -"Classes can define methods called :meth:`__truediv__` and :meth:" -"`__floordiv__` to overload the two division operators. At the C level, " -"there are also slots in the :c:type:`PyNumberMethods` structure so extension " -"types can define the two operators." +"Classes can define methods called :meth:`~object.__truediv__` and :meth:" +"`~object.__floordiv__` to overload the two division operators. At the C " +"level, there are also slots in the :c:type:`PyNumberMethods` structure so " +"extension types can define the two operators." msgstr "" #: whatsnew/2.2.rst:760 @@ -905,9 +907,9 @@ msgstr "" msgid "" "When built to use UCS-4 (a \"wide Python\"), the interpreter can natively " "handle Unicode characters from U+000000 to U+110000, so the range of legal " -"values for the :func:`unichr` function is expanded accordingly. Using an " +"values for the :func:`!unichr` function is expanded accordingly. Using an " "interpreter compiled to use UCS-2 (a \"narrow Python\"), values greater than " -"65535 will still cause :func:`unichr` to raise a :exc:`ValueError` " +"65535 will still cause :func:`!unichr` to raise a :exc:`ValueError` " "exception. This is all described in :pep:`261`, \"Support for 'wide' Unicode " "characters\"; consult it for further details." msgstr "" @@ -915,11 +917,11 @@ msgstr "" #: whatsnew/2.2.rst:794 msgid "" "Another change is simpler to explain. Since their introduction, Unicode " -"strings have supported an :meth:`encode` method to convert the string to a " +"strings have supported an :meth:`!encode` method to convert the string to a " "selected encoding such as UTF-8 or Latin-1. A symmetric " "``decode([*encoding*])`` method has been added to 8-bit strings (though not " -"to Unicode strings) in 2.2. :meth:`decode` assumes that the string is in the " -"specified encoding and decodes it, returning whatever is returned by the " +"to Unicode strings) in 2.2. :meth:`!decode` assumes that the string is in " +"the specified encoding and decodes it, returning whatever is returned by the " "codec." msgstr "" @@ -932,14 +934,14 @@ msgstr "" #: whatsnew/2.2.rst:822 msgid "" -"To convert a class instance to Unicode, a :meth:`__unicode__` method can be " -"defined by a class, analogous to :meth:`__str__`." +"To convert a class instance to Unicode, a :meth:`!__unicode__` method can be " +"defined by a class, analogous to :meth:`!__str__`." msgstr "" #: whatsnew/2.2.rst:825 msgid "" -":meth:`encode`, :meth:`decode`, and :meth:`__unicode__` were implemented by " -"Marc-André Lemburg. The changes to support using UCS-4 internally were " +":meth:`!encode`, :meth:`!decode`, and :meth:`!__unicode__` were implemented " +"by Marc-André Lemburg. The changes to support using UCS-4 internally were " "implemented by Fredrik Lundh and Martin von Löwis." msgstr "" @@ -977,7 +979,7 @@ msgstr "" #: whatsnew/2.2.rst:862 msgid "" -"The function :func:`g` will always raise a :exc:`NameError` exception, " +"The function :func:`!g` will always raise a :exc:`NameError` exception, " "because the binding of the name ``g`` isn't in either its local namespace or " "in the module-level namespace. This isn't much of a problem in practice " "(how often do you recursively define interior functions like this?), but " @@ -1038,7 +1040,7 @@ msgstr "" msgid "" "Line 4 containing the ``exec`` statement is a syntax error, since ``exec`` " "would define a new local variable named ``x`` whose value should be accessed " -"by :func:`g`." +"by :func:`!g`." msgstr "" #: whatsnew/2.2.rst:920 @@ -1062,18 +1064,19 @@ msgstr "" #: whatsnew/2.2.rst:936 msgid "" -"The :mod:`xmlrpclib` module was contributed to the standard library by " -"Fredrik Lundh, providing support for writing XML-RPC clients. XML-RPC is a " -"simple remote procedure call protocol built on top of HTTP and XML. For " -"example, the following snippet retrieves a list of RSS channels from the " -"O'Reilly Network, and then lists the recent headlines for one channel::" +"The :mod:`xmlrpclib ` module was contributed to the standard " +"library by Fredrik Lundh, providing support for writing XML-RPC clients. " +"XML-RPC is a simple remote procedure call protocol built on top of HTTP and " +"XML. For example, the following snippet retrieves a list of RSS channels " +"from the O'Reilly Network, and then lists the recent headlines for one " +"channel::" msgstr "" #: whatsnew/2.2.rst:959 msgid "" -"The :mod:`SimpleXMLRPCServer` module makes it easy to create straightforward " -"XML-RPC servers. See http://xmlrpc.scripting.com/ for more information " -"about XML-RPC." +"The :mod:`SimpleXMLRPCServer ` module makes it easy to create " +"straightforward XML-RPC servers. See http://xmlrpc.scripting.com/ for more " +"information about XML-RPC." msgstr "" #: whatsnew/2.2.rst:962 @@ -1086,10 +1089,11 @@ msgstr "" msgid "" "Several functions that originally returned lengthy tuples now return pseudo-" "sequences that still behave like tuples but also have mnemonic attributes " -"such as memberst_mtime or :attr:`tm_year`. The enhanced functions include :" -"func:`stat`, :func:`fstat`, :func:`statvfs`, and :func:`fstatvfs` in the :" -"mod:`os` module, and :func:`localtime`, :func:`gmtime`, and :func:`strptime` " -"in the :mod:`time` module." +"such as :attr:`!memberst_mtime` or :attr:`~time.struct_time.tm_year`. The " +"enhanced functions include :func:`~os.stat`, :func:`~os.fstat`, :func:`~os." +"statvfs`, and :func:`~os.fstatvfs` in the :mod:`os` module, and :func:`~time." +"localtime`, :func:`~time.gmtime`, and :func:`~time.strptime` in the :mod:" +"`time` module." msgstr "" #: whatsnew/2.2.rst:972 @@ -1143,8 +1147,8 @@ msgid "" "engine underlying the :mod:`re` module. For example, the :func:`re.sub` " "and :func:`re.split` functions have been rewritten in C. Another " "contributed patch speeds up certain Unicode character ranges by a factor of " -"two, and a new :meth:`finditer` method that returns an iterator over all " -"the non-overlapping matches in a given string. (SRE is maintained by " +"two, and a new :meth:`~re.finditer` method that returns an iterator over " +"all the non-overlapping matches in a given string. (SRE is maintained by " "Fredrik Lundh. The BIGCHARSET patch was contributed by Martin von Löwis.)" msgstr "" @@ -1166,19 +1170,19 @@ msgstr "" #: whatsnew/2.2.rst:1015 msgid "" -"The :mod:`rfc822` module's parsing of email addresses is now compliant with :" -"rfc:`2822`, an update to :rfc:`822`. (The module's name is *not* going to " -"be changed to ``rfc2822``.) A new package, :mod:`email`, has also been " -"added for parsing and generating e-mail messages. (Contributed by Barry " -"Warsaw, and arising out of his work on Mailman.)" +"The :mod:`!rfc822` module's parsing of email addresses is now compliant " +"with :rfc:`2822`, an update to :rfc:`822`. (The module's name is *not* " +"going to be changed to ``rfc2822``.) A new package, :mod:`email`, has also " +"been added for parsing and generating e-mail messages. (Contributed by " +"Barry Warsaw, and arising out of his work on Mailman.)" msgstr "" #: whatsnew/2.2.rst:1021 msgid "" -"The :mod:`difflib` module now contains a new :class:`Differ` class for " +"The :mod:`difflib` module now contains a new :class:`!Differ` class for " "producing human-readable lists of changes (a \"delta\") between two " -"sequences of lines of text. There are also two generator functions, :func:" -"`ndiff` and :func:`restore`, which respectively return a delta from two " +"sequences of lines of text. There are also two generator functions, :func:`!" +"ndiff` and :func:`!restore`, which respectively return a delta from two " "sequences, or one of the original sequences from a delta. (Grunt work " "contributed by David Goodger, from ndiff.py code by Tim Peters who then did " "the generatorization.)" @@ -1186,28 +1190,28 @@ msgstr "" #: whatsnew/2.2.rst:1028 msgid "" -"New constants :const:`ascii_letters`, :const:`ascii_lowercase`, and :const:" -"`ascii_uppercase` were added to the :mod:`string` module. There were " -"several modules in the standard library that used :const:`string.letters` to " -"mean the ranges A-Za-z, but that assumption is incorrect when locales are in " -"use, because :const:`string.letters` varies depending on the set of legal " -"characters defined by the current locale. The buggy modules have all been " -"fixed to use :const:`ascii_letters` instead. (Reported by an unknown person; " -"fixed by Fred L. Drake, Jr.)" +"New constants :const:`!ascii_letters`, :const:`!ascii_lowercase`, and :const:" +"`!ascii_uppercase` were added to the :mod:`string` module. There were " +"several modules in the standard library that used :const:`!string.letters` " +"to mean the ranges A-Za-z, but that assumption is incorrect when locales are " +"in use, because :const:`!string.letters` varies depending on the set of " +"legal characters defined by the current locale. The buggy modules have all " +"been fixed to use :const:`!ascii_letters` instead. (Reported by an unknown " +"person; fixed by Fred L. Drake, Jr.)" msgstr "" #: whatsnew/2.2.rst:1037 msgid "" "The :mod:`mimetypes` module now makes it easier to use alternative MIME-type " -"databases by the addition of a :class:`MimeTypes` class, which takes a list " -"of filenames to be parsed. (Contributed by Fred L. Drake, Jr.)" +"databases by the addition of a :class:`~mimetypes.MimeTypes` class, which " +"takes a list of filenames to be parsed. (Contributed by Fred L. Drake, Jr.)" msgstr "" #: whatsnew/2.2.rst:1041 msgid "" -"A :class:`Timer` class was added to the :mod:`threading` module that allows " -"scheduling an activity to happen at some future time. (Contributed by " -"Itamar Shtull-Trauring.)" +"A :class:`~threading.Timer` class was added to the :mod:`threading` module " +"that allows scheduling an activity to happen at some future time. " +"(Contributed by Itamar Shtull-Trauring.)" msgstr "" #: whatsnew/2.2.rst:1049 @@ -1326,9 +1330,9 @@ msgid "" "Two new wrapper functions, :c:func:`PyOS_snprintf` and :c:func:" "`PyOS_vsnprintf` were added to provide cross-platform implementations for " "the relatively new :c:func:`snprintf` and :c:func:`vsnprintf` C lib APIs. In " -"contrast to the standard :c:func:`sprintf` and :c:func:`vsprintf` functions, " -"the Python versions check the bounds of the buffer used to protect against " -"buffer overruns. (Contributed by M.-A. Lemburg.)" +"contrast to the standard :c:func:`sprintf` and :c:func:`!vsprintf` " +"functions, the Python versions check the bounds of the buffer used to " +"protect against buffer overruns. (Contributed by M.-A. Lemburg.)" msgstr "" #: whatsnew/2.2.rst:1121 @@ -1450,14 +1454,15 @@ msgstr "" #: whatsnew/2.2.rst:1215 msgid "" -"Some features of the object returned by the :func:`xrange` function are now " +"Some features of the object returned by the :func:`!xrange` function are now " "deprecated, and trigger warnings when they're accessed; they'll disappear in " -"Python 2.3. :class:`xrange` objects tried to pretend they were full sequence " -"types by supporting slicing, sequence multiplication, and the :keyword:`in` " -"operator, but these features were rarely used and therefore buggy. The :" -"meth:`tolist` method and the :attr:`start`, :attr:`stop`, and :attr:`step` " -"attributes are also being deprecated. At the C level, the fourth argument " -"to the :c:func:`!PyRange_New` function, ``repeat``, has also been deprecated." +"Python 2.3. :class:`!xrange` objects tried to pretend they were full " +"sequence types by supporting slicing, sequence multiplication, and the :" +"keyword:`in` operator, but these features were rarely used and therefore " +"buggy. The :meth:`!tolist` method and the :attr:`!start`, :attr:`!stop`, " +"and :attr:`!step` attributes are also being deprecated. At the C level, the " +"fourth argument to the :c:func:`!PyRange_New` function, ``repeat``, has also " +"been deprecated." msgstr "" #: whatsnew/2.2.rst:1224 diff --git a/whatsnew/2.3.po b/whatsnew/2.3.po index 53b6e5a7a..26869b097 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1265,9 +1265,9 @@ msgstr "" msgid "" "Multiplication of large long integers is now much faster thanks to an " "implementation of Karatsuba multiplication, an algorithm that scales better " -"than the O(n\\*n) required for the grade-school multiplication algorithm. " -"(Original patch by Christopher A. Craig, and significantly reworked by Tim " -"Peters.)" +"than the *O*\\ (*n*\\ :sup:`2`) required for the grade-school multiplication " +"algorithm. (Original patch by Christopher A. Craig, and significantly " +"reworked by Tim Peters.)" msgstr "" #: whatsnew/2.3.rst:1202 @@ -1424,8 +1424,9 @@ msgid "" "partially sorted order such that, for every index *k*, ``heap[k] <= " "heap[2*k+1]`` and ``heap[k] <= heap[2*k+2]``. This makes it quick to remove " "the smallest item, and inserting a new item while maintaining the heap " -"property is O(lg n). (See https://xlinux.nist.gov/dads//HTML/priorityque." -"html for more information about the priority queue data structure.)" +"property is *O*\\ (log *n*). (See https://xlinux.nist.gov/dads//HTML/" +"priorityque.html for more information about the priority queue data " +"structure.)" msgstr "" #: whatsnew/2.3.rst:1314 diff --git a/whatsnew/2.4.po b/whatsnew/2.4.po index b699f5790..a41ed7edc 100644 --- a/whatsnew/2.4.po +++ b/whatsnew/2.4.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -407,7 +407,7 @@ msgid "" "offering different features and different levels of complexity. ``os." "system(command)`` is easy to use, but slow (it runs a shell process which " "executes the command) and dangerous (you have to be careful about escaping " -"the shell's metacharacters). The :mod:`popen2` module offers classes that " +"the shell's metacharacters). The :mod:`!popen2` module offers classes that " "can capture standard output and standard error from the subprocess, but the " "naming is confusing. The :mod:`subprocess` module cleans this up, " "providing a unified interface that offers all the features you might need." @@ -415,9 +415,9 @@ msgstr "" #: whatsnew/2.4.rst:395 msgid "" -"Instead of :mod:`popen2`'s collection of classes, :mod:`subprocess` contains " -"a single class called :class:`Popen` whose constructor supports a number of " -"different keyword arguments. ::" +"Instead of :mod:`!popen2`'s collection of classes, :mod:`subprocess` " +"contains a single class called :class:`subprocess.Popen` whose constructor " +"supports a number of different keyword arguments. ::" msgstr "" #: whatsnew/2.4.rst:405 @@ -1251,9 +1251,9 @@ msgstr "" #: whatsnew/2.4.rst:1084 msgid "" -"The :mod:`httplib` module now contains constants for HTTP status codes " -"defined in various HTTP-related RFC documents. Constants have names such " -"as :const:`OK`, :const:`CREATED`, :const:`CONTINUE`, and :const:" +"The :mod:`httplib ` module now contains constants for HTTP status " +"codes defined in various HTTP-related RFC documents. Constants have names " +"such as :const:`OK`, :const:`CREATED`, :const:`CONTINUE`, and :const:" "`MOVED_PERMANENTLY`; use pydoc to get a full list. (Contributed by Andrew " "Eland.)" msgstr "" @@ -1379,11 +1379,12 @@ msgstr "" #: whatsnew/2.4.rst:1221 msgid "" -"The long-term plan is to deprecate the :mod:`rfc822` module in some future " +"The long-term plan is to deprecate the :mod:`!rfc822` module in some future " "Python release in favor of the :mod:`email` package. To this end, the :func:" -"`email.Utils.formatdate` function has been changed to make it usable as a " -"replacement for :func:`rfc822.formatdate`. You may want to write new e-mail " -"processing code with this in mind. (Change implemented by Anthony Baxter.)" +"`email.Utils.formatdate ` function has been changed " +"to make it usable as a replacement for :func:`!rfc822.formatdate`. You may " +"want to write new e-mail processing code with this in mind. (Change " +"implemented by Anthony Baxter.)" msgstr "" #: whatsnew/2.4.rst:1227 @@ -1517,9 +1518,9 @@ msgstr "" #: whatsnew/2.4.rst:1311 msgid "" -"The :mod:`xmlrpclib` module now supports a multi-call extension for " -"transmitting multiple XML-RPC calls in a single HTTP operation. (Contributed " -"by Brian Quinlan.)" +"The :mod:`xmlrpclib ` module now supports a multi-call " +"extension for transmitting multiple XML-RPC calls in a single HTTP " +"operation. (Contributed by Brian Quinlan.)" msgstr "" #: whatsnew/2.4.rst:1315 @@ -1534,12 +1535,12 @@ msgstr "" #: whatsnew/2.4.rst:1326 msgid "" -"The :mod:`cookielib` library supports client-side handling for HTTP cookies, " -"mirroring the :mod:`Cookie` module's server-side cookie support. Cookies are " -"stored in cookie jars; the library transparently stores cookies offered by " -"the web server in the cookie jar, and fetches the cookie from the jar when " -"connecting to the server. As in web browsers, policy objects control whether " -"cookies are accepted or not." +"The :mod:`cookielib ` library supports client-side handling " +"for HTTP cookies, mirroring the :mod:`Cookie ` module's server-" +"side cookie support. Cookies are stored in cookie jars; the library " +"transparently stores cookies offered by the web server in the cookie jar, " +"and fetches the cookie from the jar when connecting to the server. As in web " +"browsers, policy objects control whether cookies are accepted or not." msgstr "" #: whatsnew/2.4.rst:1333 @@ -1552,8 +1553,9 @@ msgstr "" #: whatsnew/2.4.rst:1338 msgid "" -":mod:`urllib2` has been changed to interact with :mod:`cookielib`: :class:" -"`HTTPCookieProcessor` manages a cookie jar that is used when accessing URLs." +":mod:`urllib2 ` has been changed to interact with :mod:" +"`cookielib `: :class:`HTTPCookieProcessor` manages a cookie " +"jar that is used when accessing URLs." msgstr "" #: whatsnew/2.4.rst:1342 @@ -1749,7 +1751,7 @@ msgstr "" #: whatsnew/2.4.rst:1532 msgid "" -":func:`dircache.listdir` now passes exceptions to the caller instead of " +":func:`!dircache.listdir` now passes exceptions to the caller instead of " "returning empty lists." msgstr "" diff --git a/whatsnew/2.5.po b/whatsnew/2.5.po index 4733e011b..a333d6d81 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1725,10 +1725,10 @@ msgstr "" #: whatsnew/2.5.rst:1481 msgid "" -"The :mod:`pickle` and :mod:`cPickle` modules no longer accept a return value " -"of ``None`` from the :meth:`__reduce__` method; the method must return a " -"tuple of arguments instead. The ability to return ``None`` was deprecated " -"in Python 2.4, so this completes the removal of the feature." +"The :mod:`pickle` and :mod:`!cPickle` modules no longer accept a return " +"value of ``None`` from the :meth:`~object.__reduce__` method; the method " +"must return a tuple of arguments instead. The ability to return ``None`` " +"was deprecated in Python 2.4, so this completes the removal of the feature." msgstr "" #: whatsnew/2.5.rst:1486 @@ -1790,11 +1790,11 @@ msgstr "" #: whatsnew/2.5.rst:1522 msgid "" -"The :mod:`SimpleXMLRPCServer` and :mod:`DocXMLRPCServer` classes now have " -"a :attr:`rpc_paths` attribute that constrains XML-RPC operations to a " -"limited set of URL paths; the default is to allow only ``'/'`` and ``'/" -"RPC2'``. Setting :attr:`rpc_paths` to ``None`` or an empty tuple disables " -"this path checking." +"The :mod:`SimpleXMLRPCServer ` and :mod:`DocXMLRPCServer " +"` classes now have a :attr:`rpc_paths` attribute that " +"constrains XML-RPC operations to a limited set of URL paths; the default is " +"to allow only ``'/'`` and ``'/RPC2'``. Setting :attr:`rpc_paths` to " +"``None`` or an empty tuple disables this path checking." msgstr "" #: whatsnew/2.5.rst:1529 @@ -1952,10 +1952,11 @@ msgstr "" #: whatsnew/2.5.rst:1653 msgid "" -"The :mod:`xmlrpclib` module now supports returning :class:`~datetime." -"datetime` objects for the XML-RPC date type. Supply ``use_datetime=True`` " -"to the :func:`loads` function or the :class:`Unmarshaller` class to enable " -"this feature. (Contributed by Skip Montanaro.)" +"The :mod:`xmlrpclib ` module now supports returning :class:" +"`~datetime.datetime` objects for the XML-RPC date type. Supply " +"``use_datetime=True`` to the :func:`~xmlrpc.client.loads` function or the :" +"class:`!Unmarshaller` class to enable this feature. (Contributed by Skip " +"Montanaro.)" msgstr "" #: whatsnew/2.5.rst:1660 @@ -1981,7 +1982,7 @@ msgstr "" msgid "" "The :mod:`ctypes` package, written by Thomas Heller, has been added to the " "standard library. :mod:`ctypes` lets you call arbitrary functions in " -"shared libraries or DLLs. Long-time users may remember the :mod:`dl` " +"shared libraries or DLLs. Long-time users may remember the :mod:`!dl` " "module, which provides functions for loading shared libraries and calling " "functions in them. The :mod:`ctypes` package is much fancier." msgstr "" @@ -2267,15 +2268,15 @@ msgstr "" #: whatsnew/2.5.rst:1879 msgid "" "A new :mod:`hashlib` module, written by Gregory P. Smith, has been added to " -"replace the :mod:`md5` and :mod:`sha` modules. :mod:`hashlib` adds support " -"for additional secure hashes (SHA-224, SHA-256, SHA-384, and SHA-512). When " -"available, the module uses OpenSSL for fast platform optimized " -"implementations of algorithms." +"replace the :mod:`!md5` and :mod:`!sha` modules. :mod:`hashlib` adds " +"support for additional secure hashes (SHA-224, SHA-256, SHA-384, and " +"SHA-512). When available, the module uses OpenSSL for fast platform " +"optimized implementations of algorithms." msgstr "" #: whatsnew/2.5.rst:1885 msgid "" -"The old :mod:`md5` and :mod:`sha` modules still exist as wrappers around " +"The old :mod:`!md5` and :mod:`!sha` modules still exist as wrappers around " "hashlib to preserve backwards compatibility. The new module's interface is " "very close to that of the old modules, but not identical. The most " "significant difference is that the constructor functions for creating new " @@ -2692,19 +2693,19 @@ msgstr "" #: whatsnew/2.5.rst:2256 msgid "" -"Library: The :mod:`pickle` and :mod:`cPickle` modules no longer accept a " -"return value of ``None`` from the :meth:`__reduce__` method; the method must " -"return a tuple of arguments instead. The modules also no longer accept the " -"deprecated *bin* keyword parameter." +"Library: The :mod:`pickle` and :mod:`!cPickle` modules no longer accept a " +"return value of ``None`` from the :meth:`~object.__reduce__` method; the " +"method must return a tuple of arguments instead. The modules also no longer " +"accept the deprecated *bin* keyword parameter." msgstr "" #: whatsnew/2.5.rst:2261 msgid "" -"Library: The :mod:`SimpleXMLRPCServer` and :mod:`DocXMLRPCServer` classes " -"now have a :attr:`rpc_paths` attribute that constrains XML-RPC operations to " -"a limited set of URL paths; the default is to allow only ``'/'`` and ``'/" -"RPC2'``. Setting :attr:`rpc_paths` to ``None`` or an empty tuple disables " -"this path checking." +"Library: The :mod:`SimpleXMLRPCServer ` and :mod:" +"`DocXMLRPCServer ` classes now have a :attr:`rpc_paths` " +"attribute that constrains XML-RPC operations to a limited set of URL paths; " +"the default is to allow only ``'/'`` and ``'/RPC2'``. Setting :attr:" +"`rpc_paths` to ``None`` or an empty tuple disables this path checking." msgstr "" #: whatsnew/2.5.rst:2267 diff --git a/whatsnew/2.6.po b/whatsnew/2.6.po index 7ab902c87..94a3ff55e 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-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -24,17 +24,17 @@ msgstr "" msgid "Author" msgstr "" -#: whatsnew/2.6.rst:9 +#: whatsnew/2.6.rst:7 msgid "A.M. Kuchling (amk at amk.ca)" msgstr "" -#: whatsnew/2.6.rst:52 +#: whatsnew/2.6.rst:50 msgid "" "This article explains the new features in Python 2.6, released on October 1, " "2008. The release schedule is described in :pep:`361`." msgstr "" -#: whatsnew/2.6.rst:55 +#: whatsnew/2.6.rst:53 msgid "" "The major theme of Python 2.6 is preparing the migration path to Python 3.0, " "a major redesign of the language. Whenever possible, Python 2.6 " @@ -45,14 +45,14 @@ msgid "" "`!-3` switch to warn about usages that will become unsupported in 3.0." msgstr "" -#: whatsnew/2.6.rst:64 +#: whatsnew/2.6.rst:62 msgid "" "Some significant new packages have been added to the standard library, such " "as the :mod:`multiprocessing` and :mod:`json` modules, but there aren't many " "new features that aren't related to Python 3.0 in some way." msgstr "" -#: whatsnew/2.6.rst:69 +#: whatsnew/2.6.rst:67 msgid "" "Python 2.6 also sees a number of improvements and bugfixes throughout the " "source. A search through the change logs finds there were 259 patches " @@ -60,7 +60,7 @@ msgid "" "likely to be underestimates." msgstr "" -#: whatsnew/2.6.rst:74 +#: whatsnew/2.6.rst:72 msgid "" "This article doesn't attempt to provide a complete specification of the new " "features, but instead provides a convenient overview. For full details, you " @@ -70,18 +70,18 @@ msgid "" "the bug/patch item for each change." msgstr "" -#: whatsnew/2.6.rst:90 +#: whatsnew/2.6.rst:88 msgid "Python 3.0" msgstr "" -#: whatsnew/2.6.rst:92 +#: whatsnew/2.6.rst:90 msgid "" "The development cycle for Python versions 2.6 and 3.0 was synchronized, with " "the alpha and beta releases for both versions being made on the same days. " "The development of 3.0 has influenced many features in 2.6." msgstr "" -#: whatsnew/2.6.rst:97 +#: whatsnew/2.6.rst:95 msgid "" "Python 3.0 is a far-ranging redesign of Python that breaks compatibility " "with the 2.x series. This means that existing Python code will need some " @@ -92,22 +92,22 @@ msgid "" "derived features are:" msgstr "" -#: whatsnew/2.6.rst:106 +#: whatsnew/2.6.rst:104 msgid "" "A :meth:`__complex__` method for converting objects to a complex number." msgstr "" -#: whatsnew/2.6.rst:107 +#: whatsnew/2.6.rst:105 msgid "Alternate syntax for catching exceptions: ``except TypeError as exc``." msgstr "" -#: whatsnew/2.6.rst:108 +#: whatsnew/2.6.rst:106 msgid "" "The addition of :func:`functools.reduce` as a synonym for the built-in :func:" "`reduce` function." msgstr "" -#: whatsnew/2.6.rst:111 +#: whatsnew/2.6.rst:109 msgid "" "Python 3.0 adds several new built-in functions and changes the semantics of " "some existing builtins. Functions that are new in 3.0 such as :func:`bin` " @@ -117,7 +117,7 @@ msgid "" "future_builtins import hex, map`` as necessary." msgstr "" -#: whatsnew/2.6.rst:119 +#: whatsnew/2.6.rst:117 msgid "" "A new command-line switch, :option:`!-3`, enables warnings about features " "that will be removed in Python 3.0. You can run code with this switch to " @@ -126,19 +126,19 @@ msgid "" "py3kwarning`, and to C extension code as :c:data:`Py_Py3kWarningFlag`." msgstr "" -#: whatsnew/2.6.rst:128 +#: whatsnew/2.6.rst:126 msgid "" "The 3\\ *xxx* series of PEPs, which contains proposals for Python 3.0. :pep:" "`3000` describes the development process for Python 3.0. Start with :pep:" "`3100` that describes the general goals for Python 3.0, and then explore the " -"higher-numbered PEPS that propose specific features." +"higher-numbered PEPs that propose specific features." msgstr "" -#: whatsnew/2.6.rst:136 +#: whatsnew/2.6.rst:134 msgid "Changes to the Development Process" msgstr "" -#: whatsnew/2.6.rst:138 +#: whatsnew/2.6.rst:136 msgid "" "While 2.6 was being developed, the Python development process underwent two " "significant changes: we switched from SourceForge's issue tracker to a " @@ -146,11 +146,11 @@ msgid "" "LaTeX to reStructuredText." msgstr "" -#: whatsnew/2.6.rst:145 +#: whatsnew/2.6.rst:143 msgid "New Issue Tracker: Roundup" msgstr "" -#: whatsnew/2.6.rst:147 +#: whatsnew/2.6.rst:145 msgid "" "For a long time, the Python developers had been growing increasingly annoyed " "by SourceForge's bug tracker. SourceForge's hosted solution doesn't permit " @@ -158,7 +158,7 @@ msgid "" "cycle of issues." msgstr "" -#: whatsnew/2.6.rst:152 +#: whatsnew/2.6.rst:150 msgid "" "The infrastructure committee of the Python Software Foundation therefore " "posted a call for issue trackers, asking volunteers to set up different " @@ -172,7 +172,7 @@ msgid "" "volunteers to administer it and a server to host it." msgstr "" -#: whatsnew/2.6.rst:166 +#: whatsnew/2.6.rst:164 msgid "" "After posting a call for volunteers, a new Roundup installation was set up " "at https://bugs.python.org. One installation of Roundup can host multiple " @@ -182,7 +182,7 @@ msgid "" "item for each change." msgstr "" -#: whatsnew/2.6.rst:174 +#: whatsnew/2.6.rst:172 msgid "" "Hosting of the Python bug tracker is kindly provided by `Upfront Systems " "`__ of Stellenbosch, South Africa. Martin " @@ -192,43 +192,43 @@ msgid "" "wishing to move from SourceForge to Roundup." msgstr "" -#: whatsnew/2.6.rst:185 +#: whatsnew/2.6.rst:183 msgid "https://bugs.python.org" msgstr "" -#: whatsnew/2.6.rst:185 +#: whatsnew/2.6.rst:183 msgid "The Python bug tracker." msgstr "" -#: whatsnew/2.6.rst:188 +#: whatsnew/2.6.rst:186 msgid "https://bugs.jython.org:" msgstr "" -#: whatsnew/2.6.rst:188 +#: whatsnew/2.6.rst:186 msgid "The Jython bug tracker." msgstr "" -#: whatsnew/2.6.rst:191 +#: whatsnew/2.6.rst:189 msgid "https://roundup.sourceforge.io/" msgstr "" -#: whatsnew/2.6.rst:191 +#: whatsnew/2.6.rst:189 msgid "Roundup downloads and documentation." msgstr "" -#: whatsnew/2.6.rst:193 +#: whatsnew/2.6.rst:191 msgid "https://svn.python.org/view/tracker/importer/" msgstr "" -#: whatsnew/2.6.rst:194 +#: whatsnew/2.6.rst:192 msgid "Martin von Löwis's conversion scripts." msgstr "" -#: whatsnew/2.6.rst:197 +#: whatsnew/2.6.rst:195 msgid "New Documentation Format: reStructuredText Using Sphinx" msgstr "" -#: whatsnew/2.6.rst:199 +#: whatsnew/2.6.rst:197 msgid "" "The Python documentation was written using LaTeX since the project started " "around 1989. In the 1980s and early 1990s, most documentation was printed " @@ -237,7 +237,7 @@ msgid "" "once the basic rules of the markup were learned." msgstr "" -#: whatsnew/2.6.rst:206 +#: whatsnew/2.6.rst:204 msgid "" "Today LaTeX is still used for writing publications destined for printing, " "but the landscape for programming tools has shifted. We no longer print out " @@ -250,14 +250,14 @@ msgid "" "and no one ever committed the time required to finish the job." msgstr "" -#: whatsnew/2.6.rst:217 +#: whatsnew/2.6.rst:215 msgid "" "During the 2.6 development cycle, Georg Brandl put a lot of effort into " "building a new toolchain for processing the documentation. The resulting " "package is called Sphinx, and is available from https://www.sphinx-doc.org/." msgstr "" -#: whatsnew/2.6.rst:222 +#: whatsnew/2.6.rst:220 msgid "" "Sphinx concentrates on HTML output, producing attractively styled and modern " "HTML; printed output is still supported through conversion to LaTeX. The " @@ -265,7 +265,7 @@ msgid "" "extensions and directives that is commonly used in the Python community." msgstr "" -#: whatsnew/2.6.rst:228 +#: whatsnew/2.6.rst:226 msgid "" "Sphinx is a standalone package that can be used for writing, and almost two " "dozen other projects (`listed on the Sphinx web site `__" msgstr "" -#: whatsnew/2.6.rst:236 +#: whatsnew/2.6.rst:234 msgid "Describes how to write for Python's documentation." msgstr "" -#: whatsnew/2.6.rst:239 +#: whatsnew/2.6.rst:237 msgid "`Sphinx `__" msgstr "" -#: whatsnew/2.6.rst:239 +#: whatsnew/2.6.rst:237 msgid "Documentation and code for the Sphinx toolchain." msgstr "" -#: whatsnew/2.6.rst:241 +#: whatsnew/2.6.rst:239 msgid "`Docutils `__" msgstr "" -#: whatsnew/2.6.rst:242 +#: whatsnew/2.6.rst:240 msgid "The underlying reStructuredText parser and toolset." msgstr "" -#: whatsnew/2.6.rst:248 +#: whatsnew/2.6.rst:246 msgid "PEP 343: The 'with' statement" msgstr "" -#: whatsnew/2.6.rst:250 +#: whatsnew/2.6.rst:248 msgid "" "The previous version, Python 2.5, added the ':keyword:`with`' statement as " "an optional feature, to be enabled by a ``from __future__ import " @@ -312,7 +312,7 @@ msgid "" "':keyword:`!with`' statement from Python 2.5, you can skip this section." msgstr "" -#: whatsnew/2.6.rst:259 +#: whatsnew/2.6.rst:257 msgid "" "The ':keyword:`with`' statement clarifies code that previously would use " "``try...finally`` blocks to ensure that clean-up code is executed. In this " @@ -321,20 +321,20 @@ msgid "" "objects for use with this statement." msgstr "" -#: whatsnew/2.6.rst:265 +#: whatsnew/2.6.rst:263 msgid "" "The ':keyword:`with`' statement is a control-flow structure whose basic " "structure is::" msgstr "" -#: whatsnew/2.6.rst:271 +#: whatsnew/2.6.rst:269 msgid "" "The expression is evaluated, and it should result in an object that supports " "the context management protocol (that is, has :meth:`~object.__enter__` and :" "meth:`~object.__exit__` methods)." msgstr "" -#: whatsnew/2.6.rst:275 +#: whatsnew/2.6.rst:273 msgid "" "The object's :meth:`~object.__enter__` is called before *with-block* is " "executed and therefore can run set-up code. It also may return a value that " @@ -342,57 +342,57 @@ msgid "" "is *not* assigned the result of *expression*.)" msgstr "" -#: whatsnew/2.6.rst:280 +#: whatsnew/2.6.rst:278 msgid "" "After execution of the *with-block* is finished, the object's :meth:`~object." "__exit__` method is called, even if the block raised an exception, and can " "therefore run clean-up code." msgstr "" -#: whatsnew/2.6.rst:284 +#: whatsnew/2.6.rst:282 msgid "" "Some standard Python objects now support the context management protocol and " "can be used with the ':keyword:`with`' statement. File objects are one " "example::" msgstr "" -#: whatsnew/2.6.rst:292 +#: whatsnew/2.6.rst:290 msgid "" "After this statement has executed, the file object in *f* will have been " "automatically closed, even if the :keyword:`for` loop raised an exception " "part-way through the block." msgstr "" -#: whatsnew/2.6.rst:298 +#: whatsnew/2.6.rst:296 msgid "" "In this case, *f* is the same object created by :func:`open`, because :meth:" "`~object.__enter__` returns *self*." msgstr "" -#: whatsnew/2.6.rst:301 +#: whatsnew/2.6.rst:299 msgid "" "The :mod:`threading` module's locks and condition variables also support " "the ':keyword:`with`' statement::" msgstr "" -#: whatsnew/2.6.rst:309 +#: whatsnew/2.6.rst:307 msgid "" "The lock is acquired before the block is executed and always released once " "the block is complete." msgstr "" -#: whatsnew/2.6.rst:312 +#: whatsnew/2.6.rst:310 msgid "" "The :func:`localcontext` function in the :mod:`decimal` module makes it easy " "to save and restore the current decimal context, which encapsulates the " "desired precision and rounding characteristics for computations::" msgstr "" -#: whatsnew/2.6.rst:331 +#: whatsnew/2.6.rst:329 msgid "Writing Context Managers" msgstr "" -#: whatsnew/2.6.rst:333 +#: whatsnew/2.6.rst:331 msgid "" "Under the hood, the ':keyword:`with`' statement is fairly complicated. Most " "people will only use ':keyword:`!with`' in company with existing objects and " @@ -401,29 +401,29 @@ msgid "" "the underlying implementation and should keep reading." msgstr "" -#: whatsnew/2.6.rst:339 +#: whatsnew/2.6.rst:337 msgid "A high-level explanation of the context management protocol is:" msgstr "" -#: whatsnew/2.6.rst:341 +#: whatsnew/2.6.rst:339 msgid "" "The expression is evaluated and should result in an object called a " "\"context manager\". The context manager must have :meth:`~object." "__enter__` and :meth:`~object.__exit__` methods." msgstr "" -#: whatsnew/2.6.rst:345 +#: whatsnew/2.6.rst:343 msgid "" "The context manager's :meth:`~object.__enter__` method is called. The value " "returned is assigned to *VAR*. If no ``as VAR`` clause is present, the " "value is simply discarded." msgstr "" -#: whatsnew/2.6.rst:349 +#: whatsnew/2.6.rst:347 msgid "The code in *BLOCK* is executed." msgstr "" -#: whatsnew/2.6.rst:351 +#: whatsnew/2.6.rst:349 msgid "" "If *BLOCK* raises an exception, the context manager's :meth:`~object." "__exit__` method is called with three arguments, the exception details " @@ -436,19 +436,19 @@ msgid "" "realize anything went wrong." msgstr "" -#: whatsnew/2.6.rst:360 +#: whatsnew/2.6.rst:358 msgid "" "If *BLOCK* didn't raise an exception, the :meth:`~object.__exit__` method " "is still called, but *type*, *value*, and *traceback* are all ``None``." msgstr "" -#: whatsnew/2.6.rst:363 +#: whatsnew/2.6.rst:361 msgid "" "Let's think through an example. I won't present detailed code but will only " "sketch the methods necessary for a database that supports transactions." msgstr "" -#: whatsnew/2.6.rst:366 +#: whatsnew/2.6.rst:364 msgid "" "(For people unfamiliar with database terminology: a set of changes to the " "database are grouped into a transaction. Transactions can be either " @@ -457,20 +457,20 @@ msgid "" "unchanged. See any database textbook for more information.)" msgstr "" -#: whatsnew/2.6.rst:372 +#: whatsnew/2.6.rst:370 msgid "" "Let's assume there's an object representing a database connection. Our goal " "will be to let the user write code like this::" msgstr "" -#: whatsnew/2.6.rst:381 +#: whatsnew/2.6.rst:379 msgid "" "The transaction should be committed if the code in the block runs flawlessly " "or rolled back if there's an exception. Here's the basic interface for :" "class:`DatabaseConnection` that I'll assume::" msgstr "" -#: whatsnew/2.6.rst:394 +#: whatsnew/2.6.rst:392 msgid "" "The :meth:`~object.__enter__` method is pretty easy, having only to start a " "new transaction. For this application the resulting cursor object would be " @@ -479,7 +479,7 @@ msgid "" "variable name. ::" msgstr "" -#: whatsnew/2.6.rst:406 +#: whatsnew/2.6.rst:404 msgid "" "The :meth:`~object.__exit__` method is the most complicated because it's " "where most of the work has to be done. The method has to check if an " @@ -487,7 +487,7 @@ msgid "" "committed. The transaction is rolled back if there was an exception." msgstr "" -#: whatsnew/2.6.rst:411 +#: whatsnew/2.6.rst:409 msgid "" "In the code below, execution will just fall off the end of the function, " "returning the default value of ``None``. ``None`` is false, so the " @@ -495,17 +495,17 @@ msgid "" "explicit and add a :keyword:`return` statement at the marked location. ::" msgstr "" -#: whatsnew/2.6.rst:431 +#: whatsnew/2.6.rst:429 msgid "The contextlib module" msgstr "" -#: whatsnew/2.6.rst:433 +#: whatsnew/2.6.rst:431 msgid "" "The :mod:`contextlib` module provides some functions and a decorator that " "are useful when writing objects for use with the ':keyword:`with`' statement." msgstr "" -#: whatsnew/2.6.rst:436 +#: whatsnew/2.6.rst:434 msgid "" "The decorator is called :func:`contextmanager`, and lets you write a single " "generator function instead of defining a new class. The generator should " @@ -518,13 +518,13 @@ msgid "" "yield` statement." msgstr "" -#: whatsnew/2.6.rst:445 +#: whatsnew/2.6.rst:443 msgid "" "Using this decorator, our database example from the previous section could " "be written as::" msgstr "" -#: whatsnew/2.6.rst:465 +#: whatsnew/2.6.rst:463 msgid "" "The :mod:`contextlib` module also has a ``nested(mgr1, mgr2, ...)`` function " "that combines a number of context managers so you don't need to write nested " @@ -533,18 +533,18 @@ msgid "" "lock::" msgstr "" -#: whatsnew/2.6.rst:474 +#: whatsnew/2.6.rst:472 msgid "" "Finally, the :func:`closing` function returns its argument so that it can be " "bound to a variable, and calls the argument's ``.close()`` method at the end " "of the block. ::" msgstr "" -#: whatsnew/2.6.rst:492 +#: whatsnew/2.6.rst:490 msgid ":pep:`343` - The \"with\" statement" msgstr "" -#: whatsnew/2.6.rst:489 +#: whatsnew/2.6.rst:487 msgid "" "PEP written by Guido van Rossum and Nick Coghlan; implemented by Mike Bland, " "Guido van Rossum, and Neal Norwitz. The PEP shows the code generated for a " @@ -552,29 +552,29 @@ msgid "" "statement works." msgstr "" -#: whatsnew/2.6.rst:494 +#: whatsnew/2.6.rst:492 msgid "The documentation for the :mod:`contextlib` module." msgstr "" -#: whatsnew/2.6.rst:501 +#: whatsnew/2.6.rst:499 msgid "PEP 366: Explicit Relative Imports From a Main Module" msgstr "" -#: whatsnew/2.6.rst:503 +#: whatsnew/2.6.rst:501 msgid "" "Python's :option:`-m` switch allows running a module as a script. When you " "ran a module that was located inside a package, relative imports didn't work " "correctly." msgstr "" -#: whatsnew/2.6.rst:507 +#: whatsnew/2.6.rst:505 msgid "" "The fix for Python 2.6 adds a :attr:`__package__` attribute to modules. " "When this attribute is present, relative imports will be relative to the " "value of this attribute instead of the :attr:`__name__` attribute." msgstr "" -#: whatsnew/2.6.rst:512 +#: whatsnew/2.6.rst:510 msgid "" "PEP 302-style importers can then set :attr:`__package__` as necessary. The :" "mod:`runpy` module that implements the :option:`-m` switch now does this, so " @@ -582,11 +582,11 @@ msgid "" "package." msgstr "" -#: whatsnew/2.6.rst:522 +#: whatsnew/2.6.rst:520 msgid "PEP 370: Per-user ``site-packages`` Directory" msgstr "" -#: whatsnew/2.6.rst:524 +#: whatsnew/2.6.rst:522 msgid "" "When you run Python, the module search path ``sys.path`` usually includes a " "directory whose path ends in ``\"site-packages\"``. This directory is " @@ -594,28 +594,28 @@ msgid "" "machine or a particular site installation." msgstr "" -#: whatsnew/2.6.rst:529 +#: whatsnew/2.6.rst:527 msgid "" "Python 2.6 introduces a convention for user-specific site directories. The " "directory varies depending on the platform:" msgstr "" -#: whatsnew/2.6.rst:532 +#: whatsnew/2.6.rst:530 msgid "Unix and Mac OS X: :file:`~/.local/`" msgstr "" -#: whatsnew/2.6.rst:533 +#: whatsnew/2.6.rst:531 msgid "Windows: :file:`%APPDATA%/Python`" msgstr "" -#: whatsnew/2.6.rst:535 +#: whatsnew/2.6.rst:533 msgid "" "Within this directory, there will be version-specific subdirectories, such " "as :file:`lib/python2.6/site-packages` on Unix/Mac OS and :file:`Python26/" "site-packages` on Windows." msgstr "" -#: whatsnew/2.6.rst:539 +#: whatsnew/2.6.rst:537 msgid "" "If you don't like the default directory, it can be overridden by an " "environment variable. :envvar:`PYTHONUSERBASE` sets the root directory used " @@ -625,25 +625,25 @@ msgid "" "file for your Python installation." msgstr "" -#: whatsnew/2.6.rst:546 +#: whatsnew/2.6.rst:544 msgid "" "The feature can be disabled entirely by running Python with the :option:`-s` " "option or setting the :envvar:`PYTHONNOUSERSITE` environment variable." msgstr "" -#: whatsnew/2.6.rst:552 +#: whatsnew/2.6.rst:550 msgid ":pep:`370` - Per-user ``site-packages`` Directory" msgstr "" -#: whatsnew/2.6.rst:553 +#: whatsnew/2.6.rst:551 msgid "PEP written and implemented by Christian Heimes." msgstr "" -#: whatsnew/2.6.rst:561 +#: whatsnew/2.6.rst:559 msgid "PEP 371: The ``multiprocessing`` Package" msgstr "" -#: whatsnew/2.6.rst:563 +#: whatsnew/2.6.rst:561 msgid "" "The new :mod:`multiprocessing` package lets Python programs create new " "processes that will perform a computation and return a result to the " @@ -652,7 +652,7 @@ msgid "" "share simple arrays of data." msgstr "" -#: whatsnew/2.6.rst:569 +#: whatsnew/2.6.rst:567 msgid "" "The :mod:`multiprocessing` module started out as an exact emulation of the :" "mod:`threading` module using processes instead of threads. That goal was " @@ -664,14 +664,14 @@ msgid "" "still running and the :meth:`join` method to wait for the process to exit." msgstr "" -#: whatsnew/2.6.rst:579 +#: whatsnew/2.6.rst:577 msgid "" "Here's a simple example where the subprocess will calculate a factorial. " "The function doing the calculation is written strangely so that it takes " "significantly longer when the input argument is a multiple of 4." msgstr "" -#: whatsnew/2.6.rst:616 +#: whatsnew/2.6.rst:614 msgid "" "A :class:`~queue.Queue` is used to communicate the result of the factorial. " "The :class:`~queue.Queue` object is stored in a global variable. The child " @@ -681,7 +681,7 @@ msgid "" "variable, the child's value would be unaffected, and vice versa.)" msgstr "" -#: whatsnew/2.6.rst:624 +#: whatsnew/2.6.rst:622 msgid "" "Two other classes, :class:`Pool` and :class:`Manager`, provide higher-level " "interfaces. :class:`Pool` will create a fixed number of worker processes, " @@ -692,11 +692,11 @@ msgid "" "results::" msgstr "" -#: whatsnew/2.6.rst:642 +#: whatsnew/2.6.rst:640 msgid "This produces the following output::" msgstr "" -#: whatsnew/2.6.rst:651 +#: whatsnew/2.6.rst:649 msgid "" "The other high-level interface, the :class:`Manager` class, creates a " "separate server process that can hold master copies of Python data " @@ -709,36 +709,36 @@ msgid "" "create shared locks.)" msgstr "" -#: whatsnew/2.6.rst:695 +#: whatsnew/2.6.rst:693 msgid "This will produce the output::" msgstr "" -#: whatsnew/2.6.rst:706 +#: whatsnew/2.6.rst:704 msgid "The documentation for the :mod:`multiprocessing` module." msgstr "" -#: whatsnew/2.6.rst:709 +#: whatsnew/2.6.rst:707 msgid ":pep:`371` - Addition of the multiprocessing package" msgstr "" -#: whatsnew/2.6.rst:709 +#: whatsnew/2.6.rst:707 msgid "" "PEP written by Jesse Noller and Richard Oudkerk; implemented by Richard " "Oudkerk and Jesse Noller." msgstr "" -#: whatsnew/2.6.rst:718 +#: whatsnew/2.6.rst:716 msgid "PEP 3101: Advanced String Formatting" msgstr "" -#: whatsnew/2.6.rst:720 +#: whatsnew/2.6.rst:718 msgid "" "In Python 3.0, the ``%`` operator is supplemented by a more powerful string " "formatting method, :meth:`format`. Support for the :meth:`str.format` " "method has been backported to Python 2.6." msgstr "" -#: whatsnew/2.6.rst:724 +#: whatsnew/2.6.rst:722 msgid "" "In 2.6, both 8-bit and Unicode strings have a ``.format()`` method that " "treats the string as a template and takes the arguments to be formatted. The " @@ -746,18 +746,18 @@ msgid "" "characters::" msgstr "" -#: whatsnew/2.6.rst:737 +#: whatsnew/2.6.rst:735 msgid "Curly brackets can be escaped by doubling them::" msgstr "" -#: whatsnew/2.6.rst:742 +#: whatsnew/2.6.rst:740 msgid "" "Field names can be integers indicating positional arguments, such as ``{0}" "``, ``{1}``, etc. or names of keyword arguments. You can also supply " "compound field names that read attributes or access dictionary keys::" msgstr "" -#: whatsnew/2.6.rst:756 +#: whatsnew/2.6.rst:754 msgid "" "Note that when using dictionary-style notation such as ``[.mp4]``, you don't " "need to put any quotation marks around the string; it will look up the value " @@ -766,249 +766,249 @@ msgid "" "inside a format string." msgstr "" -#: whatsnew/2.6.rst:762 +#: whatsnew/2.6.rst:760 msgid "" "So far we've shown how to specify which field to substitute into the " "resulting string. The precise formatting used is also controllable by " "adding a colon followed by a format specifier. For example::" msgstr "" -#: whatsnew/2.6.rst:776 +#: whatsnew/2.6.rst:774 msgid "Format specifiers can reference other fields through nesting::" msgstr "" -#: whatsnew/2.6.rst:786 +#: whatsnew/2.6.rst:784 msgid "The alignment of a field within the desired width can be specified:" msgstr "" -#: whatsnew/2.6.rst:789 +#: whatsnew/2.6.rst:787 msgid "Character" msgstr "" -#: whatsnew/2.6.rst:789 +#: whatsnew/2.6.rst:787 msgid "Effect" msgstr "" -#: whatsnew/2.6.rst:791 +#: whatsnew/2.6.rst:789 msgid "< (default)" msgstr "" -#: whatsnew/2.6.rst:791 +#: whatsnew/2.6.rst:789 msgid "Left-align" msgstr "" -#: whatsnew/2.6.rst:792 +#: whatsnew/2.6.rst:790 msgid ">" msgstr "" -#: whatsnew/2.6.rst:792 +#: whatsnew/2.6.rst:790 msgid "Right-align" msgstr "" -#: whatsnew/2.6.rst:793 +#: whatsnew/2.6.rst:791 msgid "^" msgstr "" -#: whatsnew/2.6.rst:793 +#: whatsnew/2.6.rst:791 msgid "Center" msgstr "" -#: whatsnew/2.6.rst:794 +#: whatsnew/2.6.rst:792 msgid "=" msgstr "" -#: whatsnew/2.6.rst:794 +#: whatsnew/2.6.rst:792 msgid "(For numeric types only) Pad after the sign." msgstr "" -#: whatsnew/2.6.rst:797 +#: whatsnew/2.6.rst:795 msgid "" "Format specifiers can also include a presentation type, which controls how " "the value is formatted. For example, floating-point numbers can be " "formatted as a general number or in exponential notation::" msgstr "" -#: whatsnew/2.6.rst:806 +#: whatsnew/2.6.rst:804 msgid "" "A variety of presentation types are available. Consult the 2.6 " "documentation for a :ref:`complete list `; here's a sample:" msgstr "" -#: whatsnew/2.6.rst:810 +#: whatsnew/2.6.rst:808 msgid "``b``" msgstr "" -#: whatsnew/2.6.rst:810 +#: whatsnew/2.6.rst:808 msgid "Binary. Outputs the number in base 2." msgstr "" -#: whatsnew/2.6.rst:811 +#: whatsnew/2.6.rst:809 msgid "``c``" msgstr "" -#: whatsnew/2.6.rst:811 +#: whatsnew/2.6.rst:809 msgid "" "Character. Converts the integer to the corresponding Unicode character " "before printing." msgstr "" -#: whatsnew/2.6.rst:813 +#: whatsnew/2.6.rst:811 msgid "``d``" msgstr "" -#: whatsnew/2.6.rst:813 +#: whatsnew/2.6.rst:811 msgid "Decimal Integer. Outputs the number in base 10." msgstr "" -#: whatsnew/2.6.rst:814 +#: whatsnew/2.6.rst:812 msgid "``o``" msgstr "" -#: whatsnew/2.6.rst:814 +#: whatsnew/2.6.rst:812 msgid "Octal format. Outputs the number in base 8." msgstr "" -#: whatsnew/2.6.rst:815 +#: whatsnew/2.6.rst:813 msgid "``x``" msgstr "" -#: whatsnew/2.6.rst:815 +#: whatsnew/2.6.rst:813 msgid "" "Hex format. Outputs the number in base 16, using lower-case letters for the " "digits above 9." msgstr "" -#: whatsnew/2.6.rst:817 +#: whatsnew/2.6.rst:815 msgid "``e``" msgstr "" -#: whatsnew/2.6.rst:817 +#: whatsnew/2.6.rst:815 msgid "" "Exponent notation. Prints the number in scientific notation using the letter " "'e' to indicate the exponent." msgstr "" -#: whatsnew/2.6.rst:819 +#: whatsnew/2.6.rst:817 msgid "``g``" msgstr "" -#: whatsnew/2.6.rst:819 +#: whatsnew/2.6.rst:817 msgid "" "General format. This prints the number as a fixed-point number, unless the " "number is too large, in which case it switches to 'e' exponent notation." msgstr "" -#: whatsnew/2.6.rst:822 +#: whatsnew/2.6.rst:820 msgid "``n``" msgstr "" -#: whatsnew/2.6.rst:822 +#: whatsnew/2.6.rst:820 msgid "" "Number. This is the same as 'g' (for floats) or 'd' (for integers), except " "that it uses the current locale setting to insert the appropriate number " "separator characters." msgstr "" -#: whatsnew/2.6.rst:825 +#: whatsnew/2.6.rst:823 msgid "``%``" msgstr "" -#: whatsnew/2.6.rst:825 +#: whatsnew/2.6.rst:823 msgid "" "Percentage. Multiplies the number by 100 and displays in fixed ('f') format, " "followed by a percent sign." msgstr "" -#: whatsnew/2.6.rst:829 +#: whatsnew/2.6.rst:827 msgid "" "Classes and types can define a :meth:`__format__` method to control how " "they're formatted. It receives a single argument, the format specifier::" msgstr "" -#: whatsnew/2.6.rst:838 +#: whatsnew/2.6.rst:836 msgid "" "There's also a :func:`format` builtin that will format a single value. It " "calls the type's :meth:`__format__` method with the provided specifier::" msgstr "" -#: whatsnew/2.6.rst:849 +#: whatsnew/2.6.rst:847 msgid ":ref:`formatstrings`" msgstr "" -#: whatsnew/2.6.rst:849 +#: whatsnew/2.6.rst:847 msgid "The reference documentation for format fields." msgstr "" -#: whatsnew/2.6.rst:851 +#: whatsnew/2.6.rst:849 msgid ":pep:`3101` - Advanced String Formatting" msgstr "" -#: whatsnew/2.6.rst:852 +#: whatsnew/2.6.rst:850 msgid "PEP written by Talin. Implemented by Eric Smith." msgstr "" -#: whatsnew/2.6.rst:859 +#: whatsnew/2.6.rst:857 msgid "PEP 3105: ``print`` As a Function" msgstr "" -#: whatsnew/2.6.rst:861 +#: whatsnew/2.6.rst:859 msgid "" "The ``print`` statement becomes the :func:`print` function in Python 3.0. " "Making :func:`print` a function makes it possible to replace the function by " "doing ``def print(...)`` or importing a new function from somewhere else." msgstr "" -#: whatsnew/2.6.rst:865 +#: whatsnew/2.6.rst:863 msgid "" "Python 2.6 has a ``__future__`` import that removes ``print`` as language " "syntax, letting you use the functional form instead. For example::" msgstr "" -#: whatsnew/2.6.rst:871 +#: whatsnew/2.6.rst:869 msgid "The signature of the new function is::" msgstr "" -#: whatsnew/2.6.rst:876 +#: whatsnew/2.6.rst:874 msgid "The parameters are:" msgstr "" -#: whatsnew/2.6.rst:878 +#: whatsnew/2.6.rst:876 msgid "*args*: positional arguments whose values will be printed out." msgstr "" -#: whatsnew/2.6.rst:879 +#: whatsnew/2.6.rst:877 msgid "*sep*: the separator, which will be printed between arguments." msgstr "" -#: whatsnew/2.6.rst:880 +#: whatsnew/2.6.rst:878 msgid "" "*end*: the ending text, which will be printed after all of the arguments " "have been output." msgstr "" -#: whatsnew/2.6.rst:882 +#: whatsnew/2.6.rst:880 msgid "*file*: the file object to which the output will be sent." msgstr "" -#: whatsnew/2.6.rst:886 +#: whatsnew/2.6.rst:884 msgid ":pep:`3105` - Make print a function" msgstr "" -#: whatsnew/2.6.rst:887 +#: whatsnew/2.6.rst:885 msgid "PEP written by Georg Brandl." msgstr "" -#: whatsnew/2.6.rst:894 +#: whatsnew/2.6.rst:892 msgid "PEP 3110: Exception-Handling Changes" msgstr "" -#: whatsnew/2.6.rst:896 +#: whatsnew/2.6.rst:894 msgid "" "One error that Python programmers occasionally make is writing the following " "code::" msgstr "" -#: whatsnew/2.6.rst:904 +#: whatsnew/2.6.rst:902 msgid "" "The author is probably trying to catch both :exc:`TypeError` and :exc:" "`ValueError` exceptions, but this code actually does something different: it " @@ -1017,21 +1017,21 @@ msgid "" "caught at all. The correct code specifies a tuple of exceptions::" msgstr "" -#: whatsnew/2.6.rst:916 +#: whatsnew/2.6.rst:914 msgid "" "This error happens because the use of the comma here is ambiguous: does it " "indicate two different nodes in the parse tree, or a single node that's a " "tuple?" msgstr "" -#: whatsnew/2.6.rst:920 +#: whatsnew/2.6.rst:918 msgid "" "Python 3.0 makes this unambiguous by replacing the comma with the word " "\"as\". To catch an exception and store the exception object in the " "variable ``exc``, you must write::" msgstr "" -#: whatsnew/2.6.rst:929 +#: whatsnew/2.6.rst:927 msgid "" "Python 3.0 will only support the use of \"as\", and therefore interprets the " "first example as catching two different exceptions. Python 2.6 supports " @@ -1040,19 +1040,19 @@ msgid "" "be executed with 2.6." msgstr "" -#: whatsnew/2.6.rst:937 +#: whatsnew/2.6.rst:935 msgid ":pep:`3110` - Catching Exceptions in Python 3000" msgstr "" -#: whatsnew/2.6.rst:938 +#: whatsnew/2.6.rst:936 msgid "PEP written and implemented by Collin Winter." msgstr "" -#: whatsnew/2.6.rst:945 +#: whatsnew/2.6.rst:943 msgid "PEP 3112: Byte Literals" msgstr "" -#: whatsnew/2.6.rst:947 +#: whatsnew/2.6.rst:945 msgid "" "Python 3.0 adopts Unicode as the language's fundamental string type and " "denotes 8-bit literals differently, either as ``b'string'`` or using a :" @@ -1061,7 +1061,7 @@ msgid "" "``b''`` notation." msgstr "" -#: whatsnew/2.6.rst:954 +#: whatsnew/2.6.rst:952 msgid "" "The 2.6 :class:`str` differs from 3.0's :class:`bytes` type in various ways; " "most notably, the constructor is completely different. In 3.0, ``bytes([65, " @@ -1070,7 +1070,7 @@ msgid "" "func:`str` of the list." msgstr "" -#: whatsnew/2.6.rst:960 +#: whatsnew/2.6.rst:958 msgid "" "The primary use of :class:`bytes` in 2.6 will be to write tests of object " "type such as ``isinstance(x, bytes)``. This will help the 2to3 converter, " @@ -1080,14 +1080,14 @@ msgid "" "be correct in Python 3.0." msgstr "" -#: whatsnew/2.6.rst:967 +#: whatsnew/2.6.rst:965 msgid "" "There's also a ``__future__`` import that causes all string literals to " "become Unicode strings. This means that ``\\u`` escape sequences can be " "used to include Unicode characters::" msgstr "" -#: whatsnew/2.6.rst:979 +#: whatsnew/2.6.rst:977 msgid "" "At the C level, Python 3.0 will rename the existing 8-bit string type, " "called :c:type:`!PyStringObject` in Python 2.x, to :c:type:`PyBytesObject`. " @@ -1097,38 +1097,38 @@ msgid "" "with strings." msgstr "" -#: whatsnew/2.6.rst:986 +#: whatsnew/2.6.rst:984 msgid "" "Instances of the :class:`bytes` type are immutable just as strings are. A " "new :class:`bytearray` type stores a mutable sequence of bytes::" msgstr "" -#: whatsnew/2.6.rst:1001 +#: whatsnew/2.6.rst:999 msgid "" "Byte arrays support most of the methods of string types, such as :meth:" "`startswith`/:meth:`endswith`, :meth:`find`/:meth:`rfind`, and some of the " "methods of lists, such as :meth:`append`, :meth:`pop`, and :meth:`reverse`." msgstr "" -#: whatsnew/2.6.rst:1014 +#: whatsnew/2.6.rst:1012 msgid "" "There's also a corresponding C API, with :c:func:`PyByteArray_FromObject`, :" "c:func:`PyByteArray_FromStringAndSize`, and various other functions." msgstr "" -#: whatsnew/2.6.rst:1021 +#: whatsnew/2.6.rst:1019 msgid ":pep:`3112` - Bytes literals in Python 3000" msgstr "" -#: whatsnew/2.6.rst:1022 +#: whatsnew/2.6.rst:1020 msgid "PEP written by Jason Orendorff; backported to 2.6 by Christian Heimes." msgstr "" -#: whatsnew/2.6.rst:1029 +#: whatsnew/2.6.rst:1027 msgid "PEP 3116: New I/O Library" msgstr "" -#: whatsnew/2.6.rst:1031 +#: whatsnew/2.6.rst:1029 msgid "" "Python's built-in file objects support a number of methods, but file-like " "objects don't necessarily support all of them. Objects that imitate files " @@ -1138,13 +1138,13 @@ msgid "" "from the fundamental read and write operations." msgstr "" -#: whatsnew/2.6.rst:1039 +#: whatsnew/2.6.rst:1037 msgid "" "There are three levels of abstract base classes provided by the :mod:`io` " "module:" msgstr "" -#: whatsnew/2.6.rst:1042 +#: whatsnew/2.6.rst:1040 msgid "" ":class:`RawIOBase` defines raw I/O operations: :meth:`read`, :meth:" "`readinto`, :meth:`write`, :meth:`seek`, :meth:`tell`, :meth:`truncate`, " @@ -1154,13 +1154,13 @@ msgid "" "allow." msgstr "" -#: whatsnew/2.6.rst:1050 +#: whatsnew/2.6.rst:1048 msgid "" "Python 3.0 has concrete implementations of this class for files and sockets, " "but Python 2.6 hasn't restructured its file and socket objects in this way." msgstr "" -#: whatsnew/2.6.rst:1056 +#: whatsnew/2.6.rst:1052 msgid "" ":class:`BufferedIOBase` is an abstract base class that buffers data in " "memory to reduce the number of system calls used, making I/O processing more " @@ -1168,7 +1168,7 @@ msgid "" "attr:`raw` attribute holding the underlying raw object." msgstr "" -#: whatsnew/2.6.rst:1062 +#: whatsnew/2.6.rst:1058 msgid "" "There are five concrete classes implementing this ABC. :class:" "`BufferedWriter` and :class:`BufferedReader` are for objects that support " @@ -1180,7 +1180,7 @@ msgid "" "seeking over an in-memory buffer." msgstr "" -#: whatsnew/2.6.rst:1075 +#: whatsnew/2.6.rst:1071 msgid "" ":class:`TextIOBase`: Provides functions for reading and writing strings " "(remember, strings will be Unicode in Python 3.0), and supporting :term:" @@ -1188,7 +1188,7 @@ msgid "" "method and supports iteration upon objects." msgstr "" -#: whatsnew/2.6.rst:1081 +#: whatsnew/2.6.rst:1077 msgid "" "There are two concrete implementations. :class:`TextIOWrapper` wraps a " "buffered I/O object, supporting all of the methods for text I/O and adding " @@ -1197,16 +1197,16 @@ msgid "" "to disk." msgstr "" -#: whatsnew/2.6.rst:1087 +#: whatsnew/2.6.rst:1083 msgid "" "(In Python 2.6, :class:`io.StringIO` is implemented in pure Python, so it's " -"pretty slow. You should therefore stick with the existing :mod:`StringIO` " -"module or :mod:`cStringIO` for now. At some point Python 3.0's :mod:`io` " +"pretty slow. You should therefore stick with the existing :mod:`!StringIO` " +"module or :mod:`!cStringIO` for now. At some point Python 3.0's :mod:`io` " "module will be rewritten into C for speed, and perhaps the C implementation " "will be backported to the 2.x releases.)" msgstr "" -#: whatsnew/2.6.rst:1093 +#: whatsnew/2.6.rst:1089 msgid "" "In Python 2.6, the underlying implementations haven't been restructured to " "build on top of the :mod:`io` module's classes. The module is being " @@ -1215,22 +1215,22 @@ msgid "" "buffering and text I/O." msgstr "" -#: whatsnew/2.6.rst:1103 +#: whatsnew/2.6.rst:1099 msgid ":pep:`3116` - New I/O" msgstr "" -#: whatsnew/2.6.rst:1102 +#: whatsnew/2.6.rst:1098 msgid "" "PEP written by Daniel Stutzbach, Mike Verdone, and Guido van Rossum. Code by " "Guido van Rossum, Georg Brandl, Walter Doerwald, Jeremy Hylton, Martin von " "Löwis, Tony Lownds, and others." msgstr "" -#: whatsnew/2.6.rst:1111 +#: whatsnew/2.6.rst:1107 msgid "PEP 3118: Revised Buffer Protocol" msgstr "" -#: whatsnew/2.6.rst:1113 +#: whatsnew/2.6.rst:1109 msgid "" "The buffer protocol is a C-level API that lets Python types exchange " "pointers into their internal representations. A memory-mapped file can be " @@ -1239,7 +1239,7 @@ msgid "" "searched." msgstr "" -#: whatsnew/2.6.rst:1119 +#: whatsnew/2.6.rst:1115 msgid "" "The primary users of the buffer protocol are numeric-processing packages " "such as NumPy, which expose the internal representation of arrays so that " @@ -1249,7 +1249,7 @@ msgid "" "the shape of an array or locking a memory region." msgstr "" -#: whatsnew/2.6.rst:1126 +#: whatsnew/2.6.rst:1122 msgid "" "The most important new C API function is ``PyObject_GetBuffer(PyObject *obj, " "Py_buffer *view, int flags)``, which takes an object and a set of flags, and " @@ -1260,49 +1260,49 @@ msgid "" "external caller is done." msgstr "" -#: whatsnew/2.6.rst:1138 +#: whatsnew/2.6.rst:1132 msgid "" "The *flags* argument to :c:func:`PyObject_GetBuffer` specifies constraints " "upon the memory returned. Some examples are:" msgstr "" -#: whatsnew/2.6.rst:1141 +#: whatsnew/2.6.rst:1135 msgid ":c:macro:`PyBUF_WRITABLE` indicates that the memory must be writable." msgstr "" -#: whatsnew/2.6.rst:1143 +#: whatsnew/2.6.rst:1137 msgid "" ":c:macro:`PyBUF_LOCK` requests a read-only or exclusive lock on the memory." msgstr "" -#: whatsnew/2.6.rst:1145 +#: whatsnew/2.6.rst:1139 msgid "" ":c:macro:`PyBUF_C_CONTIGUOUS` and :c:macro:`PyBUF_F_CONTIGUOUS` requests a C-" "contiguous (last dimension varies the fastest) or Fortran-contiguous (first " "dimension varies the fastest) array layout." msgstr "" -#: whatsnew/2.6.rst:1149 +#: whatsnew/2.6.rst:1143 msgid "" "Two new argument codes for :c:func:`PyArg_ParseTuple`, ``s*`` and ``z*``, " "return locked buffer objects for a parameter." msgstr "" -#: whatsnew/2.6.rst:1155 +#: whatsnew/2.6.rst:1149 msgid ":pep:`3118` - Revising the buffer protocol" msgstr "" -#: whatsnew/2.6.rst:1155 +#: whatsnew/2.6.rst:1149 msgid "" "PEP written by Travis Oliphant and Carl Banks; implemented by Travis " "Oliphant." msgstr "" -#: whatsnew/2.6.rst:1164 +#: whatsnew/2.6.rst:1158 msgid "PEP 3119: Abstract Base Classes" msgstr "" -#: whatsnew/2.6.rst:1166 +#: whatsnew/2.6.rst:1160 msgid "" "Some object-oriented languages such as Java support interfaces, declaring " "that a class has a given set of methods or supports a given access " @@ -1314,7 +1314,7 @@ msgid "" "versions of Python will probably add more ABCs." msgstr "" -#: whatsnew/2.6.rst:1176 +#: whatsnew/2.6.rst:1170 msgid "" "Let's say you have a particular class and wish to know whether it supports " "dictionary-style access. The phrase \"dictionary-style\" is vague, however. " @@ -1325,7 +1325,7 @@ msgid "" "`update`? Iterating over the object with :func:`iter`?" msgstr "" -#: whatsnew/2.6.rst:1184 +#: whatsnew/2.6.rst:1178 msgid "" "The Python 2.6 :mod:`collections` module includes a number of different ABCs " "that represent these distinctions. :class:`Iterable` indicates that a class " @@ -1336,20 +1336,20 @@ msgid "" "`MutableMapping` ABC." msgstr "" -#: whatsnew/2.6.rst:1193 +#: whatsnew/2.6.rst:1187 msgid "" "You can derive your own classes from a particular ABC to indicate they " "support that ABC's interface::" msgstr "" -#: whatsnew/2.6.rst:1202 +#: whatsnew/2.6.rst:1196 msgid "" "Alternatively, you could write the class without deriving from the desired " "ABC and instead register the class by calling the ABC's :meth:`register` " "method::" msgstr "" -#: whatsnew/2.6.rst:1213 +#: whatsnew/2.6.rst:1207 msgid "" "For classes that you write, deriving from the ABC is probably clearer. The :" "meth:`register` method is useful when you've written a new ABC that can " @@ -1358,20 +1358,20 @@ msgid "" "`PrintableType` ABC, it's legal to do::" msgstr "" -#: whatsnew/2.6.rst:1225 +#: whatsnew/2.6.rst:1219 msgid "" "Classes should obey the semantics specified by an ABC, but Python can't " "check this; it's up to the class author to understand the ABC's requirements " "and to implement the code accordingly." msgstr "" -#: whatsnew/2.6.rst:1229 +#: whatsnew/2.6.rst:1223 msgid "" "To check whether an object supports a particular interface, you can now " "write::" msgstr "" -#: whatsnew/2.6.rst:1236 +#: whatsnew/2.6.rst:1230 msgid "" "Don't feel that you must now begin writing lots of checks as in the above " "example. Python has a strong tradition of duck-typing, where explicit type-" @@ -1381,13 +1381,13 @@ msgid "" "necessary." msgstr "" -#: whatsnew/2.6.rst:1243 +#: whatsnew/2.6.rst:1237 msgid "" "You can write your own ABCs by using ``abc.ABCMeta`` as the metaclass in a " "class definition::" msgstr "" -#: whatsnew/2.6.rst:1264 +#: whatsnew/2.6.rst:1258 msgid "" "In the :class:`Drawable` ABC above, the :meth:`draw_doubled` method renders " "the object at twice its size and can be implemented in terms of other " @@ -1397,7 +1397,7 @@ msgid "" "necessary, though; the ABC can't provide a useful generic implementation." msgstr "" -#: whatsnew/2.6.rst:1272 +#: whatsnew/2.6.rst:1266 msgid "" "You can apply the ``@abstractmethod`` decorator to methods such as :meth:" "`draw` that must be implemented; Python will then raise an exception for " @@ -1406,51 +1406,51 @@ msgid "" "method::" msgstr "" -#: whatsnew/2.6.rst:1287 +#: whatsnew/2.6.rst:1281 msgid "" "Abstract data attributes can be declared using the ``@abstractproperty`` " "decorator::" msgstr "" -#: whatsnew/2.6.rst:1297 +#: whatsnew/2.6.rst:1291 msgid "Subclasses must then define a :meth:`readonly` property." msgstr "" -#: whatsnew/2.6.rst:1303 +#: whatsnew/2.6.rst:1297 msgid ":pep:`3119` - Introducing Abstract Base Classes" msgstr "" -#: whatsnew/2.6.rst:1302 +#: whatsnew/2.6.rst:1296 msgid "" "PEP written by Guido van Rossum and Talin. Implemented by Guido van Rossum. " "Backported to 2.6 by Benjamin Aranguren, with Alex Martelli." msgstr "" -#: whatsnew/2.6.rst:1311 +#: whatsnew/2.6.rst:1305 msgid "PEP 3127: Integer Literal Support and Syntax" msgstr "" -#: whatsnew/2.6.rst:1313 +#: whatsnew/2.6.rst:1307 msgid "" "Python 3.0 changes the syntax for octal (base-8) integer literals, prefixing " "them with \"0o\" or \"0O\" instead of a leading zero, and adds support for " "binary (base-2) integer literals, signalled by a \"0b\" or \"0B\" prefix." msgstr "" -#: whatsnew/2.6.rst:1318 +#: whatsnew/2.6.rst:1312 msgid "" "Python 2.6 doesn't drop support for a leading 0 signalling an octal number, " "but it does add support for \"0o\" and \"0b\"::" msgstr "" -#: whatsnew/2.6.rst:1326 +#: whatsnew/2.6.rst:1320 msgid "" "The :func:`oct` builtin still returns numbers prefixed with a leading zero, " "and a new :func:`bin` builtin returns the binary representation for a " "number::" msgstr "" -#: whatsnew/2.6.rst:1337 +#: whatsnew/2.6.rst:1331 msgid "" "The :func:`int` and :func:`long` builtins will now accept the \"0o\" and " "\"0b\" prefixes when base-8 or base-2 are requested, or when the *base* " @@ -1458,55 +1458,55 @@ msgid "" "the string)::" msgstr "" -#: whatsnew/2.6.rst:1355 +#: whatsnew/2.6.rst:1349 msgid ":pep:`3127` - Integer Literal Support and Syntax" msgstr "" -#: whatsnew/2.6.rst:1355 +#: whatsnew/2.6.rst:1349 msgid "PEP written by Patrick Maupin; backported to 2.6 by Eric Smith." msgstr "" -#: whatsnew/2.6.rst:1363 +#: whatsnew/2.6.rst:1357 msgid "PEP 3129: Class Decorators" msgstr "" -#: whatsnew/2.6.rst:1365 +#: whatsnew/2.6.rst:1359 msgid "" "Decorators have been extended from functions to classes. It's now legal to " "write::" msgstr "" -#: whatsnew/2.6.rst:1373 +#: whatsnew/2.6.rst:1367 msgid "This is equivalent to::" msgstr "" -#: whatsnew/2.6.rst:1382 +#: whatsnew/2.6.rst:1376 msgid ":pep:`3129` - Class Decorators" msgstr "" -#: whatsnew/2.6.rst:1383 +#: whatsnew/2.6.rst:1377 msgid "PEP written by Collin Winter." msgstr "" -#: whatsnew/2.6.rst:1390 +#: whatsnew/2.6.rst:1384 msgid "PEP 3141: A Type Hierarchy for Numbers" msgstr "" -#: whatsnew/2.6.rst:1392 +#: whatsnew/2.6.rst:1386 msgid "" "Python 3.0 adds several abstract base classes for numeric types inspired by " "Scheme's numeric tower. These classes were backported to 2.6 as the :mod:" "`numbers` module." msgstr "" -#: whatsnew/2.6.rst:1396 +#: whatsnew/2.6.rst:1390 msgid "" "The most general ABC is :class:`Number`. It defines no operations at all, " "and only exists to allow checking if an object is a number by doing " "``isinstance(obj, Number)``." msgstr "" -#: whatsnew/2.6.rst:1400 +#: whatsnew/2.6.rst:1394 msgid "" ":class:`Complex` is a subclass of :class:`Number`. Complex numbers can " "undergo the basic operations of addition, subtraction, multiplication, " @@ -1515,14 +1515,14 @@ msgid "" "implementation of :class:`Complex`." msgstr "" -#: whatsnew/2.6.rst:1406 +#: whatsnew/2.6.rst:1400 msgid "" ":class:`Real` further derives from :class:`Complex`, and adds operations " "that only work on real numbers: :func:`floor`, :func:`trunc`, rounding, " "taking the remainder mod N, floor division, and comparisons." msgstr "" -#: whatsnew/2.6.rst:1411 +#: whatsnew/2.6.rst:1405 msgid "" ":class:`Rational` numbers derive from :class:`Real`, have :attr:`numerator` " "and :attr:`denominator` properties, and can be converted to floats. Python " @@ -1531,7 +1531,7 @@ msgid "" "`Rational` to avoid a name clash with :class:`numbers.Rational`.)" msgstr "" -#: whatsnew/2.6.rst:1418 +#: whatsnew/2.6.rst:1412 msgid "" ":class:`Integral` numbers derive from :class:`Rational`, and can be shifted " "left and right with ``<<`` and ``>>``, combined using bitwise operations " @@ -1539,7 +1539,7 @@ msgid "" "boundaries." msgstr "" -#: whatsnew/2.6.rst:1423 +#: whatsnew/2.6.rst:1417 msgid "" "In Python 3.0, the PEP slightly redefines the existing builtins :func:" "`round`, :func:`math.floor`, :func:`math.ceil`, and adds a new one, :func:" @@ -1548,32 +1548,32 @@ msgid "" "the function's argument and zero." msgstr "" -#: whatsnew/2.6.rst:1432 +#: whatsnew/2.6.rst:1426 msgid ":pep:`3141` - A Type Hierarchy for Numbers" msgstr "" -#: whatsnew/2.6.rst:1432 +#: whatsnew/2.6.rst:1426 msgid "PEP written by Jeffrey Yasskin." msgstr "" -#: whatsnew/2.6.rst:1434 +#: whatsnew/2.6.rst:1428 msgid "" "`Scheme's numerical tower `__, from the Guile manual." msgstr "" -#: whatsnew/2.6.rst:1436 +#: whatsnew/2.6.rst:1430 msgid "" "`Scheme's number datatypes `__ from the R5RS " "Scheme specification." msgstr "" -#: whatsnew/2.6.rst:1440 +#: whatsnew/2.6.rst:1434 msgid "The :mod:`fractions` Module" msgstr "" -#: whatsnew/2.6.rst:1442 +#: whatsnew/2.6.rst:1436 msgid "" "To fill out the hierarchy of numeric types, the :mod:`fractions` module " "provides a rational-number class. Rational numbers store their values as a " @@ -1581,42 +1581,42 @@ msgid "" "numbers such as ``2/3`` that floating-point numbers can only approximate." msgstr "" -#: whatsnew/2.6.rst:1448 +#: whatsnew/2.6.rst:1442 msgid "" "The :class:`Fraction` constructor takes two :class:`Integral` values that " "will be the numerator and denominator of the resulting fraction. ::" msgstr "" -#: whatsnew/2.6.rst:1461 +#: whatsnew/2.6.rst:1455 msgid "" "For converting floating-point numbers to rationals, the float type now has " "an :meth:`as_integer_ratio()` method that returns the numerator and " "denominator for a fraction that evaluates to the same floating-point value::" msgstr "" -#: whatsnew/2.6.rst:1473 +#: whatsnew/2.6.rst:1467 msgid "" "Note that values that can only be approximated by floating-point numbers, " "such as 1./3, are not simplified to the number being approximated; the " "fraction attempts to match the floating-point value **exactly**." msgstr "" -#: whatsnew/2.6.rst:1478 +#: whatsnew/2.6.rst:1472 msgid "" "The :mod:`fractions` module is based upon an implementation by Sjoerd " "Mullender that was in Python's :file:`Demo/classes/` directory for a long " "time. This implementation was significantly updated by Jeffrey Yasskin." msgstr "" -#: whatsnew/2.6.rst:1485 +#: whatsnew/2.6.rst:1479 msgid "Other Language Changes" msgstr "" -#: whatsnew/2.6.rst:1487 +#: whatsnew/2.6.rst:1481 msgid "Some smaller changes made to the core Python language are:" msgstr "" -#: whatsnew/2.6.rst:1489 +#: whatsnew/2.6.rst:1483 msgid "" "Directories and zip archives containing a :file:`__main__.py` file can now " "be executed directly by passing their name to the interpreter. The directory " @@ -1625,7 +1625,7 @@ msgid "" "J. Eby and Nick Coghlan; :issue:`1739468`.)" msgstr "" -#: whatsnew/2.6.rst:1496 +#: whatsnew/2.6.rst:1490 msgid "" "The :func:`hasattr` function was catching and ignoring all errors, under the " "assumption that they meant a :meth:`__getattr__` method was failing somehow " @@ -1636,30 +1636,30 @@ msgid "" "`2196`.)" msgstr "" -#: whatsnew/2.6.rst:1504 +#: whatsnew/2.6.rst:1498 msgid "" "When calling a function using the ``**`` syntax to provide keyword " "arguments, you are no longer required to use a Python dictionary; any " "mapping will now work::" msgstr "" -#: whatsnew/2.6.rst:1517 +#: whatsnew/2.6.rst:1511 msgid "(Contributed by Alexander Belopolsky; :issue:`1686487`.)" msgstr "" -#: whatsnew/2.6.rst:1519 +#: whatsnew/2.6.rst:1513 msgid "" "It's also become legal to provide keyword arguments after a ``*args`` " "argument to a function call. ::" msgstr "" -#: whatsnew/2.6.rst:1528 +#: whatsnew/2.6.rst:1522 msgid "" "Previously this would have been a syntax error. (Contributed by Amaury " "Forgeot d'Arc; :issue:`3473`.)" msgstr "" -#: whatsnew/2.6.rst:1531 +#: whatsnew/2.6.rst:1525 msgid "" "A new builtin, ``next(iterator, [default])`` returns the next item from the " "specified iterator. If the *default* argument is supplied, it will be " @@ -1667,17 +1667,17 @@ msgid "" "`StopIteration` exception will be raised. (Backported in :issue:`2719`.)" msgstr "" -#: whatsnew/2.6.rst:1537 +#: whatsnew/2.6.rst:1531 msgid "" "Tuples now have :meth:`index` and :meth:`count` methods matching the list " "type's :meth:`index` and :meth:`count` methods::" msgstr "" -#: whatsnew/2.6.rst:1546 +#: whatsnew/2.6.rst:1540 msgid "(Contributed by Raymond Hettinger)" msgstr "" -#: whatsnew/2.6.rst:1548 +#: whatsnew/2.6.rst:1542 msgid "" "The built-in types now have improved support for extended slicing syntax, " "accepting various combinations of ``(start, stop, step)``. Previously, the " @@ -1685,7 +1685,7 @@ msgid "" "Thomas Wouters.)" msgstr "" -#: whatsnew/2.6.rst:1555 +#: whatsnew/2.6.rst:1549 msgid "" "Properties now have three attributes, :attr:`getter`, :attr:`setter` and :" "attr:`deleter`, that are decorators providing useful shortcuts for adding a " @@ -1693,18 +1693,18 @@ msgid "" "them like this::" msgstr "" -#: whatsnew/2.6.rst:1582 +#: whatsnew/2.6.rst:1576 msgid "" "Several methods of the built-in set types now accept multiple iterables: :" "meth:`intersection`, :meth:`intersection_update`, :meth:`union`, :meth:" "`update`, :meth:`difference` and :meth:`difference_update`." msgstr "" -#: whatsnew/2.6.rst:1881 whatsnew/2.6.rst:1902 +#: whatsnew/2.6.rst:1875 whatsnew/2.6.rst:1896 msgid "(Contributed by Raymond Hettinger.)" msgstr "" -#: whatsnew/2.6.rst:1598 +#: whatsnew/2.6.rst:1592 msgid "" "Many floating-point features were added. The :func:`float` function will " "now turn the string ``nan`` into an IEEE 754 Not A Number value, and " @@ -1713,14 +1713,14 @@ msgid "" "`1635`.)" msgstr "" -#: whatsnew/2.6.rst:1604 +#: whatsnew/2.6.rst:1598 msgid "" "Other functions in the :mod:`math` module, :func:`isinf` and :func:`isnan`, " "return true if their floating-point argument is infinite or Not A Number. (:" "issue:`1640`)" msgstr "" -#: whatsnew/2.6.rst:1608 +#: whatsnew/2.6.rst:1602 msgid "" "Conversion functions were added to convert floating-point numbers into " "hexadecimal strings (:issue:`3008`). These functions convert floats to and " @@ -1730,7 +1730,7 @@ msgid "" "converts a string back into a number::" msgstr "" -#: whatsnew/2.6.rst:1625 +#: whatsnew/2.6.rst:1619 msgid "" "A numerical nicety: when creating a complex number from two floats on " "systems that support signed zeros (-0 and +0), the :func:`complex` " @@ -1738,7 +1738,7 @@ msgid "" "Dickinson; :issue:`1507`.)" msgstr "" -#: whatsnew/2.6.rst:1630 +#: whatsnew/2.6.rst:1624 msgid "" "Classes that inherit a :meth:`__hash__` method from a parent class can set " "``__hash__ = None`` to indicate that the class isn't hashable. This will " @@ -1746,7 +1746,7 @@ msgid "" "indicated as implementing the :class:`Hashable` ABC." msgstr "" -#: whatsnew/2.6.rst:1636 +#: whatsnew/2.6.rst:1630 msgid "" "You should do this when you've defined a :meth:`__cmp__` or :meth:`__eq__` " "method that compares objects by their value rather than by identity. All " @@ -1758,7 +1758,7 @@ msgid "" "d'Arc; :issue:`2235`.)" msgstr "" -#: whatsnew/2.6.rst:1646 +#: whatsnew/2.6.rst:1640 msgid "" "The :exc:`GeneratorExit` exception now subclasses :exc:`BaseException` " "instead of :exc:`Exception`. This means that an exception handler that does " @@ -1766,20 +1766,20 @@ msgid "" "(Contributed by Chad Austin; :issue:`1537`.)" msgstr "" -#: whatsnew/2.6.rst:1652 +#: whatsnew/2.6.rst:1646 msgid "" "Generator objects now have a :attr:`gi_code` attribute that refers to the " "original code object backing the generator. (Contributed by Collin Winter; :" "issue:`1473257`.)" msgstr "" -#: whatsnew/2.6.rst:1656 +#: whatsnew/2.6.rst:1650 msgid "" "The :func:`compile` built-in function now accepts keyword arguments as well " "as positional parameters. (Contributed by Thomas Wouters; :issue:`1444529`.)" msgstr "" -#: whatsnew/2.6.rst:1660 +#: whatsnew/2.6.rst:1654 msgid "" "The :func:`complex` constructor now accepts strings containing parenthesized " "complex numbers, meaning that ``complex(repr(cplx))`` will now round-trip " @@ -1787,7 +1787,7 @@ msgid "" "issue:`1491866`)" msgstr "" -#: whatsnew/2.6.rst:1665 +#: whatsnew/2.6.rst:1659 msgid "" "The string :meth:`translate` method now accepts ``None`` as the translation " "table parameter, which is treated as the identity transformation. This " @@ -1796,7 +1796,7 @@ msgid "" "`1193128`.)" msgstr "" -#: whatsnew/2.6.rst:1671 +#: whatsnew/2.6.rst:1665 msgid "" "The built-in :func:`dir` function now checks for a :meth:`__dir__` method on " "the objects it receives. This method must return a list of strings " @@ -1806,7 +1806,7 @@ msgid "" "pseudo-attributes they will honor. (:issue:`1591665`)" msgstr "" -#: whatsnew/2.6.rst:1679 +#: whatsnew/2.6.rst:1673 msgid "" "Instance method objects have new attributes for the object and function " "comprising the method; the new synonym for :attr:`!im_self` is :attr:" @@ -1815,7 +1815,7 @@ msgid "" "3.0." msgstr "" -#: whatsnew/2.6.rst:1685 +#: whatsnew/2.6.rst:1679 msgid "" "An obscure change: when you use the :func:`locals` function inside a :" "keyword:`class` statement, the resulting dictionary no longer returns free " @@ -1823,11 +1823,11 @@ msgid "" "keyword:`!class` statement that aren't attributes of the class.)" msgstr "" -#: whatsnew/2.6.rst:1694 +#: whatsnew/2.6.rst:1688 msgid "Optimizations" msgstr "" -#: whatsnew/2.6.rst:1696 +#: whatsnew/2.6.rst:1690 msgid "" "The :mod:`warnings` module has been rewritten in C. This makes it possible " "to invoke warnings from the parser, and may also make the interpreter's " @@ -1835,7 +1835,7 @@ msgid "" "`1631171`.)" msgstr "" -#: whatsnew/2.6.rst:1701 +#: whatsnew/2.6.rst:1695 msgid "" "Type objects now have a cache of methods that can reduce the work required " "to find the correct method implementation for a particular class; once " @@ -1846,7 +1846,7 @@ msgid "" "updated for Python 2.6 by Kevin Jacobs; :issue:`1700288`.)" msgstr "" -#: whatsnew/2.6.rst:1711 +#: whatsnew/2.6.rst:1705 msgid "" "By default, this change is only applied to types that are included with the " "Python core. Extension modules may not necessarily be compatible with this " @@ -1858,7 +1858,7 @@ msgid "" "interpreter to determine that. See :issue:`1878` for some discussion.)" msgstr "" -#: whatsnew/2.6.rst:1722 +#: whatsnew/2.6.rst:1716 msgid "" "Function calls that use keyword arguments are significantly faster by doing " "a quick pointer comparison, usually saving the time of a full string " @@ -1866,21 +1866,21 @@ msgid "" "implementation by Antoine Pitrou; :issue:`1819`.)" msgstr "" -#: whatsnew/2.6.rst:1727 +#: whatsnew/2.6.rst:1721 msgid "" "All of the functions in the :mod:`struct` module have been rewritten in C, " "thanks to work at the Need For Speed sprint. (Contributed by Raymond " "Hettinger.)" msgstr "" -#: whatsnew/2.6.rst:1731 +#: whatsnew/2.6.rst:1725 msgid "" "Some of the standard built-in types now set a bit in their type objects. " "This speeds up checking whether an object is a subclass of one of these " "types. (Contributed by Neal Norwitz.)" msgstr "" -#: whatsnew/2.6.rst:1735 +#: whatsnew/2.6.rst:1729 msgid "" "Unicode strings now use faster code for detecting whitespace and line " "breaks; this speeds up the :meth:`split` method by about 25% and :meth:" @@ -1888,24 +1888,24 @@ msgid "" "reduced by using pymalloc for the Unicode string's data." msgstr "" -#: whatsnew/2.6.rst:1741 +#: whatsnew/2.6.rst:1735 msgid "" "The ``with`` statement now stores the :meth:`~object.__exit__` method on the " "stack, producing a small speedup. (Implemented by Jeffrey Yasskin.)" msgstr "" -#: whatsnew/2.6.rst:1744 +#: whatsnew/2.6.rst:1738 msgid "" "To reduce memory usage, the garbage collector will now clear internal free " "lists when garbage-collecting the highest generation of objects. This may " "return memory to the operating system sooner." msgstr "" -#: whatsnew/2.6.rst:1753 +#: whatsnew/2.6.rst:1747 msgid "Interpreter Changes" msgstr "" -#: whatsnew/2.6.rst:1755 +#: whatsnew/2.6.rst:1749 msgid "" "Two command-line options have been reserved for use by other Python " "implementations. The :option:`-J` switch has been reserved for use by " @@ -1916,7 +1916,7 @@ msgid "" "the option isn't currently used." msgstr "" -#: whatsnew/2.6.rst:1763 +#: whatsnew/2.6.rst:1757 msgid "" "Python can now be prevented from writing :file:`.pyc` or :file:`.pyo` files " "by supplying the :option:`-B` switch to the Python interpreter, or by " @@ -1927,7 +1927,7 @@ msgid "" "and Georg Brandl.)" msgstr "" -#: whatsnew/2.6.rst:1771 +#: whatsnew/2.6.rst:1765 msgid "" "The encoding used for standard input, output, and standard error can be " "specified by setting the :envvar:`PYTHONIOENCODING` environment variable " @@ -1939,11 +1939,11 @@ msgid "" "\"replace\". (Contributed by Martin von Löwis.)" msgstr "" -#: whatsnew/2.6.rst:1784 +#: whatsnew/2.6.rst:1778 msgid "New and Improved Modules" msgstr "" -#: whatsnew/2.6.rst:1786 +#: whatsnew/2.6.rst:1780 msgid "" "As in every release, Python's standard library received a number of " "enhancements and bug fixes. Here's a partial list of the most notable " @@ -1952,14 +1952,14 @@ msgid "" "the Subversion logs for all the details." msgstr "" -#: whatsnew/2.6.rst:1792 +#: whatsnew/2.6.rst:1786 msgid "" "The :mod:`!asyncore` and :mod:`!asynchat` modules are being actively " "maintained again, and a number of patches and bugfixes were applied. " "(Maintained by Josiah Carlson; see :issue:`1736190` for one patch.)" msgstr "" -#: whatsnew/2.6.rst:1797 +#: whatsnew/2.6.rst:1791 msgid "" "The :mod:`bsddb` module also has a new maintainer, Jesús Cea Avión, and the " "package is now available as a standalone package. The web page for the " @@ -1969,14 +1969,14 @@ msgid "" "frequent than Python's." msgstr "" -#: whatsnew/2.6.rst:1805 +#: whatsnew/2.6.rst:1799 msgid "" "The :mod:`bsddb.dbshelve` module now uses the highest pickling protocol " "available, instead of restricting itself to protocol 1. (Contributed by W. " "Barnes.)" msgstr "" -#: whatsnew/2.6.rst:1809 +#: whatsnew/2.6.rst:1803 msgid "" "The :mod:`cgi` module will now read variables from the query string of an " "HTTP POST request. This makes it possible to use form actions with URLs " @@ -1984,51 +1984,51 @@ msgid "" "(Contributed by Alexandre Fiori and Nubis; :issue:`1817`.)" msgstr "" -#: whatsnew/2.6.rst:1815 +#: whatsnew/2.6.rst:1809 msgid "" "The :func:`parse_qs` and :func:`parse_qsl` functions have been relocated " -"from the :mod:`cgi` module to the :mod:`urlparse` module. The versions still " -"available in the :mod:`cgi` module will trigger :exc:" +"from the :mod:`cgi` module to the :mod:`urlparse ` module. The " +"versions still available in the :mod:`!cgi` module will trigger :exc:" "`PendingDeprecationWarning` messages in 2.6 (:issue:`600362`)." msgstr "" -#: whatsnew/2.6.rst:1821 +#: whatsnew/2.6.rst:1815 msgid "" "The :mod:`cmath` module underwent extensive revision, contributed by Mark " "Dickinson and Christian Heimes. Five new functions were added:" msgstr "" -#: whatsnew/2.6.rst:1825 +#: whatsnew/2.6.rst:1819 msgid "" ":func:`polar` converts a complex number to polar form, returning the modulus " "and argument of the complex number." msgstr "" -#: whatsnew/2.6.rst:1828 +#: whatsnew/2.6.rst:1822 msgid "" ":func:`rect` does the opposite, turning a modulus, argument pair back into " "the corresponding complex number." msgstr "" -#: whatsnew/2.6.rst:1831 +#: whatsnew/2.6.rst:1825 msgid "" ":func:`phase` returns the argument (also called the angle) of a complex " "number." msgstr "" -#: whatsnew/2.6.rst:1834 +#: whatsnew/2.6.rst:1828 msgid "" ":func:`isnan` returns True if either the real or imaginary part of its " "argument is a NaN." msgstr "" -#: whatsnew/2.6.rst:1837 +#: whatsnew/2.6.rst:1831 msgid "" ":func:`isinf` returns True if either the real or imaginary part of its " "argument is infinite." msgstr "" -#: whatsnew/2.6.rst:1840 +#: whatsnew/2.6.rst:1834 msgid "" "The revisions also improved the numerical soundness of the :mod:`cmath` " "module. For all functions, the real and imaginary parts of the results are " @@ -2037,27 +2037,27 @@ msgid "" "`atanh`: and :func:`atan` have also been corrected." msgstr "" -#: whatsnew/2.6.rst:1847 +#: whatsnew/2.6.rst:1841 msgid "" "The tests for the module have been greatly expanded; nearly 2000 new test " "cases exercise the algebraic functions." msgstr "" -#: whatsnew/2.6.rst:1850 +#: whatsnew/2.6.rst:1844 msgid "" "On IEEE 754 platforms, the :mod:`cmath` module now handles IEEE 754 special " "values and floating-point exceptions in a manner consistent with Annex 'G' " "of the C99 standard." msgstr "" -#: whatsnew/2.6.rst:1854 +#: whatsnew/2.6.rst:1848 msgid "" "A new data type in the :mod:`collections` module: ``namedtuple(typename, " "fieldnames)`` is a factory function that creates subclasses of the standard " "tuple whose fields are accessible by name as well as index. For example::" msgstr "" -#: whatsnew/2.6.rst:1876 +#: whatsnew/2.6.rst:1870 msgid "" "Several places in the standard library that returned tuples have been " "modified to return :func:`namedtuple` instances. For example, the :meth:" @@ -2065,7 +2065,7 @@ msgid "" "`digits`, and :attr:`exponent` fields." msgstr "" -#: whatsnew/2.6.rst:1883 +#: whatsnew/2.6.rst:1877 msgid "" "Another change to the :mod:`collections` module is that the :class:`deque` " "type now supports an optional *maxlen* parameter; if supplied, the deque's " @@ -2073,22 +2073,23 @@ msgid "" "to a full deque causes old items to be discarded." msgstr "" -#: whatsnew/2.6.rst:1904 +#: whatsnew/2.6.rst:1898 msgid "" -"The :mod:`Cookie` module's :class:`Morsel` objects now support an :attr:" -"`httponly` attribute. In some browsers. cookies with this attribute set " -"cannot be accessed or manipulated by JavaScript code. (Contributed by Arvin " -"Schnell; :issue:`1638033`.)" +"The :mod:`Cookie ` module's :class:`~http.cookies.Morsel` " +"objects now support an :attr:`~http.cookies.Morsel.httponly` attribute. In " +"some browsers. cookies with this attribute set cannot be accessed or " +"manipulated by JavaScript code. (Contributed by Arvin Schnell; :issue:" +"`1638033`.)" msgstr "" -#: whatsnew/2.6.rst:1909 +#: whatsnew/2.6.rst:1903 msgid "" "A new window method in the :mod:`curses` module, :meth:`chgat`, changes the " "display attributes for a certain number of characters on a single line. " "(Contributed by Fabian Kreutz.)" msgstr "" -#: whatsnew/2.6.rst:1919 +#: whatsnew/2.6.rst:1913 msgid "" "The :class:`Textbox` class in the :mod:`curses.textpad` module now supports " "editing in insert mode as well as overwrite mode. Insert mode is enabled by " @@ -2096,7 +2097,7 @@ msgid "" "class:`Textbox` instance." msgstr "" -#: whatsnew/2.6.rst:1924 +#: whatsnew/2.6.rst:1918 msgid "" "The :mod:`datetime` module's :meth:`strftime` methods now support a ``%f`` " "format code that expands to the number of microseconds in the object, zero-" @@ -2104,7 +2105,7 @@ msgid "" "`1158`.)" msgstr "" -#: whatsnew/2.6.rst:1929 +#: whatsnew/2.6.rst:1923 msgid "" "The :mod:`decimal` module was updated to version 1.66 of `the General " "Decimal Specification `__. " @@ -2112,26 +2113,26 @@ msgid "" "as :meth:`exp` and :meth:`log10`::" msgstr "" -#: whatsnew/2.6.rst:1941 +#: whatsnew/2.6.rst:1935 msgid "" "The :meth:`as_tuple` method of :class:`Decimal` objects now returns a named " "tuple with :attr:`sign`, :attr:`digits`, and :attr:`exponent` fields." msgstr "" -#: whatsnew/2.6.rst:1944 +#: whatsnew/2.6.rst:1938 msgid "" "(Implemented by Facundo Batista and Mark Dickinson. Named tuple support " "added by Raymond Hettinger.)" msgstr "" -#: whatsnew/2.6.rst:1947 +#: whatsnew/2.6.rst:1941 msgid "" "The :mod:`difflib` module's :class:`SequenceMatcher` class now returns named " "tuples representing matches, with :attr:`a`, :attr:`b`, and :attr:`size` " "attributes. (Contributed by Raymond Hettinger.)" msgstr "" -#: whatsnew/2.6.rst:1952 +#: whatsnew/2.6.rst:1946 msgid "" "An optional ``timeout`` parameter, specifying a timeout measured in seconds, " "was added to the :class:`ftplib.FTP` class constructor as well as the :meth:" @@ -2141,7 +2142,7 @@ msgid "" "data has been sent. (Contributed by Phil Schwartz; :issue:`1221598`.)" msgstr "" -#: whatsnew/2.6.rst:1960 +#: whatsnew/2.6.rst:1954 msgid "" "The :func:`reduce` built-in function is also available in the :mod:" "`functools` module. In Python 3.0, the builtin has been dropped and :func:" @@ -2150,7 +2151,7 @@ msgid "" "issue:`1739906`.)" msgstr "" -#: whatsnew/2.6.rst:1966 +#: whatsnew/2.6.rst:1960 msgid "" "When possible, the :mod:`getpass` module will now use :file:`/dev/tty` to " "print a prompt message and read the password, falling back to standard error " @@ -2159,14 +2160,14 @@ msgid "" "P. Smith.)" msgstr "" -#: whatsnew/2.6.rst:1972 +#: whatsnew/2.6.rst:1966 msgid "" "The :func:`glob.glob` function can now return Unicode filenames if a Unicode " "path was used and Unicode filenames are matched within the directory. (:" "issue:`1001604`)" msgstr "" -#: whatsnew/2.6.rst:1976 +#: whatsnew/2.6.rst:1970 msgid "" "A new function in the :mod:`heapq` module, ``merge(iter1, iter2, ...)``, " "takes any number of iterables returning data in sorted order, and returns a " @@ -2174,14 +2175,14 @@ msgid "" "order. For example::" msgstr "" -#: whatsnew/2.6.rst:1984 +#: whatsnew/2.6.rst:1978 msgid "" "Another new function, ``heappushpop(heap, item)``, pushes *item* onto " "*heap*, then pops off and returns the smallest item. This is more efficient " "than making a call to :func:`heappush` and then :func:`heappop`." msgstr "" -#: whatsnew/2.6.rst:1989 +#: whatsnew/2.6.rst:1983 msgid "" ":mod:`heapq` is now implemented to only use less-than comparison, instead of " "the less-than-or-equal comparison it previously used. This makes :mod:" @@ -2189,14 +2190,15 @@ msgid "" "by Raymond Hettinger.)" msgstr "" -#: whatsnew/2.6.rst:1995 +#: whatsnew/2.6.rst:1989 msgid "" "An optional ``timeout`` parameter, specifying a timeout measured in seconds, " -"was added to the :class:`httplib.HTTPConnection` and :class:" -"`HTTPSConnection` class constructors. (Added by Facundo Batista.)" +"was added to the :class:`httplib.HTTPConnection ` and :class:`HTTPSConnection ` " +"class constructors. (Added by Facundo Batista.)" msgstr "" -#: whatsnew/2.6.rst:2000 +#: whatsnew/2.6.rst:1994 msgid "" "Most of the :mod:`inspect` module's functions, such as :func:`getmoduleinfo` " "and :func:`getargs`, now return named tuples. In addition to behaving like " @@ -2204,55 +2206,55 @@ msgid "" "attributes. (Contributed by Raymond Hettinger.)" msgstr "" -#: whatsnew/2.6.rst:2006 +#: whatsnew/2.6.rst:2000 msgid "" "Some new functions in the module include :func:`isgenerator`, :func:" "`isgeneratorfunction`, and :func:`isabstract`." msgstr "" -#: whatsnew/2.6.rst:2010 +#: whatsnew/2.6.rst:2004 msgid "The :mod:`itertools` module gained several new functions." msgstr "" -#: whatsnew/2.6.rst:2012 +#: whatsnew/2.6.rst:2006 msgid "" "``izip_longest(iter1, iter2, ...[, fillvalue])`` makes tuples from each of " "the elements; if some of the iterables are shorter than others, the missing " "values are set to *fillvalue*. For example::" msgstr "" -#: whatsnew/2.6.rst:2019 +#: whatsnew/2.6.rst:2013 msgid "" "``product(iter1, iter2, ..., [repeat=N])`` returns the Cartesian product of " "the supplied iterables, a set of tuples containing every possible " "combination of the elements returned from each iterable. ::" msgstr "" -#: whatsnew/2.6.rst:2028 +#: whatsnew/2.6.rst:2022 msgid "" "The optional *repeat* keyword argument is used for taking the product of an " "iterable or a set of iterables with themselves, repeated *N* times. With a " "single iterable argument, *N*-tuples are returned::" msgstr "" -#: whatsnew/2.6.rst:2037 +#: whatsnew/2.6.rst:2031 msgid "With two iterables, *2N*-tuples are returned. ::" msgstr "" -#: whatsnew/2.6.rst:2045 +#: whatsnew/2.6.rst:2039 msgid "" "``combinations(iterable, r)`` returns sub-sequences of length *r* from the " "elements of *iterable*. ::" msgstr "" -#: whatsnew/2.6.rst:2056 +#: whatsnew/2.6.rst:2050 msgid "" "``permutations(iter[, r])`` returns all the permutations of length *r* of " "the iterable's elements. If *r* is not specified, it will default to the " "number of elements produced by the iterable. ::" msgstr "" -#: whatsnew/2.6.rst:2066 +#: whatsnew/2.6.rst:2060 msgid "" "``itertools.chain(*iterables)`` is an existing function in :mod:`itertools` " "that gained a new constructor in Python 2.6. ``itertools.chain." @@ -2261,11 +2263,11 @@ msgid "" "iterable, then all the elements of the second, and so on. ::" msgstr "" -#: whatsnew/2.6.rst:2076 +#: whatsnew/2.6.rst:2070 msgid "(All contributed by Raymond Hettinger.)" msgstr "" -#: whatsnew/2.6.rst:2078 +#: whatsnew/2.6.rst:2072 msgid "" "The :mod:`logging` module's :class:`FileHandler` class and its subclasses :" "class:`WatchedFileHandler`, :class:`RotatingFileHandler`, and :class:" @@ -2274,68 +2276,68 @@ msgid "" "the first :meth:`emit` call is made. (Contributed by Vinay Sajip.)" msgstr "" -#: whatsnew/2.6.rst:2085 +#: whatsnew/2.6.rst:2079 msgid "" ":class:`TimedRotatingFileHandler` also has a *utc* constructor parameter. " "If the argument is true, UTC time will be used in determining when midnight " "occurs and in generating filenames; otherwise local time will be used." msgstr "" -#: whatsnew/2.6.rst:2090 +#: whatsnew/2.6.rst:2084 msgid "Several new functions were added to the :mod:`math` module:" msgstr "" -#: whatsnew/2.6.rst:2092 +#: whatsnew/2.6.rst:2086 msgid "" ":func:`~math.isinf` and :func:`~math.isnan` determine whether a given float " "is a (positive or negative) infinity or a NaN (Not a Number), respectively." msgstr "" -#: whatsnew/2.6.rst:2095 +#: whatsnew/2.6.rst:2089 msgid "" ":func:`~math.copysign` copies the sign bit of an IEEE 754 number, returning " "the absolute value of *x* combined with the sign bit of *y*. For example, " "``math.copysign(1, -0.0)`` returns -1.0. (Contributed by Christian Heimes.)" msgstr "" -#: whatsnew/2.6.rst:2100 +#: whatsnew/2.6.rst:2094 msgid "" ":func:`~math.factorial` computes the factorial of a number. (Contributed by " "Raymond Hettinger; :issue:`2138`.)" msgstr "" -#: whatsnew/2.6.rst:2103 +#: whatsnew/2.6.rst:2097 msgid "" ":func:`~math.fsum` adds up the stream of numbers from an iterable, and is " "careful to avoid loss of precision through using partial sums. (Contributed " "by Jean Brouwers, Raymond Hettinger, and Mark Dickinson; :issue:`2819`.)" msgstr "" -#: whatsnew/2.6.rst:2108 +#: whatsnew/2.6.rst:2102 msgid "" ":func:`~math.acosh`, :func:`~math.asinh` and :func:`~math.atanh` compute the " "inverse hyperbolic functions." msgstr "" -#: whatsnew/2.6.rst:2111 +#: whatsnew/2.6.rst:2105 msgid ":func:`~math.log1p` returns the natural logarithm of *1+x* (base *e*)." msgstr "" -#: whatsnew/2.6.rst:2114 +#: whatsnew/2.6.rst:2108 msgid "" ":func:`trunc` rounds a number toward zero, returning the closest :class:" "`Integral` that's between the function's argument and zero. Added as part of " "the backport of `PEP 3141's type hierarchy for numbers <#pep-3141>`__." msgstr "" -#: whatsnew/2.6.rst:2119 +#: whatsnew/2.6.rst:2113 msgid "" "The :mod:`math` module has been improved to give more consistent behaviour " "across platforms, especially with respect to handling of floating-point " "exceptions and IEEE 754 special values." msgstr "" -#: whatsnew/2.6.rst:2123 +#: whatsnew/2.6.rst:2117 msgid "" "Whenever possible, the module follows the recommendations of the C99 " "standard about 754's special values. For example, ``sqrt(-1.)`` should now " @@ -2347,11 +2349,11 @@ msgid "" "`OverflowError`. (See :issue:`711019` and :issue:`1640`.)" msgstr "" -#: whatsnew/2.6.rst:2133 +#: whatsnew/2.6.rst:2127 msgid "(Contributed by Christian Heimes and Mark Dickinson.)" msgstr "" -#: whatsnew/2.6.rst:2135 +#: whatsnew/2.6.rst:2129 msgid "" ":class:`~mmap.mmap` objects now have a :meth:`rfind` method that searches " "for a substring beginning at the end of the string and searching backwards. " @@ -2359,28 +2361,28 @@ msgid "" "which to stop searching. (Contributed by John Lenton.)" msgstr "" -#: whatsnew/2.6.rst:2141 +#: whatsnew/2.6.rst:2135 msgid "" "The :mod:`operator` module gained a :func:`methodcaller` function that takes " "a name and an optional set of arguments, returning a callable that will call " "the named function on any arguments passed to it. For example::" msgstr "" -#: whatsnew/2.6.rst:2151 +#: whatsnew/2.6.rst:2145 msgid "(Contributed by Georg Brandl, after a suggestion by Gregory Petrosyan.)" msgstr "" -#: whatsnew/2.6.rst:2153 +#: whatsnew/2.6.rst:2147 msgid "" "The :func:`attrgetter` function now accepts dotted names and performs the " "corresponding attribute lookups::" msgstr "" -#: whatsnew/2.6.rst:2163 +#: whatsnew/2.6.rst:2157 msgid "(Contributed by Georg Brandl, after a suggestion by Barry Warsaw.)" msgstr "" -#: whatsnew/2.6.rst:2165 +#: whatsnew/2.6.rst:2159 msgid "" "The :mod:`os` module now wraps several new system calls. ``fchmod(fd, " "mode)`` and ``fchown(fd, uid, gid)`` change the mode and ownership of an " @@ -2388,7 +2390,7 @@ msgid "" "(Contributed by Georg Brandl and Christian Heimes.)" msgstr "" -#: whatsnew/2.6.rst:2171 +#: whatsnew/2.6.rst:2165 msgid "" ":func:`chflags` and :func:`lchflags` are wrappers for the corresponding " "system calls (where they're available), changing the flags set on a file. " @@ -2398,7 +2400,7 @@ msgid "" "the file. (Contributed by M. Levinson.)" msgstr "" -#: whatsnew/2.6.rst:2179 +#: whatsnew/2.6.rst:2173 msgid "" "``os.closerange(low, high)`` efficiently closes all file descriptors from " "*low* to *high*, ignoring any errors and not including *high* itself. This " @@ -2406,14 +2408,14 @@ msgid "" "processes faster. (Contributed by Georg Brandl; :issue:`1663329`.)" msgstr "" -#: whatsnew/2.6.rst:2184 +#: whatsnew/2.6.rst:2178 msgid "" "The ``os.environ`` object's :meth:`clear` method will now unset the " "environment variables using :func:`os.unsetenv` in addition to clearing the " "object's keys. (Contributed by Martin Horcicka; :issue:`1181`.)" msgstr "" -#: whatsnew/2.6.rst:2188 +#: whatsnew/2.6.rst:2182 msgid "" "The :func:`os.walk` function now has a ``followlinks`` parameter. If set to " "True, it will follow symlinks pointing to directories and visit the " @@ -2422,7 +2424,7 @@ msgid "" "if there's a symlink that points to a parent directory. (:issue:`1273829`)" msgstr "" -#: whatsnew/2.6.rst:2195 +#: whatsnew/2.6.rst:2189 msgid "" "In the :mod:`os.path` module, the :func:`splitext` function has been changed " "to not split on leading period characters. This produces better results when " @@ -2431,7 +2433,7 @@ msgid "" "`1115886`)" msgstr "" -#: whatsnew/2.6.rst:2202 +#: whatsnew/2.6.rst:2196 msgid "" "A new function, ``os.path.relpath(path, start='.')``, returns a relative " "path from the ``start`` path, if it's supplied, or from the current working " @@ -2439,14 +2441,14 @@ msgid "" "issue:`1339796`.)" msgstr "" -#: whatsnew/2.6.rst:2207 +#: whatsnew/2.6.rst:2201 msgid "" "On Windows, :func:`os.path.expandvars` will now expand environment variables " "given in the form \"%var%\", and \"~user\" will be expanded into the user's " "home directory path. (Contributed by Josiah Carlson; :issue:`957650`.)" msgstr "" -#: whatsnew/2.6.rst:2212 +#: whatsnew/2.6.rst:2206 msgid "" "The Python debugger provided by the :mod:`pdb` module gained a new command: " "\"run\" restarts the Python program being debugged and can optionally take " @@ -2454,14 +2456,14 @@ msgid "" "Bernstein; :issue:`1393667`.)" msgstr "" -#: whatsnew/2.6.rst:2217 +#: whatsnew/2.6.rst:2211 msgid "" "The :func:`pdb.post_mortem` function, used to begin debugging a traceback, " "will now use the traceback returned by :func:`sys.exc_info` if no traceback " "is supplied. (Contributed by Facundo Batista; :issue:`1106316`.)" msgstr "" -#: whatsnew/2.6.rst:2222 +#: whatsnew/2.6.rst:2216 msgid "" "The :mod:`pickletools` module now has an :func:`optimize` function that " "takes a string containing a pickle and removes some unused opcodes, " @@ -2469,25 +2471,25 @@ msgid "" "(Contributed by Raymond Hettinger.)" msgstr "" -#: whatsnew/2.6.rst:2227 +#: whatsnew/2.6.rst:2221 msgid "" "A :func:`get_data` function was added to the :mod:`pkgutil` module that " "returns the contents of resource files included with an installed Python " "package. For example::" msgstr "" -#: whatsnew/2.6.rst:2242 +#: whatsnew/2.6.rst:2236 msgid "(Contributed by Paul Moore; :issue:`2439`.)" msgstr "" -#: whatsnew/2.6.rst:2244 +#: whatsnew/2.6.rst:2238 msgid "" "The :mod:`pyexpat` module's :class:`Parser` objects now allow setting their :" "attr:`buffer_size` attribute to change the size of the buffer used to hold " "character data. (Contributed by Achim Gaedke; :issue:`1137`.)" msgstr "" -#: whatsnew/2.6.rst:2249 +#: whatsnew/2.6.rst:2243 msgid "" "The :mod:`Queue` module now provides queue variants that retrieve entries in " "different orders. The :class:`PriorityQueue` class stores queued items in a " @@ -2496,7 +2498,7 @@ msgid "" "(Contributed by Raymond Hettinger.)" msgstr "" -#: whatsnew/2.6.rst:2256 +#: whatsnew/2.6.rst:2250 msgid "" "The :mod:`random` module's :class:`Random` objects can now be pickled on a " "32-bit system and unpickled on a 64-bit system, and vice versa. " @@ -2505,7 +2507,7 @@ msgid "" "(Contributed by Shawn Ligocki; :issue:`1727780`.)" msgstr "" -#: whatsnew/2.6.rst:2263 +#: whatsnew/2.6.rst:2257 msgid "" "The new ``triangular(low, high, mode)`` function returns random numbers " "following a triangular distribution. The returned values are between *low* " @@ -2514,14 +2516,14 @@ msgid "" "der Laan and Raymond Hettinger; :issue:`1681432`.)" msgstr "" -#: whatsnew/2.6.rst:2270 +#: whatsnew/2.6.rst:2264 msgid "" "Long regular expression searches carried out by the :mod:`re` module will " "check for signals being delivered, so time-consuming searches can now be " "interrupted. (Contributed by Josh Hoyt and Ralf Schmitt; :issue:`846388`.)" msgstr "" -#: whatsnew/2.6.rst:2275 +#: whatsnew/2.6.rst:2269 msgid "" "The regular expression module is implemented by compiling bytecodes for a " "tiny regex-specific virtual machine. Untrusted code could create malicious " @@ -2530,14 +2532,14 @@ msgid "" "for Google App Engine; :issue:`3487`.)" msgstr "" -#: whatsnew/2.6.rst:2282 +#: whatsnew/2.6.rst:2276 msgid "" "The :mod:`rlcompleter` module's :meth:`Completer.complete()` method will now " "ignore exceptions triggered while evaluating a name. (Fixed by Lorenz " "Quack; :issue:`2250`.)" msgstr "" -#: whatsnew/2.6.rst:2286 +#: whatsnew/2.6.rst:2280 msgid "" "The :mod:`sched` module's :class:`scheduler` instances now have a read-only :" "attr:`queue` attribute that returns the contents of the scheduler's queue, " @@ -2545,7 +2547,7 @@ msgid "" "action, argument)``. (Contributed by Raymond Hettinger; :issue:`1861`.)" msgstr "" -#: whatsnew/2.6.rst:2292 +#: whatsnew/2.6.rst:2286 msgid "" "The :mod:`select` module now has wrapper functions for the Linux :c:func:`!" "epoll` and BSD :c:func:`!kqueue` system calls. :meth:`modify` method was " @@ -2555,7 +2557,7 @@ msgid "" "Heimes; :issue:`1657`.)" msgstr "" -#: whatsnew/2.6.rst:2300 +#: whatsnew/2.6.rst:2294 msgid "" "The :func:`shutil.copytree` function now has an optional *ignore* argument " "that takes a callable object. This callable will receive each directory " @@ -2563,7 +2565,7 @@ msgid "" "that will be ignored, not copied." msgstr "" -#: whatsnew/2.6.rst:2305 +#: whatsnew/2.6.rst:2299 msgid "" "The :mod:`shutil` module also provides an :func:`ignore_patterns` function " "for use with this new parameter. :func:`ignore_patterns` takes an arbitrary " @@ -2573,11 +2575,11 @@ msgid "" "Emacs backup files, which have names ending with '~'::" msgstr "" -#: whatsnew/2.6.rst:2316 +#: whatsnew/2.6.rst:2310 msgid "(Contributed by Tarek Ziadé; :issue:`2663`.)" msgstr "" -#: whatsnew/2.6.rst:2318 +#: whatsnew/2.6.rst:2312 msgid "" "Integrating signal handling with GUI handling event loops like those used by " "Tkinter or GTk+ has long been a problem; most software ends up polling, " @@ -2589,7 +2591,7 @@ msgid "" "descriptor." msgstr "" -#: whatsnew/2.6.rst:2328 +#: whatsnew/2.6.rst:2322 msgid "" "Event loops will use this by opening a pipe to create two descriptors, one " "for reading and one for writing. The writable descriptor will be passed to :" @@ -2599,18 +2601,18 @@ msgid "" "loop will be woken up, avoiding the need to poll." msgstr "" -#: whatsnew/2.6.rst:2336 +#: whatsnew/2.6.rst:2330 msgid "(Contributed by Adam Olsen; :issue:`1583`.)" msgstr "" -#: whatsnew/2.6.rst:2338 +#: whatsnew/2.6.rst:2332 msgid "" "The :func:`siginterrupt` function is now available from Python code, and " "allows changing whether signals can interrupt system calls or not. " "(Contributed by Ralf Schmitt.)" msgstr "" -#: whatsnew/2.6.rst:2342 +#: whatsnew/2.6.rst:2336 msgid "" "The :func:`setitimer` and :func:`getitimer` functions have also been added " "(where they're available). :func:`setitimer` allows setting interval timers " @@ -2619,7 +2621,7 @@ msgid "" "process+system time. (Contributed by Guilherme Polo; :issue:`2240`.)" msgstr "" -#: whatsnew/2.6.rst:2349 +#: whatsnew/2.6.rst:2343 msgid "" "The :mod:`smtplib` module now supports SMTP over SSL thanks to the addition " "of the :class:`SMTP_SSL` class. This class supports an interface identical " @@ -2629,7 +2631,7 @@ msgid "" "seconds. (Contributed by Facundo Batista.)" msgstr "" -#: whatsnew/2.6.rst:2357 +#: whatsnew/2.6.rst:2351 msgid "" "An implementation of the LMTP protocol (:rfc:`2033`) was also added to the " "module. LMTP is used in place of SMTP when transferring e-mail between " @@ -2637,14 +2639,14 @@ msgid "" "issue:`957003`.)" msgstr "" -#: whatsnew/2.6.rst:2362 +#: whatsnew/2.6.rst:2356 msgid "" ":meth:`SMTP.starttls` now complies with :rfc:`3207` and forgets any " "knowledge obtained from the server not obtained from the TLS negotiation " "itself. (Patch contributed by Bill Fenner; :issue:`829951`.)" msgstr "" -#: whatsnew/2.6.rst:2367 +#: whatsnew/2.6.rst:2361 msgid "" "The :mod:`socket` module now supports TIPC (https://tipc.sourceforge.net/), " "a high-performance non-IP-based protocol designed for use in clustered " @@ -2652,7 +2654,7 @@ msgid "" "Bertogli; :issue:`1646`.)" msgstr "" -#: whatsnew/2.6.rst:2372 +#: whatsnew/2.6.rst:2366 msgid "" "A new function, :func:`create_connection`, takes an address and connects to " "it using an optional timeout value, returning the connected socket object. " @@ -2662,39 +2664,41 @@ msgid "" "make your code work with IPv6." msgstr "" -#: whatsnew/2.6.rst:2380 +#: whatsnew/2.6.rst:2374 msgid "" -"The base classes in the :mod:`SocketServer` module now support calling a :" -"meth:`handle_timeout` method after a span of inactivity specified by the " -"server's :attr:`timeout` attribute. (Contributed by Michael Pomraning.) " -"The :meth:`serve_forever` method now takes an optional poll interval " -"measured in seconds, controlling how often the server will check for a " -"shutdown request. (Contributed by Pedro Werneck and Jeffrey Yasskin; :issue:" -"`742598`, :issue:`1193577`.)" +"The base classes in the :mod:`SocketServer ` module now " +"support calling a :meth:`~socketserver.BaseServer.handle_timeout` method " +"after a span of inactivity specified by the server's :attr:`~socketserver." +"BaseServer.timeout` attribute. (Contributed by Michael Pomraning.) The :" +"meth:`~socketserver.BaseServer.serve_forever` method now takes an optional " +"poll interval measured in seconds, controlling how often the server will " +"check for a shutdown request. (Contributed by Pedro Werneck and Jeffrey " +"Yasskin; :issue:`742598`, :issue:`1193577`.)" msgstr "" -#: whatsnew/2.6.rst:2389 +#: whatsnew/2.6.rst:2383 msgid "" "The :mod:`sqlite3` module, maintained by Gerhard Häring, has been updated " "from version 2.3.2 in Python 2.5 to version 2.4.1." msgstr "" -#: whatsnew/2.6.rst:2393 +#: whatsnew/2.6.rst:2387 msgid "" "The :mod:`struct` module now supports the C99 :c:expr:`_Bool` type, using " "the format character ``'?'``. (Contributed by David Remahl.)" msgstr "" -#: whatsnew/2.6.rst:2397 +#: whatsnew/2.6.rst:2391 msgid "" -"The :class:`Popen` objects provided by the :mod:`subprocess` module now " -"have :meth:`terminate`, :meth:`kill`, and :meth:`send_signal` methods. On " -"Windows, :meth:`send_signal` only supports the :const:`SIGTERM` signal, and " -"all these methods are aliases for the Win32 API function :c:func:" -"`TerminateProcess`. (Contributed by Christian Heimes.)" +"The :class:`~subprocess.Popen` objects provided by the :mod:`subprocess` " +"module now have :meth:`~subprocess.Popen.terminate`, :meth:`~subprocess." +"Popen.kill`, and :meth:`~subprocess.Popen.send_signal` methods. On Windows, :" +"meth:`!send_signal` only supports the :py:const:`~signal.SIGTERM` signal, " +"and all these methods are aliases for the Win32 API function :c:func:`!" +"TerminateProcess`. (Contributed by Christian Heimes.)" msgstr "" -#: whatsnew/2.6.rst:2404 +#: whatsnew/2.6.rst:2398 msgid "" "A new variable in the :mod:`sys` module, :attr:`float_info`, is an object " "containing information derived from the :file:`float.h` file about the " @@ -2704,7 +2708,7 @@ msgid "" "several others. (Contributed by Christian Heimes; :issue:`1534`.)" msgstr "" -#: whatsnew/2.6.rst:2412 +#: whatsnew/2.6.rst:2406 msgid "" "Another new variable, :attr:`dont_write_bytecode`, controls whether Python " "writes any :file:`.pyc` or :file:`.pyo` files on importing a module. If this " @@ -2716,7 +2720,7 @@ msgid "" "written or not. (Contributed by Neal Norwitz and Georg Brandl.)" msgstr "" -#: whatsnew/2.6.rst:2423 +#: whatsnew/2.6.rst:2417 msgid "" "Information about the command-line arguments supplied to the Python " "interpreter is available by reading attributes of a named tuple available as " @@ -2725,7 +2729,7 @@ msgid "" "These attributes are all read-only. (Contributed by Christian Heimes.)" msgstr "" -#: whatsnew/2.6.rst:2431 +#: whatsnew/2.6.rst:2425 msgid "" "A new function, :func:`getsizeof`, takes a Python object and returns the " "amount of memory used by the object, measured in bytes. Built-in objects " @@ -2734,14 +2738,14 @@ msgid "" "Schuppenies; :issue:`2898`.)" msgstr "" -#: whatsnew/2.6.rst:2438 +#: whatsnew/2.6.rst:2432 msgid "" "It's now possible to determine the current profiler and tracer functions by " "calling :func:`sys.getprofile` and :func:`sys.gettrace`. (Contributed by " "Georg Brandl; :issue:`1648`.)" msgstr "" -#: whatsnew/2.6.rst:2442 +#: whatsnew/2.6.rst:2436 msgid "" "The :mod:`tarfile` module now supports POSIX.1-2001 (pax) tarfiles in " "addition to the POSIX.1-1988 (ustar) and GNU tar formats that were already " @@ -2749,7 +2753,7 @@ msgid "" "to open a file using a different format::" msgstr "" -#: whatsnew/2.6.rst:2450 +#: whatsnew/2.6.rst:2444 msgid "" "The new ``encoding`` and ``errors`` parameters specify an encoding and an " "error handling scheme for character conversions. ``'strict'``, " @@ -2759,7 +2763,7 @@ msgid "" "PAX format supports Unicode filenames, defaulting to UTF-8 encoding.)" msgstr "" -#: whatsnew/2.6.rst:2458 +#: whatsnew/2.6.rst:2452 msgid "" "The :meth:`TarFile.add` method now accepts an ``exclude`` argument that's a " "function that can be used to exclude certain filenames from an archive. The " @@ -2769,18 +2773,18 @@ msgid "" "added directories." msgstr "" -#: whatsnew/2.6.rst:2466 +#: whatsnew/2.6.rst:2460 msgid "(All changes contributed by Lars Gustäbel)." msgstr "" -#: whatsnew/2.6.rst:2468 +#: whatsnew/2.6.rst:2462 msgid "" "An optional ``timeout`` parameter was added to the :class:`telnetlib.Telnet` " "class constructor, specifying a timeout measured in seconds. (Added by " "Facundo Batista.)" msgstr "" -#: whatsnew/2.6.rst:2472 +#: whatsnew/2.6.rst:2466 msgid "" "The :class:`tempfile.NamedTemporaryFile` class usually deletes the temporary " "file it created when the file is closed. This behaviour can now be changed " @@ -2788,7 +2792,7 @@ msgid "" "Miller; :issue:`1537850`.)" msgstr "" -#: whatsnew/2.6.rst:2477 +#: whatsnew/2.6.rst:2471 msgid "" "A new class, :class:`SpooledTemporaryFile`, behaves like a temporary file " "but stores its data in memory until a maximum size is exceeded. On reaching " @@ -2796,7 +2800,7 @@ msgid "" "(Contributed by Dustin J. Mitchell.)" msgstr "" -#: whatsnew/2.6.rst:2482 +#: whatsnew/2.6.rst:2476 msgid "" "The :class:`NamedTemporaryFile` and :class:`SpooledTemporaryFile` classes " "both work as context managers, so you can write ``with tempfile." @@ -2804,15 +2808,15 @@ msgid "" "issue:`2021`.)" msgstr "" -#: whatsnew/2.6.rst:2487 +#: whatsnew/2.6.rst:2481 msgid "" -"The :mod:`test.test_support` module gained a number of context managers " -"useful for writing tests. :func:`EnvironmentVarGuard` is a context manager " -"that temporarily changes environment variables and automatically restores " -"them to their old values." +"The :mod:`test.test_support ` module gained a number of " +"context managers useful for writing tests. :func:`~test.support.os_helper." +"EnvironmentVarGuard` is a context manager that temporarily changes " +"environment variables and automatically restores them to their old values." msgstr "" -#: whatsnew/2.6.rst:2493 +#: whatsnew/2.6.rst:2487 msgid "" "Another context manager, :class:`TransientResource`, can surround calls to " "resources that may or may not be available; it will catch and ignore a " @@ -2820,29 +2824,29 @@ msgid "" "certain failures when connecting to an external web site::" msgstr "" -#: whatsnew/2.6.rst:2504 +#: whatsnew/2.6.rst:2498 msgid "" "Finally, :func:`check_warnings` resets the :mod:`warning` module's warning " "filters and returns an object that will record all warning messages " "triggered (:issue:`3781`)::" msgstr "" -#: whatsnew/2.6.rst:2514 +#: whatsnew/2.6.rst:2508 msgid "(Contributed by Brett Cannon.)" msgstr "" -#: whatsnew/2.6.rst:2516 +#: whatsnew/2.6.rst:2510 msgid "" "The :mod:`textwrap` module can now preserve existing whitespace at the " "beginnings and ends of the newly created lines by specifying " "``drop_whitespace=False`` as an argument::" msgstr "" -#: whatsnew/2.6.rst:2535 +#: whatsnew/2.6.rst:2529 msgid "(Contributed by Dwayne Bailey; :issue:`1581073`.)" msgstr "" -#: whatsnew/2.6.rst:2537 +#: whatsnew/2.6.rst:2531 msgid "" "The :mod:`threading` module API is being changed to use properties such as :" "attr:`daemon` instead of :meth:`setDaemon` and :meth:`isDaemon` methods, and " @@ -2855,14 +2859,14 @@ msgid "" "Peterson.)" msgstr "" -#: whatsnew/2.6.rst:2548 +#: whatsnew/2.6.rst:2542 msgid "" "The :mod:`threading` module's :class:`Thread` objects gained an :attr:" "`ident` property that returns the thread's identifier, a nonzero integer. " "(Contributed by Gregory P. Smith; :issue:`2871`.)" msgstr "" -#: whatsnew/2.6.rst:2553 +#: whatsnew/2.6.rst:2547 msgid "" "The :mod:`timeit` module now accepts callables as well as strings for the " "statement being timed and for the setup code. Two convenience functions were " @@ -2872,80 +2876,81 @@ msgid "" "issue:`1533909`.)" msgstr "" -#: whatsnew/2.6.rst:2562 +#: whatsnew/2.6.rst:2556 msgid "" "The :mod:`Tkinter` module now accepts lists and tuples for options, " "separating the elements by spaces before passing the resulting value to Tcl/" "Tk. (Contributed by Guilherme Polo; :issue:`2906`.)" msgstr "" -#: whatsnew/2.6.rst:2567 +#: whatsnew/2.6.rst:2561 msgid "" "The :mod:`turtle` module for turtle graphics was greatly enhanced by Gregor " "Lingl. New features in the module include:" msgstr "" -#: whatsnew/2.6.rst:2570 +#: whatsnew/2.6.rst:2564 msgid "Better animation of turtle movement and rotation." msgstr "" -#: whatsnew/2.6.rst:2571 +#: whatsnew/2.6.rst:2565 msgid "" "Control over turtle movement using the new :meth:`delay`, :meth:`tracer`, " "and :meth:`speed` methods." msgstr "" -#: whatsnew/2.6.rst:2573 +#: whatsnew/2.6.rst:2567 msgid "" "The ability to set new shapes for the turtle, and to define a new coordinate " "system." msgstr "" -#: whatsnew/2.6.rst:2575 +#: whatsnew/2.6.rst:2569 msgid "Turtles now have an :meth:`undo()` method that can roll back actions." msgstr "" -#: whatsnew/2.6.rst:2576 +#: whatsnew/2.6.rst:2570 msgid "" "Simple support for reacting to input events such as mouse and keyboard " "activity, making it possible to write simple games." msgstr "" -#: whatsnew/2.6.rst:2578 +#: whatsnew/2.6.rst:2572 msgid "" "A :file:`turtle.cfg` file can be used to customize the starting appearance " "of the turtle's screen." msgstr "" -#: whatsnew/2.6.rst:2580 +#: whatsnew/2.6.rst:2574 msgid "" "The module's docstrings can be replaced by new docstrings that have been " "translated into another language." msgstr "" -#: whatsnew/2.6.rst:2583 +#: whatsnew/2.6.rst:2577 msgid "(:issue:`1513695`)" msgstr "" -#: whatsnew/2.6.rst:2585 +#: whatsnew/2.6.rst:2579 msgid "" -"An optional ``timeout`` parameter was added to the :func:`urllib.urlopen` " -"function and the :class:`urllib.ftpwrapper` class constructor, as well as " -"the :func:`urllib2.urlopen` function. The parameter specifies a timeout " -"measured in seconds. For example::" +"An optional ``timeout`` parameter was added to the :func:`urllib.urlopen " +"` function and the :class:`urllib.ftpwrapper` class " +"constructor, as well as the :func:`urllib2.urlopen ` " +"function. The parameter specifies a timeout measured in seconds. For " +"example::" msgstr "" -#: whatsnew/2.6.rst:2598 +#: whatsnew/2.6.rst:2592 msgid "(Added by Facundo Batista.)" msgstr "" -#: whatsnew/2.6.rst:2600 +#: whatsnew/2.6.rst:2594 msgid "" "The Unicode database provided by the :mod:`unicodedata` module has been " "updated to version 5.1.0. (Updated by Martin von Löwis; :issue:`3811`.)" msgstr "" -#: whatsnew/2.6.rst:2604 +#: whatsnew/2.6.rst:2598 msgid "" "The :mod:`warnings` module's :func:`formatwarning` and :func:`showwarning` " "gained an optional *line* argument that can be used to supply the line of " @@ -2953,25 +2958,26 @@ msgid "" "of the :mod:`warnings` module in C code.)" msgstr "" -#: whatsnew/2.6.rst:2609 +#: whatsnew/2.6.rst:2603 msgid "" "A new function, :func:`catch_warnings`, is a context manager intended for " "testing purposes that lets you temporarily modify the warning filters and " "then restore their original values (:issue:`3781`)." msgstr "" -#: whatsnew/2.6.rst:2613 +#: whatsnew/2.6.rst:2607 msgid "" -"The XML-RPC :class:`SimpleXMLRPCServer` and :class:`DocXMLRPCServer` classes " -"can now be prevented from immediately opening and binding to their socket by " -"passing ``False`` as the *bind_and_activate* constructor parameter. This " -"can be used to modify the instance's :attr:`allow_reuse_address` attribute " -"before calling the :meth:`server_bind` and :meth:`server_activate` methods " -"to open the socket and begin listening for connections. (Contributed by " -"Peter Parente; :issue:`1599845`.)" +"The XML-RPC :class:`SimpleXMLRPCServer ` and :class:" +"`DocXMLRPCServer ` classes can now be prevented from " +"immediately opening and binding to their socket by passing ``False`` as the " +"*bind_and_activate* constructor parameter. This can be used to modify the " +"instance's :attr:`allow_reuse_address` attribute before calling the :meth:" +"`server_bind` and :meth:`server_activate` methods to open the socket and " +"begin listening for connections. (Contributed by Peter Parente; :issue:" +"`1599845`.)" msgstr "" -#: whatsnew/2.6.rst:2622 +#: whatsnew/2.6.rst:2616 msgid "" ":class:`SimpleXMLRPCServer` also has a :attr:`_send_traceback_header` " "attribute; if true, the exception and formatted traceback are returned as " @@ -2982,30 +2988,31 @@ msgid "" "Code 2007.)" msgstr "" -#: whatsnew/2.6.rst:2630 +#: whatsnew/2.6.rst:2624 msgid "" -"The :mod:`xmlrpclib` module no longer automatically converts :class:" -"`datetime.date` and :class:`datetime.time` to the :class:`xmlrpclib." -"DateTime` type; the conversion semantics were not necessarily correct for " -"all applications. Code using :mod:`xmlrpclib` should convert :class:`date` " -"and :class:`~datetime.time` instances. (:issue:`1330538`) The code can also " -"handle dates before 1900 (contributed by Ralf Schmitt; :issue:`2014`) and 64-" -"bit integers represented by using ```` in XML-RPC responses (contributed " -"by Riku Lindblad; :issue:`2985`)." +"The :mod:`xmlrpclib ` module no longer automatically " +"converts :class:`datetime.date` and :class:`datetime.time` to the :class:" +"`xmlrpclib.DateTime ` type; the conversion semantics " +"were not necessarily correct for all applications. Code using :mod:`!" +"xmlrpclib` should convert :class:`date` and :class:`~datetime.time` " +"instances. (:issue:`1330538`) The code can also handle dates before 1900 " +"(contributed by Ralf Schmitt; :issue:`2014`) and 64-bit integers represented " +"by using ```` in XML-RPC responses (contributed by Riku Lindblad; :issue:" +"`2985`)." msgstr "" -#: whatsnew/2.6.rst:2640 +#: whatsnew/2.6.rst:2634 msgid "" "The :mod:`zipfile` module's :class:`ZipFile` class now has :meth:`extract` " "and :meth:`extractall` methods that will unpack a single file or all the " "files in the archive to the current directory, or to a specified directory::" msgstr "" -#: whatsnew/2.6.rst:2654 +#: whatsnew/2.6.rst:2648 msgid "(Contributed by Alan McIntyre; :issue:`467924`.)" msgstr "" -#: whatsnew/2.6.rst:2656 +#: whatsnew/2.6.rst:2650 msgid "" "The :meth:`open`, :meth:`read` and :meth:`extract` methods can now take " "either a filename or a :class:`ZipInfo` object. This is useful when an " @@ -3013,17 +3020,17 @@ msgid "" "Horler; :issue:`1775025`.)" msgstr "" -#: whatsnew/2.6.rst:2661 +#: whatsnew/2.6.rst:2655 msgid "" "Finally, :mod:`zipfile` now supports using Unicode filenames for archived " "files. (Contributed by Alexey Borzenkov; :issue:`1734346`.)" msgstr "" -#: whatsnew/2.6.rst:2668 +#: whatsnew/2.6.rst:2662 msgid "The :mod:`ast` module" msgstr "" -#: whatsnew/2.6.rst:2670 +#: whatsnew/2.6.rst:2664 msgid "" "The :mod:`ast` module provides an Abstract Syntax Tree representation of " "Python code, and Armin Ronacher contributed a set of helper functions that " @@ -3031,17 +3038,17 @@ msgid "" "packages, code analyzers, and similar tools that process Python code." msgstr "" -#: whatsnew/2.6.rst:2677 +#: whatsnew/2.6.rst:2671 msgid "" "The :func:`parse` function takes an expression and returns an AST. The :func:" "`dump` function outputs a representation of a tree, suitable for debugging::" msgstr "" -#: whatsnew/2.6.rst:2691 +#: whatsnew/2.6.rst:2685 msgid "This outputs a deeply nested tree::" msgstr "" -#: whatsnew/2.6.rst:2724 +#: whatsnew/2.6.rst:2718 msgid "" "The :func:`literal_eval` method takes a string or an AST representing a " "literal expression, parses and evaluates it, and returns the resulting " @@ -3051,18 +3058,18 @@ msgid "" "an :func:`eval` call, :func:`literal_eval` will handle it safely::" msgstr "" -#: whatsnew/2.6.rst:2740 +#: whatsnew/2.6.rst:2734 msgid "" "The module also includes :class:`NodeVisitor` and :class:`NodeTransformer` " "classes for traversing and modifying an AST, and functions for common " "transformations such as changing line numbers." msgstr "" -#: whatsnew/2.6.rst:2748 +#: whatsnew/2.6.rst:2742 msgid "The :mod:`future_builtins` module" msgstr "" -#: whatsnew/2.6.rst:2750 +#: whatsnew/2.6.rst:2744 msgid "" "Python 3.0 makes many changes to the repertoire of built-in functions, and " "most of the changes can't be introduced in the Python 2.x series because " @@ -3071,24 +3078,24 @@ msgid "" "compatible code." msgstr "" -#: whatsnew/2.6.rst:2757 +#: whatsnew/2.6.rst:2751 msgid "The functions in this module currently include:" msgstr "" -#: whatsnew/2.6.rst:2759 +#: whatsnew/2.6.rst:2753 msgid "" "``ascii(obj)``: equivalent to :func:`repr`. In Python 3.0, :func:`repr` " "will return a Unicode string, while :func:`ascii` will return a pure ASCII " "bytestring." msgstr "" -#: whatsnew/2.6.rst:2763 +#: whatsnew/2.6.rst:2757 msgid "" "``filter(predicate, iterable)``, ``map(func, iterable1, ...)``: the 3.0 " "versions return iterators, unlike the 2.x builtins which return lists." msgstr "" -#: whatsnew/2.6.rst:2767 +#: whatsnew/2.6.rst:2761 msgid "" "``hex(value)``, ``oct(value)``: instead of calling the :meth:`__hex__` or :" "meth:`__oct__` methods, these versions will call the :meth:`__index__` " @@ -3096,11 +3103,11 @@ msgid "" "the new ``0o`` notation for its result." msgstr "" -#: whatsnew/2.6.rst:2776 +#: whatsnew/2.6.rst:2770 msgid "The :mod:`json` module: JavaScript Object Notation" msgstr "" -#: whatsnew/2.6.rst:2778 +#: whatsnew/2.6.rst:2772 msgid "" "The new :mod:`json` module supports the encoding and decoding of Python " "types in JSON (Javascript Object Notation). JSON is a lightweight " @@ -3108,34 +3115,34 @@ msgid "" "about JSON, see http://www.json.org." msgstr "" -#: whatsnew/2.6.rst:2783 +#: whatsnew/2.6.rst:2777 msgid "" ":mod:`json` comes with support for decoding and encoding most built-in " "Python types. The following example encodes and decodes a dictionary::" msgstr "" -#: whatsnew/2.6.rst:2794 +#: whatsnew/2.6.rst:2788 msgid "" "It's also possible to write your own decoders and encoders to support more " "types. Pretty-printing of the JSON strings is also supported." msgstr "" -#: whatsnew/2.6.rst:2797 +#: whatsnew/2.6.rst:2791 msgid ":mod:`json` (originally called simplejson) was written by Bob Ippolito." msgstr "" -#: whatsnew/2.6.rst:2804 +#: whatsnew/2.6.rst:2798 msgid "The :mod:`plistlib` module: A Property-List Parser" msgstr "" -#: whatsnew/2.6.rst:2806 +#: whatsnew/2.6.rst:2800 msgid "" "The ``.plist`` format is commonly used on Mac OS X to store basic data types " "(numbers, strings, lists, and dictionaries) by serializing them into an XML-" "based format. It resembles the XML-RPC serialization of data types." msgstr "" -#: whatsnew/2.6.rst:2811 +#: whatsnew/2.6.rst:2805 msgid "" "Despite being primarily used on Mac OS X, the format has nothing Mac-" "specific about it and the Python implementation works on any platform that " @@ -3143,33 +3150,33 @@ msgid "" "standard library." msgstr "" -#: whatsnew/2.6.rst:2816 +#: whatsnew/2.6.rst:2810 msgid "Using the module is simple::" msgstr "" -#: whatsnew/2.6.rst:2843 +#: whatsnew/2.6.rst:2837 msgid "ctypes Enhancements" msgstr "" -#: whatsnew/2.6.rst:2845 +#: whatsnew/2.6.rst:2839 msgid "" "Thomas Heller continued to maintain and enhance the :mod:`ctypes` module." msgstr "" -#: whatsnew/2.6.rst:2848 +#: whatsnew/2.6.rst:2842 msgid "" ":mod:`ctypes` now supports a :class:`c_bool` datatype that represents the " "C99 ``bool`` type. (Contributed by David Remahl; :issue:`1649190`.)" msgstr "" -#: whatsnew/2.6.rst:2852 +#: whatsnew/2.6.rst:2846 msgid "" "The :mod:`ctypes` string, buffer and array types have improved support for " "extended slicing syntax, where various combinations of ``(start, stop, " "step)`` are supplied. (Implemented by Thomas Wouters.)" msgstr "" -#: whatsnew/2.6.rst:2859 +#: whatsnew/2.6.rst:2853 msgid "" "All :mod:`ctypes` data types now support :meth:`from_buffer` and :meth:" "`from_buffer_copy` methods that create a ctypes instance based on a provided " @@ -3177,14 +3184,14 @@ msgid "" "while :meth:`from_buffer` will share the same memory area." msgstr "" -#: whatsnew/2.6.rst:2866 +#: whatsnew/2.6.rst:2860 msgid "" "A new calling convention tells :mod:`ctypes` to clear the ``errno`` or Win32 " "LastError variables at the outset of each wrapped call. (Implemented by " "Thomas Heller; :issue:`1798`.)" msgstr "" -#: whatsnew/2.6.rst:2870 +#: whatsnew/2.6.rst:2864 msgid "" "You can now retrieve the Unix ``errno`` variable after a function call. " "When creating a wrapped function, you can supply ``use_errno=True`` as a " @@ -3193,7 +3200,7 @@ msgid "" "error value." msgstr "" -#: whatsnew/2.6.rst:2876 +#: whatsnew/2.6.rst:2870 msgid "" "The Win32 LastError variable is similarly supported by the :func:`DLL`, :" "func:`OleDLL`, and :func:`WinDLL` functions. You supply " @@ -3201,18 +3208,18 @@ msgid "" "level methods :meth:`set_last_error` and :meth:`get_last_error`." msgstr "" -#: whatsnew/2.6.rst:2882 +#: whatsnew/2.6.rst:2876 msgid "" "The :func:`byref` function, used to retrieve a pointer to a ctypes instance, " "now has an optional *offset* parameter that is a byte count that will be " "added to the returned pointer." msgstr "" -#: whatsnew/2.6.rst:2889 +#: whatsnew/2.6.rst:2883 msgid "Improved SSL Support" msgstr "" -#: whatsnew/2.6.rst:2891 +#: whatsnew/2.6.rst:2885 msgid "" "Bill Janssen made extensive improvements to Python 2.6's support for the " "Secure Sockets Layer by adding a new module, :mod:`ssl`, that's built atop " @@ -3223,7 +3230,7 @@ msgid "" "removed and continues to work, though it will be removed in Python 3.0." msgstr "" -#: whatsnew/2.6.rst:2900 +#: whatsnew/2.6.rst:2894 msgid "" "To use the new module, you must first create a TCP connection in the usual " "way and then pass it to the :func:`ssl.wrap_socket` function. It's possible " @@ -3231,97 +3238,98 @@ msgid "" "by calling the :meth:`getpeercert` method." msgstr "" -#: whatsnew/2.6.rst:2907 +#: whatsnew/2.6.rst:2901 msgid "The documentation for the :mod:`ssl` module." msgstr "" -#: whatsnew/2.6.rst:2912 +#: whatsnew/2.6.rst:2906 msgid "Deprecations and Removals" msgstr "" -#: whatsnew/2.6.rst:3242 +#: whatsnew/2.6.rst:3263 msgid "" "String exceptions have been removed. Attempting to use them raises a :exc:" "`TypeError`." msgstr "" -#: whatsnew/2.6.rst:2917 +#: whatsnew/2.6.rst:2911 msgid "" "Changes to the :class:`Exception` interface as dictated by :pep:`352` " -"continue to be made. For 2.6, the :attr:`message` attribute is being " -"deprecated in favor of the :attr:`args` attribute." +"continue to be made. For 2.6, the :attr:`!message` attribute is being " +"deprecated in favor of the :attr:`~BaseException.args` attribute." msgstr "" -#: whatsnew/2.6.rst:2922 +#: whatsnew/2.6.rst:2916 msgid "" "(3.0-warning mode) Python 3.0 will feature a reorganized standard library " "that will drop many outdated modules and rename others. Python 2.6 running " "in 3.0-warning mode will warn about these modules when they are imported." msgstr "" -#: whatsnew/2.6.rst:2927 +#: whatsnew/2.6.rst:2921 msgid "" -"The list of deprecated modules is: :mod:`audiodev`, :mod:`bgenlocations`, :" -"mod:`buildtools`, :mod:`bundlebuilder`, :mod:`Canvas`, :mod:`compiler`, :mod:" -"`dircache`, :mod:`dl`, :mod:`fpformat`, :mod:`gensuitemodule`, :mod:" -"`ihooks`, :mod:`imageop`, :mod:`imgfile`, :mod:`linuxaudiodev`, :mod:" -"`mhlib`, :mod:`mimetools`, :mod:`multifile`, :mod:`new`, :mod:`pure`, :mod:" -"`statvfs`, :mod:`sunaudiodev`, :mod:`test.testall`, and :mod:`toaiff`." +"The list of deprecated modules is: :mod:`!audiodev`, :mod:`!bgenlocations`, :" +"mod:`!buildtools`, :mod:`!bundlebuilder`, :mod:`!Canvas`, :mod:`!compiler`, :" +"mod:`!dircache`, :mod:`!dl`, :mod:`!fpformat`, :mod:`!gensuitemodule`, :mod:" +"`!ihooks`, :mod:`!imageop`, :mod:`!imgfile`, :mod:`!linuxaudiodev`, :mod:`!" +"mhlib`, :mod:`!mimetools`, :mod:`!multifile`, :mod:`!new`, :mod:`!pure`, :" +"mod:`!statvfs`, :mod:`!sunaudiodev`, :mod:`!test.testall`, and :mod:`!" +"toaiff`." msgstr "" -#: whatsnew/2.6.rst:2952 -msgid "The :mod:`gopherlib` module has been removed." +#: whatsnew/2.6.rst:2946 +msgid "The :mod:`!gopherlib` module has been removed." msgstr "" -#: whatsnew/2.6.rst:2954 +#: whatsnew/2.6.rst:2948 msgid "" -"The :mod:`MimeWriter` module and :mod:`mimify` module have been deprecated; " -"use the :mod:`email` package instead." +"The :mod:`!MimeWriter` module and :mod:`!mimify` module have been " +"deprecated; use the :mod:`email` package instead." msgstr "" -#: whatsnew/2.6.rst:2958 +#: whatsnew/2.6.rst:2952 msgid "" -"The :mod:`md5` module has been deprecated; use the :mod:`hashlib` module " +"The :mod:`!md5` module has been deprecated; use the :mod:`hashlib` module " "instead." msgstr "" -#: whatsnew/2.6.rst:2961 +#: whatsnew/2.6.rst:2955 msgid "" -"The :mod:`posixfile` module has been deprecated; :func:`fcntl.lockf` " +"The :mod:`!posixfile` module has been deprecated; :func:`fcntl.lockf` " "provides better locking." msgstr "" -#: whatsnew/2.6.rst:2964 +#: whatsnew/2.6.rst:2958 msgid "" -"The :mod:`popen2` module has been deprecated; use the :mod:`subprocess` " +"The :mod:`!popen2` module has been deprecated; use the :mod:`subprocess` " "module." msgstr "" -#: whatsnew/2.6.rst:2967 -msgid "The :mod:`rgbimg` module has been removed." +#: whatsnew/2.6.rst:2961 +msgid "The :mod:`!rgbimg` module has been removed." msgstr "" -#: whatsnew/2.6.rst:2969 +#: whatsnew/2.6.rst:2963 msgid "" -"The :mod:`sets` module has been deprecated; it's better to use the built-in :" -"class:`set` and :class:`frozenset` types." +"The :mod:`!sets` module has been deprecated; it's better to use the built-" +"in :class:`set` and :class:`frozenset` types." msgstr "" -#: whatsnew/2.6.rst:2972 +#: whatsnew/2.6.rst:2966 msgid "" -"The :mod:`sha` module has been deprecated; use the :mod:`hashlib` module " +"The :mod:`!sha` module has been deprecated; use the :mod:`hashlib` module " "instead." msgstr "" -#: whatsnew/2.6.rst:2980 +#: whatsnew/2.6.rst:2974 msgid "Build and C API Changes" msgstr "" -#: whatsnew/2.6.rst:2982 +#: whatsnew/2.6.rst:2976 msgid "Changes to Python's build process and to the C API include:" msgstr "" -#: whatsnew/2.6.rst:2984 +#: whatsnew/2.6.rst:2978 msgid "" "Python now must be compiled with C89 compilers (after 19 years!). This " "means that the Python source tree has dropped its own implementations of :c:" @@ -3329,14 +3337,14 @@ msgid "" "library." msgstr "" -#: whatsnew/2.6.rst:2989 +#: whatsnew/2.6.rst:2983 msgid "" "Python 2.6 can be built with Microsoft Visual Studio 2008 (version 9.0), and " "this is the new default compiler. See the :file:`PCbuild` directory for the " "build files. (Implemented by Christian Heimes.)" msgstr "" -#: whatsnew/2.6.rst:2994 +#: whatsnew/2.6.rst:2988 msgid "" "On Mac OS X, Python 2.6 can be compiled as a 4-way universal build. The :" "program:`configure` script can take a :option:`!--with-universal-archs=[32-" @@ -3345,21 +3353,59 @@ msgid "" "(Contributed by Ronald Oussoren.)" msgstr "" -#: whatsnew/2.6.rst:3001 +#: whatsnew/2.6.rst:2995 +msgid "" +"A new function added in Python 2.6.6, :c:func:`!PySys_SetArgvEx`, sets the " +"value of ``sys.argv`` and can optionally update ``sys.path`` to include the " +"directory containing the script named by ``sys.argv[0]`` depending on the " +"value of an *updatepath* parameter." +msgstr "" + +#: whatsnew/2.6.rst:3000 +msgid "" +"This function was added to close a security hole for applications that embed " +"Python. The old function, :c:func:`!PySys_SetArgv`, would always update " +"``sys.path``, and sometimes it would add the current directory. This meant " +"that, if you ran an application embedding Python in a directory controlled " +"by someone else, attackers could put a Trojan-horse module in the directory " +"(say, a file named :file:`os.py`) that your application would then import " +"and run." +msgstr "" + +#: whatsnew/2.6.rst:3008 +msgid "" +"If you maintain a C/C++ application that embeds Python, check whether you're " +"calling :c:func:`!PySys_SetArgv` and carefully consider whether the " +"application should be using :c:func:`!PySys_SetArgvEx` with *updatepath* set " +"to false. Note that using this function will break compatibility with " +"Python versions 2.6.5 and earlier; if you have to continue working with " +"earlier versions, you can leave the call to :c:func:`!PySys_SetArgv` alone " +"and call ``PyRun_SimpleString(\"sys.path.pop(0)\\n\")`` afterwards to " +"discard the first ``sys.path`` component." +msgstr "" + +#: whatsnew/2.6.rst:3018 +msgid "" +"Security issue reported as `CVE-2008-5983 `_; discussed in :gh:`50003`, and fixed by " +"Antoine Pitrou." +msgstr "" + +#: whatsnew/2.6.rst:3022 msgid "" "The BerkeleyDB module now has a C API object, available as ``bsddb.db." "api``. This object can be used by other C extensions that wish to use the :" "mod:`bsddb` module for their own purposes. (Contributed by Duncan Grisby.)" msgstr "" -#: whatsnew/2.6.rst:3006 +#: whatsnew/2.6.rst:3027 msgid "" "The new buffer interface, previously described in `the PEP 3118 section " "<#pep-3118-revised-buffer-protocol>`__, adds :c:func:`PyObject_GetBuffer` " "and :c:func:`PyBuffer_Release`, as well as a few other functions." msgstr "" -#: whatsnew/2.6.rst:3011 +#: whatsnew/2.6.rst:3032 msgid "" "Python's use of the C stdio library is now thread-safe, or at least as " "thread-safe as the underlying library is. A long-standing potential bug " @@ -3374,7 +3420,7 @@ msgid "" "Gregory P. Smith.)" msgstr "" -#: whatsnew/2.6.rst:3024 +#: whatsnew/2.6.rst:3045 msgid "" "Importing modules simultaneously in two different threads no longer " "deadlocks; it will now raise an :exc:`ImportError`. A new API function, :c:" @@ -3384,7 +3430,7 @@ msgid "" "(Contributed by Christian Heimes.)" msgstr "" -#: whatsnew/2.6.rst:3032 +#: whatsnew/2.6.rst:3053 msgid "" "Several functions return information about the platform's floating-point " "support. :c:func:`PyFloat_GetMax` returns the maximum representable " @@ -3396,7 +3442,7 @@ msgid "" "by Christian Heimes; :issue:`1534`.)" msgstr "" -#: whatsnew/2.6.rst:3043 +#: whatsnew/2.6.rst:3064 msgid "" "C functions and methods that use :c:func:`PyComplex_AsCComplex` will now " "accept arguments that have a :meth:`__complex__` method. In particular, the " @@ -3405,14 +3451,14 @@ msgid "" "Dickinson; :issue:`1675423`.)" msgstr "" -#: whatsnew/2.6.rst:3050 +#: whatsnew/2.6.rst:3071 msgid "" "Python's C API now includes two functions for case-insensitive string " "comparisons, ``PyOS_stricmp(char*, char*)`` and ``PyOS_strnicmp(char*, " "char*, Py_ssize_t)``. (Contributed by Christian Heimes; :issue:`1635`.)" msgstr "" -#: whatsnew/2.6.rst:3055 +#: whatsnew/2.6.rst:3076 msgid "" "Many C extensions define their own little macro for adding integers and " "strings to the module's dictionary in the ``init*`` function. Python 2.6 " @@ -3421,7 +3467,7 @@ msgid "" "(Contributed by Christian Heimes.)" msgstr "" -#: whatsnew/2.6.rst:3062 +#: whatsnew/2.6.rst:3083 msgid "" "Some macros were renamed in both 3.0 and 2.6 to make it clearer that they " "are macros, not functions. :c:macro:`!Py_Size()` became :c:macro:" @@ -3430,14 +3476,14 @@ msgid "" "still available in Python 2.6 for backward compatibility. (:issue:`1629`)" msgstr "" -#: whatsnew/2.6.rst:3071 +#: whatsnew/2.6.rst:3092 msgid "" "Distutils now places C extensions it builds in a different directory when " "running on a debug version of Python. (Contributed by Collin Winter; :issue:" "`1530959`.)" msgstr "" -#: whatsnew/2.6.rst:3075 +#: whatsnew/2.6.rst:3096 msgid "" "Several basic data types, such as integers and strings, maintain internal " "free lists of objects that can be re-used. The data structures for these " @@ -3446,7 +3492,7 @@ msgid "" "``Py_MAXFREELIST`` is always defined." msgstr "" -#: whatsnew/2.6.rst:3082 +#: whatsnew/2.6.rst:3103 msgid "" "A new Makefile target, \"make patchcheck\", prepares the Python source tree " "for making a patch: it fixes trailing whitespace in all modified ``.py`` " @@ -3455,7 +3501,7 @@ msgid "" "(Contributed by Brett Cannon.)" msgstr "" -#: whatsnew/2.6.rst:3089 +#: whatsnew/2.6.rst:3110 msgid "" "Another new target, \"make profile-opt\", compiles a Python binary using " "GCC's profile-guided optimization. It compiles Python with profiling " @@ -3464,17 +3510,17 @@ msgid "" "Smith.)" msgstr "" -#: whatsnew/2.6.rst:3098 +#: whatsnew/2.6.rst:3119 msgid "Port-Specific Changes: Windows" msgstr "" -#: whatsnew/2.6.rst:3100 +#: whatsnew/2.6.rst:3121 msgid "" "The support for Windows 95, 98, ME and NT4 has been dropped. Python 2.6 " "requires at least Windows 2000 SP4." msgstr "" -#: whatsnew/2.6.rst:3103 +#: whatsnew/2.6.rst:3124 msgid "" "The new default compiler on Windows is Visual Studio 2008 (version 9.0). The " "build directories for Visual Studio 2003 (version 7.1) and 2005 (version " @@ -3485,124 +3531,127 @@ msgid "" "Martin von Löwis.)" msgstr "" -#: whatsnew/2.6.rst:3111 +#: whatsnew/2.6.rst:3132 msgid "" "The :mod:`msvcrt` module now supports both the normal and wide char variants " -"of the console I/O API. The :func:`getwch` function reads a keypress and " -"returns a Unicode value, as does the :func:`getwche` function. The :func:" -"`putwch` function takes a Unicode character and writes it to the console. " -"(Contributed by Christian Heimes.)" +"of the console I/O API. The :func:`~msvcrt.getwch` function reads a " +"keypress and returns a Unicode value, as does the :func:`~msvcrt.getwche` " +"function. The :func:`~msvcrt.putwch` function takes a Unicode character and " +"writes it to the console. (Contributed by Christian Heimes.)" msgstr "" -#: whatsnew/2.6.rst:3118 +#: whatsnew/2.6.rst:3139 msgid "" ":func:`os.path.expandvars` will now expand environment variables in the form " "\"%var%\", and \"~user\" will be expanded into the user's home directory " "path. (Contributed by Josiah Carlson; :issue:`957650`.)" msgstr "" -#: whatsnew/2.6.rst:3122 +#: whatsnew/2.6.rst:3143 msgid "" -"The :mod:`socket` module's socket objects now have an :meth:`ioctl` method " -"that provides a limited interface to the :c:func:`WSAIoctl` system interface." +"The :mod:`socket` module's socket objects now have an :meth:`~socket.socket." +"ioctl` method that provides a limited interface to the :c:func:`WSAIoctl` " +"system interface." msgstr "" -#: whatsnew/2.6.rst:3126 +#: whatsnew/2.6.rst:3147 msgid "" -"The :mod:`_winreg` module now has a function, :func:" -"`ExpandEnvironmentStrings`, that expands environment variable references " -"such as ``%NAME%`` in an input string. The handle objects provided by this " +"The :mod:`_winreg ` module now has a function, :func:`~winreg." +"ExpandEnvironmentStrings`, that expands environment variable references such " +"as ``%NAME%`` in an input string. The handle objects provided by this " "module now support the context protocol, so they can be used in :keyword:" "`with` statements. (Contributed by Christian Heimes.)" msgstr "" -#: whatsnew/2.6.rst:3133 +#: whatsnew/2.6.rst:3154 msgid "" -":mod:`_winreg` also has better support for x64 systems, exposing the :func:" -"`DisableReflectionKey`, :func:`EnableReflectionKey`, and :func:" -"`QueryReflectionKey` functions, which enable and disable registry reflection " -"for 32-bit processes running on 64-bit systems. (:issue:`1753245`)" +":mod:`_winreg ` also has better support for x64 systems, exposing " +"the :func:`~winreg.DisableReflectionKey`, :func:`~winreg." +"EnableReflectionKey`, and :func:`~winreg.QueryReflectionKey` functions, " +"which enable and disable registry reflection for 32-bit processes running on " +"64-bit systems. (:issue:`1753245`)" msgstr "" -#: whatsnew/2.6.rst:3139 +#: whatsnew/2.6.rst:3160 msgid "" -"The :mod:`msilib` module's :class:`Record` object gained :meth:`GetInteger` " -"and :meth:`GetString` methods that return field values as an integer or a " -"string. (Contributed by Floris Bruynooghe; :issue:`2125`.)" +"The :mod:`msilib` module's :class:`!Record` object gained :meth:`~msilib." +"Record.GetInteger` and :meth:`~msilib.Record.GetString` methods that return " +"field values as an integer or a string. (Contributed by Floris Bruynooghe; :" +"issue:`2125`.)" msgstr "" -#: whatsnew/2.6.rst:3147 +#: whatsnew/2.6.rst:3168 msgid "Port-Specific Changes: Mac OS X" msgstr "" -#: whatsnew/2.6.rst:3149 +#: whatsnew/2.6.rst:3170 msgid "" "When compiling a framework build of Python, you can now specify the " "framework name to be used by providing the :option:`!--with-framework-name=` " "option to the :program:`configure` script." msgstr "" -#: whatsnew/2.6.rst:3154 +#: whatsnew/2.6.rst:3175 msgid "" -"The :mod:`macfs` module has been removed. This in turn required the :func:" -"`macostools.touched` function to be removed because it depended on the :mod:" -"`macfs` module. (:issue:`1490190`)" +"The :mod:`!macfs` module has been removed. This in turn required the :func:" +"`!macostools.touched` function to be removed because it depended on the :mod:" +"`!macfs` module. (:issue:`1490190`)" msgstr "" -#: whatsnew/2.6.rst:3158 +#: whatsnew/2.6.rst:3179 msgid "" "Many other Mac OS modules have been deprecated and will be removed in Python " -"3.0: :mod:`_builtinSuites`, :mod:`aepack`, :mod:`aetools`, :mod:`aetypes`, :" -"mod:`applesingle`, :mod:`appletrawmain`, :mod:`appletrunner`, :mod:" -"`argvemulator`, :mod:`Audio_mac`, :mod:`autoGIL`, :mod:`Carbon`, :mod:" -"`cfmfile`, :mod:`CodeWarrior`, :mod:`ColorPicker`, :mod:`EasyDialogs`, :mod:" -"`Explorer`, :mod:`Finder`, :mod:`FrameWork`, :mod:`findertools`, :mod:`ic`, :" -"mod:`icglue`, :mod:`icopen`, :mod:`macerrors`, :mod:`MacOS`, :mod:`macfs`, :" -"mod:`macostools`, :mod:`macresource`, :mod:`MiniAEFrame`, :mod:`Nav`, :mod:" -"`Netscape`, :mod:`OSATerminology`, :mod:`pimp`, :mod:`PixMapWrapper`, :mod:" -"`StdSuites`, :mod:`SystemEvents`, :mod:`Terminal`, and :mod:" -"`terminalcommand`." -msgstr "" - -#: whatsnew/2.6.rst:3201 +"3.0: :mod:`!_builtinSuites`, :mod:`!aepack`, :mod:`!aetools`, :mod:`!" +"aetypes`, :mod:`!applesingle`, :mod:`!appletrawmain`, :mod:`!appletrunner`, :" +"mod:`!argvemulator`, :mod:`!Audio_mac`, :mod:`!autoGIL`, :mod:`!Carbon`, :" +"mod:`!cfmfile`, :mod:`!CodeWarrior`, :mod:`!ColorPicker`, :mod:`!" +"EasyDialogs`, :mod:`!Explorer`, :mod:`!Finder`, :mod:`!FrameWork`, :mod:`!" +"findertools`, :mod:`!ic`, :mod:`!icglue`, :mod:`!icopen`, :mod:`!" +"macerrors`, :mod:`!MacOS`, :mod:`!macfs`, :mod:`!macostools`, :mod:`!" +"macresource`, :mod:`!MiniAEFrame`, :mod:`!Nav`, :mod:`!Netscape`, :mod:`!" +"OSATerminology`, :mod:`!pimp`, :mod:`!PixMapWrapper`, :mod:`!StdSuites`, :" +"mod:`!SystemEvents`, :mod:`!Terminal`, and :mod:`!terminalcommand`." +msgstr "" + +#: whatsnew/2.6.rst:3222 msgid "Port-Specific Changes: IRIX" msgstr "" -#: whatsnew/2.6.rst:3203 +#: whatsnew/2.6.rst:3224 msgid "" "A number of old IRIX-specific modules were deprecated and will be removed in " -"Python 3.0: :mod:`al` and :mod:`AL`, :mod:`cd`, :mod:`cddb`, :mod:" -"`cdplayer`, :mod:`CL` and :mod:`cl`, :mod:`DEVICE`, :mod:`ERRNO`, :mod:" -"`FILE`, :mod:`FL` and :mod:`fl`, :mod:`flp`, :mod:`fm`, :mod:`GET`, :mod:" -"`GLWS`, :mod:`GL` and :mod:`gl`, :mod:`IN`, :mod:`IOCTL`, :mod:`jpeg`, :mod:" -"`panelparser`, :mod:`readcd`, :mod:`SV` and :mod:`sv`, :mod:`torgb`, :mod:" -"`videoreader`, and :mod:`WAIT`." +"Python 3.0: :mod:`!al` and :mod:`!AL`, :mod:`!cd`, :mod:`!cddb`, :mod:`!" +"cdplayer`, :mod:`!CL` and :mod:`!cl`, :mod:`!DEVICE`, :mod:`!ERRNO`, :mod:`!" +"FILE`, :mod:`!FL` and :mod:`!fl`, :mod:`!flp`, :mod:`!fm`, :mod:`!GET`, :mod:" +"`!GLWS`, :mod:`!GL` and :mod:`!gl`, :mod:`!IN`, :mod:`!IOCTL`, :mod:`!" +"jpeg`, :mod:`!panelparser`, :mod:`!readcd`, :mod:`!SV` and :mod:`!sv`, :mod:" +"`!torgb`, :mod:`!videoreader`, and :mod:`!WAIT`." msgstr "" -#: whatsnew/2.6.rst:3233 +#: whatsnew/2.6.rst:3254 msgid "Porting to Python 2.6" msgstr "" -#: whatsnew/2.6.rst:3235 +#: whatsnew/2.6.rst:3256 msgid "" "This section lists previously described changes and other bugfixes that may " "require changes to your code:" msgstr "" -#: whatsnew/2.6.rst:3238 +#: whatsnew/2.6.rst:3259 msgid "" "Classes that aren't supposed to be hashable should set ``__hash__ = None`` " "in their definitions to indicate the fact." msgstr "" -#: whatsnew/2.6.rst:3245 +#: whatsnew/2.6.rst:3266 msgid "" "The :meth:`__init__` method of :class:`collections.deque` now clears any " "existing contents of the deque before adding elements from the iterable. " "This change makes the behavior match ``list.__init__()``." msgstr "" -#: whatsnew/2.6.rst:3250 +#: whatsnew/2.6.rst:3271 msgid "" ":meth:`object.__init__` previously accepted arbitrary arguments and keyword " "arguments, ignoring them. In Python 2.6, this is no longer allowed and will " @@ -3611,7 +3660,7 @@ msgid "" "through using :func:`super`). See :issue:`1683368` for discussion." msgstr "" -#: whatsnew/2.6.rst:3257 +#: whatsnew/2.6.rst:3278 msgid "" "The :class:`Decimal` constructor now accepts leading and trailing whitespace " "when passed a string. Previously it would raise an :exc:`InvalidOperation` " @@ -3620,7 +3669,7 @@ msgid "" "`ConversionSyntax` exception." msgstr "" -#: whatsnew/2.6.rst:3264 +#: whatsnew/2.6.rst:3285 msgid "" "Due to an implementation accident, if you passed a file path to the built-" "in :func:`__import__` function, it would actually import the specified " @@ -3628,20 +3677,20 @@ msgid "" "explicitly checks for this case and raises an :exc:`ImportError`." msgstr "" -#: whatsnew/2.6.rst:3270 +#: whatsnew/2.6.rst:3291 msgid "" "C API: the :c:func:`PyImport_Import` and :c:func:`PyImport_ImportModule` " "functions now default to absolute imports, not relative imports. This will " "affect C extensions that import other modules." msgstr "" -#: whatsnew/2.6.rst:3274 +#: whatsnew/2.6.rst:3295 msgid "" "C API: extension data types that shouldn't be hashable should define their " "``tp_hash`` slot to :c:func:`PyObject_HashNotImplemented`." msgstr "" -#: whatsnew/2.6.rst:3278 +#: whatsnew/2.6.rst:3299 msgid "" "The :mod:`socket` module exception :exc:`socket.error` now inherits from :" "exc:`IOError`. Previously it wasn't a subclass of :exc:`StandardError` but " @@ -3649,41 +3698,55 @@ msgid "" "`1706815`.)" msgstr "" -#: whatsnew/2.6.rst:3283 +#: whatsnew/2.6.rst:3304 msgid "" -"The :mod:`xmlrpclib` module no longer automatically converts :class:" -"`datetime.date` and :class:`datetime.time` to the :class:`xmlrpclib." -"DateTime` type; the conversion semantics were not necessarily correct for " -"all applications. Code using :mod:`xmlrpclib` should convert :class:`date` " -"and :class:`~datetime.time` instances. (:issue:`1330538`)" +"The :mod:`xmlrpclib ` module no longer automatically " +"converts :class:`datetime.date` and :class:`datetime.time` to the :class:" +"`xmlrpclib.DateTime ` type; the conversion semantics " +"were not necessarily correct for all applications. Code using :mod:`!" +"xmlrpclib` should convert :class:`date` and :class:`~datetime.time` " +"instances. (:issue:`1330538`)" msgstr "" -#: whatsnew/2.6.rst:3290 +#: whatsnew/2.6.rst:3311 msgid "" "(3.0-warning mode) The :class:`Exception` class now warns when accessed " "using slicing or index access; having :class:`Exception` behave like a tuple " "is being phased out." msgstr "" -#: whatsnew/2.6.rst:3294 +#: whatsnew/2.6.rst:3315 msgid "" "(3.0-warning mode) inequality comparisons between two dictionaries or two " "objects that don't implement comparison methods are reported as warnings. " "``dict1 == dict2`` still works, but ``dict1 < dict2`` is being phased out." msgstr "" -#: whatsnew/2.6.rst:3299 +#: whatsnew/2.6.rst:3320 msgid "" "Comparisons between cells, which are an implementation detail of Python's " "scoping rules, also cause warnings because such comparisons are forbidden " "entirely in 3.0." msgstr "" -#: whatsnew/2.6.rst:3309 +#: whatsnew/2.6.rst:3324 +msgid "For applications that embed Python:" +msgstr "" + +#: whatsnew/2.6.rst:3326 +msgid "" +"The :c:func:`!PySys_SetArgvEx` function was added in Python 2.6.6, letting " +"applications close a security hole when the existing :c:func:`!" +"PySys_SetArgv` function was used. Check whether you're calling :c:func:`!" +"PySys_SetArgv` and carefully consider whether the application should be " +"using :c:func:`!PySys_SetArgvEx` with *updatepath* set to false." +msgstr "" + +#: whatsnew/2.6.rst:3339 msgid "Acknowledgements" msgstr "" -#: whatsnew/2.6.rst:3311 +#: whatsnew/2.6.rst:3341 msgid "" "The author would like to thank the following people for offering " "suggestions, corrections and assistance with various drafts of this article: " @@ -3691,10 +3754,10 @@ msgid "" "Johnson, Chris Lambacher, Martin Michlmayr, Antoine Pitrou, Brian Warner." msgstr "" -#: whatsnew/2.6.rst:1072 +#: whatsnew/2.6.rst:1068 msgid "universal newlines" msgstr "" -#: whatsnew/2.6.rst:1072 +#: whatsnew/2.6.rst:1068 msgid "What's new" msgstr "" diff --git a/whatsnew/2.7.po b/whatsnew/2.7.po index 091bef675..c174ec72f 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -266,8 +266,8 @@ msgstr "" #: whatsnew/2.7.rst:199 msgid "" -":func:`operator.isCallable` and :func:`operator.sequenceIncludes`, which are " -"not supported in 3.x, now trigger warnings." +":func:`!operator.isCallable` and :func:`!operator.sequenceIncludes`, which " +"are not supported in 3.x, now trigger warnings." msgstr "" #: whatsnew/2.7.rst:201 @@ -332,7 +332,8 @@ msgid "" "How does the :class:`~collections.OrderedDict` work? It maintains a doubly " "linked list of keys, appending new keys to the list as they're inserted. A " "secondary dictionary maps keys to their corresponding list node, so deletion " -"doesn't have to traverse the entire linked list and therefore remains O(1)." +"doesn't have to traverse the entire linked list and therefore remains *O*\\ " +"(1)." msgstr "" #: whatsnew/2.7.rst:287 @@ -521,14 +522,14 @@ msgid "" "All this flexibility can require a lot of configuration. You can write " "Python statements to create objects and set their properties, but a complex " "set-up requires verbose but boring code. :mod:`logging` also supports a :" -"func:`~logging.fileConfig` function that parses a file, but the file format " -"doesn't support configuring filters, and it's messier to generate " +"func:`~logging.config.fileConfig` function that parses a file, but the file " +"format doesn't support configuring filters, and it's messier to generate " "programmatically." msgstr "" #: whatsnew/2.7.rst:462 msgid "" -"Python 2.7 adds a :func:`~logging.dictConfig` function that uses a " +"Python 2.7 adds a :func:`~logging.config.dictConfig` function that uses a " "dictionary to configure logging. There are many ways to produce a " "dictionary from different sources: construct one with code; parse a file " "containing JSON; or use a YAML parsing library if one is installed. For " @@ -569,9 +570,9 @@ msgstr "" #: whatsnew/2.7.rst:535 msgid "" -"The :class:`~logging.LoggerAdapter` class gained an :meth:`~logging." -"LoggerAdapter.isEnabledFor` method that takes a *level* and returns whether " -"the underlying logger would process a message of that level of importance." +"The :class:`~logging.LoggerAdapter` class gained an :meth:`~logging.Logger." +"isEnabledFor` method that takes a *level* and returns whether the underlying " +"logger would process a message of that level of importance." msgstr "" #: whatsnew/2.7.rst:544 @@ -598,7 +599,7 @@ msgid "" "It's not possible to change the return values of :meth:`~dict.keys`, :meth:" "`~dict.values`, and :meth:`~dict.items` in Python 2.7 because too much code " "would break. Instead the 3.x versions were added under the new names :meth:" -"`~dict.viewkeys`, :meth:`~dict.viewvalues`, and :meth:`~dict.viewitems`." +"`!viewkeys`, :meth:`!viewvalues`, and :meth:`!viewitems`." msgstr "" #: whatsnew/2.7.rst:568 @@ -713,7 +714,7 @@ msgstr "" #: whatsnew/2.7.rst:723 msgid "" -"The :func:`contextlib.nested` function provides a very similar function, so " +"The :func:`!contextlib.nested` function provides a very similar function, so " "it's no longer necessary and has been deprecated." msgstr "" @@ -787,7 +788,7 @@ msgstr "" #: whatsnew/2.7.rst:787 msgid "" "Implicit coercion for complex numbers has been removed; the interpreter will " -"no longer ever attempt to call a :meth:`__coerce__` method on complex " +"no longer ever attempt to call a :meth:`!__coerce__` method on complex " "objects. (Removed by Meador Inge and Mark Dickinson; :issue:`5211`.)" msgstr "" @@ -828,17 +829,17 @@ msgstr "" msgid "" "A low-level change: the :meth:`object.__format__` method now triggers a :exc:" "`PendingDeprecationWarning` if it's passed a format string, because the :" -"meth:`__format__` method for :class:`object` converts the object to a string " -"representation and formats that. Previously the method silently applied the " -"format string to the string representation, but that could hide mistakes in " -"Python code. If you're supplying formatting information such as an " -"alignment or precision, presumably you're expecting the formatting to be " +"meth:`!__format__` method for :class:`object` converts the object to a " +"string representation and formats that. Previously the method silently " +"applied the format string to the string representation, but that could hide " +"mistakes in Python code. If you're supplying formatting information such as " +"an alignment or precision, presumably you're expecting the formatting to be " "applied in some object-specific way. (Fixed by Eric Smith; :issue:`7994`.)" msgstr "" #: whatsnew/2.7.rst:828 msgid "" -"The :func:`int` and :func:`long` types gained a ``bit_length`` method that " +"The :func:`int` and :func:`!long` types gained a ``bit_length`` method that " "returns the number of bits necessary to represent its argument in binary::" msgstr "" @@ -856,8 +857,8 @@ msgstr "" #: whatsnew/2.7.rst:851 msgid "" -"It's now possible for a subclass of the built-in :class:`unicode` type to " -"override the :meth:`__unicode__` method. (Implemented by Victor Stinner; :" +"It's now possible for a subclass of the built-in :class:`!unicode` type to " +"override the :meth:`!__unicode__` method. (Implemented by Victor Stinner; :" "issue:`1583863`.)" msgstr "" @@ -877,7 +878,7 @@ msgid "" "George Sakkis; :issue:`5982`.)" msgstr "" -#: whatsnew/2.7.rst:2465 +#: whatsnew/2.7.rst:2468 msgid "" "When a restricted set of attributes were set using ``__slots__``, deleting " "an unset attribute would not raise :exc:`AttributeError` as you would " @@ -894,11 +895,12 @@ msgstr "" #: whatsnew/2.7.rst:879 msgid "" -"The :class:`file` object will now set the :attr:`filename` attribute on the :" -"exc:`IOError` exception when trying to open a directory on POSIX platforms " -"(noted by Jan Kaliszewski; :issue:`4764`), and now explicitly checks for and " -"forbids writing to read-only file objects instead of trusting the C library " -"to catch and report the error (fixed by Stefan Krah; :issue:`5677`)." +"The :class:`!file` object will now set the :attr:`!filename` attribute on " +"the :exc:`IOError` exception when trying to open a directory on POSIX " +"platforms (noted by Jan Kaliszewski; :issue:`4764`), and now explicitly " +"checks for and forbids writing to read-only file objects instead of trusting " +"the C library to catch and report the error (fixed by Stefan Krah; :issue:" +"`5677`)." msgstr "" #: whatsnew/2.7.rst:886 @@ -946,9 +948,9 @@ msgstr "" #: whatsnew/2.7.rst:917 msgid "" "For example, the following setting will print warnings every time they " -"occur, but turn warnings from the :mod:`Cookie` module into an error. (The " -"exact syntax for setting an environment variable varies across operating " -"systems and shells.)" +"occur, but turn warnings from the :mod:`Cookie ` module into " +"an error. (The exact syntax for setting an environment variable varies " +"across operating systems and shells.)" msgstr "" #: whatsnew/2.7.rst:930 @@ -1006,7 +1008,7 @@ msgstr "" msgid "" "Apart from the performance improvements this change should be invisible to " "end users, with one exception: for testing and debugging purposes there's a " -"new structseq :data:`sys.long_info` that provides information about the " +"new structseq :data:`!sys.long_info` that provides information about the " "internal format, giving the number of bits per digit and the size in bytes " "of the C type used to store each digit::" msgstr "" @@ -1056,24 +1058,25 @@ msgstr "" #: whatsnew/2.7.rst:1008 msgid "" -"The :meth:`split`, :meth:`replace`, :meth:`rindex`, :meth:`rpartition`, and :" -"meth:`rsplit` methods of string-like types (strings, Unicode strings, and :" -"class:`bytearray` objects) now use a fast reverse-search algorithm instead " -"of a character-by-character scan. This is sometimes faster by a factor of " -"10. (Added by Florent Xicluna; :issue:`7462` and :issue:`7622`.)" +"The :meth:`!split`, :meth:`!replace`, :meth:`!rindex`, :meth:`!rpartition`, " +"and :meth:`!rsplit` methods of string-like types (strings, Unicode strings, " +"and :class:`bytearray` objects) now use a fast reverse-search algorithm " +"instead of a character-by-character scan. This is sometimes faster by a " +"factor of 10. (Added by Florent Xicluna; :issue:`7462` and :issue:`7622`.)" msgstr "" #: whatsnew/2.7.rst:1015 msgid "" -"The :mod:`pickle` and :mod:`cPickle` modules now automatically intern the " +"The :mod:`pickle` and :mod:`!cPickle` modules now automatically intern the " "strings used for attribute names, reducing memory usage of the objects " "resulting from unpickling. (Contributed by Jake McGuire; :issue:`5084`.)" msgstr "" #: whatsnew/2.7.rst:1020 msgid "" -"The :mod:`cPickle` module now special-cases dictionaries, nearly halving the " -"time required to pickle them. (Contributed by Collin Winter; :issue:`5670`.)" +"The :mod:`!cPickle` module now special-cases dictionaries, nearly halving " +"the time required to pickle them. (Contributed by Collin Winter; :issue:" +"`5670`.)" msgstr "" #: whatsnew/2.7.rst:1027 @@ -1108,8 +1111,8 @@ msgstr "" #: whatsnew/2.7.rst:1047 msgid "" -"Updated module: the :mod:`bsddb` module has been updated from 4.7.2devel9 to " -"version 4.8.4 of `the pybsddb package `__. The new version features better Python 3.x compatibility, " "various bug fixes, and adds several new BerkeleyDB flags and methods. " "(Updated by Jesús Cea Avión; :issue:`8156`. The pybsddb changelog can be " @@ -1177,9 +1180,9 @@ msgstr "" #: whatsnew/2.7.rst:1132 msgid "" -"Finally, the :class:`~collections.Mapping` abstract base class now returns :" -"const:`NotImplemented` if a mapping is compared to another type that isn't " -"a :class:`Mapping`. (Fixed by Daniel Stutzbach; :issue:`8729`.)" +"Finally, the :class:`~collections.abc.Mapping` abstract base class now " +"returns :const:`NotImplemented` if a mapping is compared to another type " +"that isn't a :class:`Mapping`. (Fixed by Daniel Stutzbach; :issue:`8729`.)" msgstr "" #: whatsnew/2.7.rst:1137 @@ -1195,7 +1198,7 @@ msgstr "" #: whatsnew/2.7.rst:1161 msgid "" -"Deprecated function: :func:`contextlib.nested`, which allows handling more " +"Deprecated function: :func:`!contextlib.nested`, which allows handling more " "than one context manager with a single :keyword:`with` statement, has been " "deprecated, because the :keyword:`!with` statement now supports multiple " "context managers." @@ -1203,9 +1206,9 @@ msgstr "" #: whatsnew/2.7.rst:1166 msgid "" -"The :mod:`cookielib` module now ignores cookies that have an invalid version " -"field, one that doesn't contain an integer value. (Fixed by John J. Lee; :" -"issue:`3924`.)" +"The :mod:`cookielib ` module now ignores cookies that have " +"an invalid version field, one that doesn't contain an integer value. (Fixed " +"by John J. Lee; :issue:`3924`.)" msgstr "" #: whatsnew/2.7.rst:1170 @@ -1235,11 +1238,10 @@ msgstr "" msgid "" "New method: the :class:`~decimal.Decimal` class gained a :meth:`~decimal." "Decimal.from_float` class method that performs an exact conversion of a " -"floating-point number to a :class:`~decimal.Decimal`. This exact conversion " -"strives for the closest decimal approximation to the floating-point " -"representation's value; the resulting decimal value will therefore still " -"include the inaccuracy, if any. For example, ``Decimal.from_float(0.1)`` " -"returns " +"floating-point number to a :class:`!Decimal`. This exact conversion strives " +"for the closest decimal approximation to the floating-point representation's " +"value; the resulting decimal value will therefore still include the " +"inaccuracy, if any. For example, ``Decimal.from_float(0.1)`` returns " "``Decimal('0.1000000000000000055511151231257827021181583404541015625')``. " "(Implemented by Raymond Hettinger; :issue:`4796`.)" msgstr "" @@ -1250,9 +1252,9 @@ 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.Decimal`. (Fixed by Mark " +"how to convert between float and :class:`!Decimal`. (Fixed by Mark " "Dickinson; :issue:`2531`.)" msgstr "" @@ -1280,12 +1282,12 @@ msgid "" "types. (Changed by Mark Dickinson; :issue:`6857`.)" msgstr "" -#: whatsnew/2.7.rst:1220 +#: whatsnew/2.7.rst:2486 msgid "" "Comparisons involving a signaling NaN value (or ``sNAN``) now signal :const:" -"`InvalidOperation` instead of silently returning a true or false value " -"depending on the comparison operator. Quiet NaN values (or ``NaN``) are now " -"hashable. (Fixed by Mark Dickinson; :issue:`7279`.)" +"`~decimal.InvalidOperation` instead of silently returning a true or false " +"value depending on the comparison operator. Quiet NaN values (or ``NaN``) " +"are now hashable. (Fixed by Mark Dickinson; :issue:`7279`.)" msgstr "" #: whatsnew/2.7.rst:1226 @@ -1306,16 +1308,16 @@ msgstr "" #: whatsnew/2.7.rst:1238 msgid "" -"The :mod:`doctest` module's :const:`IGNORE_EXCEPTION_DETAIL` flag will now " -"ignore the name of the module containing the exception being tested. (Patch " -"by Lennart Regebro; :issue:`7490`.)" +"The :mod:`doctest` module's :const:`~doctest.IGNORE_EXCEPTION_DETAIL` flag " +"will now ignore the name of the module containing the exception being " +"tested. (Patch by Lennart Regebro; :issue:`7490`.)" msgstr "" #: whatsnew/2.7.rst:1242 msgid "" "The :mod:`email` module's :class:`~email.message.Message` class will now " "accept a Unicode-valued payload, automatically converting the payload to the " -"encoding specified by :attr:`output_charset`. (Added by R. David Murray; :" +"encoding specified by :attr:`!output_charset`. (Added by R. David Murray; :" "issue:`1368247`.)" msgstr "" @@ -1352,11 +1354,12 @@ msgstr "" #: whatsnew/2.7.rst:1270 msgid "" "New class decorator: :func:`~functools.total_ordering` in the :mod:" -"`functools` module takes a class that defines an :meth:`__eq__` method and " -"one of :meth:`__lt__`, :meth:`__le__`, :meth:`__gt__`, or :meth:`__ge__`, " -"and generates the missing comparison methods. Since the :meth:`__cmp__` " -"method is being deprecated in Python 3.x, this decorator makes it easier to " -"define ordered classes. (Added by Raymond Hettinger; :issue:`5479`.)" +"`functools` module takes a class that defines an :meth:`~object.__eq__` " +"method and one of :meth:`~object.__lt__`, :meth:`~object.__le__`, :meth:" +"`~object.__gt__`, or :meth:`~object.__ge__`, and generates the missing " +"comparison methods. Since the :meth:`!__cmp__` method is being deprecated " +"in Python 3.x, this decorator makes it easier to define ordered classes. " +"(Added by Raymond Hettinger; :issue:`5479`.)" msgstr "" #: whatsnew/2.7.rst:1278 @@ -1397,32 +1400,33 @@ msgstr "" #: whatsnew/2.7.rst:1303 msgid "" -"New attribute: the :mod:`hashlib` module now has an :attr:`~hashlib.hashlib." -"algorithms` attribute containing a tuple naming the supported algorithms. In " -"Python 2.7, ``hashlib.algorithms`` contains ``('md5', 'sha1', 'sha224', " -"'sha256', 'sha384', 'sha512')``. (Contributed by Carl Chenet; :issue:`7418`.)" +"New attribute: the :mod:`hashlib` module now has an :attr:`!algorithms` " +"attribute containing a tuple naming the supported algorithms. In Python 2.7, " +"``hashlib.algorithms`` contains ``('md5', 'sha1', 'sha224', 'sha256', " +"'sha384', 'sha512')``. (Contributed by Carl Chenet; :issue:`7418`.)" msgstr "" #: whatsnew/2.7.rst:1309 msgid "" -"The default :class:`~httplib.HTTPResponse` class used by the :mod:`httplib` " -"module now supports buffering, resulting in much faster reading of HTTP " -"responses. (Contributed by Kristján Valur Jónsson; :issue:`4879`.)" +"The default :class:`~http.client.HTTPResponse` class used by the :mod:" +"`httplib ` module now supports buffering, resulting in much faster " +"reading of HTTP responses. (Contributed by Kristján Valur Jónsson; :issue:" +"`4879`.)" msgstr "" #: whatsnew/2.7.rst:1313 msgid "" -"The :class:`~httplib.HTTPConnection` and :class:`~httplib.HTTPSConnection` " -"classes now support a *source_address* parameter, a ``(host, port)`` 2-tuple " -"giving the source address that will be used for the connection. (Contributed " -"by Eldon Ziegler; :issue:`3972`.)" +"The :class:`~http.client.HTTPConnection` and :class:`~http.client." +"HTTPSConnection` classes now support a *source_address* parameter, a " +"``(host, port)`` 2-tuple giving the source address that will be used for the " +"connection. (Contributed by Eldon Ziegler; :issue:`3972`.)" msgstr "" #: whatsnew/2.7.rst:1318 msgid "" -"The :mod:`ihooks` module now supports relative imports. Note that :mod:" -"`ihooks` is an older module for customizing imports, superseded by the :mod:" -"`imputil` module added in Python 2.0. (Relative import support added by Neil " +"The :mod:`!ihooks` module now supports relative imports. Note that :mod:`!" +"ihooks` is an older module for customizing imports, superseded by the :mod:`!" +"imputil` module added in Python 2.0. (Relative import support added by Neil " "Schemenauer.)" msgstr "" @@ -1449,14 +1453,15 @@ msgid "" "Updated module: The :mod:`io` library has been upgraded to the version " "shipped with Python 3.1. For 3.1, the I/O library was entirely rewritten in " "C and is 2 to 20 times faster depending on the task being performed. The " -"original Python version was renamed to the :mod:`_pyio` module." +"original Python version was renamed to the :mod:`!_pyio` module." msgstr "" #: whatsnew/2.7.rst:1353 msgid "" "One minor resulting change: the :class:`io.TextIOBase` class now has an :" -"attr:`errors` attribute giving the error setting used for encoding and " -"decoding errors (one of ``'strict'``, ``'replace'``, ``'ignore'``)." +"attr:`~io.TextIOBase.errors` attribute giving the error setting used for " +"encoding and decoding errors (one of ``'strict'``, ``'replace'``, " +"``'ignore'``)." msgstr "" #: whatsnew/2.7.rst:1358 @@ -1551,12 +1556,12 @@ msgstr "" #: whatsnew/2.7.rst:1426 msgid "" -"The :class:`~multiprocessing.Pool` class, which controls a pool of worker " -"processes, now has an optional *maxtasksperchild* parameter. Worker " +"The :class:`~multiprocessing.pool.Pool` class, which controls a pool of " +"worker processes, now has an optional *maxtasksperchild* parameter. Worker " "processes will perform the specified number of tasks and then exit, causing " -"the :class:`~multiprocessing.Pool` to start a new worker. This is useful if " -"tasks may leak memory or other resources, or if some tasks will cause the " -"worker to become very large. (Contributed by Charles Cazabon; :issue:`6963`.)" +"the :class:`!Pool` to start a new worker. This is useful if tasks may leak " +"memory or other resources, or if some tasks will cause the worker to become " +"very large. (Contributed by Charles Cazabon; :issue:`6963`.)" msgstr "" #: whatsnew/2.7.rst:1434 @@ -1652,9 +1657,9 @@ msgid "" "site- and user-specific paths. :func:`~site.getsitepackages` returns a list " "containing all global site-packages directories, :func:`~site." "getusersitepackages` returns the path of the user's site-packages directory, " -"and :func:`~site.getuserbase` returns the value of the :envvar:`USER_BASE` " -"environment variable, giving the path to a directory that can be used to " -"store data. (Contributed by Tarek Ziadé; :issue:`6693`.)" +"and :func:`~site.getuserbase` returns the value of the :data:`~site." +"USER_BASE` environment variable, giving the path to a directory that can be " +"used to store data. (Contributed by Tarek Ziadé; :issue:`6693`.)" msgstr "" #: whatsnew/2.7.rst:1506 @@ -1682,17 +1687,17 @@ msgstr "" #: whatsnew/2.7.rst:1521 msgid "" -"The :mod:`SocketServer` module's :class:`~SocketServer.TCPServer` class now " -"supports socket timeouts and disabling the Nagle algorithm. The :attr:" -"`~SocketServer.TCPServer.disable_nagle_algorithm` class attribute defaults " -"to ``False``; if overridden to be true, new request connections will have " -"the TCP_NODELAY option set to prevent buffering many small sends into a " -"single TCP packet. The :attr:`~SocketServer.BaseServer.timeout` class " -"attribute can hold a timeout in seconds that will be applied to the request " -"socket; if no request is received within that time, :meth:`~SocketServer." -"BaseServer.handle_timeout` will be called and :meth:`~SocketServer." -"BaseServer.handle_request` will return. (Contributed by Kristján Valur " -"Jónsson; :issue:`6192` and :issue:`6267`.)" +"The :mod:`SocketServer ` module's :class:`~socketserver." +"TCPServer` class now supports socket timeouts and disabling the Nagle " +"algorithm. The :attr:`!disable_nagle_algorithm` class attribute defaults to " +"``False``; if overridden to be true, new request connections will have the " +"TCP_NODELAY option set to prevent buffering many small sends into a single " +"TCP packet. The :attr:`~socketserver.BaseServer.timeout` class attribute can " +"hold a timeout in seconds that will be applied to the request socket; if no " +"request is received within that time, :meth:`~socketserver.BaseServer." +"handle_timeout` will be called and :meth:`~socketserver.BaseServer." +"handle_request` will return. (Contributed by Kristján Valur Jónsson; :issue:" +"`6192` and :issue:`6267`.)" msgstr "" #: whatsnew/2.7.rst:1533 @@ -1710,18 +1715,18 @@ msgstr "" msgid "" "The :mod:`ssl` module's :class:`~ssl.SSLSocket` objects now support the " "buffer API, which fixed a test suite failure (fix by Antoine Pitrou; :issue:" -"`7133`) and automatically set OpenSSL's :c:macro:`SSL_MODE_AUTO_RETRY`, " +"`7133`) and automatically set OpenSSL's :c:macro:`!SSL_MODE_AUTO_RETRY`, " "which will prevent an error code being returned from :meth:`recv` operations " "that trigger an SSL renegotiation (fix by Antoine Pitrou; :issue:`8222`)." msgstr "" #: whatsnew/2.7.rst:1547 msgid "" -"The :func:`ssl.wrap_socket` constructor function now takes a *ciphers* " -"argument that's a string listing the encryption algorithms to be allowed; " -"the format of the string is described `in the OpenSSL documentation `__. (Added by Antoine " -"Pitrou; :issue:`8322`.)" +"The :func:`~ssl.SSLContext.wrap_socket` constructor function now takes a " +"*ciphers* argument that's a string listing the encryption algorithms to be " +"allowed; the format of the string is described `in the OpenSSL documentation " +"`__. (Added by " +"Antoine Pitrou; :issue:`8322`.)" msgstr "" #: whatsnew/2.7.rst:1554 @@ -1746,9 +1751,9 @@ msgid "" "a value is too large for a particular integer format code (one of " "``bBhHiIlLqQ``); it now always raises a :exc:`struct.error` exception. " "(Changed by Mark Dickinson; :issue:`1523`.) The :func:`~struct.pack` " -"function will also attempt to use :meth:`__index__` to convert and pack non-" -"integers before trying the :meth:`__int__` method or reporting an error. " -"(Changed by Mark Dickinson; :issue:`8300`.)" +"function will also attempt to use :meth:`~object.__index__` to convert and " +"pack non-integers before trying the :meth:`~object.__int__` method or " +"reporting an error. (Changed by Mark Dickinson; :issue:`8300`.)" msgstr "" #: whatsnew/2.7.rst:1575 @@ -1766,8 +1771,8 @@ msgstr "" #: whatsnew/2.7.rst:1592 msgid "" "The :mod:`subprocess` module will now retry its internal system calls on " -"receiving an :const:`EINTR` signal. (Reported by several people; final " -"patch by Gregory P. Smith in :issue:`1068268`.)" +"receiving an :const:`~errno.EINTR` signal. (Reported by several people; " +"final patch by Gregory P. Smith in :issue:`1068268`.)" msgstr "" #: whatsnew/2.7.rst:1596 @@ -1778,7 +1783,7 @@ msgid "" "Hylton.)" msgstr "" -#: whatsnew/2.7.rst:2499 +#: whatsnew/2.7.rst:2502 msgid "" "The :mod:`syslog` module will now use the value of ``sys.argv[0]`` as the " "identifier instead of the previous default value of ``'python'``. (Changed " @@ -1787,21 +1792,21 @@ msgstr "" #: whatsnew/2.7.rst:1605 msgid "" -"The ``sys.version_info`` value is now a named tuple, with attributes named :" -"attr:`major`, :attr:`minor`, :attr:`micro`, :attr:`releaselevel`, and :attr:" -"`serial`. (Contributed by Ross Light; :issue:`4285`.)" +"The :attr:`sys.version_info` value is now a named tuple, with attributes " +"named :attr:`!major`, :attr:`!minor`, :attr:`!micro`, :attr:`!releaselevel`, " +"and :attr:`!serial`. (Contributed by Ross Light; :issue:`4285`.)" msgstr "" #: whatsnew/2.7.rst:1610 msgid "" ":func:`sys.getwindowsversion` also returns a named tuple, with attributes " -"named :attr:`major`, :attr:`minor`, :attr:`build`, :attr:`platform`, :attr:" -"`service_pack`, :attr:`service_pack_major`, :attr:`service_pack_minor`, :" -"attr:`suite_mask`, and :attr:`product_type`. (Contributed by Brian Curtin; :" -"issue:`7766`.)" +"named :attr:`!major`, :attr:`!minor`, :attr:`!build`, :attr:`!platform`, :" +"attr:`!service_pack`, :attr:`!service_pack_major`, :attr:`!" +"service_pack_minor`, :attr:`!suite_mask`, and :attr:`!product_type`. " +"(Contributed by Brian Curtin; :issue:`7766`.)" msgstr "" -#: whatsnew/2.7.rst:2503 +#: whatsnew/2.7.rst:2506 msgid "" "The :mod:`tarfile` module's default error handling has changed, to no longer " "suppress fatal errors. The default error level was previously 0, which " @@ -1845,21 +1850,21 @@ msgid "" "Florent Xicluna; :issue:`8024`)." msgstr "" -#: whatsnew/2.7.rst:2511 +#: whatsnew/2.7.rst:2514 msgid "" -"The :mod:`urlparse` module's :func:`~urlparse.urlsplit` now handles unknown " -"URL schemes in a fashion compliant with :rfc:`3986`: if the URL is of the " -"form ``\"://...\"``, the text before the ``://`` is treated as " -"the scheme, even if it's a made-up scheme that the module doesn't know " -"about. This change may break code that worked around the old behaviour. " -"For example, Python 2.6.4 or 2.5 will return the following:" +"The :mod:`urlparse ` module's :func:`~urllib.parse.urlsplit` " +"now handles unknown URL schemes in a fashion compliant with :rfc:`3986`: if " +"the URL is of the form ``\"://...\"``, the text before the ``://" +"`` is treated as the scheme, even if it's a made-up scheme that the module " +"doesn't know about. This change may break code that worked around the old " +"behaviour. For example, Python 2.6.4 or 2.5 will return the following:" msgstr "" -#: whatsnew/2.7.rst:2526 +#: whatsnew/2.7.rst:2529 msgid "Python 2.7 (and Python 2.6.5) will return:" msgstr "" -#: whatsnew/2.7.rst:2535 +#: whatsnew/2.7.rst:2538 msgid "" "(Python 2.7 actually produces slightly different output, since it returns a " "named tuple instead of a standard tuple.)" @@ -1867,8 +1872,9 @@ msgstr "" #: whatsnew/2.7.rst:1678 msgid "" -"The :mod:`urlparse` module also supports IPv6 literal addresses as defined " -"by :rfc:`2732` (contributed by Senthil Kumaran; :issue:`2987`)." +"The :mod:`urlparse ` module also supports IPv6 literal " +"addresses as defined by :rfc:`2732` (contributed by Senthil Kumaran; :issue:" +"`2987`)." msgstr "" #: whatsnew/2.7.rst:1688 @@ -1880,9 +1886,9 @@ msgid "" "Michael Foord.)" msgstr "" -#: whatsnew/2.7.rst:2489 +#: whatsnew/2.7.rst:1694 msgid "" -"The ElementTree library, :mod:`xml.etree`, no longer escapes ampersands and " +"The :mod:`xml.etree.ElementTree` library, no longer escapes ampersands and " "angle brackets when outputting an XML processing instruction (which looks " "like ````) or comment (which looks like " "````). (Patch by Neil Muller; :issue:`2746`.)" @@ -1890,13 +1896,14 @@ msgstr "" #: whatsnew/2.7.rst:1700 msgid "" -"The XML-RPC client and server, provided by the :mod:`xmlrpclib` and :mod:" -"`SimpleXMLRPCServer` modules, have improved performance by supporting " -"HTTP/1.1 keep-alive and by optionally using gzip encoding to compress the " -"XML being exchanged. The gzip compression is controlled by the :attr:" -"`encode_threshold` attribute of :class:`SimpleXMLRPCRequestHandler`, which " -"contains a size in bytes; responses larger than this will be compressed. " -"(Contributed by Kristján Valur Jónsson; :issue:`6267`.)" +"The XML-RPC client and server, provided by the :mod:`xmlrpclib ` and :mod:`SimpleXMLRPCServer ` modules, have " +"improved performance by supporting HTTP/1.1 keep-alive and by optionally " +"using gzip encoding to compress the XML being exchanged. The gzip " +"compression is controlled by the :attr:`!encode_threshold` attribute of :" +"class:`~xmlrpc.server.SimpleXMLRPCRequestHandler`, which contains a size in " +"bytes; responses larger than this will be compressed. (Contributed by " +"Kristján Valur Jónsson; :issue:`6267`.)" msgstr "" #: whatsnew/2.7.rst:1709 @@ -1910,19 +1917,19 @@ msgstr "" msgid "" ":mod:`zipfile` now also supports archiving empty directories and extracts " "them correctly. (Fixed by Kuba Wieczorek; :issue:`4710`.) Reading files out " -"of an archive is faster, and interleaving :meth:`~zipfile.ZipFile.read` and :" -"meth:`~zipfile.ZipFile.readline` now works correctly. (Contributed by Nir " -"Aides; :issue:`7610`.)" +"of an archive is faster, and interleaving :meth:`read() ` and :meth:`readline() ` now works correctly. " +"(Contributed by Nir Aides; :issue:`7610`.)" msgstr "" -#: whatsnew/2.7.rst:1719 +#: whatsnew/2.7.rst:1720 msgid "" "The :func:`~zipfile.is_zipfile` function now accepts a file object, in " "addition to the path names accepted in earlier versions. (Contributed by " "Gabriel Genellina; :issue:`4756`.)" msgstr "" -#: whatsnew/2.7.rst:1723 +#: whatsnew/2.7.rst:1724 msgid "" "The :meth:`~zipfile.ZipFile.writestr` method now has an optional " "*compress_type* parameter that lets you override the default compression " @@ -1930,11 +1937,11 @@ msgid "" "by Ronald Oussoren; :issue:`6003`.)" msgstr "" -#: whatsnew/2.7.rst:1736 +#: whatsnew/2.7.rst:1737 msgid "New module: importlib" msgstr "" -#: whatsnew/2.7.rst:1738 +#: whatsnew/2.7.rst:1739 msgid "" "Python 3.1 includes the :mod:`importlib` package, a re-implementation of the " "logic underlying Python's :keyword:`import` statement. :mod:`importlib` is " @@ -1945,7 +1952,7 @@ msgid "" "import_module`." msgstr "" -#: whatsnew/2.7.rst:1746 +#: whatsnew/2.7.rst:1747 msgid "" "``import_module(name, package=None)`` imports a module. *name* is a string " "containing the module or package's name. It's possible to do relative " @@ -1956,21 +1963,21 @@ msgid "" "imported module into ``sys.modules`` and returns the module object." msgstr "" -#: whatsnew/2.7.rst:1755 +#: whatsnew/2.7.rst:1756 msgid "Here are some examples::" msgstr "" -#: whatsnew/2.7.rst:1766 +#: whatsnew/2.7.rst:1767 msgid "" ":mod:`importlib` was implemented by Brett Cannon and introduced in Python " "3.1." msgstr "" -#: whatsnew/2.7.rst:1771 +#: whatsnew/2.7.rst:1772 msgid "New module: sysconfig" msgstr "" -#: whatsnew/2.7.rst:1773 +#: whatsnew/2.7.rst:1774 msgid "" "The :mod:`sysconfig` module has been pulled out of the Distutils package, " "becoming a new top-level module in its own right. :mod:`sysconfig` provides " @@ -1979,42 +1986,42 @@ msgid "" "running from its source directory." msgstr "" -#: whatsnew/2.7.rst:1780 +#: whatsnew/2.7.rst:1781 msgid "Some of the functions in the module are:" msgstr "" -#: whatsnew/2.7.rst:1782 +#: whatsnew/2.7.rst:1783 msgid "" ":func:`~sysconfig.get_config_var` returns variables from Python's Makefile " "and the :file:`pyconfig.h` file." msgstr "" -#: whatsnew/2.7.rst:1784 +#: whatsnew/2.7.rst:1785 msgid "" ":func:`~sysconfig.get_config_vars` returns a dictionary containing all of " "the configuration variables." msgstr "" -#: whatsnew/2.7.rst:1786 +#: whatsnew/2.7.rst:1787 msgid "" ":func:`~sysconfig.get_path` returns the configured path for a particular " "type of module: the standard library, site-specific modules, platform-" "specific modules, etc." msgstr "" -#: whatsnew/2.7.rst:1789 +#: whatsnew/2.7.rst:1790 msgid "" ":func:`~sysconfig.is_python_build` returns true if you're running a binary " "from a Python source tree, and false otherwise." msgstr "" -#: whatsnew/2.7.rst:1792 +#: whatsnew/2.7.rst:1793 msgid "" "Consult the :mod:`sysconfig` documentation for more details and for a " "complete list of functions." msgstr "" -#: whatsnew/2.7.rst:1795 +#: whatsnew/2.7.rst:1796 msgid "" "The Distutils package and :mod:`sysconfig` are now maintained by Tarek " "Ziadé, who has also started a Distutils2 package (source repository at " @@ -2022,11 +2029,11 @@ msgid "" "of Distutils." msgstr "" -#: whatsnew/2.7.rst:1802 +#: whatsnew/2.7.rst:1803 msgid "ttk: Themed Widgets for Tk" msgstr "" -#: whatsnew/2.7.rst:1804 +#: whatsnew/2.7.rst:1805 msgid "" "Tcl/Tk 8.5 includes a set of themed widgets that re-implement basic Tk " "widgets but have a more customizable appearance and can therefore more " @@ -2035,37 +2042,38 @@ msgid "" "added to Tcl/Tck release 8.5." msgstr "" -#: whatsnew/2.7.rst:1810 +#: whatsnew/2.7.rst:1811 msgid "" -"To learn more, read the :mod:`ttk` module documentation. You may also wish " -"to read the Tcl/Tk manual page describing the Ttk theme engine, available at " -"https://www.tcl.tk/man/tcl8.5/TkCmd/ttk_intro.htm. Some screenshots of the " -"Python/Ttk code in use are at https://code.google.com/archive/p/python-ttk/" -"wikis/Screenshots.wiki." +"To learn more, read the :mod:`~tkinter.ttk` module documentation. You may " +"also wish to read the Tcl/Tk manual page describing the Ttk theme engine, " +"available at https://www.tcl.tk/man/tcl8.5/TkCmd/ttk_intro.html. Some " +"screenshots of the Python/Ttk code in use are at https://code.google.com/" +"archive/p/python-ttk/wikis/Screenshots.wiki." msgstr "" -#: whatsnew/2.7.rst:1817 +#: whatsnew/2.7.rst:1818 msgid "" -"The :mod:`ttk` module was written by Guilherme Polo and added in :issue:" -"`2983`. An alternate version called ``Tile.py``, written by Martin Franklin " -"and maintained by Kevin Walzer, was proposed for inclusion in :issue:`2618`, " -"but the authors argued that Guilherme Polo's work was more comprehensive." +"The :mod:`tkinter.ttk` module was written by Guilherme Polo and added in :" +"issue:`2983`. An alternate version called ``Tile.py``, written by Martin " +"Franklin and maintained by Kevin Walzer, was proposed for inclusion in :" +"issue:`2618`, but the authors argued that Guilherme Polo's work was more " +"comprehensive." msgstr "" -#: whatsnew/2.7.rst:1827 +#: whatsnew/2.7.rst:1828 msgid "Updated module: unittest" msgstr "" -#: whatsnew/2.7.rst:1829 +#: whatsnew/2.7.rst:1830 msgid "" "The :mod:`unittest` module was greatly enhanced; many new features were " "added. Most of these features were implemented by Michael Foord, unless " "otherwise noted. The enhanced version of the module is downloadable " -"separately for use with Python versions 2.4 to 2.6, packaged as the :mod:" -"`unittest2` package, from https://pypi.org/project/unittest2." +"separately for use with Python versions 2.4 to 2.6, packaged as the :mod:`!" +"unittest2` package, from https://pypi.org/project/unittest2." msgstr "" -#: whatsnew/2.7.rst:1836 +#: whatsnew/2.7.rst:1837 msgid "" "When used from the command line, the module can automatically discover " "tests. It's not as fancy as `py.test `__ or `nose " @@ -2075,17 +2083,17 @@ msgid "" "files named ``test*.py``::" msgstr "" -#: whatsnew/2.7.rst:1845 +#: whatsnew/2.7.rst:1846 msgid "" "Consult the :mod:`unittest` module documentation for more details. " "(Developed in :issue:`6001`.)" msgstr "" -#: whatsnew/2.7.rst:1848 +#: whatsnew/2.7.rst:1849 msgid "The :func:`~unittest.main` function supports some other new options:" msgstr "" -#: whatsnew/2.7.rst:1850 +#: whatsnew/2.7.rst:1851 msgid "" ":option:`-b ` or :option:`!--buffer` will buffer the standard " "output and standard error streams during each test. If the test passes, any " @@ -2093,7 +2101,7 @@ msgid "" "displayed." msgstr "" -#: whatsnew/2.7.rst:1855 +#: whatsnew/2.7.rst:1856 msgid "" ":option:`-c ` or :option:`!--catch` will cause the control-C " "interrupt to be handled more gracefully. Instead of interrupting the test " @@ -2102,7 +2110,7 @@ msgid "" "impatient, a second press of control-C will cause an immediate interruption." msgstr "" -#: whatsnew/2.7.rst:1862 +#: whatsnew/2.7.rst:1863 msgid "" "This control-C handler tries to avoid causing problems when the code being " "tested or the tests being run have defined a signal handler of their own, by " @@ -2112,7 +2120,7 @@ msgid "" "disabled." msgstr "" -#: whatsnew/2.7.rst:1869 +#: whatsnew/2.7.rst:1870 msgid "" ":option:`-f ` or :option:`!--failfast` makes test execution " "stop immediately when a test fails instead of continuing to execute further " @@ -2120,20 +2128,20 @@ msgid "" "`8074`.)" msgstr "" -#: whatsnew/2.7.rst:1874 +#: whatsnew/2.7.rst:1875 msgid "" "The progress messages now show 'x' for expected failures and 'u' for " "unexpected successes when run in verbose mode. (Contributed by Benjamin " "Peterson.)" msgstr "" -#: whatsnew/2.7.rst:1878 +#: whatsnew/2.7.rst:1879 msgid "" "Test cases can raise the :exc:`~unittest.SkipTest` exception to skip a test " "(:issue:`1034053`)." msgstr "" -#: whatsnew/2.7.rst:1881 +#: whatsnew/2.7.rst:1882 msgid "" "The error messages for :meth:`~unittest.TestCase.assertEqual`, :meth:" "`~unittest.TestCase.assertTrue`, and :meth:`~unittest.TestCase.assertFalse` " @@ -2144,18 +2152,18 @@ msgid "" "`5663`.)" msgstr "" -#: whatsnew/2.7.rst:1888 +#: whatsnew/2.7.rst:1889 msgid "" "The :meth:`~unittest.TestCase.assertRaises` method now returns a context " "handler when called without providing a callable object to run. For " "example, you can write this::" msgstr "" -#: whatsnew/2.7.rst:1895 +#: whatsnew/2.7.rst:1896 msgid "(Implemented by Antoine Pitrou; :issue:`4444`.)" msgstr "" -#: whatsnew/2.7.rst:1899 +#: whatsnew/2.7.rst:1900 msgid "" "Module- and class-level setup and teardown fixtures are now supported. " "Modules can contain :func:`~unittest.setUpModule` and :func:`~unittest." @@ -2166,7 +2174,7 @@ msgid "" "case in a different module or class." msgstr "" -#: whatsnew/2.7.rst:1907 +#: whatsnew/2.7.rst:1908 msgid "" "The methods :meth:`~unittest.TestCase.addCleanup` and :meth:`~unittest." "TestCase.doCleanups` were added. :meth:`~unittest.TestCase.addCleanup` lets " @@ -2176,7 +2184,7 @@ msgid "" "simpler resource allocation and deallocation during tests (:issue:`5679`)." msgstr "" -#: whatsnew/2.7.rst:1915 +#: whatsnew/2.7.rst:1916 msgid "" "A number of new methods were added that provide more specialized tests. " "Many of these methods were written by Google engineers for use in their test " @@ -2184,21 +2192,21 @@ msgid "" "Python's version of :mod:`unittest`." msgstr "" -#: whatsnew/2.7.rst:1920 +#: whatsnew/2.7.rst:1921 msgid "" ":meth:`~unittest.TestCase.assertIsNone` and :meth:`~unittest.TestCase." "assertIsNotNone` take one expression and verify that the result is or is not " "``None``." msgstr "" -#: whatsnew/2.7.rst:1923 +#: whatsnew/2.7.rst:1924 msgid "" ":meth:`~unittest.TestCase.assertIs` and :meth:`~unittest.TestCase." "assertIsNot` take two values and check whether the two values evaluate to " "the same object or not. (Added by Michael Foord; :issue:`2578`.)" msgstr "" -#: whatsnew/2.7.rst:1927 +#: whatsnew/2.7.rst:1928 msgid "" ":meth:`~unittest.TestCase.assertIsInstance` and :meth:`~unittest.TestCase." "assertNotIsInstance` check whether the resulting object is an instance of a " @@ -2206,14 +2214,14 @@ msgid "" "issue:`7031`.)" msgstr "" -#: whatsnew/2.7.rst:1932 +#: whatsnew/2.7.rst:1933 msgid "" ":meth:`~unittest.TestCase.assertGreater`, :meth:`~unittest.TestCase." "assertGreaterEqual`, :meth:`~unittest.TestCase.assertLess`, and :meth:" "`~unittest.TestCase.assertLessEqual` compare two quantities." msgstr "" -#: whatsnew/2.7.rst:1936 +#: whatsnew/2.7.rst:1937 msgid "" ":meth:`~unittest.TestCase.assertMultiLineEqual` compares two strings, and if " "they're not equal, displays a helpful comparison that highlights the " @@ -2221,40 +2229,41 @@ msgid "" "Unicode strings are compared with :meth:`~unittest.TestCase.assertEqual`." msgstr "" -#: whatsnew/2.7.rst:1941 +#: whatsnew/2.7.rst:1942 msgid "" -":meth:`~unittest.TestCase.assertRegexpMatches` and :meth:`~unittest.TestCase." -"assertNotRegexpMatches` checks whether the first argument is a string " -"matching or not matching the regular expression provided as the second " -"argument (:issue:`8038`)." +":meth:`assertRegexpMatches() ` and :meth:" +"`assertNotRegexpMatches() ` checks whether " +"the first argument is a string matching or not matching the regular " +"expression provided as the second argument (:issue:`8038`)." msgstr "" -#: whatsnew/2.7.rst:1946 +#: whatsnew/2.7.rst:1947 msgid "" -":meth:`~unittest.TestCase.assertRaisesRegexp` checks whether a particular " -"exception is raised, and then also checks that the string representation of " -"the exception matches the provided regular expression." +":meth:`assertRaisesRegexp() ` checks " +"whether a particular exception is raised, and then also checks that the " +"string representation of the exception matches the provided regular " +"expression." msgstr "" -#: whatsnew/2.7.rst:1950 +#: whatsnew/2.7.rst:1952 msgid "" ":meth:`~unittest.TestCase.assertIn` and :meth:`~unittest.TestCase." "assertNotIn` tests whether *first* is or is not in *second*." msgstr "" -#: whatsnew/2.7.rst:1953 +#: whatsnew/2.7.rst:1955 msgid "" -":meth:`~unittest.TestCase.assertItemsEqual` tests whether two provided " -"sequences contain the same elements." +":meth:`assertItemsEqual() ` tests " +"whether two provided sequences contain the same elements." msgstr "" -#: whatsnew/2.7.rst:1956 +#: whatsnew/2.7.rst:1958 msgid "" ":meth:`~unittest.TestCase.assertSetEqual` compares whether two sets are " "equal, and only reports the differences between the sets in case of error." msgstr "" -#: whatsnew/2.7.rst:1959 +#: whatsnew/2.7.rst:1961 msgid "" "Similarly, :meth:`~unittest.TestCase.assertListEqual` and :meth:`~unittest." "TestCase.assertTupleEqual` compare the specified types and explain any " @@ -2265,16 +2274,16 @@ msgid "" "both sequences are of a particular type." msgstr "" -#: whatsnew/2.7.rst:1967 +#: whatsnew/2.7.rst:1969 msgid "" ":meth:`~unittest.TestCase.assertDictEqual` compares two dictionaries and " "reports the differences; it's now used by default when you compare two " -"dictionaries using :meth:`~unittest.TestCase.assertEqual`. :meth:`~unittest." -"TestCase.assertDictContainsSubset` checks whether all of the key/value pairs " -"in *first* are found in *second*." +"dictionaries using :meth:`~unittest.TestCase.assertEqual`. :meth:`!" +"assertDictContainsSubset` checks whether all of the key/value pairs in " +"*first* are found in *second*." msgstr "" -#: whatsnew/2.7.rst:1972 +#: whatsnew/2.7.rst:1974 msgid "" ":meth:`~unittest.TestCase.assertAlmostEqual` and :meth:`~unittest.TestCase." "assertNotAlmostEqual` test whether *first* and *second* are approximately " @@ -2283,14 +2292,14 @@ msgid "" "require the difference to be smaller than a supplied *delta* value." msgstr "" -#: whatsnew/2.7.rst:1978 +#: whatsnew/2.7.rst:1980 msgid "" ":meth:`~unittest.TestLoader.loadTestsFromName` properly honors the :attr:" "`~unittest.TestLoader.suiteClass` attribute of the :class:`~unittest." "TestLoader`. (Fixed by Mark Roddy; :issue:`6866`.)" msgstr "" -#: whatsnew/2.7.rst:1982 +#: whatsnew/2.7.rst:1984 msgid "" "A new hook lets you extend the :meth:`~unittest.TestCase.assertEqual` method " "to handle new data types. The :meth:`~unittest.TestCase." @@ -2302,7 +2311,7 @@ msgid "" "sequence comparison methods do." msgstr "" -#: whatsnew/2.7.rst:1991 +#: whatsnew/2.7.rst:1993 msgid "" ":func:`unittest.main` now takes an optional ``exit`` argument. If false, :" "func:`~unittest.main` doesn't call :func:`sys.exit`, allowing :func:" @@ -2310,7 +2319,7 @@ msgid "" "by J. Pablo Fernández; :issue:`3379`.)" msgstr "" -#: whatsnew/2.7.rst:1996 +#: whatsnew/2.7.rst:1998 msgid "" ":class:`~unittest.TestResult` has new :meth:`~unittest.TestResult." "startTestRun` and :meth:`~unittest.TestResult.stopTestRun` methods that are " @@ -2318,7 +2327,7 @@ msgid "" "Collins; :issue:`5728`.)" msgstr "" -#: whatsnew/2.7.rst:2000 +#: whatsnew/2.7.rst:2002 msgid "" "With all these changes, the :file:`unittest.py` was becoming awkwardly " "large, so the module was turned into a package and the code split into " @@ -2326,43 +2335,43 @@ msgid "" "imported or used." msgstr "" -#: whatsnew/2.7.rst:2008 +#: whatsnew/2.7.rst:2010 msgid "" "https://web.archive.org/web/20210619163128/http://www.voidspace.org.uk/" "python/articles/unittest2.shtml" msgstr "" -#: whatsnew/2.7.rst:2008 +#: whatsnew/2.7.rst:2010 msgid "" "Describes the new features, how to use them, and the rationale for various " "design decisions. (By Michael Foord.)" msgstr "" -#: whatsnew/2.7.rst:2014 +#: whatsnew/2.7.rst:2016 msgid "Updated module: ElementTree 1.3" msgstr "" -#: whatsnew/2.7.rst:2016 +#: whatsnew/2.7.rst:2018 msgid "" "The version of the ElementTree library included with Python was updated to " "version 1.3. Some of the new features are:" msgstr "" -#: whatsnew/2.7.rst:2019 +#: whatsnew/2.7.rst:2021 msgid "" "The various parsing functions now take a *parser* keyword argument giving " "an :class:`~xml.etree.ElementTree.XMLParser` instance that will be used. " "This makes it possible to override the file's internal encoding::" msgstr "" -#: whatsnew/2.7.rst:2026 +#: whatsnew/2.7.rst:2028 msgid "" -"Errors in parsing XML now raise a :exc:`ParseError` exception, whose " -"instances have a :attr:`position` attribute containing a (*line*, *column*) " -"tuple giving the location of the problem." +"Errors in parsing XML now raise a :exc:`~xml.etree.ElementTree.ParseError` " +"exception, whose instances have a :attr:`!position` attribute containing a " +"(*line*, *column*) tuple giving the location of the problem." msgstr "" -#: whatsnew/2.7.rst:2030 +#: whatsnew/2.7.rst:2032 msgid "" "ElementTree's code for converting trees to a string has been significantly " "reworked, making it roughly twice as fast in many cases. The :meth:" @@ -2371,12 +2380,13 @@ msgid "" "\"xml\" (the default), \"html\", or \"text\". HTML mode will output empty " "elements as ```` instead of ````, and text mode will " "skip over elements and only output the text chunks. If you set the :attr:" -"`tag` attribute of an element to ``None`` but leave its children in place, " -"the element will be omitted when the tree is written out, so you don't need " -"to do more extensive rearrangement to remove a single element." +"`~xml.etree.ElementTree.Element.tag` attribute of an element to ``None`` but " +"leave its children in place, the element will be omitted when the tree is " +"written out, so you don't need to do more extensive rearrangement to remove " +"a single element." msgstr "" -#: whatsnew/2.7.rst:2042 +#: whatsnew/2.7.rst:2045 msgid "" "Namespace handling has also been improved. All ``xmlns:`` " "declarations are now output on the root element, not scattered throughout " @@ -2386,7 +2396,7 @@ msgid "" "the true/false *xml_declaration* parameter to suppress the XML declaration." msgstr "" -#: whatsnew/2.7.rst:2050 +#: whatsnew/2.7.rst:2053 msgid "" "New :class:`~xml.etree.ElementTree.Element` method: :meth:`~xml.etree." "ElementTree.Element.extend` appends the items from a sequence to the " @@ -2394,22 +2404,24 @@ msgid "" "to move children from one element to another::" msgstr "" -#: whatsnew/2.7.rst:2067 +#: whatsnew/2.7.rst:2070 msgid "" -"New :class:`Element` method: :meth:`~xml.etree.ElementTree.Element.iter` " -"yields the children of the element as a generator. It's also possible to " -"write ``for child in elem:`` to loop over an element's children. The " -"existing method :meth:`getiterator` is now deprecated, as is :meth:" -"`getchildren` which constructs and returns a list of children." +"New :class:`~xml.etree.ElementTree.Element` method: :meth:`~xml.etree." +"ElementTree.Element.iter` yields the children of the element as a " +"generator. It's also possible to write ``for child in elem:`` to loop over " +"an element's children. The existing method :meth:`!getiterator` is now " +"deprecated, as is :meth:`!getchildren` which constructs and returns a list " +"of children." msgstr "" -#: whatsnew/2.7.rst:2074 +#: whatsnew/2.7.rst:2077 msgid "" -"New :class:`Element` method: :meth:`~xml.etree.ElementTree.Element.itertext` " -"yields all chunks of text that are descendants of the element. For example::" +"New :class:`~xml.etree.ElementTree.Element` method: :meth:`~xml.etree." +"ElementTree.Element.itertext` yields all chunks of text that are descendants " +"of the element. For example::" msgstr "" -#: whatsnew/2.7.rst:2085 +#: whatsnew/2.7.rst:2088 msgid "" "Deprecated: using an element as a Boolean (i.e., ``if elem:``) would return " "true if the element had any children, or false if there were no children. " @@ -2419,7 +2431,7 @@ msgid "" "number of children, or ``elem is not None``." msgstr "" -#: whatsnew/2.7.rst:2093 +#: whatsnew/2.7.rst:2096 msgid "" "Fredrik Lundh develops ElementTree and produced the 1.3 version; you can " "read his article describing 1.3 at https://web.archive.org/" @@ -2428,15 +2440,15 @@ msgid "" "python-dev and in :issue:`6472`.)" msgstr "" -#: whatsnew/2.7.rst:2103 +#: whatsnew/2.7.rst:2106 msgid "Build and C API Changes" msgstr "" -#: whatsnew/2.7.rst:2105 +#: whatsnew/2.7.rst:2108 msgid "Changes to Python's build process and to the C API include:" msgstr "" -#: whatsnew/2.7.rst:2107 +#: whatsnew/2.7.rst:2110 msgid "" "The latest release of the GNU Debugger, GDB 7, can be `scripted using Python " "`_; discussed in :issue:`5753`, and fixed by " "Antoine Pitrou." msgstr "" -#: whatsnew/2.7.rst:2182 +#: whatsnew/2.7.rst:2185 msgid "" "New macros: the Python header files now define the following macros: :c:" "macro:`Py_ISALNUM`, :c:macro:`Py_ISALPHA`, :c:macro:`Py_ISDIGIT`, :c:macro:" @@ -2555,7 +2567,7 @@ msgid "" "Eric Smith; :issue:`5793`.)" msgstr "" -#: whatsnew/2.7.rst:2200 +#: whatsnew/2.7.rst:2203 msgid "" "Removed function: :c:func:`!PyEval_CallObject` is now only available as a " "macro. A function version was being kept around to preserve ABI linking " @@ -2563,7 +2575,7 @@ msgid "" "(Removed by Antoine Pitrou; :issue:`8276`.)" msgstr "" -#: whatsnew/2.7.rst:2205 +#: whatsnew/2.7.rst:2208 msgid "" "New format codes: the :c:func:`!PyString_FromFormat`, :c:func:`!" "PyString_FromFormatV`, and :c:func:`PyErr_Format` functions now accept " @@ -2571,7 +2583,7 @@ msgid "" "types. (Contributed by Mark Dickinson; :issue:`7228`.)" msgstr "" -#: whatsnew/2.7.rst:2211 +#: whatsnew/2.7.rst:2214 msgid "" "The complicated interaction between threads and process forking has been " "changed. Previously, the child process created by :func:`os.fork` might " @@ -2583,7 +2595,7 @@ msgid "" "replicated, and the child process would no longer be able to perform imports." msgstr "" -#: whatsnew/2.7.rst:2221 +#: whatsnew/2.7.rst:2224 msgid "" "Python 2.7 acquires the import lock before performing an :func:`os.fork`, " "and will also clean up any locks created using the :mod:`threading` module. " @@ -2591,38 +2603,39 @@ msgid "" "themselves, will not benefit from this clean-up." msgstr "" -#: whatsnew/2.7.rst:2227 +#: whatsnew/2.7.rst:2230 msgid "(Fixed by Thomas Wouters; :issue:`1590864`.)" msgstr "" -#: whatsnew/2.7.rst:2229 +#: whatsnew/2.7.rst:2232 msgid "" -"The :c:func:`Py_Finalize` function now calls the internal :func:`threading." +"The :c:func:`Py_Finalize` function now calls the internal :func:`!threading." "_shutdown` function; this prevents some exceptions from being raised when an " "interpreter shuts down. (Patch by Adam Olsen; :issue:`1722344`.)" msgstr "" -#: whatsnew/2.7.rst:2234 +#: whatsnew/2.7.rst:2237 msgid "" "When using the :c:type:`PyMemberDef` structure to define attributes of a " "type, Python will no longer let you try to delete or set a :c:macro:" "`T_STRING_INPLACE` attribute." msgstr "" -#: whatsnew/2.7.rst:2240 +#: whatsnew/2.7.rst:2243 msgid "" "Global symbols defined by the :mod:`ctypes` module are now prefixed with " "``Py``, or with ``_ctypes``. (Implemented by Thomas Heller; :issue:`3102`.)" msgstr "" -#: whatsnew/2.7.rst:2244 +#: whatsnew/2.7.rst:2247 msgid "" "New configure option: the :option:`!--with-system-expat` switch allows " -"building the :mod:`pyexpat` module to use the system Expat library. " -"(Contributed by Arfrever Frehtes Taifersar Arahesis; :issue:`7609`.)" +"building the :mod:`pyexpat ` module to use the system " +"Expat library. (Contributed by Arfrever Frehtes Taifersar Arahesis; :issue:" +"`7609`.)" msgstr "" -#: whatsnew/2.7.rst:2248 +#: whatsnew/2.7.rst:2251 msgid "" "New configure option: the :option:`!--with-valgrind` option will now disable " "the pymalloc allocator, which is difficult for the Valgrind memory-error " @@ -2631,14 +2644,14 @@ msgid "" "issue:`2422`.)" msgstr "" -#: whatsnew/2.7.rst:2255 +#: whatsnew/2.7.rst:2258 msgid "" "New configure option: you can now supply an empty string to :option:`!--with-" "dbmliborder=` in order to disable all of the various DBM modules. (Added by " "Arfrever Frehtes Taifersar Arahesis; :issue:`6491`.)" msgstr "" -#: whatsnew/2.7.rst:2260 +#: whatsnew/2.7.rst:2263 msgid "" "The :program:`configure` script now checks for floating-point rounding bugs " "on certain 32-bit Intel chips and defines a :c:macro:`X87_DOUBLE_ROUNDING` " @@ -2647,30 +2660,30 @@ msgid "" "`2937`.)" msgstr "" -#: whatsnew/2.7.rst:2266 +#: whatsnew/2.7.rst:2269 msgid "" ":program:`configure` also now sets a :envvar:`LDCXXSHARED` Makefile variable " "for supporting C++ linking. (Contributed by Arfrever Frehtes Taifersar " "Arahesis; :issue:`1222585`.)" msgstr "" -#: whatsnew/2.7.rst:2270 +#: whatsnew/2.7.rst:2273 msgid "" "The build process now creates the necessary files for pkg-config support. " "(Contributed by Clinton Roy; :issue:`3585`.)" msgstr "" -#: whatsnew/2.7.rst:2273 +#: whatsnew/2.7.rst:2276 msgid "" "The build process now supports Subversion 1.7. (Contributed by Arfrever " "Frehtes Taifersar Arahesis; :issue:`6094`.)" msgstr "" -#: whatsnew/2.7.rst:2280 +#: whatsnew/2.7.rst:2283 msgid "Capsules" msgstr "" -#: whatsnew/2.7.rst:2282 +#: whatsnew/2.7.rst:2285 msgid "" "Python 3.1 adds a new C datatype, :c:type:`PyCapsule`, for providing a C API " "to an extension module. A capsule is essentially the holder of a C ``void " @@ -2682,7 +2695,7 @@ msgid "" "module's various API functions." msgstr "" -#: whatsnew/2.7.rst:2291 +#: whatsnew/2.7.rst:2294 msgid "" "There is an existing data type already used for this, :c:type:`!PyCObject`, " "but it doesn't provide type safety. Evil code written in pure Python could " @@ -2692,7 +2705,7 @@ msgid "" "name:" msgstr "" -#: whatsnew/2.7.rst:2309 +#: whatsnew/2.7.rst:2312 msgid "" "You are assured that ``vtable`` points to whatever you're expecting. If a " "different capsule was passed in, :c:func:`PyCapsule_IsValid` would detect " @@ -2700,7 +2713,7 @@ msgid "" "more information on using these objects." msgstr "" -#: whatsnew/2.7.rst:2314 +#: whatsnew/2.7.rst:2317 msgid "" "Python 2.7 now uses capsules internally to provide various extension-module " "APIs, but the :c:func:`!PyCObject_AsVoidPtr` was modified to handle " @@ -2709,68 +2722,69 @@ msgid "" "exc:`PendingDeprecationWarning`, which is silent by default." msgstr "" -#: whatsnew/2.7.rst:2321 +#: whatsnew/2.7.rst:2324 msgid "" "Implemented in Python 3.1 and backported to 2.7 by Larry Hastings; discussed " "in :issue:`5630`." msgstr "" -#: whatsnew/2.7.rst:2328 +#: whatsnew/2.7.rst:2331 msgid "Port-Specific Changes: Windows" msgstr "" -#: whatsnew/2.7.rst:2330 +#: whatsnew/2.7.rst:2333 msgid "" "The :mod:`msvcrt` module now contains some constants from the :file:" -"`crtassem.h` header file: :data:`CRT_ASSEMBLY_VERSION`, :data:" -"`VC_ASSEMBLY_PUBLICKEYTOKEN`, and :data:`LIBRARIES_ASSEMBLY_NAME_PREFIX`. " -"(Contributed by David Cournapeau; :issue:`4365`.)" +"`crtassem.h` header file: :data:`~msvcrt.CRT_ASSEMBLY_VERSION`, :data:" +"`~msvcrt.VC_ASSEMBLY_PUBLICKEYTOKEN`, and :data:`~msvcrt." +"LIBRARIES_ASSEMBLY_NAME_PREFIX`. (Contributed by David Cournapeau; :issue:" +"`4365`.)" msgstr "" -#: whatsnew/2.7.rst:2337 +#: whatsnew/2.7.rst:2340 msgid "" -"The :mod:`_winreg` module for accessing the registry now implements the :" -"func:`~_winreg.CreateKeyEx` and :func:`~_winreg.DeleteKeyEx` functions, " +"The :mod:`_winreg ` module for accessing the registry now implements " +"the :func:`~winreg.CreateKeyEx` and :func:`~winreg.DeleteKeyEx` functions, " "extended versions of previously supported functions that take several extra " -"arguments. The :func:`~_winreg.DisableReflectionKey`, :func:`~_winreg." -"EnableReflectionKey`, and :func:`~_winreg.QueryReflectionKey` were also " +"arguments. The :func:`~winreg.DisableReflectionKey`, :func:`~winreg." +"EnableReflectionKey`, and :func:`~winreg.QueryReflectionKey` were also " "tested and documented. (Implemented by Brian Curtin: :issue:`7347`.)" msgstr "" -#: whatsnew/2.7.rst:2345 +#: whatsnew/2.7.rst:2348 msgid "" -"The new :c:func:`_beginthreadex` API is used to start threads, and the " +"The new :c:func:`!_beginthreadex` API is used to start threads, and the " "native thread-local storage functions are now used. (Contributed by Kristján " "Valur Jónsson; :issue:`3582`.)" msgstr "" -#: whatsnew/2.7.rst:2349 +#: whatsnew/2.7.rst:2352 msgid "" "The :func:`os.kill` function now works on Windows. The signal value can be " -"the constants :const:`CTRL_C_EVENT`, :const:`CTRL_BREAK_EVENT`, or any " -"integer. The first two constants will send :kbd:`Control-C` and :kbd:" -"`Control-Break` keystroke events to subprocesses; any other value will use " -"the :c:func:`TerminateProcess` API. (Contributed by Miki Tebeka; :issue:" -"`1220212`.)" +"the constants :const:`~signal.CTRL_C_EVENT`, :const:`~signal." +"CTRL_BREAK_EVENT`, or any integer. The first two constants will send :kbd:" +"`Control-C` and :kbd:`Control-Break` keystroke events to subprocesses; any " +"other value will use the :c:func:`!TerminateProcess` API. (Contributed by " +"Miki Tebeka; :issue:`1220212`.)" msgstr "" -#: whatsnew/2.7.rst:2356 +#: whatsnew/2.7.rst:2359 msgid "" "The :func:`os.listdir` function now correctly fails for an empty path. " "(Fixed by Hirokazu Yamamoto; :issue:`5913`.)" msgstr "" -#: whatsnew/2.7.rst:2359 +#: whatsnew/2.7.rst:2362 msgid "" -"The :mod:`mimelib` module will now read the MIME database from the Windows " +"The :mod:`mimetypes` module will now read the MIME database from the Windows " "registry when initializing. (Patch by Gabriel Genellina; :issue:`4969`.)" msgstr "" -#: whatsnew/2.7.rst:2366 +#: whatsnew/2.7.rst:2369 msgid "Port-Specific Changes: Mac OS X" msgstr "" -#: whatsnew/2.7.rst:2368 +#: whatsnew/2.7.rst:2371 msgid "" "The path ``/Library/Python/2.7/site-packages`` is now appended to ``sys." "path``, in order to share added packages between the system installation and " @@ -2778,7 +2792,7 @@ msgid "" "issue:`4865`.)" msgstr "" -#: whatsnew/2.7.rst:2375 +#: whatsnew/2.7.rst:2378 msgid "" "As of 2.7.13, this change was removed. ``/Library/Python/2.7/site-" "packages``, the site-packages directory used by the Apple-supplied system " @@ -2790,23 +2804,23 @@ msgid "" "Pythons. (:issue:`28440`)" msgstr "" -#: whatsnew/2.7.rst:2386 +#: whatsnew/2.7.rst:2389 msgid "Port-Specific Changes: FreeBSD" msgstr "" -#: whatsnew/2.7.rst:2388 +#: whatsnew/2.7.rst:2391 msgid "" -"FreeBSD 7.1's :const:`SO_SETFIB` constant, used with the :func:`~socket." +"FreeBSD 7.1's :const:`!SO_SETFIB` constant, used with the :func:`~socket." "socket` methods :func:`~socket.socket.getsockopt`/:func:`~socket.socket." "setsockopt` to select an alternate routing table, is now available in the :" "mod:`socket` module. (Added by Kyle VanderBeek; :issue:`8235`.)" msgstr "" -#: whatsnew/2.7.rst:2394 +#: whatsnew/2.7.rst:2397 msgid "Other Changes and Fixes" msgstr "" -#: whatsnew/2.7.rst:2396 +#: whatsnew/2.7.rst:2399 msgid "" "Two benchmark scripts, :file:`iobench` and :file:`ccbench`, were added to " "the :file:`Tools` directory. :file:`iobench` measures the speed of the " @@ -2816,13 +2830,13 @@ msgid "" "bandwidth when performing several tasks using a varying number of threads." msgstr "" -#: whatsnew/2.7.rst:2404 +#: whatsnew/2.7.rst:2407 msgid "" "The :file:`Tools/i18n/msgfmt.py` script now understands plural forms in :" "file:`.po` files. (Fixed by Martin von Löwis; :issue:`5464`.)" msgstr "" -#: whatsnew/2.7.rst:2408 +#: whatsnew/2.7.rst:2411 msgid "" "When importing a module from a :file:`.pyc` or :file:`.pyo` file with an " "existing :file:`.py` counterpart, the :attr:`~codeobject.co_filename` " @@ -2832,7 +2846,7 @@ msgid "" "Paul Calderone; :issue:`1180193`.)" msgstr "" -#: whatsnew/2.7.rst:2415 +#: whatsnew/2.7.rst:2418 msgid "" "The :file:`regrtest.py` script now takes a :option:`!--randseed=` switch " "that takes an integer that will be used as the random seed for the :option:" @@ -2840,7 +2854,7 @@ msgid "" "also reports the seed that was used (Added by Collin Winter.)" msgstr "" -#: whatsnew/2.7.rst:2421 +#: whatsnew/2.7.rst:2424 msgid "" "Another :file:`regrtest.py` switch is :option:`!-j`, which takes an integer " "specifying how many tests run in parallel. This allows reducing the total " @@ -2851,31 +2865,31 @@ msgid "" "they fail. (Added by Antoine Pitrou; :issue:`7312`.)" msgstr "" -#: whatsnew/2.7.rst:2430 +#: whatsnew/2.7.rst:2433 msgid "" "When executed as a script, the :file:`py_compile.py` module now accepts " "``'-'`` as an argument, which will read standard input for the list of " "filenames to be compiled. (Contributed by Piotr Ożarowski; :issue:`8233`.)" msgstr "" -#: whatsnew/2.7.rst:2438 +#: whatsnew/2.7.rst:2441 msgid "Porting to Python 2.7" msgstr "" -#: whatsnew/2.7.rst:2440 +#: whatsnew/2.7.rst:2443 msgid "" "This section lists previously described changes and other bugfixes that may " "require changes to your code:" msgstr "" -#: whatsnew/2.7.rst:2443 +#: whatsnew/2.7.rst:2446 msgid "" "The :func:`range` function processes its arguments more consistently; it " -"will now call :meth:`__int__` on non-float, non-integer arguments that are " -"supplied to it. (Fixed by Alexander Belopolsky; :issue:`1533`.)" +"will now call :meth:`~object.__int__` on non-float, non-integer arguments " +"that are supplied to it. (Fixed by Alexander Belopolsky; :issue:`1533`.)" msgstr "" -#: whatsnew/2.7.rst:2448 +#: whatsnew/2.7.rst:2451 msgid "" "The string :meth:`format` method changed the default precision used for " "floating-point and complex numbers from 6 decimal places to 12, which " @@ -2883,7 +2897,7 @@ msgid "" "`5920`.)" msgstr "" -#: whatsnew/2.7.rst:2453 +#: whatsnew/2.7.rst:2456 msgid "" "Because of an optimization for the :keyword:`with` statement, the special " "methods :meth:`~object.__enter__` and :meth:`~object.__exit__` must belong " @@ -2892,7 +2906,7 @@ msgid "" "C extension types. (:issue:`6101`.)" msgstr "" -#: whatsnew/2.7.rst:2459 +#: whatsnew/2.7.rst:2462 msgid "" "Due to a bug in Python 2.6, the *exc_value* parameter to :meth:`~object." "__exit__` methods was often the string representation of the exception, not " @@ -2900,11 +2914,11 @@ msgid "" "expected. (Fixed by Florent Xicluna; :issue:`7853`.)" msgstr "" -#: whatsnew/2.7.rst:2469 +#: whatsnew/2.7.rst:2472 msgid "In the standard library:" msgstr "" -#: whatsnew/2.7.rst:2471 +#: whatsnew/2.7.rst:2474 msgid "" "Operations with :class:`~datetime.datetime` instances that resulted in a " "year falling outside the supported range didn't always raise :exc:" @@ -2913,7 +2927,7 @@ msgid "" "Alexander Belopolsky; :issue:`7150`.)" msgstr "" -#: whatsnew/2.7.rst:2477 +#: whatsnew/2.7.rst:2480 msgid "" "When using :class:`~decimal.Decimal` instances with a string's :meth:" "`format` method, the default alignment was previously left-alignment. This " @@ -2921,44 +2935,44 @@ msgid "" "programs. (Changed by Mark Dickinson; :issue:`6857`.)" msgstr "" -#: whatsnew/2.7.rst:2483 +#: whatsnew/2.7.rst:2492 msgid "" -"Comparisons involving a signaling NaN value (or ``sNAN``) now signal :const:" -"`~decimal.InvalidOperation` instead of silently returning a true or false " -"value depending on the comparison operator. Quiet NaN values (or ``NaN``) " -"are now hashable. (Fixed by Mark Dickinson; :issue:`7279`.)" +"The :mod:`xml.etree.ElementTree` library no longer escapes ampersands and " +"angle brackets when outputting an XML processing instruction (which looks " +"like ````) or comment (which looks like " +"````). (Patch by Neil Muller; :issue:`2746`.)" msgstr "" -#: whatsnew/2.7.rst:2495 +#: whatsnew/2.7.rst:2498 msgid "" -"The :meth:`~StringIO.StringIO.readline` method of :class:`~StringIO." -"StringIO` objects now does nothing when a negative length is requested, as " -"other file-like objects do. (:issue:`7348`)." +"The :meth:`!readline` method of :class:`~io.StringIO` objects now does " +"nothing when a negative length is requested, as other file-like objects do. " +"(:issue:`7348`)." msgstr "" -#: whatsnew/2.7.rst:2538 +#: whatsnew/2.7.rst:2541 msgid "For C extensions:" msgstr "" -#: whatsnew/2.7.rst:2540 +#: whatsnew/2.7.rst:2543 msgid "" "C extensions that use integer format codes with the ``PyArg_Parse*`` family " "of functions will now raise a :exc:`TypeError` exception instead of " "triggering a :exc:`DeprecationWarning` (:issue:`5080`)." msgstr "" -#: whatsnew/2.7.rst:2544 +#: whatsnew/2.7.rst:2547 msgid "" "Use the new :c:func:`PyOS_string_to_double` function instead of the old :c:" "func:`!PyOS_ascii_strtod` and :c:func:`!PyOS_ascii_atof` functions, which " "are now deprecated." msgstr "" -#: whatsnew/2.7.rst:2548 +#: whatsnew/2.7.rst:2551 msgid "For applications that embed Python:" msgstr "" -#: whatsnew/2.7.rst:2550 +#: whatsnew/2.7.rst:2553 msgid "" "The :c:func:`PySys_SetArgvEx` function was added, letting applications close " "a security hole when the existing :c:func:`PySys_SetArgv` function was " @@ -2967,11 +2981,11 @@ msgid "" "with *updatepath* set to false." msgstr "" -#: whatsnew/2.7.rst:2563 +#: whatsnew/2.7.rst:2566 msgid "New Features Added to Python 2.7 Maintenance Releases" msgstr "" -#: whatsnew/2.7.rst:2565 +#: whatsnew/2.7.rst:2568 msgid "" "New features may be added to Python 2.7 maintenance releases when the " "situation genuinely calls for it. Any such additions must go through the " @@ -2980,38 +2994,38 @@ msgid "" "Python 3, or else by publishing it on the Python Package Index." msgstr "" -#: whatsnew/2.7.rst:2571 +#: whatsnew/2.7.rst:2574 msgid "" "In addition to the specific proposals listed below, there is a general " "exemption allowing new ``-3`` warnings to be added in any Python 2.7 " "maintenance release." msgstr "" -#: whatsnew/2.7.rst:2577 +#: whatsnew/2.7.rst:2580 msgid "Two new environment variables for debug mode" msgstr "" -#: whatsnew/2.7.rst:2579 +#: whatsnew/2.7.rst:2582 msgid "" "In debug mode, the ``[xxx refs]`` statistic is not written by default, the :" -"envvar:`PYTHONSHOWREFCOUNT` environment variable now must also be set. " +"envvar:`!PYTHONSHOWREFCOUNT` environment variable now must also be set. " "(Contributed by Victor Stinner; :issue:`31733`.)" msgstr "" -#: whatsnew/2.7.rst:2583 +#: whatsnew/2.7.rst:2586 msgid "" "When Python is compiled with ``COUNT_ALLOC`` defined, allocation counts are " -"no longer dumped by default anymore: the :envvar:`PYTHONSHOWALLOCCOUNT` " +"no longer dumped by default anymore: the :envvar:`!PYTHONSHOWALLOCCOUNT` " "environment variable must now also be set. Moreover, allocation counts are " "now dumped into stderr, rather than stdout. (Contributed by Victor Stinner; :" "issue:`31692`.)" msgstr "" -#: whatsnew/2.7.rst:2592 +#: whatsnew/2.7.rst:2595 msgid "PEP 434: IDLE Enhancement Exception for All Branches" msgstr "" -#: whatsnew/2.7.rst:2594 +#: whatsnew/2.7.rst:2597 msgid "" ":pep:`434` describes a general exemption for changes made to the IDLE " "development environment shipped along with Python. This exemption makes it " @@ -3019,62 +3033,62 @@ msgid "" "experience across all supported versions of Python 2 and 3." msgstr "" -#: whatsnew/2.7.rst:2599 +#: whatsnew/2.7.rst:2602 msgid "" "For details of any IDLE changes, refer to the NEWS file for the specific " "release." msgstr "" -#: whatsnew/2.7.rst:2604 +#: whatsnew/2.7.rst:2607 msgid "PEP 466: Network Security Enhancements for Python 2.7" msgstr "" -#: whatsnew/2.7.rst:2606 +#: whatsnew/2.7.rst:2609 msgid "" ":pep:`466` describes a number of network security enhancement proposals that " "have been approved for inclusion in Python 2.7 maintenance releases, with " "the first of those changes appearing in the Python 2.7.7 release." msgstr "" -#: whatsnew/2.7.rst:2610 +#: whatsnew/2.7.rst:2613 msgid ":pep:`466` related features added in Python 2.7.7:" msgstr "" -#: whatsnew/2.7.rst:2612 +#: whatsnew/2.7.rst:2615 msgid "" ":func:`hmac.compare_digest` was backported from Python 3 to make a timing " "attack resistant comparison operation available to Python 2 applications. " "(Contributed by Alex Gaynor; :issue:`21306`.)" msgstr "" -#: whatsnew/2.7.rst:2616 +#: whatsnew/2.7.rst:2619 msgid "" "OpenSSL 1.0.1g was upgraded in the official Windows installers published on " "python.org. (Contributed by Zachary Ware; :issue:`21462`.)" msgstr "" -#: whatsnew/2.7.rst:2619 +#: whatsnew/2.7.rst:2622 msgid ":pep:`466` related features added in Python 2.7.8:" msgstr "" -#: whatsnew/2.7.rst:2621 +#: whatsnew/2.7.rst:2624 msgid "" ":func:`hashlib.pbkdf2_hmac` was backported from Python 3 to make a hashing " "algorithm suitable for secure password storage broadly available to Python 2 " "applications. (Contributed by Alex Gaynor; :issue:`21304`.)" msgstr "" -#: whatsnew/2.7.rst:2625 +#: whatsnew/2.7.rst:2628 msgid "" "OpenSSL 1.0.1h was upgraded for the official Windows installers published on " "python.org. (contributed by Zachary Ware in :issue:`21671` for CVE-2014-0224)" msgstr "" -#: whatsnew/2.7.rst:2628 +#: whatsnew/2.7.rst:2631 msgid ":pep:`466` related features added in Python 2.7.9:" msgstr "" -#: whatsnew/2.7.rst:2630 +#: whatsnew/2.7.rst:2633 msgid "" "Most of Python 3.4's :mod:`ssl` module was backported. This means :mod:`ssl` " "now supports Server Name Indication, TLS1.x settings, access to the platform " @@ -3082,20 +3096,20 @@ msgid "" "(Contributed by Alex Gaynor and David Reid; :issue:`21308`.)" msgstr "" -#: whatsnew/2.7.rst:2635 +#: whatsnew/2.7.rst:2638 msgid "" "Refer to the \"Version added: 2.7.9\" notes in the module documentation for " "specific details." msgstr "" -#: whatsnew/2.7.rst:2638 +#: whatsnew/2.7.rst:2641 msgid "" ":func:`os.urandom` was changed to cache a file descriptor to ``/dev/" "urandom`` instead of reopening ``/dev/urandom`` on every call. (Contributed " "by Alex Gaynor; :issue:`21305`.)" msgstr "" -#: whatsnew/2.7.rst:2642 +#: whatsnew/2.7.rst:2645 msgid "" ":data:`hashlib.algorithms_guaranteed` and :data:`hashlib." "algorithms_available` were backported from Python 3 to make it easier for " @@ -3103,22 +3117,22 @@ msgid "" "(Contributed by Alex Gaynor in :issue:`21307`)" msgstr "" -#: whatsnew/2.7.rst:2649 +#: whatsnew/2.7.rst:2652 msgid "PEP 477: Backport ensurepip (PEP 453) to Python 2.7" msgstr "" -#: whatsnew/2.7.rst:2651 +#: whatsnew/2.7.rst:2654 msgid "" ":pep:`477` approves the inclusion of the :pep:`453` ensurepip module and the " "improved documentation that was enabled by it in the Python 2.7 maintenance " "releases, appearing first in the Python 2.7.9 release." msgstr "" -#: whatsnew/2.7.rst:2657 +#: whatsnew/2.7.rst:2660 msgid "Bootstrapping pip By Default" msgstr "" -#: whatsnew/2.7.rst:2659 +#: whatsnew/2.7.rst:2662 msgid "" "The new :mod:`ensurepip` module (defined in :pep:`453`) provides a standard " "cross-platform mechanism to bootstrap the pip installer into Python " @@ -3128,14 +3142,14 @@ msgid "" "the release candidate." msgstr "" -#: whatsnew/2.7.rst:2666 +#: whatsnew/2.7.rst:2669 msgid "" "By default, the commands ``pip``, ``pipX`` and ``pipX.Y`` will be installed " "on all platforms (where X.Y stands for the version of the Python " "installation), along with the ``pip`` Python package and its dependencies." msgstr "" -#: whatsnew/2.7.rst:2670 +#: whatsnew/2.7.rst:2673 msgid "" "For CPython :ref:`source builds on POSIX systems `, " "the ``make install`` and ``make altinstall`` commands do not bootstrap " @@ -3143,7 +3157,7 @@ msgid "" "options, and overridden through Makefile options." msgstr "" -#: whatsnew/2.7.rst:2675 +#: whatsnew/2.7.rst:2678 msgid "" "On Windows and Mac OS X, the CPython installers now default to installing " "``pip`` along with CPython itself (users may opt out of installing it during " @@ -3153,7 +3167,7 @@ msgid "" "Windows as ``py -m pip``." msgstr "" -#: whatsnew/2.7.rst:2682 +#: whatsnew/2.7.rst:2685 msgid "" "As `discussed in the PEP`__, platform packagers may choose not to install " "these commands by default, as long as, when invoked, they provide clear and " @@ -3161,11 +3175,11 @@ msgid "" "system package manager)." msgstr "" -#: whatsnew/2.7.rst:2691 +#: whatsnew/2.7.rst:2694 msgid "Documentation Changes" msgstr "" -#: whatsnew/2.7.rst:2693 +#: whatsnew/2.7.rst:2696 msgid "" "As part of this change, the :ref:`installing-index` and :ref:`distributing-" "index` sections of the documentation have been completely redesigned as " @@ -3175,49 +3189,49 @@ msgid "" "of the individual projects." msgstr "" -#: whatsnew/2.7.rst:2701 +#: whatsnew/2.7.rst:2704 msgid "" "However, as this migration is currently still incomplete, the legacy " "versions of those guides remaining available as :ref:`install-index` and :" "ref:`setuptools-index`." msgstr "" -#: whatsnew/2.7.rst:2708 +#: whatsnew/2.7.rst:2711 msgid ":pep:`453` -- Explicit bootstrapping of pip in Python installations" msgstr "" -#: whatsnew/2.7.rst:2708 +#: whatsnew/2.7.rst:2711 msgid "" "PEP written by Donald Stufft and Nick Coghlan, implemented by Donald Stufft, " "Nick Coghlan, Martin von Löwis and Ned Deily." msgstr "" -#: whatsnew/2.7.rst:2712 +#: whatsnew/2.7.rst:2715 msgid "" "PEP 476: Enabling certificate verification by default for stdlib http clients" msgstr "" -#: whatsnew/2.7.rst:2714 +#: whatsnew/2.7.rst:2717 msgid "" -":pep:`476` updated :mod:`httplib` and modules which use it, such as :mod:" -"`urllib2` and :mod:`xmlrpclib`, to now verify that the server presents a " -"certificate which is signed by a Certificate Authority in the platform trust " -"store and whose hostname matches the hostname being requested by default, " -"significantly improving security for many applications. This change was made " -"in the Python 2.7.9 release." +":pep:`476` updated :mod:`httplib ` and modules which use it, such as :" +"mod:`urllib2 ` and :mod:`xmlrpclib `, to now " +"verify that the server presents a certificate which is signed by a " +"Certificate Authority in the platform trust store and whose hostname matches " +"the hostname being requested by default, significantly improving security " +"for many applications. This change was made in the Python 2.7.9 release." msgstr "" -#: whatsnew/2.7.rst:2721 +#: whatsnew/2.7.rst:2725 msgid "" "For applications which require the old previous behavior, they can pass an " "alternate context::" msgstr "" -#: whatsnew/2.7.rst:2738 +#: whatsnew/2.7.rst:2742 msgid "PEP 493: HTTPS verification migration tools for Python 2.7" msgstr "" -#: whatsnew/2.7.rst:2740 +#: whatsnew/2.7.rst:2744 msgid "" ":pep:`493` provides additional migration tools to support a more incremental " "infrastructure upgrade process for environments containing applications and " @@ -3226,14 +3240,14 @@ msgid "" "were made in the Python 2.7.12 release." msgstr "" -#: whatsnew/2.7.rst:2746 +#: whatsnew/2.7.rst:2750 msgid "" "These tools are intended for use in cases where affected applications and " "services can't be modified to explicitly pass a more permissive SSL context " "when establishing the connection." msgstr "" -#: whatsnew/2.7.rst:2750 +#: whatsnew/2.7.rst:2754 msgid "" "For applications and services which can't be modified at all, the new " "``PYTHONHTTPSVERIFY`` environment variable may be set to ``0`` to revert an " @@ -3241,18 +3255,18 @@ msgid "" "2.7.8 and earlier." msgstr "" -#: whatsnew/2.7.rst:2755 +#: whatsnew/2.7.rst:2759 msgid "" "For cases where the connection establishment code can't be modified, but the " -"overall application can be, the new :func:`ssl._https_verify_certificates` " +"overall application can be, the new :func:`!ssl._https_verify_certificates` " "function can be used to adjust the default behaviour at runtime." msgstr "" -#: whatsnew/2.7.rst:2761 +#: whatsnew/2.7.rst:2765 msgid "New ``make regen-all`` build target" msgstr "" -#: whatsnew/2.7.rst:2763 +#: whatsnew/2.7.rst:2767 msgid "" "To simplify cross-compilation, and to ensure that CPython can reliably be " "compiled without requiring an existing version of Python to already be " @@ -3260,43 +3274,43 @@ msgid "" "recompile generated files based on file modification times." msgstr "" -#: whatsnew/2.7.rst:2768 +#: whatsnew/2.7.rst:2772 msgid "" "Instead, a new ``make regen-all`` command has been added to force " "regeneration of these files when desired (e.g. after an initial version of " "Python has already been built based on the pregenerated versions)." msgstr "" -#: whatsnew/2.7.rst:2772 +#: whatsnew/2.7.rst:2776 msgid "" "More selective regeneration targets are also defined - see :source:`Makefile." "pre.in` for details." msgstr "" -#: whatsnew/2.7.rst:2788 +#: whatsnew/2.7.rst:2792 msgid "(Contributed by Victor Stinner in :issue:`23404`.)" msgstr "" -#: whatsnew/2.7.rst:2781 +#: whatsnew/2.7.rst:2785 msgid "Removal of ``make touch`` build target" msgstr "" -#: whatsnew/2.7.rst:2783 +#: whatsnew/2.7.rst:2787 msgid "" "The ``make touch`` build target previously used to request implicit " "regeneration of generated files by updating their modification times has " "been removed." msgstr "" -#: whatsnew/2.7.rst:2786 +#: whatsnew/2.7.rst:2790 msgid "It has been replaced by the new ``make regen-all`` target." msgstr "" -#: whatsnew/2.7.rst:2797 +#: whatsnew/2.7.rst:2801 msgid "Acknowledgements" msgstr "" -#: whatsnew/2.7.rst:2799 +#: whatsnew/2.7.rst:2803 msgid "" "The author would like to thank the following people for offering " "suggestions, corrections and assistance with various drafts of this article: " diff --git a/whatsnew/3.0.po b/whatsnew/3.0.po index 4492f3d6a..f507cd123 100644 --- a/whatsnew/3.0.po +++ b/whatsnew/3.0.po @@ -7,7 +7,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-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -388,9 +388,9 @@ msgstr "" #: whatsnew/3.0.rst:340 msgid "" -"The :mod:`StringIO` and :mod:`cStringIO` modules are gone. Instead, import " -"the :mod:`io` module and use :class:`io.StringIO` or :class:`io.BytesIO` for " -"text and data respectively." +"The :mod:`!StringIO` and :mod:`!cStringIO` modules are gone. Instead, " +"import the :mod:`io` module and use :class:`io.StringIO` or :class:`io." +"BytesIO` for text and data respectively." msgstr "" #: whatsnew/3.0.rst:344 @@ -721,17 +721,17 @@ msgstr "" #: whatsnew/3.0.rst:558 msgid "" -"Many old modules were removed. Some, like :mod:`gopherlib` (no longer used) " -"and :mod:`md5` (replaced by :mod:`hashlib`), were already deprecated by :pep:" -"`4`. Others were removed as a result of the removal of support for various " -"platforms such as Irix, BeOS and Mac OS 9 (see :pep:`11`). Some modules " -"were also selected for removal in Python 3.0 due to lack of use or because a " -"better replacement exists. See :pep:`3108` for an exhaustive list." +"Many old modules were removed. Some, like :mod:`!gopherlib` (no longer " +"used) and :mod:`!md5` (replaced by :mod:`hashlib`), were already deprecated " +"by :pep:`4`. Others were removed as a result of the removal of support for " +"various platforms such as Irix, BeOS and Mac OS 9 (see :pep:`11`). Some " +"modules were also selected for removal in Python 3.0 due to lack of use or " +"because a better replacement exists. See :pep:`3108` for an exhaustive list." msgstr "" #: whatsnew/3.0.rst:566 msgid "" -"The :mod:`bsddb3` package was removed because its presence in the core " +"The :mod:`!bsddb3` package was removed because its presence in the core " "standard library has proved over time to be a particular burden for the core " "developers due to testing instability and Berkeley DB's release schedule. " "However, the package is alive and well, externally maintained at https://www." @@ -820,14 +820,14 @@ msgstr "" msgid "" "A common pattern in Python 2.x is to have one version of a module " "implemented in pure Python, with an optional accelerated version implemented " -"as a C extension; for example, :mod:`pickle` and :mod:`cPickle`. This " +"as a C extension; for example, :mod:`pickle` and :mod:`!cPickle`. This " "places the burden of importing the accelerated version and falling back on " "the pure Python version on each user of these modules. In Python 3.0, the " "accelerated versions are considered implementation details of the pure " "Python versions. Users should always import the standard version, which " "attempts to import the accelerated version and falls back to the pure Python " -"version. The :mod:`pickle` / :mod:`cPickle` pair received this treatment. " -"The :mod:`profile` module is on the list for 3.1. The :mod:`StringIO` " +"version. The :mod:`pickle` / :mod:`!cPickle` pair received this treatment. " +"The :mod:`profile` module is on the list for 3.1. The :mod:`!StringIO` " "module has been turned into a class in the :mod:`io` module." msgstr "" @@ -839,18 +839,18 @@ msgstr "" #: whatsnew/3.0.rst:606 msgid "" -":mod:`dbm` (:mod:`anydbm`, :mod:`dbhash`, :mod:`dbm`, :mod:`dumbdbm`, :mod:" -"`gdbm`, :mod:`whichdb`)." +":mod:`dbm` (:mod:`!anydbm`, :mod:`!dbhash`, :mod:`!dbm`, :mod:`!dumbdbm`, :" +"mod:`!gdbm`, :mod:`!whichdb`)." msgstr "" #: whatsnew/3.0.rst:609 -msgid ":mod:`html` (:mod:`HTMLParser`, :mod:`htmlentitydefs`)." +msgid ":mod:`html` (:mod:`!HTMLParser`, :mod:`!htmlentitydefs`)." msgstr "" #: whatsnew/3.0.rst:611 msgid "" -":mod:`http` (:mod:`httplib`, :mod:`BaseHTTPServer`, :mod:`CGIHTTPServer`, :" -"mod:`SimpleHTTPServer`, :mod:`Cookie`, :mod:`cookielib`)." +":mod:`http` (:mod:`!httplib`, :mod:`!BaseHTTPServer`, :mod:`!" +"CGIHTTPServer`, :mod:`!SimpleHTTPServer`, :mod:`!Cookie`, :mod:`!cookielib`)." msgstr "" #: whatsnew/3.0.rst:615 @@ -863,14 +863,14 @@ msgstr "" #: whatsnew/3.0.rst:620 msgid "" -":mod:`urllib` (:mod:`urllib`, :mod:`urllib2`, :mod:`urlparse`, :mod:" -"`robotparse`)." +":mod:`urllib` (:mod:`!urllib`, :mod:`!urllib2`, :mod:`!urlparse`, :mod:`!" +"robotparse`)." msgstr "" #: whatsnew/3.0.rst:623 msgid "" -":mod:`xmlrpc` (:mod:`xmlrpclib`, :mod:`DocXMLRPCServer`, :mod:" -"`SimpleXMLRPCServer`)." +":mod:`xmlrpc` (:mod:`!xmlrpclib`, :mod:`!DocXMLRPCServer`, :mod:`!" +"SimpleXMLRPCServer`)." msgstr "" #: whatsnew/3.0.rst:626 @@ -879,7 +879,7 @@ msgid "" msgstr "" #: whatsnew/3.0.rst:629 -msgid "Killed :mod:`sets`. Use the built-in :func:`set` class." +msgid "Killed :mod:`!sets`. Use the built-in :func:`set` class." msgstr "" #: whatsnew/3.0.rst:631 @@ -905,8 +905,9 @@ msgstr "" #: whatsnew/3.0.rst:645 msgid "" -"Cleanup of the :mod:`thread` module: :func:`acquire_lock` and :func:" -"`release_lock` are gone; use :func:`acquire` and :func:`release` instead." +"Cleanup of the :mod:`!thread` module: :func:`!acquire_lock` and :func:`!" +"release_lock` are gone; use :meth:`~threading.Lock.acquire` and :meth:" +"`~threading.Lock.release` instead." msgstr "" #: whatsnew/3.0.rst:649 @@ -914,7 +915,7 @@ msgid "Cleanup of the :mod:`random` module: removed the :func:`jumpahead` API." msgstr "" #: whatsnew/3.0.rst:651 -msgid "The :mod:`new` module is gone." +msgid "The :mod:`!new` module is gone." msgstr "" #: whatsnew/3.0.rst:653 diff --git a/whatsnew/3.1.po b/whatsnew/3.1.po index ac60c6311..cd98a2575 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: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -79,11 +79,24 @@ msgid "" "by Raymond Hettinger." msgstr "" -#: whatsnew/3.1.rst:85 +#: whatsnew/3.1.rst:83 +msgid "" +"Since an ordered dictionary remembers its insertion order, it can be used in " +"conjunction with sorting to make a sorted dictionary::" +msgstr "" + +#: whatsnew/3.1.rst:101 +msgid "" +"The new sorted dictionaries maintain their sort order when entries are " +"deleted. But when new keys are added, the keys are appended to the end and " +"the sort is not maintained." +msgstr "" + +#: whatsnew/3.1.rst:107 msgid "PEP 378: Format Specifier for Thousands Separator" msgstr "" -#: whatsnew/3.1.rst:87 +#: whatsnew/3.1.rst:109 msgid "" "The built-in :func:`format` function and the :meth:`str.format` method use a " "mini-language that now includes a simple, non-locale aware way to format a " @@ -91,13 +104,13 @@ msgid "" "program's output, improving its professional appearance and readability::" msgstr "" -#: whatsnew/3.1.rst:101 +#: whatsnew/3.1.rst:123 msgid "" "The supported types are :class:`int`, :class:`float`, :class:`complex` and :" "class:`decimal.Decimal`." msgstr "" -#: whatsnew/3.1.rst:104 +#: whatsnew/3.1.rst:126 msgid "" "Discussions are underway about how to specify alternative separators like " "dots, spaces, apostrophes, or underscores. Locale-aware applications should " @@ -105,25 +118,25 @@ msgid "" "thousands separators." msgstr "" -#: whatsnew/3.1.rst:112 +#: whatsnew/3.1.rst:134 msgid ":pep:`378` - Format Specifier for Thousands Separator" msgstr "" -#: whatsnew/3.1.rst:112 +#: whatsnew/3.1.rst:134 msgid "" "PEP written by Raymond Hettinger and implemented by Eric Smith and Mark " "Dickinson." msgstr "" -#: whatsnew/3.1.rst:117 +#: whatsnew/3.1.rst:139 msgid "Other Language Changes" msgstr "" -#: whatsnew/3.1.rst:119 +#: whatsnew/3.1.rst:141 msgid "Some smaller changes made to the core Python language are:" msgstr "" -#: whatsnew/3.1.rst:121 +#: whatsnew/3.1.rst:143 msgid "" "Directories and zip archives containing a :file:`__main__.py` file can now " "be executed directly by passing their name to the interpreter. The directory/" @@ -132,36 +145,36 @@ msgid "" "and Nick Coghlan; :issue:`1739468`.)" msgstr "" -#: whatsnew/3.1.rst:127 +#: whatsnew/3.1.rst:149 msgid "" "The :func:`int` type gained a ``bit_length`` method that returns the number " "of bits necessary to represent its argument in binary::" msgstr "" -#: whatsnew/3.1.rst:141 +#: whatsnew/3.1.rst:163 msgid "" "(Contributed by Fredrik Johansson, Victor Stinner, Raymond Hettinger, and " "Mark Dickinson; :issue:`3439`.)" msgstr "" -#: whatsnew/3.1.rst:144 +#: whatsnew/3.1.rst:166 msgid "" "The fields in :func:`format` strings can now be automatically numbered::" msgstr "" -#: whatsnew/3.1.rst:150 +#: whatsnew/3.1.rst:172 msgid "" "Formerly, the string would have required numbered fields such as: ``'Sir {0} " "of {1}'``." msgstr "" -#: whatsnew/3.1.rst:153 +#: whatsnew/3.1.rst:175 msgid "(Contributed by Eric Smith; :issue:`5237`.)" msgstr "" -#: whatsnew/3.1.rst:155 +#: whatsnew/3.1.rst:177 msgid "" -"The :func:`string.maketrans` function is deprecated and is replaced by new " +"The :func:`!string.maketrans` function is deprecated and is replaced by new " "static methods, :meth:`bytes.maketrans` and :meth:`bytearray.maketrans`. " "This change solves the confusion around which types were supported by the :" "mod:`string` module. Now, :class:`str`, :class:`bytes`, and :class:" @@ -169,46 +182,46 @@ msgid "" "intermediate translation tables of the appropriate type." msgstr "" -#: whatsnew/3.1.rst:162 +#: whatsnew/3.1.rst:184 msgid "(Contributed by Georg Brandl; :issue:`5675`.)" msgstr "" -#: whatsnew/3.1.rst:164 +#: whatsnew/3.1.rst:186 msgid "" "The syntax of the :keyword:`with` statement now allows multiple context " "managers in a single statement::" msgstr "" -#: whatsnew/3.1.rst:172 +#: whatsnew/3.1.rst:194 msgid "" -"With the new syntax, the :func:`contextlib.nested` function is no longer " +"With the new syntax, the :func:`!contextlib.nested` function is no longer " "needed and is now deprecated." msgstr "" -#: whatsnew/3.1.rst:175 +#: whatsnew/3.1.rst:197 msgid "" "(Contributed by Georg Brandl and Mattias Brändström; `appspot issue 53094 " "`_.)" msgstr "" -#: whatsnew/3.1.rst:178 +#: whatsnew/3.1.rst:200 msgid "" "``round(x, n)`` now returns an integer if *x* is an integer. Previously it " "returned a float::" msgstr "" -#: whatsnew/3.1.rst:184 +#: whatsnew/3.1.rst:206 msgid "(Contributed by Mark Dickinson; :issue:`4707`.)" msgstr "" -#: whatsnew/3.1.rst:186 +#: whatsnew/3.1.rst:208 msgid "" "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." msgstr "" -#: whatsnew/3.1.rst:191 +#: whatsnew/3.1.rst:213 msgid "" "The significance is easily seen with a number like ``1.1`` which does not " "have an exact equivalent in binary floating point. Since there is no exact " @@ -219,7 +232,7 @@ msgid "" "calculations." msgstr "" -#: whatsnew/3.1.rst:199 +#: whatsnew/3.1.rst:221 msgid "" "What is new is how the number gets displayed. Formerly, Python used a " "simple approach. The value of ``repr(1.1)`` was computed as ``format(1.1, " @@ -231,7 +244,7 @@ msgid "" "problem with Python itself)." msgstr "" -#: whatsnew/3.1.rst:208 +#: whatsnew/3.1.rst:230 msgid "" "The new algorithm for ``repr(1.1)`` is smarter and returns ``'1.1'``. " "Effectively, it searches all equivalent string representations (ones that " @@ -239,14 +252,14 @@ msgid "" "representation." msgstr "" -#: whatsnew/3.1.rst:213 +#: whatsnew/3.1.rst:235 msgid "" "The new algorithm tends to emit cleaner representations when possible, but " "it does not change the underlying values. So, it is still the case that " "``1.1 + 2.2 != 3.3`` even though the representations may suggest otherwise." msgstr "" -#: whatsnew/3.1.rst:217 +#: whatsnew/3.1.rst:239 msgid "" "The new algorithm depends on certain features in the underlying floating " "point implementation. If the required features are not found, the old " @@ -254,64 +267,64 @@ msgid "" "cross-platform portability by using the old algorithm." msgstr "" -#: whatsnew/3.1.rst:222 +#: whatsnew/3.1.rst:244 msgid "(Contributed by Eric Smith and Mark Dickinson; :issue:`1580`)" msgstr "" -#: whatsnew/3.1.rst:225 +#: whatsnew/3.1.rst:247 msgid "New, Improved, and Deprecated Modules" msgstr "" -#: whatsnew/3.1.rst:227 +#: whatsnew/3.1.rst:249 msgid "" "Added a :class:`collections.Counter` class to support convenient counting of " "unique items in a sequence or iterable::" msgstr "" -#: whatsnew/3.1.rst:233 +#: whatsnew/3.1.rst:255 msgid "(Contributed by Raymond Hettinger; :issue:`1696199`.)" msgstr "" -#: whatsnew/3.1.rst:235 +#: whatsnew/3.1.rst:257 msgid "" "Added a new module, :mod:`tkinter.ttk` for access to the Tk themed widget " "set. The basic idea of ttk is to separate, to the extent possible, the code " "implementing a widget's behavior from the code implementing its appearance." msgstr "" -#: whatsnew/3.1.rst:239 +#: whatsnew/3.1.rst:261 msgid "(Contributed by Guilherme Polo; :issue:`2983`.)" msgstr "" -#: whatsnew/3.1.rst:241 +#: whatsnew/3.1.rst:263 msgid "" "The :class:`gzip.GzipFile` and :class:`bz2.BZ2File` classes now support the " "context management protocol::" msgstr "" -#: whatsnew/3.1.rst:248 +#: whatsnew/3.1.rst:270 msgid "(Contributed by Antoine Pitrou.)" msgstr "" -#: whatsnew/3.1.rst:250 +#: whatsnew/3.1.rst:272 msgid "" "The :mod:`decimal` module now supports methods for creating a decimal object " "from a binary :class:`float`. The conversion is exact but can sometimes be " "surprising::" msgstr "" -#: whatsnew/3.1.rst:257 +#: whatsnew/3.1.rst:279 msgid "" "The long decimal result shows the actual binary fraction being stored for " "*1.1*. The fraction has many digits because *1.1* cannot be exactly " "represented in binary." msgstr "" -#: whatsnew/3.1.rst:261 +#: whatsnew/3.1.rst:283 msgid "(Contributed by Raymond Hettinger and Mark Dickinson.)" msgstr "" -#: whatsnew/3.1.rst:263 +#: whatsnew/3.1.rst:285 msgid "" "The :mod:`itertools` module grew two new functions. The :func:`itertools." "combinations_with_replacement` function is one of four for generating " @@ -322,11 +335,11 @@ msgid "" "`fractions.Fraction` and :class:`decimal.Decimal`::" msgstr "" -#: whatsnew/3.1.rst:282 +#: whatsnew/3.1.rst:304 msgid "(Contributed by Raymond Hettinger.)" msgstr "" -#: whatsnew/3.1.rst:284 +#: whatsnew/3.1.rst:306 msgid "" ":func:`collections.namedtuple` now supports a keyword argument *rename* " "which lets invalid fieldnames be automatically converted to positional names " @@ -335,21 +348,21 @@ msgid "" "input::" msgstr "" -#: whatsnew/3.1.rst:301 +#: whatsnew/3.1.rst:323 msgid "(Contributed by Raymond Hettinger; :issue:`1818`.)" msgstr "" -#: whatsnew/3.1.rst:303 +#: whatsnew/3.1.rst:325 msgid "" "The :func:`re.sub`, :func:`re.subn` and :func:`re.split` functions now " "accept a flags parameter." msgstr "" -#: whatsnew/3.1.rst:306 +#: whatsnew/3.1.rst:328 msgid "(Contributed by Gregory Smith.)" msgstr "" -#: whatsnew/3.1.rst:308 +#: whatsnew/3.1.rst:330 msgid "" "The :mod:`logging` module now implements a simple :class:`logging." "NullHandler` class for applications that are not using logging but are " @@ -357,52 +370,52 @@ msgid "" "spurious warnings such as \"No handlers could be found for logger foo\"::" msgstr "" -#: whatsnew/3.1.rst:316 +#: whatsnew/3.1.rst:338 msgid "(Contributed by Vinay Sajip; :issue:`4384`)." msgstr "" -#: whatsnew/3.1.rst:318 +#: whatsnew/3.1.rst:340 msgid "" "The :mod:`runpy` module which supports the ``-m`` command line switch now " "supports the execution of packages by looking for and executing a " "``__main__`` submodule when a package name is supplied." msgstr "" -#: whatsnew/3.1.rst:322 +#: whatsnew/3.1.rst:344 msgid "(Contributed by Andi Vajda; :issue:`4195`.)" msgstr "" -#: whatsnew/3.1.rst:324 +#: whatsnew/3.1.rst:346 msgid "" "The :mod:`pdb` module can now access and display source code loaded via :mod:" "`zipimport` (or any other conformant :pep:`302` loader)." msgstr "" -#: whatsnew/3.1.rst:327 +#: whatsnew/3.1.rst:349 msgid "(Contributed by Alexander Belopolsky; :issue:`4201`.)" msgstr "" -#: whatsnew/3.1.rst:329 +#: whatsnew/3.1.rst:351 msgid ":class:`functools.partial` objects can now be pickled." msgstr "" -#: whatsnew/3.1.rst:331 +#: whatsnew/3.1.rst:353 msgid "" "(Suggested by Antoine Pitrou and Jesse Noller. Implemented by Jack " "Diederich; :issue:`5228`.)" msgstr "" -#: whatsnew/3.1.rst:334 +#: whatsnew/3.1.rst:356 msgid "" "Add :mod:`pydoc` help topics for symbols so that ``help('@')`` works as " "expected in the interactive environment." msgstr "" -#: whatsnew/3.1.rst:337 +#: whatsnew/3.1.rst:359 msgid "(Contributed by David Laban; :issue:`4739`.)" msgstr "" -#: whatsnew/3.1.rst:339 +#: whatsnew/3.1.rst:361 msgid "" "The :mod:`unittest` module now supports skipping individual tests or classes " "of tests. And it supports marking a test as an expected failure, a test that " @@ -410,48 +423,50 @@ msgid "" "TestResult::" msgstr "" -#: whatsnew/3.1.rst:354 +#: whatsnew/3.1.rst:376 msgid "" "Also, tests for exceptions have been builtout to work with context managers " "using the :keyword:`with` statement::" msgstr "" -#: whatsnew/3.1.rst:361 +#: whatsnew/3.1.rst:383 msgid "" -"In addition, several new assertion methods were added including :func:" -"`assertSetEqual`, :func:`assertDictEqual`, :func:" -"`assertDictContainsSubset`, :func:`assertListEqual`, :func:" -"`assertTupleEqual`, :func:`assertSequenceEqual`, :func:" -"`assertRaisesRegexp`, :func:`assertIsNone`, and :func:`assertIsNotNone`." +"In addition, several new assertion methods were added including :meth:" +"`~unittest.TestCase.assertSetEqual`, :meth:`~unittest.TestCase." +"assertDictEqual`, :meth:`!assertDictContainsSubset`, :meth:`~unittest." +"TestCase.assertListEqual`, :meth:`~unittest.TestCase.assertTupleEqual`, :" +"meth:`~unittest.TestCase.assertSequenceEqual`, :meth:`assertRaisesRegexp() " +"`, :meth:`~unittest.TestCase." +"assertIsNone`, and :meth:`~unittest.TestCase.assertIsNotNone`." msgstr "" -#: whatsnew/3.1.rst:368 +#: whatsnew/3.1.rst:394 msgid "(Contributed by Benjamin Peterson and Antoine Pitrou.)" msgstr "" -#: whatsnew/3.1.rst:370 +#: whatsnew/3.1.rst:396 msgid "" -"The :mod:`io` module has three new constants for the :meth:`seek` method :" -"data:`SEEK_SET`, :data:`SEEK_CUR`, and :data:`SEEK_END`." +"The :mod:`io` module has three new constants for the :meth:`~io.IOBase.seek` " +"method: :data:`~os.SEEK_SET`, :data:`~os.SEEK_CUR`, and :data:`~os.SEEK_END`." msgstr "" -#: whatsnew/3.1.rst:373 +#: whatsnew/3.1.rst:399 msgid "The :data:`sys.version_info` tuple is now a named tuple::" msgstr "" -#: whatsnew/3.1.rst:378 +#: whatsnew/3.1.rst:404 msgid "(Contributed by Ross Light; :issue:`4285`.)" msgstr "" -#: whatsnew/3.1.rst:380 +#: whatsnew/3.1.rst:406 msgid "The :mod:`nntplib` and :mod:`imaplib` modules now support IPv6." msgstr "" -#: whatsnew/3.1.rst:382 +#: whatsnew/3.1.rst:408 msgid "(Contributed by Derek Morr; :issue:`1655` and :issue:`1664`.)" msgstr "" -#: whatsnew/3.1.rst:384 +#: whatsnew/3.1.rst:410 msgid "" "The :mod:`pickle` module has been adapted for better interoperability with " "Python 2.x when used with protocol 2 or lower. The reorganization of the " @@ -464,7 +479,7 @@ msgid "" "*fix_imports* option::" msgstr "" -#: whatsnew/3.1.rst:400 +#: whatsnew/3.1.rst:426 msgid "" "An unfortunate but unavoidable side-effect of this change is that protocol 2 " "pickles produced by Python 3.1 won't be readable with Python 3.0. The latest " @@ -473,12 +488,12 @@ msgid "" "Python 2.x." msgstr "" -#: whatsnew/3.1.rst:406 +#: whatsnew/3.1.rst:432 msgid "" "(Contributed by Alexandre Vassalotti and Antoine Pitrou, :issue:`6137`.)" msgstr "" -#: whatsnew/3.1.rst:408 +#: whatsnew/3.1.rst:434 msgid "" "A new module, :mod:`importlib` was added. It provides a complete, portable, " "pure Python reference implementation of the :keyword:`import` statement and " @@ -487,19 +502,19 @@ msgid "" "place during imports." msgstr "" -#: whatsnew/3.1.rst:414 +#: whatsnew/3.1.rst:440 msgid "(Contributed by Brett Cannon.)" msgstr "" -#: whatsnew/3.1.rst:417 +#: whatsnew/3.1.rst:443 msgid "Optimizations" msgstr "" -#: whatsnew/3.1.rst:419 +#: whatsnew/3.1.rst:445 msgid "Major performance enhancements have been added:" msgstr "" -#: whatsnew/3.1.rst:421 +#: whatsnew/3.1.rst:447 msgid "" "The new I/O library (as defined in :pep:`3116`) was mostly written in Python " "and quickly proved to be a problematic bottleneck in Python 3.0. In Python " @@ -508,11 +523,11 @@ msgid "" "available for experimentation purposes through the ``_pyio`` module." msgstr "" -#: whatsnew/3.1.rst:428 +#: whatsnew/3.1.rst:454 msgid "(Contributed by Amaury Forgeot d'Arc and Antoine Pitrou.)" msgstr "" -#: whatsnew/3.1.rst:430 +#: whatsnew/3.1.rst:456 msgid "" "Added a heuristic so that tuples and dicts containing only untrackable " "objects are not tracked by the garbage collector. This can reduce the size " @@ -520,11 +535,11 @@ msgid "" "programs, depending on their particular use of datatypes." msgstr "" -#: whatsnew/3.1.rst:435 +#: whatsnew/3.1.rst:461 msgid "(Contributed by Antoine Pitrou, :issue:`4688`.)" msgstr "" -#: whatsnew/3.1.rst:437 +#: whatsnew/3.1.rst:463 msgid "" "Enabling a configure option named ``--with-computed-gotos`` on compilers " "that support it (notably: gcc, SunPro, icc), the bytecode evaluation loop is " @@ -532,23 +547,23 @@ msgid "" "depending on the system, the compiler, and the benchmark." msgstr "" -#: whatsnew/3.1.rst:443 +#: whatsnew/3.1.rst:469 msgid "" "(Contributed by Antoine Pitrou along with a number of other participants, :" "issue:`4753`)." msgstr "" -#: whatsnew/3.1.rst:446 +#: whatsnew/3.1.rst:472 msgid "" "The decoding of UTF-8, UTF-16 and LATIN-1 is now two to four times faster." msgstr "" -#: whatsnew/3.1.rst:449 +#: whatsnew/3.1.rst:475 msgid "" "(Contributed by Antoine Pitrou and Amaury Forgeot d'Arc, :issue:`4868`.)" msgstr "" -#: whatsnew/3.1.rst:451 +#: whatsnew/3.1.rst:477 msgid "" "The :mod:`json` module now has a C extension to substantially improve its " "performance. In addition, the API was modified so that json works only " @@ -557,45 +572,45 @@ msgid "" "in terms of Unicode." msgstr "" -#: whatsnew/3.1.rst:457 +#: whatsnew/3.1.rst:483 msgid "" "(Contributed by Bob Ippolito and converted to Py3.1 by Antoine Pitrou and " "Benjamin Peterson; :issue:`4136`.)" msgstr "" -#: whatsnew/3.1.rst:460 +#: whatsnew/3.1.rst:486 msgid "" "Unpickling now interns the attribute names of pickled objects. This saves " "memory and allows pickles to be smaller." msgstr "" -#: whatsnew/3.1.rst:463 +#: whatsnew/3.1.rst:489 msgid "(Contributed by Jake McGuire and Antoine Pitrou; :issue:`5084`.)" msgstr "" -#: whatsnew/3.1.rst:466 +#: whatsnew/3.1.rst:492 msgid "IDLE" msgstr "" -#: whatsnew/3.1.rst:468 +#: whatsnew/3.1.rst:494 msgid "" "IDLE's format menu now provides an option to strip trailing whitespace from " "a source file." msgstr "" -#: whatsnew/3.1.rst:471 +#: whatsnew/3.1.rst:497 msgid "(Contributed by Roger D. Serwy; :issue:`5150`.)" msgstr "" -#: whatsnew/3.1.rst:474 +#: whatsnew/3.1.rst:500 msgid "Build and C API Changes" msgstr "" -#: whatsnew/3.1.rst:476 +#: whatsnew/3.1.rst:502 msgid "Changes to Python's build process and to the C API include:" msgstr "" -#: whatsnew/3.1.rst:478 +#: whatsnew/3.1.rst:504 msgid "" "Integers are now stored internally either in base ``2**15`` or in base " "``2**30``, the base being determined at build time. Previously, they were " @@ -607,7 +622,7 @@ msgid "" "this default." msgstr "" -#: whatsnew/3.1.rst:487 +#: whatsnew/3.1.rst:513 msgid "" "Apart from the performance improvements this change should be invisible to " "end users, with one exception: for testing and debugging purposes there's a " @@ -616,41 +631,41 @@ msgid "" "type used to store each digit::" msgstr "" -#: whatsnew/3.1.rst:497 +#: whatsnew/3.1.rst:523 msgid "(Contributed by Mark Dickinson; :issue:`4258`.)" msgstr "" -#: whatsnew/3.1.rst:499 +#: whatsnew/3.1.rst:525 msgid "" "The :c:func:`PyLong_AsUnsignedLongLong()` function now handles a negative " "*pylong* by raising :exc:`OverflowError` instead of :exc:`TypeError`." msgstr "" -#: whatsnew/3.1.rst:502 +#: whatsnew/3.1.rst:528 msgid "(Contributed by Mark Dickinson and Lisandro Dalcrin; :issue:`5175`.)" msgstr "" -#: whatsnew/3.1.rst:504 +#: whatsnew/3.1.rst:530 msgid "" "Deprecated :c:func:`!PyNumber_Int`. Use :c:func:`PyNumber_Long` instead." msgstr "" -#: whatsnew/3.1.rst:506 +#: whatsnew/3.1.rst:532 msgid "(Contributed by Mark Dickinson; :issue:`4910`.)" msgstr "" -#: whatsnew/3.1.rst:508 +#: whatsnew/3.1.rst:534 msgid "" "Added a new :c:func:`PyOS_string_to_double` function to replace the " "deprecated functions :c:func:`!PyOS_ascii_strtod` and :c:func:`!" "PyOS_ascii_atof`." msgstr "" -#: whatsnew/3.1.rst:511 +#: whatsnew/3.1.rst:537 msgid "(Contributed by Mark Dickinson; :issue:`5914`.)" msgstr "" -#: whatsnew/3.1.rst:513 +#: whatsnew/3.1.rst:539 msgid "" "Added :c:type:`PyCapsule` as a replacement for the :c:type:`!PyCObject` API. " "The principal difference is that the new type has a well defined interface " @@ -659,27 +674,27 @@ msgid "" "deprecated." msgstr "" -#: whatsnew/3.1.rst:519 +#: whatsnew/3.1.rst:545 msgid "(Contributed by Larry Hastings; :issue:`5630`.)" msgstr "" -#: whatsnew/3.1.rst:522 +#: whatsnew/3.1.rst:548 msgid "Porting to Python 3.1" msgstr "" -#: whatsnew/3.1.rst:524 +#: whatsnew/3.1.rst:550 msgid "" "This section lists previously described changes and other bugfixes that may " "require changes to your code:" msgstr "" -#: whatsnew/3.1.rst:527 +#: whatsnew/3.1.rst:553 msgid "" "The new floating point string representations can break existing doctests. " "For example::" msgstr "" -#: whatsnew/3.1.rst:550 +#: whatsnew/3.1.rst:576 msgid "" "The automatic name remapping in the pickle module for protocol 2 or lower " "can make Python 3.1 pickles unreadable in Python 3.0. One solution is to " diff --git a/whatsnew/3.10.po b/whatsnew/3.10.po index 3e19f28c3..680a3893c 100644 --- a/whatsnew/3.10.po +++ b/whatsnew/3.10.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -122,7 +122,7 @@ msgstr "" msgid ":pep:`597`, Add optional EncodingWarning" msgstr "" -#: whatsnew/3.10.rst:2046 +#: whatsnew/3.10.rst:2053 msgid "New Features" msgstr "" @@ -1549,8 +1549,8 @@ msgstr "" #: whatsnew/3.10.rst:1318 msgid "" "Add an ``end_lineno`` attribute to the ``Function`` and ``Class`` objects in " -"the tree returned by :func:`pyclbr.readline` and :func:`pyclbr." -"readline_ex`. It matches the existing (start) ``lineno``. (Contributed by " +"the tree returned by :func:`pyclbr.readmodule` and :func:`pyclbr." +"readmodule_ex`. It matches the existing (start) ``lineno``. (Contributed by " "Aviral Srivastava in :issue:`38307`.)" msgstr "" @@ -1844,22 +1844,32 @@ msgid "" "in :issue:`42967`.)" msgstr "" -#: whatsnew/3.10.rst:1521 +#: whatsnew/3.10.rst:1520 +msgid "" +"The presence of newline or tab characters in parts of a URL allows for some " +"forms of attacks. Following the WHATWG specification that updates :rfc:" +"`3986`, ASCII newline ``\\n``, ``\\r`` and tab ``\\t`` characters are " +"stripped from the URL by the parser in :mod:`urllib.parse` preventing such " +"attacks. The removal characters are controlled by a new module level " +"variable ``urllib.parse._UNSAFE_URL_BYTES_TO_REMOVE``. (See :gh:`88048`)" +msgstr "" + +#: whatsnew/3.10.rst:1528 msgid "xml" msgstr "" -#: whatsnew/3.10.rst:1523 +#: whatsnew/3.10.rst:1530 msgid "" "Add a :class:`~xml.sax.handler.LexicalHandler` class to the :mod:`xml.sax." "handler` module. (Contributed by Jonathan Gossage and Zackery Spytz in :" "issue:`35018`.)" msgstr "" -#: whatsnew/3.10.rst:1528 +#: whatsnew/3.10.rst:1535 msgid "zipimport" msgstr "" -#: whatsnew/3.10.rst:1529 +#: whatsnew/3.10.rst:1536 msgid "" "Add methods related to :pep:`451`: :meth:`~zipimport.zipimporter." "find_spec`, :meth:`zipimport.zipimporter.create_module`, and :meth:" @@ -1867,24 +1877,24 @@ msgid "" "`42131`.)" msgstr "" -#: whatsnew/3.10.rst:1534 +#: whatsnew/3.10.rst:1541 msgid "" "Add :meth:`~zipimport.zipimporter.invalidate_caches` method. (Contributed by " "Desmond Cheong in :issue:`14678`.)" msgstr "" -#: whatsnew/3.10.rst:1539 +#: whatsnew/3.10.rst:1546 msgid "Optimizations" msgstr "" -#: whatsnew/3.10.rst:1541 +#: whatsnew/3.10.rst:1548 msgid "" "Constructors :func:`str`, :func:`bytes` and :func:`bytearray` are now faster " "(around 30--40% for small objects). (Contributed by Serhiy Storchaka in :" "issue:`41334`.)" msgstr "" -#: whatsnew/3.10.rst:1545 +#: whatsnew/3.10.rst:1552 msgid "" "The :mod:`runpy` module now imports fewer modules. The ``python3 -m module-" "name`` command startup time is 1.4x faster in average. On Linux, ``python3 -" @@ -1893,7 +1903,7 @@ msgid "" "`41006` and :issue:`41718`.)" msgstr "" -#: whatsnew/3.10.rst:1551 +#: whatsnew/3.10.rst:1558 msgid "" "The ``LOAD_ATTR`` instruction now uses new \"per opcode cache\" mechanism. " "It is about 36% faster now for regular attributes and 44% faster for slots. " @@ -1902,7 +1912,7 @@ msgid "" "and MicroPython.)" msgstr "" -#: whatsnew/3.10.rst:1557 +#: whatsnew/3.10.rst:1564 msgid "" "When building Python with :option:`--enable-optimizations` now ``-fno-" "semantic-interposition`` is added to both the compile and link line. This " @@ -1913,7 +1923,7 @@ msgid "" "and Pablo Galindo in :issue:`38980`.)" msgstr "" -#: whatsnew/3.10.rst:1565 +#: whatsnew/3.10.rst:1572 msgid "" "Use a new output buffer management code for :mod:`bz2` / :mod:`lzma` / :mod:" "`zlib` modules, and add ``.readall()`` function to ``_compression." @@ -1923,7 +1933,7 @@ msgid "" "`41486`)" msgstr "" -#: whatsnew/3.10.rst:1571 +#: whatsnew/3.10.rst:1578 msgid "" "When using stringized annotations, annotations dicts for functions are no " "longer created when the function is created. Instead, they are stored as a " @@ -1933,7 +1943,7 @@ msgid "" "Inada Naoki in :issue:`42202`.)" msgstr "" -#: whatsnew/3.10.rst:1578 +#: whatsnew/3.10.rst:1585 msgid "" "Substring search functions such as ``str1 in str2`` and ``str2.find(str1)`` " "now sometimes use Crochemore & Perrin's \"Two-Way\" string searching " @@ -1941,7 +1951,7 @@ msgid "" "Dennis Sweeney in :issue:`41972`)" msgstr "" -#: whatsnew/3.10.rst:1583 +#: whatsnew/3.10.rst:1590 msgid "" "Add micro-optimizations to ``_PyType_Lookup()`` to improve type attribute " "cache lookup performance in the common case of cache hits. This makes the " @@ -1949,7 +1959,7 @@ msgid "" "issue:`43452`.)" msgstr "" -#: whatsnew/3.10.rst:1587 +#: whatsnew/3.10.rst:1594 msgid "" "The following built-in functions now support the faster :pep:`590` " "vectorcall calling convention: :func:`map`, :func:`filter`, :func:" @@ -1958,7 +1968,7 @@ msgid "" "`41873` and :issue:`41870`.)" msgstr "" -#: whatsnew/3.10.rst:1591 +#: whatsnew/3.10.rst:1598 msgid "" ":class:`BZ2File` performance is improved by removing internal ``RLock``. " "This makes :class:`BZ2File` thread unsafe in the face of multiple " @@ -1967,11 +1977,11 @@ msgid "" "issue:`43785`.)" msgstr "" -#: whatsnew/3.10.rst:2205 +#: whatsnew/3.10.rst:2212 msgid "Deprecated" msgstr "" -#: whatsnew/3.10.rst:1601 +#: whatsnew/3.10.rst:1608 msgid "" "Currently Python accepts numeric literals immediately followed by keywords, " "for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing and " @@ -1984,7 +1994,7 @@ msgid "" "by Serhiy Storchaka in :issue:`43833`.)" msgstr "" -#: whatsnew/3.10.rst:1612 +#: whatsnew/3.10.rst:1619 msgid "" "Starting in this release, there will be a concerted effort to begin cleaning " "up old import semantics that were kept for Python 2.7 compatibility. " @@ -2001,21 +2011,21 @@ msgid "" "transition." msgstr "" -#: whatsnew/3.10.rst:1629 +#: whatsnew/3.10.rst:1636 msgid "" "The entire ``distutils`` namespace is deprecated, to be removed in Python " "3.12. Refer to the :ref:`module changes ` section for " "more information." msgstr "" -#: whatsnew/3.10.rst:1633 +#: whatsnew/3.10.rst:1640 msgid "" "Non-integer arguments to :func:`random.randrange` are deprecated. The :exc:" "`ValueError` is deprecated in favor of a :exc:`TypeError`. (Contributed by " "Serhiy Storchaka and Raymond Hettinger in :issue:`37319`.)" msgstr "" -#: whatsnew/3.10.rst:1637 +#: whatsnew/3.10.rst:1644 msgid "" "The various ``load_module()`` methods of :mod:`importlib` have been " "documented as deprecated since Python 3.6, but will now also trigger a :exc:" @@ -2023,21 +2033,21 @@ msgid "" "(Contributed by Brett Cannon in :issue:`26131`.)" msgstr "" -#: whatsnew/3.10.rst:1643 +#: whatsnew/3.10.rst:1650 msgid "" ":meth:`zimport.zipimporter.load_module` has been deprecated in preference " "for :meth:`~zipimport.zipimporter.exec_module`. (Contributed by Brett Cannon " "in :issue:`26131`.)" msgstr "" -#: whatsnew/3.10.rst:1647 +#: whatsnew/3.10.rst:1654 msgid "" "The use of :meth:`~importlib.abc.Loader.load_module` by the import system " "now triggers an :exc:`ImportWarning` as :meth:`~importlib.abc.Loader." "exec_module` is preferred. (Contributed by Brett Cannon in :issue:`26131`.)" msgstr "" -#: whatsnew/3.10.rst:1652 +#: whatsnew/3.10.rst:1659 msgid "" "The use of :meth:`!importlib.abc.MetaPathFinder.find_module` and :meth:`!" "importlib.abc.PathEntryFinder.find_module` by the import system now trigger " @@ -2047,7 +2057,7 @@ msgid "" "porting. (Contributed by Brett Cannon in :issue:`42134`.)" msgstr "" -#: whatsnew/3.10.rst:1661 +#: whatsnew/3.10.rst:1668 msgid "" "The use of :meth:`!importlib.abc.PathEntryFinder.find_loader` by the import " "system now triggers an :exc:`ImportWarning` as :meth:`importlib.abc." @@ -2056,7 +2066,7 @@ msgid "" "`43672`.)" msgstr "" -#: whatsnew/3.10.rst:1667 +#: whatsnew/3.10.rst:1674 msgid "" "The various implementations of :meth:`!importlib.abc.MetaPathFinder." "find_module` ( :meth:`!importlib.machinery.BuiltinImporter.find_module`, :" @@ -2071,7 +2081,7 @@ msgid "" "Python 3.4). (Contributed by Brett Cannon in :issue:`42135`.)" msgstr "" -#: whatsnew/3.10.rst:1682 +#: whatsnew/3.10.rst:1689 msgid "" ":class:`!importlib.abc.Finder` is deprecated (including its sole method, :" "meth:`!find_module`). Both :class:`importlib.abc.MetaPathFinder` and :class:" @@ -2080,7 +2090,7 @@ msgid "" "(Contributed by Brett Cannon in :issue:`42135`.)" msgstr "" -#: whatsnew/3.10.rst:1689 +#: whatsnew/3.10.rst:1696 msgid "" "The deprecations of :mod:`!imp`, :func:`!importlib.find_loader`, :func:`!" "importlib.util.set_package_wrapper`, :func:`!importlib.util." @@ -2091,7 +2101,7 @@ msgid "" "Brett Cannon in :issue:`43720`.)" msgstr "" -#: whatsnew/3.10.rst:1699 +#: whatsnew/3.10.rst:1706 msgid "" "The import system now uses the ``__spec__`` attribute on modules before " "falling back on :meth:`!module_repr` for a module's ``__repr__()`` method. " @@ -2099,7 +2109,7 @@ msgid "" "(Contributed by Brett Cannon in :issue:`42137`.)" msgstr "" -#: whatsnew/3.10.rst:1705 +#: whatsnew/3.10.rst:1712 msgid "" ":meth:`!importlib.abc.Loader.module_repr`, :meth:`!importlib.machinery." "FrozenLoader.module_repr`, and :meth:`!importlib.machinery.BuiltinLoader." @@ -2107,7 +2117,7 @@ msgid "" "(Contributed by Brett Cannon in :issue:`42136`.)" msgstr "" -#: whatsnew/3.10.rst:1711 +#: whatsnew/3.10.rst:1718 msgid "" "``sqlite3.OptimizedUnicode`` has been undocumented and obsolete since Python " "3.3, when it was made an alias to :class:`str`. It is now deprecated, " @@ -2115,7 +2125,7 @@ msgid "" "issue:`42264`.)" msgstr "" -#: whatsnew/3.10.rst:1716 +#: whatsnew/3.10.rst:1723 msgid "" "The undocumented built-in function ``sqlite3.enable_shared_cache`` is now " "deprecated, scheduled for removal in Python 3.12. Its use is strongly " @@ -2125,67 +2135,67 @@ msgid "" "query parameter. (Contributed by Erlend E. Aasland in :issue:`24464`.)" msgstr "" -#: whatsnew/3.10.rst:1724 +#: whatsnew/3.10.rst:1731 msgid "The following ``threading`` methods are now deprecated:" msgstr "" -#: whatsnew/3.10.rst:1726 +#: whatsnew/3.10.rst:1733 msgid "``threading.currentThread`` => :func:`threading.current_thread`" msgstr "" -#: whatsnew/3.10.rst:1728 +#: whatsnew/3.10.rst:1735 msgid "``threading.activeCount`` => :func:`threading.active_count`" msgstr "" -#: whatsnew/3.10.rst:1730 +#: whatsnew/3.10.rst:1737 msgid "" "``threading.Condition.notifyAll`` => :meth:`threading.Condition.notify_all`" msgstr "" -#: whatsnew/3.10.rst:1733 +#: whatsnew/3.10.rst:1740 msgid "``threading.Event.isSet`` => :meth:`threading.Event.is_set`" msgstr "" -#: whatsnew/3.10.rst:1735 +#: whatsnew/3.10.rst:1742 msgid "``threading.Thread.setName`` => :attr:`threading.Thread.name`" msgstr "" -#: whatsnew/3.10.rst:1737 +#: whatsnew/3.10.rst:1744 msgid "``threading.thread.getName`` => :attr:`threading.Thread.name`" msgstr "" -#: whatsnew/3.10.rst:1739 +#: whatsnew/3.10.rst:1746 msgid "``threading.Thread.isDaemon`` => :attr:`threading.Thread.daemon`" msgstr "" -#: whatsnew/3.10.rst:1741 +#: whatsnew/3.10.rst:1748 msgid "``threading.Thread.setDaemon`` => :attr:`threading.Thread.daemon`" msgstr "" -#: whatsnew/3.10.rst:1743 +#: whatsnew/3.10.rst:1750 msgid "(Contributed by Jelle Zijlstra in :gh:`87889`.)" msgstr "" -#: whatsnew/3.10.rst:1745 +#: whatsnew/3.10.rst:1752 msgid "" ":meth:`!pathlib.Path.link_to` is deprecated and slated for removal in Python " "3.12. Use :meth:`pathlib.Path.hardlink_to` instead. (Contributed by Barney " "Gale in :issue:`39950`.)" msgstr "" -#: whatsnew/3.10.rst:1749 +#: whatsnew/3.10.rst:1756 msgid "" "``cgi.log()`` is deprecated and slated for removal in Python 3.12. " "(Contributed by Inada Naoki in :issue:`41139`.)" msgstr "" -#: whatsnew/3.10.rst:1752 +#: whatsnew/3.10.rst:1759 msgid "" "The following :mod:`ssl` features have been deprecated since Python 3.6, " "Python 3.7, or OpenSSL 1.1.0 and will be removed in 3.11:" msgstr "" -#: whatsnew/3.10.rst:1755 +#: whatsnew/3.10.rst:1762 msgid "" ":data:`~ssl.OP_NO_SSLv2`, :data:`~ssl.OP_NO_SSLv3`, :data:`~ssl." "OP_NO_TLSv1`, :data:`~ssl.OP_NO_TLSv1_1`, :data:`~ssl.OP_NO_TLSv1_2`, and :" @@ -2193,7 +2203,7 @@ msgid "" "minimum_version` and :attr:`sslSSLContext.maximum_version`." msgstr "" -#: whatsnew/3.10.rst:1761 +#: whatsnew/3.10.rst:1768 msgid "" ":data:`~ssl.PROTOCOL_SSLv2`, :data:`~ssl.PROTOCOL_SSLv3`, :data:`~ssl." "PROTOCOL_SSLv23`, :data:`~ssl.PROTOCOL_TLSv1`, :data:`~ssl." @@ -2202,26 +2212,26 @@ msgid "" "and :const:`~ssl.PROTOCOL_TLS_SERVER`" msgstr "" -#: whatsnew/3.10.rst:1767 +#: whatsnew/3.10.rst:1774 msgid "" ":func:`~ssl.wrap_socket` is replaced by :meth:`ssl.SSLContext.wrap_socket`" msgstr "" -#: whatsnew/3.10.rst:1769 +#: whatsnew/3.10.rst:1776 msgid ":func:`~ssl.match_hostname`" msgstr "" -#: whatsnew/3.10.rst:1771 +#: whatsnew/3.10.rst:1778 msgid ":func:`~ssl.RAND_pseudo_bytes`, :func:`~ssl.RAND_egd`" msgstr "" -#: whatsnew/3.10.rst:1773 +#: whatsnew/3.10.rst:1780 msgid "" "NPN features like :meth:`ssl.SSLSocket.selected_npn_protocol` and :meth:`ssl." "SSLContext.set_npn_protocols` are replaced by ALPN." msgstr "" -#: whatsnew/3.10.rst:1776 +#: whatsnew/3.10.rst:1783 msgid "" "The threading debug (:envvar:`!PYTHONTHREADDEBUG` environment variable) is " "deprecated in Python 3.10 and will be removed in Python 3.12. This feature " @@ -2229,7 +2239,7 @@ msgid "" "Victor Stinner in :issue:`44584`.)" msgstr "" -#: whatsnew/3.10.rst:1781 +#: whatsnew/3.10.rst:1788 msgid "" "Importing from the ``typing.io`` and ``typing.re`` submodules will now emit :" "exc:`DeprecationWarning`. These submodules will be removed in a future " @@ -2238,11 +2248,11 @@ msgid "" "Rittau in :issue:`38291`.)" msgstr "" -#: whatsnew/3.10.rst:2213 +#: whatsnew/3.10.rst:2220 msgid "Removed" msgstr "" -#: whatsnew/3.10.rst:1792 +#: whatsnew/3.10.rst:1799 msgid "" "Removed special methods ``__int__``, ``__float__``, ``__floordiv__``, " "``__mod__``, ``__divmod__``, ``__rfloordiv__``, ``__rmod__`` and " @@ -2250,7 +2260,7 @@ msgid "" "`TypeError`. (Contributed by Serhiy Storchaka in :issue:`41974`.)" msgstr "" -#: whatsnew/3.10.rst:1798 +#: whatsnew/3.10.rst:1805 msgid "" "The ``ParserBase.error()`` method from the private and undocumented " "``_markupbase`` module has been removed. :class:`html.parser.HTMLParser` is " @@ -2259,7 +2269,7 @@ msgid "" "`31844`.)" msgstr "" -#: whatsnew/3.10.rst:1804 +#: whatsnew/3.10.rst:1811 msgid "" "Removed the ``unicodedata.ucnhash_CAPI`` attribute which was an internal " "PyCapsule object. The related private ``_PyUnicode_Name_CAPI`` structure was " @@ -2267,7 +2277,7 @@ msgid "" "`42157`.)" msgstr "" -#: whatsnew/3.10.rst:1809 +#: whatsnew/3.10.rst:1816 msgid "" "Removed the ``parser`` module, which was deprecated in 3.9 due to the switch " "to the new PEG parser, as well as all the C source and header files that " @@ -2275,7 +2285,7 @@ msgid "" "``graminit.h`` and ``grammar.h``." msgstr "" -#: whatsnew/3.10.rst:1814 +#: whatsnew/3.10.rst:1821 msgid "" "Removed the Public C API functions ``PyParser_SimpleParseStringFlags``, " "``PyParser_SimpleParseStringFlagsFilename``, " @@ -2283,7 +2293,7 @@ msgid "" "deprecated in 3.9 due to the switch to the new PEG parser." msgstr "" -#: whatsnew/3.10.rst:1819 +#: whatsnew/3.10.rst:1826 msgid "" "Removed the ``formatter`` module, which was deprecated in Python 3.4. It is " "somewhat obsolete, little used, and not tested. It was originally scheduled " @@ -2292,71 +2302,71 @@ msgid "" "their code. (Contributed by Donghee Na and Terry J. Reedy in :issue:`42299`.)" msgstr "" -#: whatsnew/3.10.rst:1826 +#: whatsnew/3.10.rst:1833 msgid "" "Removed the :c:func:`!PyModule_GetWarningsModule` function that was useless " "now due to the :mod:`!_warnings` module was converted to a builtin module in " "2.6. (Contributed by Hai Shi in :issue:`42599`.)" msgstr "" -#: whatsnew/3.10.rst:1830 +#: whatsnew/3.10.rst:1837 msgid "" "Remove deprecated aliases to :ref:`collections-abstract-base-classes` from " "the :mod:`collections` module. (Contributed by Victor Stinner in :issue:" "`37324`.)" msgstr "" -#: whatsnew/3.10.rst:1834 +#: whatsnew/3.10.rst:1841 msgid "" "The ``loop`` parameter has been removed from most of :mod:`asyncio`\\ 's :" "doc:`high-level API <../library/asyncio-api-index>` following deprecation in " "Python 3.8. The motivation behind this change is multifold:" msgstr "" -#: whatsnew/3.10.rst:1838 +#: whatsnew/3.10.rst:1845 msgid "This simplifies the high-level API." msgstr "" -#: whatsnew/3.10.rst:1839 +#: whatsnew/3.10.rst:1846 msgid "" "The functions in the high-level API have been implicitly getting the current " "thread's running event loop since Python 3.7. There isn't a need to pass " "the event loop to the API in most normal use cases." msgstr "" -#: whatsnew/3.10.rst:1842 +#: whatsnew/3.10.rst:1849 msgid "" "Event loop passing is error-prone especially when dealing with loops running " "in different threads." msgstr "" -#: whatsnew/3.10.rst:1845 +#: whatsnew/3.10.rst:1852 msgid "" "Note that the low-level API will still accept ``loop``. See :ref:`changes-" "python-api` for examples of how to replace existing code." msgstr "" -#: whatsnew/3.10.rst:1920 +#: whatsnew/3.10.rst:1927 msgid "" "(Contributed by Yurii Karabas, Andrew Svetlov, Yury Selivanov and Kyle " "Stanley in :issue:`42392`.)" msgstr "" -#: whatsnew/3.10.rst:2140 +#: whatsnew/3.10.rst:2147 msgid "Porting to Python 3.10" msgstr "" -#: whatsnew/3.10.rst:1855 +#: whatsnew/3.10.rst:1862 msgid "" "This section lists previously described changes and other bugfixes that may " "require changes to your code." msgstr "" -#: whatsnew/3.10.rst:1860 +#: whatsnew/3.10.rst:1867 msgid "Changes in the Python syntax" msgstr "" -#: whatsnew/3.10.rst:1862 +#: whatsnew/3.10.rst:1869 msgid "" "Deprecation warning is now emitted when compiling previously valid syntax if " "the numeric literal is immediately followed by a keyword (like in ``0in " @@ -2366,11 +2376,11 @@ msgid "" "following keyword. (Contributed by Serhiy Storchaka in :issue:`43833`.)" msgstr "" -#: whatsnew/3.10.rst:1873 +#: whatsnew/3.10.rst:1880 msgid "Changes in the Python API" msgstr "" -#: whatsnew/3.10.rst:1875 +#: whatsnew/3.10.rst:1882 msgid "" "The *etype* parameters of the :func:`~traceback.format_exception`, :func:" "`~traceback.format_exception_only`, and :func:`~traceback.print_exception` " @@ -2378,7 +2388,7 @@ msgid "" "(Contributed by Zackery Spytz and Matthias Bussonnier in :issue:`26389`.)" msgstr "" -#: whatsnew/3.10.rst:1881 +#: whatsnew/3.10.rst:1888 msgid "" ":mod:`atexit`: At Python exit, if a callback registered with :func:`atexit." "register` fails, its exception is now logged. Previously, only some " @@ -2386,7 +2396,7 @@ msgid "" "(Contributed by Victor Stinner in :issue:`42639`.)" msgstr "" -#: whatsnew/3.10.rst:1887 +#: whatsnew/3.10.rst:1894 msgid "" ":class:`collections.abc.Callable` generic now flattens type parameters, " "similar to what :data:`typing.Callable` currently does. This means that " @@ -2399,7 +2409,7 @@ msgid "" "`42195`.)" msgstr "" -#: whatsnew/3.10.rst:1897 +#: whatsnew/3.10.rst:1904 msgid "" ":meth:`socket.htons` and :meth:`socket.ntohs` now raise :exc:`OverflowError` " "instead of :exc:`DeprecationWarning` if the given parameter will not fit in " @@ -2407,29 +2417,29 @@ msgid "" "`42393`.)" msgstr "" -#: whatsnew/3.10.rst:1902 +#: whatsnew/3.10.rst:1909 msgid "" "The ``loop`` parameter has been removed from most of :mod:`asyncio`\\ 's :" "doc:`high-level API <../library/asyncio-api-index>` following deprecation in " "Python 3.8." msgstr "" -#: whatsnew/3.10.rst:1906 +#: whatsnew/3.10.rst:1913 msgid "A coroutine that currently looks like this::" msgstr "" -#: whatsnew/3.10.rst:1911 +#: whatsnew/3.10.rst:1918 msgid "Should be replaced with this::" msgstr "" -#: whatsnew/3.10.rst:1916 +#: whatsnew/3.10.rst:1923 msgid "" "If ``foo()`` was specifically designed *not* to run in the current thread's " "running event loop (e.g. running in another thread's event loop), consider " "using :func:`asyncio.run_coroutine_threadsafe` instead." msgstr "" -#: whatsnew/3.10.rst:1923 +#: whatsnew/3.10.rst:1930 msgid "" "The :data:`types.FunctionType` constructor now inherits the current builtins " "if the *globals* dictionary has no ``\"__builtins__\"`` key, rather than " @@ -2440,11 +2450,11 @@ msgid "" "`42990`.)" msgstr "" -#: whatsnew/3.10.rst:1932 +#: whatsnew/3.10.rst:1939 msgid "Changes in the C API" msgstr "" -#: whatsnew/3.10.rst:1934 +#: whatsnew/3.10.rst:1941 msgid "" "The C API functions ``PyParser_SimpleParseStringFlags``, " "``PyParser_SimpleParseStringFlagsFilename``, " @@ -2453,31 +2463,31 @@ msgid "" "PEG parser." msgstr "" -#: whatsnew/3.10.rst:1940 +#: whatsnew/3.10.rst:1947 msgid "" "Source should be now be compiled directly to a code object using, for " "example, :c:func:`Py_CompileString`. The resulting code object can then be " "evaluated using, for example, :c:func:`PyEval_EvalCode`." msgstr "" -#: whatsnew/3.10.rst:1944 +#: whatsnew/3.10.rst:1951 msgid "Specifically:" msgstr "" -#: whatsnew/3.10.rst:1946 +#: whatsnew/3.10.rst:1953 msgid "" "A call to ``PyParser_SimpleParseStringFlags`` followed by ``PyNode_Compile`` " "can be replaced by calling :c:func:`Py_CompileString`." msgstr "" -#: whatsnew/3.10.rst:1949 +#: whatsnew/3.10.rst:1956 msgid "" "There is no direct replacement for ``PyParser_SimpleParseFileFlags``. To " "compile code from a ``FILE *`` argument, you will need to read the file in C " "and pass the resulting buffer to :c:func:`Py_CompileString`." msgstr "" -#: whatsnew/3.10.rst:1953 +#: whatsnew/3.10.rst:1960 msgid "" "To compile a file given a ``char *`` filename, explicitly open the file, " "read it and compile the result. One way to do this is using the :py:mod:`io` " @@ -2486,7 +2496,7 @@ msgid "" "(Declarations and error handling are omitted.) ::" msgstr "" -#: whatsnew/3.10.rst:1966 +#: whatsnew/3.10.rst:1973 msgid "" "For ``FrameObject`` objects, the :attr:`~frame.f_lasti` member now " "represents a wordcode offset instead of a simple offset into the bytecode " @@ -2497,53 +2507,53 @@ msgid "" "`PyFrame_GetLineNumber` instead." msgstr "" -#: whatsnew/3.10.rst:1974 +#: whatsnew/3.10.rst:1981 msgid "CPython bytecode changes" msgstr "" -#: whatsnew/3.10.rst:1976 +#: whatsnew/3.10.rst:1983 msgid "" "The ``MAKE_FUNCTION`` instruction now accepts either a dict or a tuple of " "strings as the function's annotations. (Contributed by Yurii Karabas and " "Inada Naoki in :issue:`42202`.)" msgstr "" -#: whatsnew/3.10.rst:1981 +#: whatsnew/3.10.rst:1988 msgid "Build Changes" msgstr "" -#: whatsnew/3.10.rst:1983 +#: whatsnew/3.10.rst:1990 msgid "" ":pep:`644`: Python now requires OpenSSL 1.1.1 or newer. OpenSSL 1.0.2 is no " "longer supported. (Contributed by Christian Heimes in :issue:`43669`.)" msgstr "" -#: whatsnew/3.10.rst:1987 +#: whatsnew/3.10.rst:1994 msgid "" "The C99 functions :c:func:`snprintf` and :c:func:`vsnprintf` are now " "required to build Python. (Contributed by Victor Stinner in :issue:`36020`.)" msgstr "" -#: whatsnew/3.10.rst:1991 +#: whatsnew/3.10.rst:1998 msgid "" ":mod:`sqlite3` requires SQLite 3.7.15 or higher. (Contributed by Sergey " "Fedoseev and Erlend E. Aasland in :issue:`40744` and :issue:`40810`.)" msgstr "" -#: whatsnew/3.10.rst:1994 +#: whatsnew/3.10.rst:2001 msgid "" "The :mod:`atexit` module must now always be built as a built-in module. " "(Contributed by Victor Stinner in :issue:`42639`.)" msgstr "" -#: whatsnew/3.10.rst:1997 +#: whatsnew/3.10.rst:2004 msgid "" "Add :option:`--disable-test-modules` option to the ``configure`` script: " "don't build nor install test modules. (Contributed by Xavier de Gaye, Thomas " "Petazzoni and Peixing Xin in :issue:`27640`.)" msgstr "" -#: whatsnew/3.10.rst:2001 +#: whatsnew/3.10.rst:2008 msgid "" "Add :option:`--with-wheel-pkg-dir=PATH option <--with-wheel-pkg-dir>` to the " "``./configure`` script. If specified, the :mod:`ensurepip` module looks for " @@ -2552,7 +2562,7 @@ msgid "" "packages." msgstr "" -#: whatsnew/3.10.rst:2007 +#: whatsnew/3.10.rst:2014 msgid "" "Some Linux distribution packaging policies recommend against bundling " "dependencies. For example, Fedora installs wheel packages in the ``/usr/" @@ -2560,22 +2570,22 @@ msgid "" "_bundled`` package." msgstr "" -#: whatsnew/3.10.rst:2012 +#: whatsnew/3.10.rst:2019 msgid "(Contributed by Victor Stinner in :issue:`42856`.)" msgstr "" -#: whatsnew/3.10.rst:2014 +#: whatsnew/3.10.rst:2021 msgid "" "Add a new :option:`configure --without-static-libpython option <--without-" "static-libpython>` to not build the ``libpythonMAJOR.MINOR.a`` static " "library and not install the ``python.o`` object file." msgstr "" -#: whatsnew/3.10.rst:2018 +#: whatsnew/3.10.rst:2025 msgid "(Contributed by Victor Stinner in :issue:`43103`.)" msgstr "" -#: whatsnew/3.10.rst:2020 +#: whatsnew/3.10.rst:2027 msgid "" "The ``configure`` script now uses the ``pkg-config`` utility, if available, " "to detect the location of Tcl/Tk headers and libraries. As before, those " @@ -2584,7 +2594,7 @@ msgid "" "Stamatogiannakis in :issue:`42603`.)" msgstr "" -#: whatsnew/3.10.rst:2026 +#: whatsnew/3.10.rst:2033 msgid "" "Add :option:`--with-openssl-rpath` option to ``configure`` script. The " "option simplifies building Python with a custom OpenSSL installation, e.g. " @@ -2592,15 +2602,15 @@ msgid "" "(Contributed by Christian Heimes in :issue:`43466`.)" msgstr "" -#: whatsnew/3.10.rst:2033 +#: whatsnew/3.10.rst:2040 msgid "C API Changes" msgstr "" -#: whatsnew/3.10.rst:2036 +#: whatsnew/3.10.rst:2043 msgid "PEP 652: Maintaining the Stable ABI" msgstr "" -#: whatsnew/3.10.rst:2038 +#: whatsnew/3.10.rst:2045 msgid "" "The Stable ABI (Application Binary Interface) for extension modules or " "embedding Python is now explicitly defined. :ref:`stable` describes C API " @@ -2608,25 +2618,25 @@ msgid "" "ABI." msgstr "" -#: whatsnew/3.10.rst:2043 +#: whatsnew/3.10.rst:2050 msgid "(Contributed by Petr Viktorin in :pep:`652` and :issue:`43795`.)" msgstr "" -#: whatsnew/3.10.rst:2048 +#: whatsnew/3.10.rst:2055 msgid "" "The result of :c:func:`PyNumber_Index` now always has exact type :class:" "`int`. Previously, the result could have been an instance of a subclass of " "``int``. (Contributed by Serhiy Storchaka in :issue:`40792`.)" msgstr "" -#: whatsnew/3.10.rst:2052 +#: whatsnew/3.10.rst:2059 msgid "" "Add a new :c:member:`~PyConfig.orig_argv` member to the :c:type:`PyConfig` " "structure: the list of the original command line arguments passed to the " "Python executable. (Contributed by Victor Stinner in :issue:`23427`.)" msgstr "" -#: whatsnew/3.10.rst:2057 +#: whatsnew/3.10.rst:2064 msgid "" "The :c:func:`PyDateTime_DATE_GET_TZINFO` and :c:func:" "`PyDateTime_TIME_GET_TZINFO` macros have been added for accessing the " @@ -2634,72 +2644,72 @@ msgid "" "time` objects. (Contributed by Zackery Spytz in :issue:`30155`.)" msgstr "" -#: whatsnew/3.10.rst:2063 +#: whatsnew/3.10.rst:2070 msgid "" "Add a :c:func:`PyCodec_Unregister` function to unregister a codec search " "function. (Contributed by Hai Shi in :issue:`41842`.)" msgstr "" -#: whatsnew/3.10.rst:2067 +#: whatsnew/3.10.rst:2074 msgid "" "The :c:func:`PyIter_Send` function was added to allow sending value into " "iterator without raising ``StopIteration`` exception. (Contributed by " "Vladimir Matveev in :issue:`41756`.)" msgstr "" -#: whatsnew/3.10.rst:2071 +#: whatsnew/3.10.rst:2078 msgid "" "Add :c:func:`PyUnicode_AsUTF8AndSize` to the limited C API. (Contributed by " "Alex Gaynor in :issue:`41784`.)" msgstr "" -#: whatsnew/3.10.rst:2074 +#: whatsnew/3.10.rst:2081 msgid "" "Add :c:func:`PyModule_AddObjectRef` function: similar to :c:func:" "`PyModule_AddObject` but don't steal a reference to the value on success. " "(Contributed by Victor Stinner in :issue:`1635741`.)" msgstr "" -#: whatsnew/3.10.rst:2079 +#: whatsnew/3.10.rst:2086 msgid "" "Add :c:func:`Py_NewRef` and :c:func:`Py_XNewRef` functions to increment the " "reference count of an object and return the object. (Contributed by Victor " "Stinner in :issue:`42262`.)" msgstr "" -#: whatsnew/3.10.rst:2083 +#: whatsnew/3.10.rst:2090 msgid "" "The :c:func:`PyType_FromSpecWithBases` and :c:func:" "`PyType_FromModuleAndSpec` functions now accept a single class as the " "*bases* argument. (Contributed by Serhiy Storchaka in :issue:`42423`.)" msgstr "" -#: whatsnew/3.10.rst:2087 +#: whatsnew/3.10.rst:2094 msgid "" "The :c:func:`PyType_FromModuleAndSpec` function now accepts NULL ``tp_doc`` " "slot. (Contributed by Hai Shi in :issue:`41832`.)" msgstr "" -#: whatsnew/3.10.rst:2091 +#: whatsnew/3.10.rst:2098 msgid "" "The :c:func:`PyType_GetSlot` function can accept :ref:`static types `. (Contributed by Hai Shi and Petr Viktorin in :issue:`41073`.)" msgstr "" -#: whatsnew/3.10.rst:2095 +#: whatsnew/3.10.rst:2102 msgid "" "Add a new :c:func:`PySet_CheckExact` function to the C-API to check if an " "object is an instance of :class:`set` but not an instance of a subtype. " "(Contributed by Pablo Galindo in :issue:`43277`.)" msgstr "" -#: whatsnew/3.10.rst:2099 +#: whatsnew/3.10.rst:2106 msgid "" "Add :c:func:`PyErr_SetInterruptEx` which allows passing a signal number to " "simulate. (Contributed by Antoine Pitrou in :issue:`43356`.)" msgstr "" -#: whatsnew/3.10.rst:2103 +#: whatsnew/3.10.rst:2110 msgid "" "The limited C API is now supported if :ref:`Python is built in debug mode " "` (if the ``Py_DEBUG`` macro is defined). In the limited C API, " @@ -2712,14 +2722,14 @@ msgid "" "`36465`)." msgstr "" -#: whatsnew/3.10.rst:2113 +#: whatsnew/3.10.rst:2120 msgid "" "The limited C API is still not supported in the :option:`--with-trace-refs` " "special build (``Py_TRACE_REFS`` macro). (Contributed by Victor Stinner in :" "issue:`43688`.)" msgstr "" -#: whatsnew/3.10.rst:2117 +#: whatsnew/3.10.rst:2124 msgid "" "Add the :c:func:`Py_Is(x, y) ` function to test if the *x* object is " "the *y* object, the same as ``x is y`` in Python. Add also the :c:func:" @@ -2729,7 +2739,7 @@ msgid "" "`43753`.)" msgstr "" -#: whatsnew/3.10.rst:2124 +#: whatsnew/3.10.rst:2131 msgid "" "Add new functions to control the garbage collector from C code: :c:func:" "`PyGC_Enable()`, :c:func:`PyGC_Disable()`, :c:func:`PyGC_IsEnabled()`. These " @@ -2737,20 +2747,20 @@ msgid "" "collector from C code without having to import the :mod:`gc` module." msgstr "" -#: whatsnew/3.10.rst:2131 +#: whatsnew/3.10.rst:2138 msgid "" "Add a new :c:macro:`Py_TPFLAGS_DISALLOW_INSTANTIATION` type flag to disallow " "creating type instances. (Contributed by Victor Stinner in :issue:`43916`.)" msgstr "" -#: whatsnew/3.10.rst:2135 +#: whatsnew/3.10.rst:2142 msgid "" "Add a new :c:macro:`Py_TPFLAGS_IMMUTABLETYPE` type flag for creating " "immutable type objects: type attributes cannot be set nor deleted. " "(Contributed by Victor Stinner and Erlend E. Aasland in :issue:`43908`.)" msgstr "" -#: whatsnew/3.10.rst:2142 +#: whatsnew/3.10.rst:2149 msgid "" "The ``PY_SSIZE_T_CLEAN`` macro must now be defined to use :c:func:" "`PyArg_ParseTuple` and :c:func:`Py_BuildValue` formats which use ``#``: " @@ -2759,7 +2769,7 @@ msgid "" "`40943`.)" msgstr "" -#: whatsnew/3.10.rst:2148 +#: whatsnew/3.10.rst:2155 msgid "" "Since :c:func:`Py_REFCNT()` is changed to the inline static function, " "``Py_REFCNT(obj) = new_refcnt`` must be replaced with ``Py_SET_REFCNT(obj, " @@ -2767,18 +2777,18 @@ msgid "" "For backward compatibility, this macro can be used::" msgstr "" -#: whatsnew/3.10.rst:2157 +#: whatsnew/3.10.rst:2164 msgid "(Contributed by Victor Stinner in :issue:`39573`.)" msgstr "" -#: whatsnew/3.10.rst:2159 +#: whatsnew/3.10.rst:2166 msgid "" "Calling :c:func:`PyDict_GetItem` without :term:`GIL` held had been allowed " "for historical reason. It is no longer allowed. (Contributed by Victor " "Stinner in :issue:`40839`.)" msgstr "" -#: whatsnew/3.10.rst:2163 +#: whatsnew/3.10.rst:2170 msgid "" "``PyUnicode_FromUnicode(NULL, size)`` and " "``PyUnicode_FromStringAndSize(NULL, size)`` raise ``DeprecationWarning`` " @@ -2786,14 +2796,14 @@ msgid "" "data. (Contributed by Inada Naoki in :issue:`36346`.)" msgstr "" -#: whatsnew/3.10.rst:2168 +#: whatsnew/3.10.rst:2175 msgid "" "The private ``_PyUnicode_Name_CAPI`` structure of the PyCapsule API " "``unicodedata.ucnhash_CAPI`` has been moved to the internal C API. " "(Contributed by Victor Stinner in :issue:`42157`.)" msgstr "" -#: whatsnew/3.10.rst:2172 +#: whatsnew/3.10.rst:2179 msgid "" ":c:func:`Py_GetPath`, :c:func:`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`, :c:" "func:`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome` and :c:func:" @@ -2803,7 +2813,7 @@ msgid "" "Stinner in :issue:`42260`.)" msgstr "" -#: whatsnew/3.10.rst:2179 +#: whatsnew/3.10.rst:2186 msgid "" ":c:func:`PyList_SET_ITEM`, :c:func:`PyTuple_SET_ITEM` and :c:func:" "`PyCell_SET` macros can no longer be used as l-value or r-value. For " @@ -2813,7 +2823,7 @@ msgid "" "and Victor Stinner in :issue:`30459`.)" msgstr "" -#: whatsnew/3.10.rst:2186 +#: whatsnew/3.10.rst:2193 msgid "" "The non-limited API files ``odictobject.h``, ``parser_interface.h``, " "``picklebufobject.h``, ``pyarena.h``, ``pyctype.h``, ``pydebug.h``, ``pyfpe." @@ -2824,7 +2834,7 @@ msgid "" "issue:`35134`.)" msgstr "" -#: whatsnew/3.10.rst:2194 +#: whatsnew/3.10.rst:2201 msgid "" "Use the :c:macro:`Py_TPFLAGS_IMMUTABLETYPE` type flag to create immutable " "type objects. Do not rely on :c:macro:`Py_TPFLAGS_HEAPTYPE` to decide if a " @@ -2833,85 +2843,85 @@ msgid "" "issue:`43908`.)" msgstr "" -#: whatsnew/3.10.rst:2200 +#: whatsnew/3.10.rst:2207 msgid "" "The undocumented function ``Py_FrozenMain`` has been removed from the " "limited API. The function is mainly useful for custom builds of Python. " "(Contributed by Petr Viktorin in :issue:`26241`.)" msgstr "" -#: whatsnew/3.10.rst:2207 +#: whatsnew/3.10.rst:2214 msgid "" "The ``PyUnicode_InternImmortal()`` function is now deprecated and will be " "removed in Python 3.12: use :c:func:`PyUnicode_InternInPlace` instead. " "(Contributed by Victor Stinner in :issue:`41692`.)" msgstr "" -#: whatsnew/3.10.rst:2215 +#: whatsnew/3.10.rst:2222 msgid "" "Removed ``Py_UNICODE_str*`` functions manipulating ``Py_UNICODE*`` strings. " "(Contributed by Inada Naoki in :issue:`41123`.)" msgstr "" -#: whatsnew/3.10.rst:2218 +#: whatsnew/3.10.rst:2225 msgid "" "``Py_UNICODE_strlen``: use :c:func:`PyUnicode_GetLength` or :c:macro:" "`PyUnicode_GET_LENGTH`" msgstr "" -#: whatsnew/3.10.rst:2220 +#: whatsnew/3.10.rst:2227 msgid "" "``Py_UNICODE_strcat``: use :c:func:`PyUnicode_CopyCharacters` or :c:func:" "`PyUnicode_FromFormat`" msgstr "" -#: whatsnew/3.10.rst:2222 +#: whatsnew/3.10.rst:2229 msgid "" "``Py_UNICODE_strcpy``, ``Py_UNICODE_strncpy``: use :c:func:" "`PyUnicode_CopyCharacters` or :c:func:`PyUnicode_Substring`" msgstr "" -#: whatsnew/3.10.rst:2224 +#: whatsnew/3.10.rst:2231 msgid "``Py_UNICODE_strcmp``: use :c:func:`PyUnicode_Compare`" msgstr "" -#: whatsnew/3.10.rst:2225 +#: whatsnew/3.10.rst:2232 msgid "``Py_UNICODE_strncmp``: use :c:func:`PyUnicode_Tailmatch`" msgstr "" -#: whatsnew/3.10.rst:2226 +#: whatsnew/3.10.rst:2233 msgid "" "``Py_UNICODE_strchr``, ``Py_UNICODE_strrchr``: use :c:func:" "`PyUnicode_FindChar`" msgstr "" -#: whatsnew/3.10.rst:2229 +#: whatsnew/3.10.rst:2236 msgid "" "Removed ``PyUnicode_GetMax()``. Please migrate to new (:pep:`393`) APIs. " "(Contributed by Inada Naoki in :issue:`41103`.)" msgstr "" -#: whatsnew/3.10.rst:2232 +#: whatsnew/3.10.rst:2239 msgid "" "Removed ``PyLong_FromUnicode()``. Please migrate to :c:func:" "`PyLong_FromUnicodeObject`. (Contributed by Inada Naoki in :issue:`41103`.)" msgstr "" -#: whatsnew/3.10.rst:2235 +#: whatsnew/3.10.rst:2242 msgid "" "Removed ``PyUnicode_AsUnicodeCopy()``. Please use :c:func:" "`PyUnicode_AsUCS4Copy` or :c:func:`PyUnicode_AsWideCharString` (Contributed " "by Inada Naoki in :issue:`41103`.)" msgstr "" -#: whatsnew/3.10.rst:2239 +#: whatsnew/3.10.rst:2246 msgid "" "Removed ``_Py_CheckRecursionLimit`` variable: it has been replaced by " "``ceval.recursion_limit`` of the :c:type:`PyInterpreterState` structure. " "(Contributed by Victor Stinner in :issue:`41834`.)" msgstr "" -#: whatsnew/3.10.rst:2243 +#: whatsnew/3.10.rst:2250 msgid "" "Removed undocumented macros ``Py_ALLOW_RECURSION`` and " "``Py_END_ALLOW_RECURSION`` and the ``recursion_critical`` field of the :c:" @@ -2919,14 +2929,14 @@ msgid "" "issue:`41936`.)" msgstr "" -#: whatsnew/3.10.rst:2248 +#: whatsnew/3.10.rst:2255 msgid "" "Removed the undocumented ``PyOS_InitInterrupts()`` function. Initializing " "Python already implicitly installs signal handlers: see :c:member:`PyConfig." "install_signal_handlers`. (Contributed by Victor Stinner in :issue:`41713`.)" msgstr "" -#: whatsnew/3.10.rst:2253 +#: whatsnew/3.10.rst:2260 msgid "" "Remove the ``PyAST_Validate()`` function. It is no longer possible to build " "a AST object (``mod_ty`` type) with the public C API. The function was " @@ -2934,48 +2944,48 @@ msgid "" "Stinner in :issue:`43244`.)" msgstr "" -#: whatsnew/3.10.rst:2258 +#: whatsnew/3.10.rst:2265 msgid "Remove the ``symtable.h`` header file and the undocumented functions:" msgstr "" -#: whatsnew/3.10.rst:2260 +#: whatsnew/3.10.rst:2267 msgid "``PyST_GetScope()``" msgstr "" -#: whatsnew/3.10.rst:2261 +#: whatsnew/3.10.rst:2268 msgid "``PySymtable_Build()``" msgstr "" -#: whatsnew/3.10.rst:2262 +#: whatsnew/3.10.rst:2269 msgid "``PySymtable_BuildObject()``" msgstr "" -#: whatsnew/3.10.rst:2263 +#: whatsnew/3.10.rst:2270 msgid "``PySymtable_Free()``" msgstr "" -#: whatsnew/3.10.rst:2264 +#: whatsnew/3.10.rst:2271 msgid "``Py_SymtableString()``" msgstr "" -#: whatsnew/3.10.rst:2265 +#: whatsnew/3.10.rst:2272 msgid "``Py_SymtableStringObject()``" msgstr "" -#: whatsnew/3.10.rst:2267 +#: whatsnew/3.10.rst:2274 msgid "" "The ``Py_SymtableString()`` function was part the stable ABI by mistake but " "it could not be used, because the ``symtable.h`` header file was excluded " "from the limited C API." msgstr "" -#: whatsnew/3.10.rst:2271 +#: whatsnew/3.10.rst:2278 msgid "" "Use Python :mod:`symtable` module instead. (Contributed by Victor Stinner " "in :issue:`43244`.)" msgstr "" -#: whatsnew/3.10.rst:2274 +#: whatsnew/3.10.rst:2281 msgid "" "Remove :c:func:`PyOS_ReadlineFunctionPointer` from the limited C API headers " "and from ``python3.dll``, the library that provides the stable ABI on " @@ -2983,7 +2993,7 @@ msgid "" "cannot be guaranteed. (Contributed by Petr Viktorin in :issue:`43868`.)" msgstr "" -#: whatsnew/3.10.rst:2280 +#: whatsnew/3.10.rst:2287 msgid "" "Remove ``ast.h``, ``asdl.h``, and ``Python-ast.h`` header files. These " "functions were undocumented and excluded from the limited C API. Most names " @@ -2994,87 +3004,137 @@ msgid "" "(Contributed by Victor Stinner in :issue:`43244`.)" msgstr "" -#: whatsnew/3.10.rst:2288 +#: whatsnew/3.10.rst:2295 msgid "" "Remove the compiler and parser functions using ``struct _mod`` type, because " "the public AST C API was removed:" msgstr "" -#: whatsnew/3.10.rst:2291 +#: whatsnew/3.10.rst:2298 msgid "``PyAST_Compile()``" msgstr "" -#: whatsnew/3.10.rst:2292 +#: whatsnew/3.10.rst:2299 msgid "``PyAST_CompileEx()``" msgstr "" -#: whatsnew/3.10.rst:2293 +#: whatsnew/3.10.rst:2300 msgid "``PyAST_CompileObject()``" msgstr "" -#: whatsnew/3.10.rst:2294 +#: whatsnew/3.10.rst:2301 msgid "``PyFuture_FromAST()``" msgstr "" -#: whatsnew/3.10.rst:2295 +#: whatsnew/3.10.rst:2302 msgid "``PyFuture_FromASTObject()``" msgstr "" -#: whatsnew/3.10.rst:2296 +#: whatsnew/3.10.rst:2303 msgid "``PyParser_ASTFromFile()``" msgstr "" -#: whatsnew/3.10.rst:2297 +#: whatsnew/3.10.rst:2304 msgid "``PyParser_ASTFromFileObject()``" msgstr "" -#: whatsnew/3.10.rst:2298 +#: whatsnew/3.10.rst:2305 msgid "``PyParser_ASTFromFilename()``" msgstr "" -#: whatsnew/3.10.rst:2299 +#: whatsnew/3.10.rst:2306 msgid "``PyParser_ASTFromString()``" msgstr "" -#: whatsnew/3.10.rst:2300 +#: whatsnew/3.10.rst:2307 msgid "``PyParser_ASTFromStringObject()``" msgstr "" -#: whatsnew/3.10.rst:2302 +#: whatsnew/3.10.rst:2309 msgid "" "These functions were undocumented and excluded from the limited C API. " "(Contributed by Victor Stinner in :issue:`43244`.)" msgstr "" -#: whatsnew/3.10.rst:2305 +#: whatsnew/3.10.rst:2312 msgid "Remove the ``pyarena.h`` header file with functions:" msgstr "" -#: whatsnew/3.10.rst:2307 +#: whatsnew/3.10.rst:2314 msgid "``PyArena_New()``" msgstr "" -#: whatsnew/3.10.rst:2308 +#: whatsnew/3.10.rst:2315 msgid "``PyArena_Free()``" msgstr "" -#: whatsnew/3.10.rst:2309 +#: whatsnew/3.10.rst:2316 msgid "``PyArena_Malloc()``" msgstr "" -#: whatsnew/3.10.rst:2310 +#: whatsnew/3.10.rst:2317 msgid "``PyArena_AddPyObject()``" msgstr "" -#: whatsnew/3.10.rst:2312 +#: whatsnew/3.10.rst:2319 msgid "" "These functions were undocumented, excluded from the limited C API, and were " "only used internally by the compiler. (Contributed by Victor Stinner in :" "issue:`43244`.)" msgstr "" -#: whatsnew/3.10.rst:2316 +#: whatsnew/3.10.rst:2323 msgid "" "The ``PyThreadState.use_tracing`` member has been removed to optimize " "Python. (Contributed by Mark Shannon in :issue:`43760`.)" msgstr "" + +#: whatsnew/3.10.rst:2328 +msgid "Notable security feature in 3.10.7" +msgstr "" + +#: whatsnew/3.10.rst:2330 +msgid "" +"Converting between :class:`int` and :class:`str` in bases other than 2 " +"(binary), 4, 8 (octal), 16 (hexadecimal), or 32 such as base 10 (decimal) " +"now raises a :exc:`ValueError` if the number of digits in string form is " +"above a limit to avoid potential denial of service attacks due to the " +"algorithmic complexity. This is a mitigation for `CVE-2020-10735 `_. This limit can be " +"configured or disabled by environment variable, command line flag, or :mod:" +"`sys` APIs. See the :ref:`integer string conversion length limitation " +"` documentation. The default limit is 4300 digits in " +"string form." +msgstr "" + +#: whatsnew/3.10.rst:2342 +msgid "Notable security feature in 3.10.8" +msgstr "" + +#: whatsnew/3.10.rst:2344 +msgid "" +"The deprecated :mod:`!mailcap` module now refuses to inject unsafe text " +"(filenames, MIME types, parameters) into shell commands. Instead of using " +"such text, it will warn and act as if a match was not found (or for test " +"commands, as if the test failed). (Contributed by Petr Viktorin in :gh:" +"`98966`.)" +msgstr "" + +#: whatsnew/3.10.rst:2351 +msgid "Notable changes in 3.10.12" +msgstr "" + +#: whatsnew/3.10.rst:2354 +msgid "tarfile" +msgstr "" + +#: whatsnew/3.10.rst:2356 +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 " +"surprising or dangerous, such as creating files outside the destination " +"directory. See :ref:`tarfile-extraction-filter` for details. In Python 3.12, " +"use without the *filter* argument will show a :exc:`DeprecationWarning`. In " +"Python 3.14, the default will switch to ``'data'``. (Contributed by Petr " +"Viktorin in :pep:`706`.)" +msgstr "" diff --git a/whatsnew/3.11.po b/whatsnew/3.11.po index b44d67b47..3a689ebaf 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-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -758,9 +758,9 @@ msgstr "" msgid "" "Changed :meth:`Enum.__format__() ` (the default for :" "func:`format`, :meth:`str.format` and :term:`f-string`\\s) to always produce " -"the same result as :meth:`Enum.__str__()`: for enums inheriting from :class:" -"`~enum.ReprEnum` it will be the member's value; for all other enums it will " -"be the enum and member name (e.g. ``Color.RED``)." +"the same result as :meth:`Enum.__str__() `: for enums " +"inheriting from :class:`~enum.ReprEnum` it will be the member's value; for " +"all other enums it will be the enum and member name (e.g. ``Color.RED``)." msgstr "" #: whatsnew/3.11.rst:679 @@ -2104,7 +2104,7 @@ msgstr "" #: whatsnew/3.11.rst:1607 msgid "" -":opcode:`ASYNC_GEN_WRAP`, :opcode:`RETURN_GENERATOR` and :opcode:`SEND`, " +":opcode:`!ASYNC_GEN_WRAP`, :opcode:`RETURN_GENERATOR` and :opcode:`SEND`, " "used in generators and co-routines." msgstr "" @@ -2126,7 +2126,7 @@ msgstr "" #: whatsnew/3.11.rst:1618 msgid "" -":opcode:`CHECK_EG_MATCH` and :opcode:`PREP_RERAISE_STAR`, to handle the :" +":opcode:`CHECK_EG_MATCH` and :opcode:`!PREP_RERAISE_STAR`, to handle the :" "ref:`new exception groups and except* ` added in :pep:" "`654`." msgstr "" @@ -2190,11 +2190,11 @@ msgid ":opcode:`CALL`" msgstr "" #: whatsnew/3.11.rst:0 -msgid ":opcode:`KW_NAMES`" +msgid ":opcode:`!KW_NAMES`" msgstr "" #: whatsnew/3.11.rst:0 -msgid ":opcode:`PRECALL`" +msgid ":opcode:`!PRECALL`" msgstr "" #: whatsnew/3.11.rst:0 @@ -2272,11 +2272,11 @@ msgid ":opcode:`JUMP_BACKWARD`" msgstr "" #: whatsnew/3.11.rst:0 -msgid ":opcode:`POP_JUMP_BACKWARD_IF_* `" +msgid ":opcode:`!POP_JUMP_BACKWARD_IF_*`" msgstr "" #: whatsnew/3.11.rst:0 -msgid ":opcode:`POP_JUMP_FORWARD_IF_* `" +msgid ":opcode:`!POP_JUMP_FORWARD_IF_*`" msgstr "" #: whatsnew/3.11.rst:1653 @@ -2303,8 +2303,8 @@ msgstr "" #: whatsnew/3.11.rst:1663 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 " +"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 "" @@ -3014,8 +3014,8 @@ msgstr "" #: whatsnew/3.11.rst:1970 msgid "" -"Removed the :mod:`distutils` ``bdist_msi`` command deprecated in Python 3.9. " -"Use ``bdist_wheel`` (wheel packages) instead. (Contributed by Hugo van " +"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 "" @@ -3505,7 +3505,7 @@ msgstr "" #: whatsnew/3.11.rst:2298 msgid "" -":c:func:`PyCode_New` and :c:func:`PyCode_NewWithPosOnlyArgs` now take an " +":c:func:`!PyCode_New` and :c:func:`!PyCode_NewWithPosOnlyArgs` now take an " "additional ``exception_table`` argument. Using these functions should be " "avoided, if at all possible. To get a custom code object: create a code " "object using the compiler, then get a modified version with the ``replace`` " @@ -3608,7 +3608,7 @@ msgstr "" #: whatsnew/3.11.rst:2405 msgid "" -"The :c:func:`PyUnicode_CHECK_INTERNED` macro has been excluded from the " +"The :c:func:`!PyUnicode_CHECK_INTERNED` macro has been excluded from the " "limited C API. It was never usable there, because it used internal " "structures which are not available in the limited C API. (Contributed by " "Victor Stinner in :issue:`46007`.)" @@ -3767,8 +3767,8 @@ msgstr "" #: whatsnew/3.11.rst:2466 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:" -"`PyFrame_FastToLocalsWithError` or :c:func:`PyFrame_LocalsToFast`, in fact " +"func:`PyFrame_GetLocals` instead. They no longer need to call :c:func:`!" +"PyFrame_FastToLocalsWithError` or :c:func:`!PyFrame_LocalsToFast`, in fact " "they should not call those functions. The necessary updating of the frame is " "now managed by the virtual machine." msgstr "" @@ -3959,11 +3959,11 @@ msgid ":c:func:`!PyUnicode_GetSize`" msgstr "" #: whatsnew/3.11.rst:2607 -msgid ":c:func:`PyUnicode_IS_COMPACT`" +msgid ":c:func:`!PyUnicode_IS_COMPACT`" msgstr "" #: whatsnew/3.11.rst:2608 -msgid ":c:func:`PyUnicode_IS_READY`" +msgid ":c:func:`!PyUnicode_IS_READY`" msgstr "" #: whatsnew/3.11.rst:2609 @@ -4083,7 +4083,7 @@ msgstr "" #: whatsnew/3.11.rst:2662 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 " +"worked since the :c:type:`!PyWeakReference` structure is opaque in the " "limited C API. (Contributed by Victor Stinner in :issue:`35134`.)" msgstr "" @@ -4169,3 +4169,35 @@ 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:2705 +msgid "Notable changes in 3.11.4" +msgstr "" + +#: whatsnew/3.11.rst:2708 +msgid "tarfile" +msgstr "" + +#: whatsnew/3.11.rst:2710 +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 " +"surprising or dangerous, such as creating files outside the destination " +"directory. See :ref:`tarfile-extraction-filter` for details. In Python 3.12, " +"use without the *filter* argument will show a :exc:`DeprecationWarning`. In " +"Python 3.14, the default will switch to ``'data'``. (Contributed by Petr " +"Viktorin in :pep:`706`.)" +msgstr "" + +#: whatsnew/3.11.rst:2722 +msgid "Notable changes in 3.11.5" +msgstr "" + +#: whatsnew/3.11.rst:2725 +msgid "OpenSSL" +msgstr "" + +#: whatsnew/3.11.rst:2727 +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 07723dbe4..c7179dd8a 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-01-04 03:14+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+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:1954 +#: whatsnew/3.12.rst:1966 msgid "New Features" msgstr "" @@ -1118,7 +1118,7 @@ msgid "" "Windows. (Contributed by Charles Machalow in :gh:`103179`.)" msgstr "" -#: whatsnew/3.12.rst:1657 +#: whatsnew/3.12.rst:1669 msgid "sqlite3" msgstr "" @@ -1191,7 +1191,7 @@ msgid "" "Katriel in :gh:`102778`.)" msgstr "" -#: whatsnew/3.12.rst:1853 +#: whatsnew/3.12.rst:1865 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 " @@ -1336,7 +1336,7 @@ msgid "" "Benjamin Peterson in :gh:`96734`)." msgstr "" -#: whatsnew/3.12.rst:1698 +#: whatsnew/3.12.rst:1710 msgid "unittest" msgstr "" @@ -1512,7 +1512,7 @@ msgid "" "demos>`_. (Contributed by Victor Stinner in :gh:`97669`.)" msgstr "" -#: whatsnew/3.12.rst:2256 +#: whatsnew/3.12.rst:2268 msgid "Deprecated" msgstr "" @@ -1531,23 +1531,23 @@ msgid "" "Python 3.14:" msgstr "" -#: whatsnew/3.12.rst:1389 +#: whatsnew/3.12.rst:1401 msgid ":class:`!ast.Num`" msgstr "" -#: whatsnew/3.12.rst:1390 +#: whatsnew/3.12.rst:1402 msgid ":class:`!ast.Str`" msgstr "" -#: whatsnew/3.12.rst:1391 +#: whatsnew/3.12.rst:1403 msgid ":class:`!ast.Bytes`" msgstr "" -#: whatsnew/3.12.rst:1392 +#: whatsnew/3.12.rst:1404 msgid ":class:`!ast.NameConstant`" msgstr "" -#: whatsnew/3.12.rst:1393 +#: whatsnew/3.12.rst:1405 msgid ":class:`!ast.Ellipsis`" msgstr "" @@ -1557,7 +1557,7 @@ msgid "" "`90953`.)" msgstr "" -#: whatsnew/3.12.rst:1395 +#: whatsnew/3.12.rst:1407 msgid ":mod:`asyncio`:" msgstr "" @@ -1622,15 +1622,15 @@ msgid "" "removal in Python 3.14:" msgstr "" -#: whatsnew/3.12.rst:1412 +#: whatsnew/3.12.rst:1424 msgid ":class:`!importlib.abc.ResourceReader`" msgstr "" -#: whatsnew/3.12.rst:1413 +#: whatsnew/3.12.rst:1425 msgid ":class:`!importlib.abc.Traversable`" msgstr "" -#: whatsnew/3.12.rst:1414 +#: whatsnew/3.12.rst:1426 msgid ":class:`!importlib.abc.TraversableResources`" msgstr "" @@ -1925,7 +1925,7 @@ msgstr "" msgid ":mod:`!lib2to3`, and the :program:`2to3` program (:gh:`84540`)" msgstr "" -#: whatsnew/3.12.rst:1444 +#: whatsnew/3.12.rst:1456 msgid "APIs:" msgstr "" @@ -1965,151 +1965,190 @@ msgstr "" msgid ":class:`classmethod` descriptor chaining (:gh:`89519`)" msgstr "" -#: whatsnew/3.12.rst:2343 -msgid "Pending Removal in Python 3.14" +#: whatsnew/3.12.rst:1377 +msgid ":mod:`importlib.resources` deprecated methods:" +msgstr "" + +#: whatsnew/3.12.rst:1379 +msgid "``contents()``" +msgstr "" + +#: whatsnew/3.12.rst:1380 +msgid "``is_resource()``" msgstr "" #: whatsnew/3.12.rst:1381 +msgid "``open_binary()``" +msgstr "" + +#: whatsnew/3.12.rst:1382 +msgid "``open_text()``" +msgstr "" + +#: whatsnew/3.12.rst:1383 +msgid "``path()``" +msgstr "" + +#: whatsnew/3.12.rst:1384 +msgid "``read_binary()``" +msgstr "" + +#: whatsnew/3.12.rst:1385 +msgid "``read_text()``" +msgstr "" + +#: whatsnew/3.12.rst:1387 +msgid "" +"Use :func:`importlib.resources.files()` instead. Refer to `importlib-" +"resources: Migrating from Legacy `_ (:gh:`106531`)" +msgstr "" + +#: whatsnew/3.12.rst:2355 +msgid "Pending Removal in Python 3.14" +msgstr "" + +#: whatsnew/3.12.rst:1393 msgid "" "The following APIs have been deprecated and will be removed in Python 3.14." msgstr "" -#: whatsnew/3.12.rst:1384 +#: whatsnew/3.12.rst:1396 msgid "" ":mod:`argparse`: The *type*, *choices*, and *metavar* parameters of :class:`!" "argparse.BooleanOptionalAction`" msgstr "" -#: whatsnew/3.12.rst:1387 +#: whatsnew/3.12.rst:1399 msgid ":mod:`ast`:" msgstr "" -#: whatsnew/3.12.rst:1397 +#: whatsnew/3.12.rst:1409 msgid ":class:`!asyncio.MultiLoopChildWatcher`" msgstr "" -#: whatsnew/3.12.rst:1398 +#: whatsnew/3.12.rst:1410 msgid ":class:`!asyncio.FastChildWatcher`" msgstr "" -#: whatsnew/3.12.rst:1399 +#: whatsnew/3.12.rst:1411 msgid ":class:`!asyncio.AbstractChildWatcher`" msgstr "" -#: whatsnew/3.12.rst:1400 +#: whatsnew/3.12.rst:1412 msgid ":class:`!asyncio.SafeChildWatcher`" msgstr "" -#: whatsnew/3.12.rst:1401 +#: whatsnew/3.12.rst:1413 msgid ":func:`!asyncio.set_child_watcher`" msgstr "" -#: whatsnew/3.12.rst:1402 +#: whatsnew/3.12.rst:1414 msgid ":func:`!asyncio.get_child_watcher`," msgstr "" -#: whatsnew/3.12.rst:1403 +#: whatsnew/3.12.rst:1415 msgid ":meth:`!asyncio.AbstractEventLoopPolicy.set_child_watcher`" msgstr "" -#: whatsnew/3.12.rst:1404 +#: whatsnew/3.12.rst:1416 msgid ":meth:`!asyncio.AbstractEventLoopPolicy.get_child_watcher`" msgstr "" -#: whatsnew/3.12.rst:1406 +#: whatsnew/3.12.rst:1418 msgid ":mod:`collections.abc`: :class:`!collections.abc.ByteString`." msgstr "" -#: whatsnew/3.12.rst:1408 +#: whatsnew/3.12.rst:1420 msgid ":mod:`email`: the *isdst* parameter in :func:`email.utils.localtime`." msgstr "" -#: whatsnew/3.12.rst:1410 +#: whatsnew/3.12.rst:1422 msgid ":mod:`importlib.abc`:" msgstr "" -#: whatsnew/3.12.rst:1416 +#: whatsnew/3.12.rst:1428 msgid ":mod:`itertools`: Support for copy, deepcopy, and pickle operations." msgstr "" -#: whatsnew/3.12.rst:1418 +#: whatsnew/3.12.rst:1430 msgid ":mod:`pkgutil`:" msgstr "" -#: whatsnew/3.12.rst:1420 +#: whatsnew/3.12.rst:1432 msgid ":func:`!pkgutil.find_loader`" msgstr "" -#: whatsnew/3.12.rst:1421 +#: whatsnew/3.12.rst:1433 msgid ":func:`!pkgutil.get_loader`." msgstr "" -#: whatsnew/3.12.rst:1423 +#: whatsnew/3.12.rst:1435 msgid ":mod:`pty`:" msgstr "" -#: whatsnew/3.12.rst:1425 +#: whatsnew/3.12.rst:1437 msgid ":func:`!pty.master_open`" msgstr "" -#: whatsnew/3.12.rst:1426 +#: whatsnew/3.12.rst:1438 msgid ":func:`!pty.slave_open`" msgstr "" -#: whatsnew/3.12.rst:1428 +#: whatsnew/3.12.rst:1440 msgid ":mod:`shutil`: The *onerror* argument of :func:`shutil.rmtree`" msgstr "" -#: whatsnew/3.12.rst:1430 +#: whatsnew/3.12.rst:1442 msgid ":mod:`typing`: :class:`!typing.ByteString`" msgstr "" -#: whatsnew/3.12.rst:1432 +#: whatsnew/3.12.rst:1444 msgid "" ":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`xml." "etree.ElementTree.Element`." msgstr "" -#: whatsnew/3.12.rst:1434 +#: whatsnew/3.12.rst:1446 msgid "The ``__package__`` and ``__cached__`` attributes on module objects." msgstr "" -#: whatsnew/3.12.rst:1436 +#: whatsnew/3.12.rst:1448 msgid "The :attr:`~codeobject.co_lnotab` attribute of code objects." msgstr "" -#: whatsnew/3.12.rst:2380 +#: whatsnew/3.12.rst:2392 msgid "Pending Removal in Python 3.15" msgstr "" -#: whatsnew/3.12.rst:1441 +#: whatsnew/3.12.rst:1453 msgid "" "The following APIs have been deprecated and will be removed in Python 3.15." msgstr "" -#: whatsnew/3.12.rst:1446 +#: whatsnew/3.12.rst:1458 msgid ":func:`locale.getdefaultlocale` (:gh:`90817`)" msgstr "" -#: whatsnew/3.12.rst:2398 +#: whatsnew/3.12.rst:2410 msgid "Pending Removal in Future Versions" msgstr "" -#: whatsnew/3.12.rst:1452 +#: whatsnew/3.12.rst:1464 msgid "" "The following APIs were deprecated in earlier Python versions and will be " "removed, although there is currently no date scheduled for their removal." msgstr "" -#: whatsnew/3.12.rst:1455 +#: whatsnew/3.12.rst:1467 msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" msgstr "" -#: whatsnew/3.12.rst:1457 +#: whatsnew/3.12.rst:1469 msgid ":class:`typing.Text` (:gh:`92332`)" msgstr "" -#: whatsnew/3.12.rst:1459 +#: whatsnew/3.12.rst:1471 msgid "" "Currently Python accepts numeric literals immediately followed by keywords, " "for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing and " @@ -2121,54 +2160,54 @@ msgid "" "syntax error. (:gh:`87999`)" msgstr "" -#: whatsnew/3.12.rst:2430 +#: whatsnew/3.12.rst:2442 msgid "Removed" msgstr "" -#: whatsnew/3.12.rst:1473 +#: whatsnew/3.12.rst:1485 msgid "asynchat and asyncore" msgstr "" -#: whatsnew/3.12.rst:1475 +#: whatsnew/3.12.rst:1487 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:1482 +#: whatsnew/3.12.rst:1494 msgid "configparser" msgstr "" -#: whatsnew/3.12.rst:1484 +#: whatsnew/3.12.rst:1496 msgid "" "Several names deprecated in the :mod:`configparser` way back in 3.2 have " "been removed per :gh:`89336`:" msgstr "" -#: whatsnew/3.12.rst:1487 +#: whatsnew/3.12.rst:1499 msgid "" ":class:`configparser.ParsingError` no longer has a ``filename`` attribute or " "argument. Use the ``source`` attribute and argument instead." msgstr "" -#: whatsnew/3.12.rst:1489 +#: whatsnew/3.12.rst:1501 msgid "" ":mod:`configparser` no longer has a ``SafeConfigParser`` class. Use the " "shorter :class:`~configparser.ConfigParser` name instead." msgstr "" -#: whatsnew/3.12.rst:1491 +#: whatsnew/3.12.rst:1503 msgid "" ":class:`configparser.ConfigParser` no longer has a ``readfp`` method. Use :" "meth:`~configparser.ConfigParser.read_file` instead." msgstr "" -#: whatsnew/3.12.rst:1495 +#: whatsnew/3.12.rst:1507 msgid "distutils" msgstr "" -#: whatsnew/3.12.rst:1497 +#: whatsnew/3.12.rst:1509 msgid "" "Remove the :py:mod:`!distutils` package. It was deprecated in Python 3.10 " "by :pep:`632` \"Deprecate distutils module\". For projects still using " @@ -2177,17 +2216,17 @@ msgid "" "Victor Stinner in :gh:`92584`.)" msgstr "" -#: whatsnew/3.12.rst:1504 +#: whatsnew/3.12.rst:1516 msgid "ensurepip" msgstr "" -#: whatsnew/3.12.rst:1506 +#: whatsnew/3.12.rst:1518 msgid "" "Remove the bundled setuptools wheel from :mod:`ensurepip`, and stop " "installing setuptools in environments created by :mod:`venv`." msgstr "" -#: whatsnew/3.12.rst:1509 +#: whatsnew/3.12.rst:1521 msgid "" "``pip (>= 22.1)`` does not require setuptools to be installed in the " "environment. ``setuptools``-based (and ``distutils``-based) packages can " @@ -2195,7 +2234,7 @@ msgid "" "the build environment it uses for building a package." msgstr "" -#: whatsnew/3.12.rst:1515 +#: whatsnew/3.12.rst:1527 msgid "" "``easy_install``, ``pkg_resources``, ``setuptools`` and ``distutils`` are no " "longer provided by default in environments created with ``venv`` or " @@ -2205,35 +2244,35 @@ msgid "" "(typically, using pip)." msgstr "" -#: whatsnew/3.12.rst:1522 +#: whatsnew/3.12.rst:1534 msgid "(Contributed by Pradyun Gedam in :gh:`95299`.)" msgstr "" -#: whatsnew/3.12.rst:1525 +#: whatsnew/3.12.rst:1537 msgid "enum" msgstr "" -#: whatsnew/3.12.rst:1527 +#: whatsnew/3.12.rst:1539 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:1532 +#: whatsnew/3.12.rst:1544 msgid "ftplib" msgstr "" -#: whatsnew/3.12.rst:1534 +#: whatsnew/3.12.rst:1546 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:1539 +#: whatsnew/3.12.rst:1551 msgid "gzip" msgstr "" -#: whatsnew/3.12.rst:1541 +#: whatsnew/3.12.rst:1553 msgid "" "Remove the ``filename`` attribute of :mod:`gzip`'s :class:`gzip.GzipFile`, " "deprecated since Python 2.6, use the :attr:`~gzip.GzipFile.name` attribute " @@ -2242,11 +2281,11 @@ msgid "" "`94196`.)" msgstr "" -#: whatsnew/3.12.rst:1548 +#: whatsnew/3.12.rst:1560 msgid "hashlib" msgstr "" -#: whatsnew/3.12.rst:1550 +#: whatsnew/3.12.rst:1562 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 " @@ -2255,191 +2294,191 @@ msgid "" "Stinner in :gh:`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1584 +#: whatsnew/3.12.rst:1596 msgid "importlib" msgstr "" -#: whatsnew/3.12.rst:1559 +#: whatsnew/3.12.rst:1571 msgid "" "Many previously deprecated cleanups in :mod:`importlib` have now been " "completed:" msgstr "" -#: whatsnew/3.12.rst:1562 +#: whatsnew/3.12.rst:1574 msgid "" "References to, and support for :meth:`!module_repr()` has been removed. " "(Contributed by Barry Warsaw in :gh:`97850`.)" msgstr "" -#: whatsnew/3.12.rst:1565 +#: whatsnew/3.12.rst:1577 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:1569 +#: whatsnew/3.12.rst:1581 msgid "" "Support for ``find_loader()`` and ``find_module()`` APIs have been removed. " "(Contributed by Barry Warsaw in :gh:`98040`.)" msgstr "" -#: whatsnew/3.12.rst:1572 +#: whatsnew/3.12.rst:1584 msgid "" "``importlib.abc.Finder``, ``pkgutil.ImpImporter``, and ``pkgutil.ImpLoader`` " "have been removed. (Contributed by Barry Warsaw in :gh:`98040`.)" msgstr "" -#: whatsnew/3.12.rst:1584 +#: whatsnew/3.12.rst:1596 msgid "imp" msgstr "" -#: whatsnew/3.12.rst:1578 +#: whatsnew/3.12.rst:1590 msgid "" "The :mod:`!imp` module has been removed. (Contributed by Barry Warsaw in :" "gh:`98040`.)" msgstr "" -#: whatsnew/3.12.rst:1581 +#: whatsnew/3.12.rst:1593 msgid "To migrate, consult the following correspondence table:" msgstr "" -#: whatsnew/3.12.rst:1586 +#: whatsnew/3.12.rst:1598 msgid "``imp.NullImporter``" msgstr "" -#: whatsnew/3.12.rst:1586 +#: whatsnew/3.12.rst:1598 msgid "Insert ``None`` into ``sys.path_importer_cache``" msgstr "" -#: whatsnew/3.12.rst:1587 +#: whatsnew/3.12.rst:1599 msgid "``imp.cache_from_source()``" msgstr "" -#: whatsnew/3.12.rst:1587 +#: whatsnew/3.12.rst:1599 msgid ":func:`importlib.util.cache_from_source`" msgstr "" -#: whatsnew/3.12.rst:1588 +#: whatsnew/3.12.rst:1600 msgid "``imp.find_module()``" msgstr "" -#: whatsnew/3.12.rst:1588 +#: whatsnew/3.12.rst:1600 msgid ":func:`importlib.util.find_spec`" msgstr "" -#: whatsnew/3.12.rst:1589 +#: whatsnew/3.12.rst:1601 msgid "``imp.get_magic()``" msgstr "" -#: whatsnew/3.12.rst:1589 +#: whatsnew/3.12.rst:1601 msgid ":attr:`importlib.util.MAGIC_NUMBER`" msgstr "" -#: whatsnew/3.12.rst:1590 +#: whatsnew/3.12.rst:1602 msgid "``imp.get_suffixes()``" msgstr "" -#: whatsnew/3.12.rst:1590 +#: whatsnew/3.12.rst:1602 msgid "" ":attr:`importlib.machinery.SOURCE_SUFFIXES`, :attr:`importlib.machinery." "EXTENSION_SUFFIXES`, and :attr:`importlib.machinery.BYTECODE_SUFFIXES`" msgstr "" -#: whatsnew/3.12.rst:1591 +#: whatsnew/3.12.rst:1603 msgid "``imp.get_tag()``" msgstr "" -#: whatsnew/3.12.rst:1591 +#: whatsnew/3.12.rst:1603 msgid ":attr:`sys.implementation.cache_tag `" msgstr "" -#: whatsnew/3.12.rst:1592 +#: whatsnew/3.12.rst:1604 msgid "``imp.load_module()``" msgstr "" -#: whatsnew/3.12.rst:1592 +#: whatsnew/3.12.rst:1604 msgid ":func:`importlib.import_module`" msgstr "" -#: whatsnew/3.12.rst:1593 +#: whatsnew/3.12.rst:1605 msgid "``imp.new_module(name)``" msgstr "" -#: whatsnew/3.12.rst:1593 +#: whatsnew/3.12.rst:1605 msgid "``types.ModuleType(name)``" msgstr "" -#: whatsnew/3.12.rst:1594 +#: whatsnew/3.12.rst:1606 msgid "``imp.reload()``" msgstr "" -#: whatsnew/3.12.rst:1594 +#: whatsnew/3.12.rst:1606 msgid ":func:`importlib.reload`" msgstr "" -#: whatsnew/3.12.rst:1595 +#: whatsnew/3.12.rst:1607 msgid "``imp.source_from_cache()``" msgstr "" -#: whatsnew/3.12.rst:1595 +#: whatsnew/3.12.rst:1607 msgid ":func:`importlib.util.source_from_cache`" msgstr "" -#: whatsnew/3.12.rst:1596 +#: whatsnew/3.12.rst:1608 msgid "``imp.load_source()``" msgstr "" -#: whatsnew/3.12.rst:1596 +#: whatsnew/3.12.rst:1608 msgid "*See below*" msgstr "" -#: whatsnew/3.12.rst:1599 +#: whatsnew/3.12.rst:1611 msgid "Replace ``imp.load_source()`` with::" msgstr "" -#: whatsnew/3.12.rst:1614 +#: whatsnew/3.12.rst:1626 msgid "Remove :mod:`!imp` functions and attributes with no replacements:" msgstr "" -#: whatsnew/3.12.rst:1616 +#: whatsnew/3.12.rst:1628 msgid "Undocumented functions:" msgstr "" -#: whatsnew/3.12.rst:1618 +#: whatsnew/3.12.rst:1630 msgid "``imp.init_builtin()``" msgstr "" -#: whatsnew/3.12.rst:1619 +#: whatsnew/3.12.rst:1631 msgid "``imp.load_compiled()``" msgstr "" -#: whatsnew/3.12.rst:1620 +#: whatsnew/3.12.rst:1632 msgid "``imp.load_dynamic()``" msgstr "" -#: whatsnew/3.12.rst:1621 +#: whatsnew/3.12.rst:1633 msgid "``imp.load_package()``" msgstr "" -#: whatsnew/3.12.rst:1623 +#: whatsnew/3.12.rst:1635 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:1625 +#: whatsnew/3.12.rst:1637 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:1630 +#: whatsnew/3.12.rst:1642 msgid "io" msgstr "" -#: whatsnew/3.12.rst:1632 +#: whatsnew/3.12.rst:1644 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." @@ -2448,22 +2487,22 @@ msgid "" "`94169`.)" msgstr "" -#: whatsnew/3.12.rst:1639 +#: whatsnew/3.12.rst:1651 msgid "locale" msgstr "" -#: whatsnew/3.12.rst:1641 +#: whatsnew/3.12.rst:1653 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:1646 +#: whatsnew/3.12.rst:1658 msgid "smtpd" msgstr "" -#: whatsnew/3.12.rst:1648 +#: whatsnew/3.12.rst:1660 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 aiosmtpd_ PyPI " @@ -2471,27 +2510,27 @@ msgid "" "Oleg Iarygin in :gh:`93243`.)" msgstr "" -#: whatsnew/3.12.rst:1659 +#: whatsnew/3.12.rst:1671 msgid "" "The following undocumented :mod:`sqlite3` features, deprecated in Python " "3.10, are now removed:" msgstr "" -#: whatsnew/3.12.rst:1662 +#: whatsnew/3.12.rst:1674 msgid "``sqlite3.enable_shared_cache()``" msgstr "" -#: whatsnew/3.12.rst:1663 +#: whatsnew/3.12.rst:1675 msgid "``sqlite3.OptimizedUnicode``" msgstr "" -#: whatsnew/3.12.rst:1665 +#: whatsnew/3.12.rst:1677 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:1668 +#: whatsnew/3.12.rst:1680 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 " @@ -2499,22 +2538,22 @@ msgid "" "default value which is also ``str``." msgstr "" -#: whatsnew/3.12.rst:1673 +#: whatsnew/3.12.rst:1685 msgid "(Contributed by Erlend E. Aasland in :gh:`92548`.)" msgstr "" -#: whatsnew/3.12.rst:1676 +#: whatsnew/3.12.rst:1688 msgid "ssl" msgstr "" -#: whatsnew/3.12.rst:1678 +#: whatsnew/3.12.rst:1690 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:1682 +#: whatsnew/3.12.rst:1694 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 " @@ -2522,7 +2561,7 @@ msgid "" "Stinner in :gh:`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1688 +#: whatsnew/3.12.rst:1700 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." @@ -2533,185 +2572,185 @@ msgid "" "Validation. (Contributed by Victor Stinner in :gh:`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1700 +#: whatsnew/3.12.rst:1712 msgid "Remove many long-deprecated :mod:`unittest` features:" msgstr "" -#: whatsnew/3.12.rst:1704 +#: whatsnew/3.12.rst:1716 msgid "A number of :class:`~unittest.TestCase` method aliases:" msgstr "" -#: whatsnew/3.12.rst:1707 +#: whatsnew/3.12.rst:1719 msgid "Deprecated alias" msgstr "" -#: whatsnew/3.12.rst:1707 +#: whatsnew/3.12.rst:1719 msgid "Method Name" msgstr "" -#: whatsnew/3.12.rst:1707 +#: whatsnew/3.12.rst:1719 msgid "Deprecated in" msgstr "" -#: whatsnew/3.12.rst:1709 +#: whatsnew/3.12.rst:1721 msgid "``failUnless``" msgstr "" -#: whatsnew/3.12.rst:1716 +#: whatsnew/3.12.rst:1728 msgid ":meth:`.assertTrue`" msgstr "" -#: whatsnew/3.12.rst:1710 whatsnew/3.12.rst:1712 whatsnew/3.12.rst:1714 -#: whatsnew/3.12.rst:1715 +#: whatsnew/3.12.rst:1722 whatsnew/3.12.rst:1724 whatsnew/3.12.rst:1726 +#: whatsnew/3.12.rst:1727 msgid "3.1" msgstr "" -#: whatsnew/3.12.rst:1710 +#: whatsnew/3.12.rst:1722 msgid "``failIf``" msgstr "" -#: whatsnew/3.12.rst:1710 +#: whatsnew/3.12.rst:1722 msgid ":meth:`.assertFalse`" msgstr "" -#: whatsnew/3.12.rst:1711 +#: whatsnew/3.12.rst:1723 msgid "``failUnlessEqual``" msgstr "" -#: whatsnew/3.12.rst:1717 +#: whatsnew/3.12.rst:1729 msgid ":meth:`.assertEqual`" msgstr "" -#: whatsnew/3.12.rst:1712 +#: whatsnew/3.12.rst:1724 msgid "``failIfEqual``" msgstr "" -#: whatsnew/3.12.rst:1718 +#: whatsnew/3.12.rst:1730 msgid ":meth:`.assertNotEqual`" msgstr "" -#: whatsnew/3.12.rst:1713 +#: whatsnew/3.12.rst:1725 msgid "``failUnlessAlmostEqual``" msgstr "" -#: whatsnew/3.12.rst:1719 +#: whatsnew/3.12.rst:1731 msgid ":meth:`.assertAlmostEqual`" msgstr "" -#: whatsnew/3.12.rst:1714 +#: whatsnew/3.12.rst:1726 msgid "``failIfAlmostEqual``" msgstr "" -#: whatsnew/3.12.rst:1720 +#: whatsnew/3.12.rst:1732 msgid ":meth:`.assertNotAlmostEqual`" msgstr "" -#: whatsnew/3.12.rst:1715 +#: whatsnew/3.12.rst:1727 msgid "``failUnlessRaises``" msgstr "" -#: whatsnew/3.12.rst:1715 +#: whatsnew/3.12.rst:1727 msgid ":meth:`.assertRaises`" msgstr "" -#: whatsnew/3.12.rst:1716 +#: whatsnew/3.12.rst:1728 msgid "``assert_``" msgstr "" -#: whatsnew/3.12.rst:1717 whatsnew/3.12.rst:1719 whatsnew/3.12.rst:1721 -#: whatsnew/3.12.rst:1722 +#: whatsnew/3.12.rst:1729 whatsnew/3.12.rst:1731 whatsnew/3.12.rst:1733 +#: whatsnew/3.12.rst:1734 msgid "3.2" msgstr "" -#: whatsnew/3.12.rst:1717 +#: whatsnew/3.12.rst:1729 msgid "``assertEquals``" msgstr "" -#: whatsnew/3.12.rst:1718 +#: whatsnew/3.12.rst:1730 msgid "``assertNotEquals``" msgstr "" -#: whatsnew/3.12.rst:1719 +#: whatsnew/3.12.rst:1731 msgid "``assertAlmostEquals``" msgstr "" -#: whatsnew/3.12.rst:1720 +#: whatsnew/3.12.rst:1732 msgid "``assertNotAlmostEquals``" msgstr "" -#: whatsnew/3.12.rst:1721 +#: whatsnew/3.12.rst:1733 msgid "``assertRegexpMatches``" msgstr "" -#: whatsnew/3.12.rst:1721 +#: whatsnew/3.12.rst:1733 msgid ":meth:`.assertRegex`" msgstr "" -#: whatsnew/3.12.rst:1722 +#: whatsnew/3.12.rst:1734 msgid "``assertRaisesRegexp``" msgstr "" -#: whatsnew/3.12.rst:1722 +#: whatsnew/3.12.rst:1734 msgid ":meth:`.assertRaisesRegex`" msgstr "" -#: whatsnew/3.12.rst:1723 +#: whatsnew/3.12.rst:1735 msgid "``assertNotRegexpMatches``" msgstr "" -#: whatsnew/3.12.rst:1723 +#: whatsnew/3.12.rst:1735 msgid ":meth:`.assertNotRegex`" msgstr "" -#: whatsnew/3.12.rst:1723 +#: whatsnew/3.12.rst:1735 msgid "3.5" msgstr "" -#: whatsnew/3.12.rst:1726 +#: whatsnew/3.12.rst:1738 msgid "" "You can use https://github.com/isidentical/teyit to automatically modernise " "your unit tests." msgstr "" -#: whatsnew/3.12.rst:1729 +#: whatsnew/3.12.rst:1741 msgid "" "Undocumented and broken :class:`~unittest.TestCase` method " "``assertDictContainsSubset`` (deprecated in Python 3.2)." msgstr "" -#: whatsnew/3.12.rst:1732 +#: whatsnew/3.12.rst:1744 msgid "" "Undocumented :meth:`TestLoader.loadTestsFromModule ` parameter *use_load_tests* (deprecated and ignored " "since Python 3.2)." msgstr "" -#: whatsnew/3.12.rst:1736 +#: whatsnew/3.12.rst:1748 msgid "" "An alias of the :class:`~unittest.TextTestResult` class: ``_TextTestResult`` " "(deprecated in Python 3.2)." msgstr "" -#: whatsnew/3.12.rst:1739 +#: whatsnew/3.12.rst:1751 msgid "(Contributed by Serhiy Storchaka in :gh:`89325`.)" msgstr "" -#: whatsnew/3.12.rst:1742 +#: whatsnew/3.12.rst:1754 msgid "webbrowser" msgstr "" -#: whatsnew/3.12.rst:1744 +#: whatsnew/3.12.rst:1756 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:1749 +#: whatsnew/3.12.rst:1761 msgid "xml.etree.ElementTree" msgstr "" -#: whatsnew/3.12.rst:1751 +#: whatsnew/3.12.rst:1763 msgid "" "Remove the ``ElementTree.Element.copy()`` method of the pure Python " "implementation, deprecated in Python 3.10, use the :func:`copy.copy` " @@ -2720,22 +2759,22 @@ msgid "" "Stinner in :gh:`94383`.)" msgstr "" -#: whatsnew/3.12.rst:1758 +#: whatsnew/3.12.rst:1770 msgid "zipimport" msgstr "" -#: whatsnew/3.12.rst:1760 +#: whatsnew/3.12.rst:1772 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:1766 +#: whatsnew/3.12.rst:1778 msgid "Others" msgstr "" -#: whatsnew/3.12.rst:1768 +#: whatsnew/3.12.rst:1780 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 " @@ -3005,84 +3044,84 @@ msgid "" "contents are marked by the ``PyUnstable_`` prefix in names." msgstr "" -#: whatsnew/3.12.rst:1964 +#: whatsnew/3.12.rst:1976 msgid "Code object constructors:" msgstr "" -#: whatsnew/3.12.rst:1966 +#: whatsnew/3.12.rst:1978 msgid "``PyUnstable_Code_New()`` (renamed from ``PyCode_New``)" msgstr "" -#: whatsnew/3.12.rst:1967 +#: whatsnew/3.12.rst:1979 msgid "" "``PyUnstable_Code_NewWithPosOnlyArgs()`` (renamed from " "``PyCode_NewWithPosOnlyArgs``)" msgstr "" -#: whatsnew/3.12.rst:1969 +#: whatsnew/3.12.rst:1981 msgid "Extra storage for code objects (:pep:`523`):" msgstr "" -#: whatsnew/3.12.rst:1971 +#: whatsnew/3.12.rst:1983 msgid "" "``PyUnstable_Eval_RequestCodeExtraIndex()`` (renamed from " "``_PyEval_RequestCodeExtraIndex``)" msgstr "" -#: whatsnew/3.12.rst:1972 +#: whatsnew/3.12.rst:1984 msgid "``PyUnstable_Code_GetExtra()`` (renamed from ``_PyCode_GetExtra``)" msgstr "" -#: whatsnew/3.12.rst:1973 +#: whatsnew/3.12.rst:1985 msgid "``PyUnstable_Code_SetExtra()`` (renamed from ``_PyCode_SetExtra``)" msgstr "" -#: whatsnew/3.12.rst:1975 +#: whatsnew/3.12.rst:1987 msgid "" "The original names will continue to be available until the respective API " "changes." msgstr "" -#: whatsnew/3.12.rst:1978 +#: whatsnew/3.12.rst:1990 msgid "(Contributed by Petr Viktorin in :gh:`101101`.)" msgstr "" -#: whatsnew/3.12.rst:1980 +#: whatsnew/3.12.rst:1992 msgid "" ":pep:`697`: Add an API for extending types whose instance memory layout is " "opaque:" msgstr "" -#: whatsnew/3.12.rst:1983 +#: whatsnew/3.12.rst:1995 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:1985 +#: whatsnew/3.12.rst:1997 msgid "" ":c:func:`PyObject_GetTypeData` and :c:func:`PyType_GetTypeDataSize` added to " "allow access to subclass-specific instance data." msgstr "" -#: whatsnew/3.12.rst:1987 +#: whatsnew/3.12.rst:1999 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:1990 +#: whatsnew/3.12.rst:2002 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:1993 +#: whatsnew/3.12.rst:2005 msgid "(Contributed by Petr Viktorin in :gh:`103509`.)" msgstr "" -#: whatsnew/3.12.rst:1995 +#: whatsnew/3.12.rst:2007 msgid "" "Add the new :ref:`limited C API ` function :c:func:" "`PyType_FromMetaclass`, which generalizes the existing :c:func:" @@ -3090,29 +3129,29 @@ msgid "" "(Contributed by Wenzel Jakob in :gh:`93012`.)" msgstr "" -#: whatsnew/3.12.rst:2000 +#: whatsnew/3.12.rst:2012 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:2004 +#: whatsnew/3.12.rst:2016 msgid ":c:macro:`Py_TPFLAGS_HAVE_VECTORCALL`" msgstr "" -#: whatsnew/3.12.rst:2005 +#: whatsnew/3.12.rst:2017 msgid ":c:func:`PyVectorcall_NARGS`" msgstr "" -#: whatsnew/3.12.rst:2006 +#: whatsnew/3.12.rst:2018 msgid ":c:func:`PyVectorcall_Call`" msgstr "" -#: whatsnew/3.12.rst:2007 +#: whatsnew/3.12.rst:2019 msgid ":c:type:`vectorcallfunc`" msgstr "" -#: whatsnew/3.12.rst:2009 +#: whatsnew/3.12.rst:2021 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 " @@ -3123,7 +3162,7 @@ msgid "" "`93274`.)" msgstr "" -#: whatsnew/3.12.rst:2017 +#: whatsnew/3.12.rst:2029 msgid "" "The :c:macro:`Py_TPFLAGS_MANAGED_DICT` and :c:macro:" "`Py_TPFLAGS_MANAGED_WEAKREF` flags have been added. This allows extensions " @@ -3131,32 +3170,32 @@ msgid "" "using less memory and with faster access." msgstr "" -#: whatsnew/3.12.rst:2022 +#: whatsnew/3.12.rst:2034 msgid "" "API for performing calls using :ref:`the vectorcall protocol ` " "was added to the :ref:`Limited API `:" msgstr "" -#: whatsnew/3.12.rst:2026 +#: whatsnew/3.12.rst:2038 msgid ":c:func:`PyObject_Vectorcall`" msgstr "" -#: whatsnew/3.12.rst:2027 +#: whatsnew/3.12.rst:2039 msgid ":c:func:`PyObject_VectorcallMethod`" msgstr "" -#: whatsnew/3.12.rst:2028 +#: whatsnew/3.12.rst:2040 msgid ":c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET`" msgstr "" -#: whatsnew/3.12.rst:2030 +#: whatsnew/3.12.rst:2042 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:2034 +#: whatsnew/3.12.rst:2046 msgid "" "Add two new public functions, :c:func:`PyEval_SetProfileAllThreads` and :c:" "func:`PyEval_SetTraceAllThreads`, that allow to set tracing and profiling " @@ -3164,14 +3203,14 @@ msgid "" "(Contributed by Pablo Galindo in :gh:`93503`.)" msgstr "" -#: whatsnew/3.12.rst:2040 +#: whatsnew/3.12.rst:2052 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:2044 +#: whatsnew/3.12.rst:2056 msgid "" "The C API now permits registering callbacks via :c:func:" "`PyDict_AddWatcher`, :c:func:`PyDict_Watch` and related APIs to be called " @@ -3180,28 +3219,28 @@ msgid "" "`91052`.)" msgstr "" -#: whatsnew/3.12.rst:2050 +#: whatsnew/3.12.rst:2062 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:2054 +#: whatsnew/3.12.rst:2066 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:2059 +#: whatsnew/3.12.rst:2071 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:2063 +#: whatsnew/3.12.rst:2075 msgid "" "Add :c:func:`PyErr_GetRaisedException` and :c:func:" "`PyErr_SetRaisedException` for saving and restoring the current exception. " @@ -3211,14 +3250,14 @@ msgid "" "(Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2071 +#: whatsnew/3.12.rst:2083 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:2075 +#: whatsnew/3.12.rst:2087 msgid "" "Add :c:func:`PyException_GetArgs` and :c:func:`PyException_SetArgs` as " "convenience functions for retrieving and modifying the :attr:`~BaseException." @@ -3226,71 +3265,71 @@ msgid "" "in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2080 +#: whatsnew/3.12.rst:2092 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:2086 +#: whatsnew/3.12.rst:2098 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:2089 +#: whatsnew/3.12.rst:2101 msgid "``_Py_IMMORTAL_REFCNT``: The reference count that defines an object" msgstr "" -#: whatsnew/3.12.rst:2090 +#: whatsnew/3.12.rst:2102 msgid "as immortal." msgstr "" -#: whatsnew/3.12.rst:2091 +#: whatsnew/3.12.rst:2103 msgid "" "``_Py_IsImmortal`` Checks if an object has the immortal reference count." msgstr "" -#: whatsnew/3.12.rst:2092 +#: whatsnew/3.12.rst:2104 msgid "``PyObject_HEAD_INIT`` This will now initialize reference count to" msgstr "" -#: whatsnew/3.12.rst:2093 +#: whatsnew/3.12.rst:2105 msgid "``_Py_IMMORTAL_REFCNT`` when used with ``Py_BUILD_CORE``." msgstr "" -#: whatsnew/3.12.rst:2094 +#: whatsnew/3.12.rst:2106 msgid "``SSTATE_INTERNED_IMMORTAL`` An identifier for interned unicode objects" msgstr "" -#: whatsnew/3.12.rst:2095 +#: whatsnew/3.12.rst:2107 msgid "that are immortal." msgstr "" -#: whatsnew/3.12.rst:2096 +#: whatsnew/3.12.rst:2108 msgid "``SSTATE_INTERNED_IMMORTAL_STATIC`` An identifier for interned unicode" msgstr "" -#: whatsnew/3.12.rst:2097 +#: whatsnew/3.12.rst:2109 msgid "objects that are immortal and static" msgstr "" -#: whatsnew/3.12.rst:2100 +#: whatsnew/3.12.rst:2112 msgid "``sys.getunicodeinternedsize`` This returns the total number of unicode" msgstr "" -#: whatsnew/3.12.rst:2099 +#: whatsnew/3.12.rst:2111 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:2102 +#: whatsnew/3.12.rst:2114 msgid "(Contributed by Eddie Elizondo in :gh:`84436`.)" msgstr "" -#: whatsnew/3.12.rst:2104 +#: whatsnew/3.12.rst:2116 msgid "" ":pep:`684`: Add the new :c:func:`Py_NewInterpreterFromConfig` function and :" "c:type:`PyInterpreterConfig`, which may be used to create sub-interpreters " @@ -3298,27 +3337,27 @@ msgid "" "(Contributed by Eric Snow in :gh:`104110`.)" msgstr "" -#: whatsnew/3.12.rst:2110 +#: whatsnew/3.12.rst:2122 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:2118 +#: whatsnew/3.12.rst:2130 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:2121 +#: whatsnew/3.12.rst:2133 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:2125 +#: whatsnew/3.12.rst:2137 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 " @@ -3327,7 +3366,7 @@ msgid "" "necessary, the (internal-only) ``_PyObject_GET_WEAKREFS_LISTPTR()`` macro." msgstr "" -#: whatsnew/3.12.rst:2132 +#: whatsnew/3.12.rst:2144 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 " @@ -3335,13 +3374,13 @@ msgid "" "only field directly." msgstr "" -#: whatsnew/3.12.rst:2137 +#: whatsnew/3.12.rst:2149 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:2141 +#: whatsnew/3.12.rst:2153 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 " @@ -3350,7 +3389,7 @@ msgid "" "`98836`.)" msgstr "" -#: whatsnew/3.12.rst:2147 +#: whatsnew/3.12.rst:2159 msgid "" "An unrecognized format character in :c:func:`PyUnicode_FromFormat` and :c:" "func:`PyUnicode_FromFormatV` now sets a :exc:`SystemError`. In previous " @@ -3359,13 +3398,13 @@ msgid "" "Storchaka in :gh:`95781`.)" msgstr "" -#: whatsnew/3.12.rst:2153 +#: whatsnew/3.12.rst:2165 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:2157 +#: whatsnew/3.12.rst:2169 msgid "" "Extension classes wanting to add a ``__dict__`` or weak reference slot " "should use :c:macro:`Py_TPFLAGS_MANAGED_DICT` and :c:macro:" @@ -3379,7 +3418,7 @@ msgid "" "func:`PyObject_ClearWeakRefs`, as before." msgstr "" -#: whatsnew/3.12.rst:2169 +#: whatsnew/3.12.rst:2181 msgid "" "The :c:func:`PyUnicode_FSDecoder` function no longer accepts bytes-like " "paths, like :class:`bytearray` and :class:`memoryview` types: only the " @@ -3387,7 +3426,7 @@ msgid "" "Victor Stinner in :gh:`98393`.)" msgstr "" -#: whatsnew/3.12.rst:2174 +#: whatsnew/3.12.rst:2186 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 " @@ -3395,7 +3434,7 @@ msgid "" "Stinner in :gh:`98724`.)" msgstr "" -#: whatsnew/3.12.rst:2179 +#: whatsnew/3.12.rst:2191 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 " @@ -3403,7 +3442,7 @@ msgid "" "(Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2184 +#: whatsnew/3.12.rst:2196 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 " @@ -3411,25 +3450,25 @@ msgid "" "``_Py_GetGlobalRefTotal()``." msgstr "" -#: whatsnew/3.12.rst:2189 +#: whatsnew/3.12.rst:2201 msgid "" "The following functions now select an appropriate metaclass for the newly " "created type:" msgstr "" -#: whatsnew/3.12.rst:2192 +#: whatsnew/3.12.rst:2204 msgid ":c:func:`PyType_FromSpec`" msgstr "" -#: whatsnew/3.12.rst:2193 +#: whatsnew/3.12.rst:2205 msgid ":c:func:`PyType_FromSpecWithBases`" msgstr "" -#: whatsnew/3.12.rst:2194 +#: whatsnew/3.12.rst:2206 msgid ":c:func:`PyType_FromModuleAndSpec`" msgstr "" -#: whatsnew/3.12.rst:2196 +#: whatsnew/3.12.rst:2208 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 " @@ -3437,14 +3476,14 @@ msgid "" "initialization." msgstr "" -#: whatsnew/3.12.rst:2201 +#: whatsnew/3.12.rst:2213 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:2205 +#: whatsnew/3.12.rst:2217 msgid "" "Since ``tp_new`` overrides almost everything ``PyType_From*`` functions do, " "the two are incompatible with each other. The existing behavior -- ignoring " @@ -3453,17 +3492,17 @@ msgid "" "general workaround. One of the following may work for you:" msgstr "" -#: whatsnew/3.12.rst:2212 +#: whatsnew/3.12.rst:2224 msgid "If you control the metaclass, avoid using ``tp_new`` in it:" msgstr "" -#: whatsnew/3.12.rst:2214 +#: whatsnew/3.12.rst:2226 msgid "" "If initialization can be skipped, it can be done in :c:member:`~PyTypeObject." "tp_init` instead." msgstr "" -#: whatsnew/3.12.rst:2216 +#: whatsnew/3.12.rst:2228 msgid "" "If the metaclass doesn't need to be instantiated from Python, set its " "``tp_new`` to ``NULL`` using the :c:macro:" @@ -3471,20 +3510,20 @@ msgid "" "``PyType_From*`` functions." msgstr "" -#: whatsnew/3.12.rst:2221 +#: whatsnew/3.12.rst:2233 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:2225 +#: whatsnew/3.12.rst:2237 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:2228 +#: whatsnew/3.12.rst:2240 msgid "" ":c:var:`PyOS_InputHook` and :c:var:`PyOS_ReadlineFunctionPointer` are no " "longer called in :ref:`subinterpreters `. This is " @@ -3492,14 +3531,14 @@ msgid "" "callbacks have no way of recovering extension module state)." msgstr "" -#: whatsnew/3.12.rst:2233 +#: whatsnew/3.12.rst:2245 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:2237 +#: whatsnew/3.12.rst:2249 msgid "" ":c:struct:`PyLongObject` has had its internals changed for better " "performance. Although the internals of :c:struct:`PyLongObject` are private, " @@ -3510,15 +3549,15 @@ msgid "" "a single machine word:" msgstr "" -#: whatsnew/3.12.rst:2245 +#: whatsnew/3.12.rst:2257 msgid ":c:func:`PyUnstable_Long_IsCompact`" msgstr "" -#: whatsnew/3.12.rst:2246 +#: whatsnew/3.12.rst:2258 msgid ":c:func:`PyUnstable_Long_CompactValue`" msgstr "" -#: whatsnew/3.12.rst:2248 +#: whatsnew/3.12.rst:2260 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 " @@ -3527,7 +3566,7 @@ msgid "" "create a new GitHub issue and CC ``@ericsnowcurrently``." msgstr "" -#: whatsnew/3.12.rst:2258 +#: whatsnew/3.12.rst:2270 msgid "" "In accordance with :pep:`699`, the ``ma_version_tag`` field in :c:type:" "`PyDictObject` is deprecated for extension modules. Accessing this field " @@ -3536,444 +3575,444 @@ msgid "" "PEP by Ken Jin.)" msgstr "" -#: whatsnew/3.12.rst:2263 +#: whatsnew/3.12.rst:2275 msgid "Deprecate global configuration variable:" msgstr "" -#: whatsnew/3.12.rst:2350 +#: whatsnew/3.12.rst:2362 msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug`" msgstr "" -#: whatsnew/3.12.rst:2351 +#: whatsnew/3.12.rst:2363 msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose`" msgstr "" -#: whatsnew/3.12.rst:2352 +#: whatsnew/3.12.rst:2364 msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet`" msgstr "" -#: whatsnew/3.12.rst:2353 +#: whatsnew/3.12.rst:2365 msgid ":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive`" msgstr "" -#: whatsnew/3.12.rst:2354 +#: whatsnew/3.12.rst:2366 msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect`" msgstr "" -#: whatsnew/3.12.rst:2355 +#: whatsnew/3.12.rst:2367 msgid ":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level`" msgstr "" -#: whatsnew/3.12.rst:2356 +#: whatsnew/3.12.rst:2368 msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import`" msgstr "" -#: whatsnew/3.12.rst:2357 +#: whatsnew/3.12.rst:2369 msgid ":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning`" msgstr "" -#: whatsnew/3.12.rst:2358 +#: whatsnew/3.12.rst:2370 msgid ":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings`" msgstr "" -#: whatsnew/3.12.rst:2359 +#: whatsnew/3.12.rst:2371 msgid "" ":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment`" msgstr "" -#: whatsnew/3.12.rst:2360 +#: whatsnew/3.12.rst:2372 msgid "" ":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode`" msgstr "" -#: whatsnew/3.12.rst:2361 +#: whatsnew/3.12.rst:2373 msgid "" ":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig.user_site_directory`" msgstr "" -#: whatsnew/3.12.rst:2362 +#: whatsnew/3.12.rst:2374 msgid "" ":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio`" msgstr "" -#: whatsnew/3.12.rst:2363 +#: whatsnew/3.12.rst:2375 msgid "" ":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " "and :c:member:`PyConfig.hash_seed`" msgstr "" -#: whatsnew/3.12.rst:2365 +#: whatsnew/3.12.rst:2377 msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated`" msgstr "" -#: whatsnew/3.12.rst:2366 +#: whatsnew/3.12.rst:2378 msgid "" ":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." "legacy_windows_fs_encoding`" msgstr "" -#: whatsnew/3.12.rst:2367 +#: whatsnew/3.12.rst:2379 msgid "" ":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." "legacy_windows_stdio`" msgstr "" -#: whatsnew/3.12.rst:2368 +#: whatsnew/3.12.rst:2380 msgid "" ":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding`" msgstr "" -#: whatsnew/3.12.rst:2369 +#: whatsnew/3.12.rst:2381 msgid "" ":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding`" msgstr "" -#: whatsnew/3.12.rst:2370 +#: whatsnew/3.12.rst:2382 msgid "" ":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." "filesystem_errors`" msgstr "" -#: whatsnew/3.12.rst:2371 +#: whatsnew/3.12.rst:2383 msgid "" ":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` (see :c:func:" "`Py_PreInitialize`)" msgstr "" -#: whatsnew/3.12.rst:2288 +#: whatsnew/3.12.rst:2300 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:2292 +#: whatsnew/3.12.rst:2304 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:2295 +#: whatsnew/3.12.rst:2307 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:2298 +#: whatsnew/3.12.rst:2310 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:2301 +#: whatsnew/3.12.rst:2313 msgid "" ":c:struct:`PyMemberDef`, :c:func:`PyMember_GetOne` and :c:func:" "`PyMember_SetOne`" msgstr "" -#: whatsnew/3.12.rst:2303 +#: whatsnew/3.12.rst:2315 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:2305 +#: whatsnew/3.12.rst:2317 msgid "" "The flags :c:macro:`Py_READONLY` (previously ``READONLY``) and :c:macro:" "`Py_AUDIT_READ` (previously all uppercase)" msgstr "" -#: whatsnew/3.12.rst:2308 +#: whatsnew/3.12.rst:2320 msgid "Several items are not exposed from :file:`Python.h`:" msgstr "" -#: whatsnew/3.12.rst:2310 +#: whatsnew/3.12.rst:2322 msgid ":c:macro:`T_OBJECT` (use :c:macro:`Py_T_OBJECT_EX`)" msgstr "" -#: whatsnew/3.12.rst:2311 +#: whatsnew/3.12.rst:2323 msgid ":c:macro:`T_NONE` (previously undocumented, and pretty quirky)" msgstr "" -#: whatsnew/3.12.rst:2312 +#: whatsnew/3.12.rst:2324 msgid "The macro ``WRITE_RESTRICTED`` which does nothing." msgstr "" -#: whatsnew/3.12.rst:2313 +#: whatsnew/3.12.rst:2325 msgid "" "The macros ``RESTRICTED`` and ``READ_RESTRICTED``, equivalents of :c:macro:" "`Py_AUDIT_READ`." msgstr "" -#: whatsnew/3.12.rst:2315 +#: whatsnew/3.12.rst:2327 msgid "" "In some configurations, ```` is not included from :file:`Python." "h`. It should be included manually when using ``offsetof()``." msgstr "" -#: whatsnew/3.12.rst:2318 +#: whatsnew/3.12.rst:2330 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:2323 +#: whatsnew/3.12.rst:2335 msgid "" "(Contributed in :gh:`47146` by Petr Viktorin, based on earlier work by " "Alexander Belopolsky and Matthias Braun.)" msgstr "" -#: whatsnew/3.12.rst:2326 +#: whatsnew/3.12.rst:2338 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:2331 +#: whatsnew/3.12.rst:2343 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:2334 +#: whatsnew/3.12.rst:2346 msgid "" "``_PyErr_ChainExceptions`` is deprecated. Use ``_PyErr_ChainExceptions1`` " "instead. (Contributed by Irit Katriel in :gh:`102192`.)" msgstr "" -#: whatsnew/3.12.rst:2337 +#: whatsnew/3.12.rst:2349 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:2345 +#: whatsnew/3.12.rst:2357 msgid "" "The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules " "(:pep:`699`; :gh:`101193`)." msgstr "" -#: whatsnew/3.12.rst:2348 +#: whatsnew/3.12.rst:2360 msgid "Global configuration variables:" msgstr "" -#: whatsnew/3.12.rst:2373 +#: whatsnew/3.12.rst:2385 msgid "" "The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" "`PyConfig` instead." msgstr "" -#: whatsnew/3.12.rst:2376 +#: whatsnew/3.12.rst:2388 msgid "" "Creating :c:data:`immutable types ` with mutable " "bases (:gh:`95388`)." msgstr "" -#: whatsnew/3.12.rst:2382 +#: whatsnew/3.12.rst:2394 msgid "" ":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule`" msgstr "" -#: whatsnew/3.12.rst:2383 +#: whatsnew/3.12.rst:2395 msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t`" msgstr "" -#: whatsnew/3.12.rst:2384 +#: whatsnew/3.12.rst:2396 msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t`" msgstr "" -#: whatsnew/3.12.rst:2385 +#: whatsnew/3.12.rst:2397 msgid "Python initialization functions:" msgstr "" -#: whatsnew/3.12.rst:2387 +#: whatsnew/3.12.rst:2399 msgid "" ":c:func:`PySys_ResetWarnOptions`: clear :data:`sys.warnoptions` and :data:`!" "warnings.filters`" msgstr "" -#: whatsnew/3.12.rst:2389 +#: whatsnew/3.12.rst:2401 msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix`" msgstr "" -#: whatsnew/3.12.rst:2390 +#: whatsnew/3.12.rst:2402 msgid ":c:func:`Py_GetPath`: get :data:`sys.path`" msgstr "" -#: whatsnew/3.12.rst:2391 +#: whatsnew/3.12.rst:2403 msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix`" msgstr "" -#: whatsnew/3.12.rst:2392 +#: whatsnew/3.12.rst:2404 msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable`" msgstr "" -#: whatsnew/3.12.rst:2393 +#: whatsnew/3.12.rst:2405 msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable`" msgstr "" -#: whatsnew/3.12.rst:2394 +#: whatsnew/3.12.rst:2406 msgid "" ":c:func:`Py_GetPythonHome`: get :c:member:`PyConfig.home` or the :envvar:" "`PYTHONHOME` environment variable" msgstr "" -#: whatsnew/3.12.rst:2400 +#: whatsnew/3.12.rst:2412 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:2403 +#: whatsnew/3.12.rst:2415 msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8" msgstr "" -#: whatsnew/3.12.rst:2404 +#: whatsnew/3.12.rst:2416 msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException`" msgstr "" -#: whatsnew/3.12.rst:2405 +#: whatsnew/3.12.rst:2417 msgid "" ":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException`" msgstr "" -#: whatsnew/3.12.rst:2406 +#: whatsnew/3.12.rst:2418 msgid ":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException`" msgstr "" -#: whatsnew/3.12.rst:2407 +#: whatsnew/3.12.rst:2419 msgid "" ":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject`" msgstr "" -#: whatsnew/3.12.rst:2408 +#: whatsnew/3.12.rst:2420 msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child`" msgstr "" -#: whatsnew/3.12.rst:2409 +#: whatsnew/3.12.rst:2421 msgid "" ":c:func:`PySlice_GetIndicesEx`: use :c:func:`PySlice_Unpack` and :c:func:" "`PySlice_AdjustIndices`" msgstr "" -#: whatsnew/3.12.rst:2410 +#: whatsnew/3.12.rst:2422 msgid ":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode`" msgstr "" -#: whatsnew/3.12.rst:2411 +#: whatsnew/3.12.rst:2423 msgid ":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode`" msgstr "" -#: whatsnew/3.12.rst:2412 +#: whatsnew/3.12.rst:2424 msgid ":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode`" msgstr "" -#: whatsnew/3.12.rst:2413 +#: whatsnew/3.12.rst:2425 msgid ":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode`" msgstr "" -#: whatsnew/3.12.rst:2414 +#: whatsnew/3.12.rst:2426 msgid ":c:func:`PyUnicode_READY`: unneeded since Python 3.12" msgstr "" -#: whatsnew/3.12.rst:2415 +#: whatsnew/3.12.rst:2427 msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException`" msgstr "" -#: whatsnew/3.12.rst:2416 +#: whatsnew/3.12.rst:2428 msgid ":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1``" msgstr "" -#: whatsnew/3.12.rst:2417 +#: whatsnew/3.12.rst:2429 msgid "" ":c:member:`!PyBytesObject.ob_shash` member: call :c:func:`PyObject_Hash` " "instead" msgstr "" -#: whatsnew/3.12.rst:2419 +#: whatsnew/3.12.rst:2431 msgid ":c:member:`!PyDictObject.ma_version_tag` member" msgstr "" -#: whatsnew/3.12.rst:2420 +#: whatsnew/3.12.rst:2432 msgid "Thread Local Storage (TLS) API:" msgstr "" -#: whatsnew/3.12.rst:2422 +#: whatsnew/3.12.rst:2434 msgid ":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc`" msgstr "" -#: whatsnew/3.12.rst:2423 +#: whatsnew/3.12.rst:2435 msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free`" msgstr "" -#: whatsnew/3.12.rst:2424 +#: whatsnew/3.12.rst:2436 msgid ":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set`" msgstr "" -#: whatsnew/3.12.rst:2425 +#: whatsnew/3.12.rst:2437 msgid ":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get`" msgstr "" -#: whatsnew/3.12.rst:2426 +#: whatsnew/3.12.rst:2438 msgid ":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete`" msgstr "" -#: whatsnew/3.12.rst:2427 +#: whatsnew/3.12.rst:2439 msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7" msgstr "" -#: whatsnew/3.12.rst:2432 +#: whatsnew/3.12.rst:2444 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:2437 +#: whatsnew/3.12.rst:2449 msgid "Legacy Unicode APIs have been removed. See :pep:`623` for detail." msgstr "" -#: whatsnew/3.12.rst:2439 +#: whatsnew/3.12.rst:2451 msgid ":c:macro:`!PyUnicode_WCHAR_KIND`" msgstr "" -#: whatsnew/3.12.rst:2440 +#: whatsnew/3.12.rst:2452 msgid ":c:func:`!PyUnicode_AS_UNICODE`" msgstr "" -#: whatsnew/3.12.rst:2441 +#: whatsnew/3.12.rst:2453 msgid ":c:func:`!PyUnicode_AsUnicode`" msgstr "" -#: whatsnew/3.12.rst:2442 +#: whatsnew/3.12.rst:2454 msgid ":c:func:`!PyUnicode_AsUnicodeAndSize`" msgstr "" -#: whatsnew/3.12.rst:2443 +#: whatsnew/3.12.rst:2455 msgid ":c:func:`!PyUnicode_AS_DATA`" msgstr "" -#: whatsnew/3.12.rst:2444 +#: whatsnew/3.12.rst:2456 msgid ":c:func:`!PyUnicode_FromUnicode`" msgstr "" -#: whatsnew/3.12.rst:2445 +#: whatsnew/3.12.rst:2457 msgid ":c:func:`!PyUnicode_GET_SIZE`" msgstr "" -#: whatsnew/3.12.rst:2446 +#: whatsnew/3.12.rst:2458 msgid ":c:func:`!PyUnicode_GetSize`" msgstr "" -#: whatsnew/3.12.rst:2447 +#: whatsnew/3.12.rst:2459 msgid ":c:func:`!PyUnicode_GET_DATA_SIZE`" msgstr "" -#: whatsnew/3.12.rst:2449 +#: whatsnew/3.12.rst:2461 msgid "" "Remove the ``PyUnicode_InternImmortal()`` function macro. (Contributed by " "Victor Stinner in :gh:`85858`.)" diff --git a/whatsnew/3.2.po b/whatsnew/3.2.po index 27d575351..5e68aeee3 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-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -316,9 +316,9 @@ msgstr "" msgid "" "The :mod:`importlib.abc` module has been updated with new :term:`abstract " "base classes ` for loading bytecode files. The " -"obsolete ABCs, :class:`~importlib.abc.PyLoader` and :class:`~importlib.abc." -"PyPycLoader`, have been deprecated (instructions on how to stay Python 3.1 " -"compatible are included with the documentation)." +"obsolete ABCs, :class:`!PyLoader` and :class:`!PyPycLoader`, have been " +"deprecated (instructions on how to stay Python 3.1 compatible are included " +"with the documentation)." msgstr "" #: whatsnew/3.2.rst:353 @@ -385,7 +385,7 @@ msgid "" "code points between *U+0000* through *U+00FF* which are translatable to " "bytes using *Latin-1* encoding. These strings are used for the keys and " "values in the environment dictionary and for response headers and statuses " -"in the :func:`start_response` function. They must follow :rfc:`2616` with " +"in the :func:`!start_response` function. They must follow :rfc:`2616` with " "respect to encoding. That is, they must either be *ISO-8859-1* characters or " "use :rfc:`2047` MIME encoding." msgstr "" @@ -411,9 +411,9 @@ msgstr "" #: whatsnew/3.2.rst:418 msgid "" -"Values yielded by an application or sent using the :meth:`write` method must " -"be byte strings. The :func:`start_response` function and environ must use " -"native strings. The two cannot be mixed." +"Values yielded by an application or sent using the :meth:`!write` method " +"must be byte strings. The :func:`!start_response` function and environ must " +"use native strings. The two cannot be mixed." msgstr "" #: whatsnew/3.2.rst:422 @@ -492,11 +492,11 @@ msgstr "" msgid "" "The :func:`hasattr` function works by calling :func:`getattr` and detecting " "whether an exception is raised. This technique allows it to detect methods " -"created dynamically by :meth:`__getattr__` or :meth:`__getattribute__` which " -"would otherwise be absent from the class dictionary. Formerly, *hasattr* " -"would catch any exception, possibly masking genuine errors. Now, *hasattr* " -"has been tightened to only catch :exc:`AttributeError` and let other " -"exceptions pass through::" +"created dynamically by :meth:`~object.__getattr__` or :meth:`~object." +"__getattribute__` which would otherwise be absent from the class " +"dictionary. Formerly, *hasattr* would catch any exception, possibly masking " +"genuine errors. Now, *hasattr* has been tightened to only catch :exc:" +"`AttributeError` and let other exceptions pass through::" msgstr "" #: whatsnew/3.2.rst:519 @@ -610,10 +610,11 @@ msgstr "" msgid "" ":class:`range` objects now support *index* and *count* methods. This is part " "of an effort to make more objects fully implement the :class:`collections." -"Sequence` :term:`abstract base class`. As a result, the language will have " -"a more uniform API. In addition, :class:`range` objects now support slicing " -"and negative indices, even with values larger than :data:`sys.maxsize`. " -"This makes *range* more interoperable with lists::" +"Sequence ` :term:`abstract base class`. As a " +"result, the language will have a more uniform API. In addition, :class:" +"`range` objects now support slicing and negative indices, even with values " +"larger than :data:`sys.maxsize`. This makes *range* more interoperable with " +"lists::" msgstr "" #: whatsnew/3.2.rst:637 @@ -754,7 +755,7 @@ msgstr "" #: whatsnew/3.2.rst:723 msgid "" -"The :mod:`xml.etree.ElementTree` package and its :mod:`xml.etree." +"The :mod:`xml.etree.ElementTree` package and its :mod:`!xml.etree." "cElementTree` counterpart have been updated to version 1.3." msgstr "" @@ -814,11 +815,12 @@ msgid "Two methods have been deprecated:" msgstr "" #: whatsnew/3.2.rst:746 -msgid ":meth:`xml.etree.ElementTree.getchildren` use ``list(elem)`` instead." +msgid ":meth:`!xml.etree.ElementTree.getchildren` use ``list(elem)`` instead." msgstr "" #: whatsnew/3.2.rst:747 -msgid ":meth:`xml.etree.ElementTree.getiterator` use ``Element.iter`` instead." +msgid "" +":meth:`!xml.etree.ElementTree.getiterator` use ``Element.iter`` instead." msgstr "" #: whatsnew/3.2.rst:749 @@ -1094,7 +1096,7 @@ msgstr "" #: whatsnew/3.2.rst:1010 msgid "" "Whenever a two-digit year is used in a time tuple, the interpretation has " -"been governed by :data:`time.accept2dyear`. The default is ``True`` which " +"been governed by :data:`!time.accept2dyear`. The default is ``True`` which " "means that for a two-digit year, the century is guessed according to the " "POSIX rules governing the ``%y`` strptime format." msgstr "" @@ -1102,15 +1104,15 @@ msgstr "" #: whatsnew/3.2.rst:1015 msgid "" "Starting with Py3.2, use of the century guessing heuristic will emit a :exc:" -"`DeprecationWarning`. Instead, it is recommended that :data:`time." +"`DeprecationWarning`. Instead, it is recommended that :data:`!time." "accept2dyear` be set to ``False`` so that large date ranges can be used " "without guesswork::" msgstr "" #: whatsnew/3.2.rst:1034 msgid "" -"Several functions now have significantly expanded date ranges. When :data:" -"`time.accept2dyear` is false, the :func:`time.asctime` function will accept " +"Several functions now have significantly expanded date ranges. When :data:`!" +"time.accept2dyear` is false, the :func:`time.asctime` function will accept " "any year that fits in a C int, while the :func:`time.mktime` and :func:`time." "strftime` functions will accept the full range supported by the " "corresponding operating system functions." @@ -1210,18 +1212,19 @@ msgstr "" #: whatsnew/3.2.rst:1151 msgid "" -"When writing a :meth:`__repr__` method for a custom container, it is easy to " -"forget to handle the case where a member refers back to the container " -"itself. Python's builtin objects such as :class:`list` and :class:`set` " -"handle self-reference by displaying \"...\" in the recursive part of the " -"representation string." +"When writing a :meth:`~object.__repr__` method for a custom container, it is " +"easy to forget to handle the case where a member refers back to the " +"container itself. Python's builtin objects such as :class:`list` and :class:" +"`set` handle self-reference by displaying \"...\" in the recursive part of " +"the representation string." msgstr "" #: whatsnew/3.2.rst:1157 msgid "" -"To help write such :meth:`__repr__` methods, the :mod:`reprlib` module has a " -"new decorator, :func:`~reprlib.recursive_repr`, for detecting recursive " -"calls to :meth:`__repr__` and substituting a placeholder string instead::" +"To help write such :meth:`~object.__repr__` methods, the :mod:`reprlib` " +"module has a new decorator, :func:`~reprlib.recursive_repr`, for detecting " +"recursive calls to :meth:`!__repr__` and substituting a placeholder string " +"instead::" msgstr "" #: whatsnew/3.2.rst:1172 @@ -1389,14 +1392,13 @@ msgstr "" #: whatsnew/3.2.rst:1311 msgid "" -"An early decision to limit the inter-operability of various numeric types " -"has 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 losslessly to either a decimal or rational representation, " -"it makes sense to add them to the constructor and to support mixed-type " -"comparisons." +"An early decision to limit the interoperability of various numeric types has " +"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 " +"losslessly to either a decimal or rational representation, it makes sense to " +"add them to the constructor and to support mixed-type comparisons." msgstr "" #: whatsnew/3.2.rst:1319 @@ -1423,9 +1425,9 @@ msgstr "" #: whatsnew/3.2.rst:1338 msgid "" "Another useful change for the :mod:`decimal` module is that the :attr:" -"`Context.clamp` attribute is now public. This is useful in creating " -"contexts that correspond to the decimal interchange formats specified in " -"IEEE 754 (see :issue:`8540`)." +"`Context.clamp ` attribute is now public. This is " +"useful in creating contexts that correspond to the decimal interchange " +"formats specified in IEEE 754 (see :issue:`8540`)." msgstr "" #: whatsnew/3.2.rst:1343 @@ -1528,11 +1530,11 @@ msgstr "" #: whatsnew/3.2.rst:1431 msgid "" -"Also, the :class:`zipfile.ZipExtFile` class was reworked internally to " -"represent files stored inside an archive. The new implementation is " -"significantly faster and can be wrapped in an :class:`io.BufferedReader` " -"object for more speedups. It also solves an issue where interleaved calls " -"to *read* and *readline* gave the wrong results." +"Also, the :class:`zipfile.ZipExtFile ` class was " +"reworked internally to represent files stored inside an archive. The new " +"implementation is significantly faster and can be wrapped in an :class:`io." +"BufferedReader` object for more speedups. It also solves an issue where " +"interleaved calls to *read* and *readline* gave the wrong results." msgstr "" #: whatsnew/3.2.rst:1437 @@ -1684,7 +1686,7 @@ msgstr "" #: whatsnew/3.2.rst:1599 msgid "" -"The :attr:`sqlite3.Connection.in_transit` attribute is true if there is an " +"The :attr:`!sqlite3.Connection.in_transit` attribute is true if there is an " "active transaction for uncommitted changes." msgstr "" @@ -1754,17 +1756,18 @@ msgstr "" #: whatsnew/3.2.rst:1646 msgid "" -"A new function, :func:`ssl.match_hostname`, supports server identity " +"A new function, :func:`!ssl.match_hostname`, supports server identity " "verification for higher-level protocols by implementing the rules of HTTPS " "(from :rfc:`2818`) which are also suitable for other protocols." msgstr "" #: whatsnew/3.2.rst:1650 msgid "" -"The :func:`ssl.wrap_socket` constructor function now takes a *ciphers* " -"argument. The *ciphers* string lists the allowed encryption algorithms " -"using the format described in the `OpenSSL documentation `__." +"The :func:`ssl.wrap_socket() ` constructor " +"function now takes a *ciphers* argument. The *ciphers* string lists the " +"allowed encryption algorithms using the format described in the `OpenSSL " +"documentation `__." msgstr "" #: whatsnew/3.2.rst:1655 @@ -1937,7 +1940,7 @@ msgstr "" #: whatsnew/3.2.rst:1761 msgid "" "Experimentation at the interactive prompt is now easier because the :class:" -"`unittest.case.TestCase` class can now be instantiated without arguments:" +"`unittest.TestCase` class can now be instantiated without arguments:" msgstr "" #: whatsnew/3.2.rst:1770 @@ -1978,12 +1981,11 @@ msgstr "" #: whatsnew/3.2.rst:1799 msgid "" "For example, :meth:`~unittest.TestCase.assertRegex` is the new name for :" -"meth:`~unittest.TestCase.assertRegexpMatches` which was misnamed because the " -"test uses :func:`re.search`, not :func:`re.match`. Other methods using " -"regular expressions are now named using short form \"Regex\" in preference " -"to \"Regexp\" -- this matches the names used in other unittest " -"implementations, matches Python's old name for the :mod:`re` module, and it " -"has unambiguous camel-casing." +"meth:`!assertRegexpMatches` which was misnamed because the test uses :func:" +"`re.search`, not :func:`re.match`. Other methods using regular expressions " +"are now named using short form \"Regex\" in preference to \"Regexp\" -- this " +"matches the names used in other unittest implementations, matches Python's " +"old name for the :mod:`re` module, and it has unambiguous camel-casing." msgstr "" #: whatsnew/3.2.rst:1807 @@ -2005,7 +2007,7 @@ msgid "Preferred Name" msgstr "" #: whatsnew/3.2.rst:1815 -msgid ":meth:`assert_`" +msgid ":meth:`!assert_`" msgstr "" #: whatsnew/3.2.rst:1815 @@ -2013,7 +2015,7 @@ msgid ":meth:`.assertTrue`" msgstr "" #: whatsnew/3.2.rst:1816 -msgid ":meth:`assertEquals`" +msgid ":meth:`!assertEquals`" msgstr "" #: whatsnew/3.2.rst:1816 @@ -2021,7 +2023,7 @@ msgid ":meth:`.assertEqual`" msgstr "" #: whatsnew/3.2.rst:1817 -msgid ":meth:`assertNotEquals`" +msgid ":meth:`!assertNotEquals`" msgstr "" #: whatsnew/3.2.rst:1817 @@ -2029,7 +2031,7 @@ msgid ":meth:`.assertNotEqual`" msgstr "" #: whatsnew/3.2.rst:1818 -msgid ":meth:`assertAlmostEquals`" +msgid ":meth:`!assertAlmostEquals`" msgstr "" #: whatsnew/3.2.rst:1818 @@ -2037,7 +2039,7 @@ msgid ":meth:`.assertAlmostEqual`" msgstr "" #: whatsnew/3.2.rst:1819 -msgid ":meth:`assertNotAlmostEquals`" +msgid ":meth:`!assertNotAlmostEquals`" msgstr "" #: whatsnew/3.2.rst:1819 @@ -2056,10 +2058,10 @@ msgstr "" #: whatsnew/3.2.rst:1827 msgid "" -"The :meth:`~unittest.TestCase.assertDictContainsSubset` method was " -"deprecated because it was misimplemented with the arguments in the wrong " -"order. This created hard-to-debug optical illusions where tests like " -"``TestCase().assertDictContainsSubset({'a':1, 'b':2}, {'a':1})`` would fail." +"The :meth:`!assertDictContainsSubset` method was deprecated because it was " +"misimplemented with the arguments in the wrong order. This created hard-to-" +"debug optical illusions where tests like ``TestCase()." +"assertDictContainsSubset({'a':1, 'b':2}, {'a':1})`` would fail." msgstr "" #: whatsnew/3.2.rst:1835 @@ -2204,7 +2206,7 @@ msgstr "" #: whatsnew/3.2.rst:2000 msgid "" -"All database modules now support the :meth:`get` and :meth:`setdefault` " +"All database modules now support the :meth:`!get` and :meth:`!setdefault` " "methods." msgstr "" @@ -2337,7 +2339,8 @@ msgid "" msgstr "" #: whatsnew/3.2.rst:2121 -msgid "The :class:`Pdb` class constructor now accepts a *nosigint* argument." +msgid "" +"The :class:`~pdb.Pdb` class constructor now accepts a *nosigint* argument." msgstr "" #: whatsnew/3.2.rst:2122 @@ -2663,11 +2666,11 @@ msgstr "" #: whatsnew/3.2.rst:2397 msgid "" -"The fast-search algorithm in stringlib is now used by the :meth:`split`, :" -"meth:`rsplit`, :meth:`splitlines` and :meth:`replace` methods on :class:" -"`bytes`, :class:`bytearray` and :class:`str` objects. Likewise, the " -"algorithm is also used by :meth:`rfind`, :meth:`rindex`, :meth:`rsplit` and :" -"meth:`rpartition`." +"The fast-search algorithm in stringlib is now used by the :meth:`~str." +"split`, :meth:`~str.rsplit`, :meth:`~str.splitlines` and :meth:`~str." +"replace` methods on :class:`bytes`, :class:`bytearray` and :class:`str` " +"objects. Likewise, the algorithm is also used by :meth:`~str.rfind`, :meth:" +"`~str.rindex`, :meth:`~str.rsplit` and :meth:`~str.rpartition`." msgstr "" #: whatsnew/3.2.rst:2403 @@ -2688,11 +2691,11 @@ msgstr "" msgid "" "There were several other minor optimizations. Set differencing now runs " "faster when one operand is much larger than the other (patch by Andress " -"Bennetts in :issue:`8685`). The :meth:`array.repeat` method has a faster " -"implementation (:issue:`1569291` by Alexander Belopolsky). The :class:" -"`BaseHTTPRequestHandler` has more efficient buffering (:issue:`3709` by " -"Andrew Schaaf). The :func:`operator.attrgetter` function has been sped-up (:" -"issue:`10160` by Christos Georgiou). And :class:`~configparser." +"Bennetts in :issue:`8685`). The :meth:`!array.repeat` method has a faster " +"implementation (:issue:`1569291` by Alexander Belopolsky). The :class:`~http." +"server.BaseHTTPRequestHandler` has more efficient buffering (:issue:`3709` " +"by Andrew Schaaf). The :func:`operator.attrgetter` function has been sped-" +"up (:issue:`10160` by Christos Georgiou). And :class:`~configparser." "ConfigParser` loads multi-line arguments a bit faster (:issue:`7113` by " "Łukasz Langa)." msgstr "" @@ -2940,14 +2943,14 @@ msgstr "" #: whatsnew/3.2.rst:2565 msgid "" -"A new macro :c:macro:`Py_VA_COPY` copies the state of the variable argument " +"A new macro :c:macro:`!Py_VA_COPY` copies the state of the variable argument " "list. It is equivalent to C99 *va_copy* but available on all Python " "platforms (:issue:`2443`)." msgstr "" #: whatsnew/3.2.rst:2569 msgid "" -"A new C API function :c:func:`PySys_SetArgvEx` allows an embedded " +"A new C API function :c:func:`!PySys_SetArgvEx` allows an embedded " "interpreter to set :data:`sys.argv` without also modifying :data:`sys.path` " "(:issue:`5753`)." msgstr "" @@ -3088,24 +3091,25 @@ msgstr "" #: whatsnew/3.2.rst:2653 msgid "" -"The :meth:`array.tostring` and :meth:`array.fromstring` have been renamed " -"to :meth:`array.tobytes` and :meth:`array.frombytes` for clarity. The old " -"names have been deprecated. (See :issue:`8990`.)" +"The :meth:`!array.tostring` and :meth:`!array.fromstring` have been renamed " +"to :meth:`array.tobytes() ` and :meth:`array." +"frombytes() ` for clarity. The old names have been " +"deprecated. (See :issue:`8990`.)" msgstr "" -#: whatsnew/3.2.rst:2657 +#: whatsnew/3.2.rst:2658 msgid "``PyArg_Parse*()`` functions:" msgstr "" -#: whatsnew/3.2.rst:2659 +#: whatsnew/3.2.rst:2660 msgid "\"t#\" format has been removed: use \"s#\" or \"s*\" instead" msgstr "" -#: whatsnew/3.2.rst:2660 +#: whatsnew/3.2.rst:2661 msgid "\"w\" and \"w#\" formats has been removed: use \"w*\" instead" msgstr "" -#: whatsnew/3.2.rst:2662 +#: whatsnew/3.2.rst:2663 msgid "" "The :c:type:`!PyCObject` type, deprecated in 3.1, has been removed. To wrap " "opaque C pointers in Python objects, the :c:type:`PyCapsule` API should be " @@ -3113,13 +3117,13 @@ msgid "" "safety information and a less complicated signature for calling a destructor." msgstr "" -#: whatsnew/3.2.rst:2667 +#: whatsnew/3.2.rst:2668 msgid "" -"The :func:`sys.setfilesystemencoding` function was removed because it had a " +"The :func:`!sys.setfilesystemencoding` function was removed because it had a " "flawed design." msgstr "" -#: whatsnew/3.2.rst:2670 +#: whatsnew/3.2.rst:2671 msgid "" "The :func:`random.seed` function and method now salt string seeds with an " "sha512 hash function. To access the previous version of *seed* in order to " @@ -3127,36 +3131,37 @@ msgid "" "seed(s, version=1)``." msgstr "" -#: whatsnew/3.2.rst:2675 +#: whatsnew/3.2.rst:2676 msgid "" -"The previously deprecated :func:`string.maketrans` function has been removed " -"in favor of the static methods :meth:`bytes.maketrans` and :meth:`bytearray." -"maketrans`. This change solves the confusion around which types were " -"supported by the :mod:`string` module. Now, :class:`str`, :class:`bytes`, " -"and :class:`bytearray` each have their own **maketrans** and **translate** " -"methods with intermediate translation tables of the appropriate type." +"The previously deprecated :func:`!string.maketrans` function has been " +"removed in favor of the static methods :meth:`bytes.maketrans` and :meth:" +"`bytearray.maketrans`. This change solves the confusion around which types " +"were supported by the :mod:`string` module. Now, :class:`str`, :class:" +"`bytes`, and :class:`bytearray` each have their own **maketrans** and " +"**translate** methods with intermediate translation tables of the " +"appropriate type." msgstr "" -#: whatsnew/3.2.rst:2683 +#: whatsnew/3.2.rst:2684 msgid "(Contributed by Georg Brandl; :issue:`5675`.)" msgstr "" -#: whatsnew/3.2.rst:2685 +#: whatsnew/3.2.rst:2686 msgid "" -"The previously deprecated :func:`contextlib.nested` function has been " +"The previously deprecated :func:`!contextlib.nested` function has been " "removed in favor of a plain :keyword:`with` statement which can accept " "multiple context managers. The latter technique is faster (because it is " "built-in), and it does a better job finalizing multiple context managers " "when one of them raises an exception::" msgstr "" -#: whatsnew/3.2.rst:2696 +#: whatsnew/3.2.rst:2697 msgid "" "(Contributed by Georg Brandl and Mattias Brändström; `appspot issue 53094 " "`_.)" msgstr "" -#: whatsnew/3.2.rst:2699 +#: whatsnew/3.2.rst:2700 msgid "" ":func:`struct.pack` now only allows bytes for the ``s`` string pack code. " "Formerly, it would accept text arguments and implicitly encode them to bytes " @@ -3165,32 +3170,32 @@ msgid "" "writing to fixed length segment of a structure." msgstr "" -#: whatsnew/3.2.rst:2705 +#: whatsnew/3.2.rst:2706 msgid "" "Code such as ``struct.pack('<6sHHBBB', 'GIF87a', x, y)`` should be rewritten " "with to use bytes instead of text, ``struct.pack('<6sHHBBB', b'GIF87a', x, " "y)``." msgstr "" -#: whatsnew/3.2.rst:2708 +#: whatsnew/3.2.rst:2709 msgid "" "(Discovered by David Beazley and fixed by Victor Stinner; :issue:`10783`.)" msgstr "" -#: whatsnew/3.2.rst:2710 +#: whatsnew/3.2.rst:2711 msgid "" "The :class:`xml.etree.ElementTree` class now raises an :exc:`xml.etree." "ElementTree.ParseError` when a parse fails. Previously it raised an :exc:" "`xml.parsers.expat.ExpatError`." msgstr "" -#: whatsnew/3.2.rst:2714 +#: whatsnew/3.2.rst:2715 msgid "" "The new, longer :func:`str` value on floats may break doctests which rely on " "the old output format." msgstr "" -#: whatsnew/3.2.rst:2717 +#: whatsnew/3.2.rst:2718 msgid "" "In :class:`subprocess.Popen`, the default value for *close_fds* is now " "``True`` under Unix; under Windows, it is ``True`` if the three standard " @@ -3199,28 +3204,28 @@ msgid "" "race conditions when open file descriptors would leak into the child process." msgstr "" -#: whatsnew/3.2.rst:2724 +#: whatsnew/3.2.rst:2725 msgid "" "Support for legacy HTTP 0.9 has been removed from :mod:`urllib.request` and :" "mod:`http.client`. Such support is still present on the server side (in :" "mod:`http.server`)." msgstr "" -#: whatsnew/3.2.rst:2728 +#: whatsnew/3.2.rst:2729 msgid "(Contributed by Antoine Pitrou, :issue:`10711`.)" msgstr "" -#: whatsnew/3.2.rst:2730 +#: whatsnew/3.2.rst:2731 msgid "" "SSL sockets in timeout mode now raise :exc:`socket.timeout` when a timeout " "occurs, rather than a generic :exc:`~ssl.SSLError`." msgstr "" -#: whatsnew/3.2.rst:2733 +#: whatsnew/3.2.rst:2734 msgid "(Contributed by Antoine Pitrou, :issue:`10272`.)" msgstr "" -#: whatsnew/3.2.rst:2735 +#: whatsnew/3.2.rst:2736 msgid "" "The misleading functions :c:func:`!PyEval_AcquireLock` and :c:func:`!" "PyEval_ReleaseLock` have been officially deprecated. The thread-state aware " @@ -3228,18 +3233,18 @@ msgid "" "`PyEval_RestoreThread`) should be used instead." msgstr "" -#: whatsnew/3.2.rst:2740 +#: whatsnew/3.2.rst:2741 msgid "" "Due to security risks, :func:`!asyncore.handle_accept` has been deprecated, " "and a new function, :func:`!asyncore.handle_accepted`, was added to replace " "it." msgstr "" -#: whatsnew/3.2.rst:2743 +#: whatsnew/3.2.rst:2744 msgid "(Contributed by Giampaolo Rodola in :issue:`6706`.)" msgstr "" -#: whatsnew/3.2.rst:2745 +#: whatsnew/3.2.rst:2746 msgid "" "Due to the new :term:`GIL` implementation, :c:func:`!PyEval_InitThreads` " "cannot be called before :c:func:`Py_Initialize` anymore." diff --git a/whatsnew/3.3.po b/whatsnew/3.3.po index 6050a698c..ca6bc3dbd 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-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -249,7 +249,7 @@ msgstr "" #: whatsnew/3.3.rst:176 msgid "" "Arbitrary slicing of any 1-D arrays type is supported. For example, it is " -"now possible to reverse a memoryview in O(1) by using a negative step." +"now possible to reverse a memoryview in *O*\\ (1) by using a negative step." msgstr "" #: whatsnew/3.3.rst:1133 diff --git a/whatsnew/3.5.po b/whatsnew/3.5.po index 2754de223..3e04c3160 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-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -3123,7 +3123,7 @@ msgstr "" #: whatsnew/3.5.rst:2420 msgid "" "The deprecated \"strict\" mode and argument of :class:`~html.parser." -"HTMLParser`, :meth:`HTMLParser.error`, and the :exc:`HTMLParserError` " +"HTMLParser`, :meth:`!HTMLParser.error`, and the :exc:`!HTMLParserError` " "exception have been removed. (Contributed by Ezio Melotti in :issue:" "`15114`.) The *convert_charrefs* argument of :class:`~html.parser." "HTMLParser` is now ``True`` by default. (Contributed by Berker Peksag in :" diff --git a/whatsnew/3.6.po b/whatsnew/3.6.po index 45a09d1d0..755444ee9 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-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1141,7 +1141,7 @@ msgid "" "Hettinger in :issue:`17941`.)" msgstr "" -#: whatsnew/3.6.rst:2282 +#: whatsnew/3.6.rst:2295 msgid "" "The *verbose* and *rename* arguments for :func:`~collections.namedtuple` are " "now keyword-only. (Contributed by Raymond Hettinger in :issue:`25628`.)" @@ -1232,7 +1232,7 @@ msgstr "" msgid "(Contributed by Stefan Krah amd Mark Dickinson in :issue:`25928`.)" msgstr "" -#: whatsnew/3.6.rst:1986 +#: whatsnew/3.6.rst:1990 msgid "distutils" msgstr "" @@ -1502,7 +1502,7 @@ msgid "" "button. (Contributed by Tal Einat in :issue:`1529353`.)" msgstr "" -#: whatsnew/3.6.rst:2003 +#: whatsnew/3.6.rst:2007 msgid "importlib" msgstr "" @@ -1597,7 +1597,7 @@ msgid "" "issue:`6766`.)" msgstr "" -#: whatsnew/3.6.rst:2017 +#: whatsnew/3.6.rst:2021 msgid "os" msgstr "" @@ -1702,7 +1702,7 @@ msgid "" "by Raymond Hettinger in :issue:`18844`.)" msgstr "" -#: whatsnew/3.6.rst:2025 +#: whatsnew/3.6.rst:2029 msgid "re" msgstr "" @@ -1844,7 +1844,7 @@ msgid "" "(Contributed by Martin Panter in :issue:`26721`.)" msgstr "" -#: whatsnew/3.6.rst:2033 +#: whatsnew/3.6.rst:2037 msgid "ssl" msgstr "" @@ -1893,32 +1893,39 @@ msgid "" "were added. (Contributed by Christian Heimes in :issue:`28085`.)" msgstr "" -#: whatsnew/3.6.rst:1477 +#: whatsnew/3.6.rst:1475 +msgid "" +"Added :attr:`ssl.SSLContext.post_handshake_auth` to enable and :meth:`ssl." +"SSLSocket.verify_client_post_handshake` to initiate TLS 1.3 post-handshake " +"authentication. (Contributed by Christian Heimes in :gh:`78851`.)" +msgstr "" + +#: whatsnew/3.6.rst:1481 msgid "statistics" msgstr "" -#: whatsnew/3.6.rst:1479 +#: whatsnew/3.6.rst:1483 msgid "" "A new :func:`~statistics.harmonic_mean` function has been added. " "(Contributed by Steven D'Aprano in :issue:`27181`.)" msgstr "" -#: whatsnew/3.6.rst:1484 +#: whatsnew/3.6.rst:1488 msgid "struct" msgstr "" -#: whatsnew/3.6.rst:1486 +#: whatsnew/3.6.rst:1490 msgid "" ":mod:`struct` now supports IEEE 754 half-precision floats via the ``'e'`` " "format specifier. (Contributed by Eli Stevens, Mark Dickinson in :issue:" "`11734`.)" msgstr "" -#: whatsnew/3.6.rst:1492 +#: whatsnew/3.6.rst:1496 msgid "subprocess" msgstr "" -#: whatsnew/3.6.rst:1494 +#: whatsnew/3.6.rst:1498 msgid "" ":class:`subprocess.Popen` destructor now emits a :exc:`ResourceWarning` " "warning if the child process is still running. Use the context manager " @@ -1927,7 +1934,7 @@ msgid "" "(Contributed by Victor Stinner in :issue:`26741`.)" msgstr "" -#: whatsnew/3.6.rst:1500 +#: whatsnew/3.6.rst:1504 msgid "" "The :class:`subprocess.Popen` constructor and all functions that pass " "arguments through to it now accept *encoding* and *errors* arguments. " @@ -1935,18 +1942,18 @@ msgid "" "and *stderr* streams. (Contributed by Steve Dower in :issue:`6135`.)" msgstr "" -#: whatsnew/3.6.rst:1507 +#: whatsnew/3.6.rst:1511 msgid "sys" msgstr "" -#: whatsnew/3.6.rst:1509 +#: whatsnew/3.6.rst:1513 msgid "" "The new :func:`~sys.getfilesystemencodeerrors` function returns the name of " "the error mode used to convert between Unicode filenames and bytes " "filenames. (Contributed by Steve Dower in :issue:`27781`.)" msgstr "" -#: whatsnew/3.6.rst:1513 +#: whatsnew/3.6.rst:1517 msgid "" "On Windows the return value of the :func:`~sys.getwindowsversion` function " "now includes the *platform_version* field which contains the accurate major " @@ -1955,31 +1962,31 @@ msgid "" "by Steve Dower in :issue:`27932`.)" msgstr "" -#: whatsnew/3.6.rst:1521 +#: whatsnew/3.6.rst:1525 msgid "telnetlib" msgstr "" -#: whatsnew/3.6.rst:1523 +#: whatsnew/3.6.rst:1527 msgid "" ":class:`~telnetlib.Telnet` is now a context manager (contributed by Stéphane " "Wirtel in :issue:`25485`)." msgstr "" -#: whatsnew/3.6.rst:1528 +#: whatsnew/3.6.rst:1532 msgid "time" msgstr "" -#: whatsnew/3.6.rst:1530 +#: whatsnew/3.6.rst:1534 msgid "" "The :class:`~time.struct_time` attributes :attr:`tm_gmtoff` and :attr:" "`tm_zone` are now available on all platforms." msgstr "" -#: whatsnew/3.6.rst:1535 +#: whatsnew/3.6.rst:1539 msgid "timeit" msgstr "" -#: whatsnew/3.6.rst:1537 +#: whatsnew/3.6.rst:1541 msgid "" "The new :meth:`Timer.autorange() ` convenience " "method has been added to call :meth:`Timer.timeit() ` " @@ -1987,17 +1994,17 @@ msgid "" "milliseconds. (Contributed by Steven D'Aprano in :issue:`6422`.)" msgstr "" -#: whatsnew/3.6.rst:1542 +#: whatsnew/3.6.rst:1546 msgid "" ":mod:`timeit` now warns when there is substantial (4x) variance between best " "and worst times. (Contributed by Serhiy Storchaka in :issue:`23552`.)" msgstr "" -#: whatsnew/3.6.rst:2050 +#: whatsnew/3.6.rst:2054 msgid "tkinter" msgstr "" -#: whatsnew/3.6.rst:1550 +#: whatsnew/3.6.rst:1554 msgid "" "Added methods :meth:`~tkinter.Variable.trace_add`, :meth:`~tkinter.Variable." "trace_remove` and :meth:`~tkinter.Variable.trace_info` in the :class:" @@ -2008,52 +2015,52 @@ msgid "" "Serhiy Storchaka in :issue:`22115`)." msgstr "" -#: whatsnew/3.6.rst:1563 +#: whatsnew/3.6.rst:1567 msgid "traceback" msgstr "" -#: whatsnew/3.6.rst:1565 +#: whatsnew/3.6.rst:1569 msgid "" "Both the traceback module and the interpreter's builtin exception display " "now abbreviate long sequences of repeated lines in tracebacks as shown in " "the following example::" msgstr "" -#: whatsnew/3.6.rst:1580 +#: whatsnew/3.6.rst:1584 msgid "(Contributed by Emanuel Barry in :issue:`26823`.)" msgstr "" -#: whatsnew/3.6.rst:1584 +#: whatsnew/3.6.rst:1588 msgid "tracemalloc" msgstr "" -#: whatsnew/3.6.rst:1586 +#: whatsnew/3.6.rst:1590 msgid "" "The :mod:`tracemalloc` module now supports tracing memory allocations in " "multiple different address spaces." msgstr "" -#: whatsnew/3.6.rst:1589 +#: whatsnew/3.6.rst:1593 msgid "" "The new :class:`~tracemalloc.DomainFilter` filter class has been added to " "filter block traces by their address space (domain)." msgstr "" -#: whatsnew/3.6.rst:1592 +#: whatsnew/3.6.rst:1596 msgid "(Contributed by Victor Stinner in :issue:`26588`.)" msgstr "" -#: whatsnew/3.6.rst:1598 +#: whatsnew/3.6.rst:1602 msgid "typing" msgstr "" -#: whatsnew/3.6.rst:1600 +#: whatsnew/3.6.rst:1604 msgid "" "Since the :mod:`typing` module is :term:`provisional `, all " "changes introduced in Python 3.6 have also been backported to Python 3.5.x." msgstr "" -#: whatsnew/3.6.rst:1604 +#: whatsnew/3.6.rst:1608 msgid "" "The :mod:`typing` module has a much improved support for generic type " "aliases. For example ``Dict[str, Tuple[S, T]]`` is now a valid type " @@ -2061,21 +2068,21 @@ msgid "" "com/python/typing/pull/195>`_.)" msgstr "" -#: whatsnew/3.6.rst:1610 +#: whatsnew/3.6.rst:1614 msgid "" "The :class:`typing.ContextManager` class has been added for representing :" "class:`contextlib.AbstractContextManager`. (Contributed by Brett Cannon in :" "issue:`25609`.)" msgstr "" -#: whatsnew/3.6.rst:1614 +#: whatsnew/3.6.rst:1618 msgid "" "The :class:`typing.Collection` class has been added for representing :class:" "`collections.abc.Collection`. (Contributed by Ivan Levkivskyi in :issue:" "`27598`.)" msgstr "" -#: whatsnew/3.6.rst:1618 +#: whatsnew/3.6.rst:1622 msgid "" "The :const:`typing.ClassVar` type construct has been added to mark class " "variables. As introduced in :pep:`526`, a variable annotation wrapped in " @@ -2085,7 +2092,7 @@ msgid "" "pull/280>`_.)" msgstr "" -#: whatsnew/3.6.rst:1625 +#: whatsnew/3.6.rst:1629 msgid "" "A new :const:`~typing.TYPE_CHECKING` constant that is assumed to be ``True`` " "by the static type checkers, but is ``False`` at runtime. (Contributed by " @@ -2093,38 +2100,38 @@ msgid "" "issues/230>`_.)" msgstr "" -#: whatsnew/3.6.rst:1630 +#: whatsnew/3.6.rst:1634 msgid "" "A new :func:`~typing.NewType` helper function has been added to create " "lightweight distinct types for annotations::" msgstr "" -#: whatsnew/3.6.rst:1638 +#: whatsnew/3.6.rst:1642 msgid "" "The static type checker will treat the new type as if it were a subclass of " "the original type. (Contributed by Ivan Levkivskyi in `Github #189 `_.)" msgstr "" -#: whatsnew/3.6.rst:1644 +#: whatsnew/3.6.rst:1648 msgid "unicodedata" msgstr "" -#: whatsnew/3.6.rst:1646 +#: whatsnew/3.6.rst:1650 msgid "" "The :mod:`unicodedata` module now uses data from `Unicode 9.0.0 `_. (Contributed by Benjamin Peterson.)" msgstr "" -#: whatsnew/3.6.rst:1652 +#: whatsnew/3.6.rst:1656 msgid "unittest.mock" msgstr "" -#: whatsnew/3.6.rst:1654 +#: whatsnew/3.6.rst:1658 msgid "The :class:`~unittest.mock.Mock` class has the following improvements:" msgstr "" -#: whatsnew/3.6.rst:1656 +#: whatsnew/3.6.rst:1660 msgid "" "Two new methods, :meth:`Mock.assert_called() ` and :meth:`Mock.assert_called_once() ` method now has " "two optional keyword only arguments: *return_value* and *side_effect*. " "(Contributed by Kushal Das in :issue:`21271`.)" msgstr "" -#: whatsnew/3.6.rst:1669 +#: whatsnew/3.6.rst:1673 msgid "urllib.request" msgstr "" -#: whatsnew/3.6.rst:1671 +#: whatsnew/3.6.rst:1675 msgid "" "If a HTTP request has a file or iterable body (other than a bytes object) " "but no ``Content-Length`` header, rather than throwing an error, :class:" @@ -2151,33 +2158,33 @@ msgid "" "encoding. (Contributed by Demian Brecht and Rolf Krahl in :issue:`12319`.)" msgstr "" -#: whatsnew/3.6.rst:1679 +#: whatsnew/3.6.rst:1683 msgid "urllib.robotparser" msgstr "" -#: whatsnew/3.6.rst:1681 +#: whatsnew/3.6.rst:1685 msgid "" ":class:`~urllib.robotparser.RobotFileParser` now supports the ``Crawl-" "delay`` and ``Request-rate`` extensions. (Contributed by Nikolay Bogoychev " "in :issue:`16099`.)" msgstr "" -#: whatsnew/3.6.rst:2058 +#: whatsnew/3.6.rst:2062 msgid "venv" msgstr "" -#: whatsnew/3.6.rst:1689 +#: whatsnew/3.6.rst:1693 msgid "" ":mod:`venv` accepts a new parameter ``--prompt``. This parameter provides an " "alternative prefix for the virtual environment. (Proposed by Łukasz " "Balcerzak and ported to 3.6 by Stéphane Wirtel in :issue:`22829`.)" msgstr "" -#: whatsnew/3.6.rst:1695 +#: whatsnew/3.6.rst:1699 msgid "warnings" msgstr "" -#: whatsnew/3.6.rst:1697 +#: whatsnew/3.6.rst:1701 msgid "" "A new optional *source* parameter has been added to the :func:`warnings." "warn_explicit` function: the destroyed object which emitted a :exc:" @@ -2186,65 +2193,65 @@ msgid "" "and :issue:`26567`)." msgstr "" -#: whatsnew/3.6.rst:1703 +#: whatsnew/3.6.rst:1707 msgid "" "When a :exc:`ResourceWarning` warning is logged, the :mod:`tracemalloc` " "module is now used to try to retrieve the traceback where the destroyed " "object was allocated." msgstr "" -#: whatsnew/3.6.rst:1706 +#: whatsnew/3.6.rst:1710 msgid "Example with the script ``example.py``::" msgstr "" -#: whatsnew/3.6.rst:1716 +#: whatsnew/3.6.rst:1720 msgid "Output of the command ``python3.6 -Wd -X tracemalloc=5 example.py``::" msgstr "" -#: whatsnew/3.6.rst:1726 +#: whatsnew/3.6.rst:1730 msgid "" "The \"Object allocated at\" traceback is new and is only displayed if :mod:" "`tracemalloc` is tracing Python memory allocations and if the :mod:" "`warnings` module was already imported." msgstr "" -#: whatsnew/3.6.rst:1732 +#: whatsnew/3.6.rst:1736 msgid "winreg" msgstr "" -#: whatsnew/3.6.rst:1734 +#: whatsnew/3.6.rst:1738 msgid "" "Added the 64-bit integer type :data:`REG_QWORD `. " "(Contributed by Clement Rouault in :issue:`23026`.)" msgstr "" -#: whatsnew/3.6.rst:1739 +#: whatsnew/3.6.rst:1743 msgid "winsound" msgstr "" -#: whatsnew/3.6.rst:1741 +#: whatsnew/3.6.rst:1745 msgid "" "Allowed keyword arguments to be passed to :func:`Beep `, :" "func:`MessageBeep `, and :func:`PlaySound ` (:issue:`27982`)." msgstr "" -#: whatsnew/3.6.rst:1747 +#: whatsnew/3.6.rst:1751 msgid "xmlrpc.client" msgstr "" -#: whatsnew/3.6.rst:1749 +#: whatsnew/3.6.rst:1753 msgid "" "The :mod:`xmlrpc.client` module now supports unmarshalling additional data " "types used by the Apache XML-RPC implementation for numerics and ``None``. " "(Contributed by Serhiy Storchaka in :issue:`26885`.)" msgstr "" -#: whatsnew/3.6.rst:1756 +#: whatsnew/3.6.rst:1760 msgid "zipfile" msgstr "" -#: whatsnew/3.6.rst:1758 +#: whatsnew/3.6.rst:1762 msgid "" "A new :meth:`ZipInfo.from_file() ` class method " "allows making a :class:`~zipfile.ZipInfo` instance from a filesystem file. A " @@ -2253,29 +2260,29 @@ msgid "" "(Contributed by Thomas Kluyver in :issue:`26039`.)" msgstr "" -#: whatsnew/3.6.rst:1764 +#: whatsnew/3.6.rst:1768 msgid "" "The :meth:`ZipFile.open() ` method can now be used to " "write data into a ZIP file, as well as for extracting data. (Contributed by " "Thomas Kluyver in :issue:`26039`.)" msgstr "" -#: whatsnew/3.6.rst:1770 +#: whatsnew/3.6.rst:1774 msgid "zlib" msgstr "" -#: whatsnew/3.6.rst:1772 +#: whatsnew/3.6.rst:1776 msgid "" "The :func:`~zlib.compress` and :func:`~zlib.decompress` functions now accept " "keyword arguments. (Contributed by Aviv Palivoda in :issue:`26243` and Xiang " "Zhang in :issue:`16764` respectively.)" msgstr "" -#: whatsnew/3.6.rst:1779 +#: whatsnew/3.6.rst:1783 msgid "Optimizations" msgstr "" -#: whatsnew/3.6.rst:1781 +#: whatsnew/3.6.rst:1785 msgid "" "The Python interpreter now uses a 16-bit wordcode instead of bytecode which " "made a number of opcode optimizations possible. (Contributed by Demur Rumed " @@ -2283,79 +2290,79 @@ msgid "" "`26647` and :issue:`28050`.)" msgstr "" -#: whatsnew/3.6.rst:1786 +#: whatsnew/3.6.rst:1790 msgid "" "The :class:`asyncio.Future` class now has an optimized C implementation. " "(Contributed by Yury Selivanov and INADA Naoki in :issue:`26081`.)" msgstr "" -#: whatsnew/3.6.rst:1789 +#: whatsnew/3.6.rst:1793 msgid "" "The :class:`asyncio.Task` class now has an optimized C implementation. " "(Contributed by Yury Selivanov in :issue:`28544`.)" msgstr "" -#: whatsnew/3.6.rst:1792 +#: whatsnew/3.6.rst:1796 msgid "" "Various implementation improvements in the :mod:`typing` module (such as " "caching of generic types) allow up to 30 times performance improvements and " "reduced memory footprint." msgstr "" -#: whatsnew/3.6.rst:1796 +#: whatsnew/3.6.rst:1800 msgid "" "The ASCII decoder is now up to 60 times as fast for error handlers " "``surrogateescape``, ``ignore`` and ``replace`` (Contributed by Victor " "Stinner in :issue:`24870`)." msgstr "" -#: whatsnew/3.6.rst:1800 +#: whatsnew/3.6.rst:1804 msgid "" "The ASCII and the Latin1 encoders are now up to 3 times as fast for the " "error handler ``surrogateescape`` (Contributed by Victor Stinner in :issue:" "`25227`)." msgstr "" -#: whatsnew/3.6.rst:1804 +#: whatsnew/3.6.rst:1808 msgid "" "The UTF-8 encoder is now up to 75 times as fast for error handlers " "``ignore``, ``replace``, ``surrogateescape``, ``surrogatepass`` (Contributed " "by Victor Stinner in :issue:`25267`)." msgstr "" -#: whatsnew/3.6.rst:1808 +#: whatsnew/3.6.rst:1812 msgid "" "The UTF-8 decoder is now up to 15 times as fast for error handlers " "``ignore``, ``replace`` and ``surrogateescape`` (Contributed by Victor " "Stinner in :issue:`25301`)." msgstr "" -#: whatsnew/3.6.rst:1812 +#: whatsnew/3.6.rst:1816 msgid "" "``bytes % args`` is now up to 2 times faster. (Contributed by Victor Stinner " "in :issue:`25349`)." msgstr "" -#: whatsnew/3.6.rst:1815 +#: whatsnew/3.6.rst:1819 msgid "" "``bytearray % args`` is now between 2.5 and 5 times faster. (Contributed by " "Victor Stinner in :issue:`25399`)." msgstr "" -#: whatsnew/3.6.rst:1818 +#: whatsnew/3.6.rst:1822 msgid "" "Optimize :meth:`bytes.fromhex` and :meth:`bytearray.fromhex`: they are now " "between 2x and 3.5x faster. (Contributed by Victor Stinner in :issue:" "`25401`)." msgstr "" -#: whatsnew/3.6.rst:1821 +#: whatsnew/3.6.rst:1825 msgid "" "Optimize ``bytes.replace(b'', b'.')`` and ``bytearray.replace(b'', b'.')``: " "up to 80% faster. (Contributed by Josh Snider in :issue:`26574`)." msgstr "" -#: whatsnew/3.6.rst:1824 +#: whatsnew/3.6.rst:1828 msgid "" "Allocator functions of the :c:func:`PyMem_Malloc` domain (:c:macro:" "`PYMEM_DOMAIN_MEM`) now use the :ref:`pymalloc memory allocator ` " @@ -2365,14 +2372,14 @@ msgid "" "(Contributed by Victor Stinner in :issue:`26249`)." msgstr "" -#: whatsnew/3.6.rst:1831 +#: whatsnew/3.6.rst:1835 msgid "" ":func:`pickle.load` and :func:`pickle.loads` are now up to 10% faster when " "deserializing many small objects (Contributed by Victor Stinner in :issue:" "`27056`)." msgstr "" -#: whatsnew/3.6.rst:1835 +#: whatsnew/3.6.rst:1839 msgid "" "Passing :term:`keyword arguments ` to a function has an " "overhead in comparison with passing :term:`positional arguments ` must now be held when allocator " "functions of :c:macro:`PYMEM_DOMAIN_OBJ` (ex: :c:func:`PyObject_Malloc`) " @@ -2445,72 +2452,72 @@ msgid "" "called." msgstr "" -#: whatsnew/3.6.rst:1880 +#: whatsnew/3.6.rst:1884 msgid "" "New :c:func:`Py_FinalizeEx` API which indicates if flushing buffered data " "failed. (Contributed by Martin Panter in :issue:`5319`.)" msgstr "" -#: whatsnew/3.6.rst:1884 +#: whatsnew/3.6.rst:1888 msgid "" ":c:func:`PyArg_ParseTupleAndKeywords` now supports :ref:`positional-only " "parameters `. Positional-only parameters are " "defined by empty names. (Contributed by Serhiy Storchaka in :issue:`26282`)." msgstr "" -#: whatsnew/3.6.rst:1889 +#: whatsnew/3.6.rst:1893 msgid "" "``PyTraceback_Print`` method now abbreviates long sequences of repeated " "lines as ``\"[Previous line repeated {count} more times]\"``. (Contributed " "by Emanuel Barry in :issue:`26823`.)" msgstr "" -#: whatsnew/3.6.rst:1893 +#: whatsnew/3.6.rst:1897 msgid "" "The new :c:func:`PyErr_SetImportErrorSubclass` function allows for " "specifying a subclass of :exc:`ImportError` to raise. (Contributed by Eric " "Snow in :issue:`15767`.)" msgstr "" -#: whatsnew/3.6.rst:1897 +#: whatsnew/3.6.rst:1901 msgid "" "The new :c:func:`PyErr_ResourceWarning` function can be used to generate a :" "exc:`ResourceWarning` providing the source of the resource allocation. " "(Contributed by Victor Stinner in :issue:`26567`.)" msgstr "" -#: whatsnew/3.6.rst:1901 +#: whatsnew/3.6.rst:1905 msgid "" "The new :c:func:`PyOS_FSPath` function returns the file system " "representation of a :term:`path-like object`. (Contributed by Brett Cannon " "in :issue:`27186`.)" msgstr "" -#: whatsnew/3.6.rst:1905 +#: whatsnew/3.6.rst:1909 msgid "" "The :c:func:`PyUnicode_FSConverter` and :c:func:`PyUnicode_FSDecoder` " "functions will now accept :term:`path-like objects `." msgstr "" -#: whatsnew/3.6.rst:1910 +#: whatsnew/3.6.rst:1914 msgid "Other Improvements" msgstr "" -#: whatsnew/3.6.rst:1912 +#: whatsnew/3.6.rst:1916 msgid "" "When :option:`--version` (short form: :option:`-V`) is supplied twice, " "Python prints :data:`sys.version` for detailed information." msgstr "" -#: whatsnew/3.6.rst:1923 +#: whatsnew/3.6.rst:1927 msgid "Deprecated" msgstr "" -#: whatsnew/3.6.rst:1926 +#: whatsnew/3.6.rst:1930 msgid "New Keywords" msgstr "" -#: whatsnew/3.6.rst:1928 +#: whatsnew/3.6.rst:1932 msgid "" "``async`` and ``await`` are not recommended to be used as variable, class, " "function or module names. Introduced by :pep:`492` in Python 3.5, they will " @@ -2518,18 +2525,18 @@ msgid "" "``async`` or ``await`` as names will generate a :exc:`DeprecationWarning`." msgstr "" -#: whatsnew/3.6.rst:1935 +#: whatsnew/3.6.rst:1939 msgid "Deprecated Python behavior" msgstr "" -#: whatsnew/3.6.rst:1937 +#: whatsnew/3.6.rst:1941 msgid "" "Raising the :exc:`StopIteration` exception inside a generator will now " "generate a :exc:`DeprecationWarning`, and will trigger a :exc:`RuntimeError` " "in Python 3.7. See :ref:`whatsnew-pep-479` for details." msgstr "" -#: whatsnew/3.6.rst:1941 +#: whatsnew/3.6.rst:1945 msgid "" "The :meth:`__aiter__` method is now expected to return an asynchronous " "iterator directly instead of returning an awaitable as previously. Doing the " @@ -2538,7 +2545,7 @@ msgid "" "`27243`.)" msgstr "" -#: whatsnew/3.6.rst:1947 +#: whatsnew/3.6.rst:1951 msgid "" "A backslash-character pair that is not a valid escape sequence now generates " "a :exc:`DeprecationWarning`. Although this will eventually become a :exc:" @@ -2546,7 +2553,7 @@ msgid "" "Emanuel Barry in :issue:`27364`.)" msgstr "" -#: whatsnew/3.6.rst:1952 +#: whatsnew/3.6.rst:1956 msgid "" "When performing a relative import, falling back on ``__name__`` and " "``__path__`` from the calling module when ``__spec__`` or ``__package__`` " @@ -2554,35 +2561,35 @@ msgid "" "Ames in :issue:`25791`.)" msgstr "" -#: whatsnew/3.6.rst:1959 +#: whatsnew/3.6.rst:1963 msgid "Deprecated Python modules, functions and methods" msgstr "" -#: whatsnew/3.6.rst:1962 +#: whatsnew/3.6.rst:1966 msgid "asynchat" msgstr "" -#: whatsnew/3.6.rst:1964 +#: whatsnew/3.6.rst:1968 msgid "" "The :mod:`!asynchat` has been deprecated in favor of :mod:`asyncio`. " "(Contributed by Mariatta in :issue:`25002`.)" msgstr "" -#: whatsnew/3.6.rst:1969 +#: whatsnew/3.6.rst:1973 msgid "asyncore" msgstr "" -#: whatsnew/3.6.rst:1971 +#: whatsnew/3.6.rst:1975 msgid "" "The :mod:`!asyncore` has been deprecated in favor of :mod:`asyncio`. " "(Contributed by Mariatta in :issue:`25002`.)" msgstr "" -#: whatsnew/3.6.rst:1976 +#: whatsnew/3.6.rst:1980 msgid "dbm" msgstr "" -#: whatsnew/3.6.rst:1978 +#: whatsnew/3.6.rst:1982 msgid "" "Unlike other :mod:`dbm` implementations, the :mod:`dbm.dumb` module creates " "databases with the ``'rw'`` mode and allows modifying the database opened " @@ -2590,7 +2597,7 @@ msgid "" "in 3.8. (Contributed by Serhiy Storchaka in :issue:`21708`.)" msgstr "" -#: whatsnew/3.6.rst:1988 +#: whatsnew/3.6.rst:1992 msgid "" "The undocumented ``extra_path`` argument to the ``distutils.Distribution`` " "constructor is now considered deprecated and will raise a warning if set. " @@ -2598,17 +2605,17 @@ msgid "" "issue:`27919` for details." msgstr "" -#: whatsnew/3.6.rst:1995 +#: whatsnew/3.6.rst:1999 msgid "grp" msgstr "" -#: whatsnew/3.6.rst:1997 +#: whatsnew/3.6.rst:2001 msgid "" "The support of non-integer arguments in :func:`~grp.getgrgid` has been " "deprecated. (Contributed by Serhiy Storchaka in :issue:`26129`.)" msgstr "" -#: whatsnew/3.6.rst:2005 +#: whatsnew/3.6.rst:2009 msgid "" "The :meth:`importlib.machinery.SourceFileLoader.load_module` and :meth:" "`importlib.machinery.SourcelessFileLoader.load_module` methods are now " @@ -2618,14 +2625,14 @@ msgid "" "exec_module`." msgstr "" -#: whatsnew/3.6.rst:2012 +#: whatsnew/3.6.rst:2016 msgid "" "The :class:`importlib.machinery.WindowsRegistryFinder` class is now " "deprecated. As of 3.6.0, it is still added to :data:`sys.meta_path` by " "default (on Windows), but this may change in future releases." msgstr "" -#: whatsnew/3.6.rst:2019 +#: whatsnew/3.6.rst:2023 msgid "" "Undocumented support of general :term:`bytes-like objects ` as paths in :mod:`os` functions, :func:`compile` and similar " @@ -2633,7 +2640,7 @@ msgid "" "`25791` and :issue:`26754`.)" msgstr "" -#: whatsnew/3.6.rst:2027 +#: whatsnew/3.6.rst:2031 msgid "" "Support for inline flags ``(?letters)`` in the middle of the regular " "expression has been deprecated and will be removed in a future Python " @@ -2641,14 +2648,14 @@ msgid "" "(Contributed by Serhiy Storchaka in :issue:`22493`.)" msgstr "" -#: whatsnew/3.6.rst:2035 +#: whatsnew/3.6.rst:2039 msgid "" "OpenSSL 0.9.8, 1.0.0 and 1.0.1 are deprecated and no longer supported. In " "the future the :mod:`ssl` module will require at least OpenSSL 1.0.2 or " "1.1.0." msgstr "" -#: whatsnew/3.6.rst:2039 +#: whatsnew/3.6.rst:2043 msgid "" "SSL-related arguments like ``certfile``, ``keyfile`` and ``check_hostname`` " "in :mod:`ftplib`, :mod:`http.client`, :mod:`imaplib`, :mod:`poplib`, and :" @@ -2656,7 +2663,7 @@ msgid "" "Christian Heimes in :issue:`28022`.)" msgstr "" -#: whatsnew/3.6.rst:2044 +#: whatsnew/3.6.rst:2048 msgid "" "A couple of protocols and functions of the :mod:`ssl` module are now " "deprecated. Some features will no longer be available in future versions of " @@ -2664,13 +2671,13 @@ msgid "" "(Contributed by Christian Heimes in :issue:`28022` and :issue:`26470`.)" msgstr "" -#: whatsnew/3.6.rst:2052 +#: whatsnew/3.6.rst:2056 msgid "" "The :mod:`tkinter.tix` module is now deprecated. :mod:`tkinter` users " "should use :mod:`tkinter.ttk` instead." msgstr "" -#: whatsnew/3.6.rst:2060 +#: whatsnew/3.6.rst:2064 msgid "" "The ``pyvenv`` script has been deprecated in favour of ``python3 -m venv``. " "This prevents confusion as to what Python interpreter ``pyvenv`` is " @@ -2678,11 +2685,22 @@ msgid "" "environment. (Contributed by Brett Cannon in :issue:`25154`.)" msgstr "" -#: whatsnew/3.6.rst:2067 +#: whatsnew/3.6.rst:2071 +msgid "xml" +msgstr "" + +#: whatsnew/3.6.rst:2073 +msgid "" +"As mitigation against DTD and external entity retrieval, the :mod:`xml.dom." +"minidom` and :mod:`xml.sax` modules no longer process external entities by " +"default. (Contributed by Christian Heimes in :gh:`61441`.)" +msgstr "" + +#: whatsnew/3.6.rst:2080 msgid "Deprecated functions and types of the C API" msgstr "" -#: whatsnew/3.6.rst:2069 +#: whatsnew/3.6.rst:2082 msgid "" "Undocumented functions :c:func:`!PyUnicode_AsEncodedObject`, :c:func:`!" "PyUnicode_AsDecodedObject`, :c:func:`!PyUnicode_AsEncodedUnicode` and :c:" @@ -2690,11 +2708,11 @@ msgid "" "codec based API ` instead." msgstr "" -#: whatsnew/3.6.rst:2076 +#: whatsnew/3.6.rst:2089 msgid "Deprecated Build Options" msgstr "" -#: whatsnew/3.6.rst:2078 +#: whatsnew/3.6.rst:2091 msgid "" "The ``--with-system-ffi`` configure flag is now on by default on non-macOS " "UNIX platforms. It may be disabled by using ``--without-system-ffi``, but " @@ -2703,15 +2721,15 @@ msgid "" "the ``--with-system-ffi`` flag when building their system Python." msgstr "" -#: whatsnew/3.6.rst:2086 +#: whatsnew/3.6.rst:2099 msgid "Removed" msgstr "" -#: whatsnew/3.6.rst:2089 +#: whatsnew/3.6.rst:2102 msgid "API and Feature Removals" msgstr "" -#: whatsnew/3.6.rst:2091 +#: whatsnew/3.6.rst:2104 msgid "" "Unknown escapes consisting of ``'\\'`` and an ASCII letter in regular " "expressions will now cause an error. In replacement templates for :func:`re." @@ -2719,14 +2737,14 @@ msgid "" "now only be used with binary patterns." msgstr "" -#: whatsnew/3.6.rst:2096 +#: whatsnew/3.6.rst:2109 msgid "" "``inspect.getmoduleinfo()`` was removed (was deprecated since CPython 3.3). :" "func:`inspect.getmodulename` should be used for obtaining the module name " "for a given path. (Contributed by Yury Selivanov in :issue:`13248`.)" msgstr "" -#: whatsnew/3.6.rst:2101 +#: whatsnew/3.6.rst:2114 msgid "" "``traceback.Ignore`` class and ``traceback.usage``, ``traceback.modname``, " "``traceback.fullmodname``, ``traceback.find_lines_from_code``, ``traceback." @@ -2736,14 +2754,14 @@ msgid "" "equivalent functionality is available from private methods." msgstr "" -#: whatsnew/3.6.rst:2108 +#: whatsnew/3.6.rst:2121 msgid "" "The ``tk_menuBar()`` and ``tk_bindForTraversal()`` dummy methods in :mod:" "`tkinter` widget classes were removed (corresponding Tk commands were " "obsolete since Tk 4.0)." msgstr "" -#: whatsnew/3.6.rst:2112 +#: whatsnew/3.6.rst:2125 msgid "" "The :meth:`~zipfile.ZipFile.open` method of the :class:`zipfile.ZipFile` " "class no longer supports the ``'U'`` mode (was deprecated since Python 3.4). " @@ -2751,7 +2769,7 @@ msgid "" "`universal newlines` mode." msgstr "" -#: whatsnew/3.6.rst:2117 +#: whatsnew/3.6.rst:2130 msgid "" "The undocumented ``IN``, ``CDROM``, ``DLFCN``, ``TYPES``, ``CDIO``, and " "``STROPTS`` modules have been removed. They had been available in the " @@ -2762,25 +2780,25 @@ msgid "" "blob/v3.6.15/Tools/scripts/h2py.py>`_." msgstr "" -#: whatsnew/3.6.rst:2125 +#: whatsnew/3.6.rst:2138 msgid "The deprecated ``asynchat.fifo`` class has been removed." msgstr "" -#: whatsnew/3.6.rst:2129 +#: whatsnew/3.6.rst:2142 msgid "Porting to Python 3.6" msgstr "" -#: whatsnew/3.6.rst:2131 +#: whatsnew/3.6.rst:2144 msgid "" "This section lists previously described changes and other bugfixes that may " "require changes to your code." msgstr "" -#: whatsnew/3.6.rst:2135 +#: whatsnew/3.6.rst:2148 msgid "Changes in 'python' Command Behavior" msgstr "" -#: whatsnew/3.6.rst:2137 +#: whatsnew/3.6.rst:2150 msgid "" "The output of a special Python build with defined ``COUNT_ALLOCS``, " "``SHOW_ALLOC_COUNT`` or ``SHOW_TRACK_COUNT`` macros is now off by default. " @@ -2789,42 +2807,42 @@ msgid "" "issue:`23034`.)" msgstr "" -#: whatsnew/3.6.rst:2145 +#: whatsnew/3.6.rst:2158 msgid "Changes in the Python API" msgstr "" -#: whatsnew/3.6.rst:2147 +#: whatsnew/3.6.rst:2160 msgid "" ":func:`open() ` will no longer allow combining the ``'U'`` mode flag " "with ``'+'``. (Contributed by Jeff Balogh and John O'Connor in :issue:" "`2091`.)" msgstr "" -#: whatsnew/3.6.rst:2151 +#: whatsnew/3.6.rst:2164 msgid "" ":mod:`sqlite3` no longer implicitly commits an open transaction before DDL " "statements." msgstr "" -#: whatsnew/3.6.rst:2154 +#: whatsnew/3.6.rst:2167 msgid "" "On Linux, :func:`os.urandom` now blocks until the system urandom entropy " "pool is initialized to increase the security." msgstr "" -#: whatsnew/3.6.rst:2157 +#: whatsnew/3.6.rst:2170 msgid "" "When :meth:`importlib.abc.Loader.exec_module` is defined, :meth:`importlib." "abc.Loader.create_module` must also be defined." msgstr "" -#: whatsnew/3.6.rst:2160 +#: whatsnew/3.6.rst:2173 msgid "" ":c:func:`PyErr_SetImportError` now sets :exc:`TypeError` when its **msg** " "argument is not set. Previously only ``NULL`` was returned." msgstr "" -#: whatsnew/3.6.rst:2163 +#: whatsnew/3.6.rst:2176 msgid "" "The format of the :attr:`~codeobject.co_lnotab` attribute of code objects " "changed to support a negative line number delta. By default, Python does not " @@ -2837,7 +2855,7 @@ msgid "" "and how to decode it, and see the :pep:`511` for the rationale." msgstr "" -#: whatsnew/3.6.rst:2174 +#: whatsnew/3.6.rst:2187 msgid "" "The functions in the :mod:`compileall` module now return booleans instead of " "``1`` or ``0`` to represent success or failure, respectively. Thanks to " @@ -2845,7 +2863,7 @@ msgid "" "were doing identity checks for ``1`` or ``0``. See :issue:`25768`." msgstr "" -#: whatsnew/3.6.rst:2179 +#: whatsnew/3.6.rst:2192 msgid "" "Reading the :attr:`~urllib.parse.SplitResult.port` attribute of :func:" "`urllib.parse.urlsplit` and :func:`~urllib.parse.urlparse` results now " @@ -2853,13 +2871,13 @@ msgid "" "const:`None`. See :issue:`20059`." msgstr "" -#: whatsnew/3.6.rst:2184 +#: whatsnew/3.6.rst:2197 msgid "" "The :mod:`!imp` module now raises a :exc:`DeprecationWarning` instead of :" "exc:`PendingDeprecationWarning`." msgstr "" -#: whatsnew/3.6.rst:2187 +#: whatsnew/3.6.rst:2200 msgid "" "The following modules have had missing APIs added to their :attr:`__all__` " "attributes to match the documented APIs: :mod:`calendar`, :mod:`cgi`, :mod:" @@ -2871,21 +2889,21 @@ msgid "" "Kołodziej in :issue:`23883`.)" msgstr "" -#: whatsnew/3.6.rst:2198 +#: whatsnew/3.6.rst:2211 msgid "" "When performing a relative import, if ``__package__`` does not compare equal " "to ``__spec__.parent`` then :exc:`ImportWarning` is raised. (Contributed by " "Brett Cannon in :issue:`25791`.)" msgstr "" -#: whatsnew/3.6.rst:2202 +#: whatsnew/3.6.rst:2215 msgid "" "When a relative import is performed and no parent package is known, then :" "exc:`ImportError` will be raised. Previously, :exc:`SystemError` could be " "raised. (Contributed by Brett Cannon in :issue:`18018`.)" msgstr "" -#: whatsnew/3.6.rst:2206 +#: whatsnew/3.6.rst:2219 msgid "" "Servers based on the :mod:`socketserver` module, including those defined in :" "mod:`http.server`, :mod:`xmlrpc.server` and :mod:`wsgiref.simple_server`, " @@ -2896,20 +2914,20 @@ msgid "" "(Contributed by Martin Panter in :issue:`23430`.)" msgstr "" -#: whatsnew/3.6.rst:2215 +#: whatsnew/3.6.rst:2228 msgid "" ":func:`spwd.getspnam` now raises a :exc:`PermissionError` instead of :exc:" "`KeyError` if the user doesn't have privileges." msgstr "" -#: whatsnew/3.6.rst:2218 +#: whatsnew/3.6.rst:2231 msgid "" "The :meth:`socket.socket.close` method now raises an exception if an error " "(e.g. ``EBADF``) was reported by the underlying system call. (Contributed by " "Martin Panter in :issue:`26685`.)" msgstr "" -#: whatsnew/3.6.rst:2222 +#: whatsnew/3.6.rst:2235 msgid "" "The *decode_data* argument for the :class:`!smtpd.SMTPChannel` and :class:`!" "smtpd.SMTPServer` constructors is now ``False`` by default. This means that " @@ -2919,7 +2937,7 @@ msgid "" "generated by 3.5 will not be affected." msgstr "" -#: whatsnew/3.6.rst:2230 +#: whatsnew/3.6.rst:2243 msgid "" "All optional arguments of the :func:`~json.dump`, :func:`~json.dumps`, :func:" "`~json.load` and :func:`~json.loads` functions and :class:`~json." @@ -2928,13 +2946,13 @@ msgid "" "(Contributed by Serhiy Storchaka in :issue:`18726`.)" msgstr "" -#: whatsnew/3.6.rst:2237 +#: whatsnew/3.6.rst:2250 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." msgstr "" -#: whatsnew/3.6.rst:2240 +#: whatsnew/3.6.rst:2253 msgid "" "As part of :pep:`487`, the handling of keyword arguments passed to :class:" "`type` (other than the metaclass hint, ``metaclass``) is now consistently " @@ -2946,7 +2964,7 @@ msgid "" "__new__` (whether direct or via :class:`super`) accordingly." msgstr "" -#: whatsnew/3.6.rst:2249 +#: whatsnew/3.6.rst:2262 msgid "" "In ``distutils.command.sdist.sdist``, the ``default_format`` attribute has " "been removed and is no longer honored. Instead, the gzipped tarfile format " @@ -2956,13 +2974,13 @@ msgid "" "containing the following:" msgstr "" -#: whatsnew/3.6.rst:2262 +#: whatsnew/3.6.rst:2275 msgid "" "This behavior has also been backported to earlier Python versions by " "Setuptools 26.0.0." msgstr "" -#: whatsnew/3.6.rst:2265 +#: whatsnew/3.6.rst:2278 msgid "" "In the :mod:`urllib.request` module and the :meth:`http.client." "HTTPConnection.request` method, if no Content-Length header field has been " @@ -2973,47 +2991,47 @@ msgid "" "`12319`.)" msgstr "" -#: whatsnew/3.6.rst:2274 +#: whatsnew/3.6.rst:2287 msgid "" "The :class:`~csv.DictReader` now returns rows of type :class:`~collections." "OrderedDict`. (Contributed by Steve Holden in :issue:`27842`.)" msgstr "" -#: whatsnew/3.6.rst:2278 +#: whatsnew/3.6.rst:2291 msgid "" "The :const:`crypt.METHOD_CRYPT` will no longer be added to ``crypt.methods`` " "if unsupported by the platform. (Contributed by Victor Stinner in :issue:" "`25287`.)" msgstr "" -#: whatsnew/3.6.rst:2286 +#: whatsnew/3.6.rst:2299 msgid "" "On Linux, :func:`ctypes.util.find_library` now looks in ``LD_LIBRARY_PATH`` " "for shared libraries. (Contributed by Vinay Sajip in :issue:`9998`.)" msgstr "" -#: whatsnew/3.6.rst:2290 +#: whatsnew/3.6.rst:2303 msgid "" "The :class:`imaplib.IMAP4` class now handles flags containing the ``']'`` " "character in messages sent from the server to improve real-world " "compatibility. (Contributed by Lita Cho in :issue:`21815`.)" msgstr "" -#: whatsnew/3.6.rst:2295 +#: whatsnew/3.6.rst:2308 msgid "" "The :func:`mmap.write() ` function now returns the number of " "bytes written like other write methods. (Contributed by Jakub Stasiak in :" "issue:`26335`.)" msgstr "" -#: whatsnew/3.6.rst:2299 +#: whatsnew/3.6.rst:2312 msgid "" "The :func:`pkgutil.iter_modules` and :func:`pkgutil.walk_packages` functions " "now return :class:`~pkgutil.ModuleInfo` named tuples. (Contributed by " "Ramchandra Apte in :issue:`17211`.)" msgstr "" -#: whatsnew/3.6.rst:2303 +#: whatsnew/3.6.rst:2316 msgid "" ":func:`re.sub` now raises an error for invalid numerical group references in " "replacement templates even if the pattern is not found in the string. The " @@ -3022,7 +3040,7 @@ msgid "" "in :issue:`25953`.)" msgstr "" -#: whatsnew/3.6.rst:2309 +#: whatsnew/3.6.rst:2322 msgid "" ":class:`zipfile.ZipFile` will now raise :exc:`NotImplementedError` for " "unrecognized compression values. Previously a plain :exc:`RuntimeError` was " @@ -3032,7 +3050,7 @@ msgid "" "`RuntimeError` was raised in those scenarios." msgstr "" -#: whatsnew/3.6.rst:2316 +#: whatsnew/3.6.rst:2329 msgid "" "when custom metaclasses are combined with zero-argument :func:`super` or " "direct references from methods to the implicit ``__class__`` closure " @@ -3042,7 +3060,7 @@ msgid "" "Python 3.8." msgstr "" -#: whatsnew/3.6.rst:2323 +#: whatsnew/3.6.rst:2336 msgid "" "With the introduction of :exc:`ModuleNotFoundError`, import system consumers " "may start expecting import system replacements to raise that more specific " @@ -3055,11 +3073,11 @@ msgid "" "the default import system will raise the new subclass when appropriate." msgstr "" -#: whatsnew/3.6.rst:2335 +#: whatsnew/3.6.rst:2348 msgid "Changes in the C API" msgstr "" -#: whatsnew/3.6.rst:2337 +#: whatsnew/3.6.rst:2350 msgid "" "The :c:func:`PyMem_Malloc` allocator family now uses the :ref:`pymalloc " "allocator ` rather than the system :c:func:`malloc`. Applications " @@ -3068,29 +3086,29 @@ msgid "" "usage of memory allocators in your application. See :issue:`26249`." msgstr "" -#: whatsnew/3.6.rst:2343 +#: whatsnew/3.6.rst:2356 msgid "" ":c:func:`Py_Exit` (and the main interpreter) now override the exit status " "with 120 if flushing buffered data failed. See :issue:`5319`." msgstr "" -#: whatsnew/3.6.rst:2348 +#: whatsnew/3.6.rst:2361 msgid "CPython bytecode changes" msgstr "" -#: whatsnew/3.6.rst:2350 +#: whatsnew/3.6.rst:2363 msgid "" "There have been several major changes to the :term:`bytecode` in Python 3.6." msgstr "" -#: whatsnew/3.6.rst:2352 +#: whatsnew/3.6.rst:2365 msgid "" "The Python interpreter now uses a 16-bit wordcode instead of bytecode. " "(Contributed by Demur Rumed with input and reviews from Serhiy Storchaka and " "Victor Stinner in :issue:`26647` and :issue:`28050`.)" msgstr "" -#: whatsnew/3.6.rst:2356 +#: whatsnew/3.6.rst:2369 msgid "" "The new :opcode:`FORMAT_VALUE` and :opcode:`BUILD_STRING` opcodes as part of " "the :ref:`formatted string literal ` implementation. " @@ -3098,14 +3116,14 @@ msgid "" "`27078`.)" msgstr "" -#: whatsnew/3.6.rst:2361 +#: whatsnew/3.6.rst:2374 msgid "" "The new :opcode:`BUILD_CONST_KEY_MAP` opcode to optimize the creation of " "dictionaries with constant keys. (Contributed by Serhiy Storchaka in :issue:" "`27140`.)" msgstr "" -#: whatsnew/3.6.rst:2365 +#: whatsnew/3.6.rst:2378 msgid "" "The function call opcodes have been heavily reworked for better performance " "and simpler implementation. The :opcode:`MAKE_FUNCTION`, :opcode:" @@ -3117,22 +3135,22 @@ msgid "" "issue:`27095`, and Serhiy Storchaka in :issue:`27213`, :issue:`28257`.)" msgstr "" -#: whatsnew/3.6.rst:2376 +#: whatsnew/3.6.rst:2389 msgid "" "The new :opcode:`SETUP_ANNOTATIONS` and :opcode:`STORE_ANNOTATION` opcodes " "have been added to support the new :term:`variable annotation` syntax. " "(Contributed by Ivan Levkivskyi in :issue:`27985`.)" msgstr "" -#: whatsnew/3.6.rst:2382 +#: whatsnew/3.6.rst:2395 msgid "Notable changes in Python 3.6.2" msgstr "" -#: whatsnew/3.6.rst:2385 +#: whatsnew/3.6.rst:2398 msgid "New ``make regen-all`` build target" msgstr "" -#: whatsnew/3.6.rst:2387 +#: whatsnew/3.6.rst:2400 msgid "" "To simplify cross-compilation, and to ensure that CPython can reliably be " "compiled without requiring an existing version of Python to already be " @@ -3140,43 +3158,43 @@ msgid "" "recompile generated files based on file modification times." msgstr "" -#: whatsnew/3.6.rst:2392 +#: whatsnew/3.6.rst:2405 msgid "" "Instead, a new ``make regen-all`` command has been added to force " "regeneration of these files when desired (e.g. after an initial version of " "Python has already been built based on the pregenerated versions)." msgstr "" -#: whatsnew/3.6.rst:2396 +#: whatsnew/3.6.rst:2409 msgid "" "More selective regeneration targets are also defined - see :source:`Makefile." "pre.in` for details." msgstr "" -#: whatsnew/3.6.rst:2412 +#: whatsnew/3.6.rst:2425 msgid "(Contributed by Victor Stinner in :issue:`23404`.)" msgstr "" -#: whatsnew/3.6.rst:2405 +#: whatsnew/3.6.rst:2418 msgid "Removal of ``make touch`` build target" msgstr "" -#: whatsnew/3.6.rst:2407 +#: whatsnew/3.6.rst:2420 msgid "" "The ``make touch`` build target previously used to request implicit " "regeneration of generated files by updating their modification times has " "been removed." msgstr "" -#: whatsnew/3.6.rst:2410 +#: whatsnew/3.6.rst:2423 msgid "It has been replaced by the new ``make regen-all`` target." msgstr "" -#: whatsnew/3.6.rst:2418 +#: whatsnew/3.6.rst:2431 msgid "Notable changes in Python 3.6.4" msgstr "" -#: whatsnew/3.6.rst:2420 +#: whatsnew/3.6.rst:2433 msgid "" "The ``PyExc_RecursionErrorInst`` singleton that was part of the public API " "has been removed as its members being never cleared may cause a segfault " @@ -3184,22 +3202,28 @@ msgid "" "issue:`22898` and :issue:`30697`.)" msgstr "" -#: whatsnew/3.6.rst:2427 +#: whatsnew/3.6.rst:2440 msgid "Notable changes in Python 3.6.5" msgstr "" -#: whatsnew/3.6.rst:2429 +#: whatsnew/3.6.rst:2442 msgid "" "The :func:`locale.localeconv` function now sets temporarily the ``LC_CTYPE`` " "locale to the ``LC_NUMERIC`` locale in some cases. (Contributed by Victor " "Stinner in :issue:`31900`.)" msgstr "" -#: whatsnew/3.6.rst:2434 +#: whatsnew/3.6.rst:2448 msgid "Notable changes in Python 3.6.7" msgstr "" -#: whatsnew/3.6.rst:2436 +#: whatsnew/3.6.rst:2450 +msgid "" +":mod:`xml.dom.minidom` and :mod:`xml.sax` modules no longer process external " +"entities by default. See also :gh:`61441`." +msgstr "" + +#: whatsnew/3.6.rst:2453 msgid "" "In 3.6.7 the :mod:`tokenize` module now implicitly emits a ``NEWLINE`` token " "when provided with input that does not have a trailing new line. This " @@ -3207,11 +3231,11 @@ msgid "" "Ammar Askar in :issue:`33899`.)" msgstr "" -#: whatsnew/3.6.rst:2442 +#: whatsnew/3.6.rst:2459 msgid "Notable changes in Python 3.6.10" msgstr "" -#: whatsnew/3.6.rst:2444 +#: whatsnew/3.6.rst:2461 msgid "" "Due to significant security concerns, the *reuse_address* parameter of :meth:" "`asyncio.loop.create_datagram_endpoint` is no longer supported. This is " @@ -3221,11 +3245,11 @@ msgid "" "`37228`.)" msgstr "" -#: whatsnew/3.6.rst:2452 +#: whatsnew/3.6.rst:2469 msgid "Notable changes in Python 3.6.13" msgstr "" -#: whatsnew/3.6.rst:2454 +#: whatsnew/3.6.rst:2471 msgid "" "Earlier Python versions allowed using both ``;`` and ``&`` as query " "parameter separators in :func:`urllib.parse.parse_qs` and :func:`urllib." @@ -3236,3 +3260,26 @@ msgid "" "For more details, please see their respective documentation. (Contributed by " "Adam Goldschmidt, Senthil Kumaran and Ken Jin in :issue:`42967`.)" msgstr "" + +#: whatsnew/3.6.rst:2482 +msgid "Notable changes in Python 3.6.14" +msgstr "" + +#: whatsnew/3.6.rst:2484 +msgid "" +"A security fix alters the :class:`ftplib.FTP` behavior to not trust the IPv4 " +"address sent from the remote server when setting up a passive data channel. " +"We reuse the ftp server IP address instead. For unusual code requiring the " +"old behavior, set a ``trust_server_pasv_ipv4_address`` attribute on your FTP " +"instance to ``True``. (See :gh:`87451`)" +msgstr "" + +#: whatsnew/3.6.rst:2490 +msgid "" +"The presence of newline or tab characters in parts of a URL allows for some " +"forms of attacks. Following the WHATWG specification that updates RFC 3986, " +"ASCII newline ``\\n``, ``\\r`` and tab ``\\t`` characters are stripped from " +"the URL by the parser :func:`urllib.parse` preventing such attacks. The " +"removal characters are controlled by a new module level variable ``urllib." +"parse._UNSAFE_URL_BYTES_TO_REMOVE``. (See :gh:`88048`)" +msgstr "" diff --git a/whatsnew/3.7.po b/whatsnew/3.7.po index ff8b7e573..5f8ed61f0 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-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -475,27 +475,27 @@ msgid "" "module:" msgstr "" -#: whatsnew/3.7.rst:1447 +#: whatsnew/3.7.rst:1451 msgid ":func:`time.clock_gettime_ns`" msgstr "" -#: whatsnew/3.7.rst:1448 +#: whatsnew/3.7.rst:1452 msgid ":func:`time.clock_settime_ns`" msgstr "" -#: whatsnew/3.7.rst:1449 +#: whatsnew/3.7.rst:1453 msgid ":func:`time.monotonic_ns`" msgstr "" -#: whatsnew/3.7.rst:1450 +#: whatsnew/3.7.rst:1454 msgid ":func:`time.perf_counter_ns`" msgstr "" -#: whatsnew/3.7.rst:1451 +#: whatsnew/3.7.rst:1455 msgid ":func:`time.process_time_ns`" msgstr "" -#: whatsnew/3.7.rst:1452 +#: whatsnew/3.7.rst:1456 msgid ":func:`time.time_ns`" msgstr "" @@ -865,7 +865,7 @@ msgid "" "positional arguments. (Contributed by paul.j3 in :issue:`14191`.)" msgstr "" -#: whatsnew/3.7.rst:1951 +#: whatsnew/3.7.rst:1964 msgid "asyncio" msgstr "" @@ -1093,7 +1093,7 @@ msgid "" "(Contributed by Oz Tiram in :issue:`30095`.)" msgstr "" -#: whatsnew/3.7.rst:1965 +#: whatsnew/3.7.rst:1978 msgid "collections" msgstr "" @@ -1200,7 +1200,7 @@ msgid "" "(Contributed by Alexander Belopolsky in :issue:`5288`.)" msgstr "" -#: whatsnew/3.7.rst:1975 +#: whatsnew/3.7.rst:1988 msgid "dbm" msgstr "" @@ -1245,7 +1245,7 @@ msgid "" "in :issue:`11913`.)" msgstr "" -#: whatsnew/3.7.rst:1985 +#: whatsnew/3.7.rst:1998 msgid "enum" msgstr "" @@ -1445,7 +1445,7 @@ msgid "" "`17535`.)" msgstr "" -#: whatsnew/3.7.rst:2004 +#: whatsnew/3.7.rst:2017 msgid "importlib" msgstr "" @@ -1513,7 +1513,7 @@ msgid "" "Roberts in :issue:`30537`.)" msgstr "" -#: whatsnew/3.7.rst:2022 +#: whatsnew/3.7.rst:2035 msgid "locale" msgstr "" @@ -1778,7 +1778,7 @@ msgid "" "in :issue:`30050`.)" msgstr "" -#: whatsnew/3.7.rst:2045 +#: whatsnew/3.7.rst:2058 msgid "socket" msgstr "" @@ -1855,7 +1855,7 @@ msgid "" "Lorentsen in :issue:`31843`.)" msgstr "" -#: whatsnew/3.7.rst:2054 +#: whatsnew/3.7.rst:2067 msgid "ssl" msgstr "" @@ -1941,22 +1941,29 @@ msgid "" "`32609`.)" msgstr "" -#: whatsnew/3.7.rst:1385 +#: whatsnew/3.7.rst:1383 +msgid "" +"Added :attr:`ssl.SSLContext.post_handshake_auth` to enable and :meth:`ssl." +"SSLSocket.verify_client_post_handshake` to initiate TLS 1.3 post-handshake " +"authentication. (Contributed by Christian Heimes in :gh:`78851`.)" +msgstr "" + +#: whatsnew/3.7.rst:1389 msgid "string" msgstr "" -#: whatsnew/3.7.rst:1387 +#: whatsnew/3.7.rst:1391 msgid "" ":class:`string.Template` now lets you to optionally modify the regular " "expression pattern for braced placeholders and non-braced placeholders " "separately. (Contributed by Barry Warsaw in :issue:`1198569`.)" msgstr "" -#: whatsnew/3.7.rst:1393 +#: whatsnew/3.7.rst:1397 msgid "subprocess" msgstr "" -#: whatsnew/3.7.rst:1395 +#: whatsnew/3.7.rst:1399 msgid "" "The :func:`subprocess.run` function accepts the new *capture_output* keyword " "argument. When true, stdout and stderr will be captured. This is equivalent " @@ -1964,14 +1971,14 @@ msgid "" "(Contributed by Bo Bayles in :issue:`32102`.)" msgstr "" -#: whatsnew/3.7.rst:1401 +#: whatsnew/3.7.rst:1405 msgid "" "The ``subprocess.run`` function and the :class:`subprocess.Popen` " "constructor now accept the *text* keyword argument as an alias to " "*universal_newlines*. (Contributed by Andrew Clegg in :issue:`31756`.)" msgstr "" -#: whatsnew/3.7.rst:1406 +#: whatsnew/3.7.rst:1410 msgid "" "On Windows the default for *close_fds* was changed from ``False`` to " "``True`` when redirecting the standard handles. It's now possible to set " @@ -1980,7 +1987,7 @@ msgid "" "all supported platforms. (Contributed by Segev Finer in :issue:`19764`.)" msgstr "" -#: whatsnew/3.7.rst:1413 +#: whatsnew/3.7.rst:1417 msgid "" "The subprocess module is now more graceful when handling :exc:" "`KeyboardInterrupt` during :func:`subprocess.call`, :func:`subprocess.run`, " @@ -1990,23 +1997,23 @@ msgid "" "`25942`.)" msgstr "" -#: whatsnew/3.7.rst:2070 +#: whatsnew/3.7.rst:2083 msgid "sys" msgstr "" -#: whatsnew/3.7.rst:1425 +#: whatsnew/3.7.rst:1429 msgid "" "The new :func:`sys.breakpointhook` hook function is called by the built-in :" "func:`breakpoint`. (Contributed by Barry Warsaw in :issue:`31353`.)" msgstr "" -#: whatsnew/3.7.rst:1429 +#: whatsnew/3.7.rst:1433 msgid "" "On Android, the new :func:`sys.getandroidapilevel` returns the build-time " "Android API version. (Contributed by Victor Stinner in :issue:`28740`.)" msgstr "" -#: whatsnew/3.7.rst:1433 +#: whatsnew/3.7.rst:1437 msgid "" "The new :func:`sys.get_coroutine_origin_tracking_depth` function returns the " "current coroutine origin tracking depth, as set by the new :func:`sys." @@ -2016,68 +2023,68 @@ msgid "" "`32591`.)" msgstr "" -#: whatsnew/3.7.rst:1442 +#: whatsnew/3.7.rst:1446 msgid "time" msgstr "" -#: whatsnew/3.7.rst:1444 +#: whatsnew/3.7.rst:1448 msgid "" ":pep:`564` adds six new functions with nanosecond resolution to the :mod:" "`time` module:" msgstr "" -#: whatsnew/3.7.rst:1454 +#: whatsnew/3.7.rst:1458 msgid "New clock identifiers have been added:" msgstr "" -#: whatsnew/3.7.rst:1456 +#: whatsnew/3.7.rst:1460 msgid "" ":const:`time.CLOCK_BOOTTIME` (Linux): Identical to :const:`time." "CLOCK_MONOTONIC`, except it also includes any time that the system is " "suspended." msgstr "" -#: whatsnew/3.7.rst:1459 +#: whatsnew/3.7.rst:1463 msgid "" ":const:`time.CLOCK_PROF` (FreeBSD, NetBSD and OpenBSD): High-resolution per-" "process CPU timer." msgstr "" -#: whatsnew/3.7.rst:1461 +#: whatsnew/3.7.rst:1465 msgid "" ":const:`time.CLOCK_UPTIME` (FreeBSD, OpenBSD): Time whose absolute value is " "the time the system has been running and not suspended, providing accurate " "uptime measurement." msgstr "" -#: whatsnew/3.7.rst:1465 +#: whatsnew/3.7.rst:1469 msgid "" "The new :func:`time.thread_time` and :func:`time.thread_time_ns` functions " "can be used to get per-thread CPU time measurements. (Contributed by Antoine " "Pitrou in :issue:`32025`.)" msgstr "" -#: whatsnew/3.7.rst:1469 +#: whatsnew/3.7.rst:1473 msgid "" "The new :func:`time.pthread_getcpuclockid` function returns the clock ID of " "the thread-specific CPU-time clock." msgstr "" -#: whatsnew/3.7.rst:1474 +#: whatsnew/3.7.rst:1478 msgid "tkinter" msgstr "" -#: whatsnew/3.7.rst:1476 +#: whatsnew/3.7.rst:1480 msgid "" "The new :class:`tkinter.ttk.Spinbox` class is now available. (Contributed by " "Alan Moore in :issue:`32585`.)" msgstr "" -#: whatsnew/3.7.rst:1481 +#: whatsnew/3.7.rst:1485 msgid "tracemalloc" msgstr "" -#: whatsnew/3.7.rst:1483 +#: whatsnew/3.7.rst:1487 msgid "" ":class:`tracemalloc.Traceback` behaves more like regular tracebacks, sorting " "the frames from oldest to most recent. :meth:`Traceback.format() " @@ -2087,11 +2094,11 @@ msgid "" "by Jesse Bakker in :issue:`32121`.)" msgstr "" -#: whatsnew/3.7.rst:1493 +#: whatsnew/3.7.rst:1497 msgid "types" msgstr "" -#: whatsnew/3.7.rst:1495 +#: whatsnew/3.7.rst:1499 msgid "" "The new :class:`~types.WrapperDescriptorType`, :class:`~types." "MethodWrapperType`, :class:`~types.MethodDescriptorType`, and :class:`~types." @@ -2100,29 +2107,29 @@ msgid "" "issue:`32265`.)" msgstr "" -#: whatsnew/3.7.rst:1501 +#: whatsnew/3.7.rst:1505 msgid "" "The new :func:`types.resolve_bases` function resolves MRO entries " "dynamically as specified by :pep:`560`. (Contributed by Ivan Levkivskyi in :" "issue:`32717`.)" msgstr "" -#: whatsnew/3.7.rst:1507 +#: whatsnew/3.7.rst:1511 msgid "unicodedata" msgstr "" -#: whatsnew/3.7.rst:1509 +#: whatsnew/3.7.rst:1513 msgid "" "The internal :mod:`unicodedata` database has been upgraded to use `Unicode " "11 `_. (Contributed by " "Benjamin Peterson.)" msgstr "" -#: whatsnew/3.7.rst:1515 +#: whatsnew/3.7.rst:1519 msgid "unittest" msgstr "" -#: whatsnew/3.7.rst:1517 +#: whatsnew/3.7.rst:1521 msgid "" "The new ``-k`` command-line option allows filtering tests by a name " "substring or a Unix shell-like pattern. For example, ``python -m unittest -k " @@ -2131,18 +2138,18 @@ msgid "" "Jonas Haag in :issue:`32071`.)" msgstr "" -#: whatsnew/3.7.rst:1526 +#: whatsnew/3.7.rst:1530 msgid "unittest.mock" msgstr "" -#: whatsnew/3.7.rst:1528 +#: whatsnew/3.7.rst:1532 msgid "" "The :const:`~unittest.mock.sentinel` attributes now preserve their identity " "when they are :mod:`copied ` or :mod:`pickled `. (Contributed " "by Serhiy Storchaka in :issue:`20804`.)" msgstr "" -#: whatsnew/3.7.rst:1532 +#: whatsnew/3.7.rst:1536 msgid "" "The new :func:`~unittest.mock.seal` function allows sealing :class:" "`~unittest.mock.Mock` instances, which will disallow further creation of " @@ -2150,33 +2157,33 @@ msgid "" "themselves mocks. (Contributed by Mario Corchero in :issue:`30541`.)" msgstr "" -#: whatsnew/3.7.rst:1540 +#: whatsnew/3.7.rst:1544 msgid "urllib.parse" msgstr "" -#: whatsnew/3.7.rst:1542 +#: whatsnew/3.7.rst:1546 msgid "" ":func:`urllib.parse.quote` has been updated from :rfc:`2396` to :rfc:`3986`, " "adding ``~`` to the set of characters that are never quoted by default. " "(Contributed by Christian Theune and Ratnadeep Debnath in :issue:`16285`.)" msgstr "" -#: whatsnew/3.7.rst:1548 +#: whatsnew/3.7.rst:1552 msgid "uu" msgstr "" -#: whatsnew/3.7.rst:1550 +#: whatsnew/3.7.rst:1554 msgid "" "The :func:`uu.encode` function now accepts an optional *backtick* keyword " "argument. When it's true, zeros are represented by ``'`'`` instead of " "spaces. (Contributed by Xiang Zhang in :issue:`30103`.)" msgstr "" -#: whatsnew/3.7.rst:1556 +#: whatsnew/3.7.rst:1560 msgid "uuid" msgstr "" -#: whatsnew/3.7.rst:1558 +#: whatsnew/3.7.rst:1562 msgid "" "The new :attr:`UUID.is_safe ` attribute relays " "information from the platform about whether generated UUIDs are generated " @@ -2184,7 +2191,7 @@ msgid "" "`22807`.)" msgstr "" -#: whatsnew/3.7.rst:1563 +#: whatsnew/3.7.rst:1567 msgid "" ":func:`uuid.getnode` now prefers universally administered MAC addresses over " "locally administered MAC addresses. This makes a better guarantee for global " @@ -2193,75 +2200,86 @@ msgid "" "returned. (Contributed by Barry Warsaw in :issue:`32107`.)" msgstr "" -#: whatsnew/3.7.rst:1572 +#: whatsnew/3.7.rst:1576 msgid "warnings" msgstr "" -#: whatsnew/3.7.rst:1574 +#: whatsnew/3.7.rst:1578 msgid "" "The initialization of the default warnings filters has changed as follows:" msgstr "" -#: whatsnew/3.7.rst:1576 +#: whatsnew/3.7.rst:1580 msgid "" "warnings enabled via command line options (including those for :option:`-b` " "and the new CPython-specific :option:`-X` ``dev`` option) are always passed " "to the warnings machinery via the :data:`sys.warnoptions` attribute." msgstr "" -#: whatsnew/3.7.rst:1580 +#: whatsnew/3.7.rst:1584 msgid "" "warnings filters enabled via the command line or the environment now have " "the following order of precedence:" msgstr "" -#: whatsnew/3.7.rst:1583 +#: whatsnew/3.7.rst:1587 msgid "the ``BytesWarning`` filter for :option:`-b` (or ``-bb``)" msgstr "" -#: whatsnew/3.7.rst:1584 +#: whatsnew/3.7.rst:1588 msgid "any filters specified with the :option:`-W` option" msgstr "" -#: whatsnew/3.7.rst:1585 +#: whatsnew/3.7.rst:1589 msgid "" "any filters specified with the :envvar:`PYTHONWARNINGS` environment variable" msgstr "" -#: whatsnew/3.7.rst:1587 +#: whatsnew/3.7.rst:1591 msgid "" "any other CPython specific filters (e.g. the ``default`` filter added for " "the new ``-X dev`` mode)" msgstr "" -#: whatsnew/3.7.rst:1589 +#: whatsnew/3.7.rst:1593 msgid "any implicit filters defined directly by the warnings machinery" msgstr "" -#: whatsnew/3.7.rst:1591 +#: whatsnew/3.7.rst:1595 msgid "" "in :ref:`CPython debug builds `, all warnings are now displayed " "by default (the implicit filter list is empty)" msgstr "" -#: whatsnew/3.7.rst:1594 +#: whatsnew/3.7.rst:1598 msgid "" "(Contributed by Nick Coghlan and Victor Stinner in :issue:`20361`, :issue:" "`32043`, and :issue:`32230`.)" msgstr "" -#: whatsnew/3.7.rst:1597 +#: whatsnew/3.7.rst:1601 msgid "" "Deprecation warnings are once again shown by default in single-file scripts " "and at the interactive prompt. See :ref:`whatsnew37-pep565` for details. " "(Contributed by Nick Coghlan in :issue:`31975`.)" msgstr "" -#: whatsnew/3.7.rst:1603 +#: whatsnew/3.7.rst:1607 +msgid "xml" +msgstr "" + +#: whatsnew/3.7.rst:1609 +msgid "" +"As mitigation against DTD and external entity retrieval, the :mod:`xml.dom." +"minidom` and :mod:`xml.sax` modules no longer process external entities by " +"default. (Contributed by Christian Heimes in :gh:`61441`.)" +msgstr "" + +#: whatsnew/3.7.rst:1616 msgid "xml.etree" msgstr "" -#: whatsnew/3.7.rst:1605 +#: whatsnew/3.7.rst:1618 msgid "" ":ref:`ElementPath ` predicates in the :meth:`find` " "methods can now compare text of the current node with ``[. = \"text\"]``, " @@ -2269,29 +2287,29 @@ msgid "" "readability. (Contributed by Stefan Behnel in :issue:`31648`.)" msgstr "" -#: whatsnew/3.7.rst:1612 +#: whatsnew/3.7.rst:1625 msgid "xmlrpc.server" msgstr "" -#: whatsnew/3.7.rst:1614 +#: whatsnew/3.7.rst:1627 msgid "" ":meth:`SimpleXMLRPCDispatcher.register_function ` can now be used as a decorator. (Contributed by " "Xiang Zhang in :issue:`7769`.)" msgstr "" -#: whatsnew/3.7.rst:1620 +#: whatsnew/3.7.rst:1633 msgid "zipapp" msgstr "" -#: whatsnew/3.7.rst:1622 +#: whatsnew/3.7.rst:1635 msgid "" "Function :func:`~zipapp.create_archive` now accepts an optional *filter* " "argument to allow the user to select which files should be included in the " "archive. (Contributed by Irmen de Jong in :issue:`31072`.)" msgstr "" -#: whatsnew/3.7.rst:1626 +#: whatsnew/3.7.rst:1639 msgid "" "Function :func:`~zipapp.create_archive` now accepts an optional *compressed* " "argument to generate a compressed archive. A command line option ``--" @@ -2299,27 +2317,27 @@ msgid "" "Zhiming Wang in :issue:`31638`.)" msgstr "" -#: whatsnew/3.7.rst:1633 +#: whatsnew/3.7.rst:1646 msgid "zipfile" msgstr "" -#: whatsnew/3.7.rst:1635 +#: whatsnew/3.7.rst:1648 msgid "" ":class:`~zipfile.ZipFile` now accepts the new *compresslevel* parameter to " "control the compression level. (Contributed by Bo Bayles in :issue:`21417`.)" msgstr "" -#: whatsnew/3.7.rst:1639 +#: whatsnew/3.7.rst:1652 msgid "" "Subdirectories in archives created by ``ZipFile`` are now stored in " "alphabetical order. (Contributed by Bernhard M. Wiedemann in :issue:`30693`.)" msgstr "" -#: whatsnew/3.7.rst:1645 +#: whatsnew/3.7.rst:1658 msgid "C API Changes" msgstr "" -#: whatsnew/3.7.rst:1647 +#: whatsnew/3.7.rst:1660 msgid "" "A new API for thread-local storage has been implemented. See :ref:" "`whatsnew37-pep539` for an overview and :ref:`thread-specific-storage-api` " @@ -2327,46 +2345,46 @@ msgid "" "`25658`.)" msgstr "" -#: whatsnew/3.7.rst:1652 +#: whatsnew/3.7.rst:1665 msgid "" "The new :ref:`context variables ` functionality exposes a " "number of :ref:`new C APIs `." msgstr "" -#: whatsnew/3.7.rst:1655 +#: whatsnew/3.7.rst:1668 msgid "" "The new :c:func:`PyImport_GetModule` function returns the previously " "imported module with the given name. (Contributed by Eric Snow in :issue:" "`28411`.)" msgstr "" -#: whatsnew/3.7.rst:1659 +#: whatsnew/3.7.rst:1672 msgid "" "The new :c:macro:`Py_RETURN_RICHCOMPARE` macro eases writing rich comparison " "functions. (Contributed by Petr Victorin in :issue:`23699`.)" msgstr "" -#: whatsnew/3.7.rst:1663 +#: whatsnew/3.7.rst:1676 msgid "" "The new :c:macro:`Py_UNREACHABLE` macro can be used to mark unreachable code " "paths. (Contributed by Barry Warsaw in :issue:`31338`.)" msgstr "" -#: whatsnew/3.7.rst:1667 +#: whatsnew/3.7.rst:1680 msgid "" "The :mod:`tracemalloc` now exposes a C API through the new :c:func:" "`PyTraceMalloc_Track` and :c:func:`PyTraceMalloc_Untrack` functions. " "(Contributed by Victor Stinner in :issue:`30054`.)" msgstr "" -#: whatsnew/3.7.rst:1672 +#: whatsnew/3.7.rst:1685 msgid "" "The new :c:func:`import__find__load__start` and :c:func:" "`import__find__load__done` static markers can be used to trace module " "imports. (Contributed by Christian Heimes in :issue:`31574`.)" msgstr "" -#: whatsnew/3.7.rst:1677 +#: whatsnew/3.7.rst:1690 msgid "" "The fields :c:member:`!name` and :c:member:`!doc` of structures :c:type:" "`PyMemberDef`, :c:type:`PyGetSetDef`, :c:type:`PyStructSequence_Field`, :c:" @@ -2375,34 +2393,34 @@ msgid "" "issue:`28761`.)" msgstr "" -#: whatsnew/3.7.rst:1683 +#: whatsnew/3.7.rst:1696 msgid "" "The result of :c:func:`PyUnicode_AsUTF8AndSize` and :c:func:" "`PyUnicode_AsUTF8` is now of type ``const char *`` rather of ``char *``. " "(Contributed by Serhiy Storchaka in :issue:`28769`.)" msgstr "" -#: whatsnew/3.7.rst:1687 +#: whatsnew/3.7.rst:1700 msgid "" "The result of :c:func:`PyMapping_Keys`, :c:func:`PyMapping_Values` and :c:" "func:`PyMapping_Items` is now always a list, rather than a list or a tuple. " "(Contributed by Oren Milman in :issue:`28280`.)" msgstr "" -#: whatsnew/3.7.rst:1691 +#: whatsnew/3.7.rst:1704 msgid "" "Added functions :c:func:`PySlice_Unpack` and :c:func:" "`PySlice_AdjustIndices`. (Contributed by Serhiy Storchaka in :issue:`27867`.)" msgstr "" -#: whatsnew/3.7.rst:1694 +#: whatsnew/3.7.rst:1707 msgid "" ":c:func:`PyOS_AfterFork` is deprecated in favour of the new functions :c:" "func:`PyOS_BeforeFork`, :c:func:`PyOS_AfterFork_Parent` and :c:func:" "`PyOS_AfterFork_Child`. (Contributed by Antoine Pitrou in :issue:`16500`.)" msgstr "" -#: whatsnew/3.7.rst:1699 +#: whatsnew/3.7.rst:1712 msgid "" "The ``PyExc_RecursionErrorInst`` singleton that was part of the public API " "has been removed as its members being never cleared may cause a segfault " @@ -2410,7 +2428,7 @@ msgid "" "issue:`22898` and :issue:`30697`." msgstr "" -#: whatsnew/3.7.rst:1704 +#: whatsnew/3.7.rst:1717 msgid "" "Added C API support for timezones with timezone constructors :c:func:" "`PyTimeZone_FromOffset` and :c:func:`PyTimeZone_FromOffsetAndName`, and " @@ -2418,7 +2436,7 @@ msgid "" "Contributed by Paul Ganssle in :issue:`10381`." msgstr "" -#: whatsnew/3.7.rst:1709 +#: whatsnew/3.7.rst:1722 msgid "" "The type of results of :c:func:`PyThread_start_new_thread` and :c:func:" "`PyThread_get_thread_ident`, and the *id* parameter of :c:func:" @@ -2426,14 +2444,14 @@ msgid "" "long`. (Contributed by Serhiy Storchaka in :issue:`6532`.)" msgstr "" -#: whatsnew/3.7.rst:1715 +#: whatsnew/3.7.rst:1728 msgid "" ":c:func:`PyUnicode_AsWideCharString` now raises a :exc:`ValueError` if the " "second argument is ``NULL`` and the :c:expr:`wchar_t*` string contains null " "characters. (Contributed by Serhiy Storchaka in :issue:`30708`.)" msgstr "" -#: whatsnew/3.7.rst:1719 +#: whatsnew/3.7.rst:1732 msgid "" "Changes to the startup sequence and the management of dynamic memory " "allocators mean that the long documented requirement to call :c:func:" @@ -2444,45 +2462,45 @@ msgid "" "details." msgstr "" -#: whatsnew/3.7.rst:1727 +#: whatsnew/3.7.rst:1740 msgid "" "The new :c:func:`PyInterpreterState_GetID` returns the unique ID for a given " "interpreter. (Contributed by Eric Snow in :issue:`29102`.)" msgstr "" -#: whatsnew/3.7.rst:1731 +#: whatsnew/3.7.rst:1744 msgid "" ":c:func:`Py_DecodeLocale`, :c:func:`Py_EncodeLocale` now use the UTF-8 " "encoding when the :ref:`UTF-8 mode ` is enabled. " "(Contributed by Victor Stinner in :issue:`29240`.)" msgstr "" -#: whatsnew/3.7.rst:1735 +#: whatsnew/3.7.rst:1748 msgid "" ":c:func:`PyUnicode_DecodeLocaleAndSize` and :c:func:`PyUnicode_EncodeLocale` " "now use the current locale encoding for ``surrogateescape`` error handler. " "(Contributed by Victor Stinner in :issue:`29240`.)" msgstr "" -#: whatsnew/3.7.rst:1739 +#: whatsnew/3.7.rst:1752 msgid "" "The *start* and *end* parameters of :c:func:`PyUnicode_FindChar` are now " "adjusted to behave like string slices. (Contributed by Xiang Zhang in :issue:" "`28822`.)" msgstr "" -#: whatsnew/3.7.rst:1745 +#: whatsnew/3.7.rst:1758 msgid "Build Changes" msgstr "" -#: whatsnew/3.7.rst:1747 +#: whatsnew/3.7.rst:1760 msgid "" "Support for building ``--without-threads`` has been removed. The :mod:" "`threading` module is now always available. (Contributed by Antoine Pitrou " "in :issue:`31370`.)." msgstr "" -#: whatsnew/3.7.rst:1751 +#: whatsnew/3.7.rst:1764 msgid "" "A full copy of libffi is no longer bundled for use when building the :mod:" "`_ctypes ` module on non-OSX UNIX platforms. An installed copy of " @@ -2490,7 +2508,7 @@ msgid "" "(Contributed by Zachary Ware in :issue:`27979`.)" msgstr "" -#: whatsnew/3.7.rst:1756 +#: whatsnew/3.7.rst:1769 msgid "" "The Windows build process no longer depends on Subversion to pull in " "external sources, a Python script is used to download zipfiles from GitHub " @@ -2499,7 +2517,7 @@ msgid "" "by Zachary Ware in :issue:`30450`.)" msgstr "" -#: whatsnew/3.7.rst:1762 +#: whatsnew/3.7.rst:1775 msgid "" "The :mod:`ssl` module requires OpenSSL 1.0.2 or 1.1 compatible libssl. " "OpenSSL 1.0.1 has reached end of lifetime on 2016-12-31 and is no longer " @@ -2507,11 +2525,11 @@ msgid "" "up to version 2.6.4 are missing required OpenSSL 1.0.2 APIs." msgstr "" -#: whatsnew/3.7.rst:1771 +#: whatsnew/3.7.rst:1784 msgid "Optimizations" msgstr "" -#: whatsnew/3.7.rst:1773 +#: whatsnew/3.7.rst:1786 msgid "" "The overhead of calling many methods of various standard library classes " "implemented in C has been significantly reduced by porting more code to use " @@ -2519,85 +2537,85 @@ msgid "" "`29300`, :issue:`29507`, :issue:`29452`, and :issue:`29286`.)" msgstr "" -#: whatsnew/3.7.rst:1779 +#: whatsnew/3.7.rst:1792 msgid "" "Various optimizations have reduced Python startup time by 10% on Linux and " "up to 30% on macOS. (Contributed by Victor Stinner, INADA Naoki in :issue:" "`29585`, and Ivan Levkivskyi in :issue:`31333`.)" msgstr "" -#: whatsnew/3.7.rst:1784 +#: whatsnew/3.7.rst:1797 msgid "" "Method calls are now up to 20% faster due to the bytecode changes which " "avoid creating bound method instances. (Contributed by Yury Selivanov and " "INADA Naoki in :issue:`26110`.)" msgstr "" -#: whatsnew/3.7.rst:1790 +#: whatsnew/3.7.rst:1803 msgid "" "The :mod:`asyncio` module received a number of notable optimizations for " "commonly used functions:" msgstr "" -#: whatsnew/3.7.rst:1793 +#: whatsnew/3.7.rst:1806 msgid "" "The :func:`asyncio.get_event_loop` function has been reimplemented in C to " "make it up to 15 times faster. (Contributed by Yury Selivanov in :issue:" "`32296`.)" msgstr "" -#: whatsnew/3.7.rst:1797 +#: whatsnew/3.7.rst:1810 msgid "" ":class:`asyncio.Future` callback management has been optimized. (Contributed " "by Yury Selivanov in :issue:`32348`.)" msgstr "" -#: whatsnew/3.7.rst:1800 +#: whatsnew/3.7.rst:1813 msgid "" ":func:`asyncio.gather` is now up to 15% faster. (Contributed by Yury " "Selivanov in :issue:`32355`.)" msgstr "" -#: whatsnew/3.7.rst:1803 +#: whatsnew/3.7.rst:1816 msgid "" ":func:`asyncio.sleep` is now up to 2 times faster when the *delay* argument " "is zero or negative. (Contributed by Andrew Svetlov in :issue:`32351`.)" msgstr "" -#: whatsnew/3.7.rst:1807 +#: whatsnew/3.7.rst:1820 msgid "" "The performance overhead of asyncio debug mode has been reduced. " "(Contributed by Antoine Pitrou in :issue:`31970`.)" msgstr "" -#: whatsnew/3.7.rst:1810 +#: whatsnew/3.7.rst:1823 msgid "" "As a result of :ref:`PEP 560 work `, the import time of :" "mod:`typing` has been reduced by a factor of 7, and many typing operations " "are now faster. (Contributed by Ivan Levkivskyi in :issue:`32226`.)" msgstr "" -#: whatsnew/3.7.rst:1815 +#: whatsnew/3.7.rst:1828 msgid "" ":func:`sorted` and :meth:`list.sort` have been optimized for common cases to " "be up to 40-75% faster. (Contributed by Elliot Gorokhovsky in :issue:" "`28685`.)" msgstr "" -#: whatsnew/3.7.rst:1819 +#: whatsnew/3.7.rst:1832 msgid "" ":meth:`dict.copy` is now up to 5.5 times faster. (Contributed by Yury " "Selivanov in :issue:`31179`.)" msgstr "" -#: whatsnew/3.7.rst:1822 +#: whatsnew/3.7.rst:1835 msgid "" ":func:`hasattr` and :func:`getattr` are now about 4 times faster when *name* " "is not found and *obj* does not override :meth:`object.__getattr__` or :meth:" "`object.__getattribute__`. (Contributed by INADA Naoki in :issue:`32544`.)" msgstr "" -#: whatsnew/3.7.rst:1827 +#: whatsnew/3.7.rst:1840 msgid "" "Searching for certain Unicode characters (like Ukrainian capital \"Є\") in a " "string was up to 25 times slower than searching for other characters. It is " @@ -2605,7 +2623,7 @@ msgid "" "in :issue:`24821`.)" msgstr "" -#: whatsnew/3.7.rst:1832 +#: whatsnew/3.7.rst:1845 msgid "" "The :func:`collections.namedtuple` factory has been reimplemented to make " "the creation of named tuples 4 to 6 times faster. (Contributed by Jelle " @@ -2613,33 +2631,33 @@ msgid "" "Raymond Hettinger in :issue:`28638`.)" msgstr "" -#: whatsnew/3.7.rst:1837 +#: whatsnew/3.7.rst:1850 msgid "" ":meth:`date.fromordinal` and :meth:`date.fromtimestamp` are now up to 30% " "faster in the common case. (Contributed by Paul Ganssle in :issue:`32403`.)" msgstr "" -#: whatsnew/3.7.rst:1841 +#: whatsnew/3.7.rst:1854 msgid "" "The :func:`os.fwalk` function is now up to 2 times faster thanks to the use " "of :func:`os.scandir`. (Contributed by Serhiy Storchaka in :issue:`25996`.)" msgstr "" -#: whatsnew/3.7.rst:1845 +#: whatsnew/3.7.rst:1858 msgid "" "The speed of the :func:`shutil.rmtree` function has been improved by 20--40% " "thanks to the use of the :func:`os.scandir` function. (Contributed by Serhiy " "Storchaka in :issue:`28564`.)" msgstr "" -#: whatsnew/3.7.rst:1849 +#: whatsnew/3.7.rst:1862 msgid "" "Optimized case-insensitive matching and searching of :mod:`regular " "expressions `. Searching some patterns can now be up to 20 times " "faster. (Contributed by Serhiy Storchaka in :issue:`30285`.)" msgstr "" -#: whatsnew/3.7.rst:1853 +#: whatsnew/3.7.rst:1866 msgid "" ":func:`re.compile` now converts ``flags`` parameter to int object if it is " "``RegexFlag``. It is now as fast as Python 3.5, and faster than Python 3.6 " @@ -2647,7 +2665,7 @@ msgid "" "`31671`.)" msgstr "" -#: whatsnew/3.7.rst:1858 +#: whatsnew/3.7.rst:1871 msgid "" "The :meth:`~selectors.BaseSelector.modify` methods of classes :class:" "`selectors.EpollSelector`, :class:`selectors.PollSelector` and :class:" @@ -2655,7 +2673,7 @@ msgid "" "(Contributed by Giampaolo Rodola' in :issue:`30014`)" msgstr "" -#: whatsnew/3.7.rst:1863 +#: whatsnew/3.7.rst:1876 msgid "" "Constant folding has been moved from the peephole optimizer to the new AST " "optimizer, which is able perform optimizations more consistently. " @@ -2663,7 +2681,7 @@ msgid "" "`11549`.)" msgstr "" -#: whatsnew/3.7.rst:1868 +#: whatsnew/3.7.rst:1881 msgid "" "Most functions and methods in :mod:`abc` have been rewritten in C. This " "makes creation of abstract base classes, and calling :func:`isinstance` and :" @@ -2672,7 +2690,7 @@ msgid "" "`31333`)" msgstr "" -#: whatsnew/3.7.rst:1874 +#: whatsnew/3.7.rst:1887 msgid "" "Significant speed improvements to alternate constructors for :class:" "`datetime.date` and :class:`datetime.datetime` by using fast-path " @@ -2680,7 +2698,7 @@ msgid "" "in :issue:`32403`)" msgstr "" -#: whatsnew/3.7.rst:1879 +#: whatsnew/3.7.rst:1892 msgid "" "The speed of comparison of :class:`array.array` instances has been improved " "considerably in certain cases. It is now from 10x to 70x faster when " @@ -2688,18 +2706,18 @@ msgid "" "Adrian Wielgosik in :issue:`24700`.)" msgstr "" -#: whatsnew/3.7.rst:1884 +#: whatsnew/3.7.rst:1897 msgid "" "The :func:`math.erf` and :func:`math.erfc` functions now use the (faster) C " "library implementation on most platforms. (Contributed by Serhiy Storchaka " "in :issue:`26121`.)" msgstr "" -#: whatsnew/3.7.rst:1890 +#: whatsnew/3.7.rst:1903 msgid "Other CPython Implementation Changes" msgstr "" -#: whatsnew/3.7.rst:1892 +#: whatsnew/3.7.rst:1905 msgid "" "Trace hooks may now opt out of receiving the ``line`` and opt into receiving " "the ``opcode`` events from the interpreter by setting the corresponding new :" @@ -2707,7 +2725,7 @@ msgid "" "the frame being traced. (Contributed by Nick Coghlan in :issue:`31344`.)" msgstr "" -#: whatsnew/3.7.rst:1897 +#: whatsnew/3.7.rst:1910 msgid "" "Fixed some consistency problems with namespace package module attributes. " "Namespace module objects now have an ``__file__`` that is set to ``None`` " @@ -2718,14 +2736,14 @@ msgid "" "`32303`." msgstr "" -#: whatsnew/3.7.rst:1905 +#: whatsnew/3.7.rst:1918 msgid "" "The :func:`locals` dictionary now displays in the lexical order that " "variables were defined. Previously, the order was undefined. (Contributed " "by Raymond Hettinger in :issue:`32690`.)" msgstr "" -#: whatsnew/3.7.rst:1909 +#: whatsnew/3.7.rst:1922 msgid "" "The ``distutils`` ``upload`` command no longer tries to change CR end-of-" "line characters to CRLF. This fixes a corruption issue with sdists that " @@ -2733,11 +2751,11 @@ msgid "" "`32304`.)" msgstr "" -#: whatsnew/3.7.rst:1916 +#: whatsnew/3.7.rst:1929 msgid "Deprecated Python Behavior" msgstr "" -#: whatsnew/3.7.rst:1918 +#: whatsnew/3.7.rst:1931 msgid "" "Yield expressions (both ``yield`` and ``yield from`` clauses) are now " "deprecated in comprehensions and generator expressions (aside from the " @@ -2751,7 +2769,7 @@ msgid "" "Storchaka in :issue:`10544`.)" msgstr "" -#: whatsnew/3.7.rst:1929 +#: whatsnew/3.7.rst:1942 msgid "" "Returning a subclass of :class:`complex` from :meth:`object.__complex__` is " "deprecated and will be an error in future Python versions. This makes " @@ -2759,22 +2777,22 @@ msgid "" "__float__`. (Contributed by Serhiy Storchaka in :issue:`28894`.)" msgstr "" -#: whatsnew/3.7.rst:1938 +#: whatsnew/3.7.rst:1951 msgid "Deprecated Python modules, functions and methods" msgstr "" -#: whatsnew/3.7.rst:1941 +#: whatsnew/3.7.rst:1954 msgid "aifc" msgstr "" -#: whatsnew/3.7.rst:1943 +#: whatsnew/3.7.rst:1956 msgid "" ":func:`aifc.openfp` has been deprecated and will be removed in Python 3.9. " "Use :func:`aifc.open` instead. (Contributed by Brian Curtin in :issue:" "`31985`.)" msgstr "" -#: whatsnew/3.7.rst:1953 +#: whatsnew/3.7.rst:1966 msgid "" "Support for directly ``await``-ing instances of :class:`asyncio.Lock` and " "other asyncio synchronization primitives has been deprecated. An " @@ -2783,14 +2801,14 @@ msgid "" "`32253`.)" msgstr "" -#: whatsnew/3.7.rst:1959 +#: whatsnew/3.7.rst:1972 msgid "" "The :meth:`asyncio.Task.current_task` and :meth:`asyncio.Task.all_tasks` " "methods have been deprecated. (Contributed by Andrew Svetlov in :issue:" "`32250`.)" msgstr "" -#: whatsnew/3.7.rst:1967 +#: whatsnew/3.7.rst:1980 msgid "" "In Python 3.8, the abstract base classes in :mod:`collections.abc` will no " "longer be exposed in the regular :mod:`collections` module. This will help " @@ -2798,7 +2816,7 @@ msgid "" "base classes. (Contributed by Serhiy Storchaka in :issue:`25988`.)" msgstr "" -#: whatsnew/3.7.rst:1977 +#: whatsnew/3.7.rst:1990 msgid "" ":mod:`dbm.dumb` now supports reading read-only files and no longer writes " "the index file when it is not changed. A deprecation warning is now emitted " @@ -2807,7 +2825,7 @@ msgid "" "Storchaka in :issue:`28847`.)" msgstr "" -#: whatsnew/3.7.rst:1987 +#: whatsnew/3.7.rst:2000 msgid "" "In Python 3.8, attempting to check for non-Enum objects in :class:`Enum` " "classes will raise a :exc:`TypeError` (e.g. ``1 in Color``); similarly, " @@ -2817,18 +2835,18 @@ msgid "" "`33217`.)" msgstr "" -#: whatsnew/3.7.rst:1996 +#: whatsnew/3.7.rst:2009 msgid "gettext" msgstr "" -#: whatsnew/3.7.rst:1998 +#: whatsnew/3.7.rst:2011 msgid "" "Using non-integer value for selecting a plural form in :mod:`gettext` is now " "deprecated. It never correctly worked. (Contributed by Serhiy Storchaka in :" "issue:`28692`.)" msgstr "" -#: whatsnew/3.7.rst:2006 +#: whatsnew/3.7.rst:2019 msgid "" "Methods :meth:`!MetaPathFinder.find_module()` (replaced by :meth:" "`MetaPathFinder.find_spec() `) and :" @@ -2838,40 +2856,40 @@ msgid "" "Bussonnier in :issue:`29576`.)" msgstr "" -#: whatsnew/3.7.rst:2017 +#: whatsnew/3.7.rst:2030 msgid "" "The :class:`importlib.abc.ResourceLoader` ABC has been deprecated in favour " "of :class:`importlib.abc.ResourceReader`." msgstr "" -#: whatsnew/3.7.rst:2024 +#: whatsnew/3.7.rst:2037 msgid "" ":func:`locale.format` has been deprecated, use :meth:`locale.format_string` " "instead. (Contributed by Garvit in :issue:`10379`.)" msgstr "" -#: whatsnew/3.7.rst:2029 +#: whatsnew/3.7.rst:2042 msgid "macpath" msgstr "" -#: whatsnew/3.7.rst:2031 +#: whatsnew/3.7.rst:2044 msgid "" "The :mod:`macpath` is now deprecated and will be removed in Python 3.8. " "(Contributed by Chi Hsuan Yen in :issue:`9850`.)" msgstr "" -#: whatsnew/3.7.rst:2036 +#: whatsnew/3.7.rst:2049 msgid "threading" msgstr "" -#: whatsnew/3.7.rst:2038 +#: 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:" "`threading` instead. (Contributed by Antoine Pitrou in :issue:`31370`.)" msgstr "" -#: whatsnew/3.7.rst:2047 +#: whatsnew/3.7.rst:2060 msgid "" "The silent argument value truncation in :func:`socket.htons` and :func:" "`socket.ntohs` has been deprecated. In future versions of Python, if the " @@ -2879,52 +2897,52 @@ msgid "" "(Contributed by Oren Milman in :issue:`28332`.)" msgstr "" -#: whatsnew/3.7.rst:2056 +#: whatsnew/3.7.rst:2069 msgid "" ":func:`ssl.wrap_socket` is deprecated. Use :meth:`ssl.SSLContext." "wrap_socket` instead. (Contributed by Christian Heimes in :issue:`28124`.)" msgstr "" -#: whatsnew/3.7.rst:2062 +#: whatsnew/3.7.rst:2075 msgid "sunau" msgstr "" -#: whatsnew/3.7.rst:2064 +#: whatsnew/3.7.rst:2077 msgid "" ":func:`sunau.openfp` has been deprecated and will be removed in Python 3.9. " "Use :func:`sunau.open` instead. (Contributed by Brian Curtin in :issue:" "`31985`.)" msgstr "" -#: whatsnew/3.7.rst:2072 +#: whatsnew/3.7.rst:2085 msgid "" "Deprecated :func:`sys.set_coroutine_wrapper` and :func:`sys." "get_coroutine_wrapper`." msgstr "" -#: whatsnew/3.7.rst:2075 +#: whatsnew/3.7.rst:2088 msgid "" "The undocumented ``sys.callstats()`` function has been deprecated and will " "be removed in a future Python version. (Contributed by Victor Stinner in :" "issue:`28799`.)" msgstr "" -#: whatsnew/3.7.rst:2081 +#: whatsnew/3.7.rst:2094 msgid "wave" msgstr "" -#: whatsnew/3.7.rst:2083 +#: whatsnew/3.7.rst:2096 msgid "" ":func:`wave.openfp` has been deprecated and will be removed in Python 3.9. " "Use :func:`wave.open` instead. (Contributed by Brian Curtin in :issue:" "`31985`.)" msgstr "" -#: whatsnew/3.7.rst:2089 +#: whatsnew/3.7.rst:2102 msgid "Deprecated functions and types of the C API" msgstr "" -#: whatsnew/3.7.rst:2091 +#: whatsnew/3.7.rst:2104 msgid "" "Function :c:func:`PySlice_GetIndicesEx` is deprecated and replaced with a " "macro if ``Py_LIMITED_API`` is not set or set to a value in the range " @@ -2933,7 +2951,7 @@ msgid "" "`27867`.)" msgstr "" -#: whatsnew/3.7.rst:2096 +#: whatsnew/3.7.rst:2109 msgid "" ":c:func:`PyOS_AfterFork` has been deprecated. Use :c:func:" "`PyOS_BeforeFork`, :c:func:`PyOS_AfterFork_Parent` or :c:func:" @@ -2941,15 +2959,15 @@ msgid "" "`16500`.)" msgstr "" -#: whatsnew/3.7.rst:2104 +#: whatsnew/3.7.rst:2117 msgid "Platform Support Removals" msgstr "" -#: whatsnew/3.7.rst:2106 +#: whatsnew/3.7.rst:2119 msgid "FreeBSD 9 and older are no longer officially supported." msgstr "" -#: whatsnew/3.7.rst:2107 +#: whatsnew/3.7.rst:2120 msgid "" "For full Unicode support, including within extension modules, \\*nix " "platforms are now expected to provide at least one of ``C.UTF-8`` (full " @@ -2957,7 +2975,7 @@ msgid "" "an alternative to the legacy ``ASCII``-based ``C`` locale." msgstr "" -#: whatsnew/3.7.rst:2111 +#: whatsnew/3.7.rst:2124 msgid "" "OpenSSL 0.9.8 and 1.0.1 are no longer supported, which means building " "CPython 3.7 with SSL/TLS support on older platforms still using these " @@ -2965,14 +2983,14 @@ msgid "" "OpenSSL." msgstr "" -#: whatsnew/3.7.rst:2115 +#: whatsnew/3.7.rst:2128 msgid "" "Notably, this issue affects the Debian 8 (aka \"jessie\") and Ubuntu 14.04 " "(aka \"Trusty\") LTS Linux distributions, as they still use OpenSSL 1.0.1 by " "default." msgstr "" -#: whatsnew/3.7.rst:2119 +#: whatsnew/3.7.rst:2132 msgid "" "Debian 9 (\"stretch\") and Ubuntu 16.04 (\"xenial\"), as well as recent " "releases of other LTS Linux releases (e.g. RHEL/CentOS 7.5, SLES 12-SP3), " @@ -2980,7 +2998,7 @@ msgid "" "configuration." msgstr "" -#: whatsnew/3.7.rst:2123 +#: whatsnew/3.7.rst:2136 msgid "" "CPython's own `CI configuration file `_ provides an example of using the SSL :source:" @@ -2989,41 +3007,41 @@ msgid "" "outdated system provided OpenSSL." msgstr "" -#: whatsnew/3.7.rst:2132 +#: whatsnew/3.7.rst:2145 msgid "API and Feature Removals" msgstr "" -#: whatsnew/3.7.rst:2134 +#: whatsnew/3.7.rst:2147 msgid "The following features and APIs have been removed from Python 3.7:" msgstr "" -#: whatsnew/3.7.rst:2136 +#: whatsnew/3.7.rst:2149 msgid "" "The ``os.stat_float_times()`` function has been removed. It was introduced " "in Python 2.3 for backward compatibility with Python 2.2, and was deprecated " "since Python 3.1." msgstr "" -#: whatsnew/3.7.rst:2140 +#: whatsnew/3.7.rst:2153 msgid "" "Unknown escapes consisting of ``'\\'`` and an ASCII letter in replacement " "templates for :func:`re.sub` were deprecated in Python 3.5, and will now " "cause an error." msgstr "" -#: whatsnew/3.7.rst:2144 +#: whatsnew/3.7.rst:2157 msgid "" "Removed support of the *exclude* argument in :meth:`tarfile.TarFile.add`. It " "was deprecated in Python 2.7 and 3.2. Use the *filter* argument instead." msgstr "" -#: whatsnew/3.7.rst:2147 +#: whatsnew/3.7.rst:2160 msgid "" "The :func:`!ntpath.splitunc` function was deprecated in Python 3.1, and has " "now been removed. Use :func:`~os.path.splitdrive` instead." msgstr "" -#: whatsnew/3.7.rst:2151 +#: whatsnew/3.7.rst:2164 msgid "" ":func:`collections.namedtuple` no longer supports the *verbose* parameter or " "``_source`` attribute which showed the generated source code for the named " @@ -3032,14 +3050,14 @@ msgid "" "Naoki, Serhiy Storchaka, and Raymond Hettinger in :issue:`28638`.)" msgstr "" -#: whatsnew/3.7.rst:2157 +#: whatsnew/3.7.rst:2170 msgid "" "Functions :func:`bool`, :func:`float`, :func:`list` and :func:`tuple` no " "longer take keyword arguments. The first argument of :func:`int` can now be " "passed only as positional argument." msgstr "" -#: whatsnew/3.7.rst:2161 +#: whatsnew/3.7.rst:2174 msgid "" "Removed previously deprecated in Python 2.4 classes ``Plist``, ``Dict`` and " "``_InternalDict`` in the :mod:`plistlib` module. Dict values in the result " @@ -3048,7 +3066,7 @@ msgid "" "access to access items of these dictionaries." msgstr "" -#: whatsnew/3.7.rst:2167 +#: whatsnew/3.7.rst:2180 msgid "" "The ``asyncio.windows_utils.socketpair()`` function has been removed. Use " "the :func:`socket.socketpair` function instead, it is available on all " @@ -3056,14 +3074,14 @@ msgid "" "alias to ``socket.socketpair`` on Python 3.5 and newer." msgstr "" -#: whatsnew/3.7.rst:2173 +#: 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``." msgstr "" -#: whatsnew/3.7.rst:2178 +#: whatsnew/3.7.rst:2191 msgid "" "Direct instantiation of :class:`ssl.SSLSocket` and :class:`ssl.SSLObject` " "objects is now prohibited. The constructors were never documented, tested, " @@ -3072,17 +3090,17 @@ msgid "" "in :issue:`32951`.)" msgstr "" -#: whatsnew/3.7.rst:2184 +#: whatsnew/3.7.rst:2197 msgid "" "The unused ``distutils`` ``install_misc`` command has been removed. " "(Contributed by Eric N. Vander Weele in :issue:`29218`.)" msgstr "" -#: whatsnew/3.7.rst:2189 +#: whatsnew/3.7.rst:2202 msgid "Module Removals" msgstr "" -#: whatsnew/3.7.rst:2191 +#: whatsnew/3.7.rst:2204 msgid "" "The ``fpectl`` module has been removed. It was never enabled by default, " "never worked correctly on x86-64, and it changed the Python ABI in ways that " @@ -3090,11 +3108,11 @@ msgid "" "Smith in :issue:`29137`.)" msgstr "" -#: whatsnew/3.7.rst:2474 +#: whatsnew/3.7.rst:2487 msgid "Windows-only Changes" msgstr "" -#: whatsnew/3.7.rst:2200 +#: whatsnew/3.7.rst:2213 msgid "" "The python launcher, (py.exe), can accept 32 & 64 bit specifiers **without** " "having to specify a minor version as well. So ``py -3-32`` and ``py -3-64`` " @@ -3104,7 +3122,7 @@ msgid "" "(Contributed by Steve Barnes in :issue:`30291`.)" msgstr "" -#: whatsnew/3.7.rst:2207 +#: whatsnew/3.7.rst:2220 msgid "" "The launcher can be run as ``py -0`` to produce a list of the installed " "pythons, *with default marked with an asterisk*. Running ``py -0p`` will " @@ -3113,28 +3131,28 @@ msgid "" "(Contributed by Steve Barnes in :issue:`30362`.)" msgstr "" -#: whatsnew/3.7.rst:2217 +#: whatsnew/3.7.rst:2230 msgid "Porting to Python 3.7" msgstr "" -#: whatsnew/3.7.rst:2219 +#: whatsnew/3.7.rst:2232 msgid "" "This section lists previously described changes and other bugfixes that may " "require changes to your code." msgstr "" -#: whatsnew/3.7.rst:2224 +#: whatsnew/3.7.rst:2237 msgid "Changes in Python Behavior" msgstr "" -#: whatsnew/3.7.rst:2226 +#: whatsnew/3.7.rst:2239 msgid "" ":keyword:`async` and :keyword:`await` names are now reserved keywords. Code " "using these names as identifiers will now raise a :exc:`SyntaxError`. " "(Contributed by Jelle Zijlstra in :issue:`30406`.)" msgstr "" -#: whatsnew/3.7.rst:2230 +#: whatsnew/3.7.rst:2243 msgid "" ":pep:`479` is enabled for all code in Python 3.7, meaning that :exc:" "`StopIteration` exceptions raised directly or indirectly in coroutines and " @@ -3142,19 +3160,19 @@ msgid "" "by Yury Selivanov in :issue:`32670`.)" msgstr "" -#: whatsnew/3.7.rst:2236 +#: whatsnew/3.7.rst:2249 msgid "" ":meth:`object.__aiter__` methods can no longer be declared as asynchronous. " "(Contributed by Yury Selivanov in :issue:`31709`.)" msgstr "" -#: whatsnew/3.7.rst:2239 +#: whatsnew/3.7.rst:2252 msgid "" "Due to an oversight, earlier Python versions erroneously accepted the " "following syntax::" msgstr "" -#: whatsnew/3.7.rst:2247 +#: whatsnew/3.7.rst:2260 msgid "" "Python 3.7 now correctly raises a :exc:`SyntaxError`, as a generator " "expression always needs to be directly inside a set of parentheses and " @@ -3163,7 +3181,7 @@ msgid "" "`32012` and :issue:`32023`.)" msgstr "" -#: whatsnew/3.7.rst:2253 +#: whatsnew/3.7.rst:2266 msgid "" "When using the :option:`-m` switch, the initial working directory is now " "added to :data:`sys.path`, rather than an empty string (which dynamically " @@ -3175,11 +3193,11 @@ msgid "" "place)." msgstr "" -#: whatsnew/3.7.rst:2263 +#: whatsnew/3.7.rst:2276 msgid "Changes in the Python API" msgstr "" -#: whatsnew/3.7.rst:2265 +#: whatsnew/3.7.rst:2278 msgid "" ":meth:`socketserver.ThreadingMixIn.server_close` now waits until all non-" "daemon threads complete. Set the new :attr:`socketserver.ThreadingMixIn." @@ -3187,7 +3205,7 @@ msgid "" "(Contributed by Victor Stinner in :issue:`31233` and :issue:`33540`.)" msgstr "" -#: whatsnew/3.7.rst:2271 +#: whatsnew/3.7.rst:2284 msgid "" ":meth:`socketserver.ForkingMixIn.server_close` now waits until all child " "processes complete. Set the new :attr:`socketserver.ForkingMixIn." @@ -3195,21 +3213,21 @@ msgid "" "(Contributed by Victor Stinner in :issue:`31151` and :issue:`33540`.)" msgstr "" -#: whatsnew/3.7.rst:2277 +#: whatsnew/3.7.rst:2290 msgid "" "The :func:`locale.localeconv` function now temporarily sets the ``LC_CTYPE`` " "locale to the value of ``LC_NUMERIC`` in some cases. (Contributed by Victor " "Stinner in :issue:`31900`.)" msgstr "" -#: whatsnew/3.7.rst:2281 +#: whatsnew/3.7.rst:2294 msgid "" ":meth:`pkgutil.walk_packages` now raises a :exc:`ValueError` if *path* is a " "string. Previously an empty list was returned. (Contributed by Sanyam " "Khurana in :issue:`24744`.)" msgstr "" -#: whatsnew/3.7.rst:2285 +#: whatsnew/3.7.rst:2298 msgid "" "A format string argument for :meth:`string.Formatter.format` is now :ref:" "`positional-only `. Passing it as a keyword " @@ -3217,7 +3235,7 @@ msgid "" "issue:`29193`.)" msgstr "" -#: whatsnew/3.7.rst:2290 +#: whatsnew/3.7.rst:2303 msgid "" "Attributes :attr:`~http.cookies.Morsel.key`, :attr:`~http.cookies.Morsel." "value` and :attr:`~http.cookies.Morsel.coded_value` of class :class:`http." @@ -3226,7 +3244,7 @@ msgid "" "them. (Contributed by Serhiy Storchaka in :issue:`29192`.)" msgstr "" -#: whatsnew/3.7.rst:2298 +#: whatsnew/3.7.rst:2311 msgid "" "The *mode* argument of :func:`os.makedirs` no longer affects the file " "permission bits of newly created intermediate-level directories. To set " @@ -3234,13 +3252,13 @@ msgid "" "``makedirs()``. (Contributed by Serhiy Storchaka in :issue:`19930`.)" msgstr "" -#: whatsnew/3.7.rst:2304 +#: whatsnew/3.7.rst:2317 msgid "" "The :attr:`struct.Struct.format` type is now :class:`str` instead of :class:" "`bytes`. (Contributed by Victor Stinner in :issue:`21071`.)" msgstr "" -#: whatsnew/3.7.rst:2307 +#: whatsnew/3.7.rst:2320 msgid "" ":func:`~cgi.parse_multipart` now accepts the *encoding* and *errors* " "arguments and returns the same results as :class:`!FieldStorage`: for non-" @@ -3248,27 +3266,27 @@ msgid "" "(Contributed by Pierre Quentel in :issue:`29979`.)" msgstr "" -#: whatsnew/3.7.rst:2313 +#: whatsnew/3.7.rst:2326 msgid "" "Due to internal changes in :mod:`socket`, calling :func:`socket.fromshare` " "on a socket created by :func:`socket.share ` in older " "Python versions is not supported." msgstr "" -#: whatsnew/3.7.rst:2317 +#: whatsnew/3.7.rst:2330 msgid "" "``repr`` for :exc:`BaseException` has changed to not include the trailing " "comma. Most exceptions are affected by this change. (Contributed by Serhiy " "Storchaka in :issue:`30399`.)" msgstr "" -#: whatsnew/3.7.rst:2321 +#: whatsnew/3.7.rst:2334 msgid "" "``repr`` for :class:`datetime.timedelta` has changed to include the keyword " "arguments in the output. (Contributed by Utkarsh Upadhyay in :issue:`30302`.)" msgstr "" -#: whatsnew/3.7.rst:2324 +#: whatsnew/3.7.rst:2337 msgid "" "Because :func:`shutil.rmtree` is now implemented using the :func:`os." "scandir` function, the user specified handler *onerror* is now called with " @@ -3276,7 +3294,7 @@ msgid "" "directory is failed." msgstr "" -#: whatsnew/3.7.rst:2329 +#: whatsnew/3.7.rst:2342 msgid "" "Support for nested sets and set operations in regular expressions as in " "`Unicode Technical Standard #18`_ might be added in the future. This would " @@ -3287,7 +3305,7 @@ msgid "" "with a backslash. (Contributed by Serhiy Storchaka in :issue:`30349`.)" msgstr "" -#: whatsnew/3.7.rst:2340 +#: whatsnew/3.7.rst:2353 msgid "" "The result of splitting a string on a :mod:`regular expression ` that " "could match an empty string has been changed. For example splitting on " @@ -3298,7 +3316,7 @@ msgid "" "patterns since Python 3.5." msgstr "" -#: whatsnew/3.7.rst:2349 +#: whatsnew/3.7.rst:2362 msgid "" "For patterns that match both empty and non-empty strings, the result of " "searching for all matches may also be changed in other cases. For example " @@ -3308,7 +3326,7 @@ msgid "" "as ``r'(?m)^[^\\S\\n]*$'``." msgstr "" -#: whatsnew/3.7.rst:2356 +#: whatsnew/3.7.rst:2369 msgid "" ":func:`re.sub()` now replaces empty matches adjacent to a previous non-empty " "match. For example ``re.sub('x*', '-', 'abxd')`` returns now ``'-a-b--d-'`` " @@ -3316,25 +3334,25 @@ msgid "" "and the second minus replaces an empty string between 'x' and 'd')." msgstr "" -#: whatsnew/3.7.rst:2362 +#: whatsnew/3.7.rst:2375 msgid "(Contributed by Serhiy Storchaka in :issue:`25054` and :issue:`32308`.)" msgstr "" -#: whatsnew/3.7.rst:2364 +#: whatsnew/3.7.rst:2377 msgid "" "Change :func:`re.escape` to only escape regex special characters instead of " "escaping all characters other than ASCII letters, numbers, and ``'_'``. " "(Contributed by Serhiy Storchaka in :issue:`29995`.)" msgstr "" -#: whatsnew/3.7.rst:2368 +#: whatsnew/3.7.rst:2381 msgid "" ":class:`tracemalloc.Traceback` frames are now sorted from oldest to most " "recent to be more consistent with :mod:`traceback`. (Contributed by Jesse " "Bakker in :issue:`32121`.)" msgstr "" -#: whatsnew/3.7.rst:2372 +#: whatsnew/3.7.rst:2385 msgid "" "On OSes that support :const:`socket.SOCK_NONBLOCK` or :const:`socket." "SOCK_CLOEXEC` bit flags, the :attr:`socket.type ` no " @@ -3343,7 +3361,7 @@ msgid "" "Selivanov in :issue:`32331`.)" msgstr "" -#: whatsnew/3.7.rst:2379 +#: whatsnew/3.7.rst:2392 msgid "" "On Windows the default for the *close_fds* argument of :class:`subprocess." "Popen` was changed from :const:`False` to :const:`True` when redirecting the " @@ -3353,7 +3371,7 @@ msgid "" "`STARTUPINFO.lpAttributeList `." msgstr "" -#: whatsnew/3.7.rst:2387 +#: whatsnew/3.7.rst:2400 msgid "" ":meth:`importlib.machinery.PathFinder.invalidate_caches` -- which implicitly " "affects :func:`importlib.invalidate_caches` -- now deletes entries in :data:" @@ -3361,7 +3379,7 @@ msgid "" "Cannon in :issue:`33169`.)" msgstr "" -#: whatsnew/3.7.rst:2392 +#: whatsnew/3.7.rst:2405 msgid "" "In :mod:`asyncio`, :meth:`loop.sock_recv() `, :meth:" "`loop.sock_sendall() `, :meth:`loop.sock_accept() " @@ -3372,21 +3390,21 @@ msgid "" "(Contributed by Yury Selivanov in :issue:`32327`.)" msgstr "" -#: whatsnew/3.7.rst:2403 +#: whatsnew/3.7.rst:2416 msgid "" ":attr:`asyncio.Server.sockets` now returns a copy of the internal list of " "server sockets, instead of returning it directly. (Contributed by Yury " "Selivanov in :issue:`32662`.)" msgstr "" -#: whatsnew/3.7.rst:2407 +#: whatsnew/3.7.rst:2420 msgid "" ":attr:`Struct.format ` is now a :class:`str` instance " "instead of a :class:`bytes` instance. (Contributed by Victor Stinner in :" "issue:`21071`.)" msgstr "" -#: whatsnew/3.7.rst:2411 +#: whatsnew/3.7.rst:2424 msgid "" ":mod:`argparse` subparsers can now be made mandatory by passing " "``required=True`` to :meth:`ArgumentParser.add_subparsers() ` will now " "consistently raise an exception when a date falls outside of the " @@ -3413,13 +3431,13 @@ msgid "" "date`. (Contributed by Alexander Belopolsky in :issue:`28292`.)" msgstr "" -#: whatsnew/3.7.rst:2429 +#: whatsnew/3.7.rst:2442 msgid "" ":class:`collections.ChainMap` now preserves the order of the underlying " "mappings. (Contributed by Raymond Hettinger in :issue:`32792`.)" msgstr "" -#: whatsnew/3.7.rst:2432 +#: whatsnew/3.7.rst:2445 msgid "" "The ``submit()`` method of :class:`concurrent.futures.ThreadPoolExecutor` " "and :class:`concurrent.futures.ProcessPoolExecutor` now raises a :exc:" @@ -3427,7 +3445,7 @@ msgid "" "Nemec in :issue:`33097`.)" msgstr "" -#: whatsnew/3.7.rst:2437 +#: whatsnew/3.7.rst:2450 msgid "" "The :class:`configparser.ConfigParser` constructor now uses ``read_dict()`` " "to process the default values, making its behavior consistent with the rest " @@ -3436,7 +3454,7 @@ msgid "" "in :issue:`23835`.)" msgstr "" -#: whatsnew/3.7.rst:2443 +#: whatsnew/3.7.rst:2456 msgid "" "Several undocumented internal imports were removed. One example is that ``os." "errno`` is no longer available; use ``import errno`` directly instead. Note " @@ -3444,11 +3462,11 @@ msgid "" "notice, even in micro version releases." msgstr "" -#: whatsnew/3.7.rst:2451 +#: whatsnew/3.7.rst:2464 msgid "Changes in the C API" msgstr "" -#: whatsnew/3.7.rst:2453 +#: whatsnew/3.7.rst:2466 msgid "" "The function :c:func:`PySlice_GetIndicesEx` is considered unsafe for " "resizable sequences. If the slice indices are not instances of :class:" @@ -3460,23 +3478,23 @@ msgid "" "Storchaka in :issue:`27867`.)" msgstr "" -#: whatsnew/3.7.rst:2464 +#: whatsnew/3.7.rst:2477 msgid "CPython bytecode changes" msgstr "" -#: whatsnew/3.7.rst:2466 +#: whatsnew/3.7.rst:2479 msgid "" "There are two new opcodes: :opcode:`LOAD_METHOD` and :opcode:`CALL_METHOD`. " "(Contributed by Yury Selivanov and INADA Naoki in :issue:`26110`.)" msgstr "" -#: whatsnew/3.7.rst:2469 +#: whatsnew/3.7.rst:2482 msgid "" "The :opcode:`STORE_ANNOTATION` opcode has been removed. (Contributed by Mark " "Shannon in :issue:`32550`.)" msgstr "" -#: whatsnew/3.7.rst:2476 +#: whatsnew/3.7.rst:2489 msgid "" "The file used to override :data:`sys.path` is now called ``._pth`` instead of ``'sys.path'``. See :ref:" @@ -3484,11 +3502,11 @@ msgid "" "in :issue:`28137`.)" msgstr "" -#: whatsnew/3.7.rst:2483 +#: whatsnew/3.7.rst:2496 msgid "Other CPython implementation changes" msgstr "" -#: whatsnew/3.7.rst:2485 +#: whatsnew/3.7.rst:2498 msgid "" "In preparation for potential future changes to the public CPython runtime " "initialization API (see :pep:`432` for an initial, but somewhat outdated, " @@ -3503,21 +3521,21 @@ msgid "" "Stinner in a number of other issues). Some known details affected:" msgstr "" -#: whatsnew/3.7.rst:2498 +#: whatsnew/3.7.rst:2511 msgid "" ":c:func:`PySys_AddWarnOptionUnicode` is not currently usable by embedding " "applications due to the requirement to create a Unicode object prior to " "calling ``Py_Initialize``. Use :c:func:`PySys_AddWarnOption` instead." msgstr "" -#: whatsnew/3.7.rst:2502 +#: whatsnew/3.7.rst:2515 msgid "" "warnings filters added by an embedding application with :c:func:" "`PySys_AddWarnOption` should now more consistently take precedence over the " "default filters set by the interpreter" msgstr "" -#: whatsnew/3.7.rst:2506 +#: whatsnew/3.7.rst:2519 msgid "" "Due to changes in the way the default warnings filters are configured, " "setting :c:data:`Py_BytesWarningFlag` to a value greater than one is no " @@ -3527,7 +3545,7 @@ msgid "" "BytesWarning`` warnings filter added to convert them to exceptions." msgstr "" -#: whatsnew/3.7.rst:2513 +#: whatsnew/3.7.rst:2526 msgid "" "Due to a change in the way docstrings are handled by the compiler, the " "implicit ``return None`` in a function body consisting solely of a docstring " @@ -3535,7 +3553,7 @@ msgid "" "function's header line." msgstr "" -#: whatsnew/3.7.rst:2518 +#: whatsnew/3.7.rst:2531 msgid "" "The current exception state has been moved from the frame object to the co-" "routine. This simplified the interpreter and fixed a couple of obscure bugs " @@ -3543,11 +3561,11 @@ msgid "" "(Contributed by Mark Shannon in :issue:`25612`.)" msgstr "" -#: whatsnew/3.7.rst:2524 +#: whatsnew/3.7.rst:2537 msgid "Notable changes in Python 3.7.1" msgstr "" -#: whatsnew/3.7.rst:2526 +#: whatsnew/3.7.rst:2539 msgid "" "Starting in 3.7.1, :c:func:`Py_Initialize` now consistently reads and " "respects all of the same environment settings as :c:func:`Py_Main` (in " @@ -3557,14 +3575,14 @@ msgid "" "`Py_IgnoreEnvironmentFlag` to 1 before calling :c:func:`Py_Initialize`." msgstr "" -#: whatsnew/3.7.rst:2533 +#: whatsnew/3.7.rst:2546 msgid "" "In 3.7.1 the C API for Context Variables :ref:`was updated " "` to use :c:type:`PyObject` " "pointers. See also :issue:`34762`." msgstr "" -#: whatsnew/3.7.rst:2537 +#: whatsnew/3.7.rst:2550 msgid "" "In 3.7.1 the :mod:`tokenize` module now implicitly emits a ``NEWLINE`` token " "when provided with input that does not have a trailing new line. This " @@ -3572,11 +3590,11 @@ msgid "" "Ammar Askar in :issue:`33899`.)" msgstr "" -#: whatsnew/3.7.rst:2543 +#: whatsnew/3.7.rst:2556 msgid "Notable changes in Python 3.7.2" msgstr "" -#: whatsnew/3.7.rst:2545 +#: whatsnew/3.7.rst:2558 msgid "" "In 3.7.2, :mod:`venv` on Windows no longer copies the original binaries, but " "creates redirector scripts named ``python.exe`` and ``pythonw.exe`` instead. " @@ -3586,11 +3604,11 @@ msgid "" "to get the new scripts." msgstr "" -#: whatsnew/3.7.rst:2553 +#: whatsnew/3.7.rst:2566 msgid "Notable changes in Python 3.7.6" msgstr "" -#: whatsnew/3.7.rst:2555 +#: whatsnew/3.7.rst:2568 msgid "" "Due to significant security concerns, the *reuse_address* parameter of :meth:" "`asyncio.loop.create_datagram_endpoint` is no longer supported. This is " @@ -3600,11 +3618,11 @@ msgid "" "`37228`.)" msgstr "" -#: whatsnew/3.7.rst:2563 +#: whatsnew/3.7.rst:2576 msgid "Notable changes in Python 3.7.10" msgstr "" -#: whatsnew/3.7.rst:2565 +#: whatsnew/3.7.rst:2578 msgid "" "Earlier Python versions allowed using both ``;`` and ``&`` as query " "parameter separators in :func:`urllib.parse.parse_qs` and :func:`urllib." @@ -3615,3 +3633,44 @@ msgid "" "For more details, please see their respective documentation. (Contributed by " "Adam Goldschmidt, Senthil Kumaran and Ken Jin in :issue:`42967`.)" msgstr "" + +#: whatsnew/3.7.rst:2589 +msgid "Notable changes in Python 3.7.11" +msgstr "" + +#: whatsnew/3.7.rst:2591 +msgid "" +"A security fix alters the :class:`ftplib.FTP` behavior to not trust the IPv4 " +"address sent from the remote server when setting up a passive data channel. " +"We reuse the ftp server IP address instead. For unusual code requiring the " +"old behavior, set a ``trust_server_pasv_ipv4_address`` attribute on your FTP " +"instance to ``True``. (See :gh:`87451`)" +msgstr "" + +#: whatsnew/3.7.rst:2598 +msgid "" +"The presence of newline or tab characters in parts of a URL allows for some " +"forms of attacks. Following the WHATWG specification that updates RFC 3986, " +"ASCII newline ``\\n``, ``\\r`` and tab ``\\t`` characters are stripped from " +"the URL by the parser :func:`urllib.parse` preventing such attacks. The " +"removal characters are controlled by a new module level variable ``urllib." +"parse._UNSAFE_URL_BYTES_TO_REMOVE``. (See :gh:`88048`)" +msgstr "" + +#: whatsnew/3.7.rst:2606 +msgid "Notable security feature in 3.7.14" +msgstr "" + +#: whatsnew/3.7.rst:2608 +msgid "" +"Converting between :class:`int` and :class:`str` in bases other than 2 " +"(binary), 4, 8 (octal), 16 (hexadecimal), or 32 such as base 10 (decimal) " +"now raises a :exc:`ValueError` if the number of digits in string form is " +"above a limit to avoid potential denial of service attacks due to the " +"algorithmic complexity. This is a mitigation for `CVE-2020-10735 `_. This limit can be " +"configured or disabled by environment variable, command line flag, or :mod:" +"`sys` APIs. See the :ref:`integer string conversion length limitation " +"` documentation. The default limit is 4300 digits in " +"string form." +msgstr "" diff --git a/whatsnew/3.8.po b/whatsnew/3.8.po index 99a019b0b..f525c63fb 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-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: 2023-02-03 17:30+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1212,12 +1212,13 @@ msgid "datetime" msgstr "datetime" #: whatsnew/3.8.rst:756 +#, fuzzy msgid "" "Added new alternate constructors :meth:`datetime.date.fromisocalendar` and :" -"meth:`datetime.datetime.fromisocalendar`, which construct :class:`date` and :" -"class:`datetime` objects respectively from ISO year, week number, and " -"weekday; these are the inverse of each class's ``isocalendar`` method. " -"(Contributed by Paul Ganssle in :issue:`36004`.)" +"meth:`datetime.datetime.fromisocalendar`, which construct :class:`~datetime." +"date` and :class:`~datetime.datetime` objects respectively from ISO year, " +"week number, and weekday; these are the inverse of each class's " +"``isocalendar`` method. (Contributed by Paul Ganssle in :issue:`36004`.)" msgstr "" "ISO yılı, hafta numarası ve haftanın gününden sırasıyla :class:`date` ve :" "class:`datetime` nesnelerini oluşturan yeni alternatif kurucular :meth:" @@ -2015,7 +2016,7 @@ msgstr "" "çıkardığında veya çöp toplama sırasında (:func:`gc.collect`). (Victor " "Stinner'ın :issue:`36829` 'daki katkısıyla.)" -#: whatsnew/3.8.rst:1250 +#: whatsnew/3.8.rst:2351 msgid "tarfile" msgstr "tarfile" @@ -2772,9 +2773,10 @@ msgstr "" "Elizondo'nun :issue:`35810` 'daki katkısıyla.)" #: whatsnew/3.8.rst:1626 +#, fuzzy msgid "" -"The new function :c:func:`PyCode_NewWithPosOnlyArgs` allows to create code " -"objects like :c:func:`PyCode_New`, but with an extra *posonlyargcount* " +"The new function :c:func:`!PyCode_NewWithPosOnlyArgs` allows to create code " +"objects like :c:func:`!PyCode_New`, but with an extra *posonlyargcount* " "parameter for indicating the number of positional-only arguments. " "(Contributed by Pablo Galindo in :issue:`37221`.)" msgstr "" @@ -3300,7 +3302,7 @@ msgstr "" "kontrolünü yaparak çağrıyı koruyun. (Joannah Nanjekye'nin :issue:`36475` " "'teki katkısıyla.)" -#: whatsnew/3.8.rst:1858 +#: whatsnew/3.8.rst:2321 msgid "Changes in the Python API" msgstr "Python API'sindeki değişiklikler" @@ -3948,10 +3950,35 @@ msgstr "" "Pitrou ve Yury Selivanov'un :issue:`37228` 'deki katkılarıyla.)" #: whatsnew/3.8.rst:2247 +#, fuzzy +msgid "Notable changes in Python 3.8.2" +msgstr "Python 3.8.12'deki önemli değişiklikler" + +#: whatsnew/3.8.rst:2249 +msgid "" +"Fixed a regression with the ``ignore`` callback of :func:`shutil.copytree`. " +"The argument types are now str and List[str] again. (Contributed by Manuel " +"Barkhau and Giampaolo Rodola in :gh:`83571`.)" +msgstr "" + +#: whatsnew/3.8.rst:2254 +#, fuzzy +msgid "Notable changes in Python 3.8.3" +msgstr "Python 3.8.1'deki önemli değişiklikler" + +#: whatsnew/3.8.rst:2256 +msgid "" +"The constant values of future flags in the :mod:`__future__` module are " +"updated in order to prevent collision with compiler flags. Previously " +"``PyCF_ALLOW_TOP_LEVEL_AWAIT`` was clashing with ``CO_FUTURE_DIVISION``. " +"(Contributed by Batuhan Taskaya in :gh:`83743`)" +msgstr "" + +#: whatsnew/3.8.rst:2262 msgid "Notable changes in Python 3.8.8" msgstr "Python 3.8.8'deki önemli değişiklikler" -#: whatsnew/3.8.rst:2249 +#: whatsnew/3.8.rst:2264 msgid "" "Earlier Python versions allowed using both ``;`` and ``&`` as query " "parameter separators in :func:`urllib.parse.parse_qs` and :func:`urllib." @@ -3972,11 +3999,68 @@ msgstr "" "belgelere bakın. (Adam Goldschmidt, Senthil Kumaran ve Ken Jin'in :issue:" "`42967` 'deki katkılarıyla.)" -#: whatsnew/3.8.rst:2260 +#: whatsnew/3.8.rst:2275 +#, fuzzy +msgid "Notable changes in Python 3.8.9" +msgstr "Python 3.8.1'deki önemli değişiklikler" + +#: whatsnew/3.8.rst:2277 +msgid "" +"A security fix alters the :class:`ftplib.FTP` behavior to not trust the IPv4 " +"address sent from the remote server when setting up a passive data channel. " +"We reuse the ftp server IP address instead. For unusual code requiring the " +"old behavior, set a ``trust_server_pasv_ipv4_address`` attribute on your FTP " +"instance to ``True``. (See :gh:`87451`)" +msgstr "" + +#: whatsnew/3.8.rst:2304 +#, fuzzy +msgid "Notable changes in Python 3.8.10" +msgstr "Python 3.8.1'deki önemli değişiklikler" + +#: whatsnew/3.8.rst:2287 +msgid "macOS 11.0 (Big Sur) and Apple Silicon Mac support" +msgstr "" + +#: whatsnew/3.8.rst:2289 +msgid "" +"As of 3.8.10, Python now supports building and running on macOS 11 (Big Sur) " +"and on Apple Silicon Macs (based on the ``ARM64`` architecture). A new " +"universal build variant, ``universal2``, is now available to natively " +"support both ``ARM64`` and ``Intel 64`` in one set of executables. Note that " +"support for \"weaklinking\", building binaries targeted for newer versions " +"of macOS that will also run correctly on older versions by testing at " +"runtime for missing features, is not included in this backport from Python " +"3.9; to support a range of macOS versions, continue to target for and build " +"on the oldest version in the range." +msgstr "" + +#: whatsnew/3.8.rst:2299 +msgid "" +"(Originally contributed by Ronald Oussoren and Lawrence D'Anna in :gh:" +"`85272`, with fixes by FX Coudert and Eli Rykoff, and backported to 3.8 by " +"Maxime Bélanger and Ned Deily)" +msgstr "" + +#: whatsnew/3.8.rst:2307 +msgid "urllib.parse" +msgstr "" + +#: whatsnew/3.8.rst:2309 +msgid "" +"The presence of newline or tab characters in parts of a URL allows for some " +"forms of attacks. Following the WHATWG specification that updates :rfc:" +"`3986`, ASCII newline ``\\n``, ``\\r`` and tab ``\\t`` characters are " +"stripped from the URL by the parser in :mod:`urllib.parse` preventing such " +"attacks. The removal characters are controlled by a new module level " +"variable ``urllib.parse._UNSAFE_URL_BYTES_TO_REMOVE``. (See :issue:`43882`)" +msgstr "" + +#: whatsnew/3.8.rst:2318 msgid "Notable changes in Python 3.8.12" msgstr "Python 3.8.12'deki önemli değişiklikler" -#: whatsnew/3.8.rst:2262 +#: whatsnew/3.8.rst:2323 msgid "" "Starting with Python 3.8.12 the :mod:`ipaddress` module no longer accepts " "any leading zeros in IPv4 address strings. Leading zeros are ambiguous and " @@ -3992,7 +4076,7 @@ msgstr "" "sıfırları sekizli gösterim olarak ele alır. Modern :func:`~socket.inet_pton` " "glibc uygulaması baştaki sıfırları kabul etmez." -#: whatsnew/3.8.rst:2269 +#: whatsnew/3.8.rst:2330 msgid "" "(Originally contributed by Christian Heimes in :issue:`36384`, and " "backported to 3.8 by Achraf Merzouki.)" @@ -4000,6 +4084,41 @@ msgstr "" "(Aslen :issue:`36384` içinde Christian Heimes tarafından katkıda " "bulunulmuştur ve Achraf Merzouki tarafından 3.8'e geri aktarılmıştır.)" +#: whatsnew/3.8.rst:2334 +#, fuzzy +msgid "Notable security feature in 3.8.14" +msgstr "Python 3.8.1'deki önemli değişiklikler" + +#: whatsnew/3.8.rst:2336 +msgid "" +"Converting between :class:`int` and :class:`str` in bases other than 2 " +"(binary), 4, 8 (octal), 16 (hexadecimal), or 32 such as base 10 (decimal) " +"now raises a :exc:`ValueError` if the number of digits in string form is " +"above a limit to avoid potential denial of service attacks due to the " +"algorithmic complexity. This is a mitigation for `CVE-2020-10735 `_. This limit can be " +"configured or disabled by environment variable, command line flag, or :mod:" +"`sys` APIs. See the :ref:`integer string conversion length limitation " +"` documentation. The default limit is 4300 digits in " +"string form." +msgstr "" + +#: whatsnew/3.8.rst:2348 +#, fuzzy +msgid "Notable changes in 3.8.17" +msgstr "Python 3.8.1'deki önemli değişiklikler" + +#: whatsnew/3.8.rst:2353 +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 " +"surprising or dangerous, such as creating files outside the destination " +"directory. See :ref:`tarfile-extraction-filter` for details. In Python 3.12, " +"use without the *filter* argument will show a :exc:`DeprecationWarning`. In " +"Python 3.14, the default will switch to ``'data'``. (Contributed by Petr " +"Viktorin in :pep:`706`.)" +msgstr "" + #~ msgid "" #~ "Added :meth:`pathlib.Path.link_to()` which creates a hard link pointing " #~ "to a path. (Contributed by Joannah Nanjekye in :issue:`26978`)" diff --git a/whatsnew/3.9.po b/whatsnew/3.9.po index 1abe23bc0..8dbb3019d 100644 --- a/whatsnew/3.9.po +++ b/whatsnew/3.9.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-02-24 17:22+0000\n" "PO-Revision-Date: 2023-03-01 11:48+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -3181,7 +3181,7 @@ msgstr "" "`DeprecationWarning` bir :exc:`TypeError` olacaktır. ( :issue:`42195` içinde " "Ken Jin tarafından katılmıştır.)" -#: whatsnew/3.9.rst:1554 +#: whatsnew/3.9.rst:1579 msgid "urllib.parse" msgstr "urllib.parse" @@ -3206,5 +3206,73 @@ msgstr "" "için lütfen ilgili belgelere bakın. (Adam Goldschmidt, Senthil Kumaran ve " "Ken Jin'in katkılarıyla :issue:`42967`.)" +#: whatsnew/3.9.rst:1567 +#, fuzzy +msgid "Notable changes in Python 3.9.3" +msgstr "Python 3.9.1'deki önemli değişiklikler" + +#: whatsnew/3.9.rst:1569 +msgid "" +"A security fix alters the :class:`ftplib.FTP` behavior to not trust the IPv4 " +"address sent from the remote server when setting up a passive data channel. " +"We reuse the ftp server IP address instead. For unusual code requiring the " +"old behavior, set a ``trust_server_pasv_ipv4_address`` attribute on your FTP " +"instance to ``True``. (See :gh:`87451`)" +msgstr "" + +#: whatsnew/3.9.rst:1576 +#, fuzzy +msgid "Notable changes in Python 3.9.5" +msgstr "Python 3.9.1'deki önemli değişiklikler" + +#: whatsnew/3.9.rst:1581 +msgid "" +"The presence of newline or tab characters in parts of a URL allows for some " +"forms of attacks. Following the WHATWG specification that updates :rfc:" +"`3986`, ASCII newline ``\\n``, ``\\r`` and tab ``\\t`` characters are " +"stripped from the URL by the parser in :mod:`urllib.parse` preventing such " +"attacks. The removal characters are controlled by a new module level " +"variable ``urllib.parse._UNSAFE_URL_BYTES_TO_REMOVE``. (See :gh:`88048`)" +msgstr "" + +#: whatsnew/3.9.rst:1589 +#, fuzzy +msgid "Notable security feature in 3.9.14" +msgstr "Python 3.9.1'deki önemli değişiklikler" + +#: whatsnew/3.9.rst:1591 +msgid "" +"Converting between :class:`int` and :class:`str` in bases other than 2 " +"(binary), 4, 8 (octal), 16 (hexadecimal), or 32 such as base 10 (decimal) " +"now raises a :exc:`ValueError` if the number of digits in string form is " +"above a limit to avoid potential denial of service attacks due to the " +"algorithmic complexity. This is a mitigation for `CVE-2020-10735 `_. This limit can be " +"configured or disabled by environment variable, command line flag, or :mod:" +"`sys` APIs. See the :ref:`integer string conversion length limitation " +"` documentation. The default limit is 4300 digits in " +"string form." +msgstr "" + +#: whatsnew/3.9.rst:1603 +#, fuzzy +msgid "Notable changes in 3.9.17" +msgstr "Python 3.9.1'deki önemli değişiklikler" + +#: whatsnew/3.9.rst:1606 +msgid "tarfile" +msgstr "" + +#: whatsnew/3.9.rst:1608 +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 " +"surprising or dangerous, such as creating files outside the destination " +"directory. See :ref:`tarfile-extraction-filter` for details. In Python 3.12, " +"use without the *filter* argument will show a :exc:`DeprecationWarning`. In " +"Python 3.14, the default will switch to ``'data'``. (Contributed by Petr " +"Viktorin in :pep:`706`.)" +msgstr "" + #~ msgid "For full details, see the :ref:`changelog `." #~ msgstr "Tüm detaylar için, :ref:`changelog` 'a bakınız." From 61b5ddb27665df1f4324b9e2cd7a4b0af12caf6c Mon Sep 17 00:00:00 2001 From: python-docs-turkish Date: Sat, 24 Feb 2024 17:23:29 +0000 Subject: [PATCH 2/2] Get changes from CPython Doc for 3.12 --- c-api/hash.po | 57 +++++++ howto/gdb_helpers.po | 395 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 452 insertions(+) create mode 100644 c-api/hash.po create mode 100644 howto/gdb_helpers.po diff --git a/c-api/hash.po b/c-api/hash.po new file mode 100644 index 000000000..2a2bb75eb --- /dev/null +++ b/c-api/hash.po @@ -0,0 +1,57 @@ +# 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-02-24 17:22+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" + +#: c-api/hash.rst:4 +msgid "PyHash API" +msgstr "" + +#: c-api/hash.rst:6 +msgid "See also the :c:member:`PyTypeObject.tp_hash` member." +msgstr "" + +#: c-api/hash.rst:10 +msgid "Hash value type: signed integer." +msgstr "" + +#: c-api/hash.rst:16 +msgid "Hash value type: unsigned integer." +msgstr "" + +#: c-api/hash.rst:23 +msgid "Hash function definition used by :c:func:`PyHash_GetFuncDef`." +msgstr "" + +#: c-api/hash.rst:31 +msgid "Hash function name (UTF-8 encoded string)." +msgstr "" + +#: c-api/hash.rst:35 +msgid "Internal size of the hash value in bits." +msgstr "" + +#: c-api/hash.rst:39 +msgid "Size of seed input in bits." +msgstr "" + +#: c-api/hash.rst:46 +msgid "Get the hash function definition." +msgstr "" + +#: c-api/hash.rst:49 +msgid ":pep:`456` \"Secure and interchangeable hash algorithm\"." +msgstr "" diff --git a/howto/gdb_helpers.po b/howto/gdb_helpers.po new file mode 100644 index 000000000..5879c9e10 --- /dev/null +++ b/howto/gdb_helpers.po @@ -0,0 +1,395 @@ +# 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-02-24 17:22+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" + +#: howto/gdb_helpers.rst:5 +msgid "Debugging C API extensions and CPython Internals with GDB" +msgstr "" + +#: howto/gdb_helpers.rst:9 +msgid "" +"This document explains how the Python GDB extension, ``python-gdb.py``, can " +"be used with the GDB debugger to debug CPython extensions and the CPython " +"interpreter itself." +msgstr "" + +#: howto/gdb_helpers.rst:13 +msgid "" +"When debugging low-level problems such as crashes or deadlocks, a low-level " +"debugger, such as GDB, is useful to diagnose and correct the issue. By " +"default, GDB (or any of its front-ends) doesn't support high-level " +"information specific to the CPython interpreter." +msgstr "" + +#: howto/gdb_helpers.rst:18 +msgid "" +"The ``python-gdb.py`` extension adds CPython interpreter information to GDB. " +"The extension helps introspect the stack of currently executing Python " +"functions. Given a Python object represented by a :c:expr:`PyObject *` " +"pointer, the extension surfaces the type and value of the object." +msgstr "" + +#: howto/gdb_helpers.rst:23 +msgid "" +"Developers who are working on CPython extensions or tinkering with parts of " +"CPython that are written in C can use this document to learn how to use the " +"``python-gdb.py`` extension with GDB." +msgstr "" + +#: howto/gdb_helpers.rst:29 +msgid "" +"This document assumes that you are familiar with the basics of GDB and the " +"CPython C API. It consolidates guidance from the `devguide `_ and the `Python wiki `_." +msgstr "" + +#: howto/gdb_helpers.rst:36 +msgid "Prerequisites" +msgstr "" + +#: howto/gdb_helpers.rst:38 +msgid "You need to have:" +msgstr "" + +#: howto/gdb_helpers.rst:40 +msgid "" +"GDB 7 or later. (For earlier versions of GDB, see ``Misc/gdbinit`` in the " +"sources of Python 3.11 or earlier.)" +msgstr "" + +#: howto/gdb_helpers.rst:42 +msgid "" +"GDB-compatible debugging information for Python and any extension you are " +"debugging." +msgstr "" + +#: howto/gdb_helpers.rst:44 +msgid "The ``python-gdb.py`` extension." +msgstr "" + +#: howto/gdb_helpers.rst:46 +msgid "" +"The extension is built with Python, but might be distributed separately or " +"not at all. Below, we include tips for a few common systems as examples. " +"Note that even if the instructions match your system, they might be outdated." +msgstr "" + +#: howto/gdb_helpers.rst:52 +msgid "Setup with Python built from source" +msgstr "" + +#: howto/gdb_helpers.rst:54 +msgid "" +"When you build CPython from source, debugging information should be " +"available, and the build should add a ``python-gdb.py`` file to the root " +"directory of your repository." +msgstr "" + +#: howto/gdb_helpers.rst:58 +msgid "" +"To activate support, you must add the directory containing ``python-gdb.py`` " +"to GDB's \"auto-load-safe-path\". If you haven't done this, recent versions " +"of GDB will print out a warning with instructions on how to do this." +msgstr "" + +#: howto/gdb_helpers.rst:65 +msgid "" +"If you do not see instructions for your version of GDB, put this in your " +"configuration file (``~/.gdbinit`` or ``~/.config/gdb/gdbinit``)::" +msgstr "" + +#: howto/gdb_helpers.rst:70 +msgid "You can also add multiple paths, separated by ``:``." +msgstr "" + +#: howto/gdb_helpers.rst:74 +msgid "Setup for Python from a Linux distro" +msgstr "" + +#: howto/gdb_helpers.rst:76 +msgid "" +"Most Linux systems provide debug information for the system Python in a " +"package called ``python-debuginfo``, ``python-dbg`` or similar. For example:" +msgstr "" + +#: howto/gdb_helpers.rst:80 +msgid "Fedora:" +msgstr "" + +#: howto/gdb_helpers.rst:87 +msgid "Ubuntu:" +msgstr "" + +#: howto/gdb_helpers.rst:93 +msgid "" +"On several recent Linux systems, GDB can download debugging symbols " +"automatically using *debuginfod*. However, this will not install the " +"``python-gdb.py`` extension; you generally do need to install the debug info " +"package separately." +msgstr "" + +#: howto/gdb_helpers.rst:100 +msgid "Using the Debug build and Development mode" +msgstr "" + +#: howto/gdb_helpers.rst:102 +msgid "For easier debugging, you might want to:" +msgstr "" + +#: howto/gdb_helpers.rst:104 +msgid "" +"Use a :ref:`debug build ` of Python. (When building from " +"source, use ``configure --with-pydebug``. On Linux distros, install and run " +"a package like ``python-debug`` or ``python-dbg``, if available.)" +msgstr "" + +#: howto/gdb_helpers.rst:107 +msgid "Use the runtime :ref:`development mode ` (``-X dev``)." +msgstr "" + +#: howto/gdb_helpers.rst:109 +msgid "" +"Both enable extra assertions and disable some optimizations. Sometimes this " +"hides the bug you are trying to find, but in most cases they make the " +"process easier." +msgstr "" + +#: howto/gdb_helpers.rst:115 +msgid "Using the ``python-gdb`` extension" +msgstr "" + +#: howto/gdb_helpers.rst:117 +msgid "" +"When the extension is loaded, it provides two main features: pretty printers " +"for Python values, and additional commands." +msgstr "" + +#: howto/gdb_helpers.rst:121 +msgid "Pretty-printers" +msgstr "" + +#: howto/gdb_helpers.rst:123 +msgid "" +"This is what a GDB backtrace looks like (truncated) when this extension is " +"enabled::" +msgstr "" + +#: howto/gdb_helpers.rst:142 +msgid "" +"Notice how the dictionary argument to ``PyDict_GetItemString`` is displayed " +"as its ``repr()``, rather than an opaque ``PyObject *`` pointer." +msgstr "" + +#: howto/gdb_helpers.rst:145 +msgid "" +"The extension works by supplying a custom printing routine for values of " +"type ``PyObject *``. If you need to access lower-level details of an " +"object, then cast the value to a pointer of the appropriate type. For " +"example::" +msgstr "" + +#: howto/gdb_helpers.rst:168 +msgid "" +"Note that the pretty-printers do not actually call ``repr()``. For basic " +"types, they try to match its result closely." +msgstr "" + +#: howto/gdb_helpers.rst:171 +msgid "" +"An area that can be confusing is that the custom printer for some types look " +"a lot like GDB's built-in printer for standard types. For example, the " +"pretty-printer for a Python ``int`` (:c:expr:`PyLongObject *`) gives a " +"representation that is not distinguishable from one of a regular machine-" +"level integer::" +msgstr "" + +#: howto/gdb_helpers.rst:183 +msgid "" +"The internal structure can be revealed with a cast to :c:expr:`PyLongObject " +"*`:" +msgstr "" + +#: howto/gdb_helpers.rst:185 +msgid "" +"(gdb) p *(PyLongObject*)some_python_integer $5 = {ob_base = {ob_base = " +"{ob_refcnt = 8, ob_type = 0x3dad39f5e0}, ob_size = 1}, ob_digit = {42}}" +msgstr "" + +#: howto/gdb_helpers.rst:189 +msgid "" +"A similar confusion can arise with the ``str`` type, where the output looks " +"a lot like gdb's built-in printer for ``char *``::" +msgstr "" + +#: howto/gdb_helpers.rst:195 +msgid "" +"The pretty-printer for ``str`` instances defaults to using single-quotes (as " +"does Python's ``repr`` for strings) whereas the standard printer for ``char " +"*`` values uses double-quotes and contains a hexadecimal address::" +msgstr "" + +#: howto/gdb_helpers.rst:202 +msgid "" +"Again, the implementation details can be revealed with a cast to :c:expr:" +"`PyUnicodeObject *`::" +msgstr "" + +#: howto/gdb_helpers.rst:210 +msgid "``py-list``" +msgstr "" + +#: howto/gdb_helpers.rst:212 +msgid "" +"The extension adds a ``py-list`` command, which lists the Python source code " +"(if any) for the current frame in the selected thread. The current line is " +"marked with a \">\"::" +msgstr "" + +#: howto/gdb_helpers.rst:229 +msgid "" +"Use ``py-list START`` to list at a different line number within the Python " +"source, and ``py-list START,END`` to list a specific range of lines within " +"the Python source." +msgstr "" + +#: howto/gdb_helpers.rst:234 +msgid "``py-up`` and ``py-down``" +msgstr "" + +#: howto/gdb_helpers.rst:236 +msgid "" +"The ``py-up`` and ``py-down`` commands are analogous to GDB's regular ``up`` " +"and ``down`` commands, but try to move at the level of CPython frames, " +"rather than C frames." +msgstr "" + +#: howto/gdb_helpers.rst:240 +msgid "" +"GDB is not always able to read the relevant frame information, depending on " +"the optimization level with which CPython was compiled. Internally, the " +"commands look for C frames that are executing the default frame evaluation " +"function (that is, the core bytecode interpreter loop within CPython) and " +"look up the value of the related ``PyFrameObject *``." +msgstr "" + +#: howto/gdb_helpers.rst:246 +msgid "They emit the frame number (at the C level) within the thread." +msgstr "" + +#: howto/gdb_helpers.rst:320 +msgid "For example::" +msgstr "" + +#: howto/gdb_helpers.rst:261 +msgid "so we're at the top of the Python stack." +msgstr "" + +#: howto/gdb_helpers.rst:263 +msgid "" +"The frame numbers correspond to those displayed by GDB's standard " +"``backtrace`` command. The command skips C frames which are not executing " +"Python code." +msgstr "" + +#: howto/gdb_helpers.rst:267 +msgid "Going back down::" +msgstr "" + +#: howto/gdb_helpers.rst:289 +msgid "and we're at the bottom of the Python stack." +msgstr "" + +#: howto/gdb_helpers.rst:291 +msgid "" +"Note that in Python 3.12 and newer, the same C stack frame can be used for " +"multiple Python stack frames. This means that ``py-up`` and ``py-down`` may " +"move multiple Python frames at once. For example::" +msgstr "" + +#: howto/gdb_helpers.rst:315 +msgid "``py-bt``" +msgstr "" + +#: howto/gdb_helpers.rst:317 +msgid "" +"The ``py-bt`` command attempts to display a Python-level backtrace of the " +"current thread." +msgstr "" + +#: howto/gdb_helpers.rst:336 +msgid "" +"The frame numbers correspond to those displayed by GDB's standard " +"``backtrace`` command." +msgstr "" + +#: howto/gdb_helpers.rst:340 +msgid "``py-print``" +msgstr "" + +#: howto/gdb_helpers.rst:342 +msgid "" +"The ``py-print`` command looks up a Python name and tries to print it. It " +"looks in locals within the current thread, then globals, then finally " +"builtins::" +msgstr "" + +#: howto/gdb_helpers.rst:356 +msgid "" +"If the current C frame corresponds to multiple Python frames, ``py-print`` " +"only considers the first one." +msgstr "" + +#: howto/gdb_helpers.rst:360 +msgid "``py-locals``" +msgstr "" + +#: howto/gdb_helpers.rst:362 +msgid "" +"The ``py-locals`` command looks up all Python locals within the current " +"Python frame in the selected thread, and prints their representations::" +msgstr "" + +#: howto/gdb_helpers.rst:370 +msgid "" +"If the current C frame corresponds to multiple Python frames, locals from " +"all of them will be shown::" +msgstr "" + +#: howto/gdb_helpers.rst:390 +msgid "Use with GDB commands" +msgstr "" + +#: howto/gdb_helpers.rst:392 +msgid "" +"The extension commands complement GDB's built-in commands. For example, you " +"can use a frame numbers shown by ``py-bt`` with the ``frame`` command to go " +"a specific frame within the selected thread, like this::" +msgstr "" + +#: howto/gdb_helpers.rst:411 +msgid "" +"The ``info threads`` command will give you a list of the threads within the " +"process, and you can use the ``thread`` command to select a different one::" +msgstr "" + +#: howto/gdb_helpers.rst:419 +msgid "" +"You can use ``thread apply all COMMAND`` or (``t a a COMMAND`` for short) to " +"run a command on all threads. With ``py-bt``, this lets you see what every " +"thread is doing at the Python level::" +msgstr "" pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy