From 2ebb7c29f897c48d21ae350c2f400f9c06de093d Mon Sep 17 00:00:00 2001 From: python-docs-turkish Date: Sat, 24 Feb 2024 20:28:15 +0300 Subject: [PATCH] Translation Update 3.12 (#170) --- 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/hash.po | 57 + 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/gdb_helpers.po | 395 +++++++ 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 +- 160 files changed, 13057 insertions(+), 11862 deletions(-) create mode 100644 c-api/hash.po create mode 100644 howto/gdb_helpers.po 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/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/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/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 "" 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."