From a987231e76a233a3384e566125cfab68bc8c36f4 Mon Sep 17 00:00:00 2001 From: python-docs-turkish Date: Wed, 1 Jan 2025 00:23:26 +0000 Subject: [PATCH 1/2] Get changes from CPython Doc for 3.12 --- Makefile | 2 +- about.po | 33 +- c-api/allocation.po | 22 +- c-api/buffer.po | 140 ++-- c-api/init.po | 222 +++---- c-api/object.po | 27 +- c-api/stable.po | 64 +- c-api/type.po | 10 +- deprecations/index.po | 132 ++-- deprecations/pending-removal-in-3.14.po | 96 +-- deprecations/pending-removal-in-3.15.po | 22 +- deprecations/pending-removal-in-3.16.po | 18 +- howto/argparse-optparse.po | 3 +- howto/descriptor.po | 167 ++--- howto/enum.po | 808 ++++++++++++------------ howto/functional.po | 502 +++++++-------- howto/gdb_helpers.po | 10 +- howto/index.po | 108 +++- howto/logging.po | 500 +++++++-------- library/argparse.po | 494 ++++++++------- library/asyncio-eventloop.po | 6 +- library/asyncio-sync.po | 90 +-- library/calendar.po | 172 ++--- library/cmath.po | 55 +- library/collections.po | 8 +- library/ctypes.po | 549 ++++++++-------- library/enum.po | 4 +- library/getopt.po | 49 +- library/http.cookies.po | 8 +- library/importlib.metadata.po | 8 +- library/itertools.po | 4 +- library/locale.po | 141 +++-- library/math.po | 251 ++++---- library/multiprocessing.po | 10 +- library/os.po | 481 +++++++------- library/pprint.po | 4 +- library/shutil.po | 185 +++--- library/socket.po | 458 ++++++++------ library/sqlite3.po | 105 +-- library/ssl.po | 11 +- library/string.po | 319 +++++----- library/sys.po | 529 ++++++++-------- library/time.po | 7 +- library/token.po | 16 +- library/traceback.po | 163 ++--- library/typing.po | 29 +- library/urllib.parse.po | 185 +++--- library/urllib.request.po | 557 ++++++++-------- library/warnings.po | 154 +++-- library/xmlrpc.po | 10 +- reference/datamodel.po | 6 +- reference/expressions.po | 618 +++++++++--------- reference/simple_stmts.po | 111 ++-- tutorial/datastructures.po | 18 +- tutorial/errors.po | 14 +- tutorial/introduction.po | 197 +++--- using/configure.po | 4 +- using/windows.po | 21 +- whatsnew/3.0.po | 144 +++-- whatsnew/3.12.po | 791 +++++++++++------------ whatsnew/3.4.po | 4 +- whatsnew/3.6.po | 12 +- whatsnew/3.7.po | 8 +- whatsnew/3.8.po | 15 +- 64 files changed, 5155 insertions(+), 4756 deletions(-) diff --git a/Makefile b/Makefile index 871a5aa93..3deb136f8 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 := dc3c075d9eebc82c63ec54bb3f217d67b2aea914 +CPYTHON_CURRENT_COMMIT := 7fcba2e3a9747d4b8bbe5a2fea2b66f671130157 LANGUAGE := tr BRANCH := 3.12 diff --git a/about.po b/about.po index d4535b6b1..efd08c5be 100644 --- a/about.po +++ b/about.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: 2025-01-01 00:22+0000\n" "PO-Revision-Date: 2022-12-28 16:16-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -18,19 +18,22 @@ msgstr "" "X-Generator: Poedit 3.2.2\n" #: about.rst:3 -msgid "About these documents" +#, fuzzy +msgid "About this documentation" msgstr "Bu dokümanlar hakkında" #: about.rst:6 +#, fuzzy msgid "" -"These documents are generated from `reStructuredText`_ sources by `Sphinx`_, " -"a document processor specifically written for the Python documentation." +"Python's documentation is generated from `reStructuredText`_ sources using " +"`Sphinx`_, a documentation generator originally created for Python and now " +"maintained as an independent project." msgstr "" "Bu dokümanlar, Python dokümanları için özel olarak yazılmış bir doküman " "işlemcisi olan `Sphinx`_ tarafından `reStructuredText`_ kaynaklarından " "oluşturulur." -#: about.rst:15 +#: about.rst:16 msgid "" "Development of the documentation and its toolchain is an entirely volunteer " "effort, just like Python itself. If you want to contribute, please take a " @@ -42,19 +45,20 @@ msgstr "" "yapacağınıza ilişkin bilgi için lütfen :ref:`reporting-bugs` sayfasına göz " "atın. Yeni gönüllülere her zaman açığız!" -#: about.rst:20 +#: about.rst:21 msgid "Many thanks go to:" msgstr "Destekleri için teşekkürler:" -#: about.rst:22 +#: about.rst:23 +#, fuzzy msgid "" "Fred L. Drake, Jr., the creator of the original Python documentation toolset " -"and writer of much of the content;" +"and author of much of the content;" msgstr "" "Fred L. Drake, Jr., orijinal Python dokümantasyon araç setinin yaratıcısı ve " "içeriğin çoğunun yazarı;" -#: about.rst:24 +#: about.rst:25 msgid "" "the `Docutils `_ project for creating " "reStructuredText and the Docutils suite;" @@ -62,7 +66,7 @@ msgstr "" "`Docutils `_ projesi, reStructuredText ve " "Docutils paketini oluşturdukları için;" -#: about.rst:26 +#: about.rst:27 msgid "" "Fredrik Lundh for his Alternative Python Reference project from which Sphinx " "got many good ideas." @@ -70,11 +74,12 @@ msgstr "" "Fredrik Lundh, Sphinx'in pek çok iyi fikir edindiği Alternatif Python " "Referansı projesi için." -#: about.rst:31 -msgid "Contributors to the Python Documentation" +#: about.rst:32 +#, fuzzy +msgid "Contributors to the Python documentation" msgstr "Python Dokümantasyonuna Katkıda Bulunanlar" -#: about.rst:33 +#: about.rst:34 msgid "" "Many people have contributed to the Python language, the Python standard " "library, and the Python documentation. See :source:`Misc/ACKS` in the " @@ -84,7 +89,7 @@ msgstr "" "dokümantasyonuna katkıda bulunmuştur. Katkıda bulunanların kısmi bir " "listesi için Python kaynak dağıtımında :source:`Misc/ACKS` dosyasına bakın." -#: about.rst:37 +#: about.rst:38 msgid "" "It is only with the input and contributions of the Python community that " "Python has such wonderful documentation -- Thank You!" diff --git a/c-api/allocation.po b/c-api/allocation.po index 8b43cf8ba..fc04a3926 100644 --- a/c-api/allocation.po +++ b/c-api/allocation.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: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -23,19 +23,17 @@ msgstr "" #: c-api/allocation.rst:17 msgid "" "Initialize a newly allocated object *op* with its type and initial " -"reference. Returns the initialized object. If *type* indicates that the " -"object participates in the cyclic garbage detector, it is added to the " -"detector's set of observed objects. Other fields of the object are not " -"affected." +"reference. Returns the initialized object. Other fields of the object are " +"not affected." msgstr "" -#: c-api/allocation.rst:26 +#: c-api/allocation.rst:24 msgid "" "This does everything :c:func:`PyObject_Init` does, and also initializes the " "length information for a variable-size object." msgstr "" -#: c-api/allocation.rst:32 +#: c-api/allocation.rst:30 msgid "" "Allocate a new Python object using the C structure type *TYPE* and the " "Python type object *typeobj* (``PyTypeObject*``). Fields not defined by the " @@ -45,7 +43,7 @@ msgid "" "tp_basicsize` field of the type object." msgstr "" -#: c-api/allocation.rst:43 +#: c-api/allocation.rst:41 msgid "" "Allocate a new Python object using the C structure type *TYPE* and the " "Python type object *typeobj* (``PyTypeObject*``). Fields not defined by the " @@ -58,7 +56,7 @@ msgid "" "management efficiency." msgstr "" -#: c-api/allocation.rst:57 +#: c-api/allocation.rst:55 msgid "" "Releases memory allocated to an object using :c:macro:`PyObject_New` or :c:" "macro:`PyObject_NewVar`. This is normally called from the :c:member:" @@ -67,17 +65,17 @@ msgid "" "no longer a valid Python object." msgstr "" -#: c-api/allocation.rst:66 +#: c-api/allocation.rst:64 msgid "" "Object which is visible in Python as ``None``. This should only be accessed " "using the :c:macro:`Py_None` macro, which evaluates to a pointer to this " "object." msgstr "" -#: c-api/allocation.rst:73 +#: c-api/allocation.rst:71 msgid ":c:func:`PyModule_Create`" msgstr "" -#: c-api/allocation.rst:74 +#: c-api/allocation.rst:72 msgid "To allocate and create extension modules." msgstr "" diff --git a/c-api/buffer.po b/c-api/buffer.po index fde899100..77a9e6f67 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: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -339,16 +339,17 @@ msgid "" "itemsize`, :c:member:`~Py_buffer.ndim`." msgstr "" -#: c-api/buffer.rst:249 +#: c-api/buffer.rst:248 msgid "readonly, format" msgstr "" -#: c-api/buffer.rst:253 +#: c-api/buffer.rst:252 msgid "" "Controls the :c:member:`~Py_buffer.readonly` field. If set, the exporter " "MUST provide a writable buffer or else report failure. Otherwise, the " "exporter MAY provide either a read-only or writable buffer, but the choice " -"MUST be consistent for all consumers." +"MUST be consistent for all consumers. For example, :c:expr:`PyBUF_SIMPLE | " +"PyBUF_WRITABLE` can be used to request a simple writable buffer." msgstr "" #: c-api/buffer.rst:260 @@ -367,137 +368,138 @@ msgstr "" #: c-api/buffer.rst:268 msgid "" -":c:macro:`PyBUF_FORMAT` can be \\|'d to any of the flags except :c:macro:" -"`PyBUF_SIMPLE`. The latter already implies format ``B`` (unsigned bytes)." +":c:macro:`PyBUF_FORMAT` must be \\|'d to any of the flags except :c:macro:" +"`PyBUF_SIMPLE`, because the latter already implies format ``B`` (unsigned " +"bytes). :c:macro:`!PyBUF_FORMAT` cannot be used on its own." msgstr "" -#: c-api/buffer.rst:273 +#: c-api/buffer.rst:274 msgid "shape, strides, suboffsets" msgstr "" -#: c-api/buffer.rst:275 +#: c-api/buffer.rst:276 msgid "" "The flags that control the logical structure of the memory are listed in " "decreasing order of complexity. Note that each flag contains all bits of the " "flags below it." msgstr "" -#: c-api/buffer.rst:306 c-api/buffer.rst:331 +#: c-api/buffer.rst:307 c-api/buffer.rst:332 msgid "Request" msgstr "" -#: c-api/buffer.rst:306 c-api/buffer.rst:331 +#: c-api/buffer.rst:307 c-api/buffer.rst:332 msgid "shape" msgstr "" -#: c-api/buffer.rst:306 c-api/buffer.rst:331 +#: c-api/buffer.rst:307 c-api/buffer.rst:332 msgid "strides" msgstr "" -#: c-api/buffer.rst:306 c-api/buffer.rst:331 +#: c-api/buffer.rst:307 c-api/buffer.rst:332 msgid "suboffsets" msgstr "" -#: c-api/buffer.rst:286 c-api/buffer.rst:308 c-api/buffer.rst:312 -#: c-api/buffer.rst:333 c-api/buffer.rst:337 c-api/buffer.rst:341 -#: c-api/buffer.rst:345 c-api/buffer.rst:347 +#: c-api/buffer.rst:287 c-api/buffer.rst:309 c-api/buffer.rst:313 +#: c-api/buffer.rst:334 c-api/buffer.rst:338 c-api/buffer.rst:342 +#: c-api/buffer.rst:346 c-api/buffer.rst:348 msgid "yes" msgstr "" -#: c-api/buffer.rst:333 c-api/buffer.rst:335 +#: c-api/buffer.rst:334 c-api/buffer.rst:336 msgid "if needed" msgstr "" -#: c-api/buffer.rst:288 c-api/buffer.rst:308 c-api/buffer.rst:312 -#: c-api/buffer.rst:337 c-api/buffer.rst:341 c-api/buffer.rst:345 -#: c-api/buffer.rst:347 +#: c-api/buffer.rst:289 c-api/buffer.rst:309 c-api/buffer.rst:313 +#: c-api/buffer.rst:338 c-api/buffer.rst:342 c-api/buffer.rst:346 +#: c-api/buffer.rst:348 msgid "NULL" msgstr "" -#: c-api/buffer.rst:297 +#: c-api/buffer.rst:298 msgid "contiguity requests" msgstr "" -#: c-api/buffer.rst:299 +#: c-api/buffer.rst:300 msgid "" "C or Fortran :term:`contiguity ` can be explicitly requested, " "with and without stride information. Without stride information, the buffer " "must be C-contiguous." msgstr "" -#: c-api/buffer.rst:331 +#: c-api/buffer.rst:332 msgid "contig" msgstr "" -#: c-api/buffer.rst:314 c-api/buffer.rst:347 +#: c-api/buffer.rst:315 c-api/buffer.rst:348 msgid "C" msgstr "" -#: c-api/buffer.rst:310 +#: c-api/buffer.rst:311 msgid "F" msgstr "" -#: c-api/buffer.rst:312 +#: c-api/buffer.rst:313 msgid "C or F" msgstr "" -#: c-api/buffer.rst:314 +#: c-api/buffer.rst:315 msgid ":c:macro:`PyBUF_ND`" msgstr "" -#: c-api/buffer.rst:319 +#: c-api/buffer.rst:320 msgid "compound requests" msgstr "" -#: c-api/buffer.rst:321 +#: c-api/buffer.rst:322 msgid "" "All possible requests are fully defined by some combination of the flags in " "the previous section. For convenience, the buffer protocol provides " "frequently used combinations as single flags." msgstr "" -#: c-api/buffer.rst:325 +#: c-api/buffer.rst:326 msgid "" "In the following table *U* stands for undefined contiguity. The consumer " "would have to call :c:func:`PyBuffer_IsContiguous` to determine contiguity." msgstr "" -#: c-api/buffer.rst:331 +#: c-api/buffer.rst:332 msgid "readonly" msgstr "" -#: c-api/buffer.rst:331 +#: c-api/buffer.rst:332 msgid "format" msgstr "" -#: c-api/buffer.rst:335 c-api/buffer.rst:339 c-api/buffer.rst:343 +#: c-api/buffer.rst:336 c-api/buffer.rst:340 c-api/buffer.rst:344 msgid "U" msgstr "" -#: c-api/buffer.rst:337 c-api/buffer.rst:345 +#: c-api/buffer.rst:338 c-api/buffer.rst:346 msgid "0" msgstr "" -#: c-api/buffer.rst:339 c-api/buffer.rst:347 +#: c-api/buffer.rst:340 c-api/buffer.rst:348 msgid "1 or 0" msgstr "" -#: c-api/buffer.rst:352 +#: c-api/buffer.rst:353 msgid "Complex arrays" msgstr "" -#: c-api/buffer.rst:355 +#: c-api/buffer.rst:356 msgid "NumPy-style: shape and strides" msgstr "" -#: c-api/buffer.rst:357 +#: c-api/buffer.rst:358 msgid "" "The logical structure of NumPy-style arrays is defined by :c:member:" "`~Py_buffer.itemsize`, :c:member:`~Py_buffer.ndim`, :c:member:`~Py_buffer." "shape` and :c:member:`~Py_buffer.strides`." msgstr "" -#: c-api/buffer.rst:360 +#: c-api/buffer.rst:361 msgid "" "If ``ndim == 0``, the memory location pointed to by :c:member:`~Py_buffer." "buf` is interpreted as a scalar of size :c:member:`~Py_buffer.itemsize`. In " @@ -505,28 +507,28 @@ msgid "" "strides` are ``NULL``." msgstr "" -#: c-api/buffer.rst:364 +#: c-api/buffer.rst:365 msgid "" "If :c:member:`~Py_buffer.strides` is ``NULL``, the array is interpreted as a " "standard n-dimensional C-array. Otherwise, the consumer must access an n-" "dimensional array as follows:" msgstr "" -#: c-api/buffer.rst:368 +#: c-api/buffer.rst:369 msgid "" "ptr = (char *)buf + indices[0] * strides[0] + ... + indices[n-1] * " "strides[n-1];\n" "item = *((typeof(item) *)ptr);" msgstr "" -#: c-api/buffer.rst:374 +#: c-api/buffer.rst:375 msgid "" "As noted above, :c:member:`~Py_buffer.buf` can point to any location within " "the actual memory block. An exporter can check the validity of a buffer with " "this function:" msgstr "" -#: c-api/buffer.rst:378 +#: c-api/buffer.rst:379 msgid "" "def verify_structure(memlen, itemsize, ndim, shape, strides, offset):\n" " \"\"\"Verify that the parameters represent a valid array within\n" @@ -555,11 +557,11 @@ msgid "" " return 0 <= offset+imin and offset+imax+itemsize <= memlen" msgstr "" -#: c-api/buffer.rst:408 +#: c-api/buffer.rst:409 msgid "PIL-style: shape, strides and suboffsets" msgstr "" -#: c-api/buffer.rst:410 +#: c-api/buffer.rst:411 msgid "" "In addition to the regular items, PIL-style arrays can contain pointers that " "must be followed in order to get to the next element in a dimension. For " @@ -570,14 +572,14 @@ msgid "" "x[2][3]`` arrays that can be located anywhere in memory." msgstr "" -#: c-api/buffer.rst:419 +#: c-api/buffer.rst:420 msgid "" "Here is a function that returns a pointer to the element in an N-D array " "pointed to by an N-dimensional index when there are both non-``NULL`` " "strides and suboffsets::" msgstr "" -#: c-api/buffer.rst:423 +#: c-api/buffer.rst:424 msgid "" "void *get_item_pointer(int ndim, void *buf, Py_ssize_t *strides,\n" " Py_ssize_t *suboffsets, Py_ssize_t *indices) {\n" @@ -593,25 +595,25 @@ msgid "" "}" msgstr "" -#: c-api/buffer.rst:438 +#: c-api/buffer.rst:439 msgid "Buffer-related functions" msgstr "" -#: c-api/buffer.rst:442 +#: c-api/buffer.rst:443 msgid "" "Return ``1`` if *obj* supports the buffer interface otherwise ``0``. When " "``1`` is returned, it doesn't guarantee that :c:func:`PyObject_GetBuffer` " "will succeed. This function always succeeds." msgstr "" -#: c-api/buffer.rst:449 +#: c-api/buffer.rst:450 msgid "" "Send a request to *exporter* to fill in *view* as specified by *flags*. If " "the exporter cannot provide a buffer of the exact type, it MUST raise :exc:" "`BufferError`, set ``view->obj`` to ``NULL`` and return ``-1``." msgstr "" -#: c-api/buffer.rst:454 +#: c-api/buffer.rst:455 msgid "" "On success, fill in *view*, set ``view->obj`` to a new reference to " "*exporter* and return 0. In the case of chained buffer providers that " @@ -619,7 +621,7 @@ msgid "" "instead of *exporter* (See :ref:`Buffer Object Structures `)." msgstr "" -#: c-api/buffer.rst:459 +#: c-api/buffer.rst:460 msgid "" "Successful calls to :c:func:`PyObject_GetBuffer` must be paired with calls " "to :c:func:`PyBuffer_Release`, similar to :c:func:`malloc` and :c:func:" @@ -627,7 +629,7 @@ msgid "" "`PyBuffer_Release` must be called exactly once." msgstr "" -#: c-api/buffer.rst:467 +#: c-api/buffer.rst:468 msgid "" "Release the buffer *view* and release the :term:`strong reference` (i.e. " "decrement the reference count) to the view's supporting object, ``view-" @@ -635,19 +637,19 @@ msgid "" "used, otherwise reference leaks may occur." msgstr "" -#: c-api/buffer.rst:472 +#: c-api/buffer.rst:473 msgid "" "It is an error to call this function on a buffer that was not obtained via :" "c:func:`PyObject_GetBuffer`." msgstr "" -#: c-api/buffer.rst:478 +#: c-api/buffer.rst:479 msgid "" "Return the implied :c:member:`~Py_buffer.itemsize` from :c:member:" "`~Py_buffer.format`. On error, raise an exception and return -1." msgstr "" -#: c-api/buffer.rst:486 +#: c-api/buffer.rst:487 msgid "" "Return ``1`` if the memory defined by the *view* is C-style (*order* is " "``'C'``) or Fortran-style (*order* is ``'F'``) :term:`contiguous` or either " @@ -655,69 +657,69 @@ msgid "" "succeeds." msgstr "" -#: c-api/buffer.rst:493 +#: c-api/buffer.rst:494 msgid "" "Get the memory area pointed to by the *indices* inside the given *view*. " "*indices* must point to an array of ``view->ndim`` indices." msgstr "" -#: c-api/buffer.rst:499 +#: c-api/buffer.rst:500 msgid "" "Copy contiguous *len* bytes from *buf* to *view*. *fort* can be ``'C'`` or " "``'F'`` (for C-style or Fortran-style ordering). ``0`` is returned on " "success, ``-1`` on error." msgstr "" -#: c-api/buffer.rst:506 +#: c-api/buffer.rst:507 msgid "" "Copy *len* bytes from *src* to its contiguous representation in *buf*. " "*order* can be ``'C'`` or ``'F'`` or ``'A'`` (for C-style or Fortran-style " "ordering or either one). ``0`` is returned on success, ``-1`` on error." msgstr "" -#: c-api/buffer.rst:510 +#: c-api/buffer.rst:511 msgid "This function fails if *len* != *src->len*." msgstr "" -#: c-api/buffer.rst:515 +#: c-api/buffer.rst:516 msgid "" "Copy data from *src* to *dest* buffer. Can convert between C-style and or " "Fortran-style buffers." msgstr "" -#: c-api/buffer.rst:518 +#: c-api/buffer.rst:519 msgid "``0`` is returned on success, ``-1`` on error." msgstr "" -#: c-api/buffer.rst:522 +#: c-api/buffer.rst:523 msgid "" "Fill the *strides* array with byte-strides of a :term:`contiguous` (C-style " "if *order* is ``'C'`` or Fortran-style if *order* is ``'F'``) array of the " "given shape with the given number of bytes per element." msgstr "" -#: c-api/buffer.rst:529 +#: c-api/buffer.rst:530 msgid "" "Handle buffer requests for an exporter that wants to expose *buf* of size " "*len* with writability set according to *readonly*. *buf* is interpreted as " "a sequence of unsigned bytes." msgstr "" -#: c-api/buffer.rst:533 +#: c-api/buffer.rst:534 msgid "" "The *flags* argument indicates the request type. This function always fills " "in *view* as specified by flags, unless *buf* has been designated as read-" "only and :c:macro:`PyBUF_WRITABLE` is set in *flags*." msgstr "" -#: c-api/buffer.rst:537 +#: c-api/buffer.rst:538 msgid "" "On success, set ``view->obj`` to a new reference to *exporter* and return 0. " "Otherwise, raise :exc:`BufferError`, set ``view->obj`` to ``NULL`` and " "return ``-1``;" msgstr "" -#: c-api/buffer.rst:541 +#: c-api/buffer.rst:542 msgid "" "If this function is used as part of a :ref:`getbufferproc `, " "*exporter* MUST be set to the exporting object and *flags* must be passed " @@ -744,14 +746,14 @@ msgstr "" msgid "PyBufferProcs (C type)" msgstr "" -#: c-api/buffer.rst:294 +#: c-api/buffer.rst:295 msgid "contiguous" msgstr "" -#: c-api/buffer.rst:294 +#: c-api/buffer.rst:295 msgid "C-contiguous" msgstr "" -#: c-api/buffer.rst:294 +#: c-api/buffer.rst:295 msgid "Fortran contiguous" msgstr "" diff --git a/c-api/init.po b/c-api/init.po index e5fceca7a..5fd1c6d66 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1907,10 +1907,14 @@ msgid "" " .check_multi_interp_extensions = 1,\n" " .gil = PyInterpreterConfig_OWN_GIL,\n" "};\n" -"PyThreadState *tstate = Py_NewInterpreterFromConfig(&config);" +"PyThreadState *tstate = NULL;\n" +"PyStatus status = Py_NewInterpreterFromConfig(&tstate, &config);\n" +"if (PyStatus_Exception(status)) {\n" +" Py_ExitStatusException(status);\n" +"}" msgstr "" -#: c-api/init.rst:1649 +#: c-api/init.rst:1653 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:" @@ -1918,11 +1922,11 @@ msgid "" "internally on the :c:type:`PyInterpreterState`." msgstr "" -#: c-api/init.rst:1658 +#: c-api/init.rst:1662 msgid "Extension modules are shared between (sub-)interpreters as follows:" msgstr "" -#: c-api/init.rst:1660 +#: c-api/init.rst:1664 msgid "" "For modules using multi-phase initialization, e.g. :c:func:" "`PyModule_FromDefAndSpec`, a separate module object is created and " @@ -1930,7 +1934,7 @@ msgid "" "are shared between these module objects." msgstr "" -#: c-api/init.rst:1666 +#: c-api/init.rst:1670 msgid "" "For modules using single-phase initialization, e.g. :c:func:" "`PyModule_Create`, the first time a particular extension is imported, it is " @@ -1942,7 +1946,7 @@ msgid "" "might cause unwanted behavior (see `Bugs and caveats`_ below)." msgstr "" -#: c-api/init.rst:1677 +#: c-api/init.rst:1681 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:" @@ -1952,7 +1956,7 @@ msgid "" "shared between these modules." msgstr "" -#: c-api/init.rst:1697 +#: c-api/init.rst:1701 msgid "" "Create a new sub-interpreter. This is essentially just a wrapper around :c:" "func:`Py_NewInterpreterFromConfig` with a config that preserves the existing " @@ -1961,7 +1965,7 @@ msgid "" "single-phase init modules." msgstr "" -#: c-api/init.rst:1709 +#: c-api/init.rst:1713 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 " @@ -1971,17 +1975,17 @@ msgid "" "be held before calling this function. No GIL is held when it returns." msgstr "" -#: c-api/init.rst:1717 +#: c-api/init.rst:1721 msgid "" ":c:func:`Py_FinalizeEx` will destroy all sub-interpreters that haven't been " "explicitly destroyed at that point." msgstr "" -#: c-api/init.rst:1722 +#: c-api/init.rst:1726 msgid "A Per-Interpreter GIL" msgstr "" -#: c-api/init.rst:1724 +#: c-api/init.rst:1728 msgid "" "Using :c:func:`Py_NewInterpreterFromConfig` you can create a sub-interpreter " "that is completely isolated from other interpreters, including having its " @@ -1993,7 +1997,7 @@ msgid "" "just using threads. (See :pep:`554`.)" msgstr "" -#: c-api/init.rst:1734 +#: c-api/init.rst:1738 msgid "" "Using an isolated interpreter requires vigilance in preserving that " "isolation. That especially means not sharing any objects or mutable state " @@ -2007,7 +2011,7 @@ msgid "" "builtin objects." msgstr "" -#: c-api/init.rst:1745 +#: c-api/init.rst:1749 msgid "" "If you preserve isolation then you will have access to proper multi-core " "computing without the complications that come with free-threading. Failure " @@ -2015,7 +2019,7 @@ msgid "" "threading, including races and hard-to-debug crashes." msgstr "" -#: c-api/init.rst:1750 +#: c-api/init.rst:1754 msgid "" "Aside from that, one of the main challenges of using multiple isolated " "interpreters is how to communicate between them safely (not break isolation) " @@ -2025,11 +2029,11 @@ msgid "" "sharing) data between interpreters." msgstr "" -#: c-api/init.rst:1761 +#: c-api/init.rst:1765 msgid "Bugs and caveats" msgstr "" -#: c-api/init.rst:1763 +#: c-api/init.rst:1767 msgid "" "Because sub-interpreters (and the main interpreter) are part of the same " "process, the insulation between them isn't perfect --- for example, using " @@ -2042,7 +2046,7 @@ msgid "" "should be avoided if possible." msgstr "" -#: c-api/init.rst:1773 +#: c-api/init.rst:1777 msgid "" "Special care should be taken to avoid sharing user-defined functions, " "methods, instances or classes between sub-interpreters, since import " @@ -2051,7 +2055,7 @@ msgid "" "objects from which the above are reachable." msgstr "" -#: c-api/init.rst:1779 +#: c-api/init.rst:1783 msgid "" "Also note that combining this functionality with ``PyGILState_*`` APIs is " "delicate, because these APIs assume a bijection between Python thread states " @@ -2063,25 +2067,25 @@ msgid "" "created threads will probably be broken when using sub-interpreters." msgstr "" -#: c-api/init.rst:1790 +#: c-api/init.rst:1794 msgid "Asynchronous Notifications" msgstr "" -#: c-api/init.rst:1792 +#: c-api/init.rst:1796 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:1799 +#: c-api/init.rst:1803 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:1803 +#: c-api/init.rst:1807 msgid "" "When successfully queued, *func* will be *eventually* called from the main " "interpreter thread with the argument *arg*. It will be called " @@ -2089,17 +2093,17 @@ msgid "" "these conditions met:" msgstr "" -#: c-api/init.rst:1808 +#: c-api/init.rst:1812 msgid "on a :term:`bytecode` boundary;" msgstr "" -#: c-api/init.rst:1809 +#: c-api/init.rst:1813 msgid "" "with the main thread holding the :term:`global interpreter lock` (*func* can " "therefore use the full C API)." msgstr "" -#: c-api/init.rst:1812 +#: c-api/init.rst:1816 msgid "" "*func* must return ``0`` on success, or ``-1`` on failure with an exception " "set. *func* won't be interrupted to perform another asynchronous " @@ -2107,20 +2111,20 @@ msgid "" "if the global interpreter lock is released." msgstr "" -#: c-api/init.rst:1817 +#: c-api/init.rst:1821 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:1820 +#: c-api/init.rst:1824 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:1825 +#: c-api/init.rst:1829 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 " @@ -2130,7 +2134,7 @@ msgid "" "`PyGILState API`." msgstr "" -#: c-api/init.rst:1834 +#: c-api/init.rst:1838 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 " @@ -2138,18 +2142,18 @@ msgid "" "scheduled calls." msgstr "" -#: c-api/init.rst:1843 +#: c-api/init.rst:1847 msgid "Profiling and Tracing" msgstr "" -#: c-api/init.rst:1848 +#: c-api/init.rst:1852 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:1852 +#: c-api/init.rst:1856 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 " @@ -2159,7 +2163,7 @@ msgid "" "reported to the Python-level trace functions in previous versions." msgstr "" -#: c-api/init.rst:1862 +#: c-api/init.rst:1866 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 " @@ -2171,64 +2175,64 @@ msgid "" "value of *what*:" msgstr "" -#: c-api/init.rst:1871 +#: c-api/init.rst:1875 msgid "Value of *what*" msgstr "" -#: c-api/init.rst:1871 +#: c-api/init.rst:1875 msgid "Meaning of *arg*" msgstr "" -#: c-api/init.rst:1873 +#: c-api/init.rst:1877 msgid ":c:data:`PyTrace_CALL`" msgstr "" -#: c-api/init.rst:1878 c-api/init.rst:1889 +#: c-api/init.rst:1882 c-api/init.rst:1893 msgid "Always :c:data:`Py_None`." msgstr "" -#: c-api/init.rst:1875 +#: c-api/init.rst:1879 msgid ":c:data:`PyTrace_EXCEPTION`" msgstr "" -#: c-api/init.rst:1875 +#: c-api/init.rst:1879 msgid "Exception information as returned by :func:`sys.exc_info`." msgstr "" -#: c-api/init.rst:1878 +#: c-api/init.rst:1882 msgid ":c:data:`PyTrace_LINE`" msgstr "" -#: c-api/init.rst:1880 +#: c-api/init.rst:1884 msgid ":c:data:`PyTrace_RETURN`" msgstr "" -#: c-api/init.rst:1880 +#: c-api/init.rst:1884 msgid "" "Value being returned to the caller, or ``NULL`` if caused by an exception." msgstr "" -#: c-api/init.rst:1883 +#: c-api/init.rst:1887 msgid ":c:data:`PyTrace_C_CALL`" msgstr "" -#: c-api/init.rst:1885 c-api/init.rst:1887 +#: c-api/init.rst:1889 c-api/init.rst:1891 msgid "Function object being called." msgstr "" -#: c-api/init.rst:1885 +#: c-api/init.rst:1889 msgid ":c:data:`PyTrace_C_EXCEPTION`" msgstr "" -#: c-api/init.rst:1887 +#: c-api/init.rst:1891 msgid ":c:data:`PyTrace_C_RETURN`" msgstr "" -#: c-api/init.rst:1889 +#: c-api/init.rst:1893 msgid ":c:data:`PyTrace_OPCODE`" msgstr "" -#: c-api/init.rst:1894 +#: c-api/init.rst:1898 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 " @@ -2237,7 +2241,7 @@ msgid "" "the corresponding frame." msgstr "" -#: c-api/init.rst:1903 +#: c-api/init.rst:1907 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 " @@ -2249,7 +2253,7 @@ msgid "" "profiler." msgstr "" -#: c-api/init.rst:1914 +#: c-api/init.rst:1918 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 " @@ -2257,31 +2261,31 @@ msgid "" "f_trace_lines` to *0* on that frame." msgstr "" -#: c-api/init.rst:1922 +#: c-api/init.rst:1926 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:1928 +#: c-api/init.rst:1932 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:1934 +#: c-api/init.rst:1938 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:1940 +#: c-api/init.rst:1944 msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when " "a C function has returned." msgstr "" -#: c-api/init.rst:1946 +#: c-api/init.rst:1950 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 " @@ -2289,7 +2293,7 @@ msgid "" "attr:`~frame.f_trace_opcodes` to *1* on the frame." msgstr "" -#: c-api/init.rst:1954 +#: c-api/init.rst:1958 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``. " @@ -2299,28 +2303,28 @@ msgid "" "`PyTrace_LINE` :c:data:`PyTrace_OPCODE` and :c:data:`PyTrace_EXCEPTION`." msgstr "" -#: c-api/init.rst:1961 +#: c-api/init.rst:1965 msgid "See also the :func:`sys.setprofile` function." msgstr "" -#: c-api/init.rst:1970 c-api/init.rst:1996 +#: c-api/init.rst:1974 c-api/init.rst:2000 msgid "The caller must hold the :term:`GIL`." msgstr "" -#: c-api/init.rst:1967 +#: c-api/init.rst:1971 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:1972 +#: c-api/init.rst:1976 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:1980 +#: c-api/init.rst:1984 msgid "" "Set the tracing function to *func*. This is similar to :c:func:" "`PyEval_SetProfile`, except the tracing function does receive line-number " @@ -2331,65 +2335,65 @@ msgid "" "*what* parameter." msgstr "" -#: c-api/init.rst:1987 +#: c-api/init.rst:1991 msgid "See also the :func:`sys.settrace` function." msgstr "" -#: c-api/init.rst:1993 +#: c-api/init.rst:1997 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:1998 +#: c-api/init.rst:2002 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:2007 +#: c-api/init.rst:2011 msgid "Advanced Debugger Support" msgstr "" -#: c-api/init.rst:2012 +#: c-api/init.rst:2016 msgid "" "These functions are only intended to be used by advanced debugging tools." msgstr "" -#: c-api/init.rst:2017 +#: c-api/init.rst:2021 msgid "" "Return the interpreter state object at the head of the list of all such " "objects." msgstr "" -#: c-api/init.rst:2022 +#: c-api/init.rst:2026 msgid "Return the main interpreter state object." msgstr "" -#: c-api/init.rst:2027 +#: c-api/init.rst:2031 msgid "" "Return the next interpreter state object after *interp* from the list of all " "such objects." msgstr "" -#: c-api/init.rst:2033 +#: c-api/init.rst:2037 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:2039 +#: c-api/init.rst:2043 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:2046 +#: c-api/init.rst:2050 msgid "Thread Local Storage Support" msgstr "" -#: c-api/init.rst:2050 +#: c-api/init.rst:2054 msgid "" "The Python interpreter provides low-level support for thread-local storage " "(TLS) which wraps the underlying native TLS implementation to support the " @@ -2399,19 +2403,19 @@ msgid "" "thread." msgstr "" -#: c-api/init.rst:2057 +#: c-api/init.rst:2061 msgid "" "The GIL does *not* need to be held when calling these functions; they supply " "their own locking." msgstr "" -#: c-api/init.rst:2060 +#: c-api/init.rst:2064 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:2064 +#: c-api/init.rst:2068 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 " @@ -2419,22 +2423,22 @@ msgid "" "don't do refcount operations on them either." msgstr "" -#: c-api/init.rst:2072 +#: c-api/init.rst:2076 msgid "Thread Specific Storage (TSS) API" msgstr "" -#: c-api/init.rst:2074 +#: c-api/init.rst:2078 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:2080 +#: c-api/init.rst:2084 msgid "\"A New C-API for Thread-Local Storage in CPython\" (:pep:`539`)" msgstr "" -#: c-api/init.rst:2085 +#: c-api/init.rst:2089 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 " @@ -2442,52 +2446,52 @@ msgid "" "public members in this structure." msgstr "" -#: c-api/init.rst:2090 +#: c-api/init.rst:2094 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:2096 +#: c-api/init.rst:2100 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:2101 +#: c-api/init.rst:2105 msgid "Dynamic Allocation" msgstr "" -#: c-api/init.rst:2103 +#: c-api/init.rst:2107 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:2110 +#: c-api/init.rst:2114 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:2117 +#: c-api/init.rst:2121 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:2123 +#: c-api/init.rst:2127 msgid "" "A freed key becomes a dangling pointer. You should reset the key to ``NULL``." msgstr "" -#: c-api/init.rst:2128 +#: c-api/init.rst:2132 msgid "Methods" msgstr "" -#: c-api/init.rst:2130 +#: c-api/init.rst:2134 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 " @@ -2495,13 +2499,13 @@ msgid "" "func:`PyThread_tss_create`." msgstr "" -#: c-api/init.rst:2138 +#: c-api/init.rst:2142 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:2144 +#: c-api/init.rst:2148 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 " @@ -2510,7 +2514,7 @@ msgid "" "no-op and immediately returns success." msgstr "" -#: c-api/init.rst:2153 +#: c-api/init.rst:2157 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 " @@ -2519,31 +2523,31 @@ msgid "" "key -- calling it on an already destroyed key is a no-op." msgstr "" -#: c-api/init.rst:2162 +#: c-api/init.rst:2166 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:2169 +#: c-api/init.rst:2173 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:2177 +#: c-api/init.rst:2181 msgid "Thread Local Storage (TLS) API" msgstr "" -#: c-api/init.rst:2179 +#: c-api/init.rst:2183 msgid "" "This API is superseded by :ref:`Thread Specific Storage (TSS) API `." msgstr "" -#: c-api/init.rst:2184 +#: c-api/init.rst:2188 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 " @@ -2552,7 +2556,7 @@ msgid "" "platforms." msgstr "" -#: c-api/init.rst:2189 +#: c-api/init.rst:2193 msgid "" "Due to the compatibility problem noted above, this version of the API should " "not be used in new code." @@ -2574,19 +2578,19 @@ msgstr "" msgid "path (in module sys)" msgstr "" -#: c-api/init.rst:596 c-api/init.rst:1063 c-api/init.rst:1689 +#: c-api/init.rst:596 c-api/init.rst:1063 c-api/init.rst:1693 msgid "module" msgstr "" -#: c-api/init.rst:1594 c-api/init.rst:1689 +#: c-api/init.rst:1594 c-api/init.rst:1693 msgid "builtins" msgstr "" -#: c-api/init.rst:1594 c-api/init.rst:1689 +#: c-api/init.rst:1594 c-api/init.rst:1693 msgid "__main__" msgstr "" -#: c-api/init.rst:1594 c-api/init.rst:1689 +#: c-api/init.rst:1594 c-api/init.rst:1693 msgid "sys" msgstr "" @@ -2606,7 +2610,7 @@ msgstr "" msgid "PySys_SetArgvEx (C function)" msgstr "" -#: c-api/init.rst:1654 c-api/init.rst:1707 +#: c-api/init.rst:1658 c-api/init.rst:1711 msgid "Py_FinalizeEx (C function)" msgstr "" @@ -2718,22 +2722,22 @@ msgstr "" msgid "_thread" msgstr "" -#: c-api/init.rst:1689 +#: c-api/init.rst:1693 msgid "stdout (in module sys)" msgstr "" -#: c-api/init.rst:1689 +#: c-api/init.rst:1693 msgid "stderr (in module sys)" msgstr "" -#: c-api/init.rst:1689 +#: c-api/init.rst:1693 msgid "stdin (in module sys)" msgstr "" -#: c-api/init.rst:1654 +#: c-api/init.rst:1658 msgid "Py_Initialize (C function)" msgstr "" -#: c-api/init.rst:1684 +#: c-api/init.rst:1688 msgid "close (in module os)" msgstr "" diff --git a/c-api/object.po b/c-api/object.po index 90f26d646..9de5237b1 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: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -449,6 +449,13 @@ msgstr "" #: c-api/object.rst:415 msgid "" +"This is equivalent to the Python ``__iter__(self): return self`` method. It " +"is intended for :term:`iterator` types, to be used in the :c:member:" +"`PyTypeObject.tp_iter` slot." +msgstr "" + +#: c-api/object.rst:421 +msgid "" "This is the equivalent to the Python expression ``aiter(o)``. Takes an :" "class:`AsyncIterable` object and returns an :class:`AsyncIterator` for it. " "This is typically a new iterator but if the argument is an :class:" @@ -456,51 +463,51 @@ msgid "" "``NULL`` if the object cannot be iterated." msgstr "" -#: c-api/object.rst:425 +#: c-api/object.rst:431 msgid "Get a pointer to subclass-specific data reserved for *cls*." msgstr "" -#: c-api/object.rst:427 +#: c-api/object.rst:433 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:431 +#: c-api/object.rst:437 msgid "On error, set an exception and return ``NULL``." msgstr "" -#: c-api/object.rst:437 +#: c-api/object.rst:443 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:440 +#: c-api/object.rst:446 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:443 +#: c-api/object.rst:449 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:447 +#: c-api/object.rst:453 msgid "On error, set an exception and return a negative value." msgstr "" -#: c-api/object.rst:453 +#: c-api/object.rst:459 msgid "" "Get a pointer to per-item data for a class with :c:macro:" "`Py_TPFLAGS_ITEMS_AT_END`." msgstr "" -#: c-api/object.rst:456 +#: c-api/object.rst:462 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." diff --git a/c-api/stable.po b/c-api/stable.po index 492e001d8..decd02eee 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: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -108,8 +108,8 @@ msgstr "" #: c-api/stable.rst:67 msgid "" "Python 3.2 introduced the *Limited API*, a subset of Python's C API. " -"Extensions that only use the Limited API can be compiled once and work with " -"multiple versions of Python. Contents of the Limited API are :ref:`listed " +"Extensions that only use the Limited API can be compiled once and be loaded " +"on multiple versions of Python. Contents of the Limited API are :ref:`listed " "below `." msgstr "" @@ -123,9 +123,8 @@ msgstr "" msgid "" "Define ``Py_LIMITED_API`` to the value of :c:macro:`PY_VERSION_HEX` " "corresponding to the lowest Python version your extension supports. The " -"extension will work without recompilation with all Python 3 releases from " -"the specified one onward, and can use Limited API introduced up to that " -"version." +"extension will be ABI-compatible with all Python 3 releases from the " +"specified one onward, and can use Limited API introduced up to that version." msgstr "" #: c-api/stable.rst:83 @@ -148,24 +147,33 @@ msgstr "" #: c-api/stable.rst:96 msgid "" "To enable this, Python provides a *Stable ABI*: a set of symbols that will " -"remain compatible across Python 3.x versions." +"remain ABI-compatible across Python 3.x versions." msgstr "" -#: c-api/stable.rst:99 +#: c-api/stable.rst:101 +msgid "" +"The Stable ABI prevents ABI issues, like linker errors due to missing " +"symbols or data corruption due to changes in structure layouts or function " +"signatures. However, other changes in Python can change the *behavior* of " +"extensions. See Python's Backwards Compatibility Policy (:pep:`387`) for " +"details." +msgstr "" + +#: c-api/stable.rst:107 msgid "" "The Stable ABI contains symbols exposed in the :ref:`Limited API `, but also other ones – for example, functions necessary to support " "older versions of the Limited API." msgstr "" -#: c-api/stable.rst:103 +#: c-api/stable.rst:111 msgid "" "On Windows, extensions that use the Stable ABI should be linked against " "``python3.dll`` rather than a version-specific library such as ``python39." "dll``." msgstr "" -#: c-api/stable.rst:107 +#: c-api/stable.rst:115 msgid "" "On some platforms, Python will look for and load shared library files named " "with the ``abi3`` tag (e.g. ``mymodule.abi3.so``). It does not check if such " @@ -174,31 +182,31 @@ msgid "" "not installed for lower versions of Python." msgstr "" -#: c-api/stable.rst:114 +#: c-api/stable.rst:122 msgid "" "All functions in the Stable ABI are present as functions in Python's shared " "library, not solely as macros. This makes them usable from languages that " "don't use the C preprocessor." msgstr "" -#: c-api/stable.rst:120 +#: c-api/stable.rst:128 msgid "Limited API Scope and Performance" msgstr "" -#: c-api/stable.rst:122 +#: c-api/stable.rst:130 msgid "" "The goal for the Limited API is to allow everything that is possible with " "the full C API, but possibly with a performance penalty." msgstr "" -#: c-api/stable.rst:125 +#: c-api/stable.rst:133 msgid "" "For example, while :c:func:`PyList_GetItem` is available, its “unsafe” macro " "variant :c:func:`PyList_GET_ITEM` is not. The macro can be faster because it " "can rely on version-specific implementation details of the list object." msgstr "" -#: c-api/stable.rst:130 +#: c-api/stable.rst:138 msgid "" "Without ``Py_LIMITED_API`` defined, some C API functions are inlined or " "replaced by macros. Defining ``Py_LIMITED_API`` disables this inlining, " @@ -206,7 +214,7 @@ msgid "" "reducing performance." msgstr "" -#: c-api/stable.rst:135 +#: c-api/stable.rst:143 msgid "" "By leaving out the ``Py_LIMITED_API`` definition, it is possible to compile " "a Limited API extension with a version-specific ABI. This can improve " @@ -216,11 +224,11 @@ msgid "" "of an upcoming Python version." msgstr "" -#: c-api/stable.rst:144 +#: c-api/stable.rst:152 msgid "Limited API Caveats" msgstr "" -#: c-api/stable.rst:146 +#: c-api/stable.rst:154 msgid "" "Note that compiling with ``Py_LIMITED_API`` is *not* a complete guarantee " "that code conforms to the :ref:`Limited API ` or the :ref:" @@ -228,7 +236,7 @@ msgid "" "an API also includes other issues, such as expected semantics." msgstr "" -#: c-api/stable.rst:151 +#: c-api/stable.rst:159 msgid "" "One issue that ``Py_LIMITED_API`` does not guard against is calling a " "function with arguments that are invalid in a lower Python version. For " @@ -238,19 +246,19 @@ msgid "" "crash. A similar argument works for fields of structs." msgstr "" -#: c-api/stable.rst:158 +#: c-api/stable.rst:166 msgid "" "Another issue is that some struct fields are currently not hidden when " "``Py_LIMITED_API`` is defined, even though they're part of the Limited API." msgstr "" -#: c-api/stable.rst:161 +#: c-api/stable.rst:169 msgid "" "For these reasons, we recommend testing an extension with *all* minor Python " "versions it supports, and preferably to build with the *lowest* such version." msgstr "" -#: c-api/stable.rst:164 +#: c-api/stable.rst:172 msgid "" "We also recommend reviewing documentation of all used API to check if it is " "explicitly part of the Limited API. Even with ``Py_LIMITED_API`` defined, a " @@ -258,7 +266,7 @@ msgid "" "unintentionally, as bugs)." msgstr "" -#: c-api/stable.rst:169 +#: c-api/stable.rst:177 msgid "" "Also note that the Limited API is not necessarily stable: compiling with " "``Py_LIMITED_API`` with Python 3.8 means that the extension will run with " @@ -267,11 +275,11 @@ msgid "" "that the Stable ABI stays stable." msgstr "" -#: c-api/stable.rst:179 +#: c-api/stable.rst:187 msgid "Platform Considerations" msgstr "" -#: c-api/stable.rst:181 +#: c-api/stable.rst:189 msgid "" "ABI stability depends not only on Python, but also on the compiler used, " "lower-level libraries and compiler options. For the purposes of the :ref:" @@ -279,7 +287,7 @@ msgid "" "depend on the OS type and processor architecture" msgstr "" -#: c-api/stable.rst:186 +#: c-api/stable.rst:194 msgid "" "It is the responsibility of each particular distributor of Python to ensure " "that all Python versions on a particular platform are built in a way that " @@ -287,11 +295,11 @@ msgid "" "releases from ``python.org`` and many third-party distributors." msgstr "" -#: c-api/stable.rst:196 +#: c-api/stable.rst:204 msgid "Contents of Limited API" msgstr "" -#: c-api/stable.rst:199 +#: c-api/stable.rst:207 msgid "" "Currently, the :ref:`Limited API ` includes the following " "items:" diff --git a/c-api/type.po b/c-api/type.po index e1315de41..818f303d5 100644 --- a/c-api/type.po +++ b/c-api/type.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -584,24 +584,24 @@ msgid "" "`PyType_FromSpecWithBases` instead." msgstr "" -#: c-api/type.rst:502 +#: c-api/type.rst:500 msgid "Slots in :c:type:`PyBufferProcs` may be set in the unlimited API." msgstr "" -#: c-api/type.rst:504 +#: c-api/type.rst:503 msgid "" ":c:member:`~PyBufferProcs.bf_getbuffer` and :c:member:`~PyBufferProcs." "bf_releasebuffer` are now available under the :ref:`limited API `." msgstr "" -#: c-api/type.rst:511 +#: c-api/type.rst:510 msgid "" "The desired value of the slot. In most cases, this is a pointer to a " "function." msgstr "" -#: c-api/type.rst:514 +#: c-api/type.rst:513 msgid "Slots other than ``Py_tp_doc`` may not be ``NULL``." msgstr "" diff --git a/deprecations/index.po b/deprecations/index.po index 8a7e89b57..d4bf9ae0f 100644 --- a/deprecations/index.po +++ b/deprecations/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -198,62 +198,50 @@ msgid "Pending Removal in Python 3.14" msgstr "" #: deprecations/pending-removal-in-3.14.rst:4 -msgid "The import system:" -msgstr "" - -#: deprecations/pending-removal-in-3.14.rst:6 -msgid "" -"Setting :attr:`~module.__loader__` on a module while failing to set :attr:" -"`__spec__.loader ` is deprecated. In " -"Python 3.14, :attr:`!__loader__` will cease to be set or taken into " -"consideration by the import system or the standard library." -msgstr "" - -#: deprecations/pending-removal-in-3.14.rst:11 msgid "" ":mod:`argparse`: The *type*, *choices*, and *metavar* parameters of :class:`!" "argparse.BooleanOptionalAction` are deprecated and will be removed in 3.14. " "(Contributed by Nikita Sobolev in :gh:`92248`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:16 +#: deprecations/pending-removal-in-3.14.rst:9 msgid "" ":mod:`ast`: The following features have been deprecated in documentation " "since Python 3.8, now cause a :exc:`DeprecationWarning` to be emitted at " "runtime when they are accessed or used, and will be removed in Python 3.14:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:20 +#: deprecations/pending-removal-in-3.14.rst:13 msgid ":class:`!ast.Num`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:21 +#: deprecations/pending-removal-in-3.14.rst:14 msgid ":class:`!ast.Str`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:22 +#: deprecations/pending-removal-in-3.14.rst:15 msgid ":class:`!ast.Bytes`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:23 +#: deprecations/pending-removal-in-3.14.rst:16 msgid ":class:`!ast.NameConstant`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:24 +#: deprecations/pending-removal-in-3.14.rst:17 msgid ":class:`!ast.Ellipsis`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:26 +#: deprecations/pending-removal-in-3.14.rst:19 msgid "" "Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" "`90953`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:29 +#: deprecations/pending-removal-in-3.14.rst:22 msgid ":mod:`asyncio`:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:31 +#: deprecations/pending-removal-in-3.14.rst:24 msgid "" "The child watcher classes :class:`~asyncio.MultiLoopChildWatcher`, :class:" "`~asyncio.FastChildWatcher`, :class:`~asyncio.AbstractChildWatcher` and :" @@ -261,7 +249,7 @@ msgid "" "Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:37 +#: deprecations/pending-removal-in-3.14.rst:30 msgid "" ":func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`, :meth:" "`asyncio.AbstractEventLoopPolicy.set_child_watcher` and :meth:`asyncio." @@ -269,7 +257,7 @@ msgid "" "removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:43 +#: deprecations/pending-removal-in-3.14.rst:36 msgid "" "The :meth:`~asyncio.get_event_loop` method of the default event loop policy " "now emits a :exc:`DeprecationWarning` if there is no current event loop set " @@ -277,7 +265,7 @@ msgid "" "Rossum in :gh:`100160`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:48 +#: deprecations/pending-removal-in-3.14.rst:41 msgid "" ":mod:`collections.abc`: Deprecated :class:`~collections.abc.ByteString`. " "Prefer :class:`!Sequence` or :class:`~collections.abc.Buffer`. For use in " @@ -285,51 +273,51 @@ msgid "" "abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:54 +#: deprecations/pending-removal-in-3.14.rst:47 msgid "" ":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." "localtime`. (Contributed by Alan Williams in :gh:`72346`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:57 +#: deprecations/pending-removal-in-3.14.rst:50 msgid "" ":mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or " "taken into consideration by the import system (:gh:`97879`)." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:60 +#: deprecations/pending-removal-in-3.14.rst:53 msgid ":mod:`importlib.abc` deprecated classes:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:62 +#: deprecations/pending-removal-in-3.14.rst:55 msgid ":class:`!importlib.abc.ResourceReader`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:63 +#: deprecations/pending-removal-in-3.14.rst:56 msgid ":class:`!importlib.abc.Traversable`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:64 +#: deprecations/pending-removal-in-3.14.rst:57 msgid ":class:`!importlib.abc.TraversableResources`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:66 +#: deprecations/pending-removal-in-3.14.rst:59 msgid "Use :mod:`importlib.resources.abc` classes instead:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:68 +#: deprecations/pending-removal-in-3.14.rst:61 msgid ":class:`importlib.resources.abc.Traversable`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:69 +#: deprecations/pending-removal-in-3.14.rst:62 msgid ":class:`importlib.resources.abc.TraversableResources`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:71 +#: deprecations/pending-removal-in-3.14.rst:64 msgid "(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:73 +#: deprecations/pending-removal-in-3.14.rst:66 msgid "" ":mod:`itertools` had undocumented, inefficient, historically buggy, and " "inconsistent support for copy, deepcopy, and pickle operations. This will be " @@ -337,7 +325,7 @@ msgid "" "burden. (Contributed by Raymond Hettinger in :gh:`101588`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:79 +#: deprecations/pending-removal-in-3.14.rst:72 msgid "" ":mod:`multiprocessing`: The default start method will change to a safer one " "on Linux, BSDs, and other non-macOS POSIX platforms where ``'fork'`` is " @@ -348,67 +336,53 @@ msgid "" "``'fork'``. See :ref:`multiprocessing-start-methods`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:87 +#: deprecations/pending-removal-in-3.14.rst:80 msgid "" ":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." "PurePath.relative_to`: passing additional arguments is deprecated." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:91 +#: deprecations/pending-removal-in-3.14.rst:84 msgid "" ":mod:`pkgutil`: :func:`~pkgutil.find_loader` and :func:`~pkgutil.get_loader` " "now raise :exc:`DeprecationWarning`; use :func:`importlib.util.find_spec` " "instead. (Contributed by Nikita Sobolev in :gh:`97850`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:96 +#: deprecations/pending-removal-in-3.14.rst:89 msgid ":mod:`pty`:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:98 +#: deprecations/pending-removal-in-3.14.rst:91 msgid "``master_open()``: use :func:`pty.openpty`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:99 +#: deprecations/pending-removal-in-3.14.rst:92 msgid "``slave_open()``: use :func:`pty.openpty`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:101 +#: deprecations/pending-removal-in-3.14.rst:94 msgid ":mod:`sqlite3`:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:103 +#: deprecations/pending-removal-in-3.14.rst:96 msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:105 +#: deprecations/pending-removal-in-3.14.rst:98 msgid "" ":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` if :" "ref:`named placeholders ` are used and *parameters* is " "a sequence instead of a :class:`dict`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:109 -msgid "" -"date and datetime adapter, date and timestamp converter: see the :mod:" -"`sqlite3` documentation for suggested replacement recipes." -msgstr "" - -#: deprecations/pending-removal-in-3.14.rst:112 -msgid "" -":class:`types.CodeType`: Accessing :attr:`~codeobject.co_lnotab` was " -"deprecated in :pep:`626` since 3.10 and was planned to be removed in 3.12, " -"but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " -"in 3.14. (Contributed by Nikita Sobolev in :gh:`101866`.)" -msgstr "" - -#: deprecations/pending-removal-in-3.14.rst:119 +#: deprecations/pending-removal-in-3.14.rst:102 msgid "" ":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " "causes a :exc:`DeprecationWarning` to be emitted when it is used." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:122 +#: deprecations/pending-removal-in-3.14.rst:105 msgid "" ":mod:`urllib`: :class:`!urllib.parse.Quoter` is deprecated: it was not " "intended to be a public API. (Contributed by Gregory P. Smith in :gh:" @@ -473,6 +447,22 @@ msgid "" msgstr "" #: deprecations/pending-removal-in-3.15.rst:40 +msgid ":mod:`types`:" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:42 +msgid "" +":class:`types.CodeType`: Accessing :attr:`~codeobject.co_lnotab` was " +"deprecated in :pep:`626` since 3.10 and was planned to be removed in 3.12, " +"but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " +"in 3.15. (Contributed by Nikita Sobolev in :gh:`101866`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:49 +msgid ":mod:`typing`:" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:51 msgid "" "When using the functional syntax to create a :class:`!NamedTuple` class, " "failing to pass a value to the *fields* parameter (``NT = " @@ -483,7 +473,7 @@ msgid "" "[])``." msgstr "" -#: deprecations/pending-removal-in-3.15.rst:47 +#: deprecations/pending-removal-in-3.15.rst:58 msgid "" ":class:`typing.TypedDict`: When using the functional syntax to create a :" "class:`!TypedDict` class, failing to pass a value to the *fields* parameter " @@ -493,7 +483,7 @@ msgid "" "fields, use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})``." msgstr "" -#: deprecations/pending-removal-in-3.15.rst:54 +#: deprecations/pending-removal-in-3.15.rst:65 msgid "" ":mod:`wave`: Deprecate the ``getmark()``, ``setmark()`` and ``getmarkers()`` " "methods of the :class:`wave.Wave_read` and :class:`wave.Wave_write` classes. " @@ -506,16 +496,28 @@ msgid "Pending Removal in Python 3.16" msgstr "" #: deprecations/pending-removal-in-3.16.rst:4 +msgid "The import system:" +msgstr "" + +#: deprecations/pending-removal-in-3.16.rst:6 +msgid "" +"Setting :attr:`~module.__loader__` on a module while failing to set :attr:" +"`__spec__.loader ` is deprecated. In " +"Python 3.16, :attr:`!__loader__` will cease to be set or taken into " +"consideration by the import system or the standard library." +msgstr "" + +#: deprecations/pending-removal-in-3.16.rst:11 msgid "" ":mod:`array`: :class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the " "``'w'`` type instead (``Py_UCS4``)." msgstr "" -#: deprecations/pending-removal-in-3.16.rst:8 +#: deprecations/pending-removal-in-3.16.rst:15 msgid ":mod:`builtins`: ``~bool``, bitwise inversion on bool." msgstr "" -#: deprecations/pending-removal-in-3.16.rst:11 +#: deprecations/pending-removal-in-3.16.rst:18 msgid "" ":mod:`symtable`: Deprecate :meth:`symtable.Class.get_methods` due to the " "lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" diff --git a/deprecations/pending-removal-in-3.14.po b/deprecations/pending-removal-in-3.14.po index 8fb8bec31..200869c9f 100644 --- a/deprecations/pending-removal-in-3.14.po +++ b/deprecations/pending-removal-in-3.14.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -22,62 +22,50 @@ msgid "Pending Removal in Python 3.14" msgstr "" #: deprecations/pending-removal-in-3.14.rst:4 -msgid "The import system:" -msgstr "" - -#: deprecations/pending-removal-in-3.14.rst:6 -msgid "" -"Setting :attr:`~module.__loader__` on a module while failing to set :attr:" -"`__spec__.loader ` is deprecated. In " -"Python 3.14, :attr:`!__loader__` will cease to be set or taken into " -"consideration by the import system or the standard library." -msgstr "" - -#: deprecations/pending-removal-in-3.14.rst:11 msgid "" ":mod:`argparse`: The *type*, *choices*, and *metavar* parameters of :class:`!" "argparse.BooleanOptionalAction` are deprecated and will be removed in 3.14. " "(Contributed by Nikita Sobolev in :gh:`92248`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:16 +#: deprecations/pending-removal-in-3.14.rst:9 msgid "" ":mod:`ast`: The following features have been deprecated in documentation " "since Python 3.8, now cause a :exc:`DeprecationWarning` to be emitted at " "runtime when they are accessed or used, and will be removed in Python 3.14:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:20 +#: deprecations/pending-removal-in-3.14.rst:13 msgid ":class:`!ast.Num`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:21 +#: deprecations/pending-removal-in-3.14.rst:14 msgid ":class:`!ast.Str`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:22 +#: deprecations/pending-removal-in-3.14.rst:15 msgid ":class:`!ast.Bytes`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:23 +#: deprecations/pending-removal-in-3.14.rst:16 msgid ":class:`!ast.NameConstant`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:24 +#: deprecations/pending-removal-in-3.14.rst:17 msgid ":class:`!ast.Ellipsis`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:26 +#: deprecations/pending-removal-in-3.14.rst:19 msgid "" "Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" "`90953`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:29 +#: deprecations/pending-removal-in-3.14.rst:22 msgid ":mod:`asyncio`:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:31 +#: deprecations/pending-removal-in-3.14.rst:24 msgid "" "The child watcher classes :class:`~asyncio.MultiLoopChildWatcher`, :class:" "`~asyncio.FastChildWatcher`, :class:`~asyncio.AbstractChildWatcher` and :" @@ -85,7 +73,7 @@ msgid "" "Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:37 +#: deprecations/pending-removal-in-3.14.rst:30 msgid "" ":func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`, :meth:" "`asyncio.AbstractEventLoopPolicy.set_child_watcher` and :meth:`asyncio." @@ -93,7 +81,7 @@ msgid "" "removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:43 +#: deprecations/pending-removal-in-3.14.rst:36 msgid "" "The :meth:`~asyncio.get_event_loop` method of the default event loop policy " "now emits a :exc:`DeprecationWarning` if there is no current event loop set " @@ -101,7 +89,7 @@ msgid "" "Rossum in :gh:`100160`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:48 +#: deprecations/pending-removal-in-3.14.rst:41 msgid "" ":mod:`collections.abc`: Deprecated :class:`~collections.abc.ByteString`. " "Prefer :class:`!Sequence` or :class:`~collections.abc.Buffer`. For use in " @@ -109,51 +97,51 @@ msgid "" "abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:54 +#: deprecations/pending-removal-in-3.14.rst:47 msgid "" ":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." "localtime`. (Contributed by Alan Williams in :gh:`72346`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:57 +#: deprecations/pending-removal-in-3.14.rst:50 msgid "" ":mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or " "taken into consideration by the import system (:gh:`97879`)." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:60 +#: deprecations/pending-removal-in-3.14.rst:53 msgid ":mod:`importlib.abc` deprecated classes:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:62 +#: deprecations/pending-removal-in-3.14.rst:55 msgid ":class:`!importlib.abc.ResourceReader`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:63 +#: deprecations/pending-removal-in-3.14.rst:56 msgid ":class:`!importlib.abc.Traversable`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:64 +#: deprecations/pending-removal-in-3.14.rst:57 msgid ":class:`!importlib.abc.TraversableResources`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:66 +#: deprecations/pending-removal-in-3.14.rst:59 msgid "Use :mod:`importlib.resources.abc` classes instead:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:68 +#: deprecations/pending-removal-in-3.14.rst:61 msgid ":class:`importlib.resources.abc.Traversable`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:69 +#: deprecations/pending-removal-in-3.14.rst:62 msgid ":class:`importlib.resources.abc.TraversableResources`" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:71 +#: deprecations/pending-removal-in-3.14.rst:64 msgid "(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:73 +#: deprecations/pending-removal-in-3.14.rst:66 msgid "" ":mod:`itertools` had undocumented, inefficient, historically buggy, and " "inconsistent support for copy, deepcopy, and pickle operations. This will be " @@ -161,7 +149,7 @@ msgid "" "burden. (Contributed by Raymond Hettinger in :gh:`101588`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:79 +#: deprecations/pending-removal-in-3.14.rst:72 msgid "" ":mod:`multiprocessing`: The default start method will change to a safer one " "on Linux, BSDs, and other non-macOS POSIX platforms where ``'fork'`` is " @@ -172,67 +160,53 @@ msgid "" "``'fork'``. See :ref:`multiprocessing-start-methods`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:87 +#: deprecations/pending-removal-in-3.14.rst:80 msgid "" ":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." "PurePath.relative_to`: passing additional arguments is deprecated." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:91 +#: deprecations/pending-removal-in-3.14.rst:84 msgid "" ":mod:`pkgutil`: :func:`~pkgutil.find_loader` and :func:`~pkgutil.get_loader` " "now raise :exc:`DeprecationWarning`; use :func:`importlib.util.find_spec` " "instead. (Contributed by Nikita Sobolev in :gh:`97850`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:96 +#: deprecations/pending-removal-in-3.14.rst:89 msgid ":mod:`pty`:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:98 +#: deprecations/pending-removal-in-3.14.rst:91 msgid "``master_open()``: use :func:`pty.openpty`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:99 +#: deprecations/pending-removal-in-3.14.rst:92 msgid "``slave_open()``: use :func:`pty.openpty`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:101 +#: deprecations/pending-removal-in-3.14.rst:94 msgid ":mod:`sqlite3`:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:103 +#: deprecations/pending-removal-in-3.14.rst:96 msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:105 +#: deprecations/pending-removal-in-3.14.rst:98 msgid "" ":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` if :" "ref:`named placeholders ` are used and *parameters* is " "a sequence instead of a :class:`dict`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:109 -msgid "" -"date and datetime adapter, date and timestamp converter: see the :mod:" -"`sqlite3` documentation for suggested replacement recipes." -msgstr "" - -#: deprecations/pending-removal-in-3.14.rst:112 -msgid "" -":class:`types.CodeType`: Accessing :attr:`~codeobject.co_lnotab` was " -"deprecated in :pep:`626` since 3.10 and was planned to be removed in 3.12, " -"but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " -"in 3.14. (Contributed by Nikita Sobolev in :gh:`101866`.)" -msgstr "" - -#: deprecations/pending-removal-in-3.14.rst:119 +#: deprecations/pending-removal-in-3.14.rst:102 msgid "" ":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " "causes a :exc:`DeprecationWarning` to be emitted when it is used." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:122 +#: deprecations/pending-removal-in-3.14.rst:105 msgid "" ":mod:`urllib`: :class:`!urllib.parse.Quoter` is deprecated: it was not " "intended to be a public API. (Contributed by Gregory P. Smith in :gh:" diff --git a/deprecations/pending-removal-in-3.15.po b/deprecations/pending-removal-in-3.15.po index 2074d7f0f..79add45f9 100644 --- a/deprecations/pending-removal-in-3.15.po +++ b/deprecations/pending-removal-in-3.15.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -74,6 +74,22 @@ msgid "" msgstr "" #: deprecations/pending-removal-in-3.15.rst:40 +msgid ":mod:`types`:" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:42 +msgid "" +":class:`types.CodeType`: Accessing :attr:`~codeobject.co_lnotab` was " +"deprecated in :pep:`626` since 3.10 and was planned to be removed in 3.12, " +"but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " +"in 3.15. (Contributed by Nikita Sobolev in :gh:`101866`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:49 +msgid ":mod:`typing`:" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:51 msgid "" "When using the functional syntax to create a :class:`!NamedTuple` class, " "failing to pass a value to the *fields* parameter (``NT = " @@ -84,7 +100,7 @@ msgid "" "[])``." msgstr "" -#: deprecations/pending-removal-in-3.15.rst:47 +#: deprecations/pending-removal-in-3.15.rst:58 msgid "" ":class:`typing.TypedDict`: When using the functional syntax to create a :" "class:`!TypedDict` class, failing to pass a value to the *fields* parameter " @@ -94,7 +110,7 @@ msgid "" "fields, use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})``." msgstr "" -#: deprecations/pending-removal-in-3.15.rst:54 +#: deprecations/pending-removal-in-3.15.rst:65 msgid "" ":mod:`wave`: Deprecate the ``getmark()``, ``setmark()`` and ``getmarkers()`` " "methods of the :class:`wave.Wave_read` and :class:`wave.Wave_write` classes. " diff --git a/deprecations/pending-removal-in-3.16.po b/deprecations/pending-removal-in-3.16.po index 9526b7b03..7a44ec288 100644 --- a/deprecations/pending-removal-in-3.16.po +++ b/deprecations/pending-removal-in-3.16.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -22,16 +22,28 @@ msgid "Pending Removal in Python 3.16" msgstr "" #: deprecations/pending-removal-in-3.16.rst:4 +msgid "The import system:" +msgstr "" + +#: deprecations/pending-removal-in-3.16.rst:6 +msgid "" +"Setting :attr:`~module.__loader__` on a module while failing to set :attr:" +"`__spec__.loader ` is deprecated. In " +"Python 3.16, :attr:`!__loader__` will cease to be set or taken into " +"consideration by the import system or the standard library." +msgstr "" + +#: deprecations/pending-removal-in-3.16.rst:11 msgid "" ":mod:`array`: :class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the " "``'w'`` type instead (``Py_UCS4``)." msgstr "" -#: deprecations/pending-removal-in-3.16.rst:8 +#: deprecations/pending-removal-in-3.16.rst:15 msgid ":mod:`builtins`: ``~bool``, bitwise inversion on bool." msgstr "" -#: deprecations/pending-removal-in-3.16.rst:11 +#: deprecations/pending-removal-in-3.16.rst:18 msgid "" ":mod:`symtable`: Deprecate :meth:`symtable.Class.get_methods` due to the " "lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" diff --git a/howto/argparse-optparse.po b/howto/argparse-optparse.po index 2ec77acc0..747bca1b9 100644 --- a/howto/argparse-optparse.po +++ b/howto/argparse-optparse.po @@ -8,10 +8,11 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" diff --git a/howto/descriptor.po b/howto/descriptor.po index 15f76fd5c..8f6633a51 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -93,8 +93,8 @@ msgstr "" #: howto/descriptor.rst:45 msgid "" -"The :class:`Ten` class is a descriptor whose :meth:`__get__` method always " -"returns the constant ``10``:" +"The :class:`!Ten` class is a descriptor whose :meth:`~object.__get__` method " +"always returns the constant ``10``:" msgstr "" #: howto/descriptor.rst:48 @@ -209,11 +209,11 @@ msgstr "" #: howto/descriptor.rst:122 msgid "" "Besides showing how descriptors can run computations, this example also " -"reveals the purpose of the parameters to :meth:`__get__`. The *self* " -"parameter is *size*, an instance of *DirectorySize*. The *obj* parameter is " -"either *g* or *s*, an instance of *Directory*. It is the *obj* parameter " -"that lets the :meth:`__get__` method learn the target directory. The " -"*objtype* parameter is the class *Directory*." +"reveals the purpose of the parameters to :meth:`~object.__get__`. The " +"*self* parameter is *size*, an instance of *DirectorySize*. The *obj* " +"parameter is either *g* or *s*, an instance of *Directory*. It is the *obj* " +"parameter that lets the :meth:`~object.__get__` method learn the target " +"directory. The *objtype* parameter is the class *Directory*." msgstr "" #: howto/descriptor.rst:131 @@ -225,8 +225,8 @@ msgid "" "A popular use for descriptors is managing access to instance data. The " "descriptor is assigned to a public attribute in the class dictionary while " "the actual data is stored as a private attribute in the instance " -"dictionary. The descriptor's :meth:`__get__` and :meth:`__set__` methods " -"are triggered when the public attribute is accessed." +"dictionary. The descriptor's :meth:`~object.__get__` and :meth:`~object." +"__set__` methods are triggered when the public attribute is accessed." msgstr "" #: howto/descriptor.rst:139 @@ -321,10 +321,10 @@ msgstr "" #: howto/descriptor.rst:218 msgid "" -"In this example, the :class:`Person` class has two descriptor instances, " -"*name* and *age*. When the :class:`Person` class is defined, it makes a " -"callback to :meth:`__set_name__` in *LoggedAccess* so that the field names " -"can be recorded, giving each descriptor its own *public_name* and " +"In this example, the :class:`!Person` class has two descriptor instances, " +"*name* and *age*. When the :class:`!Person` class is defined, it makes a " +"callback to :meth:`~object.__set_name__` in *LoggedAccess* so that the field " +"names can be recorded, giving each descriptor its own *public_name* and " "*private_name*:" msgstr "" @@ -364,9 +364,9 @@ msgstr "" #: howto/descriptor.rst:256 msgid "" -"An interactive session shows that the :class:`Person` class has called :meth:" -"`__set_name__` so that the field names would be recorded. Here we call :" -"func:`vars` to look up the descriptor without triggering it:" +"An interactive session shows that the :class:`!Person` class has called :" +"meth:`~object.__set_name__` so that the field names would be recorded. Here " +"we call :func:`vars` to look up the descriptor without triggering it:" msgstr "" #: howto/descriptor.rst:260 @@ -409,16 +409,16 @@ msgstr "" #: howto/descriptor.rst:297 msgid "" -"A :term:`descriptor` is what we call any object that defines :meth:" -"`__get__`, :meth:`__set__`, or :meth:`__delete__`." +"A :term:`descriptor` is what we call any object that defines :meth:`~object." +"__get__`, :meth:`~object.__set__`, or :meth:`~object.__delete__`." msgstr "" #: howto/descriptor.rst:300 msgid "" -"Optionally, descriptors can have a :meth:`__set_name__` method. This is " -"only used in cases where a descriptor needs to know either the class where " -"it was created or the name of class variable it was assigned to. (This " -"method, if present, is called even if the class is not a descriptor.)" +"Optionally, descriptors can have a :meth:`~object.__set_name__` method. " +"This is only used in cases where a descriptor needs to know either the class " +"where it was created or the name of class variable it was assigned to. " +"(This method, if present, is called even if the class is not a descriptor.)" msgstr "" #: howto/descriptor.rst:305 @@ -479,7 +479,7 @@ msgstr "" #: howto/descriptor.rst:340 msgid "" -"This :class:`Validator` class is both an :term:`abstract base class` and a " +"This :class:`!Validator` class is both an :term:`abstract base class` and a " "managed attribute descriptor:" msgstr "" @@ -506,8 +506,8 @@ msgstr "" #: howto/descriptor.rst:363 msgid "" -"Custom validators need to inherit from :class:`Validator` and must supply a :" -"meth:`validate` method to test various restrictions as needed." +"Custom validators need to inherit from :class:`!Validator` and must supply " +"a :meth:`!validate` method to test various restrictions as needed." msgstr "" #: howto/descriptor.rst:368 @@ -520,19 +520,19 @@ msgstr "" #: howto/descriptor.rst:372 msgid "" -":class:`OneOf` verifies that a value is one of a restricted set of options." +":class:`!OneOf` verifies that a value is one of a restricted set of options." msgstr "" #: howto/descriptor.rst:374 msgid "" -":class:`Number` verifies that a value is either an :class:`int` or :class:" +":class:`!Number` verifies that a value is either an :class:`int` or :class:" "`float`. Optionally, it verifies that a value is between a given minimum or " "maximum." msgstr "" #: howto/descriptor.rst:378 msgid "" -":class:`String` verifies that a value is a :class:`str`. Optionally, it " +":class:`!String` verifies that a value is a :class:`str`. Optionally, it " "validates a given minimum or maximum length. It can validate a user-defined " "`predicate `_ " "as well." @@ -678,9 +678,9 @@ msgstr "" #: howto/descriptor.rst:500 msgid "" "In general, a descriptor is an attribute value that has one of the methods " -"in the descriptor protocol. Those methods are :meth:`__get__`, :meth:" -"`__set__`, and :meth:`__delete__`. If any of those methods are defined for " -"an attribute, it is said to be a :term:`descriptor`." +"in the descriptor protocol. Those methods are :meth:`~object.__get__`, :" +"meth:`~object.__set__`, and :meth:`~object.__delete__`. If any of those " +"methods are defined for an attribute, it is said to be a :term:`descriptor`." msgstr "" #: howto/descriptor.rst:505 @@ -729,10 +729,10 @@ msgstr "" #: howto/descriptor.rst:534 msgid "" -"If an object defines :meth:`__set__` or :meth:`__delete__`, it is considered " -"a data descriptor. Descriptors that only define :meth:`__get__` are called " -"non-data descriptors (they are often used for methods but other uses are " -"possible)." +"If an object defines :meth:`~object.__set__` or :meth:`~object.__delete__`, " +"it is considered a data descriptor. Descriptors that only define :meth:" +"`~object.__get__` are called non-data descriptors (they are often used for " +"methods but other uses are possible)." msgstr "" #: howto/descriptor.rst:539 @@ -746,10 +746,10 @@ msgstr "" #: howto/descriptor.rst:545 msgid "" -"To make a read-only data descriptor, define both :meth:`__get__` and :meth:" -"`__set__` with the :meth:`__set__` raising an :exc:`AttributeError` when " -"called. Defining the :meth:`__set__` method with an exception raising " -"placeholder is enough to make it a data descriptor." +"To make a read-only data descriptor, define both :meth:`~object.__get__` " +"and :meth:`~object.__set__` with the :meth:`~object.__set__` raising an :exc:" +"`AttributeError` when called. Defining the :meth:`~object.__set__` method " +"with an exception raising placeholder is enough to make it a data descriptor." msgstr "" #: howto/descriptor.rst:552 @@ -790,8 +790,8 @@ msgstr "" msgid "" "Instance lookup scans through a chain of namespaces giving data descriptors " "the highest priority, followed by instance variables, then non-data " -"descriptors, then class variables, and lastly :meth:`__getattr__` if it is " -"provided." +"descriptors, then class variables, and lastly :meth:`~object.__getattr__` if " +"it is provided." msgstr "" #: howto/descriptor.rst:577 @@ -837,16 +837,17 @@ msgstr "" #: howto/descriptor.rst:719 msgid "" -"Note, there is no :meth:`__getattr__` hook in the :meth:`__getattribute__` " -"code. That is why calling :meth:`__getattribute__` directly or with " -"``super().__getattribute__`` will bypass :meth:`__getattr__` entirely." +"Note, there is no :meth:`~object.__getattr__` hook in the :meth:`~object." +"__getattribute__` code. That is why calling :meth:`~object." +"__getattribute__` directly or with ``super().__getattribute__`` will bypass :" +"meth:`~object.__getattr__` entirely." msgstr "" #: howto/descriptor.rst:723 msgid "" "Instead, it is the dot operator and the :func:`getattr` function that are " -"responsible for invoking :meth:`__getattr__` whenever :meth:" -"`__getattribute__` raises an :exc:`AttributeError`. Their logic is " +"responsible for invoking :meth:`~object.__getattr__` whenever :meth:`~object." +"__getattribute__` raises an :exc:`AttributeError`. Their logic is " "encapsulated in a helper function:" msgstr "" @@ -868,8 +869,8 @@ msgstr "" #: howto/descriptor.rst:775 msgid "" -"The logic for a dotted lookup such as ``A.x`` is in :meth:`type." -"__getattribute__`. The steps are similar to those for :meth:`object." +"The logic for a dotted lookup such as ``A.x`` is in :meth:`!type." +"__getattribute__`. The steps are similar to those for :meth:`!object." "__getattribute__` but the instance dictionary lookup is replaced by a search " "through the class's :term:`method resolution order`." msgstr "" @@ -890,8 +891,8 @@ msgstr "" #: howto/descriptor.rst:789 msgid "" -"The logic for super's dotted lookup is in the :meth:`__getattribute__` " -"method for object returned by :func:`super`." +"The logic for super's dotted lookup is in the :meth:`~object." +"__getattribute__` method for object returned by :func:`super`." msgstr "" #: howto/descriptor.rst:792 @@ -916,8 +917,9 @@ msgstr "" #: howto/descriptor.rst:806 msgid "" -"The mechanism for descriptors is embedded in the :meth:`__getattribute__` " -"methods for :class:`object`, :class:`type`, and :func:`super`." +"The mechanism for descriptors is embedded in the :meth:`~object." +"__getattribute__` methods for :class:`object`, :class:`type`, and :func:" +"`super`." msgstr "" #: howto/descriptor.rst:809 @@ -925,7 +927,7 @@ msgid "The important points to remember are:" msgstr "" #: howto/descriptor.rst:811 -msgid "Descriptors are invoked by the :meth:`__getattribute__` method." +msgid "Descriptors are invoked by the :meth:`~object.__getattribute__` method." msgstr "" #: howto/descriptor.rst:813 @@ -936,16 +938,16 @@ msgstr "" #: howto/descriptor.rst:816 msgid "" -"Overriding :meth:`__getattribute__` prevents automatic descriptor calls " -"because all the descriptor logic is in that method." +"Overriding :meth:`~object.__getattribute__` prevents automatic descriptor " +"calls because all the descriptor logic is in that method." msgstr "" #: howto/descriptor.rst:819 msgid "" -":meth:`object.__getattribute__` and :meth:`type.__getattribute__` make " -"different calls to :meth:`__get__`. The first includes the instance and may " -"include the class. The second puts in ``None`` for the instance and always " -"includes the class." +":meth:`!object.__getattribute__` and :meth:`!type.__getattribute__` make " +"different calls to :meth:`~object.__get__`. The first includes the instance " +"and may include the class. The second puts in ``None`` for the instance and " +"always includes the class." msgstr "" #: howto/descriptor.rst:824 @@ -965,9 +967,9 @@ msgid "" "Sometimes it is desirable for a descriptor to know what class variable name " "it was assigned to. When a new class is created, the :class:`type` " "metaclass scans the dictionary of the new class. If any of the entries are " -"descriptors and if they define :meth:`__set_name__`, that method is called " -"with two arguments. The *owner* is the class where the descriptor is used, " -"and the *name* is the class variable the descriptor was assigned to." +"descriptors and if they define :meth:`~object.__set_name__`, that method is " +"called with two arguments. The *owner* is the class where the descriptor is " +"used, and the *name* is the class variable the descriptor was assigned to." msgstr "" #: howto/descriptor.rst:839 @@ -978,9 +980,9 @@ msgstr "" #: howto/descriptor.rst:842 msgid "" -"Since the update logic is in :meth:`type.__new__`, notifications only take " +"Since the update logic is in :meth:`!type.__new__`, notifications only take " "place at the time of class creation. If descriptors are added to the class " -"afterwards, :meth:`__set_name__` will need to be called manually." +"afterwards, :meth:`~object.__set_name__` will need to be called manually." msgstr "" #: howto/descriptor.rst:848 @@ -1021,7 +1023,7 @@ msgstr "" #: howto/descriptor.rst:873 msgid "" -"We can use the :class:`Field` class to define `models `_ that describe the schema for each table in a " "database:" msgstr "" @@ -1217,7 +1219,7 @@ msgstr "" #: howto/descriptor.rst:1153 msgid "" -"Either the built-in :func:`property` or our :func:`Property` equivalent " +"Either the built-in :func:`property` or our :func:`!Property` equivalent " "would work in this example." msgstr "" @@ -1263,9 +1265,9 @@ msgstr "" #: howto/descriptor.rst:1185 msgid "" "To support automatic creation of methods, functions include the :meth:" -"`__get__` method for binding methods during attribute access. This means " -"that functions are non-data descriptors that return bound methods during " -"dotted lookup from an instance. Here's how it works:" +"`~object.__get__` method for binding methods during attribute access. This " +"means that functions are non-data descriptors that return bound methods " +"during dotted lookup from an instance. Here's how it works:" msgstr "" #: howto/descriptor.rst:1190 @@ -1307,7 +1309,7 @@ msgstr "" #: howto/descriptor.rst:1217 msgid "" "Accessing the function through the class dictionary does not invoke :meth:" -"`__get__`. Instead, it just returns the underlying function object::" +"`~object.__get__`. Instead, it just returns the underlying function object::" msgstr "" #: howto/descriptor.rst:1220 @@ -1318,8 +1320,8 @@ msgstr "" #: howto/descriptor.rst:1223 msgid "" -"Dotted access from a class calls :meth:`__get__` which just returns the " -"underlying function unchanged::" +"Dotted access from a class calls :meth:`~object.__get__` which just returns " +"the underlying function unchanged::" msgstr "" #: howto/descriptor.rst:1226 @@ -1331,7 +1333,8 @@ msgstr "" #: howto/descriptor.rst:1229 msgid "" "The interesting behavior occurs during dotted access from an instance. The " -"dotted lookup calls :meth:`__get__` which returns a bound method object::" +"dotted lookup calls :meth:`~object.__get__` which returns a bound method " +"object::" msgstr "" #: howto/descriptor.rst:1232 @@ -1374,10 +1377,10 @@ msgstr "" #: howto/descriptor.rst:1255 msgid "" -"To recap, functions have a :meth:`__get__` method so that they can be " -"converted to a method when accessed as attributes. The non-data descriptor " -"transforms an ``obj.f(*args)`` call into ``f(obj, *args)``. Calling ``cls." -"f(*args)`` becomes ``f(*args)``." +"To recap, functions have a :meth:`~object.__get__` method so that they can " +"be converted to a method when accessed as attributes. The non-data " +"descriptor transforms an ``obj.f(*args)`` call into ``f(obj, *args)``. " +"Calling ``cls.f(*args)`` becomes ``f(*args)``." msgstr "" #: howto/descriptor.rst:1260 @@ -1796,8 +1799,8 @@ msgstr "" #: howto/descriptor.rst:1685 msgid "" -"The :meth:`type.__new__` method takes care of adding member objects to class " -"variables:" +"The :meth:`!type.__new__` method takes care of adding member objects to " +"class variables:" msgstr "" #: howto/descriptor.rst:1688 @@ -1855,8 +1858,8 @@ msgstr "" #: howto/descriptor.rst:1736 msgid "" -"To use the simulation in a real class, just inherit from :class:`Object` and " -"set the :term:`metaclass` to :class:`Type`:" +"To use the simulation in a real class, just inherit from :class:`!Object` " +"and set the :term:`metaclass` to :class:`Type`:" msgstr "" #: howto/descriptor.rst:1739 diff --git a/howto/enum.po b/howto/enum.po index f915168b2..980b5f77a 100644 --- a/howto/enum.po +++ b/howto/enum.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -16,24 +16,24 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -#: howto/enum.rst:3 +#: howto/enum.rst:5 msgid "Enum HOWTO" msgstr "" -#: howto/enum.rst:9 +#: howto/enum.rst:11 msgid "" "An :class:`Enum` is a set of symbolic names bound to unique values. They " "are similar to global variables, but they offer a more useful :func:`repr`, " "grouping, type-safety, and a few other features." msgstr "" -#: howto/enum.rst:13 +#: howto/enum.rst:15 msgid "" "They are most useful when you have a variable that can take one of a limited " "selection of values. For example, the days of the week::" msgstr "" -#: howto/enum.rst:16 +#: howto/enum.rst:18 msgid "" ">>> from enum import Enum\n" ">>> class Weekday(Enum):\n" @@ -46,11 +46,11 @@ msgid "" "... SUNDAY = 7" msgstr "" -#: howto/enum.rst:26 +#: howto/enum.rst:28 msgid "Or perhaps the RGB primary colors::" msgstr "" -#: howto/enum.rst:28 +#: howto/enum.rst:30 msgid "" ">>> from enum import Enum\n" ">>> class Color(Enum):\n" @@ -59,17 +59,17 @@ msgid "" "... BLUE = 3" msgstr "" -#: howto/enum.rst:34 +#: howto/enum.rst:36 msgid "" "As you can see, creating an :class:`Enum` is as simple as writing a class " "that inherits from :class:`Enum` itself." msgstr "" -#: howto/enum.rst:37 +#: howto/enum.rst:39 msgid "Case of Enum Members" msgstr "" -#: howto/enum.rst:39 +#: howto/enum.rst:41 msgid "" "Because Enums are used to represent constants, and to help avoid issues with " "name clashes between mixin-class methods/attributes and enum names, we " @@ -77,37 +77,37 @@ msgid "" "that style in our examples." msgstr "" -#: howto/enum.rst:44 +#: howto/enum.rst:46 msgid "" "Depending on the nature of the enum a member's value may or may not be " "important, but either way that value can be used to get the corresponding " "member::" msgstr "" -#: howto/enum.rst:48 +#: howto/enum.rst:50 msgid "" ">>> Weekday(3)\n" "" msgstr "" -#: howto/enum.rst:51 +#: howto/enum.rst:53 msgid "" "As you can see, the ``repr()`` of a member shows the enum name, the member " "name, and the value. The ``str()`` of a member shows only the enum name and " "member name::" msgstr "" -#: howto/enum.rst:55 +#: howto/enum.rst:57 msgid "" ">>> print(Weekday.THURSDAY)\n" "Weekday.THURSDAY" msgstr "" -#: howto/enum.rst:58 +#: howto/enum.rst:60 msgid "The *type* of an enumeration member is the enum it belongs to::" msgstr "" -#: howto/enum.rst:60 +#: howto/enum.rst:62 msgid "" ">>> type(Weekday.MONDAY)\n" "\n" @@ -115,49 +115,50 @@ msgid "" "True" msgstr "" -#: howto/enum.rst:65 -msgid "Enum members have an attribute that contains just their :attr:`name`::" +#: howto/enum.rst:67 +msgid "Enum members have an attribute that contains just their :attr:`!name`::" msgstr "" -#: howto/enum.rst:67 +#: howto/enum.rst:69 msgid "" ">>> print(Weekday.TUESDAY.name)\n" "TUESDAY" msgstr "" -#: howto/enum.rst:70 -msgid "Likewise, they have an attribute for their :attr:`value`::" +#: howto/enum.rst:72 +msgid "Likewise, they have an attribute for their :attr:`!value`::" msgstr "" -#: howto/enum.rst:73 +#: howto/enum.rst:75 msgid "" ">>> Weekday.WEDNESDAY.value\n" "3" msgstr "" -#: howto/enum.rst:76 +#: howto/enum.rst:78 msgid "" "Unlike many languages that treat enumerations solely as name/value pairs, " "Python Enums can have behavior added. For example, :class:`datetime.date` " -"has two methods for returning the weekday: :meth:`weekday` and :meth:" -"`isoweekday`. The difference is that one of them counts from 0-6 and the " -"other from 1-7. Rather than keep track of that ourselves we can add a method " -"to the :class:`Weekday` enum to extract the day from the :class:`date` " -"instance and return the matching enum member::" +"has two methods for returning the weekday: :meth:`~datetime.date.weekday` " +"and :meth:`~datetime.date.isoweekday`. The difference is that one of them " +"counts from 0-6 and the other from 1-7. Rather than keep track of that " +"ourselves we can add a method to the :class:`!Weekday` enum to extract the " +"day from the :class:`~datetime.date` instance and return the matching enum " +"member::" msgstr "" -#: howto/enum.rst:84 +#: howto/enum.rst:87 msgid "" "@classmethod\n" "def from_date(cls, date):\n" " return cls(date.isoweekday())" msgstr "" -#: howto/enum.rst:88 -msgid "The complete :class:`Weekday` enum now looks like this::" +#: howto/enum.rst:91 +msgid "The complete :class:`!Weekday` enum now looks like this::" msgstr "" -#: howto/enum.rst:90 +#: howto/enum.rst:93 msgid "" ">>> class Weekday(Enum):\n" "... MONDAY = 1\n" @@ -173,32 +174,32 @@ msgid "" "... return cls(date.isoweekday())" msgstr "" -#: howto/enum.rst:103 +#: howto/enum.rst:106 msgid "Now we can find out what today is! Observe::" msgstr "" -#: howto/enum.rst:105 +#: howto/enum.rst:108 msgid "" ">>> from datetime import date\n" ">>> Weekday.from_date(date.today()) \n" "" msgstr "" -#: howto/enum.rst:109 +#: howto/enum.rst:112 msgid "" "Of course, if you're reading this on some other day, you'll see that day " "instead." msgstr "" -#: howto/enum.rst:111 +#: howto/enum.rst:114 msgid "" -"This :class:`Weekday` enum is great if our variable only needs one day, but " +"This :class:`!Weekday` enum is great if our variable only needs one day, but " "what if we need several? Maybe we're writing a function to plot chores " "during a week, and don't want to use a :class:`list` -- we could use a " "different type of :class:`Enum`::" msgstr "" -#: howto/enum.rst:116 +#: howto/enum.rst:119 msgid "" ">>> from enum import Flag\n" ">>> class Weekday(Flag):\n" @@ -211,43 +212,43 @@ msgid "" "... SUNDAY = 64" msgstr "" -#: howto/enum.rst:126 +#: howto/enum.rst:129 msgid "" "We've changed two things: we're inherited from :class:`Flag`, and the values " "are all powers of 2." msgstr "" -#: howto/enum.rst:129 +#: howto/enum.rst:132 msgid "" -"Just like the original :class:`Weekday` enum above, we can have a single " +"Just like the original :class:`!Weekday` enum above, we can have a single " "selection::" msgstr "" -#: howto/enum.rst:131 +#: howto/enum.rst:134 msgid "" ">>> first_week_day = Weekday.MONDAY\n" ">>> first_week_day\n" "" msgstr "" -#: howto/enum.rst:135 +#: howto/enum.rst:138 msgid "" "But :class:`Flag` also allows us to combine several members into a single " "variable::" msgstr "" -#: howto/enum.rst:138 +#: howto/enum.rst:141 msgid "" ">>> weekend = Weekday.SATURDAY | Weekday.SUNDAY\n" ">>> weekend\n" "" msgstr "" -#: howto/enum.rst:142 +#: howto/enum.rst:145 msgid "You can even iterate over a :class:`Flag` variable::" msgstr "" -#: howto/enum.rst:144 +#: howto/enum.rst:147 msgid "" ">>> for day in weekend:\n" "... print(day)\n" @@ -255,11 +256,11 @@ msgid "" "Weekday.SUNDAY" msgstr "" -#: howto/enum.rst:149 +#: howto/enum.rst:152 msgid "Okay, let's get some chores set up::" msgstr "" -#: howto/enum.rst:151 +#: howto/enum.rst:154 msgid "" ">>> chores_for_ethan = {\n" "... 'feed the cat': Weekday.MONDAY | Weekday.WEDNESDAY | Weekday." @@ -269,11 +270,11 @@ msgid "" "... }" msgstr "" -#: howto/enum.rst:157 +#: howto/enum.rst:160 msgid "And a function to display the chores for a given day::" msgstr "" -#: howto/enum.rst:159 +#: howto/enum.rst:162 msgid "" ">>> def show_chores(chores, day):\n" "... for chore, days in chores.items():\n" @@ -284,13 +285,13 @@ msgid "" "answer SO questions" msgstr "" -#: howto/enum.rst:167 +#: howto/enum.rst:170 msgid "" "In cases where the actual values of the members do not matter, you can save " "yourself some work and use :func:`auto` for the values::" msgstr "" -#: howto/enum.rst:170 +#: howto/enum.rst:173 msgid "" ">>> from enum import auto\n" ">>> class Weekday(Flag):\n" @@ -304,18 +305,18 @@ msgid "" "... WEEKEND = SATURDAY | SUNDAY" msgstr "" -#: howto/enum.rst:186 +#: howto/enum.rst:189 msgid "Programmatic access to enumeration members and their attributes" msgstr "" -#: howto/enum.rst:188 +#: howto/enum.rst:191 msgid "" "Sometimes it's useful to access members in enumerations programmatically (i." "e. situations where ``Color.RED`` won't do because the exact color is not " "known at program-writing time). ``Enum`` allows such access::" msgstr "" -#: howto/enum.rst:192 +#: howto/enum.rst:195 msgid "" ">>> Color(1)\n" "\n" @@ -323,11 +324,11 @@ msgid "" "" msgstr "" -#: howto/enum.rst:197 +#: howto/enum.rst:200 msgid "If you want to access enum members by *name*, use item access::" msgstr "" -#: howto/enum.rst:199 +#: howto/enum.rst:202 msgid "" ">>> Color['RED']\n" "\n" @@ -335,11 +336,12 @@ msgid "" "" msgstr "" -#: howto/enum.rst:204 -msgid "If you have an enum member and need its :attr:`name` or :attr:`value`::" +#: howto/enum.rst:207 +msgid "" +"If you have an enum member and need its :attr:`!name` or :attr:`!value`::" msgstr "" -#: howto/enum.rst:206 +#: howto/enum.rst:209 msgid "" ">>> member = Color.RED\n" ">>> member.name\n" @@ -348,15 +350,15 @@ msgid "" "1" msgstr "" -#: howto/enum.rst:214 +#: howto/enum.rst:217 msgid "Duplicating enum members and values" msgstr "" -#: howto/enum.rst:216 +#: howto/enum.rst:219 msgid "Having two enum members with the same name is invalid::" msgstr "" -#: howto/enum.rst:218 +#: howto/enum.rst:221 msgid "" ">>> class Shape(Enum):\n" "... SQUARE = 2\n" @@ -367,7 +369,7 @@ msgid "" "TypeError: 'SQUARE' already defined as 2" msgstr "" -#: howto/enum.rst:226 +#: howto/enum.rst:229 msgid "" "However, an enum member can have other names associated with it. Given two " "entries ``A`` and ``B`` with the same value (and ``A`` defined first), ``B`` " @@ -376,7 +378,7 @@ msgid "" "member ``A``. By-name lookup of ``B`` will also return the member ``A``::" msgstr "" -#: howto/enum.rst:232 +#: howto/enum.rst:235 msgid "" ">>> class Shape(Enum):\n" "... SQUARE = 2\n" @@ -392,24 +394,24 @@ msgid "" "" msgstr "" -#: howto/enum.rst:247 +#: howto/enum.rst:250 msgid "" "Attempting to create a member with the same name as an already defined " "attribute (another member, a method, etc.) or attempting to create an " "attribute with the same name as a member is not allowed." msgstr "" -#: howto/enum.rst:253 +#: howto/enum.rst:256 msgid "Ensuring unique enumeration values" msgstr "" -#: howto/enum.rst:255 +#: howto/enum.rst:258 msgid "" "By default, enumerations allow multiple names as aliases for the same value. " "When this behavior isn't desired, you can use the :func:`unique` decorator::" msgstr "" -#: howto/enum.rst:258 +#: howto/enum.rst:261 msgid "" ">>> from enum import Enum, unique\n" ">>> @unique\n" @@ -424,15 +426,15 @@ msgid "" "ValueError: duplicate values found in : FOUR -> THREE" msgstr "" -#: howto/enum.rst:272 +#: howto/enum.rst:275 msgid "Using automatic values" msgstr "" -#: howto/enum.rst:274 +#: howto/enum.rst:277 msgid "If the exact value is unimportant you can use :class:`auto`::" msgstr "" -#: howto/enum.rst:276 +#: howto/enum.rst:279 msgid "" ">>> from enum import Enum, auto\n" ">>> class Color(Enum):\n" @@ -444,13 +446,13 @@ msgid "" "[1, 2, 3]" msgstr "" -#: howto/enum.rst:285 +#: howto/enum.rst:288 msgid "" -"The values are chosen by :func:`_generate_next_value_`, which can be " +"The values are chosen by :func:`~Enum._generate_next_value_`, which can be " "overridden::" msgstr "" -#: howto/enum.rst:288 +#: howto/enum.rst:291 msgid "" ">>> class AutoName(Enum):\n" "... @staticmethod\n" @@ -467,20 +469,21 @@ msgid "" "['NORTH', 'SOUTH', 'EAST', 'WEST']" msgstr "" -#: howto/enum.rst:304 +#: howto/enum.rst:307 msgid "" -"The :meth:`_generate_next_value_` method must be defined before any members." +"The :meth:`~Enum._generate_next_value_` method must be defined before any " +"members." msgstr "" -#: howto/enum.rst:307 +#: howto/enum.rst:310 msgid "Iteration" msgstr "" -#: howto/enum.rst:309 +#: howto/enum.rst:312 msgid "Iterating over the members of an enum does not provide the aliases::" msgstr "" -#: howto/enum.rst:311 +#: howto/enum.rst:314 msgid "" ">>> list(Shape)\n" "[, , ]\n" @@ -490,20 +493,20 @@ msgid "" "64>]" msgstr "" -#: howto/enum.rst:316 +#: howto/enum.rst:319 msgid "" "Note that the aliases ``Shape.ALIAS_FOR_SQUARE`` and ``Weekday.WEEKEND`` " "aren't shown." msgstr "" -#: howto/enum.rst:318 +#: howto/enum.rst:321 msgid "" "The special attribute ``__members__`` is a read-only ordered mapping of " "names to members. It includes all names defined in the enumeration, " "including the aliases::" msgstr "" -#: howto/enum.rst:322 +#: howto/enum.rst:325 msgid "" ">>> for name, member in Shape.__members__.items():\n" "... name, member\n" @@ -514,34 +517,34 @@ msgid "" "('ALIAS_FOR_SQUARE', )" msgstr "" -#: howto/enum.rst:330 +#: howto/enum.rst:333 msgid "" "The ``__members__`` attribute can be used for detailed programmatic access " "to the enumeration members. For example, finding all the aliases::" msgstr "" -#: howto/enum.rst:333 +#: howto/enum.rst:336 msgid "" ">>> [name for name, member in Shape.__members__.items() if member.name != " "name]\n" "['ALIAS_FOR_SQUARE']" msgstr "" -#: howto/enum.rst:338 +#: howto/enum.rst:341 msgid "" "Aliases for flags include values with multiple flags set, such as ``3``, and " "no flags set, i.e. ``0``." msgstr "" -#: howto/enum.rst:343 +#: howto/enum.rst:346 msgid "Comparisons" msgstr "" -#: howto/enum.rst:345 +#: howto/enum.rst:348 msgid "Enumeration members are compared by identity::" msgstr "" -#: howto/enum.rst:347 +#: howto/enum.rst:350 msgid "" ">>> Color.RED is Color.RED\n" "True\n" @@ -551,13 +554,13 @@ msgid "" "True" msgstr "" -#: howto/enum.rst:354 +#: howto/enum.rst:357 msgid "" "Ordered comparisons between enumeration values are *not* supported. Enum " "members are not integers (but see `IntEnum`_ below)::" msgstr "" -#: howto/enum.rst:357 +#: howto/enum.rst:360 msgid "" ">>> Color.RED < Color.BLUE\n" "Traceback (most recent call last):\n" @@ -565,11 +568,11 @@ msgid "" "TypeError: '<' not supported between instances of 'Color' and 'Color'" msgstr "" -#: howto/enum.rst:362 +#: howto/enum.rst:365 msgid "Equality comparisons are defined though::" msgstr "" -#: howto/enum.rst:364 +#: howto/enum.rst:367 msgid "" ">>> Color.BLUE == Color.RED\n" "False\n" @@ -579,31 +582,31 @@ msgid "" "True" msgstr "" -#: howto/enum.rst:371 +#: howto/enum.rst:374 msgid "" "Comparisons against non-enumeration values will always compare not equal " "(again, :class:`IntEnum` was explicitly designed to behave differently, see " "below)::" msgstr "" -#: howto/enum.rst:375 +#: howto/enum.rst:378 msgid "" ">>> Color.BLUE == 2\n" "False" msgstr "" -#: howto/enum.rst:380 +#: howto/enum.rst:383 msgid "" "It is possible to reload modules -- if a reloaded module contains enums, " "they will be recreated, and the new members may not compare identical/equal " "to the original members." msgstr "" -#: howto/enum.rst:385 +#: howto/enum.rst:388 msgid "Allowed members and attributes of enumerations" msgstr "" -#: howto/enum.rst:387 +#: howto/enum.rst:390 msgid "" "Most of the examples above use integers for enumeration values. Using " "integers is short and handy (and provided by default by the `Functional " @@ -612,13 +615,13 @@ msgid "" "*is* important, enumerations can have arbitrary values." msgstr "" -#: howto/enum.rst:393 +#: howto/enum.rst:396 msgid "" "Enumerations are Python classes, and can have methods and special methods as " "usual. If we have this enumeration::" msgstr "" -#: howto/enum.rst:396 +#: howto/enum.rst:399 msgid "" ">>> class Mood(Enum):\n" "... FUNKY = 1\n" @@ -638,11 +641,11 @@ msgid "" "..." msgstr "" -#: howto/enum.rst:413 +#: howto/enum.rst:416 msgid "Then::" msgstr "" -#: howto/enum.rst:415 +#: howto/enum.rst:418 msgid "" ">>> Mood.favorite_mood()\n" "\n" @@ -652,55 +655,55 @@ msgid "" "'my custom str! 1'" msgstr "" -#: howto/enum.rst:422 +#: howto/enum.rst:425 msgid "" "The rules for what is allowed are as follows: names that start and end with " "a single underscore are reserved by enum and cannot be used; all other " "attributes defined within an enumeration will become members of this " -"enumeration, with the exception of special methods (:meth:`__str__`, :meth:" -"`__add__`, etc.), descriptors (methods are also descriptors), and variable " -"names listed in :attr:`_ignore_`." +"enumeration, with the exception of special methods (:meth:`~object." +"__str__`, :meth:`~object.__add__`, etc.), descriptors (methods are also " +"descriptors), and variable names listed in :attr:`~Enum._ignore_`." msgstr "" -#: howto/enum.rst:429 +#: howto/enum.rst:432 msgid "" -"Note: if your enumeration defines :meth:`__new__` and/or :meth:`__init__`, " -"any value(s) given to the enum member will be passed into those methods. See " -"`Planet`_ for an example." +"Note: if your enumeration defines :meth:`~object.__new__` and/or :meth:" +"`~object.__init__`, any value(s) given to the enum member will be passed " +"into those methods. See `Planet`_ for an example." msgstr "" -#: howto/enum.rst:435 +#: howto/enum.rst:438 msgid "" -"The :meth:`__new__` method, if defined, is used during creation of the Enum " -"members; it is then replaced by Enum's :meth:`__new__` which is used after " -"class creation for lookup of existing members. See :ref:`new-vs-init` for " -"more details." +"The :meth:`~object.__new__` method, if defined, is used during creation of " +"the Enum members; it is then replaced by Enum's :meth:`~object.__new__` " +"which is used after class creation for lookup of existing members. See :ref:" +"`new-vs-init` for more details." msgstr "" -#: howto/enum.rst:442 +#: howto/enum.rst:445 msgid "Restricted Enum subclassing" msgstr "" -#: howto/enum.rst:444 +#: howto/enum.rst:447 msgid "" "A new :class:`Enum` class must have one base enum class, up to one concrete " "data type, and as many :class:`object`-based mixin classes as needed. The " "order of these base classes is::" msgstr "" -#: howto/enum.rst:448 +#: howto/enum.rst:451 msgid "" "class EnumName([mix-in, ...,] [data-type,] base-enum):\n" " pass" msgstr "" -#: howto/enum.rst:451 +#: howto/enum.rst:454 msgid "" "Also, subclassing an enumeration is allowed only if the enumeration does not " "define any members. So this is forbidden::" msgstr "" -#: howto/enum.rst:454 +#: howto/enum.rst:457 msgid "" ">>> class MoreColor(Color):\n" "... PINK = 17\n" @@ -710,11 +713,11 @@ msgid "" "TypeError: cannot extend " msgstr "" -#: howto/enum.rst:461 +#: howto/enum.rst:464 msgid "But this is allowed::" msgstr "" -#: howto/enum.rst:463 +#: howto/enum.rst:466 msgid "" ">>> class Foo(Enum):\n" "... def some_behavior(self):\n" @@ -726,7 +729,7 @@ msgid "" "..." msgstr "" -#: howto/enum.rst:472 +#: howto/enum.rst:475 msgid "" "Allowing subclassing of enums that define members would lead to a violation " "of some important invariants of types and instances. On the other hand, it " @@ -734,17 +737,17 @@ msgid "" "enumerations. (See `OrderedEnum`_ for an example.)" msgstr "" -#: howto/enum.rst:481 +#: howto/enum.rst:484 msgid "Dataclass support" msgstr "" -#: howto/enum.rst:483 +#: howto/enum.rst:486 msgid "" "When inheriting from a :class:`~dataclasses.dataclass`, the :meth:`~Enum." "__repr__` omits the inherited class' name. For example::" msgstr "" -#: howto/enum.rst:486 +#: howto/enum.rst:489 msgid "" ">>> from dataclasses import dataclass, field\n" ">>> @dataclass\n" @@ -761,27 +764,27 @@ msgid "" "" msgstr "" -#: howto/enum.rst:500 +#: howto/enum.rst:503 msgid "" "Use the :func:`!dataclass` argument ``repr=False`` to use the standard :func:" "`repr`." msgstr "" -#: howto/enum.rst:503 +#: howto/enum.rst:506 msgid "" "Only the dataclass fields are shown in the value area, not the dataclass' " "name." msgstr "" -#: howto/enum.rst:509 +#: howto/enum.rst:512 msgid "Pickling" msgstr "" -#: howto/enum.rst:511 +#: howto/enum.rst:514 msgid "Enumerations can be pickled and unpickled::" msgstr "" -#: howto/enum.rst:513 +#: howto/enum.rst:516 msgid "" ">>> from test.test_enum import Fruit\n" ">>> from pickle import dumps, loads\n" @@ -789,49 +792,49 @@ msgid "" "True" msgstr "" -#: howto/enum.rst:518 +#: howto/enum.rst:521 msgid "" "The usual restrictions for pickling apply: picklable enums must be defined " "in the top level of a module, since unpickling requires them to be " "importable from that module." msgstr "" -#: howto/enum.rst:524 +#: howto/enum.rst:527 msgid "" "With pickle protocol version 4 it is possible to easily pickle enums nested " "in other classes." msgstr "" -#: howto/enum.rst:527 +#: howto/enum.rst:530 msgid "" "It is possible to modify how enum members are pickled/unpickled by defining :" -"meth:`__reduce_ex__` in the enumeration class. The default method is by-" -"value, but enums with complicated values may want to use by-name::" +"meth:`~object.__reduce_ex__` in the enumeration class. The default method " +"is by-value, but enums with complicated values may want to use by-name::" msgstr "" -#: howto/enum.rst:531 +#: howto/enum.rst:534 msgid "" ">>> import enum\n" ">>> class MyEnum(enum.Enum):\n" "... __reduce_ex__ = enum.pickle_by_enum_name" msgstr "" -#: howto/enum.rst:537 +#: howto/enum.rst:540 msgid "" "Using by-name for flags is not recommended, as unnamed aliases will not " "unpickle." msgstr "" -#: howto/enum.rst:542 +#: howto/enum.rst:545 msgid "Functional API" msgstr "" -#: howto/enum.rst:544 +#: howto/enum.rst:547 msgid "" "The :class:`Enum` class is callable, providing the following functional API::" msgstr "" -#: howto/enum.rst:546 +#: howto/enum.rst:549 msgid "" ">>> Animal = Enum('Animal', 'ANT BEE CAT DOG')\n" ">>> Animal\n" @@ -842,13 +845,13 @@ msgid "" "[, , , ]" msgstr "" -#: howto/enum.rst:554 +#: howto/enum.rst:557 msgid "" "The semantics of this API resemble :class:`~collections.namedtuple`. The " "first argument of the call to :class:`Enum` is the name of the enumeration." msgstr "" -#: howto/enum.rst:557 +#: howto/enum.rst:560 msgid "" "The second argument is the *source* of enumeration member names. It can be " "a whitespace-separated string of names, a sequence of names, a sequence of 2-" @@ -857,10 +860,10 @@ msgid "" "enumerations; the others auto-assign increasing integers starting with 1 " "(use the ``start`` parameter to specify a different starting value). A new " "class derived from :class:`Enum` is returned. In other words, the above " -"assignment to :class:`Animal` is equivalent to::" +"assignment to :class:`!Animal` is equivalent to::" msgstr "" -#: howto/enum.rst:566 +#: howto/enum.rst:569 msgid "" ">>> class Animal(Enum):\n" "... ANT = 1\n" @@ -870,14 +873,14 @@ msgid "" "..." msgstr "" -#: howto/enum.rst:573 +#: howto/enum.rst:576 msgid "" "The reason for defaulting to ``1`` as the starting number and not ``0`` is " "that ``0`` is ``False`` in a boolean sense, but by default enum members all " "evaluate to ``True``." msgstr "" -#: howto/enum.rst:577 +#: howto/enum.rst:580 msgid "" "Pickling enums created with the functional API can be tricky as frame stack " "implementation details are used to try and figure out which module the " @@ -886,18 +889,18 @@ msgid "" "Jython). The solution is to specify the module name explicitly as follows::" msgstr "" -#: howto/enum.rst:583 +#: howto/enum.rst:586 msgid ">>> Animal = Enum('Animal', 'ANT BEE CAT DOG', module=__name__)" msgstr "" -#: howto/enum.rst:587 +#: howto/enum.rst:590 msgid "" "If ``module`` is not supplied, and Enum cannot determine what it is, the new " "Enum members will not be unpicklable; to keep errors closer to the source, " "pickling will be disabled." msgstr "" -#: howto/enum.rst:591 +#: howto/enum.rst:594 msgid "" "The new pickle protocol 4 also, in some circumstances, relies on :attr:" "`~type.__qualname__` being set to the location where pickle will be able to " @@ -905,16 +908,16 @@ msgid "" "SomeData in the global scope::" msgstr "" -#: howto/enum.rst:596 +#: howto/enum.rst:599 msgid "" ">>> Animal = Enum('Animal', 'ANT BEE CAT DOG', qualname='SomeData.Animal')" msgstr "" -#: howto/enum.rst:598 +#: howto/enum.rst:601 msgid "The complete signature is::" msgstr "" -#: howto/enum.rst:600 +#: howto/enum.rst:603 msgid "" "Enum(\n" " value='NewEnumName',\n" @@ -927,73 +930,73 @@ msgid "" " )" msgstr "" -#: howto/enum.rst:610 +#: howto/enum.rst:613 msgid "*value*: What the new enum class will record as its name." msgstr "" -#: howto/enum.rst:612 +#: howto/enum.rst:615 msgid "" "*names*: The enum members. This can be a whitespace- or comma-separated " "string (values will start at 1 unless otherwise specified)::" msgstr "" -#: howto/enum.rst:615 +#: howto/enum.rst:618 msgid "'RED GREEN BLUE' | 'RED,GREEN,BLUE' | 'RED, GREEN, BLUE'" msgstr "" -#: howto/enum.rst:617 +#: howto/enum.rst:620 msgid "or an iterator of names::" msgstr "" -#: howto/enum.rst:619 +#: howto/enum.rst:622 msgid "['RED', 'GREEN', 'BLUE']" msgstr "" -#: howto/enum.rst:621 +#: howto/enum.rst:624 msgid "or an iterator of (name, value) pairs::" msgstr "" -#: howto/enum.rst:623 +#: howto/enum.rst:626 msgid "[('CYAN', 4), ('MAGENTA', 5), ('YELLOW', 6)]" msgstr "" -#: howto/enum.rst:625 +#: howto/enum.rst:628 msgid "or a mapping::" msgstr "" -#: howto/enum.rst:627 +#: howto/enum.rst:630 msgid "{'CHARTREUSE': 7, 'SEA_GREEN': 11, 'ROSEMARY': 42}" msgstr "" -#: howto/enum.rst:629 +#: howto/enum.rst:632 msgid "*module*: name of module where new enum class can be found." msgstr "" -#: howto/enum.rst:631 +#: howto/enum.rst:634 msgid "*qualname*: where in module new enum class can be found." msgstr "" -#: howto/enum.rst:633 +#: howto/enum.rst:636 msgid "*type*: type to mix in to new enum class." msgstr "" -#: howto/enum.rst:635 +#: howto/enum.rst:638 msgid "*start*: number to start counting at if only names are passed in." msgstr "" -#: howto/enum.rst:637 +#: howto/enum.rst:640 msgid "The *start* parameter was added." msgstr "" -#: howto/enum.rst:642 +#: howto/enum.rst:645 msgid "Derived Enumerations" msgstr "" -#: howto/enum.rst:645 +#: howto/enum.rst:648 msgid "IntEnum" msgstr "" -#: howto/enum.rst:647 +#: howto/enum.rst:650 msgid "" "The first variation of :class:`Enum` that is provided is also a subclass of :" "class:`int`. Members of an :class:`IntEnum` can be compared to integers; by " @@ -1001,7 +1004,7 @@ msgid "" "each other::" msgstr "" -#: howto/enum.rst:652 +#: howto/enum.rst:655 msgid "" ">>> from enum import IntEnum\n" ">>> class Shape(IntEnum):\n" @@ -1020,13 +1023,13 @@ msgid "" "True" msgstr "" -#: howto/enum.rst:668 +#: howto/enum.rst:671 msgid "" "However, they still can't be compared to standard :class:`Enum` " "enumerations::" msgstr "" -#: howto/enum.rst:670 +#: howto/enum.rst:673 msgid "" ">>> class Shape(IntEnum):\n" "... CIRCLE = 1\n" @@ -1040,12 +1043,12 @@ msgid "" "False" msgstr "" -#: howto/enum.rst:681 +#: howto/enum.rst:684 msgid "" ":class:`IntEnum` values behave like integers in other ways you'd expect::" msgstr "" -#: howto/enum.rst:683 +#: howto/enum.rst:686 msgid "" ">>> int(Shape.CIRCLE)\n" "1\n" @@ -1055,11 +1058,11 @@ msgid "" "[0, 1]" msgstr "" -#: howto/enum.rst:692 +#: howto/enum.rst:695 msgid "StrEnum" msgstr "" -#: howto/enum.rst:694 +#: howto/enum.rst:697 msgid "" "The second variation of :class:`Enum` that is provided is also a subclass " "of :class:`str`. Members of a :class:`StrEnum` can be compared to strings; " @@ -1067,11 +1070,11 @@ msgid "" "each other." msgstr "" -#: howto/enum.rst:703 +#: howto/enum.rst:706 msgid "IntFlag" msgstr "" -#: howto/enum.rst:705 +#: howto/enum.rst:708 msgid "" "The next variation of :class:`Enum` provided, :class:`IntFlag`, is also " "based on :class:`int`. The difference being :class:`IntFlag` members can be " @@ -1081,23 +1084,23 @@ msgid "" "is used." msgstr "" -#: howto/enum.rst:713 +#: howto/enum.rst:716 msgid "" "Any operation on an :class:`IntFlag` member besides the bit-wise operations " "will lose the :class:`IntFlag` membership." msgstr "" -#: howto/enum.rst:716 +#: howto/enum.rst:719 msgid "" "Bit-wise operations that result in invalid :class:`IntFlag` values will lose " "the :class:`IntFlag` membership. See :class:`FlagBoundary` for details." msgstr "" -#: howto/enum.rst:723 +#: howto/enum.rst:726 msgid "Sample :class:`IntFlag` class::" msgstr "" -#: howto/enum.rst:725 +#: howto/enum.rst:728 msgid "" ">>> from enum import IntFlag\n" ">>> class Perm(IntFlag):\n" @@ -1114,11 +1117,11 @@ msgid "" "True" msgstr "" -#: howto/enum.rst:739 +#: howto/enum.rst:742 msgid "It is also possible to name the combinations::" msgstr "" -#: howto/enum.rst:741 +#: howto/enum.rst:744 msgid "" ">>> class Perm(IntFlag):\n" "... R = 4\n" @@ -1134,20 +1137,20 @@ msgid "" "" msgstr "" -#: howto/enum.rst:756 +#: howto/enum.rst:759 msgid "" "Named combinations are considered aliases. Aliases do not show up during " "iteration, but can be returned from by-value lookups." msgstr "" -#: howto/enum.rst:761 +#: howto/enum.rst:764 msgid "" "Another important difference between :class:`IntFlag` and :class:`Enum` is " "that if no flags are set (the value is 0), its boolean evaluation is :data:" "`False`::" msgstr "" -#: howto/enum.rst:764 +#: howto/enum.rst:767 msgid "" ">>> Perm.R & Perm.X\n" "\n" @@ -1155,13 +1158,13 @@ msgid "" "False" msgstr "" -#: howto/enum.rst:769 +#: howto/enum.rst:772 msgid "" "Because :class:`IntFlag` members are also subclasses of :class:`int` they " "can be combined with them (but may lose :class:`IntFlag` membership::" msgstr "" -#: howto/enum.rst:772 +#: howto/enum.rst:775 msgid "" ">>> Perm.X | 4\n" "\n" @@ -1170,33 +1173,33 @@ msgid "" "9" msgstr "" -#: howto/enum.rst:780 +#: howto/enum.rst:783 msgid "" "The negation operator, ``~``, always returns an :class:`IntFlag` member with " "a positive value::" msgstr "" -#: howto/enum.rst:783 +#: howto/enum.rst:786 msgid "" ">>> (~Perm.X).value == (Perm.R|Perm.W).value == 6\n" "True" msgstr "" -#: howto/enum.rst:786 +#: howto/enum.rst:789 msgid ":class:`IntFlag` members can also be iterated over::" msgstr "" -#: howto/enum.rst:788 +#: howto/enum.rst:791 msgid "" ">>> list(RW)\n" "[, ]" msgstr "" -#: howto/enum.rst:795 +#: howto/enum.rst:798 msgid "Flag" msgstr "" -#: howto/enum.rst:797 +#: howto/enum.rst:800 msgid "" "The last variation is :class:`Flag`. Like :class:`IntFlag`, :class:`Flag` " "members can be combined using the bitwise operators (&, \\|, ^, ~). Unlike :" @@ -1206,13 +1209,13 @@ msgid "" "value and let :class:`Flag` select an appropriate value." msgstr "" -#: howto/enum.rst:806 +#: howto/enum.rst:809 msgid "" "Like :class:`IntFlag`, if a combination of :class:`Flag` members results in " "no flags being set, the boolean evaluation is :data:`False`::" msgstr "" -#: howto/enum.rst:809 +#: howto/enum.rst:812 msgid "" ">>> from enum import Flag, auto\n" ">>> class Color(Flag):\n" @@ -1226,13 +1229,13 @@ msgid "" "False" msgstr "" -#: howto/enum.rst:820 +#: howto/enum.rst:823 msgid "" "Individual flags should have values that are powers of two (1, 2, 4, " "8, ...), while combinations of flags will not::" msgstr "" -#: howto/enum.rst:823 +#: howto/enum.rst:826 msgid "" ">>> class Color(Flag):\n" "... RED = auto()\n" @@ -1244,13 +1247,13 @@ msgid "" "" msgstr "" -#: howto/enum.rst:832 +#: howto/enum.rst:835 msgid "" "Giving a name to the \"no flags set\" condition does not change its boolean " "value::" msgstr "" -#: howto/enum.rst:835 +#: howto/enum.rst:838 msgid "" ">>> class Color(Flag):\n" "... BLACK = 0\n" @@ -1264,18 +1267,18 @@ msgid "" "False" msgstr "" -#: howto/enum.rst:846 +#: howto/enum.rst:849 msgid ":class:`Flag` members can also be iterated over::" msgstr "" -#: howto/enum.rst:848 +#: howto/enum.rst:851 msgid "" ">>> purple = Color.RED | Color.BLUE\n" ">>> list(purple)\n" "[, ]" msgstr "" -#: howto/enum.rst:856 +#: howto/enum.rst:859 msgid "" "For the majority of new code, :class:`Enum` and :class:`Flag` are strongly " "recommended, since :class:`IntEnum` and :class:`IntFlag` break some semantic " @@ -1286,48 +1289,48 @@ msgid "" "enumerations, or for interoperability with other systems." msgstr "" -#: howto/enum.rst:866 +#: howto/enum.rst:869 msgid "Others" msgstr "" -#: howto/enum.rst:868 +#: howto/enum.rst:871 msgid "" "While :class:`IntEnum` is part of the :mod:`enum` module, it would be very " "simple to implement independently::" msgstr "" -#: howto/enum.rst:871 +#: howto/enum.rst:874 msgid "" "class IntEnum(int, Enum):\n" " pass" msgstr "" -#: howto/enum.rst:874 +#: howto/enum.rst:877 msgid "" "This demonstrates how similar derived enumerations can be defined; for " -"example a :class:`FloatEnum` that mixes in :class:`float` instead of :class:" +"example a :class:`!FloatEnum` that mixes in :class:`float` instead of :class:" "`int`." msgstr "" -#: howto/enum.rst:877 +#: howto/enum.rst:880 msgid "Some rules:" msgstr "" -#: howto/enum.rst:879 +#: howto/enum.rst:882 msgid "" "When subclassing :class:`Enum`, mix-in types must appear before :class:" "`Enum` itself in the sequence of bases, as in the :class:`IntEnum` example " "above." msgstr "" -#: howto/enum.rst:882 +#: howto/enum.rst:885 msgid "" "Mix-in types must be subclassable. For example, :class:`bool` and :class:" "`range` are not subclassable and will throw an error during Enum creation if " "used as the mix-in type." msgstr "" -#: howto/enum.rst:885 +#: howto/enum.rst:888 msgid "" "While :class:`Enum` can have members of any type, once you mix in an " "additional type, all the members must have values of that type, e.g. :class:" @@ -1335,57 +1338,60 @@ msgid "" "methods and don't specify another type." msgstr "" -#: howto/enum.rst:889 +#: howto/enum.rst:892 msgid "" -"When another data type is mixed in, the :attr:`value` attribute is *not the " -"same* as the enum member itself, although it is equivalent and will compare " -"equal." +"When another data type is mixed in, the :attr:`~Enum.value` attribute is " +"*not the same* as the enum member itself, although it is equivalent and will " +"compare equal." msgstr "" -#: howto/enum.rst:892 +#: howto/enum.rst:895 msgid "" -"A ``data type`` is a mixin that defines :meth:`__new__`, or a :class:" +"A ``data type`` is a mixin that defines :meth:`~object.__new__`, or a :class:" "`~dataclasses.dataclass`" msgstr "" -#: howto/enum.rst:894 +#: howto/enum.rst:897 msgid "" "%-style formatting: ``%s`` and ``%r`` call the :class:`Enum` class's :meth:" -"`__str__` and :meth:`__repr__` respectively; other codes (such as ``%i`` or " -"``%h`` for IntEnum) treat the enum member as its mixed-in type." +"`~object.__str__` and :meth:`~object.__repr__` respectively; other codes " +"(such as ``%i`` or ``%h`` for IntEnum) treat the enum member as its mixed-in " +"type." msgstr "" -#: howto/enum.rst:897 +#: howto/enum.rst:900 msgid "" ":ref:`Formatted string literals `, :meth:`str.format`, and :func:" -"`format` will use the enum's :meth:`__str__` method." +"`format` will use the enum's :meth:`~object.__str__` method." msgstr "" -#: howto/enum.rst:902 +#: howto/enum.rst:905 msgid "" "Because :class:`IntEnum`, :class:`IntFlag`, and :class:`StrEnum` are " "designed to be drop-in replacements for existing constants, their :meth:" -"`__str__` method has been reset to their data types' :meth:`__str__` method." +"`~object.__str__` method has been reset to their data types' :meth:`~object." +"__str__` method." msgstr "" -#: howto/enum.rst:910 -msgid "When to use :meth:`__new__` vs. :meth:`__init__`" +#: howto/enum.rst:913 +msgid "When to use :meth:`~object.__new__` vs. :meth:`~object.__init__`" msgstr "" -#: howto/enum.rst:912 +#: howto/enum.rst:915 msgid "" -":meth:`__new__` must be used whenever you want to customize the actual value " -"of the :class:`Enum` member. Any other modifications may go in either :meth:" -"`__new__` or :meth:`__init__`, with :meth:`__init__` being preferred." +":meth:`~object.__new__` must be used whenever you want to customize the " +"actual value of the :class:`Enum` member. Any other modifications may go in " +"either :meth:`~object.__new__` or :meth:`~object.__init__`, with :meth:" +"`~object.__init__` being preferred." msgstr "" -#: howto/enum.rst:916 +#: howto/enum.rst:919 msgid "" "For example, if you want to pass several items to the constructor, but only " "want one of them to be the value::" msgstr "" -#: howto/enum.rst:919 +#: howto/enum.rst:922 msgid "" ">>> class Coordinate(bytes, Enum):\n" "... \"\"\"\n" @@ -1410,99 +1416,102 @@ msgid "" "Coordinate.VY" msgstr "" -#: howto/enum.rst:943 +#: howto/enum.rst:946 msgid "" "*Do not* call ``super().__new__()``, as the lookup-only ``__new__`` is the " "one that is found; instead, use the data type directly." msgstr "" -#: howto/enum.rst:948 +#: howto/enum.rst:951 msgid "Finer Points" msgstr "" -#: howto/enum.rst:951 +#: howto/enum.rst:954 msgid "Supported ``__dunder__`` names" msgstr "" -#: howto/enum.rst:953 +#: howto/enum.rst:956 msgid "" -":attr:`__members__` is a read-only ordered mapping of ``member_name``:" -"``member`` items. It is only available on the class." +":attr:`~enum.EnumType.__members__` is a read-only ordered mapping of " +"``member_name``:``member`` items. It is only available on the class." msgstr "" -#: howto/enum.rst:956 +#: howto/enum.rst:959 msgid "" -":meth:`__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." +":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:`~Enum." +"_value_` appropriately. Once all the members are created it is no longer " +"used." msgstr "" -#: howto/enum.rst:962 +#: howto/enum.rst:965 msgid "Supported ``_sunder_`` names" msgstr "" -#: howto/enum.rst:964 -msgid "``_name_`` -- name of the member" +#: howto/enum.rst:967 +msgid ":attr:`~Enum._name_` -- name of the member" msgstr "" -#: howto/enum.rst:965 +#: howto/enum.rst:968 msgid "" -"``_value_`` -- value of the member; can be set / modified in ``__new__``" +":attr:`~Enum._value_` -- value of the member; can be set / modified in " +"``__new__``" msgstr "" -#: howto/enum.rst:967 +#: howto/enum.rst:970 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 "" -#: howto/enum.rst:969 +#: howto/enum.rst:972 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 "" -#: howto/enum.rst:972 +#: howto/enum.rst:975 msgid "" -"``_order_`` -- used in Python 2/3 code to ensure member order is consistent " -"(class attribute, removed during class creation)" +":attr:`~Enum._order_` -- used in Python 2/3 code to ensure member order is " +"consistent (class attribute, removed during class creation)" msgstr "" -#: howto/enum.rst:974 +#: howto/enum.rst:977 msgid "" -"``_generate_next_value_`` -- used by the `Functional API`_ and by :class:" -"`auto` to get an appropriate value for an enum member; may be overridden" +":meth:`~Enum._generate_next_value_` -- used by the `Functional API`_ and by :" +"class:`auto` to get an appropriate value for an enum member; may be " +"overridden" msgstr "" -#: howto/enum.rst:980 +#: howto/enum.rst:983 msgid "" "For standard :class:`Enum` classes the next value chosen is the last value " "seen incremented by one." msgstr "" -#: howto/enum.rst:983 +#: howto/enum.rst:986 msgid "" "For :class:`Flag` classes the next value chosen will be the next highest " "power-of-two, regardless of the last value seen." msgstr "" -#: howto/enum.rst:986 +#: howto/enum.rst:989 msgid "``_missing_``, ``_order_``, ``_generate_next_value_``" msgstr "" -#: howto/enum.rst:987 +#: howto/enum.rst:990 msgid "``_ignore_``" msgstr "" -#: howto/enum.rst:989 +#: howto/enum.rst:992 msgid "" -"To help keep Python 2 / Python 3 code in sync an :attr:`_order_` attribute " -"can be provided. It will be checked against the actual order of the " -"enumeration and raise an error if the two do not match::" +"To help keep Python 2 / Python 3 code in sync an :attr:`~Enum._order_` " +"attribute can be provided. It will be checked against the actual order of " +"the enumeration and raise an error if the two do not match::" msgstr "" -#: howto/enum.rst:993 +#: howto/enum.rst:996 msgid "" ">>> class Color(Enum):\n" "... _order_ = 'RED GREEN BLUE'\n" @@ -1517,27 +1526,27 @@ msgid "" " ['RED', 'GREEN', 'BLUE']" msgstr "" -#: howto/enum.rst:1007 +#: howto/enum.rst:1010 msgid "" -"In Python 2 code the :attr:`_order_` attribute is necessary as definition " -"order is lost before it can be recorded." +"In Python 2 code the :attr:`~Enum._order_` attribute is necessary as " +"definition order is lost before it can be recorded." msgstr "" -#: howto/enum.rst:1012 +#: howto/enum.rst:1015 msgid "_Private__names" msgstr "" -#: howto/enum.rst:1014 +#: howto/enum.rst:1017 msgid "" ":ref:`Private names ` are not converted to enum " "members, but remain normal attributes." msgstr "" -#: howto/enum.rst:1021 +#: howto/enum.rst:1024 msgid "``Enum`` member type" msgstr "" -#: howto/enum.rst:1023 +#: howto/enum.rst:1026 msgid "" "Enum members are instances of their enum class, and are normally accessed as " "``EnumClass.member``. In certain situations, such as writing custom enum " @@ -1547,18 +1556,18 @@ msgid "" "strongly recommended." msgstr "" -#: howto/enum.rst:1034 +#: howto/enum.rst:1037 msgid "Creating members that are mixed with other data types" msgstr "" -#: howto/enum.rst:1036 +#: howto/enum.rst:1039 msgid "" "When subclassing other data types, such as :class:`int` or :class:`str`, " "with an :class:`Enum`, all values after the ``=`` are passed to that data " "type's constructor. For example::" msgstr "" -#: howto/enum.rst:1040 +#: howto/enum.rst:1043 msgid "" ">>> class MyEnum(IntEnum): # help(int) -> int(x, base=10) -> integer\n" "... example = '11', 16 # so x='11' and base=16\n" @@ -1567,11 +1576,11 @@ msgid "" "17" msgstr "" -#: howto/enum.rst:1048 +#: howto/enum.rst:1051 msgid "Boolean value of ``Enum`` classes and members" msgstr "" -#: howto/enum.rst:1050 +#: howto/enum.rst:1053 msgid "" "Enum classes that are mixed with non-:class:`Enum` types (such as :class:" "`int`, :class:`str`, etc.) are evaluated according to the mixed-in type's " @@ -1580,28 +1589,28 @@ msgid "" "your class::" msgstr "" -#: howto/enum.rst:1056 +#: howto/enum.rst:1059 msgid "" "def __bool__(self):\n" " return bool(self.value)" msgstr "" -#: howto/enum.rst:1059 +#: howto/enum.rst:1062 msgid "Plain :class:`Enum` classes always evaluate as :data:`True`." msgstr "" -#: howto/enum.rst:1063 +#: howto/enum.rst:1066 msgid "``Enum`` classes with methods" msgstr "" -#: howto/enum.rst:1065 +#: howto/enum.rst:1068 msgid "" "If you give your enum subclass extra methods, like the `Planet`_ class " "below, those methods will show up in a :func:`dir` of the member, but not of " "the class::" msgstr "" -#: howto/enum.rst:1069 +#: howto/enum.rst:1072 msgid "" ">>> dir(Planet) \n" "['EARTH', 'JUPITER', 'MARS', 'MERCURY', 'NEPTUNE', 'SATURN', 'URANUS', " @@ -1611,17 +1620,17 @@ msgid "" "'surface_gravity', 'value']" msgstr "" -#: howto/enum.rst:1076 +#: howto/enum.rst:1079 msgid "Combining members of ``Flag``" msgstr "" -#: howto/enum.rst:1078 +#: howto/enum.rst:1081 msgid "" "Iterating over a combination of :class:`Flag` members will only return the " "members that are comprised of a single bit::" msgstr "" -#: howto/enum.rst:1081 +#: howto/enum.rst:1084 msgid "" ">>> class Color(Flag):\n" "... RED = auto()\n" @@ -1637,15 +1646,15 @@ msgid "" "" msgstr "" -#: howto/enum.rst:1096 +#: howto/enum.rst:1099 msgid "``Flag`` and ``IntFlag`` minutia" msgstr "" -#: howto/enum.rst:1098 +#: howto/enum.rst:1101 msgid "Using the following snippet for our examples::" msgstr "" -#: howto/enum.rst:1100 +#: howto/enum.rst:1103 msgid "" ">>> class Color(IntFlag):\n" "... BLACK = 0\n" @@ -1657,35 +1666,35 @@ msgid "" "..." msgstr "" -#: howto/enum.rst:1109 +#: howto/enum.rst:1112 msgid "the following are true:" msgstr "" -#: howto/enum.rst:1111 +#: howto/enum.rst:1114 msgid "single-bit flags are canonical" msgstr "" -#: howto/enum.rst:1112 +#: howto/enum.rst:1115 msgid "multi-bit and zero-bit flags are aliases" msgstr "" -#: howto/enum.rst:1113 +#: howto/enum.rst:1116 msgid "only canonical flags are returned during iteration::" msgstr "" -#: howto/enum.rst:1115 +#: howto/enum.rst:1118 msgid "" ">>> list(Color.WHITE)\n" "[, , ]" msgstr "" -#: howto/enum.rst:1118 +#: howto/enum.rst:1121 msgid "" "negating a flag or flag set returns a new flag/flag set with the " "corresponding positive integer value::" msgstr "" -#: howto/enum.rst:1121 +#: howto/enum.rst:1124 msgid "" ">>> Color.BLUE\n" "\n" @@ -1694,11 +1703,11 @@ msgid "" "" msgstr "" -#: howto/enum.rst:1127 +#: howto/enum.rst:1130 msgid "names of pseudo-flags are constructed from their members' names::" msgstr "" -#: howto/enum.rst:1129 +#: howto/enum.rst:1132 msgid "" ">>> (Color.RED | Color.GREEN).name\n" "'RED|GREEN'\n" @@ -1712,11 +1721,11 @@ msgid "" "True" msgstr "" -#: howto/enum.rst:1140 +#: howto/enum.rst:1143 msgid "multi-bit flags, aka aliases, can be returned from operations::" msgstr "" -#: howto/enum.rst:1142 +#: howto/enum.rst:1145 msgid "" ">>> Color.RED | Color.BLUE\n" "\n" @@ -1728,25 +1737,25 @@ msgid "" "" msgstr "" -#: howto/enum.rst:1151 +#: howto/enum.rst:1154 msgid "" "membership / containment checking: zero-valued flags are always considered " "to be contained::" msgstr "" -#: howto/enum.rst:1154 +#: howto/enum.rst:1157 msgid "" ">>> Color.BLACK in Color.WHITE\n" "True" msgstr "" -#: howto/enum.rst:1157 +#: howto/enum.rst:1160 msgid "" "otherwise, only if all bits of one flag are in the other flag will True be " "returned::" msgstr "" -#: howto/enum.rst:1160 +#: howto/enum.rst:1163 msgid "" ">>> Color.PURPLE in Color.WHITE\n" "True\n" @@ -1755,77 +1764,78 @@ msgid "" "False" msgstr "" -#: howto/enum.rst:1166 +#: howto/enum.rst:1169 msgid "" "There is a new boundary mechanism that controls how out-of-range / invalid " "bits are handled: ``STRICT``, ``CONFORM``, ``EJECT``, and ``KEEP``:" msgstr "" -#: howto/enum.rst:1169 +#: howto/enum.rst:1172 msgid "STRICT --> raises an exception when presented with invalid values" msgstr "" -#: howto/enum.rst:1170 +#: howto/enum.rst:1173 msgid "CONFORM --> discards any invalid bits" msgstr "" -#: howto/enum.rst:1171 +#: howto/enum.rst:1174 msgid "EJECT --> lose Flag status and become a normal int with the given value" msgstr "" -#: howto/enum.rst:1172 +#: howto/enum.rst:1175 msgid "KEEP --> keep the extra bits" msgstr "" -#: howto/enum.rst:1174 +#: howto/enum.rst:1177 msgid "keeps Flag status and extra bits" msgstr "" -#: howto/enum.rst:1175 +#: howto/enum.rst:1178 msgid "extra bits do not show up in iteration" msgstr "" -#: howto/enum.rst:1176 +#: howto/enum.rst:1179 msgid "extra bits do show up in repr() and str()" msgstr "" -#: howto/enum.rst:1178 +#: howto/enum.rst:1181 msgid "" "The default for Flag is ``STRICT``, the default for ``IntFlag`` is " "``EJECT``, and the default for ``_convert_`` is ``KEEP`` (see ``ssl." "Options`` for an example of when ``KEEP`` is needed)." msgstr "" -#: howto/enum.rst:1186 +#: howto/enum.rst:1189 msgid "How are Enums and Flags different?" msgstr "" -#: howto/enum.rst:1188 +#: howto/enum.rst:1191 msgid "" "Enums have a custom metaclass that affects many aspects of both derived :" "class:`Enum` classes and their instances (members)." msgstr "" -#: howto/enum.rst:1193 +#: howto/enum.rst:1196 msgid "Enum Classes" msgstr "" -#: howto/enum.rst:1195 +#: howto/enum.rst:1198 msgid "" "The :class:`EnumType` metaclass is responsible for providing the :meth:" -"`__contains__`, :meth:`__dir__`, :meth:`__iter__` and other methods that " -"allow one to do things with an :class:`Enum` class that fail on a typical " -"class, such as ``list(Color)`` or ``some_enum_var in Color``. :class:" -"`EnumType` is responsible for ensuring that various other methods on the " -"final :class:`Enum` class are correct (such as :meth:`__new__`, :meth:" -"`__getnewargs__`, :meth:`__str__` and :meth:`__repr__`)." +"`~object.__contains__`, :meth:`~object.__dir__`, :meth:`~object.__iter__` " +"and other methods that allow one to do things with an :class:`Enum` class " +"that fail on a typical class, such as ``list(Color)`` or ``some_enum_var in " +"Color``. :class:`EnumType` is responsible for ensuring that various other " +"methods on the final :class:`Enum` class are correct (such as :meth:`~object." +"__new__`, :meth:`~object.__getnewargs__`, :meth:`~object.__str__` and :meth:" +"`~object.__repr__`)." msgstr "" -#: howto/enum.rst:1204 +#: howto/enum.rst:1207 msgid "Flag Classes" msgstr "" -#: howto/enum.rst:1206 +#: howto/enum.rst:1209 msgid "" "Flags have an expanded view of aliasing: to be canonical, the value of a " "flag needs to be a power-of-two value, and not a duplicate name. So, in " @@ -1834,68 +1844,68 @@ msgid "" "considered an alias." msgstr "" -#: howto/enum.rst:1212 +#: howto/enum.rst:1215 msgid "Enum Members (aka instances)" msgstr "" -#: howto/enum.rst:1214 +#: howto/enum.rst:1217 msgid "" "The most interesting thing about enum members is that they are singletons. :" "class:`EnumType` creates them all while it is creating the enum class " -"itself, and then puts a custom :meth:`__new__` in place to ensure that no " -"new ones are ever instantiated by returning only the existing member " +"itself, and then puts a custom :meth:`~object.__new__` in place to ensure " +"that no new ones are ever instantiated by returning only the existing member " "instances." msgstr "" -#: howto/enum.rst:1220 +#: howto/enum.rst:1223 msgid "Flag Members" msgstr "" -#: howto/enum.rst:1222 +#: howto/enum.rst:1225 msgid "" "Flag members can be iterated over just like the :class:`Flag` class, and " "only the canonical members will be returned. For example::" msgstr "" -#: howto/enum.rst:1225 +#: howto/enum.rst:1228 msgid "" ">>> list(Color)\n" "[, , ]" msgstr "" -#: howto/enum.rst:1228 +#: howto/enum.rst:1231 msgid "(Note that ``BLACK``, ``PURPLE``, and ``WHITE`` do not show up.)" msgstr "" -#: howto/enum.rst:1230 +#: howto/enum.rst:1233 msgid "" "Inverting a flag member returns the corresponding positive value, rather " "than a negative value --- for example::" msgstr "" -#: howto/enum.rst:1233 +#: howto/enum.rst:1236 msgid "" ">>> ~Color.RED\n" "" msgstr "" -#: howto/enum.rst:1236 +#: howto/enum.rst:1239 msgid "" "Flag members have a length corresponding to the number of power-of-two " "values they contain. For example::" msgstr "" -#: howto/enum.rst:1239 +#: howto/enum.rst:1242 msgid "" ">>> len(Color.PURPLE)\n" "2" msgstr "" -#: howto/enum.rst:1246 +#: howto/enum.rst:1249 msgid "Enum Cookbook" msgstr "" -#: howto/enum.rst:1249 +#: howto/enum.rst:1252 msgid "" "While :class:`Enum`, :class:`IntEnum`, :class:`StrEnum`, :class:`Flag`, and :" "class:`IntFlag` are expected to cover the majority of use-cases, they cannot " @@ -1903,50 +1913,50 @@ msgid "" "that can be used directly, or as examples for creating one's own." msgstr "" -#: howto/enum.rst:1256 +#: howto/enum.rst:1259 msgid "Omitting values" msgstr "" -#: howto/enum.rst:1258 +#: howto/enum.rst:1261 msgid "" "In many use-cases, one doesn't care what the actual value of an enumeration " "is. There are several ways to define this type of simple enumeration:" msgstr "" -#: howto/enum.rst:1261 +#: howto/enum.rst:1264 msgid "use instances of :class:`auto` for the value" msgstr "" -#: howto/enum.rst:1262 +#: howto/enum.rst:1265 msgid "use instances of :class:`object` as the value" msgstr "" -#: howto/enum.rst:1263 +#: howto/enum.rst:1266 msgid "use a descriptive string as the value" msgstr "" -#: howto/enum.rst:1264 +#: howto/enum.rst:1267 msgid "" -"use a tuple as the value and a custom :meth:`__new__` to replace the tuple " -"with an :class:`int` value" +"use a tuple as the value and a custom :meth:`~object.__new__` to replace the " +"tuple with an :class:`int` value" msgstr "" -#: howto/enum.rst:1267 +#: howto/enum.rst:1270 msgid "" "Using any of these methods signifies to the user that these values are not " "important, and also enables one to add, remove, or reorder members without " "having to renumber the remaining members." msgstr "" -#: howto/enum.rst:1273 +#: howto/enum.rst:1276 msgid "Using :class:`auto`" msgstr "" -#: howto/enum.rst:1275 +#: howto/enum.rst:1278 msgid "Using :class:`auto` would look like::" msgstr "" -#: howto/enum.rst:1277 +#: howto/enum.rst:1280 msgid "" ">>> class Color(Enum):\n" "... RED = auto()\n" @@ -1957,15 +1967,15 @@ msgid "" "" msgstr "" -#: howto/enum.rst:1287 +#: howto/enum.rst:1290 msgid "Using :class:`object`" msgstr "" -#: howto/enum.rst:1289 +#: howto/enum.rst:1292 msgid "Using :class:`object` would look like::" msgstr "" -#: howto/enum.rst:1291 +#: howto/enum.rst:1294 msgid "" ">>> class Color(Enum):\n" "... RED = object()\n" @@ -1976,13 +1986,13 @@ msgid "" ">" msgstr "" -#: howto/enum.rst:1299 +#: howto/enum.rst:1302 msgid "" "This is also a good example of why you might want to write your own :meth:" -"`__repr__`::" +"`~object.__repr__`::" msgstr "" -#: howto/enum.rst:1302 +#: howto/enum.rst:1305 msgid "" ">>> class Color(Enum):\n" "... RED = object()\n" @@ -1995,15 +2005,15 @@ msgid "" "" msgstr "" -#: howto/enum.rst:1315 +#: howto/enum.rst:1318 msgid "Using a descriptive string" msgstr "" -#: howto/enum.rst:1317 +#: howto/enum.rst:1320 msgid "Using a string as the value would look like::" msgstr "" -#: howto/enum.rst:1319 +#: howto/enum.rst:1322 msgid "" ">>> class Color(Enum):\n" "... RED = 'stop'\n" @@ -2014,15 +2024,15 @@ msgid "" "" msgstr "" -#: howto/enum.rst:1329 -msgid "Using a custom :meth:`__new__`" +#: howto/enum.rst:1332 +msgid "Using a custom :meth:`~object.__new__`" msgstr "" -#: howto/enum.rst:1331 -msgid "Using an auto-numbering :meth:`__new__` would look like::" +#: howto/enum.rst:1334 +msgid "Using an auto-numbering :meth:`~object.__new__` would look like::" msgstr "" -#: howto/enum.rst:1333 +#: howto/enum.rst:1336 msgid "" ">>> class AutoNumber(Enum):\n" "... def __new__(cls):\n" @@ -2040,13 +2050,13 @@ msgid "" "" msgstr "" -#: howto/enum.rst:1348 +#: howto/enum.rst:1351 msgid "" "To make a more general purpose ``AutoNumber``, add ``*args`` to the " "signature::" msgstr "" -#: howto/enum.rst:1350 +#: howto/enum.rst:1353 msgid "" ">>> class AutoNumber(Enum):\n" "... def __new__(cls, *args): # this is the only change from above\n" @@ -2057,13 +2067,13 @@ msgid "" "..." msgstr "" -#: howto/enum.rst:1358 +#: howto/enum.rst:1361 msgid "" "Then when you inherit from ``AutoNumber`` you can write your own " "``__init__`` to handle any extra arguments::" msgstr "" -#: howto/enum.rst:1361 +#: howto/enum.rst:1364 msgid "" ">>> class Swatch(AutoNumber):\n" "... def __init__(self, pantone='unknown'):\n" @@ -2080,35 +2090,35 @@ msgid "" "'unknown'" msgstr "" -#: howto/enum.rst:1377 +#: howto/enum.rst:1380 msgid "" -"The :meth:`__new__` method, if defined, is used during creation of the Enum " -"members; it is then replaced by Enum's :meth:`__new__` which is used after " -"class creation for lookup of existing members." +"The :meth:`~object.__new__` method, if defined, is used during creation of " +"the Enum members; it is then replaced by Enum's :meth:`~object.__new__` " +"which is used after class creation for lookup of existing members." msgstr "" -#: howto/enum.rst:1383 +#: howto/enum.rst:1386 msgid "" "*Do not* call ``super().__new__()``, as the lookup-only ``__new__`` is the " "one that is found; instead, use the data type directly -- e.g.::" msgstr "" -#: howto/enum.rst:1386 +#: howto/enum.rst:1389 msgid "obj = int.__new__(cls, value)" msgstr "" -#: howto/enum.rst:1390 +#: howto/enum.rst:1393 msgid "OrderedEnum" msgstr "" -#: howto/enum.rst:1392 +#: howto/enum.rst:1395 msgid "" "An ordered enumeration that is not based on :class:`IntEnum` and so " "maintains the normal :class:`Enum` invariants (such as not being comparable " "to other enumerations)::" msgstr "" -#: howto/enum.rst:1396 +#: howto/enum.rst:1399 msgid "" ">>> class OrderedEnum(Enum):\n" "... def __ge__(self, other):\n" @@ -2139,17 +2149,17 @@ msgid "" "True" msgstr "" -#: howto/enum.rst:1426 +#: howto/enum.rst:1429 msgid "DuplicateFreeEnum" msgstr "" -#: howto/enum.rst:1428 +#: howto/enum.rst:1431 msgid "" "Raises an error if a duplicate member value is found instead of creating an " "alias::" msgstr "" -#: howto/enum.rst:1431 +#: howto/enum.rst:1434 msgid "" ">>> class DuplicateFreeEnum(Enum):\n" "... def __init__(self, *args):\n" @@ -2173,24 +2183,24 @@ msgid "" "ValueError: aliases not allowed in DuplicateFreeEnum: 'GRENE' --> 'GREEN'" msgstr "" -#: howto/enum.rst:1453 +#: howto/enum.rst:1456 msgid "" "This is a useful example for subclassing Enum to add or change other " "behaviors as well as disallowing aliases. If the only desired change is " "disallowing aliases, the :func:`unique` decorator can be used instead." msgstr "" -#: howto/enum.rst:1459 +#: howto/enum.rst:1462 msgid "Planet" msgstr "" -#: howto/enum.rst:1461 +#: howto/enum.rst:1464 msgid "" -"If :meth:`__new__` or :meth:`__init__` is defined, the value of the enum " -"member will be passed to those methods::" +"If :meth:`~object.__new__` or :meth:`~object.__init__` is defined, the value " +"of the enum member will be passed to those methods::" msgstr "" -#: howto/enum.rst:1464 +#: howto/enum.rst:1467 msgid "" ">>> class Planet(Enum):\n" "... MERCURY = (3.303e+23, 2.4397e6)\n" @@ -2216,15 +2226,15 @@ msgid "" "9.802652743337129" msgstr "" -#: howto/enum.rst:1490 +#: howto/enum.rst:1493 msgid "TimePeriod" msgstr "" -#: howto/enum.rst:1492 -msgid "An example to show the :attr:`_ignore_` attribute in use::" +#: howto/enum.rst:1495 +msgid "An example to show the :attr:`~Enum._ignore_` attribute in use::" msgstr "" -#: howto/enum.rst:1494 +#: howto/enum.rst:1497 msgid "" ">>> from datetime import timedelta\n" ">>> class Period(timedelta, Enum):\n" @@ -2242,11 +2252,11 @@ msgid "" "timedelta(days=366)>]" msgstr "" -#: howto/enum.rst:1511 +#: howto/enum.rst:1514 msgid "Subclassing EnumType" msgstr "" -#: howto/enum.rst:1513 +#: howto/enum.rst:1516 msgid "" "While most enum needs can be met by customizing :class:`Enum` subclasses, " "either with class decorators or custom functions, :class:`EnumType` can be " diff --git a/howto/functional.po b/howto/functional.po index 99a128153..2ec228fdc 100644 --- a/howto/functional.po +++ b/howto/functional.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00: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/functional.rst:3 +#: howto/functional.rst:5 msgid "Functional Programming HOWTO" msgstr "" @@ -24,7 +24,7 @@ msgstr "" msgid "Author" msgstr "" -#: howto/functional.rst:5 +#: howto/functional.rst:7 msgid "A. M. Kuchling" msgstr "" @@ -32,11 +32,11 @@ msgstr "" msgid "Release" msgstr "" -#: howto/functional.rst:6 +#: howto/functional.rst:8 msgid "0.32" msgstr "" -#: howto/functional.rst:8 +#: howto/functional.rst:10 msgid "" "In this document, we'll take a tour of Python's features suitable for " "implementing programs in a functional style. After an introduction to the " @@ -45,30 +45,30 @@ msgid "" "such as :mod:`itertools` and :mod:`functools`." msgstr "" -#: howto/functional.rst:16 +#: howto/functional.rst:18 msgid "Introduction" msgstr "" -#: howto/functional.rst:18 +#: howto/functional.rst:20 msgid "" "This section explains the basic concept of functional programming; if you're " "just interested in learning about Python language features, skip to the next " "section on :ref:`functional-howto-iterators`." msgstr "" -#: howto/functional.rst:22 +#: howto/functional.rst:24 msgid "" "Programming languages support decomposing problems in several different ways:" msgstr "" -#: howto/functional.rst:24 +#: howto/functional.rst:26 msgid "" "Most programming languages are **procedural**: programs are lists of " "instructions that tell the computer what to do with the program's input. C, " "Pascal, and even Unix shells are procedural languages." msgstr "" -#: howto/functional.rst:28 +#: howto/functional.rst:30 msgid "" "In **declarative** languages, you write a specification that describes the " "problem to be solved, and the language implementation figures out how to " @@ -78,7 +78,7 @@ msgid "" "indexes, which subclauses should be performed first, etc." msgstr "" -#: howto/functional.rst:35 +#: howto/functional.rst:37 msgid "" "**Object-oriented** programs manipulate collections of objects. Objects " "have internal state and support methods that query or modify this internal " @@ -87,7 +87,7 @@ msgid "" "force the use of object-oriented features." msgstr "" -#: howto/functional.rst:41 +#: howto/functional.rst:43 msgid "" "**Functional** programming decomposes a problem into a set of functions. " "Ideally, functions only take inputs and produce outputs, and don't have any " @@ -96,7 +96,7 @@ msgid "" "other variants) and Haskell." msgstr "" -#: howto/functional.rst:47 +#: howto/functional.rst:49 msgid "" "The designers of some computer languages choose to emphasize one particular " "approach to programming. This often makes it difficult to write programs " @@ -109,7 +109,7 @@ msgid "" "functional, for example." msgstr "" -#: howto/functional.rst:58 +#: howto/functional.rst:60 msgid "" "In a functional program, input flows through a set of functions. Each " "function operates on its input and produces some output. Functional style " @@ -120,7 +120,7 @@ msgid "" "runs; every function's output must only depend on its input." msgstr "" -#: howto/functional.rst:66 +#: howto/functional.rst:68 msgid "" "Some languages are very strict about purity and don't even have assignment " "statements such as ``a=3`` or ``c = a + b``, but it's difficult to avoid all " @@ -131,7 +131,7 @@ msgid "" "for a second." msgstr "" -#: howto/functional.rst:73 +#: howto/functional.rst:75 msgid "" "Python programs written in functional style usually won't go to the extreme " "of avoiding all I/O or all assignments; instead, they'll provide a " @@ -141,7 +141,7 @@ msgid "" "other side effects." msgstr "" -#: howto/functional.rst:79 +#: howto/functional.rst:81 msgid "" "Functional programming can be considered the opposite of object-oriented " "programming. Objects are little capsules containing some internal state " @@ -153,40 +153,40 @@ msgid "" "objects in your application (e-mail messages, transactions, etc.)." msgstr "" -#: howto/functional.rst:88 +#: howto/functional.rst:90 msgid "" "Functional design may seem like an odd constraint to work under. Why should " "you avoid objects and side effects? There are theoretical and practical " "advantages to the functional style:" msgstr "" -#: howto/functional.rst:92 +#: howto/functional.rst:94 msgid "Formal provability." msgstr "" -#: howto/functional.rst:93 +#: howto/functional.rst:95 msgid "Modularity." msgstr "" -#: howto/functional.rst:94 +#: howto/functional.rst:96 msgid "Composability." msgstr "" -#: howto/functional.rst:95 +#: howto/functional.rst:97 msgid "Ease of debugging and testing." msgstr "" -#: howto/functional.rst:99 +#: howto/functional.rst:101 msgid "Formal provability" msgstr "" -#: howto/functional.rst:101 +#: howto/functional.rst:103 msgid "" "A theoretical benefit is that it's easier to construct a mathematical proof " "that a functional program is correct." msgstr "" -#: howto/functional.rst:104 +#: howto/functional.rst:106 msgid "" "For a long time researchers have been interested in finding ways to " "mathematically prove programs correct. This is different from testing a " @@ -196,7 +196,7 @@ msgid "" "the right result for all possible inputs." msgstr "" -#: howto/functional.rst:111 +#: howto/functional.rst:113 msgid "" "The technique used to prove programs correct is to write down " "**invariants**, properties of the input data and of the program's variables " @@ -207,7 +207,7 @@ msgid "" "invariants should match the desired conditions on the program's output." msgstr "" -#: howto/functional.rst:119 +#: howto/functional.rst:121 msgid "" "Functional programming's avoidance of assignments arose because assignments " "are difficult to handle with this technique; assignments can break " @@ -215,7 +215,7 @@ msgid "" "invariants that can be propagated onward." msgstr "" -#: howto/functional.rst:124 +#: howto/functional.rst:126 msgid "" "Unfortunately, proving programs correct is largely impractical and not " "relevant to Python software. Even trivial programs require proofs that are " @@ -227,11 +227,11 @@ msgid "" "wrongly believe you've proved the program correct." msgstr "" -#: howto/functional.rst:135 +#: howto/functional.rst:137 msgid "Modularity" msgstr "" -#: howto/functional.rst:137 +#: howto/functional.rst:139 msgid "" "A more practical benefit of functional programming is that it forces you to " "break apart your problem into small pieces. Programs are more modular as a " @@ -240,15 +240,15 @@ msgid "" "Small functions are also easier to read and to check for errors." msgstr "" -#: howto/functional.rst:145 +#: howto/functional.rst:147 msgid "Ease of debugging and testing" msgstr "" -#: howto/functional.rst:147 +#: howto/functional.rst:149 msgid "Testing and debugging a functional-style program is easier." msgstr "" -#: howto/functional.rst:149 +#: howto/functional.rst:151 msgid "" "Debugging is simplified because functions are generally small and clearly " "specified. When a program doesn't work, each function is an interface point " @@ -257,7 +257,7 @@ msgid "" "responsible for a bug." msgstr "" -#: howto/functional.rst:154 +#: howto/functional.rst:156 msgid "" "Testing is easier because each function is a potential subject for a unit " "test. Functions don't depend on system state that needs to be replicated " @@ -265,11 +265,11 @@ msgid "" "and then check that the output matches expectations." msgstr "" -#: howto/functional.rst:161 +#: howto/functional.rst:163 msgid "Composability" msgstr "" -#: howto/functional.rst:163 +#: howto/functional.rst:165 msgid "" "As you work on a functional-style program, you'll write a number of " "functions with varying inputs and outputs. Some of these functions will be " @@ -280,24 +280,24 @@ msgid "" "different situations." msgstr "" -#: howto/functional.rst:170 +#: howto/functional.rst:172 msgid "" "Over time you'll form a personal library of utilities. Often you'll " "assemble new programs by arranging existing functions in a new configuration " "and writing a few functions specialized for the current task." msgstr "" -#: howto/functional.rst:178 +#: howto/functional.rst:180 msgid "Iterators" msgstr "" -#: howto/functional.rst:180 +#: howto/functional.rst:182 msgid "" "I'll start by looking at a Python language feature that's an important " "foundation for writing functional-style programs: iterators." msgstr "" -#: howto/functional.rst:183 +#: howto/functional.rst:185 msgid "" "An iterator is an object representing a stream of data; this object returns " "the data one element at a time. A Python iterator must support a method " @@ -308,7 +308,7 @@ msgid "" "reasonable to write an iterator that produces an infinite stream of data." msgstr "" -#: howto/functional.rst:191 +#: howto/functional.rst:193 msgid "" "The built-in :func:`iter` function takes an arbitrary object and tries to " "return an iterator that will return the object's contents or elements, " @@ -318,11 +318,11 @@ msgid "" "an iterator for it." msgstr "" -#: howto/functional.rst:198 +#: howto/functional.rst:200 msgid "You can experiment with the iteration interface manually:" msgstr "" -#: howto/functional.rst:216 +#: howto/functional.rst:218 msgid "" "Python expects iterable objects in several different contexts, the most " "important being the :keyword:`for` statement. In the statement ``for X in " @@ -330,7 +330,7 @@ msgid "" "an iterator. These two statements are equivalent::" msgstr "" -#: howto/functional.rst:222 +#: howto/functional.rst:224 msgid "" "for i in iter(obj):\n" " print(i)\n" @@ -339,19 +339,19 @@ msgid "" " print(i)" msgstr "" -#: howto/functional.rst:228 +#: howto/functional.rst:230 msgid "" "Iterators can be materialized as lists or tuples by using the :func:`list` " "or :func:`tuple` constructor functions:" msgstr "" -#: howto/functional.rst:237 +#: howto/functional.rst:239 msgid "" "Sequence unpacking also supports iterators: if you know an iterator will " "return N elements, you can unpack them into an N-tuple:" msgstr "" -#: howto/functional.rst:246 +#: howto/functional.rst:248 msgid "" "Built-in functions such as :func:`max` and :func:`min` can take a single " "iterator argument and will return the largest or smallest element. The " @@ -362,7 +362,7 @@ msgid "" "stream, the ``\"in\"`` and ``\"not in\"`` operators won't return either." msgstr "" -#: howto/functional.rst:254 +#: howto/functional.rst:256 msgid "" "Note that you can only go forward in an iterator; there's no way to get the " "previous element, reset the iterator, or make a copy of it. Iterator " @@ -373,24 +373,24 @@ msgid "" "new iterator." msgstr "" -#: howto/functional.rst:264 +#: howto/functional.rst:266 msgid "Data Types That Support Iterators" msgstr "" -#: howto/functional.rst:266 +#: howto/functional.rst:268 msgid "" "We've already seen how lists and tuples support iterators. In fact, any " "Python sequence type, such as strings, will automatically support creation " "of an iterator." msgstr "" -#: howto/functional.rst:270 +#: howto/functional.rst:272 msgid "" "Calling :func:`iter` on a dictionary returns an iterator that will loop over " "the dictionary's keys::" msgstr "" -#: howto/functional.rst:273 +#: howto/functional.rst:275 msgid "" ">>> m = {'Jan': 1, 'Feb': 2, 'Mar': 3, 'Apr': 4, 'May': 5, 'Jun': 6,\n" "... 'Jul': 7, 'Aug': 8, 'Sep': 9, 'Oct': 10, 'Nov': 11, 'Dec': 12}\n" @@ -410,14 +410,14 @@ msgid "" "Dec 12" msgstr "" -#: howto/functional.rst:290 +#: howto/functional.rst:292 msgid "" "Note that starting with Python 3.7, dictionary iteration order is guaranteed " "to be the same as the insertion order. In earlier versions, the behaviour " "was unspecified and could vary between implementations." msgstr "" -#: howto/functional.rst:294 +#: howto/functional.rst:296 msgid "" "Applying :func:`iter` to a dictionary always loops over the keys, but " "dictionaries have methods that return other iterators. If you want to " @@ -425,33 +425,33 @@ msgid "" "`~dict.values` or :meth:`~dict.items` methods to get an appropriate iterator." msgstr "" -#: howto/functional.rst:300 +#: howto/functional.rst:302 msgid "" "The :func:`dict` constructor can accept an iterator that returns a finite " "stream of ``(key, value)`` tuples:" msgstr "" -#: howto/functional.rst:307 +#: howto/functional.rst:309 msgid "" "Files also support iteration by calling the :meth:`~io.TextIOBase.readline` " "method until there are no more lines in the file. This means you can read " "each line of a file like this::" msgstr "" -#: howto/functional.rst:311 +#: howto/functional.rst:313 msgid "" "for line in file:\n" " # do something for each line\n" " ..." msgstr "" -#: howto/functional.rst:315 +#: howto/functional.rst:317 msgid "" "Sets can take their contents from an iterable and let you iterate over the " "set's elements::" msgstr "" -#: howto/functional.rst:318 +#: howto/functional.rst:320 msgid "" ">>> S = {2, 3, 5, 7, 11, 13}\n" ">>> for i in S:\n" @@ -464,11 +464,11 @@ msgid "" "13" msgstr "" -#: howto/functional.rst:331 +#: howto/functional.rst:333 msgid "Generator expressions and list comprehensions" msgstr "" -#: howto/functional.rst:333 +#: howto/functional.rst:335 msgid "" "Two common operations on an iterator's output are 1) performing some " "operation for every element, 2) selecting a subset of elements that meet " @@ -477,7 +477,7 @@ msgid "" "containing a given substring." msgstr "" -#: howto/functional.rst:339 +#: howto/functional.rst:341 msgid "" "List comprehensions and generator expressions (short form: \"listcomps\" and " "\"genexps\") are a concise notation for such operations, borrowed from the " @@ -485,7 +485,7 @@ msgid "" "strip all the whitespace from a stream of strings with the following code::" msgstr "" -#: howto/functional.rst:344 +#: howto/functional.rst:346 msgid "" ">>> line_list = [' line 1\\n', 'line 2 \\n', ' \\n', '']\n" "\n" @@ -496,18 +496,18 @@ msgid "" ">>> stripped_list = [line.strip() for line in line_list]" msgstr "" -#: howto/functional.rst:352 +#: howto/functional.rst:354 msgid "" "You can select only certain elements by adding an ``\"if\"`` condition::" msgstr "" -#: howto/functional.rst:354 +#: howto/functional.rst:356 msgid "" ">>> stripped_list = [line.strip() for line in line_list\n" "... if line != \"\"]" msgstr "" -#: howto/functional.rst:357 +#: howto/functional.rst:359 msgid "" "With a list comprehension, you get back a Python list; ``stripped_list`` is " "a list containing the resulting lines, not an iterator. Generator " @@ -518,14 +518,14 @@ msgid "" "preferable in these situations." msgstr "" -#: howto/functional.rst:364 +#: howto/functional.rst:366 msgid "" "Generator expressions are surrounded by parentheses (\"()\") and list " "comprehensions are surrounded by square brackets (\"[]\"). Generator " "expressions have the form::" msgstr "" -#: howto/functional.rst:368 +#: howto/functional.rst:370 msgid "" "( expression for expr in sequence1\n" " if condition1\n" @@ -538,13 +538,13 @@ msgid "" " if conditionN )" msgstr "" -#: howto/functional.rst:378 +#: howto/functional.rst:380 msgid "" "Again, for a list comprehension only the outside brackets are different " "(square brackets instead of parentheses)." msgstr "" -#: howto/functional.rst:381 +#: howto/functional.rst:383 msgid "" "The elements of the generated output will be the successive values of " "``expression``. The ``if`` clauses are all optional; if present, " @@ -552,18 +552,18 @@ msgid "" "is true." msgstr "" -#: howto/functional.rst:385 +#: howto/functional.rst:387 msgid "" "Generator expressions always have to be written inside parentheses, but the " "parentheses signalling a function call also count. If you want to create an " "iterator that will be immediately passed to a function you can write::" msgstr "" -#: howto/functional.rst:389 +#: howto/functional.rst:391 msgid "obj_total = sum(obj.count for obj in list_all_objects())" msgstr "" -#: howto/functional.rst:391 +#: howto/functional.rst:393 msgid "" "The ``for...in`` clauses contain the sequences to be iterated over. The " "sequences do not have to be the same length, because they are iterated over " @@ -573,13 +573,13 @@ msgid "" "``sequence2``." msgstr "" -#: howto/functional.rst:397 +#: howto/functional.rst:399 msgid "" "To put it another way, a list comprehension or generator expression is " "equivalent to the following Python code::" msgstr "" -#: howto/functional.rst:400 +#: howto/functional.rst:402 msgid "" "for expr1 in sequence1:\n" " if not (condition1):\n" @@ -596,7 +596,7 @@ msgid "" " # the expression." msgstr "" -#: howto/functional.rst:414 +#: howto/functional.rst:416 msgid "" "This means that when there are multiple ``for...in`` clauses but no ``if`` " "clauses, the length of the resulting output will be equal to the product of " @@ -604,14 +604,14 @@ msgid "" "output list is 9 elements long:" msgstr "" -#: howto/functional.rst:426 +#: howto/functional.rst:428 msgid "" "To avoid introducing an ambiguity into Python's grammar, if ``expression`` " "is creating a tuple, it must be surrounded with parentheses. The first list " "comprehension below is a syntax error, while the second one is correct::" msgstr "" -#: howto/functional.rst:430 +#: howto/functional.rst:432 msgid "" "# Syntax error\n" "[x, y for x in seq1 for y in seq2]\n" @@ -619,18 +619,18 @@ msgid "" "[(x, y) for x in seq1 for y in seq2]" msgstr "" -#: howto/functional.rst:437 +#: howto/functional.rst:439 msgid "Generators" msgstr "" -#: howto/functional.rst:439 +#: howto/functional.rst:441 msgid "" "Generators are a special class of functions that simplify the task of " "writing iterators. Regular functions compute a value and return it, but " "generators return an iterator that returns a stream of values." msgstr "" -#: howto/functional.rst:443 +#: howto/functional.rst:445 msgid "" "You're doubtless familiar with how regular function calls work in Python or " "C. When you call a function, it gets a private namespace where its local " @@ -643,18 +643,18 @@ msgid "" "thought of as resumable functions." msgstr "" -#: howto/functional.rst:452 +#: howto/functional.rst:454 msgid "Here's the simplest example of a generator function:" msgstr "" -#: howto/functional.rst:458 +#: howto/functional.rst:460 msgid "" "Any function containing a :keyword:`yield` keyword is a generator function; " "this is detected by Python's :term:`bytecode` compiler which compiles the " "function specially as a result." msgstr "" -#: howto/functional.rst:462 +#: howto/functional.rst:464 msgid "" "When you call a generator function, it doesn't return a single value; " "instead it returns a generator object that supports the iterator protocol. " @@ -666,17 +666,17 @@ msgid "" "method, the function will resume executing." msgstr "" -#: howto/functional.rst:471 +#: howto/functional.rst:473 msgid "Here's a sample usage of the ``generate_ints()`` generator:" msgstr "" -#: howto/functional.rst:488 +#: howto/functional.rst:490 msgid "" "You could equally write ``for i in generate_ints(5)``, or ``a, b, c = " "generate_ints(3)``." msgstr "" -#: howto/functional.rst:491 +#: howto/functional.rst:493 msgid "" "Inside a generator function, ``return value`` causes " "``StopIteration(value)`` to be raised from the :meth:`~generator.__next__` " @@ -684,7 +684,7 @@ msgid "" "procession of values ends and the generator cannot yield any further values." msgstr "" -#: howto/functional.rst:496 +#: howto/functional.rst:498 msgid "" "You could achieve the effect of generators manually by writing your own " "class and storing all the local variables of the generator as instance " @@ -694,7 +694,7 @@ msgid "" "complicated generator, writing a corresponding class can be much messier." msgstr "" -#: howto/functional.rst:504 +#: howto/functional.rst:506 msgid "" "The test suite included with Python's library, :source:`Lib/test/" "test_generators.py`, contains a number of more interesting examples. Here's " @@ -702,7 +702,7 @@ msgid "" "generators recursively. ::" msgstr "" -#: howto/functional.rst:509 +#: howto/functional.rst:511 msgid "" "# A recursive generator that generates Tree leaves in in-order.\n" "def inorder(t):\n" @@ -716,7 +716,7 @@ msgid "" " yield x" msgstr "" -#: howto/functional.rst:520 +#: howto/functional.rst:522 msgid "" "Two other examples in ``test_generators.py`` produce solutions for the N-" "Queens problem (placing N queens on an NxN chess board so that no queen " @@ -725,11 +725,11 @@ msgid "" "twice)." msgstr "" -#: howto/functional.rst:528 +#: howto/functional.rst:530 msgid "Passing values into a generator" msgstr "" -#: howto/functional.rst:530 +#: howto/functional.rst:532 msgid "" "In Python 2.4 and earlier, generators only produced output. Once a " "generator's code was invoked to create an iterator, there was no way to pass " @@ -739,18 +739,18 @@ msgid "" "these approaches are messy." msgstr "" -#: howto/functional.rst:537 +#: howto/functional.rst:539 msgid "" "In Python 2.5 there's a simple way to pass values into a generator. :keyword:" "`yield` became an expression, returning a value that can be assigned to a " "variable or otherwise operated on::" msgstr "" -#: howto/functional.rst:541 +#: howto/functional.rst:543 msgid "val = (yield i)" msgstr "" -#: howto/functional.rst:543 +#: howto/functional.rst:545 msgid "" "I recommend that you **always** put parentheses around a ``yield`` " "expression when you're doing something with the returned value, as in the " @@ -758,7 +758,7 @@ msgid "" "always add them instead of having to remember when they're needed." msgstr "" -#: howto/functional.rst:548 +#: howto/functional.rst:550 msgid "" "(:pep:`342` explains the exact rules, which are that a ``yield``-expression " "must always be parenthesized except when it occurs at the top-level " @@ -767,7 +767,7 @@ msgid "" "operation, as in ``val = (yield i) + 12``.)" msgstr "" -#: howto/functional.rst:554 +#: howto/functional.rst:556 msgid "" "Values are sent into a generator by calling its :meth:`send(value) " "` method. This method resumes the generator's code and the " @@ -775,13 +775,13 @@ msgid "" "`~generator.__next__` method is called, the ``yield`` returns ``None``." msgstr "" -#: howto/functional.rst:559 +#: howto/functional.rst:561 msgid "" "Here's a simple counter that increments by 1 and allows changing the value " "of the internal counter." msgstr "" -#: howto/functional.rst:562 +#: howto/functional.rst:564 msgid "" "def counter(maximum):\n" " i = 0\n" @@ -794,11 +794,11 @@ msgid "" " i += 1" msgstr "" -#: howto/functional.rst:574 +#: howto/functional.rst:576 msgid "And here's an example of changing the counter:" msgstr "" -#: howto/functional.rst:591 +#: howto/functional.rst:593 msgid "" "Because ``yield`` will often be returning ``None``, you should always check " "for this case. Don't just use its value in expressions unless you're sure " @@ -806,20 +806,20 @@ msgid "" "resume your generator function." msgstr "" -#: howto/functional.rst:596 +#: howto/functional.rst:598 msgid "" "In addition to :meth:`~generator.send`, there are two other methods on " "generators:" msgstr "" -#: howto/functional.rst:599 +#: howto/functional.rst:601 msgid "" ":meth:`throw(value) ` is used to raise an exception inside " "the generator; the exception is raised by the ``yield`` expression where the " "generator's execution is paused." msgstr "" -#: howto/functional.rst:603 +#: howto/functional.rst:605 msgid "" ":meth:`~generator.close` raises a :exc:`GeneratorExit` exception inside the " "generator to terminate the iteration. On receiving this exception, the " @@ -830,20 +830,20 @@ msgid "" "collected." msgstr "" -#: howto/functional.rst:611 +#: howto/functional.rst:613 msgid "" "If you need to run cleanup code when a :exc:`GeneratorExit` occurs, I " "suggest using a ``try: ... finally:`` suite instead of catching :exc:" "`GeneratorExit`." msgstr "" -#: howto/functional.rst:614 +#: howto/functional.rst:616 msgid "" "The cumulative effect of these changes is to turn generators from one-way " "producers of information into both producers and consumers." msgstr "" -#: howto/functional.rst:617 +#: howto/functional.rst:619 msgid "" "Generators also become **coroutines**, a more generalized form of " "subroutines. Subroutines are entered at one point and exited at another " @@ -852,36 +852,36 @@ msgid "" "statements)." msgstr "" -#: howto/functional.rst:624 +#: howto/functional.rst:626 msgid "Built-in functions" msgstr "" -#: howto/functional.rst:626 +#: howto/functional.rst:628 msgid "" "Let's look in more detail at built-in functions often used with iterators." msgstr "" -#: howto/functional.rst:628 +#: howto/functional.rst:630 msgid "" "Two of Python's built-in functions, :func:`map` and :func:`filter` duplicate " "the features of generator expressions:" msgstr "" -#: howto/functional.rst:631 +#: howto/functional.rst:633 msgid "" ":func:`map(f, iterA, iterB, ...) ` returns an iterator over the sequence" msgstr "" -#: howto/functional.rst:632 +#: howto/functional.rst:634 msgid "" "``f(iterA[0], iterB[0]), f(iterA[1], iterB[1]), f(iterA[2], iterB[2]), ...``." msgstr "" -#: howto/functional.rst:642 +#: howto/functional.rst:644 msgid "You can of course achieve the same effect with a list comprehension." msgstr "" -#: howto/functional.rst:644 +#: howto/functional.rst:646 msgid "" ":func:`filter(predicate, iter) ` returns an iterator over all the " "sequence elements that meet a certain condition, and is similarly duplicated " @@ -890,18 +890,18 @@ msgid "" "must take a single value." msgstr "" -#: howto/functional.rst:657 +#: howto/functional.rst:659 msgid "This can also be written as a list comprehension:" msgstr "" -#: howto/functional.rst:663 +#: howto/functional.rst:665 msgid "" ":func:`enumerate(iter, start=0) ` counts off the elements in the " "iterable returning 2-tuples containing the count (from *start*) and each " "element. ::" msgstr "" -#: howto/functional.rst:667 +#: howto/functional.rst:669 msgid "" ">>> for item in enumerate(['subject', 'verb', 'object']):\n" "... print(item)\n" @@ -910,13 +910,13 @@ msgid "" "(2, 'object')" msgstr "" -#: howto/functional.rst:673 +#: howto/functional.rst:675 msgid "" ":func:`enumerate` is often used when looping through a list and recording " "the indexes at which certain conditions are met::" msgstr "" -#: howto/functional.rst:676 +#: howto/functional.rst:678 msgid "" "f = open('data.txt', 'r')\n" "for i, line in enumerate(f):\n" @@ -924,7 +924,7 @@ msgid "" " print('Blank line at line #%i' % i)" msgstr "" -#: howto/functional.rst:681 +#: howto/functional.rst:683 msgid "" ":func:`sorted(iterable, key=None, reverse=False) ` collects all the " "elements of the iterable into a list, sorts the list, and returns the sorted " @@ -932,7 +932,7 @@ msgid "" "constructed list's :meth:`~list.sort` method. ::" msgstr "" -#: howto/functional.rst:686 +#: howto/functional.rst:688 msgid "" ">>> import random\n" ">>> # Generate 8 random numbers between [0, 10000)\n" @@ -945,12 +945,12 @@ msgid "" "[9878, 9828, 8442, 7953, 6431, 6213, 2207, 769]" msgstr "" -#: howto/functional.rst:696 +#: howto/functional.rst:698 msgid "" "(For a more detailed discussion of sorting, see the :ref:`sortinghowto`.)" msgstr "" -#: howto/functional.rst:699 +#: howto/functional.rst:701 msgid "" "The :func:`any(iter) ` and :func:`all(iter) ` built-ins look at " "the truth values of an iterable's contents. :func:`any` returns ``True`` if " @@ -958,19 +958,19 @@ msgid "" "``True`` if all of the elements are true values:" msgstr "" -#: howto/functional.rst:718 +#: howto/functional.rst:720 msgid "" ":func:`zip(iterA, iterB, ...) ` takes one element from each iterable " "and returns them in a tuple::" msgstr "" -#: howto/functional.rst:721 +#: howto/functional.rst:723 msgid "" "zip(['a', 'b', 'c'], (1, 2, 3)) =>\n" " ('a', 1), ('b', 2), ('c', 3)" msgstr "" -#: howto/functional.rst:724 +#: howto/functional.rst:726 msgid "" "It doesn't construct an in-memory list and exhaust all the input iterators " "before returning; instead tuples are constructed and returned only if " @@ -978,62 +978,62 @@ msgid "" "evaluation `__.)" msgstr "" -#: howto/functional.rst:729 +#: howto/functional.rst:731 msgid "" "This iterator is intended to be used with iterables that are all of the same " "length. If the iterables are of different lengths, the resulting stream " "will be the same length as the shortest iterable. ::" msgstr "" -#: howto/functional.rst:733 +#: howto/functional.rst:735 msgid "" "zip(['a', 'b'], (1, 2, 3)) =>\n" " ('a', 1), ('b', 2)" msgstr "" -#: howto/functional.rst:736 +#: howto/functional.rst:738 msgid "" "You should avoid doing this, though, because an element may be taken from " "the longer iterators and discarded. This means you can't go on to use the " "iterators further because you risk skipping a discarded element." msgstr "" -#: howto/functional.rst:742 +#: howto/functional.rst:744 msgid "The itertools module" msgstr "" -#: howto/functional.rst:744 +#: howto/functional.rst:746 msgid "" "The :mod:`itertools` module contains a number of commonly used iterators as " "well as functions for combining several iterators. This section will " "introduce the module's contents by showing small examples." msgstr "" -#: howto/functional.rst:748 +#: howto/functional.rst:750 msgid "The module's functions fall into a few broad classes:" msgstr "" -#: howto/functional.rst:750 +#: howto/functional.rst:752 msgid "Functions that create a new iterator based on an existing iterator." msgstr "" -#: howto/functional.rst:751 +#: howto/functional.rst:753 msgid "Functions for treating an iterator's elements as function arguments." msgstr "" -#: howto/functional.rst:752 +#: howto/functional.rst:754 msgid "Functions for selecting portions of an iterator's output." msgstr "" -#: howto/functional.rst:753 +#: howto/functional.rst:755 msgid "A function for grouping an iterator's output." msgstr "" -#: howto/functional.rst:756 +#: howto/functional.rst:758 msgid "Creating new iterators" msgstr "" -#: howto/functional.rst:758 +#: howto/functional.rst:760 msgid "" ":func:`itertools.count(start, step) ` returns an infinite " "stream of evenly spaced values. You can optionally supply the starting " @@ -1041,7 +1041,7 @@ msgid "" "defaults to 1::" msgstr "" -#: howto/functional.rst:762 +#: howto/functional.rst:764 msgid "" "itertools.count() =>\n" " 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, ...\n" @@ -1051,7 +1051,7 @@ msgid "" " 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, ..." msgstr "" -#: howto/functional.rst:769 +#: howto/functional.rst:771 msgid "" ":func:`itertools.cycle(iter) ` saves a copy of the contents " "of a provided iterable and returns a new iterator that returns its elements " @@ -1059,20 +1059,20 @@ msgid "" "infinitely. ::" msgstr "" -#: howto/functional.rst:773 +#: howto/functional.rst:775 msgid "" "itertools.cycle([1, 2, 3, 4, 5]) =>\n" " 1, 2, 3, 4, 5, 1, 2, 3, 4, 5, ..." msgstr "" -#: howto/functional.rst:776 +#: howto/functional.rst:778 msgid "" ":func:`itertools.repeat(elem, [n]) ` returns the provided " "element *n* times, or returns the element endlessly if *n* is not " "provided. ::" msgstr "" -#: howto/functional.rst:779 +#: howto/functional.rst:781 msgid "" "itertools.repeat('abc') =>\n" " abc, abc, abc, abc, abc, abc, abc, abc, abc, abc, ...\n" @@ -1080,7 +1080,7 @@ msgid "" " abc, abc, abc, abc, abc" msgstr "" -#: howto/functional.rst:784 +#: howto/functional.rst:786 msgid "" ":func:`itertools.chain(iterA, iterB, ...) ` takes an " "arbitrary number of iterables as input, and returns all the elements of the " @@ -1088,13 +1088,13 @@ msgid "" "the iterables have been exhausted. ::" msgstr "" -#: howto/functional.rst:789 +#: howto/functional.rst:791 msgid "" "itertools.chain(['a', 'b', 'c'], (1, 2, 3)) =>\n" " a, b, c, 1, 2, 3" msgstr "" -#: howto/functional.rst:792 +#: howto/functional.rst:794 msgid "" ":func:`itertools.islice(iter, [start], stop, [step]) ` " "returns a stream that's a slice of the iterator. With a single *stop* " @@ -1105,7 +1105,7 @@ msgid "" "*step*. ::" msgstr "" -#: howto/functional.rst:799 +#: howto/functional.rst:801 msgid "" "itertools.islice(range(10), 8) =>\n" " 0, 1, 2, 3, 4, 5, 6, 7\n" @@ -1115,7 +1115,7 @@ msgid "" " 2, 4, 6" msgstr "" -#: howto/functional.rst:806 +#: howto/functional.rst:808 msgid "" ":func:`itertools.tee(iter, [n]) ` replicates an iterator; it " "returns *n* independent iterators that will all return the contents of the " @@ -1125,7 +1125,7 @@ msgid "" "and one of the new iterators is consumed more than the others. ::" msgstr "" -#: howto/functional.rst:814 +#: howto/functional.rst:816 msgid "" "itertools.tee( itertools.count() ) =>\n" " iterA, iterB\n" @@ -1137,11 +1137,11 @@ msgid "" " 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, ..." msgstr "" -#: howto/functional.rst:825 +#: howto/functional.rst:827 msgid "Calling functions on elements" msgstr "" -#: howto/functional.rst:827 +#: howto/functional.rst:829 msgid "" "The :mod:`operator` module contains a set of functions corresponding to " "Python's operators. Some examples are :func:`operator.add(a, b) ` assumes that the " "iterable will return a stream of tuples, and calls *func* using these tuples " "as the arguments::" msgstr "" -#: howto/functional.rst:837 +#: howto/functional.rst:839 msgid "" "itertools.starmap(os.path.join,\n" " [('/bin', 'python'), ('/usr', 'bin', 'java'),\n" @@ -1166,37 +1166,37 @@ msgid "" " /bin/python, /usr/bin/java, /usr/bin/perl, /usr/bin/ruby" msgstr "" -#: howto/functional.rst:845 +#: howto/functional.rst:847 msgid "Selecting elements" msgstr "" -#: howto/functional.rst:847 +#: howto/functional.rst:849 msgid "" "Another group of functions chooses a subset of an iterator's elements based " "on a predicate." msgstr "" -#: howto/functional.rst:850 +#: howto/functional.rst:852 msgid "" ":func:`itertools.filterfalse(predicate, iter) ` is " "the opposite of :func:`filter`, returning all elements for which the " "predicate returns false::" msgstr "" -#: howto/functional.rst:854 +#: howto/functional.rst:856 msgid "" "itertools.filterfalse(is_even, itertools.count()) =>\n" " 1, 3, 5, 7, 9, 11, 13, 15, ..." msgstr "" -#: howto/functional.rst:857 +#: howto/functional.rst:859 msgid "" ":func:`itertools.takewhile(predicate, iter) ` returns " "elements for as long as the predicate returns true. Once the predicate " "returns false, the iterator will signal the end of its results. ::" msgstr "" -#: howto/functional.rst:861 +#: howto/functional.rst:863 msgid "" "def less_than_10(x):\n" " return x < 10\n" @@ -1208,14 +1208,14 @@ msgid "" " 0" msgstr "" -#: howto/functional.rst:870 +#: howto/functional.rst:872 msgid "" ":func:`itertools.dropwhile(predicate, iter) ` discards " "elements while the predicate returns true, and then returns the rest of the " "iterable's results. ::" msgstr "" -#: howto/functional.rst:874 +#: howto/functional.rst:876 msgid "" "itertools.dropwhile(less_than_10, itertools.count()) =>\n" " 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, ...\n" @@ -1224,7 +1224,7 @@ msgid "" " 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, ..." msgstr "" -#: howto/functional.rst:880 +#: howto/functional.rst:882 msgid "" ":func:`itertools.compress(data, selectors) ` takes two " "iterators and returns only those elements of *data* for which the " @@ -1232,24 +1232,24 @@ msgid "" "is exhausted::" msgstr "" -#: howto/functional.rst:884 +#: howto/functional.rst:886 msgid "" "itertools.compress([1, 2, 3, 4, 5], [True, True, False, False, True]) =>\n" " 1, 2, 5" msgstr "" -#: howto/functional.rst:889 +#: howto/functional.rst:891 msgid "Combinatoric functions" msgstr "" -#: howto/functional.rst:891 +#: howto/functional.rst:893 msgid "" "The :func:`itertools.combinations(iterable, r) ` " "returns an iterator giving all possible *r*-tuple combinations of the " "elements contained in *iterable*. ::" msgstr "" -#: howto/functional.rst:895 +#: howto/functional.rst:897 msgid "" "itertools.combinations([1, 2, 3, 4, 5], 2) =>\n" " (1, 2), (1, 3), (1, 4), (1, 5),\n" @@ -1263,7 +1263,7 @@ msgid "" " (3, 4, 5)" msgstr "" -#: howto/functional.rst:906 +#: howto/functional.rst:908 msgid "" "The elements within each tuple remain in the same order as *iterable* " "returned them. For example, the number 1 is always before 2, 3, 4, or 5 in " @@ -1272,7 +1272,7 @@ msgid "" "constraint on the order, returning all possible arrangements of length *r*::" msgstr "" -#: howto/functional.rst:913 +#: howto/functional.rst:915 msgid "" "itertools.permutations([1, 2, 3, 4, 5], 2) =>\n" " (1, 2), (1, 3), (1, 4), (1, 5),\n" @@ -1287,32 +1287,32 @@ msgid "" " (5, 4, 3, 2, 1)" msgstr "" -#: howto/functional.rst:925 +#: howto/functional.rst:927 msgid "" "If you don't supply a value for *r* the length of the iterable is used, " "meaning that all the elements are permuted." msgstr "" -#: howto/functional.rst:928 +#: howto/functional.rst:930 msgid "" "Note that these functions produce all of the possible combinations by " "position and don't require that the contents of *iterable* are unique::" msgstr "" -#: howto/functional.rst:931 +#: howto/functional.rst:933 msgid "" "itertools.permutations('aba', 3) =>\n" " ('a', 'b', 'a'), ('a', 'a', 'b'), ('b', 'a', 'a'),\n" " ('b', 'a', 'a'), ('a', 'a', 'b'), ('a', 'b', 'a')" msgstr "" -#: howto/functional.rst:935 +#: howto/functional.rst:937 msgid "" "The identical tuple ``('a', 'a', 'b')`` occurs twice, but the two 'a' " "strings came from different positions." msgstr "" -#: howto/functional.rst:938 +#: howto/functional.rst:940 msgid "" "The :func:`itertools.combinations_with_replacement(iterable, r) ` function relaxes a different constraint: " @@ -1321,7 +1321,7 @@ msgid "" "the second element is selected. ::" msgstr "" -#: howto/functional.rst:944 +#: howto/functional.rst:946 msgid "" "itertools.combinations_with_replacement([1, 2, 3, 4, 5], 2) =>\n" " (1, 1), (1, 2), (1, 3), (1, 4), (1, 5),\n" @@ -1331,11 +1331,11 @@ msgid "" " (5, 5)" msgstr "" -#: howto/functional.rst:953 +#: howto/functional.rst:955 msgid "Grouping elements" msgstr "" -#: howto/functional.rst:955 +#: howto/functional.rst:957 msgid "" "The last function I'll discuss, :func:`itertools.groupby(iter, " "key_func=None) `, is the most complicated. " @@ -1344,14 +1344,14 @@ msgid "" "key is simply each element itself." msgstr "" -#: howto/functional.rst:960 +#: howto/functional.rst:962 msgid "" ":func:`~itertools.groupby` collects all the consecutive elements from the " "underlying iterable that have the same key value, and returns a stream of 2-" "tuples containing a key value and an iterator for the elements with that key." msgstr "" -#: howto/functional.rst:966 +#: howto/functional.rst:968 msgid "" "city_list = [('Decatur', 'AL'), ('Huntsville', 'AL'), ('Selma', 'AL'),\n" " ('Anchorage', 'AK'), ('Nome', 'AK'),\n" @@ -1376,7 +1376,7 @@ msgid "" " ('Flagstaff', 'AZ'), ('Phoenix', 'AZ'), ('Tucson', 'AZ')" msgstr "" -#: howto/functional.rst:988 +#: howto/functional.rst:990 msgid "" ":func:`~itertools.groupby` assumes that the underlying iterable's contents " "will already be sorted based on the key. Note that the returned iterators " @@ -1384,11 +1384,11 @@ msgid "" "iterator-1 before requesting iterator-2 and its corresponding key." msgstr "" -#: howto/functional.rst:995 +#: howto/functional.rst:997 msgid "The functools module" msgstr "" -#: howto/functional.rst:997 +#: howto/functional.rst:999 msgid "" "The :mod:`functools` module contains some higher-order functions. A **higher-" "order function** takes one or more functions as input and returns a new " @@ -1396,7 +1396,7 @@ msgid "" "partial` function." msgstr "" -#: howto/functional.rst:1002 +#: howto/functional.rst:1004 msgid "" "For programs written in a functional style, you'll sometimes want to " "construct variants of existing functions that have some of the parameters " @@ -1406,7 +1406,7 @@ msgid "" "\"partial function application\"." msgstr "" -#: howto/functional.rst:1008 +#: howto/functional.rst:1010 msgid "" "The constructor for :func:`~functools.partial` takes the arguments " "``(function, arg1, arg2, ..., kwarg1=value1, kwarg2=value2)``. The " @@ -1414,11 +1414,11 @@ msgid "" "with the filled-in arguments." msgstr "" -#: howto/functional.rst:1013 +#: howto/functional.rst:1015 msgid "Here's a small but realistic example::" msgstr "" -#: howto/functional.rst:1015 +#: howto/functional.rst:1017 msgid "" "import functools\n" "\n" @@ -1431,7 +1431,7 @@ msgid "" "server_log('Unable to open socket')" msgstr "" -#: howto/functional.rst:1025 +#: howto/functional.rst:1027 msgid "" ":func:`functools.reduce(func, iter, [initial_value]) ` " "cumulatively performs an operation on all the iterable's elements and, " @@ -1446,7 +1446,7 @@ msgid "" "``func(initial_value, A)`` is the first calculation. ::" msgstr "" -#: howto/functional.rst:1037 +#: howto/functional.rst:1039 msgid "" ">>> import operator, functools\n" ">>> functools.reduce(operator.concat, ['A', 'BB', 'C'])\n" @@ -1461,20 +1461,20 @@ msgid "" "1" msgstr "" -#: howto/functional.rst:1049 +#: howto/functional.rst:1051 msgid "" "If you use :func:`operator.add` with :func:`functools.reduce`, you'll add up " "all the elements of the iterable. This case is so common that there's a " "special built-in called :func:`sum` to compute it:" msgstr "" -#: howto/functional.rst:1061 +#: howto/functional.rst:1063 msgid "" "For many uses of :func:`functools.reduce`, though, it can be clearer to just " "write the obvious :keyword:`for` loop::" msgstr "" -#: howto/functional.rst:1064 +#: howto/functional.rst:1066 msgid "" "import functools\n" "# Instead of:\n" @@ -1486,7 +1486,7 @@ msgid "" " product *= i" msgstr "" -#: howto/functional.rst:1073 +#: howto/functional.rst:1075 msgid "" "A related function is :func:`itertools.accumulate(iterable, func=operator." "add) `. It performs the same calculation, but instead " @@ -1494,7 +1494,7 @@ msgid "" "iterator that also yields each partial result::" msgstr "" -#: howto/functional.rst:1078 +#: howto/functional.rst:1080 msgid "" "itertools.accumulate([1, 2, 3, 4, 5]) =>\n" " 1, 3, 6, 10, 15\n" @@ -1503,11 +1503,11 @@ msgid "" " 1, 2, 6, 24, 120" msgstr "" -#: howto/functional.rst:1086 +#: howto/functional.rst:1088 msgid "The operator module" msgstr "" -#: howto/functional.rst:1088 +#: howto/functional.rst:1090 msgid "" "The :mod:`operator` module was mentioned earlier. It contains a set of " "functions corresponding to Python's operators. These functions are often " @@ -1515,60 +1515,60 @@ msgid "" "functions that perform a single operation." msgstr "" -#: howto/functional.rst:1093 +#: howto/functional.rst:1095 msgid "Some of the functions in this module are:" msgstr "" -#: howto/functional.rst:1095 +#: howto/functional.rst:1097 msgid "" "Math operations: ``add()``, ``sub()``, ``mul()``, ``floordiv()``, " "``abs()``, ..." msgstr "" -#: howto/functional.rst:1096 +#: howto/functional.rst:1098 msgid "Logical operations: ``not_()``, ``truth()``." msgstr "" -#: howto/functional.rst:1097 +#: howto/functional.rst:1099 msgid "Bitwise operations: ``and_()``, ``or_()``, ``invert()``." msgstr "" -#: howto/functional.rst:1098 +#: howto/functional.rst:1100 msgid "" "Comparisons: ``eq()``, ``ne()``, ``lt()``, ``le()``, ``gt()``, and ``ge()``." msgstr "" -#: howto/functional.rst:1099 +#: howto/functional.rst:1101 msgid "Object identity: ``is_()``, ``is_not()``." msgstr "" -#: howto/functional.rst:1101 +#: howto/functional.rst:1103 msgid "Consult the operator module's documentation for a complete list." msgstr "" -#: howto/functional.rst:1105 +#: howto/functional.rst:1107 msgid "Small functions and the lambda expression" msgstr "" -#: howto/functional.rst:1107 +#: howto/functional.rst:1109 msgid "" "When writing functional-style programs, you'll often need little functions " "that act as predicates or that combine elements in some way." msgstr "" -#: howto/functional.rst:1110 +#: howto/functional.rst:1112 msgid "" "If there's a Python built-in or a module function that's suitable, you don't " "need to define a new function at all::" msgstr "" -#: howto/functional.rst:1113 +#: howto/functional.rst:1115 msgid "" "stripped_lines = [line.strip() for line in lines]\n" "existing_files = filter(os.path.exists, file_list)" msgstr "" -#: howto/functional.rst:1116 +#: howto/functional.rst:1118 msgid "" "If the function you need doesn't exist, you need to write it. One way to " "write small functions is to use the :keyword:`lambda` expression. " @@ -1577,20 +1577,20 @@ msgid "" "expression::" msgstr "" -#: howto/functional.rst:1121 +#: howto/functional.rst:1123 msgid "" "adder = lambda x, y: x+y\n" "\n" "print_assign = lambda name, value: name + '=' + str(value)" msgstr "" -#: howto/functional.rst:1125 +#: howto/functional.rst:1127 msgid "" "An alternative is to just use the ``def`` statement and define a function in " "the usual way::" msgstr "" -#: howto/functional.rst:1128 +#: howto/functional.rst:1130 msgid "" "def adder(x, y):\n" " return x + y\n" @@ -1599,13 +1599,13 @@ msgid "" " return name + '=' + str(value)" msgstr "" -#: howto/functional.rst:1134 +#: howto/functional.rst:1136 msgid "" "Which alternative is preferable? That's a style question; my usual course " "is to avoid using ``lambda``." msgstr "" -#: howto/functional.rst:1137 +#: howto/functional.rst:1139 msgid "" "One reason for my preference is that ``lambda`` is quite limited in the " "functions it can define. The result has to be computable as a single " @@ -1615,20 +1615,20 @@ msgid "" "that's hard to read. Quick, what's the following code doing? ::" msgstr "" -#: howto/functional.rst:1144 +#: howto/functional.rst:1146 msgid "" "import functools\n" "total = functools.reduce(lambda a, b: (0, a[1] + b[1]), items)[1]" msgstr "" -#: howto/functional.rst:1147 +#: howto/functional.rst:1149 msgid "" "You can figure it out, but it takes time to disentangle the expression to " "figure out what's going on. Using a short nested ``def`` statements makes " "things a little bit better::" msgstr "" -#: howto/functional.rst:1151 +#: howto/functional.rst:1153 msgid "" "import functools\n" "def combine(a, b):\n" @@ -1637,70 +1637,70 @@ msgid "" "total = functools.reduce(combine, items)[1]" msgstr "" -#: howto/functional.rst:1157 +#: howto/functional.rst:1159 msgid "But it would be best of all if I had simply used a ``for`` loop::" msgstr "" -#: howto/functional.rst:1159 +#: howto/functional.rst:1161 msgid "" "total = 0\n" "for a, b in items:\n" " total += b" msgstr "" -#: howto/functional.rst:1163 +#: howto/functional.rst:1165 msgid "Or the :func:`sum` built-in and a generator expression::" msgstr "" -#: howto/functional.rst:1165 +#: howto/functional.rst:1167 msgid "total = sum(b for a, b in items)" msgstr "" -#: howto/functional.rst:1167 +#: howto/functional.rst:1169 msgid "" "Many uses of :func:`functools.reduce` are clearer when written as ``for`` " "loops." msgstr "" -#: howto/functional.rst:1169 +#: howto/functional.rst:1171 msgid "" "Fredrik Lundh once suggested the following set of rules for refactoring uses " "of ``lambda``:" msgstr "" -#: howto/functional.rst:1172 +#: howto/functional.rst:1174 msgid "Write a lambda function." msgstr "" -#: howto/functional.rst:1173 +#: howto/functional.rst:1175 msgid "Write a comment explaining what the heck that lambda does." msgstr "" -#: howto/functional.rst:1174 +#: howto/functional.rst:1176 msgid "" "Study the comment for a while, and think of a name that captures the essence " "of the comment." msgstr "" -#: howto/functional.rst:1176 +#: howto/functional.rst:1178 msgid "Convert the lambda to a def statement, using that name." msgstr "" -#: howto/functional.rst:1177 +#: howto/functional.rst:1179 msgid "Remove the comment." msgstr "" -#: howto/functional.rst:1179 +#: howto/functional.rst:1181 msgid "" "I really like these rules, but you're free to disagree about whether this " "lambda-free style is better." msgstr "" -#: howto/functional.rst:1184 +#: howto/functional.rst:1186 msgid "Revision History and Acknowledgements" msgstr "" -#: howto/functional.rst:1186 +#: howto/functional.rst:1188 msgid "" "The author would like to thank the following people for offering " "suggestions, corrections and assistance with various drafts of this article: " @@ -1708,40 +1708,40 @@ msgid "" "Krell, Leandro Lameiro, Jussi Salmela, Collin Winter, Blake Winton." msgstr "" -#: howto/functional.rst:1191 +#: howto/functional.rst:1193 msgid "Version 0.1: posted June 30 2006." msgstr "" -#: howto/functional.rst:1193 +#: howto/functional.rst:1195 msgid "Version 0.11: posted July 1 2006. Typo fixes." msgstr "" -#: howto/functional.rst:1195 +#: howto/functional.rst:1197 msgid "" "Version 0.2: posted July 10 2006. Merged genexp and listcomp sections into " "one. Typo fixes." msgstr "" -#: howto/functional.rst:1198 +#: howto/functional.rst:1200 msgid "" "Version 0.21: Added more references suggested on the tutor mailing list." msgstr "" -#: howto/functional.rst:1200 +#: howto/functional.rst:1202 msgid "" "Version 0.30: Adds a section on the ``functional`` module written by Collin " "Winter; adds short section on the operator module; a few other edits." msgstr "" -#: howto/functional.rst:1205 +#: howto/functional.rst:1207 msgid "References" msgstr "" -#: howto/functional.rst:1208 +#: howto/functional.rst:1210 msgid "General" msgstr "" -#: howto/functional.rst:1210 +#: howto/functional.rst:1212 msgid "" "**Structure and Interpretation of Computer Programs**, by Harold Abelson and " "Gerald Jay Sussman with Julie Sussman. The book can be found at https://" @@ -1752,39 +1752,39 @@ msgid "" "functional-style Python code." msgstr "" -#: howto/functional.rst:1218 +#: howto/functional.rst:1220 msgid "" "https://www.defmacro.org/ramblings/fp.html: A general introduction to " "functional programming that uses Java examples and has a lengthy historical " "introduction." msgstr "" -#: howto/functional.rst:1221 +#: howto/functional.rst:1223 msgid "" "https://en.wikipedia.org/wiki/Functional_programming: General Wikipedia " "entry describing functional programming." msgstr "" -#: howto/functional.rst:1224 +#: howto/functional.rst:1226 msgid "https://en.wikipedia.org/wiki/Coroutine: Entry for coroutines." msgstr "" -#: howto/functional.rst:1226 +#: howto/functional.rst:1228 msgid "" "https://en.wikipedia.org/wiki/Partial_application: Entry for the concept of " "partial function application." msgstr "" -#: howto/functional.rst:1228 +#: howto/functional.rst:1230 msgid "" "https://en.wikipedia.org/wiki/Currying: Entry for the concept of currying." msgstr "" -#: howto/functional.rst:1231 +#: howto/functional.rst:1233 msgid "Python-specific" msgstr "" -#: howto/functional.rst:1233 +#: howto/functional.rst:1235 msgid "" "https://gnosis.cx/TPiP/: The first chapter of David Mertz's book :title-" "reference:`Text Processing in Python` discusses functional programming for " @@ -1792,7 +1792,7 @@ msgid "" "Text Processing\"." msgstr "" -#: howto/functional.rst:1238 +#: howto/functional.rst:1240 msgid "" "Mertz also wrote a 3-part series of articles on functional programming for " "IBM's DeveloperWorks site; see `part 1 `__," msgstr "" -#: howto/functional.rst:1246 +#: howto/functional.rst:1248 msgid "Python documentation" msgstr "" -#: howto/functional.rst:1248 +#: howto/functional.rst:1250 msgid "Documentation for the :mod:`itertools` module." msgstr "" -#: howto/functional.rst:1250 +#: howto/functional.rst:1252 msgid "Documentation for the :mod:`functools` module." msgstr "" -#: howto/functional.rst:1252 +#: howto/functional.rst:1254 msgid "Documentation for the :mod:`operator` module." msgstr "" -#: howto/functional.rst:1254 +#: howto/functional.rst:1256 msgid ":pep:`289`: \"Generator Expressions\"" msgstr "" -#: howto/functional.rst:1256 +#: howto/functional.rst:1258 msgid "" ":pep:`342`: \"Coroutines via Enhanced Generators\" describes the new " "generator features in Python 2.5." diff --git a/howto/gdb_helpers.po b/howto/gdb_helpers.po index 1c89be337..ab25ad52d 100644 --- a/howto/gdb_helpers.po +++ b/howto/gdb_helpers.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: TURKISH \n" @@ -298,13 +298,15 @@ 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}}" +"(gdb) p *(PyLongObject*)some_python_integer\n" +"$5 = {ob_base = {ob_base = {ob_refcnt = 8, ob_type = 0x3dad39f5e0}, ob_size " +"= 1},\n" +"ob_digit = {42}}" msgstr "" #: howto/gdb_helpers.rst:189 diff --git a/howto/index.po b/howto/index.po index be0d97d2e..e33f44bb7 100644 --- a/howto/index.po +++ b/howto/index.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-12-17 01:28+0300\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: 2023-01-16 04:38+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -21,17 +21,109 @@ msgid "Python HOWTOs" msgstr "Python NASIL'ları" #: howto/index.rst:5 +#, fuzzy msgid "" -"Python HOWTOs are documents that cover a single, specific topic, and attempt " -"to cover it fairly completely. Modelled on the Linux Documentation Project's " -"HOWTO collection, this collection is an effort to foster documentation " -"that's more detailed than the Python Library Reference." +"Python HOWTOs are documents that cover a specific topic in-depth. Modeled on " +"the Linux Documentation Project's HOWTO collection, this collection is an " +"effort to foster documentation that's more detailed than the Python Library " +"Reference." msgstr "" "Python NASIL'ları, tek bir belirli konuyu kapsayan ve onu olabildiğince " "eksiksiz bir şekilde ele almaya çalışan dokümanlardır. Linux Dokümantasyon " "Projesi'nin NASIL koleksiyonu üzerinde modellenen bu koleksiyon, Python " "Kütüphane Referansından daha detaylı dokümantasyonu teşvik etme çabasıdır." -#: howto/index.rst:11 -msgid "Currently, the HOWTOs are:" -msgstr "Şu anda, NASIL'lar şunlardır:" +#: howto/index.rst:35 +msgid "General:" +msgstr "" + +#: howto/index.rst:37 +msgid ":ref:`annotations-howto`" +msgstr "" + +#: howto/index.rst:38 +msgid ":ref:`argparse-tutorial`" +msgstr "" + +#: howto/index.rst:39 +msgid ":ref:`descriptorhowto`" +msgstr "" + +#: howto/index.rst:40 +msgid ":ref:`enum-howto`" +msgstr "" + +#: howto/index.rst:41 +msgid ":ref:`functional-howto`" +msgstr "" + +#: howto/index.rst:42 +msgid ":ref:`ipaddress-howto`" +msgstr "" + +#: howto/index.rst:43 +msgid ":ref:`logging-howto`" +msgstr "" + +#: howto/index.rst:44 +msgid ":ref:`logging-cookbook`" +msgstr "" + +#: howto/index.rst:45 +msgid ":ref:`regex-howto`" +msgstr "" + +#: howto/index.rst:46 +msgid ":ref:`sortinghowto`" +msgstr "" + +#: howto/index.rst:47 +msgid ":ref:`unicode-howto`" +msgstr "" + +#: howto/index.rst:48 +msgid ":ref:`urllib-howto`" +msgstr "" + +#: howto/index.rst:50 +msgid "Advanced development:" +msgstr "" + +#: howto/index.rst:52 +msgid ":ref:`curses-howto`" +msgstr "" + +#: howto/index.rst:53 +msgid ":ref:`isolating-extensions-howto`" +msgstr "" + +#: howto/index.rst:54 +msgid ":ref:`python_2.3_mro`" +msgstr "" + +#: howto/index.rst:55 +msgid ":ref:`socket-howto`" +msgstr "" + +#: howto/index.rst:56 +msgid ":ref:`cporting-howto`" +msgstr "" + +#: howto/index.rst:58 +msgid "Debugging and profiling:" +msgstr "" + +#: howto/index.rst:60 +msgid ":ref:`gdb`" +msgstr "" + +#: howto/index.rst:61 +msgid ":ref:`instrumentation`" +msgstr "" + +#: howto/index.rst:62 +msgid ":ref:`perf_profiling`" +msgstr "" + +#~ msgid "Currently, the HOWTOs are:" +#~ msgstr "Şu anda, NASIL'lar şunlardır:" diff --git a/howto/logging.po b/howto/logging.po index b1deac8f3..18d7bfaac 100644 --- a/howto/logging.po +++ b/howto/logging.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00: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/logging.rst:3 +#: howto/logging.rst:5 msgid "Logging HOWTO" msgstr "" @@ -24,21 +24,21 @@ msgstr "" msgid "Author" msgstr "" -#: howto/logging.rst:5 +#: howto/logging.rst:7 msgid "Vinay Sajip " msgstr "" -#: howto/logging.rst:11 +#: howto/logging.rst:13 msgid "" "This page contains tutorial information. For links to reference information " "and a logging cookbook, please see :ref:`tutorial-ref-links`." msgstr "" -#: howto/logging.rst:15 +#: howto/logging.rst:17 msgid "Basic Logging Tutorial" msgstr "" -#: howto/logging.rst:17 +#: howto/logging.rst:19 msgid "" "Logging is a means of tracking events that happen when some software runs. " "The software's developer adds logging calls to their code to indicate that " @@ -49,11 +49,11 @@ msgid "" "the *level* or *severity*." msgstr "" -#: howto/logging.rst:26 +#: howto/logging.rst:28 msgid "When to use logging" msgstr "" -#: howto/logging.rst:28 +#: howto/logging.rst:30 msgid "" "You can access logging functionality by creating a logger via ``logger = " "getLogger(__name__)``, and then calling the logger's :meth:`~Logger.debug`, :" @@ -63,173 +63,173 @@ msgid "" "each of a set of common tasks, the best tool to use for that task." msgstr "" -#: howto/logging.rst:36 +#: howto/logging.rst:38 msgid "Task you want to perform" msgstr "" -#: howto/logging.rst:36 +#: howto/logging.rst:38 msgid "The best tool for the task" msgstr "" -#: howto/logging.rst:38 +#: howto/logging.rst:40 msgid "" "Display console output for ordinary usage of a command line script or program" msgstr "" -#: howto/logging.rst:38 +#: howto/logging.rst:40 msgid ":func:`print`" msgstr "" -#: howto/logging.rst:42 +#: howto/logging.rst:44 msgid "" "Report events that occur during normal operation of a program (e.g. for " "status monitoring or fault investigation)" msgstr "" -#: howto/logging.rst:42 +#: howto/logging.rst:44 msgid "" "A logger's :meth:`~Logger.info` (or :meth:`~Logger.debug` method for very " "detailed output for diagnostic purposes)" msgstr "" -#: howto/logging.rst:47 +#: howto/logging.rst:49 msgid "Issue a warning regarding a particular runtime event" msgstr "" -#: howto/logging.rst:47 +#: howto/logging.rst:49 msgid "" ":func:`warnings.warn` in library code if the issue is avoidable and the " "client application should be modified to eliminate the warning" msgstr "" -#: howto/logging.rst:52 +#: howto/logging.rst:54 msgid "" "A logger's :meth:`~Logger.warning` method if there is nothing the client " "application can do about the situation, but the event should still be noted" msgstr "" -#: howto/logging.rst:58 +#: howto/logging.rst:60 msgid "Report an error regarding a particular runtime event" msgstr "" -#: howto/logging.rst:58 +#: howto/logging.rst:60 msgid "Raise an exception" msgstr "" -#: howto/logging.rst:61 +#: howto/logging.rst:63 msgid "" "Report suppression of an error without raising an exception (e.g. error " "handler in a long-running server process)" msgstr "" -#: howto/logging.rst:61 +#: howto/logging.rst:63 msgid "" "A logger's :meth:`~Logger.error`, :meth:`~Logger.exception` or :meth:" "`~Logger.critical` method as appropriate for the specific error and " "application domain" msgstr "" -#: howto/logging.rst:68 +#: howto/logging.rst:70 msgid "" "The logger methods are named after the level or severity of the events they " "are used to track. The standard levels and their applicability are described " "below (in increasing order of severity):" msgstr "" -#: howto/logging.rst:874 +#: howto/logging.rst:876 msgid "Level" msgstr "" -#: howto/logging.rst:75 +#: howto/logging.rst:77 msgid "When it's used" msgstr "" -#: howto/logging.rst:884 +#: howto/logging.rst:886 msgid "``DEBUG``" msgstr "" -#: howto/logging.rst:77 +#: howto/logging.rst:79 msgid "" "Detailed information, typically of interest only when diagnosing problems." msgstr "" -#: howto/logging.rst:882 +#: howto/logging.rst:884 msgid "``INFO``" msgstr "" -#: howto/logging.rst:80 +#: howto/logging.rst:82 msgid "Confirmation that things are working as expected." msgstr "" -#: howto/logging.rst:880 +#: howto/logging.rst:882 msgid "``WARNING``" msgstr "" -#: howto/logging.rst:83 +#: howto/logging.rst:85 msgid "" "An indication that something unexpected happened, or indicative of some " "problem in the near future (e.g. 'disk space low'). The software is still " "working as expected." msgstr "" -#: howto/logging.rst:878 +#: howto/logging.rst:880 msgid "``ERROR``" msgstr "" -#: howto/logging.rst:88 +#: howto/logging.rst:90 msgid "" "Due to a more serious problem, the software has not been able to perform " "some function." msgstr "" -#: howto/logging.rst:876 +#: howto/logging.rst:878 msgid "``CRITICAL``" msgstr "" -#: howto/logging.rst:91 +#: howto/logging.rst:93 msgid "" "A serious error, indicating that the program itself may be unable to " "continue running." msgstr "" -#: howto/logging.rst:95 +#: howto/logging.rst:97 msgid "" "The default level is ``WARNING``, which means that only events of this level " "and above will be tracked, unless the logging package is configured to do " "otherwise." msgstr "" -#: howto/logging.rst:99 +#: howto/logging.rst:101 msgid "" "Events that are tracked can be handled in different ways. The simplest way " "of handling tracked events is to print them to the console. Another common " "way is to write them to a disk file." msgstr "" -#: howto/logging.rst:107 +#: howto/logging.rst:109 msgid "A simple example" msgstr "" -#: howto/logging.rst:109 +#: howto/logging.rst:111 msgid "A very simple example is::" msgstr "" -#: howto/logging.rst:111 +#: howto/logging.rst:113 msgid "" "import logging\n" "logging.warning('Watch out!') # will print a message to the console\n" "logging.info('I told you so') # will not print anything" msgstr "" -#: howto/logging.rst:115 +#: howto/logging.rst:117 msgid "If you type these lines into a script and run it, you'll see:" msgstr "" -#: howto/logging.rst:117 +#: howto/logging.rst:119 msgid "WARNING:root:Watch out!" msgstr "" -#: howto/logging.rst:121 +#: howto/logging.rst:123 msgid "" "printed out on the console. The ``INFO`` message doesn't appear because the " "default level is ``WARNING``. The printed message includes the indication of " @@ -238,7 +238,7 @@ msgid "" "need that; formatting options will also be explained later." msgstr "" -#: howto/logging.rst:127 +#: howto/logging.rst:129 msgid "" "Notice that in this example, we use functions directly on the ``logging`` " "module, like ``logging.debug``, rather than creating a logger and calling " @@ -250,11 +250,11 @@ msgid "" "methods." msgstr "" -#: howto/logging.rst:136 +#: howto/logging.rst:138 msgid "Logging to a file" msgstr "" -#: howto/logging.rst:138 +#: howto/logging.rst:140 msgid "" "A very common situation is that of recording logging events in a file, so " "let's look at that next. Be sure to try the following in a newly started " @@ -262,7 +262,7 @@ msgid "" "above::" msgstr "" -#: howto/logging.rst:142 +#: howto/logging.rst:144 msgid "" "import logging\n" "logger = logging.getLogger(__name__)\n" @@ -274,7 +274,7 @@ msgid "" "logger.error('And non-ASCII stuff, too, like Øresund and Malmö')" msgstr "" -#: howto/logging.rst:150 +#: howto/logging.rst:152 msgid "" "The *encoding* argument was added. In earlier Python versions, or if not " "specified, the encoding used is the default value used by :func:`open`. " @@ -283,13 +283,13 @@ msgid "" "values and the default, see the documentation for :func:`open`." msgstr "" -#: howto/logging.rst:157 +#: howto/logging.rst:159 msgid "" "And now if we open the file and look at what we have, we should find the log " "messages:" msgstr "" -#: howto/logging.rst:160 +#: howto/logging.rst:162 msgid "" "DEBUG:__main__:This message should go to the log file\n" "INFO:__main__:So should this\n" @@ -297,40 +297,40 @@ msgid "" "ERROR:__main__:And non-ASCII stuff, too, like Øresund and Malmö" msgstr "" -#: howto/logging.rst:167 +#: howto/logging.rst:169 msgid "" "This example also shows how you can set the logging level which acts as the " "threshold for tracking. In this case, because we set the threshold to " "``DEBUG``, all of the messages were printed." msgstr "" -#: howto/logging.rst:171 +#: howto/logging.rst:173 msgid "" "If you want to set the logging level from a command-line option such as:" msgstr "" -#: howto/logging.rst:173 +#: howto/logging.rst:175 msgid "--log=INFO" msgstr "" -#: howto/logging.rst:177 +#: howto/logging.rst:179 msgid "" "and you have the value of the parameter passed for ``--log`` in some " "variable *loglevel*, you can use::" msgstr "" -#: howto/logging.rst:180 +#: howto/logging.rst:182 msgid "getattr(logging, loglevel.upper())" msgstr "" -#: howto/logging.rst:182 +#: howto/logging.rst:184 msgid "" "to get the value which you'll pass to :func:`basicConfig` via the *level* " "argument. You may want to error check any user input value, perhaps as in " "the following example::" msgstr "" -#: howto/logging.rst:186 +#: howto/logging.rst:188 msgid "" "# assuming loglevel is bound to the string value obtained from the\n" "# command line argument. Convert to upper case to allow the user to\n" @@ -341,14 +341,14 @@ msgid "" "logging.basicConfig(level=numeric_level, ...)" msgstr "" -#: howto/logging.rst:194 +#: howto/logging.rst:196 msgid "" "The call to :func:`basicConfig` should come *before* any calls to a logger's " "methods such as :meth:`~Logger.debug`, :meth:`~Logger.info`, etc. Otherwise, " "that logging event may not be handled in the desired manner." msgstr "" -#: howto/logging.rst:198 +#: howto/logging.rst:200 msgid "" "If you run the above script several times, the messages from successive runs " "are appended to the file *example.log*. If you want each run to start " @@ -356,43 +356,43 @@ msgid "" "*filemode* argument, by changing the call in the above example to::" msgstr "" -#: howto/logging.rst:203 +#: howto/logging.rst:205 msgid "" "logging.basicConfig(filename='example.log', filemode='w', level=logging." "DEBUG)" msgstr "" -#: howto/logging.rst:205 +#: howto/logging.rst:207 msgid "" "The output will be the same as before, but the log file is no longer " "appended to, so the messages from earlier runs are lost." msgstr "" -#: howto/logging.rst:210 +#: howto/logging.rst:212 msgid "Logging variable data" msgstr "" -#: howto/logging.rst:212 +#: howto/logging.rst:214 msgid "" "To log variable data, use a format string for the event description message " "and append the variable data as arguments. For example::" msgstr "" -#: howto/logging.rst:215 +#: howto/logging.rst:217 msgid "" "import logging\n" "logging.warning('%s before you %s', 'Look', 'leap!')" msgstr "" -#: howto/logging.rst:218 +#: howto/logging.rst:220 msgid "will display:" msgstr "" -#: howto/logging.rst:220 +#: howto/logging.rst:222 msgid "WARNING:root:Look before you leap!" msgstr "" -#: howto/logging.rst:224 +#: howto/logging.rst:226 msgid "" "As you can see, merging of variable data into the event description message " "uses the old, %-style of string formatting. This is for backwards " @@ -402,17 +402,17 @@ msgid "" "tutorial: see :ref:`formatting-styles` for more information." msgstr "" -#: howto/logging.rst:233 +#: howto/logging.rst:235 msgid "Changing the format of displayed messages" msgstr "" -#: howto/logging.rst:235 +#: howto/logging.rst:237 msgid "" "To change the format which is used to display messages, you need to specify " "the format you want to use::" msgstr "" -#: howto/logging.rst:238 +#: howto/logging.rst:240 msgid "" "import logging\n" "logging.basicConfig(format='%(levelname)s:%(message)s', level=logging." @@ -422,18 +422,18 @@ msgid "" "logging.warning('And this, too')" msgstr "" -#: howto/logging.rst:244 +#: howto/logging.rst:246 msgid "which would print:" msgstr "" -#: howto/logging.rst:246 +#: howto/logging.rst:248 msgid "" "DEBUG:This message should appear on the console\n" "INFO:So should this\n" "WARNING:And this, too" msgstr "" -#: howto/logging.rst:252 +#: howto/logging.rst:254 msgid "" "Notice that the 'root' which appeared in earlier examples has disappeared. " "For a full set of things that can appear in format strings, you can refer to " @@ -443,39 +443,39 @@ msgid "" "This is described in the next section." msgstr "" -#: howto/logging.rst:261 +#: howto/logging.rst:263 msgid "Displaying the date/time in messages" msgstr "" -#: howto/logging.rst:263 +#: howto/logging.rst:265 msgid "" "To display the date and time of an event, you would place '%(asctime)s' in " "your format string::" msgstr "" -#: howto/logging.rst:266 +#: howto/logging.rst:268 msgid "" "import logging\n" "logging.basicConfig(format='%(asctime)s %(message)s')\n" "logging.warning('is when this event was logged.')" msgstr "" -#: howto/logging.rst:270 +#: howto/logging.rst:272 msgid "which should print something like this:" msgstr "" -#: howto/logging.rst:272 +#: howto/logging.rst:274 msgid "2010-12-12 11:41:42,612 is when this event was logged." msgstr "" -#: howto/logging.rst:276 +#: howto/logging.rst:278 msgid "" "The default format for date/time display (shown above) is like ISO8601 or :" "rfc:`3339`. If you need more control over the formatting of the date/time, " "provide a *datefmt* argument to ``basicConfig``, as in this example::" msgstr "" -#: howto/logging.rst:280 +#: howto/logging.rst:282 msgid "" "import logging\n" "logging.basicConfig(format='%(asctime)s %(message)s', datefmt='%m/%d/%Y %I:" @@ -483,25 +483,25 @@ msgid "" "logging.warning('is when this event was logged.')" msgstr "" -#: howto/logging.rst:284 +#: howto/logging.rst:286 msgid "which would display something like this:" msgstr "" -#: howto/logging.rst:286 +#: howto/logging.rst:288 msgid "12/12/2010 11:46:36 AM is when this event was logged." msgstr "" -#: howto/logging.rst:290 +#: howto/logging.rst:292 msgid "" "The format of the *datefmt* argument is the same as supported by :func:`time." "strftime`." msgstr "" -#: howto/logging.rst:295 +#: howto/logging.rst:297 msgid "Next Steps" msgstr "" -#: howto/logging.rst:297 +#: howto/logging.rst:299 msgid "" "That concludes the basic tutorial. It should be enough to get you up and " "running with logging. There's a lot more that the logging package offers, " @@ -510,7 +510,7 @@ msgid "" "of your favourite beverage and carry on." msgstr "" -#: howto/logging.rst:303 +#: howto/logging.rst:305 msgid "" "If your logging needs are simple, then use the above examples to incorporate " "logging into your own scripts, and if you run into problems or don't " @@ -519,50 +519,50 @@ msgid "" "should receive help before too long." msgstr "" -#: howto/logging.rst:309 +#: howto/logging.rst:311 msgid "" "Still here? You can carry on reading the next few sections, which provide a " "slightly more advanced/in-depth tutorial than the basic one above. After " "that, you can take a look at the :ref:`logging-cookbook`." msgstr "" -#: howto/logging.rst:317 +#: howto/logging.rst:319 msgid "Advanced Logging Tutorial" msgstr "" -#: howto/logging.rst:319 +#: howto/logging.rst:321 msgid "" "The logging library takes a modular approach and offers several categories " "of components: loggers, handlers, filters, and formatters." msgstr "" -#: howto/logging.rst:322 +#: howto/logging.rst:324 msgid "Loggers expose the interface that application code directly uses." msgstr "" -#: howto/logging.rst:323 +#: howto/logging.rst:325 msgid "" "Handlers send the log records (created by loggers) to the appropriate " "destination." msgstr "" -#: howto/logging.rst:325 +#: howto/logging.rst:327 msgid "" "Filters provide a finer grained facility for determining which log records " "to output." msgstr "" -#: howto/logging.rst:327 +#: howto/logging.rst:329 msgid "Formatters specify the layout of log records in the final output." msgstr "" -#: howto/logging.rst:329 +#: howto/logging.rst:331 msgid "" "Log event information is passed between loggers, handlers, filters and " "formatters in a :class:`LogRecord` instance." msgstr "" -#: howto/logging.rst:332 +#: howto/logging.rst:334 msgid "" "Logging is performed by calling methods on instances of the :class:`Logger` " "class (hereafter called :dfn:`loggers`). Each instance has a name, and they " @@ -573,23 +573,23 @@ msgid "" "originates." msgstr "" -#: howto/logging.rst:339 +#: howto/logging.rst:341 msgid "" "A good convention to use when naming loggers is to use a module-level " "logger, in each module which uses logging, named as follows::" msgstr "" -#: howto/logging.rst:342 +#: howto/logging.rst:344 msgid "logger = logging.getLogger(__name__)" msgstr "" -#: howto/logging.rst:344 +#: howto/logging.rst:346 msgid "" "This means that logger names track the package/module hierarchy, and it's " "intuitively obvious where events are logged just from the logger name." msgstr "" -#: howto/logging.rst:347 +#: howto/logging.rst:349 msgid "" "The root of the hierarchy of loggers is called the root logger. That's the " "logger used by the functions :func:`debug`, :func:`info`, :func:`warning`, :" @@ -598,7 +598,7 @@ msgid "" "root logger's name is printed as 'root' in the logged output." msgstr "" -#: howto/logging.rst:353 +#: howto/logging.rst:355 msgid "" "It is, of course, possible to log messages to different destinations. " "Support is included in the package for writing log messages to files, HTTP " @@ -609,7 +609,7 @@ msgid "" "built-in handler classes." msgstr "" -#: howto/logging.rst:360 +#: howto/logging.rst:362 msgid "" "By default, no destination is set for any logging messages. You can specify " "a destination (such as console or file) by using :func:`basicConfig` as in " @@ -621,36 +621,36 @@ msgid "" "message output." msgstr "" -#: howto/logging.rst:368 +#: howto/logging.rst:370 msgid "The default format set by :func:`basicConfig` for messages is:" msgstr "" -#: howto/logging.rst:370 +#: howto/logging.rst:372 msgid "severity:logger name:message" msgstr "" -#: howto/logging.rst:374 +#: howto/logging.rst:376 msgid "" "You can change this by passing a format string to :func:`basicConfig` with " "the *format* keyword argument. For all options regarding how a format string " "is constructed, see :ref:`formatter-objects`." msgstr "" -#: howto/logging.rst:379 +#: howto/logging.rst:381 msgid "Logging Flow" msgstr "" -#: howto/logging.rst:381 +#: howto/logging.rst:383 msgid "" "The flow of log event information in loggers and handlers is illustrated in " "the following diagram." msgstr "" -#: howto/logging.rst:432 +#: howto/logging.rst:434 msgid "Loggers" msgstr "" -#: howto/logging.rst:434 +#: howto/logging.rst:436 msgid "" ":class:`Logger` objects have a threefold job. First, they expose several " "methods to application code so that applications can log messages at " @@ -660,17 +660,17 @@ msgid "" "handlers." msgstr "" -#: howto/logging.rst:440 +#: howto/logging.rst:442 msgid "" "The most widely used methods on logger objects fall into two categories: " "configuration and message sending." msgstr "" -#: howto/logging.rst:443 +#: howto/logging.rst:445 msgid "These are the most common configuration methods:" msgstr "" -#: howto/logging.rst:445 +#: howto/logging.rst:447 msgid "" ":meth:`Logger.setLevel` specifies the lowest-severity log message a logger " "will handle, where debug is the lowest built-in severity level and critical " @@ -679,32 +679,32 @@ msgid "" "messages and will ignore DEBUG messages." msgstr "" -#: howto/logging.rst:451 +#: howto/logging.rst:453 msgid "" ":meth:`Logger.addHandler` and :meth:`Logger.removeHandler` add and remove " "handler objects from the logger object. Handlers are covered in more detail " "in :ref:`handler-basic`." msgstr "" -#: howto/logging.rst:455 +#: howto/logging.rst:457 msgid "" ":meth:`Logger.addFilter` and :meth:`Logger.removeFilter` add and remove " "filter objects from the logger object. Filters are covered in more detail " "in :ref:`filter`." msgstr "" -#: howto/logging.rst:459 +#: howto/logging.rst:461 msgid "" "You don't need to always call these methods on every logger you create. See " "the last two paragraphs in this section." msgstr "" -#: howto/logging.rst:462 +#: howto/logging.rst:464 msgid "" "With the logger object configured, the following methods create log messages:" msgstr "" -#: howto/logging.rst:464 +#: howto/logging.rst:466 msgid "" ":meth:`Logger.debug`, :meth:`Logger.info`, :meth:`Logger.warning`, :meth:" "`Logger.error`, and :meth:`Logger.critical` all create log records with a " @@ -717,14 +717,14 @@ msgid "" "exception information." msgstr "" -#: howto/logging.rst:474 +#: howto/logging.rst:476 msgid "" ":meth:`Logger.exception` creates a log message similar to :meth:`Logger." "error`. The difference is that :meth:`Logger.exception` dumps a stack trace " "along with it. Call this method only from an exception handler." msgstr "" -#: howto/logging.rst:478 +#: howto/logging.rst:480 msgid "" ":meth:`Logger.log` takes a log level as an explicit argument. This is a " "little more verbose for logging messages than using the log level " @@ -732,7 +732,7 @@ msgid "" "levels." msgstr "" -#: howto/logging.rst:482 +#: howto/logging.rst:484 msgid "" ":func:`getLogger` returns a reference to a logger instance with the " "specified name if it is provided, or ``root`` if not. The names are period-" @@ -744,7 +744,7 @@ msgid "" "descendants of ``foo``." msgstr "" -#: howto/logging.rst:490 +#: howto/logging.rst:492 msgid "" "Loggers have a concept of *effective level*. If a level is not explicitly " "set on a logger, the level of its parent is used instead as its effective " @@ -756,7 +756,7 @@ msgid "" "handlers." msgstr "" -#: howto/logging.rst:498 +#: howto/logging.rst:500 msgid "" "Child loggers propagate messages up to the handlers associated with their " "ancestor loggers. Because of this, it is unnecessary to define and configure " @@ -766,11 +766,11 @@ msgid "" "attribute of a logger to ``False``.)" msgstr "" -#: howto/logging.rst:509 +#: howto/logging.rst:511 msgid "Handlers" msgstr "" -#: howto/logging.rst:511 +#: howto/logging.rst:513 msgid "" ":class:`~logging.Handler` objects are responsible for dispatching the " "appropriate log messages (based on the log messages' severity) to the " @@ -783,14 +783,14 @@ msgid "" "of a specific severity to a specific location." msgstr "" -#: howto/logging.rst:521 +#: howto/logging.rst:523 msgid "" "The standard library includes quite a few handler types (see :ref:`useful-" "handlers`); the tutorials use mainly :class:`StreamHandler` and :class:" "`FileHandler` in its examples." msgstr "" -#: howto/logging.rst:525 +#: howto/logging.rst:527 msgid "" "There are very few methods in a handler for application developers to " "concern themselves with. The only handler methods that seem relevant for " @@ -798,7 +798,7 @@ msgid "" "not creating custom handlers) are the following configuration methods:" msgstr "" -#: howto/logging.rst:530 +#: howto/logging.rst:532 msgid "" "The :meth:`~Handler.setLevel` method, just as in logger objects, specifies " "the lowest severity that will be dispatched to the appropriate destination. " @@ -808,19 +808,19 @@ msgid "" "send on." msgstr "" -#: howto/logging.rst:536 +#: howto/logging.rst:538 msgid "" ":meth:`~Handler.setFormatter` selects a Formatter object for this handler to " "use." msgstr "" -#: howto/logging.rst:539 +#: howto/logging.rst:541 msgid "" ":meth:`~Handler.addFilter` and :meth:`~Handler.removeFilter` respectively " "configure and deconfigure filter objects on handlers." msgstr "" -#: howto/logging.rst:542 +#: howto/logging.rst:544 msgid "" "Application code should not directly instantiate and use instances of :class:" "`Handler`. Instead, the :class:`Handler` class is a base class that defines " @@ -828,11 +828,11 @@ msgid "" "behavior that child classes can use (or override)." msgstr "" -#: howto/logging.rst:549 +#: howto/logging.rst:551 msgid "Formatters" msgstr "" -#: howto/logging.rst:551 +#: howto/logging.rst:553 msgid "" "Formatter objects configure the final order, structure, and contents of the " "log message. Unlike the base :class:`logging.Handler` class, application " @@ -842,24 +842,24 @@ msgid "" "string and a style indicator." msgstr "" -#: howto/logging.rst:560 +#: howto/logging.rst:562 msgid "" "If there is no message format string, the default is to use the raw " "message. If there is no date format string, the default date format is:" msgstr "" -#: howto/logging.rst:563 +#: howto/logging.rst:565 msgid "%Y-%m-%d %H:%M:%S" msgstr "" -#: howto/logging.rst:567 +#: howto/logging.rst:569 msgid "" "with the milliseconds tacked on at the end. The ``style`` is one of ``'%'``, " "``'{'``, or ``'$'``. If one of these is not specified, then ``'%'`` will be " "used." msgstr "" -#: howto/logging.rst:570 +#: howto/logging.rst:572 msgid "" "If the ``style`` is ``'%'``, the message format string uses ``%()s`` styled string substitution; the possible keys are documented in :" @@ -869,22 +869,22 @@ msgid "" "should conform to what is expected by :meth:`string.Template.substitute`." msgstr "" -#: howto/logging.rst:577 +#: howto/logging.rst:579 msgid "Added the ``style`` parameter." msgstr "" -#: howto/logging.rst:580 +#: howto/logging.rst:582 msgid "" "The following message format string will log the time in a human-readable " "format, the severity of the message, and the contents of the message, in " "that order::" msgstr "" -#: howto/logging.rst:584 +#: howto/logging.rst:586 msgid "'%(asctime)s - %(levelname)s - %(message)s'" msgstr "" -#: howto/logging.rst:586 +#: howto/logging.rst:588 msgid "" "Formatters use a user-configurable function to convert the creation time of " "a record to a tuple. By default, :func:`time.localtime` is used; to change " @@ -895,40 +895,40 @@ msgid "" "in the Formatter class (to ``time.gmtime`` for GMT display)." msgstr "" -#: howto/logging.rst:596 +#: howto/logging.rst:598 msgid "Configuring Logging" msgstr "" -#: howto/logging.rst:600 +#: howto/logging.rst:602 msgid "Programmers can configure logging in three ways:" msgstr "" -#: howto/logging.rst:602 +#: howto/logging.rst:604 msgid "" "Creating loggers, handlers, and formatters explicitly using Python code that " "calls the configuration methods listed above." msgstr "" -#: howto/logging.rst:604 +#: howto/logging.rst:606 msgid "" "Creating a logging config file and reading it using the :func:`fileConfig` " "function." msgstr "" -#: howto/logging.rst:606 +#: howto/logging.rst:608 msgid "" "Creating a dictionary of configuration information and passing it to the :" "func:`dictConfig` function." msgstr "" -#: howto/logging.rst:609 +#: howto/logging.rst:611 msgid "" "For the reference documentation on the last two options, see :ref:`logging-" "config-api`. The following example configures a very simple logger, a " "console handler, and a simple formatter using Python code::" msgstr "" -#: howto/logging.rst:613 +#: howto/logging.rst:615 msgid "" "import logging\n" "\n" @@ -958,12 +958,12 @@ msgid "" "logger.critical('critical message')" msgstr "" -#: howto/logging.rst:639 +#: howto/logging.rst:641 msgid "" "Running this module from the command line produces the following output:" msgstr "" -#: howto/logging.rst:641 +#: howto/logging.rst:643 msgid "" "$ python simple_logging_module.py\n" "2005-03-19 15:10:26,618 - simple_example - DEBUG - debug message\n" @@ -973,14 +973,14 @@ msgid "" "2005-03-19 15:10:26,773 - simple_example - CRITICAL - critical message" msgstr "" -#: howto/logging.rst:650 +#: howto/logging.rst:652 msgid "" "The following Python module creates a logger, handler, and formatter nearly " "identical to those in the example listed above, with the only difference " "being the names of the objects::" msgstr "" -#: howto/logging.rst:654 +#: howto/logging.rst:656 msgid "" "import logging\n" "import logging.config\n" @@ -998,11 +998,11 @@ msgid "" "logger.critical('critical message')" msgstr "" -#: howto/logging.rst:669 +#: howto/logging.rst:671 msgid "Here is the logging.conf file:" msgstr "" -#: howto/logging.rst:671 +#: howto/logging.rst:673 msgid "" "[loggers]\n" "keys=root,simpleExample\n" @@ -1033,12 +1033,12 @@ msgid "" "format=%(asctime)s - %(name)s - %(levelname)s - %(message)s" msgstr "" -#: howto/logging.rst:701 +#: howto/logging.rst:703 msgid "" "The output is nearly identical to that of the non-config-file-based example:" msgstr "" -#: howto/logging.rst:703 +#: howto/logging.rst:705 msgid "" "$ python simple_logging_config.py\n" "2005-03-19 15:38:55,977 - simpleExample - DEBUG - debug message\n" @@ -1048,14 +1048,14 @@ msgid "" "2005-03-19 15:38:56,130 - simpleExample - CRITICAL - critical message" msgstr "" -#: howto/logging.rst:712 +#: howto/logging.rst:714 msgid "" "You can see that the config file approach has a few advantages over the " "Python code approach, mainly separation of configuration and code and the " "ability of noncoders to easily modify the logging properties." msgstr "" -#: howto/logging.rst:716 +#: howto/logging.rst:718 msgid "" "The :func:`fileConfig` function takes a default parameter, " "``disable_existing_loggers``, which defaults to ``True`` for reasons of " @@ -1066,7 +1066,7 @@ msgid "" "information, and specify ``False`` for this parameter if you wish." msgstr "" -#: howto/logging.rst:724 +#: howto/logging.rst:726 msgid "" "The dictionary passed to :func:`dictConfig` can also specify a Boolean value " "with key ``disable_existing_loggers``, which if not specified explicitly in " @@ -1075,7 +1075,7 @@ msgid "" "want - in which case, provide the key explicitly with a value of ``False``." msgstr "" -#: howto/logging.rst:734 +#: howto/logging.rst:736 msgid "" "Note that the class names referenced in config files need to be either " "relative to the logging module, or absolute values which can be resolved " @@ -1086,7 +1086,7 @@ msgid "" "path)." msgstr "" -#: howto/logging.rst:742 +#: howto/logging.rst:744 msgid "" "In Python 3.2, a new means of configuring logging has been introduced, using " "dictionaries to hold configuration information. This provides a superset of " @@ -1101,13 +1101,13 @@ msgid "" "a socket, or use whatever approach makes sense for your application." msgstr "" -#: howto/logging.rst:754 +#: howto/logging.rst:756 msgid "" "Here's an example of the same configuration as above, in YAML format for the " "new dictionary-based approach:" msgstr "" -#: howto/logging.rst:757 +#: howto/logging.rst:759 msgid "" "version: 1\n" "formatters:\n" @@ -1129,24 +1129,24 @@ msgid "" " handlers: [console]" msgstr "" -#: howto/logging.rst:778 +#: howto/logging.rst:780 msgid "" "For more information about logging using a dictionary, see :ref:`logging-" "config-api`." msgstr "" -#: howto/logging.rst:782 +#: howto/logging.rst:784 msgid "What happens if no configuration is provided" msgstr "" -#: howto/logging.rst:784 +#: howto/logging.rst:786 msgid "" "If no logging configuration is provided, it is possible to have a situation " "where a logging event needs to be output, but no handlers can be found to " "output the event." msgstr "" -#: howto/logging.rst:788 +#: howto/logging.rst:790 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 " @@ -1158,32 +1158,32 @@ msgid "" "severities will be output." msgstr "" -#: howto/logging.rst:799 +#: howto/logging.rst:801 msgid "For versions of Python prior to 3.2, the behaviour is as follows:" msgstr "" -#: howto/logging.rst:801 +#: howto/logging.rst:803 msgid "" "If :data:`raiseExceptions` is ``False`` (production mode), the event is " "silently dropped." msgstr "" -#: howto/logging.rst:804 +#: howto/logging.rst:806 msgid "" "If :data:`raiseExceptions` is ``True`` (development mode), a message 'No " "handlers could be found for logger X.Y.Z' is printed once." msgstr "" -#: howto/logging.rst:807 +#: howto/logging.rst:809 msgid "" "To obtain the pre-3.2 behaviour, :data:`lastResort` can be set to ``None``." msgstr "" -#: howto/logging.rst:813 +#: howto/logging.rst:815 msgid "Configuring Logging for a Library" msgstr "" -#: howto/logging.rst:815 +#: howto/logging.rst:817 msgid "" "When developing a library which uses logging, you should take care to " "document how the library uses logging - for example, the names of loggers " @@ -1194,7 +1194,7 @@ msgid "" "is regarded as the best default behaviour." msgstr "" -#: howto/logging.rst:823 +#: howto/logging.rst:825 msgid "" "If for some reason you *don't* want these messages printed in the absence of " "any logging configuration, you can attach a do-nothing handler to the top-" @@ -1206,7 +1206,7 @@ msgid "" "to those handlers, as normal." msgstr "" -#: howto/logging.rst:832 +#: howto/logging.rst:834 msgid "" "A do-nothing handler is included in the logging package: :class:`~logging." "NullHandler` (since Python 3.1). An instance of this handler could be added " @@ -1217,20 +1217,20 @@ msgid "" "etc. then the code::" msgstr "" -#: howto/logging.rst:840 +#: howto/logging.rst:842 msgid "" "import logging\n" "logging.getLogger('foo').addHandler(logging.NullHandler())" msgstr "" -#: howto/logging.rst:843 +#: howto/logging.rst:845 msgid "" "should have the desired effect. If an organisation produces a number of " "libraries, then the logger name specified can be 'orgname.foo' rather than " "just 'foo'." msgstr "" -#: howto/logging.rst:847 +#: howto/logging.rst:849 msgid "" "It is strongly advised that you *do not log to the root logger* in your " "library. Instead, use a logger with a unique and easily identifiable name, " @@ -1240,7 +1240,7 @@ msgid "" "library as they wish." msgstr "" -#: howto/logging.rst:854 +#: howto/logging.rst:856 msgid "" "It is strongly advised that you *do not add any handlers other than* :class:" "`~logging.NullHandler` *to your library's loggers*. This is because the " @@ -1251,11 +1251,11 @@ msgid "" "carry out unit tests and deliver logs which suit their requirements." msgstr "" -#: howto/logging.rst:865 +#: howto/logging.rst:867 msgid "Logging Levels" msgstr "" -#: howto/logging.rst:867 +#: howto/logging.rst:869 msgid "" "The numeric values of logging levels are given in the following table. These " "are primarily of interest if you want to define your own levels, and need " @@ -1264,39 +1264,39 @@ msgid "" "value; the predefined name is lost." msgstr "" -#: howto/logging.rst:874 +#: howto/logging.rst:876 msgid "Numeric value" msgstr "" -#: howto/logging.rst:876 +#: howto/logging.rst:878 msgid "50" msgstr "" -#: howto/logging.rst:878 +#: howto/logging.rst:880 msgid "40" msgstr "" -#: howto/logging.rst:880 +#: howto/logging.rst:882 msgid "30" msgstr "" -#: howto/logging.rst:882 +#: howto/logging.rst:884 msgid "20" msgstr "" -#: howto/logging.rst:884 +#: howto/logging.rst:886 msgid "10" msgstr "" -#: howto/logging.rst:886 +#: howto/logging.rst:888 msgid "``NOTSET``" msgstr "" -#: howto/logging.rst:886 +#: howto/logging.rst:888 msgid "0" msgstr "" -#: howto/logging.rst:889 +#: howto/logging.rst:891 msgid "" "Levels can also be associated with loggers, being set either by the " "developer or through loading a saved logging configuration. When a logging " @@ -1306,14 +1306,14 @@ msgid "" "basic mechanism controlling the verbosity of logging output." msgstr "" -#: howto/logging.rst:896 +#: howto/logging.rst:898 msgid "" "Logging messages are encoded as instances of the :class:`~logging.LogRecord` " "class. When a logger decides to actually log an event, a :class:`~logging." "LogRecord` instance is created from the logging message." msgstr "" -#: howto/logging.rst:900 +#: howto/logging.rst:902 msgid "" "Logging messages are subjected to a dispatch mechanism through the use of :" "dfn:`handlers`, which are instances of subclasses of the :class:`Handler` " @@ -1330,7 +1330,7 @@ msgid "" "at which point the passing to ancestor handlers stops)." msgstr "" -#: howto/logging.rst:914 +#: howto/logging.rst:916 msgid "" "Just as for loggers, handlers can have levels associated with them. A " "handler's level acts as a filter in the same way as a logger's level does. " @@ -1340,11 +1340,11 @@ msgid "" "`~Handler.emit`." msgstr "" -#: howto/logging.rst:923 +#: howto/logging.rst:925 msgid "Custom Levels" msgstr "" -#: howto/logging.rst:925 +#: howto/logging.rst:927 msgid "" "Defining your own levels is possible, but should not be necessary, as the " "existing levels have been chosen on the basis of practical experience. " @@ -1357,27 +1357,27 @@ msgid "" "given numeric value might mean different things for different libraries." msgstr "" -#: howto/logging.rst:938 +#: howto/logging.rst:940 msgid "Useful Handlers" msgstr "" -#: howto/logging.rst:940 +#: howto/logging.rst:942 msgid "" "In addition to the base :class:`Handler` class, many useful subclasses are " "provided:" msgstr "" -#: howto/logging.rst:943 +#: howto/logging.rst:945 msgid "" ":class:`StreamHandler` instances send messages to streams (file-like " "objects)." msgstr "" -#: howto/logging.rst:946 +#: howto/logging.rst:948 msgid ":class:`FileHandler` instances send messages to disk files." msgstr "" -#: howto/logging.rst:948 +#: howto/logging.rst:950 msgid "" ":class:`~handlers.BaseRotatingHandler` is the base class for handlers that " "rotate log files at a certain point. It is not meant to be instantiated " @@ -1385,61 +1385,61 @@ msgid "" "`~handlers.TimedRotatingFileHandler`." msgstr "" -#: howto/logging.rst:953 +#: howto/logging.rst:955 msgid "" ":class:`~handlers.RotatingFileHandler` instances send messages to disk " "files, with support for maximum log file sizes and log file rotation." msgstr "" -#: howto/logging.rst:956 +#: howto/logging.rst:958 msgid "" ":class:`~handlers.TimedRotatingFileHandler` instances send messages to disk " "files, rotating the log file at certain timed intervals." msgstr "" -#: howto/logging.rst:959 +#: howto/logging.rst:961 msgid "" ":class:`~handlers.SocketHandler` instances send messages to TCP/IP sockets. " "Since 3.4, Unix domain sockets are also supported." msgstr "" -#: howto/logging.rst:962 +#: howto/logging.rst:964 msgid "" ":class:`~handlers.DatagramHandler` instances send messages to UDP sockets. " "Since 3.4, Unix domain sockets are also supported." msgstr "" -#: howto/logging.rst:965 +#: howto/logging.rst:967 msgid "" ":class:`~handlers.SMTPHandler` instances send messages to a designated email " "address." msgstr "" -#: howto/logging.rst:968 +#: howto/logging.rst:970 msgid "" ":class:`~handlers.SysLogHandler` instances send messages to a Unix syslog " "daemon, possibly on a remote machine." msgstr "" -#: howto/logging.rst:971 +#: howto/logging.rst:973 msgid "" ":class:`~handlers.NTEventLogHandler` instances send messages to a Windows " "NT/2000/XP event log." msgstr "" -#: howto/logging.rst:974 +#: howto/logging.rst:976 msgid "" ":class:`~handlers.MemoryHandler` instances send messages to a buffer in " "memory, which is flushed whenever specific criteria are met." msgstr "" -#: howto/logging.rst:977 +#: howto/logging.rst:979 msgid "" ":class:`~handlers.HTTPHandler` instances send messages to an HTTP server " "using either ``GET`` or ``POST`` semantics." msgstr "" -#: howto/logging.rst:980 +#: howto/logging.rst:982 msgid "" ":class:`~handlers.WatchedFileHandler` instances watch the file they are " "logging to. If the file changes, it is closed and reopened using the file " @@ -1447,13 +1447,13 @@ msgid "" "support the underlying mechanism used." msgstr "" -#: howto/logging.rst:985 +#: howto/logging.rst:987 msgid "" ":class:`~handlers.QueueHandler` instances send messages to a queue, such as " "those implemented in the :mod:`queue` or :mod:`multiprocessing` modules." msgstr "" -#: howto/logging.rst:988 +#: howto/logging.rst:990 msgid "" ":class:`NullHandler` instances do nothing with error messages. They are used " "by library developers who want to use logging, but want to avoid the 'No " @@ -1462,15 +1462,15 @@ msgid "" "more information." msgstr "" -#: howto/logging.rst:994 +#: howto/logging.rst:996 msgid "The :class:`NullHandler` class." msgstr "" -#: howto/logging.rst:997 +#: howto/logging.rst:999 msgid "The :class:`~handlers.QueueHandler` class." msgstr "" -#: howto/logging.rst:1000 +#: howto/logging.rst:1002 msgid "" "The :class:`NullHandler`, :class:`StreamHandler` and :class:`FileHandler` " "classes are defined in the core logging package. The other handlers are " @@ -1478,14 +1478,14 @@ msgid "" "module, :mod:`logging.config`, for configuration functionality.)" msgstr "" -#: howto/logging.rst:1005 +#: howto/logging.rst:1007 msgid "" "Logged messages are formatted for presentation through instances of the :" "class:`Formatter` class. They are initialized with a format string suitable " "for use with the % operator and a dictionary." msgstr "" -#: howto/logging.rst:1009 +#: howto/logging.rst:1011 msgid "" "For formatting multiple messages in a batch, instances of :class:" "`BufferingFormatter` can be used. In addition to the format string (which is " @@ -1493,7 +1493,7 @@ msgid "" "trailer format strings." msgstr "" -#: howto/logging.rst:1014 +#: howto/logging.rst:1016 msgid "" "When filtering based on logger level and/or handler level is not enough, " "instances of :class:`Filter` can be added to both :class:`Logger` and :class:" @@ -1503,18 +1503,18 @@ msgid "" "value, the message is not processed further." msgstr "" -#: howto/logging.rst:1021 +#: howto/logging.rst:1023 msgid "" "The basic :class:`Filter` functionality allows filtering by specific logger " "name. If this feature is used, messages sent to the named logger and its " "children are allowed through the filter, and all others dropped." msgstr "" -#: howto/logging.rst:1029 +#: howto/logging.rst:1031 msgid "Exceptions raised during logging" msgstr "" -#: howto/logging.rst:1031 +#: howto/logging.rst:1033 msgid "" "The logging package is designed to swallow exceptions which occur while " "logging in production. This is so that errors which occur while handling " @@ -1522,7 +1522,7 @@ msgid "" "errors - do not cause the application using logging to terminate prematurely." msgstr "" -#: howto/logging.rst:1036 +#: howto/logging.rst:1038 msgid "" ":class:`SystemExit` and :class:`KeyboardInterrupt` exceptions are never " "swallowed. Other exceptions which occur during the :meth:`~Handler.emit` " @@ -1530,7 +1530,7 @@ msgid "" "handleError` method." msgstr "" -#: howto/logging.rst:1041 +#: howto/logging.rst:1043 msgid "" "The default implementation of :meth:`~Handler.handleError` in :class:" "`Handler` checks to see if a module-level variable, :data:`raiseExceptions`, " @@ -1538,7 +1538,7 @@ msgid "" "the exception is swallowed." msgstr "" -#: howto/logging.rst:1047 +#: howto/logging.rst:1049 msgid "" "The default value of :data:`raiseExceptions` is ``True``. This is because " "during development, you typically want to be notified of any exceptions that " @@ -1546,11 +1546,11 @@ msgid "" "production usage." msgstr "" -#: howto/logging.rst:1057 +#: howto/logging.rst:1059 msgid "Using arbitrary objects as messages" msgstr "" -#: howto/logging.rst:1059 +#: howto/logging.rst:1061 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 " @@ -1562,11 +1562,11 @@ msgid "" "the wire." msgstr "" -#: howto/logging.rst:1070 +#: howto/logging.rst:1072 msgid "Optimization" msgstr "" -#: howto/logging.rst:1072 +#: howto/logging.rst:1074 msgid "" "Formatting of message arguments is deferred until it cannot be avoided. " "However, computing the arguments passed to the logging method can also be " @@ -1577,20 +1577,20 @@ msgid "" "code like this::" msgstr "" -#: howto/logging.rst:1080 +#: howto/logging.rst:1082 msgid "" "if logger.isEnabledFor(logging.DEBUG):\n" " logger.debug('Message with %s, %s', expensive_func1(),\n" " expensive_func2())" msgstr "" -#: howto/logging.rst:1084 +#: howto/logging.rst:1086 msgid "" "so that if the logger's threshold is set above ``DEBUG``, the calls to " "``expensive_func1`` and ``expensive_func2`` are never made." msgstr "" -#: howto/logging.rst:1087 +#: howto/logging.rst:1089 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 " @@ -1602,7 +1602,7 @@ msgid "" "while the application is running (which is not all that common)." msgstr "" -#: howto/logging.rst:1096 +#: howto/logging.rst:1098 msgid "" "There are other optimizations which can be made for specific applications " "which need more precise control over what logging information is collected. " @@ -1610,94 +1610,94 @@ msgid "" "you don't need:" msgstr "" -#: howto/logging.rst:1102 +#: howto/logging.rst:1104 msgid "What you don't want to collect" msgstr "" -#: howto/logging.rst:1102 +#: howto/logging.rst:1104 msgid "How to avoid collecting it" msgstr "" -#: howto/logging.rst:1104 +#: howto/logging.rst:1106 msgid "Information about where calls were made from." msgstr "" -#: howto/logging.rst:1104 +#: howto/logging.rst:1106 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:1110 +#: howto/logging.rst:1112 msgid "Threading information." msgstr "" -#: howto/logging.rst:1110 +#: howto/logging.rst:1112 msgid "Set ``logging.logThreads`` to ``False``." msgstr "" -#: howto/logging.rst:1112 +#: howto/logging.rst:1114 msgid "Current process ID (:func:`os.getpid`)" msgstr "" -#: howto/logging.rst:1112 +#: howto/logging.rst:1114 msgid "Set ``logging.logProcesses`` to ``False``." msgstr "" -#: howto/logging.rst:1114 +#: howto/logging.rst:1116 msgid "" "Current process name when using ``multiprocessing`` to manage multiple " "processes." msgstr "" -#: howto/logging.rst:1114 +#: howto/logging.rst:1116 msgid "Set ``logging.logMultiprocessing`` to ``False``." msgstr "" -#: howto/logging.rst:1117 +#: howto/logging.rst:1119 msgid "Current :class:`asyncio.Task` name when using ``asyncio``." msgstr "" -#: howto/logging.rst:1117 +#: howto/logging.rst:1119 msgid "Set ``logging.logAsyncioTasks`` to ``False``." msgstr "" -#: howto/logging.rst:1121 +#: howto/logging.rst:1123 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:1128 +#: howto/logging.rst:1130 msgid "Other resources" msgstr "" -#: howto/logging.rst:1132 +#: howto/logging.rst:1134 msgid "Module :mod:`logging`" msgstr "" -#: howto/logging.rst:1133 +#: howto/logging.rst:1135 msgid "API reference for the logging module." msgstr "" -#: howto/logging.rst:1135 +#: howto/logging.rst:1137 msgid "Module :mod:`logging.config`" msgstr "" -#: howto/logging.rst:1136 +#: howto/logging.rst:1138 msgid "Configuration API for the logging module." msgstr "" -#: howto/logging.rst:1138 +#: howto/logging.rst:1140 msgid "Module :mod:`logging.handlers`" msgstr "" -#: howto/logging.rst:1139 +#: howto/logging.rst:1141 msgid "Useful handlers included with the logging module." msgstr "" -#: howto/logging.rst:1141 +#: howto/logging.rst:1143 msgid ":ref:`A logging cookbook `" msgstr "" diff --git a/library/argparse.po b/library/argparse.po index 970fe6452..c5842cd75 100644 --- a/library/argparse.po +++ b/library/argparse.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1090,14 +1090,16 @@ msgstr "" msgid "" "The recommended way to create a custom action is to extend :class:`Action`, " "overriding the :meth:`!__call__` method and optionally the :meth:`!__init__` " -"and :meth:`!format_usage` methods." +"and :meth:`!format_usage` methods. You can also register custom actions " +"using the :meth:`~ArgumentParser.register` method and reference them by " +"their registered name." msgstr "" -#: library/argparse.rst:755 +#: library/argparse.rst:756 msgid "An example of a custom action::" msgstr "" -#: library/argparse.rst:757 +#: library/argparse.rst:758 msgid "" ">>> class FooAction(argparse.Action):\n" "... def __init__(self, option_strings, dest, nargs=None, **kwargs):\n" @@ -1118,15 +1120,15 @@ msgid "" "Namespace(bar='1', foo='2')" msgstr "" -#: library/argparse.rst:775 +#: library/argparse.rst:776 msgid "For more details, see :class:`Action`." msgstr "" -#: library/argparse.rst:781 +#: library/argparse.rst:782 msgid "nargs" msgstr "" -#: library/argparse.rst:783 +#: library/argparse.rst:784 msgid "" ":class:`ArgumentParser` objects usually associate a single command-line " "argument with a single action to be taken. The ``nargs`` keyword argument " @@ -1135,13 +1137,13 @@ msgid "" "are:" msgstr "" -#: library/argparse.rst:788 +#: library/argparse.rst:789 msgid "" "``N`` (an integer). ``N`` arguments from the command line will be gathered " "together into a list. For example::" msgstr "" -#: library/argparse.rst:791 +#: library/argparse.rst:792 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo', nargs=2)\n" @@ -1150,13 +1152,13 @@ msgid "" "Namespace(bar=['c'], foo=['a', 'b'])" msgstr "" -#: library/argparse.rst:797 +#: library/argparse.rst:798 msgid "" "Note that ``nargs=1`` produces a list of one item. This is different from " "the default, in which the item is produced by itself." msgstr "" -#: library/argparse.rst:802 +#: library/argparse.rst:803 msgid "" "``'?'``. One argument will be consumed from the command line if possible, " "and produced as a single item. If no command-line argument is present, the " @@ -1166,7 +1168,7 @@ msgid "" "produced. Some examples to illustrate this::" msgstr "" -#: library/argparse.rst:809 +#: library/argparse.rst:810 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo', nargs='?', const='c', default='d')\n" @@ -1179,13 +1181,13 @@ msgid "" "Namespace(bar='d', foo='d')" msgstr "" -#: library/argparse.rst:819 +#: library/argparse.rst:820 msgid "" "One of the more common uses of ``nargs='?'`` is to allow optional input and " "output files::" msgstr "" -#: library/argparse.rst:822 +#: library/argparse.rst:823 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('infile', nargs='?', type=argparse.FileType('r'),\n" @@ -1200,7 +1202,7 @@ msgid "" " outfile=<_io.TextIOWrapper name='' encoding='UTF-8'>)" msgstr "" -#: library/argparse.rst:836 +#: library/argparse.rst:837 msgid "" "``'*'``. All command-line arguments present are gathered into a list. Note " "that it generally doesn't make much sense to have more than one positional " @@ -1208,7 +1210,7 @@ msgid "" "``nargs='*'`` is possible. For example::" msgstr "" -#: library/argparse.rst:841 +#: library/argparse.rst:842 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo', nargs='*')\n" @@ -1218,14 +1220,14 @@ msgid "" "Namespace(bar=['1', '2'], baz=['a', 'b'], foo=['x', 'y'])" msgstr "" -#: library/argparse.rst:850 +#: library/argparse.rst:851 msgid "" "``'+'``. Just like ``'*'``, all command-line args present are gathered into " "a list. Additionally, an error message will be generated if there wasn't at " "least one command-line argument present. For example::" msgstr "" -#: library/argparse.rst:854 +#: library/argparse.rst:855 msgid "" ">>> parser = argparse.ArgumentParser(prog='PROG')\n" ">>> parser.add_argument('foo', nargs='+')\n" @@ -1236,7 +1238,7 @@ msgid "" "PROG: error: the following arguments are required: foo" msgstr "" -#: library/argparse.rst:862 +#: library/argparse.rst:863 msgid "" "If the ``nargs`` keyword argument is not provided, the number of arguments " "consumed is determined by the action_. Generally this means a single " @@ -1245,11 +1247,11 @@ msgid "" "``'store_const'``) set ``nargs=0``." msgstr "" -#: library/argparse.rst:872 +#: library/argparse.rst:873 msgid "const" msgstr "" -#: library/argparse.rst:874 +#: library/argparse.rst:875 msgid "" "The ``const`` argument of :meth:`~ArgumentParser.add_argument` is used to " "hold constant values that are not read from the command line but are " @@ -1257,7 +1259,7 @@ msgid "" "common uses of it are:" msgstr "" -#: library/argparse.rst:878 +#: library/argparse.rst:879 msgid "" "When :meth:`~ArgumentParser.add_argument` is called with " "``action='store_const'`` or ``action='append_const'``. These actions add " @@ -1267,7 +1269,7 @@ msgid "" "receive a default value of ``None``." msgstr "" -#: library/argparse.rst:886 +#: library/argparse.rst:887 msgid "" "When :meth:`~ArgumentParser.add_argument` is called with option strings " "(like ``-f`` or ``--foo``) and ``nargs='?'``. This creates an optional " @@ -1277,17 +1279,17 @@ msgid "" "to be ``None`` instead. See the nargs_ description for examples." msgstr "" -#: library/argparse.rst:893 +#: library/argparse.rst:894 msgid "" "``const=None`` by default, including when ``action='append_const'`` or " "``action='store_const'``." msgstr "" -#: library/argparse.rst:900 +#: library/argparse.rst:901 msgid "default" msgstr "" -#: library/argparse.rst:902 +#: library/argparse.rst:903 msgid "" "All optional arguments and some positional arguments may be omitted at the " "command line. The ``default`` keyword argument of :meth:`~ArgumentParser." @@ -1297,7 +1299,7 @@ msgid "" "command line::" msgstr "" -#: library/argparse.rst:909 +#: library/argparse.rst:910 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo', default=42)\n" @@ -1307,13 +1309,13 @@ msgid "" "Namespace(foo=42)" msgstr "" -#: library/argparse.rst:916 +#: library/argparse.rst:917 msgid "" "If the target namespace already has an attribute set, the action *default* " "will not overwrite it::" msgstr "" -#: library/argparse.rst:919 +#: library/argparse.rst:920 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo', default=42)\n" @@ -1321,7 +1323,7 @@ msgid "" "Namespace(foo=101)" msgstr "" -#: library/argparse.rst:924 +#: library/argparse.rst:925 msgid "" "If the ``default`` value is a string, the parser parses the value as if it " "were a command-line argument. In particular, the parser applies any type_ " @@ -1329,7 +1331,7 @@ msgid "" "`Namespace` return value. Otherwise, the parser uses the value as is::" msgstr "" -#: library/argparse.rst:929 +#: library/argparse.rst:930 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--length', default='10', type=int)\n" @@ -1338,13 +1340,13 @@ msgid "" "Namespace(length=10, width=10.5)" msgstr "" -#: library/argparse.rst:935 +#: library/argparse.rst:936 msgid "" "For positional arguments with nargs_ equal to ``?`` or ``*``, the " "``default`` value is used when no command-line argument was present::" msgstr "" -#: library/argparse.rst:938 +#: library/argparse.rst:939 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('foo', nargs='?', default=42)\n" @@ -1354,20 +1356,20 @@ msgid "" "Namespace(foo=42)" msgstr "" -#: library/argparse.rst:945 +#: library/argparse.rst:946 msgid "" "For required_ arguments, the ``default`` value is ignored. For example, this " "applies to positional arguments with nargs_ values other than ``?`` or " "``*``, or optional arguments marked as ``required=True``." msgstr "" -#: library/argparse.rst:949 +#: library/argparse.rst:950 msgid "" "Providing ``default=argparse.SUPPRESS`` causes no attribute to be added if " "the command-line argument was not present::" msgstr "" -#: library/argparse.rst:952 +#: library/argparse.rst:953 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo', default=argparse.SUPPRESS)\n" @@ -1377,11 +1379,11 @@ msgid "" "Namespace(foo='1')" msgstr "" -#: library/argparse.rst:963 +#: library/argparse.rst:964 msgid "type" msgstr "" -#: library/argparse.rst:965 +#: library/argparse.rst:966 msgid "" "By default, the parser reads command-line arguments in as simple strings. " "However, quite often the command-line string should instead be interpreted " @@ -1390,25 +1392,26 @@ msgid "" "checking and type conversions to be performed." msgstr "" -#: library/argparse.rst:971 +#: library/argparse.rst:972 msgid "" "If the type_ keyword is used with the default_ keyword, the type converter " "is only applied if the default is a string." msgstr "" -#: library/argparse.rst:974 +#: library/argparse.rst:975 msgid "" -"The argument to ``type`` can be any callable that accepts a single string. " -"If the function raises :exc:`ArgumentTypeError`, :exc:`TypeError`, or :exc:" +"The argument to ``type`` can be a callable that accepts a single string or " +"the name of a registered type (see :meth:`~ArgumentParser.register`) If the " +"function raises :exc:`ArgumentTypeError`, :exc:`TypeError`, or :exc:" "`ValueError`, the exception is caught and a nicely formatted error message " -"is displayed. No other exception types are handled." +"is displayed. Other exception types are not handled." msgstr "" -#: library/argparse.rst:979 +#: library/argparse.rst:981 msgid "Common built-in types and functions can be used as type converters:" msgstr "" -#: library/argparse.rst:981 +#: library/argparse.rst:983 msgid "" "import argparse\n" "import pathlib\n" @@ -1423,11 +1426,11 @@ msgid "" "parser.add_argument('datapath', type=pathlib.Path)" msgstr "" -#: library/argparse.rst:994 +#: library/argparse.rst:996 msgid "User defined functions can be used as well:" msgstr "" -#: library/argparse.rst:996 +#: library/argparse.rst:998 msgid "" ">>> def hyphenated(string):\n" "... return '-'.join([word[:4] for word in string.casefold().split()])\n" @@ -1438,14 +1441,14 @@ msgid "" "Namespace(short_title='\"the-tale-of-two-citi')" msgstr "" -#: library/argparse.rst:1006 +#: library/argparse.rst:1008 msgid "" "The :func:`bool` function is not recommended as a type converter. All it " "does is convert empty strings to ``False`` and non-empty strings to " "``True``. This is usually not what is desired." msgstr "" -#: library/argparse.rst:1010 +#: library/argparse.rst:1012 msgid "" "In general, the ``type`` keyword is a convenience that should only be used " "for simple conversions that can only raise one of the three supported " @@ -1453,7 +1456,7 @@ msgid "" "management should be done downstream after the arguments are parsed." msgstr "" -#: library/argparse.rst:1015 +#: library/argparse.rst:1017 msgid "" "For example, JSON or YAML conversions have complex error cases that require " "better reporting than can be given by the ``type`` keyword. A :exc:`~json." @@ -1461,7 +1464,7 @@ msgid "" "exception would not be handled at all." msgstr "" -#: library/argparse.rst:1020 +#: library/argparse.rst:1022 msgid "" "Even :class:`~argparse.FileType` has its limitations for use with the " "``type`` keyword. If one argument uses :class:`~argparse.FileType` and then " @@ -1471,17 +1474,17 @@ msgid "" "files." msgstr "" -#: library/argparse.rst:1027 +#: library/argparse.rst:1029 msgid "" "For type checkers that simply check against a fixed set of values, consider " "using the choices_ keyword instead." msgstr "" -#: library/argparse.rst:1034 +#: library/argparse.rst:1036 msgid "choices" msgstr "" -#: library/argparse.rst:1036 +#: library/argparse.rst:1038 msgid "" "Some command-line arguments should be selected from a restricted set of " "values. These can be handled by passing a sequence object as the *choices* " @@ -1490,7 +1493,7 @@ msgid "" "be displayed if the argument was not one of the acceptable values::" msgstr "" -#: library/argparse.rst:1042 +#: library/argparse.rst:1044 msgid "" ">>> parser = argparse.ArgumentParser(prog='game.py')\n" ">>> parser.add_argument('move', choices=['rock', 'paper', 'scissors'])\n" @@ -1502,26 +1505,26 @@ msgid "" "'paper', 'scissors')" msgstr "" -#: library/argparse.rst:1051 +#: library/argparse.rst:1053 msgid "" "Note that inclusion in the *choices* sequence is checked after any type_ " "conversions have been performed, so the type of the objects in the *choices* " "sequence should match the type_ specified." msgstr "" -#: library/argparse.rst:1055 +#: library/argparse.rst:1057 msgid "" "Any sequence can be passed as the *choices* value, so :class:`list` " "objects, :class:`tuple` objects, and custom sequences are all supported." msgstr "" -#: library/argparse.rst:1058 +#: library/argparse.rst:1060 msgid "" "Use of :class:`enum.Enum` is not recommended because it is difficult to " "control its appearance in usage, help, and error messages." msgstr "" -#: library/argparse.rst:1061 +#: library/argparse.rst:1063 msgid "" "Formatted choices override the default *metavar* which is normally derived " "from *dest*. This is usually what you want because the user never sees the " @@ -1529,11 +1532,11 @@ msgid "" "are many choices), just specify an explicit metavar_." msgstr "" -#: library/argparse.rst:1070 +#: library/argparse.rst:1072 msgid "required" msgstr "" -#: library/argparse.rst:1072 +#: library/argparse.rst:1074 msgid "" "In general, the :mod:`!argparse` module assumes that flags like ``-f`` and " "``--bar`` indicate *optional* arguments, which can always be omitted at the " @@ -1541,7 +1544,7 @@ msgid "" "the ``required=`` keyword argument to :meth:`~ArgumentParser.add_argument`::" msgstr "" -#: library/argparse.rst:1077 +#: library/argparse.rst:1079 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo', required=True)\n" @@ -1552,24 +1555,24 @@ msgid "" ": error: the following arguments are required: --foo" msgstr "" -#: library/argparse.rst:1085 +#: library/argparse.rst:1087 msgid "" "As the example shows, if an option is marked as ``required``, :meth:" "`~ArgumentParser.parse_args` will report an error if that option is not " "present at the command line." msgstr "" -#: library/argparse.rst:1091 +#: library/argparse.rst:1093 msgid "" "Required options are generally considered bad form because users expect " "*options* to be *optional*, and thus they should be avoided when possible." msgstr "" -#: library/argparse.rst:1098 +#: library/argparse.rst:1100 msgid "help" msgstr "" -#: library/argparse.rst:1100 +#: library/argparse.rst:1102 msgid "" "The ``help`` value is a string containing a brief description of the " "argument. When a user requests help (usually by using ``-h`` or ``--help`` " @@ -1577,7 +1580,7 @@ msgid "" "each argument." msgstr "" -#: library/argparse.rst:1105 +#: library/argparse.rst:1107 msgid "" "The ``help`` strings can include various format specifiers to avoid " "repetition of things like the program name or the argument default_. The " @@ -1586,7 +1589,7 @@ msgid "" "``%(type)s``, etc.::" msgstr "" -#: library/argparse.rst:1110 +#: library/argparse.rst:1112 msgid "" ">>> parser = argparse.ArgumentParser(prog='frobble')\n" ">>> parser.add_argument('bar', nargs='?', type=int, default=42,\n" @@ -1601,19 +1604,19 @@ msgid "" " -h, --help show this help message and exit" msgstr "" -#: library/argparse.rst:1122 +#: library/argparse.rst:1124 msgid "" "As the help string supports %-formatting, if you want a literal ``%`` to " "appear in the help string, you must escape it as ``%%``." msgstr "" -#: library/argparse.rst:1125 +#: library/argparse.rst:1127 msgid "" ":mod:`!argparse` supports silencing the help entry for certain options, by " "setting the ``help`` value to ``argparse.SUPPRESS``::" msgstr "" -#: library/argparse.rst:1128 +#: library/argparse.rst:1130 msgid "" ">>> parser = argparse.ArgumentParser(prog='frobble')\n" ">>> parser.add_argument('--foo', help=argparse.SUPPRESS)\n" @@ -1624,11 +1627,11 @@ msgid "" " -h, --help show this help message and exit" msgstr "" -#: library/argparse.rst:1140 +#: library/argparse.rst:1142 msgid "metavar" msgstr "" -#: library/argparse.rst:1142 +#: library/argparse.rst:1144 msgid "" "When :class:`ArgumentParser` generates help messages, it needs some way to " "refer to each expected argument. By default, :class:`!ArgumentParser` " @@ -1640,7 +1643,7 @@ msgid "" "command-line argument will be referred to as ``FOO``. An example::" msgstr "" -#: library/argparse.rst:1151 +#: library/argparse.rst:1153 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo')\n" @@ -1658,11 +1661,11 @@ msgid "" " --foo FOO" msgstr "" -#: library/argparse.rst:1166 +#: library/argparse.rst:1168 msgid "An alternative name can be specified with ``metavar``::" msgstr "" -#: library/argparse.rst:1168 +#: library/argparse.rst:1170 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo', metavar='YYY')\n" @@ -1680,21 +1683,21 @@ msgid "" " --foo YYY" msgstr "" -#: library/argparse.rst:1183 +#: library/argparse.rst:1185 msgid "" "Note that ``metavar`` only changes the *displayed* name - the name of the " "attribute on the :meth:`~ArgumentParser.parse_args` object is still " "determined by the dest_ value." msgstr "" -#: library/argparse.rst:1187 +#: library/argparse.rst:1189 msgid "" "Different values of ``nargs`` may cause the metavar to be used multiple " "times. Providing a tuple to ``metavar`` specifies a different display for " "each of the arguments::" msgstr "" -#: library/argparse.rst:1191 +#: library/argparse.rst:1193 msgid "" ">>> parser = argparse.ArgumentParser(prog='PROG')\n" ">>> parser.add_argument('-x', nargs=2)\n" @@ -1708,11 +1711,11 @@ msgid "" " --foo bar baz" msgstr "" -#: library/argparse.rst:1206 +#: library/argparse.rst:1208 msgid "dest" msgstr "" -#: library/argparse.rst:1208 +#: library/argparse.rst:1210 msgid "" "Most :class:`ArgumentParser` actions add some value as an attribute of the " "object returned by :meth:`~ArgumentParser.parse_args`. The name of this " @@ -1722,7 +1725,7 @@ msgid "" "add_argument`::" msgstr "" -#: library/argparse.rst:1215 +#: library/argparse.rst:1217 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('bar')\n" @@ -1730,7 +1733,7 @@ msgid "" "Namespace(bar='XXX')" msgstr "" -#: library/argparse.rst:1220 +#: library/argparse.rst:1222 msgid "" "For optional argument actions, the value of ``dest`` is normally inferred " "from the option strings. :class:`ArgumentParser` generates the value of " @@ -1742,7 +1745,7 @@ msgid "" "below illustrate this behavior::" msgstr "" -#: library/argparse.rst:1229 +#: library/argparse.rst:1231 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('-f', '--foo-bar', '--foo')\n" @@ -1753,11 +1756,11 @@ msgid "" "Namespace(foo_bar='1', x='2')" msgstr "" -#: library/argparse.rst:1237 +#: library/argparse.rst:1239 msgid "``dest`` allows a custom attribute name to be provided::" msgstr "" -#: library/argparse.rst:1239 +#: library/argparse.rst:1241 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo', dest='bar')\n" @@ -1765,11 +1768,11 @@ msgid "" "Namespace(bar='XXX')" msgstr "" -#: library/argparse.rst:1245 +#: library/argparse.rst:1247 msgid "Action classes" msgstr "" -#: library/argparse.rst:1247 +#: library/argparse.rst:1249 msgid "" ":class:`!Action` classes implement the Action API, a callable which returns " "a callable which processes arguments from the command-line. Any object which " @@ -1777,7 +1780,7 @@ msgid "" "`~ArgumentParser.add_argument`." msgstr "" -#: library/argparse.rst:1256 +#: library/argparse.rst:1258 msgid "" ":class:`!Action` objects are used by an :class:`ArgumentParser` to represent " "the information needed to parse a single argument from one or more strings " @@ -1786,7 +1789,7 @@ msgid "" "`ArgumentParser.add_argument` except for the ``action`` itself." msgstr "" -#: library/argparse.rst:1262 +#: library/argparse.rst:1264 msgid "" "Instances of :class:`!Action` (or return value of any callable to the " "``action`` parameter) should have attributes :attr:`!dest`, :attr:`!" @@ -1795,46 +1798,46 @@ msgid "" "is to call :meth:`!Action.__init__`." msgstr "" -#: library/argparse.rst:1270 +#: library/argparse.rst:1272 msgid "" ":class:`!Action` instances should be callable, so subclasses must override " "the :meth:`!__call__` method, which should accept four parameters:" msgstr "" -#: library/argparse.rst:1273 +#: library/argparse.rst:1275 msgid "" "*parser* - The :class:`ArgumentParser` object which contains this action." msgstr "" -#: library/argparse.rst:1275 +#: library/argparse.rst:1277 msgid "" "*namespace* - The :class:`Namespace` object that will be returned by :meth:" "`~ArgumentParser.parse_args`. Most actions add an attribute to this object " "using :func:`setattr`." msgstr "" -#: library/argparse.rst:1279 +#: library/argparse.rst:1281 msgid "" "*values* - The associated command-line arguments, with any type conversions " "applied. Type conversions are specified with the type_ keyword argument to :" "meth:`~ArgumentParser.add_argument`." msgstr "" -#: library/argparse.rst:1283 +#: library/argparse.rst:1285 msgid "" "*option_string* - The option string that was used to invoke this action. The " "``option_string`` argument is optional, and will be absent if the action is " "associated with a positional argument." msgstr "" -#: library/argparse.rst:1287 +#: library/argparse.rst:1289 msgid "" "The :meth:`!__call__` method may perform arbitrary actions, but will " "typically set attributes on the ``namespace`` based on ``dest`` and " "``values``." msgstr "" -#: library/argparse.rst:1292 +#: library/argparse.rst:1294 msgid "" ":class:`!Action` subclasses can define a :meth:`!format_usage` method that " "takes no argument and return a string which will be used when printing the " @@ -1842,47 +1845,47 @@ msgid "" "will be used." msgstr "" -#: library/argparse.rst:1298 +#: library/argparse.rst:1300 msgid "The parse_args() method" msgstr "" -#: library/argparse.rst:1302 +#: library/argparse.rst:1304 msgid "" "Convert argument strings to objects and assign them as attributes of the " "namespace. Return the populated namespace." msgstr "" -#: library/argparse.rst:1305 +#: library/argparse.rst:1307 msgid "" "Previous calls to :meth:`add_argument` determine exactly what objects are " "created and how they are assigned. See the documentation for :meth:`!" "add_argument` for details." msgstr "" -#: library/argparse.rst:1309 +#: library/argparse.rst:1311 msgid "" "args_ - List of strings to parse. The default is taken from :data:`sys." "argv`." msgstr "" -#: library/argparse.rst:1312 +#: library/argparse.rst:1314 msgid "" "namespace_ - An object to take the attributes. The default is a new empty :" "class:`Namespace` object." msgstr "" -#: library/argparse.rst:1317 +#: library/argparse.rst:1319 msgid "Option value syntax" msgstr "" -#: library/argparse.rst:1319 +#: library/argparse.rst:1321 msgid "" "The :meth:`~ArgumentParser.parse_args` method supports several ways of " "specifying the value of an option (if it takes one). In the simplest case, " "the option and its value are passed as two separate arguments::" msgstr "" -#: library/argparse.rst:1323 +#: library/argparse.rst:1325 msgid "" ">>> parser = argparse.ArgumentParser(prog='PROG')\n" ">>> parser.add_argument('-x')\n" @@ -1893,38 +1896,38 @@ msgid "" "Namespace(foo='FOO', x=None)" msgstr "" -#: library/argparse.rst:1331 +#: library/argparse.rst:1333 msgid "" "For long options (options with names longer than a single character), the " "option and value can also be passed as a single command-line argument, using " "``=`` to separate them::" msgstr "" -#: library/argparse.rst:1335 +#: library/argparse.rst:1337 msgid "" ">>> parser.parse_args(['--foo=FOO'])\n" "Namespace(foo='FOO', x=None)" msgstr "" -#: library/argparse.rst:1338 +#: library/argparse.rst:1340 msgid "" "For short options (options only one character long), the option and its " "value can be concatenated::" msgstr "" -#: library/argparse.rst:1341 +#: library/argparse.rst:1343 msgid "" ">>> parser.parse_args(['-xX'])\n" "Namespace(foo=None, x='X')" msgstr "" -#: library/argparse.rst:1344 +#: library/argparse.rst:1346 msgid "" "Several short options can be joined together, using only a single ``-`` " "prefix, as long as only the last option (or none of them) requires a value::" msgstr "" -#: library/argparse.rst:1347 +#: library/argparse.rst:1349 msgid "" ">>> parser = argparse.ArgumentParser(prog='PROG')\n" ">>> parser.add_argument('-x', action='store_true')\n" @@ -1934,11 +1937,11 @@ msgid "" "Namespace(x=True, y=True, z='Z')" msgstr "" -#: library/argparse.rst:1356 +#: library/argparse.rst:1358 msgid "Invalid arguments" msgstr "" -#: library/argparse.rst:1358 +#: library/argparse.rst:1360 msgid "" "While parsing the command line, :meth:`~ArgumentParser.parse_args` checks " "for a variety of errors, including ambiguous options, invalid types, invalid " @@ -1946,7 +1949,7 @@ msgid "" "an error, it exits and prints the error along with a usage message::" msgstr "" -#: library/argparse.rst:1363 +#: library/argparse.rst:1365 msgid "" ">>> parser = argparse.ArgumentParser(prog='PROG')\n" ">>> parser.add_argument('--foo', type=int)\n" @@ -1968,11 +1971,11 @@ msgid "" "PROG: error: extra arguments found: badger" msgstr "" -#: library/argparse.rst:1384 +#: library/argparse.rst:1386 msgid "Arguments containing ``-``" msgstr "" -#: library/argparse.rst:1386 +#: library/argparse.rst:1388 msgid "" "The :meth:`~ArgumentParser.parse_args` method attempts to give errors " "whenever the user has clearly made a mistake, but some situations are " @@ -1984,7 +1987,7 @@ msgid "" "negative numbers::" msgstr "" -#: library/argparse.rst:1394 +#: library/argparse.rst:1396 msgid "" ">>> parser = argparse.ArgumentParser(prog='PROG')\n" ">>> parser.add_argument('-x')\n" @@ -2017,7 +2020,7 @@ msgid "" "PROG: error: argument -1: expected one argument" msgstr "" -#: library/argparse.rst:1424 +#: library/argparse.rst:1426 msgid "" "If you have positional arguments that must begin with ``-`` and don't look " "like negative numbers, you can insert the pseudo-argument ``'--'`` which " @@ -2025,30 +2028,30 @@ msgid "" "positional argument::" msgstr "" -#: library/argparse.rst:1429 +#: library/argparse.rst:1431 msgid "" ">>> parser.parse_args(['--', '-f'])\n" "Namespace(foo='-f', one=None)" msgstr "" -#: library/argparse.rst:1432 +#: library/argparse.rst:1434 msgid "" "See also :ref:`the argparse howto on ambiguous arguments ` for more details." msgstr "" -#: library/argparse.rst:1438 +#: library/argparse.rst:1440 msgid "Argument abbreviations (prefix matching)" msgstr "" -#: library/argparse.rst:1440 +#: library/argparse.rst:1442 msgid "" "The :meth:`~ArgumentParser.parse_args` method :ref:`by default " "` allows long options to be abbreviated to a prefix, if the " "abbreviation is unambiguous (the prefix matches a unique option)::" msgstr "" -#: library/argparse.rst:1444 +#: library/argparse.rst:1446 msgid "" ">>> parser = argparse.ArgumentParser(prog='PROG')\n" ">>> parser.add_argument('-bacon')\n" @@ -2062,17 +2065,17 @@ msgid "" "PROG: error: ambiguous option: -ba could match -badger, -bacon" msgstr "" -#: library/argparse.rst:1455 +#: library/argparse.rst:1457 msgid "" "An error is produced for arguments that could produce more than one options. " "This feature can be disabled by setting :ref:`allow_abbrev` to ``False``." msgstr "" -#: library/argparse.rst:1461 +#: library/argparse.rst:1463 msgid "Beyond ``sys.argv``" msgstr "" -#: library/argparse.rst:1463 +#: library/argparse.rst:1465 msgid "" "Sometimes it may be useful to have an :class:`ArgumentParser` parse " "arguments other than those of :data:`sys.argv`. This can be accomplished by " @@ -2080,7 +2083,7 @@ msgid "" "useful for testing at the interactive prompt::" msgstr "" -#: library/argparse.rst:1468 +#: library/argparse.rst:1470 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument(\n" @@ -2095,24 +2098,24 @@ msgid "" "Namespace(accumulate=, integers=[1, 2, 3, 4])" msgstr "" -#: library/argparse.rst:1483 +#: library/argparse.rst:1485 msgid "The Namespace object" msgstr "" -#: library/argparse.rst:1487 +#: library/argparse.rst:1489 msgid "" "Simple class used by default by :meth:`~ArgumentParser.parse_args` to create " "an object holding attributes and return it." msgstr "" -#: library/argparse.rst:1490 +#: library/argparse.rst:1492 msgid "" "This class is deliberately simple, just an :class:`object` subclass with a " "readable string representation. If you prefer to have dict-like view of the " "attributes, you can use the standard Python idiom, :func:`vars`::" msgstr "" -#: library/argparse.rst:1494 +#: library/argparse.rst:1496 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo')\n" @@ -2121,14 +2124,14 @@ msgid "" "{'foo': 'BAR'}" msgstr "" -#: library/argparse.rst:1500 +#: library/argparse.rst:1502 msgid "" "It may also be useful to have an :class:`ArgumentParser` assign attributes " "to an already existing object, rather than a new :class:`Namespace` object. " "This can be achieved by specifying the ``namespace=`` keyword argument::" msgstr "" -#: library/argparse.rst:1504 +#: library/argparse.rst:1506 msgid "" ">>> class C:\n" "... pass\n" @@ -2141,15 +2144,15 @@ msgid "" "'BAR'" msgstr "" -#: library/argparse.rst:1516 +#: library/argparse.rst:1518 msgid "Other utilities" msgstr "" -#: library/argparse.rst:1519 +#: library/argparse.rst:1521 msgid "Sub-commands" msgstr "" -#: library/argparse.rst:1526 +#: library/argparse.rst:1528 msgid "" "Many programs split up their functionality into a number of subcommands, for " "example, the ``svn`` program can invoke subcommands like ``svn checkout``, " @@ -2164,69 +2167,69 @@ msgid "" "returns an :class:`!ArgumentParser` object that can be modified as usual." msgstr "" -#: library/argparse.rst:1538 +#: library/argparse.rst:1540 msgid "Description of parameters:" msgstr "" -#: library/argparse.rst:1540 +#: library/argparse.rst:1542 msgid "" "*title* - title for the sub-parser group in help output; by default " "\"subcommands\" if description is provided, otherwise uses title for " "positional arguments" msgstr "" -#: library/argparse.rst:1544 +#: library/argparse.rst:1546 msgid "" "*description* - description for the sub-parser group in help output, by " "default ``None``" msgstr "" -#: library/argparse.rst:1547 +#: library/argparse.rst:1549 msgid "" "*prog* - usage information that will be displayed with sub-command help, by " "default the name of the program and any positional arguments before the " "subparser argument" msgstr "" -#: library/argparse.rst:1551 +#: library/argparse.rst:1553 msgid "" "*parser_class* - class which will be used to create sub-parser instances, by " "default the class of the current parser (e.g. :class:`ArgumentParser`)" msgstr "" -#: library/argparse.rst:1554 +#: library/argparse.rst:1556 msgid "" "action_ - the basic type of action to be taken when this argument is " "encountered at the command line" msgstr "" -#: library/argparse.rst:1557 +#: library/argparse.rst:1559 msgid "" "dest_ - name of the attribute under which sub-command name will be stored; " "by default ``None`` and no value is stored" msgstr "" -#: library/argparse.rst:1560 +#: library/argparse.rst:1562 msgid "" "required_ - Whether or not a subcommand must be provided, by default " "``False`` (added in 3.7)" msgstr "" -#: library/argparse.rst:1563 +#: library/argparse.rst:1565 msgid "help_ - help for sub-parser group in help output, by default ``None``" msgstr "" -#: library/argparse.rst:1565 +#: library/argparse.rst:1567 msgid "" "metavar_ - string presenting available subcommands in help; by default it is " "``None`` and presents subcommands in form {cmd1, cmd2, ..}" msgstr "" -#: library/argparse.rst:1568 +#: library/argparse.rst:1570 msgid "Some example usage::" msgstr "" -#: library/argparse.rst:1570 +#: library/argparse.rst:1572 msgid "" ">>> # create the top-level parser\n" ">>> parser = argparse.ArgumentParser(prog='PROG')\n" @@ -2249,7 +2252,7 @@ msgid "" "Namespace(baz='Z', foo=True)" msgstr "" -#: library/argparse.rst:1589 +#: library/argparse.rst:1591 msgid "" "Note that the object returned by :meth:`parse_args` will only contain " "attributes for the main parser and the subparser that was selected by the " @@ -2259,7 +2262,7 @@ msgid "" "``baz`` attributes are present." msgstr "" -#: library/argparse.rst:1596 +#: library/argparse.rst:1598 msgid "" "Similarly, when a help message is requested from a subparser, only the help " "for that particular parser will be printed. The help message will not " @@ -2268,7 +2271,7 @@ msgid "" "to :meth:`~_SubParsersAction.add_parser` as above.)" msgstr "" -#: library/argparse.rst:1604 +#: library/argparse.rst:1606 msgid "" ">>> parser.parse_args(['--help'])\n" "usage: PROG [-h] [--foo] {a,b} ...\n" @@ -2299,14 +2302,14 @@ msgid "" " --baz {X,Y,Z} baz help" msgstr "" -#: library/argparse.rst:1632 +#: library/argparse.rst:1634 msgid "" "The :meth:`add_subparsers` method also supports ``title`` and " "``description`` keyword arguments. When either is present, the subparser's " "commands will appear in their own group in the help output. For example::" msgstr "" -#: library/argparse.rst:1636 +#: library/argparse.rst:1638 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> subparsers = parser.add_subparsers(title='subcommands',\n" @@ -2326,14 +2329,14 @@ msgid "" " {foo,bar} additional help" msgstr "" -#: library/argparse.rst:1653 +#: library/argparse.rst:1655 msgid "" "Furthermore, ``add_parser`` supports an additional ``aliases`` argument, " "which allows multiple strings to refer to the same subparser. This example, " "like ``svn``, aliases ``co`` as a shorthand for ``checkout``::" msgstr "" -#: library/argparse.rst:1657 +#: library/argparse.rst:1659 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> subparsers = parser.add_subparsers()\n" @@ -2343,7 +2346,7 @@ msgid "" "Namespace(foo='bar')" msgstr "" -#: library/argparse.rst:1664 +#: library/argparse.rst:1666 msgid "" "One particularly effective way of handling sub-commands is to combine the " "use of the :meth:`add_subparsers` method with calls to :meth:`set_defaults` " @@ -2351,7 +2354,7 @@ msgid "" "example::" msgstr "" -#: library/argparse.rst:1669 +#: library/argparse.rst:1671 msgid "" ">>> # subcommand functions\n" ">>> def foo(args):\n" @@ -2386,7 +2389,7 @@ msgid "" "((XYZYX))" msgstr "" -#: library/argparse.rst:1701 +#: library/argparse.rst:1703 msgid "" "This way, you can let :meth:`parse_args` do the job of calling the " "appropriate function after argument parsing is complete. Associating " @@ -2396,7 +2399,7 @@ msgid "" "argument to the :meth:`add_subparsers` call will work::" msgstr "" -#: library/argparse.rst:1708 +#: library/argparse.rst:1710 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> subparsers = parser.add_subparsers(dest='subparser_name')\n" @@ -2408,15 +2411,15 @@ msgid "" "Namespace(subparser_name='2', y='frobble')" msgstr "" -#: library/argparse.rst:1717 +#: library/argparse.rst:1719 msgid "New *required* keyword-only parameter." msgstr "" -#: library/argparse.rst:1722 +#: library/argparse.rst:1724 msgid "FileType objects" msgstr "" -#: library/argparse.rst:1726 +#: library/argparse.rst:1728 msgid "" "The :class:`FileType` factory creates objects that can be passed to the type " "argument of :meth:`ArgumentParser.add_argument`. Arguments that have :class:" @@ -2425,7 +2428,7 @@ msgid "" "the :func:`open` function for more details)::" msgstr "" -#: library/argparse.rst:1732 +#: library/argparse.rst:1734 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--raw', type=argparse.FileType('wb', 0))\n" @@ -2436,14 +2439,14 @@ msgid "" "raw=<_io.FileIO name='raw.dat' mode='wb'>)" msgstr "" -#: library/argparse.rst:1738 +#: library/argparse.rst:1740 msgid "" "FileType objects understand the pseudo-argument ``'-'`` and automatically " "convert this into :data:`sys.stdin` for readable :class:`FileType` objects " "and :data:`sys.stdout` for writable :class:`FileType` objects::" msgstr "" -#: library/argparse.rst:1742 +#: library/argparse.rst:1744 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('infile', type=argparse.FileType('r'))\n" @@ -2451,15 +2454,15 @@ msgid "" "Namespace(infile=<_io.TextIOWrapper name='' encoding='UTF-8'>)" msgstr "" -#: library/argparse.rst:1747 +#: library/argparse.rst:1749 msgid "Added the *encodings* and *errors* parameters." msgstr "" -#: library/argparse.rst:1752 +#: library/argparse.rst:1754 msgid "Argument groups" msgstr "" -#: library/argparse.rst:1757 +#: library/argparse.rst:1759 msgid "" "By default, :class:`ArgumentParser` groups command-line arguments into " "\"positional arguments\" and \"options\" when displaying help messages. When " @@ -2468,7 +2471,7 @@ msgid "" "method::" msgstr "" -#: library/argparse.rst:1763 +#: library/argparse.rst:1765 msgid "" ">>> parser = argparse.ArgumentParser(prog='PROG', add_help=False)\n" ">>> group = parser.add_argument_group('group')\n" @@ -2482,7 +2485,7 @@ msgid "" " --foo FOO foo help" msgstr "" -#: library/argparse.rst:1774 +#: library/argparse.rst:1776 msgid "" "The :meth:`add_argument_group` method returns an argument group object which " "has an :meth:`~ArgumentParser.add_argument` method just like a regular :" @@ -2493,7 +2496,7 @@ msgid "" "this display::" msgstr "" -#: library/argparse.rst:1782 +#: library/argparse.rst:1784 msgid "" ">>> parser = argparse.ArgumentParser(prog='PROG', add_help=False)\n" ">>> group1 = parser.add_argument_group('group1', 'group1 description')\n" @@ -2514,7 +2517,7 @@ msgid "" " --bar BAR bar help" msgstr "" -#: library/argparse.rst:1800 +#: library/argparse.rst:1802 msgid "" "The optional, keyword-only parameters argument_default_ and " "conflict_handler_ allow for finer-grained control of the behavior of the " @@ -2523,13 +2526,13 @@ msgid "" "rather than the entire parser." msgstr "" -#: library/argparse.rst:1805 +#: library/argparse.rst:1807 msgid "" "Note that any arguments not in your user-defined groups will end up back in " "the usual \"positional arguments\" and \"optional arguments\" sections." msgstr "" -#: library/argparse.rst:1808 +#: library/argparse.rst:1810 msgid "" "Calling :meth:`add_argument_group` on an argument group is deprecated. This " "feature was never supported and does not always work correctly. The function " @@ -2537,18 +2540,18 @@ msgid "" "future." msgstr "" -#: library/argparse.rst:1816 +#: library/argparse.rst:1818 msgid "Mutual exclusion" msgstr "" -#: library/argparse.rst:1820 +#: library/argparse.rst:1822 msgid "" "Create a mutually exclusive group. :mod:`!argparse` will make sure that only " "one of the arguments in the mutually exclusive group was present on the " "command line::" msgstr "" -#: library/argparse.rst:1824 +#: library/argparse.rst:1826 msgid "" ">>> parser = argparse.ArgumentParser(prog='PROG')\n" ">>> group = parser.add_mutually_exclusive_group()\n" @@ -2563,14 +2566,14 @@ msgid "" "PROG: error: argument --bar: not allowed with argument --foo" msgstr "" -#: library/argparse.rst:1836 +#: library/argparse.rst:1838 msgid "" "The :meth:`add_mutually_exclusive_group` method also accepts a *required* " "argument, to indicate that at least one of the mutually exclusive arguments " "is required::" msgstr "" -#: library/argparse.rst:1840 +#: library/argparse.rst:1842 msgid "" ">>> parser = argparse.ArgumentParser(prog='PROG')\n" ">>> group = parser.add_mutually_exclusive_group(required=True)\n" @@ -2581,7 +2584,7 @@ msgid "" "PROG: error: one of the arguments --foo --bar is required" msgstr "" -#: library/argparse.rst:1848 +#: library/argparse.rst:1850 msgid "" "Note that currently mutually exclusive argument groups do not support the " "*title* and *description* arguments of :meth:`~ArgumentParser." @@ -2589,7 +2592,7 @@ msgid "" "argument group that has a title and description. For example::" msgstr "" -#: library/argparse.rst:1854 +#: library/argparse.rst:1856 msgid "" ">>> parser = argparse.ArgumentParser(prog='PROG')\n" ">>> group = parser.add_argument_group('Group title', 'Group description')\n" @@ -2609,7 +2612,7 @@ msgid "" " --bar BAR bar help" msgstr "" -#: library/argparse.rst:1871 +#: library/argparse.rst:1873 msgid "" "Calling :meth:`add_argument_group` or :meth:`add_mutually_exclusive_group` " "on a mutually exclusive group is deprecated. These features were never " @@ -2617,11 +2620,11 @@ msgid "" "by accident through inheritance and will be removed in the future." msgstr "" -#: library/argparse.rst:1879 +#: library/argparse.rst:1881 msgid "Parser defaults" msgstr "" -#: library/argparse.rst:1883 +#: library/argparse.rst:1885 msgid "" "Most of the time, the attributes of the object returned by :meth:" "`parse_args` will be fully determined by inspecting the command-line " @@ -2630,7 +2633,7 @@ msgid "" "command line to be added::" msgstr "" -#: library/argparse.rst:1889 +#: library/argparse.rst:1891 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('foo', type=int)\n" @@ -2639,12 +2642,12 @@ msgid "" "Namespace(bar=42, baz='badger', foo=736)" msgstr "" -#: library/argparse.rst:1895 +#: library/argparse.rst:1897 msgid "" "Note that parser-level defaults always override argument-level defaults::" msgstr "" -#: library/argparse.rst:1897 +#: library/argparse.rst:1899 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo', default='bar')\n" @@ -2653,20 +2656,20 @@ msgid "" "Namespace(foo='spam')" msgstr "" -#: library/argparse.rst:1903 +#: library/argparse.rst:1905 msgid "" "Parser-level defaults can be particularly useful when working with multiple " "parsers. See the :meth:`~ArgumentParser.add_subparsers` method for an " "example of this type." msgstr "" -#: library/argparse.rst:1909 +#: library/argparse.rst:1911 msgid "" "Get the default value for a namespace attribute, as set by either :meth:" "`~ArgumentParser.add_argument` or by :meth:`~ArgumentParser.set_defaults`::" msgstr "" -#: library/argparse.rst:1913 +#: library/argparse.rst:1915 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo', default='badger')\n" @@ -2674,54 +2677,54 @@ msgid "" "'badger'" msgstr "" -#: library/argparse.rst:1920 +#: library/argparse.rst:1922 msgid "Printing help" msgstr "" -#: library/argparse.rst:1922 +#: library/argparse.rst:1924 msgid "" "In most typical applications, :meth:`~ArgumentParser.parse_args` will take " "care of formatting and printing any usage or error messages. However, " "several formatting methods are available:" msgstr "" -#: library/argparse.rst:1928 +#: library/argparse.rst:1930 msgid "" "Print a brief description of how the :class:`ArgumentParser` should be " "invoked on the command line. If *file* is ``None``, :data:`sys.stdout` is " "assumed." msgstr "" -#: library/argparse.rst:1934 +#: library/argparse.rst:1936 msgid "" "Print a help message, including the program usage and information about the " "arguments registered with the :class:`ArgumentParser`. If *file* is " "``None``, :data:`sys.stdout` is assumed." msgstr "" -#: library/argparse.rst:1938 +#: library/argparse.rst:1940 msgid "" "There are also variants of these methods that simply return a string instead " "of printing it:" msgstr "" -#: library/argparse.rst:1943 +#: library/argparse.rst:1945 msgid "" "Return a string containing a brief description of how the :class:" "`ArgumentParser` should be invoked on the command line." msgstr "" -#: library/argparse.rst:1948 +#: library/argparse.rst:1950 msgid "" "Return a string containing a help message, including the program usage and " "information about the arguments registered with the :class:`ArgumentParser`." msgstr "" -#: library/argparse.rst:1953 +#: library/argparse.rst:1955 msgid "Partial parsing" msgstr "" -#: library/argparse.rst:1957 +#: library/argparse.rst:1959 msgid "" "Sometimes a script may only parse a few of the command-line arguments, " "passing the remaining arguments on to another script or program. In these " @@ -2732,7 +2735,7 @@ msgid "" "remaining argument strings." msgstr "" -#: library/argparse.rst:1966 +#: library/argparse.rst:1968 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo', action='store_true')\n" @@ -2741,7 +2744,7 @@ msgid "" "(Namespace(bar='BAR', foo=True), ['--badger', 'spam'])" msgstr "" -#: library/argparse.rst:1973 +#: library/argparse.rst:1975 msgid "" ":ref:`Prefix matching ` rules apply to :meth:" "`~ArgumentParser.parse_known_args`. The parser may consume an option even if " @@ -2749,11 +2752,11 @@ msgid "" "remaining arguments list." msgstr "" -#: library/argparse.rst:1980 +#: library/argparse.rst:1982 msgid "Customizing file parsing" msgstr "" -#: library/argparse.rst:1984 +#: library/argparse.rst:1986 msgid "" "Arguments that are read from a file (see the *fromfile_prefix_chars* keyword " "argument to the :class:`ArgumentParser` constructor) are read one argument " @@ -2761,38 +2764,38 @@ msgid "" "reading." msgstr "" -#: library/argparse.rst:1989 +#: library/argparse.rst:1991 msgid "" "This method takes a single argument *arg_line* which is a string read from " "the argument file. It returns a list of arguments parsed from this string. " "The method is called once per line read from the argument file, in order." msgstr "" -#: library/argparse.rst:1993 +#: library/argparse.rst:1995 msgid "" "A useful override of this method is one that treats each space-separated " "word as an argument. The following example demonstrates how to do this::" msgstr "" -#: library/argparse.rst:1996 +#: library/argparse.rst:1998 msgid "" "class MyArgumentParser(argparse.ArgumentParser):\n" " def convert_arg_line_to_args(self, arg_line):\n" " return arg_line.split()" msgstr "" -#: library/argparse.rst:2002 +#: library/argparse.rst:2004 msgid "Exiting methods" msgstr "" -#: library/argparse.rst:2006 +#: library/argparse.rst:2008 msgid "" "This method terminates the program, exiting with the specified *status* and, " "if given, it prints a *message* to :data:`sys.stderr` before that. The user " "can override this method to handle these steps differently::" msgstr "" -#: library/argparse.rst:2010 +#: library/argparse.rst:2012 msgid "" "class ErrorCatchingArgumentParser(argparse.ArgumentParser):\n" " def exit(self, status=0, message=None):\n" @@ -2801,17 +2804,17 @@ msgid "" " exit(status)" msgstr "" -#: library/argparse.rst:2018 +#: library/argparse.rst:2020 msgid "" "This method prints a usage message, including the *message*, to :data:`sys." "stderr` and terminates the program with a status code of 2." msgstr "" -#: library/argparse.rst:2023 +#: library/argparse.rst:2025 msgid "Intermixed parsing" msgstr "" -#: library/argparse.rst:2028 +#: library/argparse.rst:2030 msgid "" "A number of Unix commands allow the user to intermix optional arguments with " "positional arguments. The :meth:`~ArgumentParser.parse_intermixed_args` " @@ -2819,7 +2822,7 @@ msgid "" "parsing style." msgstr "" -#: library/argparse.rst:2033 +#: library/argparse.rst:2035 msgid "" "These parsers do not support all the :mod:`!argparse` features, and will " "raise exceptions if unsupported features are used. In particular, " @@ -2827,7 +2830,7 @@ msgid "" "positionals are not supported." msgstr "" -#: library/argparse.rst:2038 +#: library/argparse.rst:2040 msgid "" "The following example shows the difference between :meth:`~ArgumentParser." "parse_known_args` and :meth:`~ArgumentParser.parse_intermixed_args`: the " @@ -2835,7 +2838,7 @@ msgid "" "collects all the positionals into ``rest``. ::" msgstr "" -#: library/argparse.rst:2044 +#: library/argparse.rst:2046 msgid "" ">>> parser = argparse.ArgumentParser()\n" ">>> parser.add_argument('--foo')\n" @@ -2847,7 +2850,7 @@ msgid "" "Namespace(cmd='doit', foo='bar', rest=[1, 2, 3])" msgstr "" -#: library/argparse.rst:2053 +#: library/argparse.rst:2055 msgid "" ":meth:`~ArgumentParser.parse_known_intermixed_args` returns a two item tuple " "containing the populated namespace and the list of remaining argument " @@ -2855,41 +2858,82 @@ msgid "" "there are any remaining unparsed argument strings." msgstr "" -#: library/argparse.rst:2062 +#: library/argparse.rst:2064 +msgid "Registering custom types or actions" +msgstr "" + +#: library/argparse.rst:2068 +msgid "" +"Sometimes it's desirable to use a custom string in error messages to provide " +"more user-friendly output. In these cases, :meth:`!register` can be used to " +"register custom actions or types with a parser and allow you to reference " +"the type by their registered name instead of their callable name." +msgstr "" + +#: library/argparse.rst:2073 +msgid "" +"The :meth:`!register` method accepts three arguments - a *registry_name*, " +"specifying the internal registry where the object will be stored (e.g., " +"``action``, ``type``), *value*, which is the key under which the object will " +"be registered, and object, the callable to be registered." +msgstr "" + +#: library/argparse.rst:2078 +msgid "" +"The following example shows how to register a custom type with a parser::" +msgstr "" + +#: library/argparse.rst:2080 +msgid "" +">>> import argparse\n" +">>> parser = argparse.ArgumentParser()\n" +">>> parser.register('type', 'hexadecimal integer', lambda s: int(s, 16))\n" +">>> parser.add_argument('--foo', type='hexadecimal integer')\n" +"_StoreAction(option_strings=['--foo'], dest='foo', nargs=None, const=None, " +"default=None, type='hexadecimal integer', choices=None, required=False, " +"help=None, metavar=None, deprecated=False)\n" +">>> parser.parse_args(['--foo', '0xFA'])\n" +"Namespace(foo=250)\n" +">>> parser.parse_args(['--foo', '1.2'])\n" +"usage: PROG [-h] [--foo FOO]\n" +"PROG: error: argument --foo: invalid 'hexadecimal integer' value: '1.2'" +msgstr "" + +#: library/argparse.rst:2092 msgid "Exceptions" msgstr "" -#: library/argparse.rst:2066 +#: library/argparse.rst:2096 msgid "An error from creating or using an argument (optional or positional)." msgstr "" -#: library/argparse.rst:2068 +#: library/argparse.rst:2098 msgid "" "The string value of this exception is the message, augmented with " "information about the argument that caused it." msgstr "" -#: library/argparse.rst:2073 +#: library/argparse.rst:2103 msgid "" "Raised when something goes wrong converting a command line string to a type." msgstr "" -#: library/argparse.rst:2077 +#: library/argparse.rst:2107 msgid "Guides and Tutorials" msgstr "" -#: library/argparse.rst:800 +#: library/argparse.rst:801 msgid "? (question mark)" msgstr "" -#: library/argparse.rst:834 library/argparse.rst:848 +#: library/argparse.rst:835 library/argparse.rst:849 msgid "in argparse module" msgstr "" -#: library/argparse.rst:834 +#: library/argparse.rst:835 msgid "* (asterisk)" msgstr "" -#: library/argparse.rst:848 +#: library/argparse.rst:849 msgid "+ (plus)" msgstr "" diff --git a/library/asyncio-eventloop.po b/library/asyncio-eventloop.po index 6bf4faa75..c90b0a445 100644 --- a/library/asyncio-eventloop.po +++ b/library/asyncio-eventloop.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2178,8 +2178,8 @@ msgstr "" #: library/asyncio-eventloop.rst:1752 msgid "" -"`MSDN documentation on I/O Completion Ports `_." +"`MSDN documentation on I/O Completion Ports `_." msgstr "" #: library/asyncio-eventloop.rst:1758 diff --git a/library/asyncio-sync.po b/library/asyncio-sync.po index 5a4b50d58..55c72928c 100644 --- a/library/asyncio-sync.po +++ b/library/asyncio-sync.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -98,7 +98,7 @@ msgid "" " # access shared state" msgstr "" -#: library/asyncio-sync.rst:199 library/asyncio-sync.rst:298 +#: library/asyncio-sync.rst:199 library/asyncio-sync.rst:299 msgid "which is equivalent to::" msgstr "" @@ -114,8 +114,8 @@ msgid "" " lock.release()" msgstr "" -#: library/asyncio-sync.rst:112 library/asyncio-sync.rst:286 -#: library/asyncio-sync.rst:341 +#: library/asyncio-sync.rst:112 library/asyncio-sync.rst:287 +#: library/asyncio-sync.rst:342 msgid "Removed the *loop* parameter." msgstr "" @@ -179,7 +179,7 @@ msgid "" "*true*. The flag is set to *false* initially." msgstr "" -#: library/asyncio-sync.rst:365 +#: library/asyncio-sync.rst:366 msgid "Example::" msgstr "" @@ -361,18 +361,19 @@ msgstr "" #: library/asyncio-sync.rst:264 msgid "" "The predicate must be a callable which result will be interpreted as a " -"boolean value. The final value is the return value." +"boolean value. The method will repeatedly :meth:`~Condition.wait` until the " +"predicate evaluates to *true*. The final value is the return value." msgstr "" -#: library/asyncio-sync.rst:270 +#: library/asyncio-sync.rst:271 msgid "Semaphore" msgstr "" -#: library/asyncio-sync.rst:274 +#: library/asyncio-sync.rst:275 msgid "A Semaphore object. Not thread-safe." msgstr "" -#: library/asyncio-sync.rst:276 +#: library/asyncio-sync.rst:277 msgid "" "A semaphore manages an internal counter which is decremented by each :meth:" "`acquire` call and incremented by each :meth:`release` call. The counter can " @@ -380,19 +381,19 @@ msgid "" "waiting until some task calls :meth:`release`." msgstr "" -#: library/asyncio-sync.rst:282 +#: library/asyncio-sync.rst:283 msgid "" "The optional *value* argument gives the initial value for the internal " "counter (``1`` by default). If the given value is less than ``0`` a :exc:" "`ValueError` is raised." msgstr "" -#: library/asyncio-sync.rst:289 +#: library/asyncio-sync.rst:290 msgid "" "The preferred way to use a Semaphore is an :keyword:`async with` statement::" msgstr "" -#: library/asyncio-sync.rst:292 +#: library/asyncio-sync.rst:293 msgid "" "sem = asyncio.Semaphore(10)\n" "\n" @@ -401,7 +402,7 @@ msgid "" " # work with shared resource" msgstr "" -#: library/asyncio-sync.rst:300 +#: library/asyncio-sync.rst:301 msgid "" "sem = asyncio.Semaphore(10)\n" "\n" @@ -413,57 +414,57 @@ msgid "" " sem.release()" msgstr "" -#: library/asyncio-sync.rst:311 +#: library/asyncio-sync.rst:312 msgid "Acquire a semaphore." msgstr "" -#: library/asyncio-sync.rst:313 +#: library/asyncio-sync.rst:314 msgid "" "If the internal counter is greater than zero, decrement it by one and return " "``True`` immediately. If it is zero, wait until a :meth:`release` is called " "and return ``True``." msgstr "" -#: library/asyncio-sync.rst:319 +#: library/asyncio-sync.rst:320 msgid "Returns ``True`` if semaphore can not be acquired immediately." msgstr "" -#: library/asyncio-sync.rst:323 +#: library/asyncio-sync.rst:324 msgid "" "Release a semaphore, incrementing the internal counter by one. Can wake up a " "task waiting to acquire the semaphore." msgstr "" -#: library/asyncio-sync.rst:326 +#: library/asyncio-sync.rst:327 msgid "" "Unlike :class:`BoundedSemaphore`, :class:`Semaphore` allows making more " "``release()`` calls than ``acquire()`` calls." msgstr "" -#: library/asyncio-sync.rst:331 +#: library/asyncio-sync.rst:332 msgid "BoundedSemaphore" msgstr "" -#: library/asyncio-sync.rst:335 +#: library/asyncio-sync.rst:336 msgid "A bounded semaphore object. Not thread-safe." msgstr "" -#: library/asyncio-sync.rst:337 +#: library/asyncio-sync.rst:338 msgid "" "Bounded Semaphore is a version of :class:`Semaphore` that raises a :exc:" "`ValueError` in :meth:`~Semaphore.release` if it increases the internal " "counter above the initial *value*." msgstr "" -#: library/asyncio-sync.rst:346 +#: library/asyncio-sync.rst:347 msgid "Barrier" msgstr "" -#: library/asyncio-sync.rst:350 +#: library/asyncio-sync.rst:351 msgid "A barrier object. Not thread-safe." msgstr "" -#: library/asyncio-sync.rst:352 +#: library/asyncio-sync.rst:353 msgid "" "A barrier is a simple synchronization primitive that allows to block until " "*parties* number of tasks are waiting on it. Tasks can wait on the :meth:" @@ -472,17 +473,17 @@ msgid "" "waiting tasks would unblock simultaneously." msgstr "" -#: library/asyncio-sync.rst:358 +#: library/asyncio-sync.rst:359 msgid "" ":keyword:`async with` can be used as an alternative to awaiting on :meth:" "`~Barrier.wait`." msgstr "" -#: library/asyncio-sync.rst:361 +#: library/asyncio-sync.rst:362 msgid "The barrier can be reused any number of times." msgstr "" -#: library/asyncio-sync.rst:367 +#: library/asyncio-sync.rst:368 msgid "" "async def example_barrier():\n" " # barrier with 3 parties\n" @@ -506,11 +507,11 @@ msgid "" "asyncio.run(example_barrier())" msgstr "" -#: library/asyncio-sync.rst:388 +#: library/asyncio-sync.rst:389 msgid "Result of this example is::" msgstr "" -#: library/asyncio-sync.rst:390 +#: library/asyncio-sync.rst:391 msgid "" "\n" "\n" @@ -518,27 +519,27 @@ msgid "" "" msgstr "" -#: library/asyncio-sync.rst:399 +#: library/asyncio-sync.rst:400 msgid "" "Pass the barrier. When all the tasks party to the barrier have called this " "function, they are all unblocked simultaneously." msgstr "" -#: library/asyncio-sync.rst:402 +#: library/asyncio-sync.rst:403 msgid "" "When a waiting or blocked task in the barrier is cancelled, this task exits " "the barrier which stays in the same state. If the state of the barrier is " "\"filling\", the number of waiting task decreases by 1." msgstr "" -#: library/asyncio-sync.rst:407 +#: library/asyncio-sync.rst:408 msgid "" "The return value is an integer in the range of 0 to ``parties-1``, different " "for each task. This can be used to select a task to do some special " "housekeeping, e.g.::" msgstr "" -#: library/asyncio-sync.rst:411 +#: library/asyncio-sync.rst:412 msgid "" "...\n" "async with barrier as position:\n" @@ -547,51 +548,52 @@ msgid "" " print('End of *draining phase*')" msgstr "" -#: library/asyncio-sync.rst:417 +#: library/asyncio-sync.rst:418 msgid "" "This method may raise a :class:`BrokenBarrierError` exception if the barrier " "is broken or reset while a task is waiting. It could raise a :exc:" "`CancelledError` if a task is cancelled." msgstr "" -#: library/asyncio-sync.rst:423 +#: library/asyncio-sync.rst:424 msgid "" "Return the barrier to the default, empty state. Any tasks waiting on it " "will receive the :class:`BrokenBarrierError` exception." msgstr "" -#: library/asyncio-sync.rst:426 +#: library/asyncio-sync.rst:427 msgid "" "If a barrier is broken it may be better to just leave it and create a new " "one." msgstr "" -#: library/asyncio-sync.rst:430 +#: library/asyncio-sync.rst:431 msgid "" "Put the barrier into a broken state. This causes any active or future calls " -"to :meth:`wait` to fail with the :class:`BrokenBarrierError`. Use this for " -"example if one of the tasks needs to abort, to avoid infinite waiting tasks." +"to :meth:`~Barrier.wait` to fail with the :class:`BrokenBarrierError`. Use " +"this for example if one of the tasks needs to abort, to avoid infinite " +"waiting tasks." msgstr "" -#: library/asyncio-sync.rst:437 +#: library/asyncio-sync.rst:438 msgid "The number of tasks required to pass the barrier." msgstr "" -#: library/asyncio-sync.rst:441 +#: library/asyncio-sync.rst:442 msgid "The number of tasks currently waiting in the barrier while filling." msgstr "" -#: library/asyncio-sync.rst:445 +#: library/asyncio-sync.rst:446 msgid "A boolean that is ``True`` if the barrier is in the broken state." msgstr "" -#: library/asyncio-sync.rst:450 +#: library/asyncio-sync.rst:451 msgid "" "This exception, a subclass of :exc:`RuntimeError`, is raised when the :class:" "`Barrier` object is reset or broken." msgstr "" -#: library/asyncio-sync.rst:458 +#: library/asyncio-sync.rst:459 msgid "" "Acquiring a lock using ``await lock`` or ``yield from lock`` and/or :keyword:" "`with` statement (``with await lock``, ``with (yield from lock)``) was " diff --git a/library/calendar.po b/library/calendar.po index 54a138c31..6e41118ad 100644 --- a/library/calendar.po +++ b/library/calendar.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -161,6 +161,14 @@ msgstr "" #: library/calendar.rst:143 msgid "" +"Return a single week in a string with no newline. If *w* is provided, it " +"specifies the width of the date columns, which are centered. Depends on the " +"first weekday as specified in the constructor or set by the :meth:" +"`setfirstweekday` method." +msgstr "" + +#: library/calendar.rst:151 +msgid "" "Return a month's calendar in a multi-line string. If *w* is provided, it " "specifies the width of the date columns, which are centered. If *l* is " "given, it specifies the number of lines that each week will use. Depends on " @@ -168,11 +176,11 @@ msgid "" "`setfirstweekday` method." msgstr "" -#: library/calendar.rst:152 +#: library/calendar.rst:160 msgid "Print a month's calendar as returned by :meth:`formatmonth`." msgstr "" -#: library/calendar.rst:157 +#: library/calendar.rst:165 msgid "" "Return a *m*-column calendar for an entire year as a multi-line string. " "Optional parameters *w*, *l*, and *c* are for date column width, lines per " @@ -182,32 +190,32 @@ msgid "" "generated is platform-dependent." msgstr "" -#: library/calendar.rst:167 +#: library/calendar.rst:175 msgid "" "Print the calendar for an entire year as returned by :meth:`formatyear`." msgstr "" -#: library/calendar.rst:172 +#: library/calendar.rst:180 msgid "This class can be used to generate HTML calendars." msgstr "" -#: library/calendar.rst:175 +#: library/calendar.rst:183 msgid ":class:`!HTMLCalendar` instances have the following methods:" msgstr "" -#: library/calendar.rst:179 +#: library/calendar.rst:187 msgid "" "Return a month's calendar as an HTML table. If *withyear* is true the year " "will be included in the header, otherwise just the month name will be used." msgstr "" -#: library/calendar.rst:186 +#: library/calendar.rst:194 msgid "" "Return a year's calendar as an HTML table. *width* (defaulting to 3) " "specifies the number of months per row." msgstr "" -#: library/calendar.rst:192 +#: library/calendar.rst:200 msgid "" "Return a year's calendar as a complete HTML page. *width* (defaulting to 3) " "specifies the number of months per row. *css* is the name for the cascading " @@ -216,92 +224,92 @@ msgid "" "(defaulting to the system default encoding)." msgstr "" -#: library/calendar.rst:201 +#: library/calendar.rst:209 msgid "" "Return a month name as an HTML table row. If *withyear* is true the year " "will be included in the row, otherwise just the month name will be used." msgstr "" -#: library/calendar.rst:206 +#: library/calendar.rst:214 msgid "" ":class:`!HTMLCalendar` has the following attributes you can override to " "customize the CSS classes used by the calendar:" msgstr "" -#: library/calendar.rst:211 +#: library/calendar.rst:219 msgid "" "A list of CSS classes used for each weekday. The default class list is::" msgstr "" -#: library/calendar.rst:213 +#: library/calendar.rst:221 msgid "" "cssclasses = [\"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\", \"sun\"]" msgstr "" -#: library/calendar.rst:215 +#: library/calendar.rst:223 msgid "more styles can be added for each day::" msgstr "" -#: library/calendar.rst:217 +#: library/calendar.rst:225 msgid "" "cssclasses = [\"mon text-bold\", \"tue\", \"wed\", \"thu\", \"fri\", " "\"sat\", \"sun red\"]" msgstr "" -#: library/calendar.rst:219 +#: library/calendar.rst:227 msgid "Note that the length of this list must be seven items." msgstr "" -#: library/calendar.rst:224 +#: library/calendar.rst:232 msgid "The CSS class for a weekday occurring in the previous or coming month." msgstr "" -#: library/calendar.rst:231 +#: library/calendar.rst:239 msgid "" "A list of CSS classes used for weekday names in the header row. The default " "is the same as :attr:`cssclasses`." msgstr "" -#: library/calendar.rst:239 +#: library/calendar.rst:247 msgid "" "The month's head CSS class (used by :meth:`formatmonthname`). The default " "value is ``\"month\"``." msgstr "" -#: library/calendar.rst:247 +#: library/calendar.rst:255 msgid "" "The CSS class for the whole month's table (used by :meth:`formatmonth`). The " "default value is ``\"month\"``." msgstr "" -#: library/calendar.rst:255 +#: library/calendar.rst:263 msgid "" "The CSS class for the whole year's table of tables (used by :meth:" "`formatyear`). The default value is ``\"year\"``." msgstr "" -#: library/calendar.rst:263 +#: library/calendar.rst:271 msgid "" "The CSS class for the table head for the whole year (used by :meth:" "`formatyear`). The default value is ``\"year\"``." msgstr "" -#: library/calendar.rst:269 +#: library/calendar.rst:277 msgid "" "Note that although the naming for the above described class attributes is " "singular (e.g. ``cssclass_month`` ``cssclass_noday``), one can replace the " "single CSS class with a space separated list of CSS classes, for example::" msgstr "" -#: library/calendar.rst:273 +#: library/calendar.rst:281 msgid "\"text-bold text-red\"" msgstr "" -#: library/calendar.rst:275 +#: library/calendar.rst:283 msgid "Here is an example how :class:`!HTMLCalendar` can be customized::" msgstr "" -#: library/calendar.rst:277 +#: library/calendar.rst:285 msgid "" "class CustomHTMLCal(calendar.HTMLCalendar):\n" " cssclasses = [style + \" text-nowrap\" for style in\n" @@ -311,19 +319,19 @@ msgid "" " cssclass_year = \"text-italic lead\"" msgstr "" -#: library/calendar.rst:287 +#: library/calendar.rst:295 msgid "" "This subclass of :class:`TextCalendar` can be passed a locale name in the " "constructor and will return month and weekday names in the specified locale." msgstr "" -#: library/calendar.rst:293 +#: library/calendar.rst:301 msgid "" "This subclass of :class:`HTMLCalendar` can be passed a locale name in the " "constructor and will return month and weekday names in the specified locale." msgstr "" -#: library/calendar.rst:299 +#: library/calendar.rst:307 msgid "" "The constructor, :meth:`!formatweekday` and :meth:`!formatmonthname` methods " "of these two classes temporarily change the ``LC_TIME`` locale to the given " @@ -331,11 +339,11 @@ msgid "" "thread-safe." msgstr "" -#: library/calendar.rst:305 +#: library/calendar.rst:313 msgid "For simple text calendars this module provides the following functions." msgstr "" -#: library/calendar.rst:309 +#: library/calendar.rst:317 msgid "" "Sets the weekday (``0`` is Monday, ``6`` is Sunday) to start each week. The " "values :const:`MONDAY`, :const:`TUESDAY`, :const:`WEDNESDAY`, :const:" @@ -343,78 +351,78 @@ msgid "" "provided for convenience. For example, to set the first weekday to Sunday::" msgstr "" -#: library/calendar.rst:314 +#: library/calendar.rst:322 msgid "" "import calendar\n" "calendar.setfirstweekday(calendar.SUNDAY)" msgstr "" -#: library/calendar.rst:320 +#: library/calendar.rst:328 msgid "Returns the current setting for the weekday to start each week." msgstr "" -#: library/calendar.rst:325 +#: library/calendar.rst:333 msgid "" "Returns :const:`True` if *year* is a leap year, otherwise :const:`False`." msgstr "" -#: library/calendar.rst:330 +#: library/calendar.rst:338 msgid "" "Returns the number of leap years in the range from *y1* to *y2* (exclusive), " "where *y1* and *y2* are years." msgstr "" -#: library/calendar.rst:333 +#: library/calendar.rst:341 msgid "This function works for ranges spanning a century change." msgstr "" -#: library/calendar.rst:338 +#: library/calendar.rst:346 msgid "" "Returns the day of the week (``0`` is Monday) for *year* (``1970``--...), " "*month* (``1``--``12``), *day* (``1``--``31``)." msgstr "" -#: library/calendar.rst:344 +#: library/calendar.rst:352 msgid "" "Return a header containing abbreviated weekday names. *n* specifies the " "width in characters for one weekday." msgstr "" -#: library/calendar.rst:350 +#: library/calendar.rst:358 msgid "" "Returns weekday of first day of the month and number of days in month, for " "the specified *year* and *month*." msgstr "" -#: library/calendar.rst:356 +#: library/calendar.rst:364 msgid "" "Returns a matrix representing a month's calendar. Each row represents a " "week; days outside of the month are represented by zeros. Each week begins " "with Monday unless set by :func:`setfirstweekday`." msgstr "" -#: library/calendar.rst:363 +#: library/calendar.rst:371 msgid "Prints a month's calendar as returned by :func:`month`." msgstr "" -#: library/calendar.rst:368 +#: library/calendar.rst:376 msgid "" "Returns a month's calendar in a multi-line string using the :meth:" "`~TextCalendar.formatmonth` of the :class:`TextCalendar` class." msgstr "" -#: library/calendar.rst:374 +#: library/calendar.rst:382 msgid "" "Prints the calendar for an entire year as returned by :func:`calendar`." msgstr "" -#: library/calendar.rst:379 +#: library/calendar.rst:387 msgid "" "Returns a 3-column calendar for an entire year as a multi-line string using " "the :meth:`~TextCalendar.formatyear` of the :class:`TextCalendar` class." msgstr "" -#: library/calendar.rst:385 +#: library/calendar.rst:393 msgid "" "An unrelated but handy function that takes a time tuple such as returned by " "the :func:`~time.gmtime` function in the :mod:`time` module, and returns the " @@ -423,126 +431,126 @@ msgid "" "inverse." msgstr "" -#: library/calendar.rst:392 +#: library/calendar.rst:400 msgid "The :mod:`calendar` module exports the following data attributes:" msgstr "" -#: library/calendar.rst:396 +#: library/calendar.rst:404 msgid "" "A sequence that represents the days of the week in the current locale, where " "Monday is day number 0." msgstr "" -#: library/calendar.rst:406 +#: library/calendar.rst:414 msgid "" "A sequence that represents the abbreviated days of the week in the current " "locale, where Mon is day number 0." msgstr "" -#: library/calendar.rst:421 +#: library/calendar.rst:429 msgid "" "Aliases for the days of the week, where ``MONDAY`` is ``0`` and ``SUNDAY`` " "is ``6``." msgstr "" -#: library/calendar.rst:429 +#: library/calendar.rst:437 msgid "" "Enumeration defining days of the week as integer constants. The members of " "this enumeration are exported to the module scope as :data:`MONDAY` through :" "data:`SUNDAY`." msgstr "" -#: library/calendar.rst:438 +#: library/calendar.rst:446 msgid "" "A sequence that represents the months of the year in the current locale. " "This follows normal convention of January being month number 1, so it has a " "length of 13 and ``month_name[0]`` is the empty string." msgstr "" -#: library/calendar.rst:449 +#: library/calendar.rst:457 msgid "" "A sequence that represents the abbreviated months of the year in the current " "locale. This follows normal convention of January being month number 1, so " "it has a length of 13 and ``month_abbr[0]`` is the empty string." msgstr "" -#: library/calendar.rst:470 +#: library/calendar.rst:478 msgid "" "Aliases for the months of the year, where ``JANUARY`` is ``1`` and " "``DECEMBER`` is ``12``." msgstr "" -#: library/calendar.rst:478 +#: library/calendar.rst:486 msgid "" "Enumeration defining months of the year as integer constants. The members of " "this enumeration are exported to the module scope as :data:`JANUARY` " "through :data:`DECEMBER`." msgstr "" -#: library/calendar.rst:485 +#: library/calendar.rst:493 msgid "The :mod:`calendar` module defines the following exceptions:" msgstr "" -#: library/calendar.rst:489 +#: library/calendar.rst:497 msgid "" "A subclass of :exc:`ValueError`, raised when the given month number is " "outside of the range 1-12 (inclusive)." msgstr "" -#: library/calendar.rst:494 +#: library/calendar.rst:502 msgid "The invalid month number." msgstr "" -#: library/calendar.rst:499 +#: library/calendar.rst:507 msgid "" "A subclass of :exc:`ValueError`, raised when the given weekday number is " "outside of the range 0-6 (inclusive)." msgstr "" -#: library/calendar.rst:504 +#: library/calendar.rst:512 msgid "The invalid weekday number." msgstr "" -#: library/calendar.rst:509 +#: library/calendar.rst:517 msgid "Module :mod:`datetime`" msgstr "" -#: library/calendar.rst:510 +#: library/calendar.rst:518 msgid "" "Object-oriented interface to dates and times with similar functionality to " "the :mod:`time` module." msgstr "" -#: library/calendar.rst:513 +#: library/calendar.rst:521 msgid "Module :mod:`time`" msgstr "" -#: library/calendar.rst:514 +#: library/calendar.rst:522 msgid "Low-level time related functions." msgstr "" -#: library/calendar.rst:520 +#: library/calendar.rst:528 msgid "Command-Line Usage" msgstr "" -#: library/calendar.rst:524 +#: library/calendar.rst:532 msgid "" "The :mod:`calendar` module can be executed as a script from the command line " "to interactively print a calendar." msgstr "" -#: library/calendar.rst:527 +#: library/calendar.rst:535 msgid "" "python -m calendar [-h] [-L LOCALE] [-e ENCODING] [-t {text,html}]\n" " [-w WIDTH] [-l LINES] [-s SPACING] [-m MONTHS] [-c CSS]\n" " [year] [month]" msgstr "" -#: library/calendar.rst:534 +#: library/calendar.rst:542 msgid "For example, to print a calendar for the year 2000:" msgstr "" -#: library/calendar.rst:536 +#: library/calendar.rst:544 msgid "" "$ python -m calendar 2000\n" " 2000\n" @@ -583,72 +591,72 @@ msgid "" "30 31" msgstr "" -#: library/calendar.rst:577 +#: library/calendar.rst:585 msgid "The following options are accepted:" msgstr "" -#: library/calendar.rst:584 +#: library/calendar.rst:592 msgid "Show the help message and exit." msgstr "" -#: library/calendar.rst:589 +#: library/calendar.rst:597 msgid "The locale to use for month and weekday names. Defaults to English." msgstr "" -#: library/calendar.rst:595 +#: library/calendar.rst:603 msgid "" "The encoding to use for output. :option:`--encoding` is required if :option:" "`--locale` is set." msgstr "" -#: library/calendar.rst:601 +#: library/calendar.rst:609 msgid "Print the calendar to the terminal as text, or as an HTML document." msgstr "" -#: library/calendar.rst:607 +#: library/calendar.rst:615 msgid "" "The year to print the calendar for. Must be a number between 1 and 9999. " "Defaults to the current year." msgstr "" -#: library/calendar.rst:614 +#: library/calendar.rst:622 msgid "" "The month of the specified :option:`year` to print the calendar for. Must be " "a number between 1 and 12, and may only be used in text mode. Defaults to " "printing a calendar for the full year." msgstr "" -#: library/calendar.rst:620 +#: library/calendar.rst:628 msgid "*Text-mode options:*" msgstr "" -#: library/calendar.rst:624 +#: library/calendar.rst:632 msgid "" "The width of the date column in terminal columns. The date is printed " "centred in the column. Any value lower than 2 is ignored. Defaults to 2." msgstr "" -#: library/calendar.rst:632 +#: library/calendar.rst:640 msgid "" "The number of lines for each week in terminal rows. The date is printed top-" "aligned. Any value lower than 1 is ignored. Defaults to 1." msgstr "" -#: library/calendar.rst:640 +#: library/calendar.rst:648 msgid "" "The space between months in columns. Any value lower than 2 is ignored. " "Defaults to 6." msgstr "" -#: library/calendar.rst:647 +#: library/calendar.rst:655 msgid "The number of months printed per row. Defaults to 3." msgstr "" -#: library/calendar.rst:651 +#: library/calendar.rst:659 msgid "*HTML-mode options:*" msgstr "" -#: library/calendar.rst:655 +#: library/calendar.rst:663 msgid "" "The path of a CSS stylesheet to use for the calendar. This must either be " "relative to the generated HTML, or an absolute HTTP or ``file:///`` URL." diff --git a/library/cmath.po b/library/cmath.po index 4f1d65ca8..9919493d7 100644 --- a/library/cmath.po +++ b/library/cmath.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -262,31 +262,30 @@ msgstr "" #: library/cmath.rst:223 msgid "" "Whether or not two values are considered close is determined according to " -"given absolute and relative tolerances." +"given absolute and relative tolerances. If no errors occur, the result will " +"be: ``abs(a-b) <= max(rel_tol * max(abs(a), abs(b)), abs_tol)``." msgstr "" -#: library/cmath.rst:226 +#: library/cmath.rst:227 msgid "" "*rel_tol* is the relative tolerance -- it is the maximum allowed difference " "between *a* and *b*, relative to the larger absolute value of *a* or *b*. " "For example, to set a tolerance of 5%, pass ``rel_tol=0.05``. The default " "tolerance is ``1e-09``, which assures that the two values are the same " -"within about 9 decimal digits. *rel_tol* must be greater than zero." +"within about 9 decimal digits. *rel_tol* must be nonnegative and less than " +"``1.0``." msgstr "" -#: library/cmath.rst:232 +#: library/cmath.rst:234 msgid "" -"*abs_tol* is the minimum absolute tolerance -- useful for comparisons near " -"zero. *abs_tol* must be at least zero." +"*abs_tol* is the absolute tolerance; it defaults to ``0.0`` and it must be " +"nonnegative. When comparing ``x`` to ``0.0``, ``isclose(x, 0)`` is computed " +"as ``abs(x) <= rel_tol * abs(x)``, which is ``False`` for any ``x`` and " +"rel_tol less than ``1.0``. So add an appropriate positive abs_tol argument " +"to the call." msgstr "" -#: library/cmath.rst:235 -msgid "" -"If no errors occur, the result will be: ``abs(a-b) <= max(rel_tol * " -"max(abs(a), abs(b)), abs_tol)``." -msgstr "" - -#: library/cmath.rst:238 +#: library/cmath.rst:240 msgid "" "The IEEE 754 special values of ``NaN``, ``inf``, and ``-inf`` will be " "handled according to IEEE rules. Specifically, ``NaN`` is not considered " @@ -294,49 +293,49 @@ msgid "" "considered close to themselves." msgstr "" -#: library/cmath.rst:247 +#: library/cmath.rst:249 msgid ":pep:`485` -- A function for testing approximate equality" msgstr "" -#: library/cmath.rst:251 +#: library/cmath.rst:253 msgid "Constants" msgstr "" -#: library/cmath.rst:255 +#: library/cmath.rst:257 msgid "The mathematical constant *π*, as a float." msgstr "" -#: library/cmath.rst:260 +#: library/cmath.rst:262 msgid "The mathematical constant *e*, as a float." msgstr "" -#: library/cmath.rst:265 +#: library/cmath.rst:267 msgid "The mathematical constant *τ*, as a float." msgstr "" -#: library/cmath.rst:272 +#: library/cmath.rst:274 msgid "Floating-point positive infinity. Equivalent to ``float('inf')``." msgstr "" -#: library/cmath.rst:279 +#: library/cmath.rst:281 msgid "" "Complex number with zero real part and positive infinity imaginary part. " "Equivalent to ``complex(0.0, float('inf'))``." msgstr "" -#: library/cmath.rst:287 +#: library/cmath.rst:289 msgid "" "A floating-point \"not a number\" (NaN) value. Equivalent to " "``float('nan')``." msgstr "" -#: library/cmath.rst:295 +#: library/cmath.rst:297 msgid "" "Complex number with zero real part and NaN imaginary part. Equivalent to " "``complex(0.0, float('nan'))``." msgstr "" -#: library/cmath.rst:303 +#: library/cmath.rst:305 msgid "" "Note that the selection of functions is similar, but not identical, to that " "in module :mod:`math`. The reason for having two modules is that some users " @@ -348,7 +347,7 @@ msgid "" "zero)." msgstr "" -#: library/cmath.rst:311 +#: library/cmath.rst:313 msgid "" "A note on branch cuts: They are curves along which the given function fails " "to be continuous. They are a necessary feature of many complex functions. " @@ -359,17 +358,17 @@ msgid "" "following:" msgstr "" -#: library/cmath.rst:321 +#: library/cmath.rst:323 msgid "" "Kahan, W: Branch cuts for complex elementary functions; or, Much ado about " "nothing's sign bit. In Iserles, A., and Powell, M. (eds.), The state of the " "art in numerical analysis. Clarendon Press (1987) pp165--211." msgstr "" -#: library/cmath.rst:301 +#: library/cmath.rst:303 msgid "module" msgstr "" -#: library/cmath.rst:301 +#: library/cmath.rst:303 msgid "math" msgstr "" diff --git a/library/collections.po b/library/collections.po index aa133e630..f27a128ec 100644 --- a/library/collections.po +++ b/library/collections.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1023,10 +1023,10 @@ msgstr "" msgid "" "When each key is encountered for the first time, it is not already in the " "mapping; so an entry is automatically created using the :attr:`~defaultdict." -"default_factory` function which returns an empty :class:`list`. The :meth:" -"`list.append` operation then attaches the value to the new list. When keys " +"default_factory` function which returns an empty :class:`list`. The :meth:`!" +"list.append` operation then attaches the value to the new list. When keys " "are encountered again, the look-up proceeds normally (returning the list for " -"that key) and the :meth:`list.append` operation adds another value to the " +"that key) and the :meth:`!list.append` operation adds another value to the " "list. This technique is simpler and faster than an equivalent technique " "using :meth:`dict.setdefault`:" msgstr "" diff --git a/library/ctypes.po b/library/ctypes.po index 8a16f99e3..ab88a1ecc 100644 --- a/library/ctypes.po +++ b/library/ctypes.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -310,7 +310,7 @@ msgid "" "learn more about :mod:`ctypes` data types." msgstr "" -#: library/ctypes.rst:2208 +#: library/ctypes.rst:2237 msgid "Fundamental data types" msgstr "" @@ -2016,7 +2016,7 @@ msgid "" "If no library can be found, returns ``None``." msgstr "" -#: library/ctypes.rst:1982 +#: library/ctypes.rst:1997 msgid "The exact functionality is system dependent." msgstr "" @@ -2116,7 +2116,7 @@ msgid "" "determine which one is not found using Windows debugging and tracing tools." msgstr "" -#: library/ctypes.rst:1406 library/ctypes.rst:1434 +#: library/ctypes.rst:1408 library/ctypes.rst:1439 msgid "The *name* parameter can now be a :term:`path-like object`." msgstr "" @@ -2128,34 +2128,40 @@ msgstr "" #: library/ctypes.rst:1393 msgid "" -"Windows only: Instances of this class represent loaded shared libraries, " -"functions in these libraries use the ``stdcall`` calling convention, and are " -"assumed to return the windows specific :class:`HRESULT` code. :class:" -"`HRESULT` values contain information specifying whether the function call " -"failed or succeeded, together with additional error code. If the return " -"value signals a failure, an :class:`OSError` is automatically raised." +"Instances of this class represent loaded shared libraries, functions in " +"these libraries use the ``stdcall`` calling convention, and are assumed to " +"return the windows specific :class:`HRESULT` code. :class:`HRESULT` values " +"contain information specifying whether the function call failed or " +"succeeded, together with additional error code. If the return value signals " +"a failure, an :class:`OSError` is automatically raised." +msgstr "" + +#: library/ctypes.rst:1417 library/ctypes.rst:1569 library/ctypes.rst:1977 +#: library/ctypes.rst:2011 library/ctypes.rst:2029 library/ctypes.rst:2101 +#: library/ctypes.rst:2473 +msgid "Availability" msgstr "" -#: library/ctypes.rst:1400 +#: library/ctypes.rst:1402 msgid "" ":exc:`WindowsError` used to be raised, which is now an alias of :exc:" "`OSError`." msgstr "" -#: library/ctypes.rst:1411 +#: library/ctypes.rst:1413 msgid "" -"Windows only: Instances of this class represent loaded shared libraries, " -"functions in these libraries use the ``stdcall`` calling convention, and are " -"assumed to return :c:expr:`int` by default." +"Instances of this class represent loaded shared libraries, functions in " +"these libraries use the ``stdcall`` calling convention, and are assumed to " +"return :c:expr:`int` by default." msgstr "" -#: library/ctypes.rst:1419 +#: library/ctypes.rst:1424 msgid "" "The Python :term:`global interpreter lock` is released before calling any " "function exported by these libraries, and reacquired afterwards." msgstr "" -#: library/ctypes.rst:1425 +#: library/ctypes.rst:1430 msgid "" "Instances of this class behave like :class:`CDLL` instances, except that the " "Python GIL is *not* released during the function call, and after the " @@ -2163,11 +2169,11 @@ msgid "" "set, a Python exception is raised." msgstr "" -#: library/ctypes.rst:1430 +#: library/ctypes.rst:1435 msgid "Thus, this is only useful to call Python C api functions directly." msgstr "" -#: library/ctypes.rst:1436 +#: library/ctypes.rst:1441 msgid "" "All these classes can be instantiated by calling them with at least one " "argument, the pathname of the shared library. If you have an existing " @@ -2177,7 +2183,7 @@ msgid "" "the process, and to get a handle to it." msgstr "" -#: library/ctypes.rst:1443 +#: library/ctypes.rst:1448 msgid "" "The *mode* parameter can be used to specify how the library is loaded. For " "details, consult the :manpage:`dlopen(3)` manpage. On Windows, *mode* is " @@ -2185,7 +2191,7 @@ msgid "" "configurable." msgstr "" -#: library/ctypes.rst:1448 +#: library/ctypes.rst:1453 msgid "" "The *use_errno* parameter, when set to true, enables a ctypes mechanism that " "allows accessing the system :data:`errno` error number in a safe way. :mod:" @@ -2195,14 +2201,14 @@ msgid "" "private copy, the same happens immediately after the function call." msgstr "" -#: library/ctypes.rst:1455 +#: library/ctypes.rst:1460 msgid "" "The function :func:`ctypes.get_errno` returns the value of the ctypes " "private copy, and the function :func:`ctypes.set_errno` changes the ctypes " "private copy to a new value and returns the former value." msgstr "" -#: library/ctypes.rst:1459 +#: library/ctypes.rst:1464 msgid "" "The *use_last_error* parameter, when set to true, enables the same mechanism " "for the Windows error code which is managed by the :func:`GetLastError` and :" @@ -2211,7 +2217,7 @@ msgid "" "private copy of the windows error code." msgstr "" -#: library/ctypes.rst:1465 +#: library/ctypes.rst:1470 msgid "" "The *winmode* parameter is used on Windows to specify how the library is " "loaded (since *mode* is ignored). It takes any value that is valid for the " @@ -2221,29 +2227,29 @@ msgid "" "ensure the correct library and dependencies are loaded." msgstr "" -#: library/ctypes.rst:1472 +#: library/ctypes.rst:1477 msgid "Added *winmode* parameter." msgstr "" -#: library/ctypes.rst:1479 +#: library/ctypes.rst:1484 msgid "" "Flag to use as *mode* parameter. On platforms where this flag is not " "available, it is defined as the integer zero." msgstr "" -#: library/ctypes.rst:1486 +#: library/ctypes.rst:1491 msgid "" "Flag to use as *mode* parameter. On platforms where this is not available, " "it is the same as *RTLD_GLOBAL*." msgstr "" -#: library/ctypes.rst:1493 +#: library/ctypes.rst:1498 msgid "" "The default mode which is used to load shared libraries. On OSX 10.3, this " "is *RTLD_GLOBAL*, otherwise it is the same as *RTLD_LOCAL*." msgstr "" -#: library/ctypes.rst:1496 +#: library/ctypes.rst:1501 msgid "" "Instances of these classes have no public methods. Functions exported by " "the shared library can be accessed as attributes or by index. Please note " @@ -2252,7 +2258,7 @@ msgid "" "other hand, accessing it through an index returns a new object each time::" msgstr "" -#: library/ctypes.rst:1502 +#: library/ctypes.rst:1507 msgid "" ">>> from ctypes import CDLL\n" ">>> libc = CDLL(\"libc.so.6\") # On Linux\n" @@ -2262,21 +2268,21 @@ msgid "" "False" msgstr "" -#: library/ctypes.rst:1509 +#: library/ctypes.rst:1514 msgid "" "The following public attributes are available, their name starts with an " "underscore to not clash with exported function names:" msgstr "" -#: library/ctypes.rst:1515 +#: library/ctypes.rst:1520 msgid "The system handle used to access the library." msgstr "" -#: library/ctypes.rst:1520 +#: library/ctypes.rst:1525 msgid "The name of the library passed in the constructor." msgstr "" -#: library/ctypes.rst:1522 +#: library/ctypes.rst:1527 msgid "" "Shared libraries can also be loaded by using one of the prefabricated " "objects, which are instances of the :class:`LibraryLoader` class, either by " @@ -2284,13 +2290,13 @@ msgid "" "library as attribute of the loader instance." msgstr "" -#: library/ctypes.rst:1530 +#: library/ctypes.rst:1535 msgid "" "Class which loads shared libraries. *dlltype* should be one of the :class:" "`CDLL`, :class:`PyDLL`, :class:`WinDLL`, or :class:`OleDLL` types." msgstr "" -#: library/ctypes.rst:1533 +#: library/ctypes.rst:1538 msgid "" ":meth:`!__getattr__` has special behavior: It allows loading a shared " "library by accessing it as attribute of a library loader instance. The " @@ -2298,39 +2304,39 @@ msgid "" "each time." msgstr "" -#: library/ctypes.rst:1539 +#: library/ctypes.rst:1544 msgid "" "Load a shared library into the process and return it. This method always " "returns a new instance of the library." msgstr "" -#: library/ctypes.rst:1543 +#: library/ctypes.rst:1548 msgid "These prefabricated library loaders are available:" msgstr "" -#: library/ctypes.rst:1548 +#: library/ctypes.rst:1553 msgid "Creates :class:`CDLL` instances." msgstr "" -#: library/ctypes.rst:1554 -msgid "Windows only: Creates :class:`WinDLL` instances." +#: library/ctypes.rst:1559 +msgid "Creates :class:`WinDLL` instances." msgstr "" -#: library/ctypes.rst:1560 -msgid "Windows only: Creates :class:`OleDLL` instances." +#: library/ctypes.rst:1567 +msgid "Creates :class:`OleDLL` instances." msgstr "" -#: library/ctypes.rst:1566 +#: library/ctypes.rst:1575 msgid "Creates :class:`PyDLL` instances." msgstr "" -#: library/ctypes.rst:1569 +#: library/ctypes.rst:1578 msgid "" "For accessing the C Python api directly, a ready-to-use Python shared " "library object is available:" msgstr "" -#: library/ctypes.rst:1575 +#: library/ctypes.rst:1584 msgid "" "An instance of :class:`PyDLL` that exposes Python C API functions as " "attributes. Note that all these functions are assumed to return C :c:expr:" @@ -2338,32 +2344,32 @@ msgid "" "correct :attr:`!restype` attribute to use these functions." msgstr "" -#: library/ctypes.rst:1582 +#: library/ctypes.rst:1591 msgid "" "Loading a library through any of these objects raises an :ref:`auditing " "event ` ``ctypes.dlopen`` with string argument ``name``, the name " "used to load the library." msgstr "" -#: library/ctypes.rst:1588 +#: library/ctypes.rst:1597 msgid "" "Accessing a function on a loaded library raises an auditing event ``ctypes." "dlsym`` with arguments ``library`` (the library object) and ``name`` (the " "symbol's name as a string or integer)." msgstr "" -#: library/ctypes.rst:1594 +#: library/ctypes.rst:1603 msgid "" "In cases when only the library handle is available rather than the object, " "accessing a function raises an auditing event ``ctypes.dlsym/handle`` with " "arguments ``handle`` (the raw library handle) and ``name``." msgstr "" -#: library/ctypes.rst:1601 +#: library/ctypes.rst:1610 msgid "Foreign functions" msgstr "" -#: library/ctypes.rst:1603 +#: library/ctypes.rst:1612 msgid "" "As explained in the previous section, foreign functions can be accessed as " "attributes of loaded shared libraries. The function objects created in this " @@ -2372,13 +2378,13 @@ msgid "" "library loader." msgstr "" -#: library/ctypes.rst:1608 +#: library/ctypes.rst:1617 msgid "" "They are instances of a private local class :class:`!_FuncPtr` (not exposed " "in :mod:`!ctypes`) which inherits from the private :class:`_CFuncPtr` class:" msgstr "" -#: library/ctypes.rst:1611 +#: library/ctypes.rst:1620 msgid "" ">>> import ctypes\n" ">>> lib = ctypes.CDLL(None)\n" @@ -2388,29 +2394,29 @@ msgid "" "False" msgstr "" -#: library/ctypes.rst:1622 +#: library/ctypes.rst:1631 msgid "Base class for C callable foreign functions." msgstr "" -#: library/ctypes.rst:1624 +#: library/ctypes.rst:1633 msgid "" "Instances of foreign functions are also C compatible data types; they " "represent C function pointers." msgstr "" -#: library/ctypes.rst:1627 +#: library/ctypes.rst:1636 msgid "" "This behavior can be customized by assigning to special attributes of the " "foreign function object." msgstr "" -#: library/ctypes.rst:1632 +#: library/ctypes.rst:1641 msgid "" "Assign a ctypes type to specify the result type of the foreign function. Use " "``None`` for :c:expr:`void`, a function not returning anything." msgstr "" -#: library/ctypes.rst:1635 +#: library/ctypes.rst:1644 msgid "" "It is possible to assign a callable Python object that is not a ctypes type, " "in this case the function is assumed to return a C :c:expr:`int`, and the " @@ -2420,7 +2426,7 @@ msgid "" "callable to the :attr:`errcheck` attribute." msgstr "" -#: library/ctypes.rst:1644 +#: library/ctypes.rst:1653 msgid "" "Assign a tuple of ctypes types to specify the argument types that the " "function accepts. Functions using the ``stdcall`` calling convention can " @@ -2429,7 +2435,7 @@ msgid "" "unspecified arguments as well." msgstr "" -#: library/ctypes.rst:1650 +#: library/ctypes.rst:1659 msgid "" "When a foreign function is called, each actual argument is passed to the :" "meth:`~_CData.from_param` class method of the items in the :attr:`argtypes` " @@ -2439,7 +2445,7 @@ msgid "" "object using ctypes conversion rules." msgstr "" -#: library/ctypes.rst:1657 +#: library/ctypes.rst:1666 msgid "" "New: It is now possible to put items in argtypes which are not ctypes types, " "but each item must have a :meth:`~_CData.from_param` method which returns a " @@ -2447,44 +2453,44 @@ msgid "" "defining adapters that can adapt custom objects as function parameters." msgstr "" -#: library/ctypes.rst:1664 +#: library/ctypes.rst:1673 msgid "" "Assign a Python function or another callable to this attribute. The callable " "will be called with three or more arguments:" msgstr "" -#: library/ctypes.rst:1671 +#: library/ctypes.rst:1680 msgid "" "*result* is what the foreign function returns, as specified by the :attr:`!" "restype` attribute." msgstr "" -#: library/ctypes.rst:1674 +#: library/ctypes.rst:1683 msgid "" "*func* is the foreign function object itself, this allows reusing the same " "callable object to check or post process the results of several functions." msgstr "" -#: library/ctypes.rst:1678 +#: library/ctypes.rst:1687 msgid "" "*arguments* is a tuple containing the parameters originally passed to the " "function call, this allows specializing the behavior on the arguments used." msgstr "" -#: library/ctypes.rst:1682 +#: library/ctypes.rst:1691 msgid "" "The object that this function returns will be returned from the foreign " "function call, but it can also check the result value and raise an exception " "if the foreign function call failed." msgstr "" -#: library/ctypes.rst:1689 +#: library/ctypes.rst:1698 msgid "" "This exception is raised when a foreign function call cannot convert one of " "the passed arguments." msgstr "" -#: library/ctypes.rst:1695 +#: library/ctypes.rst:1704 msgid "" "On Windows, when a foreign function call raises a system exception (for " "example, due to an access violation), it will be captured and replaced with " @@ -2493,18 +2499,18 @@ msgid "" "hook to replace the exception with its own." msgstr "" -#: library/ctypes.rst:1703 +#: library/ctypes.rst:1712 msgid "" "Some ways to invoke foreign function calls may raise an auditing event " "``ctypes.call_function`` with arguments ``function pointer`` and " "``arguments``." msgstr "" -#: library/ctypes.rst:1709 +#: library/ctypes.rst:1718 msgid "Function prototypes" msgstr "" -#: library/ctypes.rst:1711 +#: library/ctypes.rst:1720 msgid "" "Foreign functions can also be created by instantiating function prototypes. " "Function prototypes are similar to function prototypes in C; they describe a " @@ -2515,7 +2521,7 @@ msgid "" "``@wrapper`` syntax. See :ref:`ctypes-callback-functions` for examples." msgstr "" -#: library/ctypes.rst:1722 +#: library/ctypes.rst:1731 msgid "" "The returned function prototype creates functions that use the standard C " "calling convention. The function will release the GIL during the call. If " @@ -2524,37 +2530,37 @@ msgid "" "after the call; *use_last_error* does the same for the Windows error code." msgstr "" -#: library/ctypes.rst:1732 +#: library/ctypes.rst:1741 msgid "" -"Windows only: The returned function prototype creates functions that use the " -"``stdcall`` calling convention. The function will release the GIL during " -"the call. *use_errno* and *use_last_error* have the same meaning as above." +"The returned function prototype creates functions that use the ``stdcall`` " +"calling convention. The function will release the GIL during the call. " +"*use_errno* and *use_last_error* have the same meaning as above." msgstr "" -#: library/ctypes.rst:1740 +#: library/ctypes.rst:1751 msgid "" "The returned function prototype creates functions that use the Python " "calling convention. The function will *not* release the GIL during the call." msgstr "" -#: library/ctypes.rst:1743 +#: library/ctypes.rst:1754 msgid "" "Function prototypes created by these factory functions can be instantiated " "in different ways, depending on the type and number of the parameters in the " "call:" msgstr "" -#: library/ctypes.rst:1750 +#: library/ctypes.rst:1761 msgid "" "Returns a foreign function at the specified address which must be an integer." msgstr "" -#: library/ctypes.rst:1757 +#: library/ctypes.rst:1768 msgid "" "Create a C callable function (a callback function) from a Python *callable*." msgstr "" -#: library/ctypes.rst:1764 +#: library/ctypes.rst:1775 msgid "" "Returns a foreign function exported by a shared library. *func_spec* must be " "a 2-tuple ``(name_or_ordinal, library)``. The first item is the name of the " @@ -2562,7 +2568,7 @@ msgid "" "small integer. The second item is the shared library instance." msgstr "" -#: library/ctypes.rst:1774 +#: library/ctypes.rst:1785 msgid "" "Returns a foreign function that will call a COM method. *vtbl_index* is the " "index into the virtual function table, a small non-negative integer. *name* " @@ -2570,79 +2576,79 @@ msgid "" "identifier which is used in extended error reporting." msgstr "" -#: library/ctypes.rst:1779 +#: library/ctypes.rst:1790 msgid "" "COM methods use a special calling convention: They require a pointer to the " "COM interface as first argument, in addition to those parameters that are " "specified in the :attr:`!argtypes` tuple." msgstr "" -#: library/ctypes.rst:1783 +#: library/ctypes.rst:1794 msgid "" "The optional *paramflags* parameter creates foreign function wrappers with " "much more functionality than the features described above." msgstr "" -#: library/ctypes.rst:1786 +#: library/ctypes.rst:1797 msgid "" "*paramflags* must be a tuple of the same length as :attr:`~_CFuncPtr." "argtypes`." msgstr "" -#: library/ctypes.rst:1788 +#: library/ctypes.rst:1799 msgid "" "Each item in this tuple contains further information about a parameter, it " "must be a tuple containing one, two, or three items." msgstr "" -#: library/ctypes.rst:1791 +#: library/ctypes.rst:1802 msgid "" "The first item is an integer containing a combination of direction flags for " "the parameter:" msgstr "" -#: library/ctypes.rst:1794 +#: library/ctypes.rst:1805 msgid "1" msgstr "" -#: library/ctypes.rst:1795 +#: library/ctypes.rst:1806 msgid "Specifies an input parameter to the function." msgstr "" -#: library/ctypes.rst:1797 +#: library/ctypes.rst:1808 msgid "2" msgstr "" -#: library/ctypes.rst:1798 +#: library/ctypes.rst:1809 msgid "Output parameter. The foreign function fills in a value." msgstr "" -#: library/ctypes.rst:1800 +#: library/ctypes.rst:1811 msgid "4" msgstr "" -#: library/ctypes.rst:1801 +#: library/ctypes.rst:1812 msgid "Input parameter which defaults to the integer zero." msgstr "" -#: library/ctypes.rst:1803 +#: library/ctypes.rst:1814 msgid "" "The optional second item is the parameter name as string. If this is " "specified, the foreign function can be called with named parameters." msgstr "" -#: library/ctypes.rst:1806 +#: library/ctypes.rst:1817 msgid "The optional third item is the default value for this parameter." msgstr "" -#: library/ctypes.rst:1809 +#: library/ctypes.rst:1820 msgid "" "The following example demonstrates how to wrap the Windows ``MessageBoxW`` " "function so that it supports default parameters and named arguments. The C " "declaration from the windows header file is this::" msgstr "" -#: library/ctypes.rst:1813 +#: library/ctypes.rst:1824 msgid "" "WINUSERAPI int WINAPI\n" "MessageBoxW(\n" @@ -2652,11 +2658,11 @@ msgid "" " UINT uType);" msgstr "" -#: library/ctypes.rst:1843 +#: library/ctypes.rst:1854 msgid "Here is the wrapping with :mod:`ctypes`::" msgstr "" -#: library/ctypes.rst:1822 +#: library/ctypes.rst:1833 msgid "" ">>> from ctypes import c_int, WINFUNCTYPE, windll\n" ">>> from ctypes.wintypes import HWND, LPCWSTR, UINT\n" @@ -2666,18 +2672,18 @@ msgid "" ">>> MessageBox = prototype((\"MessageBoxW\", windll.user32), paramflags)" msgstr "" -#: library/ctypes.rst:1828 +#: library/ctypes.rst:1839 msgid "The ``MessageBox`` foreign function can now be called in these ways::" msgstr "" -#: library/ctypes.rst:1830 +#: library/ctypes.rst:1841 msgid "" ">>> MessageBox()\n" ">>> MessageBox(text=\"Spam, spam, spam\")\n" ">>> MessageBox(flags=2, text=\"foo bar\")" msgstr "" -#: library/ctypes.rst:1834 +#: library/ctypes.rst:1845 msgid "" "A second example demonstrates output parameters. The win32 " "``GetWindowRect`` function retrieves the dimensions of a specified window by " @@ -2685,7 +2691,7 @@ msgid "" "the C declaration::" msgstr "" -#: library/ctypes.rst:1838 +#: library/ctypes.rst:1849 msgid "" "WINUSERAPI BOOL WINAPI\n" "GetWindowRect(\n" @@ -2693,7 +2699,7 @@ msgid "" " LPRECT lpRect);" msgstr "" -#: library/ctypes.rst:1845 +#: library/ctypes.rst:1856 msgid "" ">>> from ctypes import POINTER, WINFUNCTYPE, windll, WinError\n" ">>> from ctypes.wintypes import BOOL, HWND, RECT\n" @@ -2704,7 +2710,7 @@ msgid "" ">>>" msgstr "" -#: library/ctypes.rst:1852 +#: library/ctypes.rst:1863 msgid "" "Functions with output parameters will automatically return the output " "parameter value if there is a single one, or a tuple containing the output " @@ -2712,7 +2718,7 @@ msgid "" "now returns a RECT instance, when called." msgstr "" -#: library/ctypes.rst:1857 +#: library/ctypes.rst:1868 msgid "" "Output parameters can be combined with the :attr:`~_CFuncPtr.errcheck` " "protocol to do further output processing and error checking. The win32 " @@ -2721,7 +2727,7 @@ msgid "" "exception when the api call failed::" msgstr "" -#: library/ctypes.rst:1862 +#: library/ctypes.rst:1873 msgid "" ">>> def errcheck(result, func, args):\n" "... if not result:\n" @@ -2732,7 +2738,7 @@ msgid "" ">>>" msgstr "" -#: library/ctypes.rst:1870 +#: library/ctypes.rst:1881 msgid "" "If the :attr:`~_CFuncPtr.errcheck` function returns the argument tuple it " "receives unchanged, :mod:`ctypes` continues the normal processing it does on " @@ -2741,7 +2747,7 @@ msgid "" "and return them instead, the normal processing will no longer take place::" msgstr "" -#: library/ctypes.rst:1876 +#: library/ctypes.rst:1887 msgid "" ">>> def errcheck(result, func, args):\n" "... if not result:\n" @@ -2753,50 +2759,50 @@ msgid "" ">>>" msgstr "" -#: library/ctypes.rst:1889 +#: library/ctypes.rst:1900 msgid "Utility functions" msgstr "" -#: library/ctypes.rst:1893 +#: library/ctypes.rst:1904 msgid "" "Returns the address of the memory buffer as integer. *obj* must be an " "instance of a ctypes type." msgstr "" -#: library/ctypes.rst:1896 +#: library/ctypes.rst:1907 msgid "" "Raises an :ref:`auditing event ` ``ctypes.addressof`` with " "argument ``obj``." msgstr "" -#: library/ctypes.rst:1901 +#: library/ctypes.rst:1912 msgid "" "Returns the alignment requirements of a ctypes type. *obj_or_type* must be a " "ctypes type or instance." msgstr "" -#: library/ctypes.rst:1907 +#: library/ctypes.rst:1918 msgid "" "Returns a light-weight pointer to *obj*, which must be an instance of a " "ctypes type. *offset* defaults to zero, and must be an integer that will be " "added to the internal pointer value." msgstr "" -#: library/ctypes.rst:1911 +#: library/ctypes.rst:1922 msgid "``byref(obj, offset)`` corresponds to this C code::" msgstr "" -#: library/ctypes.rst:1913 +#: library/ctypes.rst:1924 msgid "(((char *)&obj) + offset)" msgstr "" -#: library/ctypes.rst:1915 +#: library/ctypes.rst:1926 msgid "" "The returned object can only be used as a foreign function call parameter. " "It behaves similar to ``pointer(obj)``, but the construction is a lot faster." msgstr "" -#: library/ctypes.rst:1921 +#: library/ctypes.rst:1932 msgid "" "This function is similar to the cast operator in C. It returns a new " "instance of *type* which points to the same memory block as *obj*. *type* " @@ -2804,19 +2810,19 @@ msgid "" "as a pointer." msgstr "" -#: library/ctypes.rst:1929 +#: library/ctypes.rst:1940 msgid "" "This function creates a mutable character buffer. The returned object is a " "ctypes array of :class:`c_char`." msgstr "" -#: library/ctypes.rst:1932 +#: library/ctypes.rst:1943 msgid "" "*init_or_size* must be an integer which specifies the size of the array, or " "a bytes object which will be used to initialize the array items." msgstr "" -#: library/ctypes.rst:1935 +#: library/ctypes.rst:1946 msgid "" "If a bytes object is specified as first argument, the buffer is made one " "item larger than its length so that the last element in the array is a NUL " @@ -2825,25 +2831,25 @@ msgid "" "not be used." msgstr "" -#: library/ctypes.rst:1940 +#: library/ctypes.rst:1951 msgid "" "Raises an :ref:`auditing event ` ``ctypes.create_string_buffer`` " "with arguments ``init``, ``size``." msgstr "" -#: library/ctypes.rst:1945 +#: library/ctypes.rst:1956 msgid "" "This function creates a mutable unicode character buffer. The returned " "object is a ctypes array of :class:`c_wchar`." msgstr "" -#: library/ctypes.rst:1948 +#: library/ctypes.rst:1959 msgid "" "*init_or_size* must be an integer which specifies the size of the array, or " "a string which will be used to initialize the array items." msgstr "" -#: library/ctypes.rst:1951 +#: library/ctypes.rst:1962 msgid "" "If a string is specified as first argument, the buffer is made one item " "larger than the length of the string so that the last element in the array " @@ -2852,27 +2858,27 @@ msgid "" "should not be used." msgstr "" -#: library/ctypes.rst:1957 +#: library/ctypes.rst:1968 msgid "" "Raises an :ref:`auditing event ` ``ctypes.create_unicode_buffer`` " "with arguments ``init``, ``size``." msgstr "" -#: library/ctypes.rst:1962 +#: library/ctypes.rst:1973 msgid "" -"Windows only: This function is a hook which allows implementing in-process " -"COM servers with ctypes. It is called from the DllCanUnloadNow function " -"that the _ctypes extension dll exports." +"This function is a hook which allows implementing in-process COM servers " +"with ctypes. It is called from the DllCanUnloadNow function that the " +"_ctypes extension dll exports." msgstr "" -#: library/ctypes.rst:1969 +#: library/ctypes.rst:1982 msgid "" -"Windows only: This function is a hook which allows implementing in-process " -"COM servers with ctypes. It is called from the DllGetClassObject function " -"that the ``_ctypes`` extension dll exports." +"This function is a hook which allows implementing in-process COM servers " +"with ctypes. It is called from the DllGetClassObject function that the " +"``_ctypes`` extension dll exports." msgstr "" -#: library/ctypes.rst:1977 +#: library/ctypes.rst:1992 msgid "" "Try to find a library and return a pathname. *name* is the library name " "without any prefix like ``lib``, suffix like ``.so``, ``.dylib`` or version " @@ -2880,92 +2886,92 @@ msgid "" "If no library can be found, returns ``None``." msgstr "" -#: library/ctypes.rst:1988 +#: library/ctypes.rst:2003 msgid "" -"Windows only: return the filename of the VC runtime library used by Python, " -"and by the extension modules. If the name of the library cannot be " -"determined, ``None`` is returned." +"Returns the filename of the VC runtime library used by Python, and by the " +"extension modules. If the name of the library cannot be determined, " +"``None`` is returned." msgstr "" -#: library/ctypes.rst:1992 +#: library/ctypes.rst:2007 msgid "" "If you need to free memory, for example, allocated by an extension module " "with a call to the ``free(void *)``, it is important that you use the " "function in the same library that allocated the memory." msgstr "" -#: library/ctypes.rst:1999 +#: library/ctypes.rst:2016 msgid "" -"Windows only: Returns a textual description of the error code *code*. If no " -"error code is specified, the last error code is used by calling the Windows " -"api function GetLastError." +"Returns a textual description of the error code *code*. If no error code is " +"specified, the last error code is used by calling the Windows api function " +"GetLastError." msgstr "" -#: library/ctypes.rst:2006 +#: library/ctypes.rst:2025 msgid "" -"Windows only: Returns the last error code set by Windows in the calling " -"thread. This function calls the Windows ``GetLastError()`` function " -"directly, it does not return the ctypes-private copy of the error code." +"Returns the last error code set by Windows in the calling thread. This " +"function calls the Windows ``GetLastError()`` function directly, it does not " +"return the ctypes-private copy of the error code." msgstr "" -#: library/ctypes.rst:2012 +#: library/ctypes.rst:2034 msgid "" "Returns the current value of the ctypes-private copy of the system :data:" "`errno` variable in the calling thread." msgstr "" -#: library/ctypes.rst:2015 +#: library/ctypes.rst:2037 msgid "" "Raises an :ref:`auditing event ` ``ctypes.get_errno`` with no " "arguments." msgstr "" -#: library/ctypes.rst:2019 +#: library/ctypes.rst:2041 msgid "" -"Windows only: returns the current value of the ctypes-private copy of the " -"system :data:`!LastError` variable in the calling thread." +"Returns the current value of the ctypes-private copy of the system :data:`!" +"LastError` variable in the calling thread." msgstr "" -#: library/ctypes.rst:2022 +#: library/ctypes.rst:2046 msgid "" "Raises an :ref:`auditing event ` ``ctypes.get_last_error`` with no " "arguments." msgstr "" -#: library/ctypes.rst:2026 +#: library/ctypes.rst:2051 msgid "" "Same as the standard C memmove library function: copies *count* bytes from " "*src* to *dst*. *dst* and *src* must be integers or ctypes instances that " "can be converted to pointers." msgstr "" -#: library/ctypes.rst:2033 +#: library/ctypes.rst:2058 msgid "" "Same as the standard C memset library function: fills the memory block at " "address *dst* with *count* bytes of value *c*. *dst* must be an integer " "specifying an address, or a ctypes instance." msgstr "" -#: library/ctypes.rst:2040 +#: library/ctypes.rst:2065 msgid "" "Create and return a new ctypes pointer type. Pointer types are cached and " "reused internally, so calling this function repeatedly is cheap. *type* must " "be a ctypes type." msgstr "" -#: library/ctypes.rst:2047 +#: library/ctypes.rst:2072 msgid "" "Create a new pointer instance, pointing to *obj*. The returned object is of " "the type ``POINTER(type(obj))``." msgstr "" -#: library/ctypes.rst:2050 +#: library/ctypes.rst:2075 msgid "" "Note: If you just want to pass a pointer to an object to a foreign function " "call, you should use ``byref(obj)`` which is much faster." msgstr "" -#: library/ctypes.rst:2056 +#: library/ctypes.rst:2081 msgid "" "This function resizes the internal memory buffer of *obj*, which must be an " "instance of a ctypes type. It is not possible to make the buffer smaller " @@ -2973,82 +2979,81 @@ msgid "" "but it is possible to enlarge the buffer." msgstr "" -#: library/ctypes.rst:2064 +#: library/ctypes.rst:2089 msgid "" "Set the current value of the ctypes-private copy of the system :data:`errno` " "variable in the calling thread to *value* and return the previous value." msgstr "" -#: library/ctypes.rst:2067 +#: library/ctypes.rst:2092 msgid "" "Raises an :ref:`auditing event ` ``ctypes.set_errno`` with " "argument ``errno``." msgstr "" -#: library/ctypes.rst:2072 +#: library/ctypes.rst:2097 msgid "" -"Windows only: set the current value of the ctypes-private copy of the " -"system :data:`!LastError` variable in the calling thread to *value* and " -"return the previous value." +"Sets the current value of the ctypes-private copy of the system :data:`!" +"LastError` variable in the calling thread to *value* and return the previous " +"value." msgstr "" -#: library/ctypes.rst:2076 +#: library/ctypes.rst:2103 msgid "" "Raises an :ref:`auditing event ` ``ctypes.set_last_error`` with " "argument ``error``." msgstr "" -#: library/ctypes.rst:2081 +#: library/ctypes.rst:2108 msgid "" "Returns the size in bytes of a ctypes type or instance memory buffer. Does " "the same as the C ``sizeof`` operator." msgstr "" -#: library/ctypes.rst:2087 +#: library/ctypes.rst:2114 msgid "" "Return the byte string at *void \\*ptr*. If *size* is specified, it is used " "as size, otherwise the string is assumed to be zero-terminated." msgstr "" -#: library/ctypes.rst:2091 +#: library/ctypes.rst:2118 msgid "" "Raises an :ref:`auditing event ` ``ctypes.string_at`` with " "arguments ``ptr``, ``size``." msgstr "" -#: library/ctypes.rst:2096 +#: library/ctypes.rst:2123 msgid "" -"Windows only: this function is probably the worst-named thing in ctypes. It " -"creates an instance of :exc:`OSError`. If *code* is not specified, " -"``GetLastError`` is called to determine the error code. If *descr* is not " -"specified, :func:`FormatError` is called to get a textual description of the " -"error." +"This function is probably the worst-named thing in ctypes. It creates an " +"instance of :exc:`OSError`. If *code* is not specified, ``GetLastError`` is " +"called to determine the error code. If *descr* is not specified, :func:" +"`FormatError` is called to get a textual description of the error." msgstr "" -#: library/ctypes.rst:2102 +#: library/ctypes.rst:2131 msgid "" "An instance of :exc:`WindowsError` used to be created, which is now an alias " "of :exc:`OSError`." msgstr "" -#: library/ctypes.rst:2109 +#: library/ctypes.rst:2138 msgid "" "Return the wide-character string at *void \\*ptr*. If *size* is specified, " "it is used as the number of characters of the string, otherwise the string " "is assumed to be zero-terminated." msgstr "" -#: library/ctypes.rst:2114 +#: library/ctypes.rst:2143 msgid "" "Raises an :ref:`auditing event ` ``ctypes.wstring_at`` with " "arguments ``ptr``, ``size``." msgstr "" -#: library/ctypes.rst:2120 +#: library/ctypes.rst:2149 msgid "Data types" msgstr "" -#: library/ctypes.rst:2125 +#: library/ctypes.rst:2154 msgid "" "This non-public class is the common base class of all ctypes data types. " "Among other things, all ctypes type instances contain a memory block that " @@ -3058,13 +3063,13 @@ msgid "" "alive in case the memory block contains pointers." msgstr "" -#: library/ctypes.rst:2132 +#: library/ctypes.rst:2161 msgid "" "Common methods of ctypes data types, these are all class methods (to be " "exact, they are methods of the :term:`metaclass`):" msgstr "" -#: library/ctypes.rst:2137 +#: library/ctypes.rst:2166 msgid "" "This method returns a ctypes instance that shares the buffer of the *source* " "object. The *source* object must support the writeable buffer interface. " @@ -3073,13 +3078,13 @@ msgid "" "exc:`ValueError` is raised." msgstr "" -#: library/ctypes.rst:2153 +#: library/ctypes.rst:2182 msgid "" "Raises an :ref:`auditing event ` ``ctypes.cdata/buffer`` with " "arguments ``pointer``, ``size``, ``offset``." msgstr "" -#: library/ctypes.rst:2147 +#: library/ctypes.rst:2176 msgid "" "This method creates a ctypes instance, copying the buffer from the *source* " "object buffer which must be readable. The optional *offset* parameter " @@ -3087,19 +3092,19 @@ msgid "" "If the source buffer is not large enough a :exc:`ValueError` is raised." msgstr "" -#: library/ctypes.rst:2157 +#: library/ctypes.rst:2186 msgid "" "This method returns a ctypes type instance using the memory specified by " "*address* which must be an integer." msgstr "" -#: library/ctypes.rst:2162 +#: library/ctypes.rst:2191 msgid "" "This method, and others that indirectly call this method, raises an :ref:" "`auditing event ` ``ctypes.cdata`` with argument ``address``." msgstr "" -#: library/ctypes.rst:2168 +#: library/ctypes.rst:2197 msgid "" "This method adapts *obj* to a ctypes type. It is called with the actual " "object used in a foreign function call when the type is present in the " @@ -3107,25 +3112,25 @@ msgid "" "object that can be used as a function call parameter." msgstr "" -#: library/ctypes.rst:2173 +#: library/ctypes.rst:2202 msgid "" "All ctypes data types have a default implementation of this classmethod that " "normally returns *obj* if that is an instance of the type. Some types " "accept other objects as well." msgstr "" -#: library/ctypes.rst:2179 +#: library/ctypes.rst:2208 msgid "" "This method returns a ctypes type instance exported by a shared library. " "*name* is the name of the symbol that exports the data, *library* is the " "loaded shared library." msgstr "" -#: library/ctypes.rst:2183 +#: library/ctypes.rst:2212 msgid "Common instance variables of ctypes data types:" msgstr "" -#: library/ctypes.rst:2187 +#: library/ctypes.rst:2216 msgid "" "Sometimes ctypes data instances do not own the memory block they contain, " "instead they share part of the memory block of a base object. The :attr:" @@ -3133,13 +3138,13 @@ msgid "" "block." msgstr "" -#: library/ctypes.rst:2194 +#: library/ctypes.rst:2223 msgid "" "This read-only variable is true when the ctypes data instance has allocated " "the memory block itself, false otherwise." msgstr "" -#: library/ctypes.rst:2199 +#: library/ctypes.rst:2228 msgid "" "This member is either ``None`` or a dictionary containing Python objects " "that need to be kept alive so that the memory block contents is kept valid. " @@ -3147,7 +3152,7 @@ msgid "" "dictionary." msgstr "" -#: library/ctypes.rst:2212 +#: library/ctypes.rst:2241 msgid "" "This non-public class is the base class of all fundamental ctypes data " "types. It is mentioned here because it contains the common attributes of the " @@ -3156,11 +3161,11 @@ msgid "" "types that are not and do not contain pointers can now be pickled." msgstr "" -#: library/ctypes.rst:2218 +#: library/ctypes.rst:2247 msgid "Instances have a single attribute:" msgstr "" -#: library/ctypes.rst:2222 +#: library/ctypes.rst:2251 msgid "" "This attribute contains the actual value of the instance. For integer and " "pointer types, it is an integer, for character types, it is a single " @@ -3168,7 +3173,7 @@ msgid "" "bytes object or string." msgstr "" -#: library/ctypes.rst:2227 +#: library/ctypes.rst:2256 msgid "" "When the ``value`` attribute is retrieved from a ctypes instance, usually a " "new object is returned each time. :mod:`ctypes` does *not* implement " @@ -3176,7 +3181,7 @@ msgid "" "true for all other ctypes object instances." msgstr "" -#: library/ctypes.rst:2233 +#: library/ctypes.rst:2262 msgid "" "Fundamental data types, when returned as foreign function call results, or, " "for example, by retrieving structure field members or array items, are " @@ -3186,7 +3191,7 @@ msgid "" "instance." msgstr "" -#: library/ctypes.rst:2241 +#: library/ctypes.rst:2270 msgid "" "Subclasses of fundamental data types do *not* inherit this behavior. So, if " "a foreign functions :attr:`!restype` is a subclass of :class:`c_void_p`, you " @@ -3194,25 +3199,25 @@ msgid "" "you can get the value of the pointer by accessing the ``value`` attribute." msgstr "" -#: library/ctypes.rst:2246 +#: library/ctypes.rst:2275 msgid "These are the fundamental ctypes data types:" msgstr "" -#: library/ctypes.rst:2250 +#: library/ctypes.rst:2279 msgid "" "Represents the C :c:expr:`signed char` datatype, and interprets the value as " "small integer. The constructor accepts an optional integer initializer; no " "overflow checking is done." msgstr "" -#: library/ctypes.rst:2257 +#: library/ctypes.rst:2286 msgid "" "Represents the C :c:expr:`char` datatype, and interprets the value as a " "single character. The constructor accepts an optional string initializer, " "the length of the string must be exactly one character." msgstr "" -#: library/ctypes.rst:2264 +#: library/ctypes.rst:2293 msgid "" "Represents the C :c:expr:`char *` datatype when it points to a zero-" "terminated string. For a general character pointer that may also point to " @@ -3220,182 +3225,182 @@ msgid "" "integer address, or a bytes object." msgstr "" -#: library/ctypes.rst:2272 +#: library/ctypes.rst:2301 msgid "" "Represents the C :c:expr:`double` datatype. The constructor accepts an " "optional float initializer." msgstr "" -#: library/ctypes.rst:2278 +#: library/ctypes.rst:2307 msgid "" "Represents the C :c:expr:`long double` datatype. The constructor accepts an " "optional float initializer. On platforms where ``sizeof(long double) == " "sizeof(double)`` it is an alias to :class:`c_double`." msgstr "" -#: library/ctypes.rst:2284 +#: library/ctypes.rst:2313 msgid "" "Represents the C :c:expr:`float` datatype. The constructor accepts an " "optional float initializer." msgstr "" -#: library/ctypes.rst:2290 +#: library/ctypes.rst:2319 msgid "" "Represents the C :c:expr:`signed int` datatype. The constructor accepts an " "optional integer initializer; no overflow checking is done. On platforms " "where ``sizeof(int) == sizeof(long)`` it is an alias to :class:`c_long`." msgstr "" -#: library/ctypes.rst:2297 +#: library/ctypes.rst:2326 msgid "" "Represents the C 8-bit :c:expr:`signed int` datatype. Usually an alias for :" "class:`c_byte`." msgstr "" -#: library/ctypes.rst:2303 +#: library/ctypes.rst:2332 msgid "" "Represents the C 16-bit :c:expr:`signed int` datatype. Usually an alias " "for :class:`c_short`." msgstr "" -#: library/ctypes.rst:2309 +#: library/ctypes.rst:2338 msgid "" "Represents the C 32-bit :c:expr:`signed int` datatype. Usually an alias " "for :class:`c_int`." msgstr "" -#: library/ctypes.rst:2315 +#: library/ctypes.rst:2344 msgid "" "Represents the C 64-bit :c:expr:`signed int` datatype. Usually an alias " "for :class:`c_longlong`." msgstr "" -#: library/ctypes.rst:2321 +#: library/ctypes.rst:2350 msgid "" "Represents the C :c:expr:`signed long` datatype. The constructor accepts an " "optional integer initializer; no overflow checking is done." msgstr "" -#: library/ctypes.rst:2327 +#: library/ctypes.rst:2356 msgid "" "Represents the C :c:expr:`signed long long` datatype. The constructor " "accepts an optional integer initializer; no overflow checking is done." msgstr "" -#: library/ctypes.rst:2333 +#: library/ctypes.rst:2362 msgid "" "Represents the C :c:expr:`signed short` datatype. The constructor accepts " "an optional integer initializer; no overflow checking is done." msgstr "" -#: library/ctypes.rst:2339 +#: library/ctypes.rst:2368 msgid "Represents the C :c:type:`size_t` datatype." msgstr "" -#: library/ctypes.rst:2344 +#: library/ctypes.rst:2373 msgid "Represents the C :c:type:`ssize_t` datatype." msgstr "" -#: library/ctypes.rst:2351 +#: library/ctypes.rst:2380 msgid "Represents the C :c:type:`time_t` datatype." msgstr "" -#: library/ctypes.rst:2358 +#: library/ctypes.rst:2387 msgid "" "Represents the C :c:expr:`unsigned char` datatype, it interprets the value " "as small integer. The constructor accepts an optional integer initializer; " "no overflow checking is done." msgstr "" -#: library/ctypes.rst:2365 +#: library/ctypes.rst:2394 msgid "" "Represents the C :c:expr:`unsigned int` datatype. The constructor accepts " "an optional integer initializer; no overflow checking is done. On platforms " "where ``sizeof(int) == sizeof(long)`` it is an alias for :class:`c_ulong`." msgstr "" -#: library/ctypes.rst:2372 +#: library/ctypes.rst:2401 msgid "" "Represents the C 8-bit :c:expr:`unsigned int` datatype. Usually an alias " "for :class:`c_ubyte`." msgstr "" -#: library/ctypes.rst:2378 +#: library/ctypes.rst:2407 msgid "" "Represents the C 16-bit :c:expr:`unsigned int` datatype. Usually an alias " "for :class:`c_ushort`." msgstr "" -#: library/ctypes.rst:2384 +#: library/ctypes.rst:2413 msgid "" "Represents the C 32-bit :c:expr:`unsigned int` datatype. Usually an alias " "for :class:`c_uint`." msgstr "" -#: library/ctypes.rst:2390 +#: library/ctypes.rst:2419 msgid "" "Represents the C 64-bit :c:expr:`unsigned int` datatype. Usually an alias " "for :class:`c_ulonglong`." msgstr "" -#: library/ctypes.rst:2396 +#: library/ctypes.rst:2425 msgid "" "Represents the C :c:expr:`unsigned long` datatype. The constructor accepts " "an optional integer initializer; no overflow checking is done." msgstr "" -#: library/ctypes.rst:2402 +#: library/ctypes.rst:2431 msgid "" "Represents the C :c:expr:`unsigned long long` datatype. The constructor " "accepts an optional integer initializer; no overflow checking is done." msgstr "" -#: library/ctypes.rst:2408 +#: library/ctypes.rst:2437 msgid "" "Represents the C :c:expr:`unsigned short` datatype. The constructor accepts " "an optional integer initializer; no overflow checking is done." msgstr "" -#: library/ctypes.rst:2414 +#: library/ctypes.rst:2443 msgid "" "Represents the C :c:expr:`void *` type. The value is represented as " "integer. The constructor accepts an optional integer initializer." msgstr "" -#: library/ctypes.rst:2420 +#: library/ctypes.rst:2449 msgid "" "Represents the C :c:type:`wchar_t` datatype, and interprets the value as a " "single character unicode string. The constructor accepts an optional string " "initializer, the length of the string must be exactly one character." msgstr "" -#: library/ctypes.rst:2427 +#: library/ctypes.rst:2456 msgid "" "Represents the C :c:expr:`wchar_t *` datatype, which must be a pointer to a " "zero-terminated wide character string. The constructor accepts an integer " "address, or a string." msgstr "" -#: library/ctypes.rst:2434 +#: library/ctypes.rst:2463 msgid "" "Represent the C :c:expr:`bool` datatype (more accurately, :c:expr:`_Bool` " "from C99). Its value can be ``True`` or ``False``, and the constructor " "accepts any object that has a truth value." msgstr "" -#: library/ctypes.rst:2441 +#: library/ctypes.rst:2470 msgid "" -"Windows only: Represents a :c:type:`!HRESULT` value, which contains success " -"or error information for a function or method call." +"Represents a :c:type:`!HRESULT` value, which contains success or error " +"information for a function or method call." msgstr "" -#: library/ctypes.rst:2447 +#: library/ctypes.rst:2478 msgid "" "Represents the C :c:expr:`PyObject *` datatype. Calling this without an " "argument creates a ``NULL`` :c:expr:`PyObject *` pointer." msgstr "" -#: library/ctypes.rst:2450 +#: library/ctypes.rst:2481 msgid "" "The :mod:`!ctypes.wintypes` module provides quite some other Windows " "specific data types, for example :c:type:`!HWND`, :c:type:`!WPARAM`, or :c:" @@ -3403,41 +3408,41 @@ msgid "" "are also defined." msgstr "" -#: library/ctypes.rst:2458 +#: library/ctypes.rst:2489 msgid "Structured data types" msgstr "" -#: library/ctypes.rst:2463 +#: library/ctypes.rst:2494 msgid "Abstract base class for unions in native byte order." msgstr "" -#: library/ctypes.rst:2468 +#: library/ctypes.rst:2499 msgid "Abstract base class for unions in *big endian* byte order." msgstr "" -#: library/ctypes.rst:2474 +#: library/ctypes.rst:2505 msgid "Abstract base class for unions in *little endian* byte order." msgstr "" -#: library/ctypes.rst:2480 +#: library/ctypes.rst:2511 msgid "Abstract base class for structures in *big endian* byte order." msgstr "" -#: library/ctypes.rst:2485 +#: library/ctypes.rst:2516 msgid "Abstract base class for structures in *little endian* byte order." msgstr "" -#: library/ctypes.rst:2487 +#: library/ctypes.rst:2518 msgid "" "Structures and unions with non-native byte order cannot contain pointer type " "fields, or any other data types containing pointer type fields." msgstr "" -#: library/ctypes.rst:2493 +#: library/ctypes.rst:2524 msgid "Abstract base class for structures in *native* byte order." msgstr "" -#: library/ctypes.rst:2495 +#: library/ctypes.rst:2526 msgid "" "Concrete structure and union types must be created by subclassing one of " "these types, and at least define a :attr:`_fields_` class variable. :mod:" @@ -3445,34 +3450,34 @@ msgid "" "the fields by direct attribute accesses. These are the" msgstr "" -#: library/ctypes.rst:2503 +#: library/ctypes.rst:2534 msgid "" "A sequence defining the structure fields. The items must be 2-tuples or 3-" "tuples. The first item is the name of the field, the second item specifies " "the type of the field; it can be any ctypes data type." msgstr "" -#: library/ctypes.rst:2507 +#: library/ctypes.rst:2538 msgid "" "For integer type fields like :class:`c_int`, a third optional item can be " "given. It must be a small positive integer defining the bit width of the " "field." msgstr "" -#: library/ctypes.rst:2511 +#: library/ctypes.rst:2542 msgid "" "Field names must be unique within one structure or union. This is not " "checked, only one field can be accessed when names are repeated." msgstr "" -#: library/ctypes.rst:2514 +#: library/ctypes.rst:2545 msgid "" "It is possible to define the :attr:`_fields_` class variable *after* the " "class statement that defines the Structure subclass, this allows creating " "data types that directly or indirectly reference themselves::" msgstr "" -#: library/ctypes.rst:2518 +#: library/ctypes.rst:2549 msgid "" "class List(Structure):\n" " pass\n" @@ -3481,7 +3486,7 @@ msgid "" " ]" msgstr "" -#: library/ctypes.rst:2524 +#: library/ctypes.rst:2555 msgid "" "The :attr:`_fields_` class variable must, however, be defined before the " "type is first used (an instance is created, :func:`sizeof` is called on it, " @@ -3489,14 +3494,14 @@ msgid "" "raise an AttributeError." msgstr "" -#: library/ctypes.rst:2529 +#: library/ctypes.rst:2560 msgid "" "It is possible to define sub-subclasses of structure types, they inherit the " "fields of the base class plus the :attr:`_fields_` defined in the sub-" "subclass, if any." msgstr "" -#: library/ctypes.rst:2536 +#: library/ctypes.rst:2567 msgid "" "An optional small integer that allows overriding the alignment of structure " "fields in the instance. :attr:`_pack_` must already be defined when :attr:" @@ -3504,14 +3509,14 @@ msgid "" "attribute to 0 is the same as not setting it at all." msgstr "" -#: library/ctypes.rst:2544 +#: library/ctypes.rst:2575 msgid "" "An optional sequence that lists the names of unnamed (anonymous) fields. :" "attr:`_anonymous_` must be already defined when :attr:`_fields_` is " "assigned, otherwise it will have no effect." msgstr "" -#: library/ctypes.rst:2548 +#: library/ctypes.rst:2579 msgid "" "The fields listed in this variable must be structure or union type fields. :" "mod:`ctypes` will create descriptors in the structure type that allows " @@ -3519,11 +3524,11 @@ msgid "" "structure or union field." msgstr "" -#: library/ctypes.rst:2553 +#: library/ctypes.rst:2584 msgid "Here is an example type (Windows)::" msgstr "" -#: library/ctypes.rst:2555 +#: library/ctypes.rst:2586 msgid "" "class _U(Union):\n" " _fields_ = [(\"lptdesc\", POINTER(TYPEDESC)),\n" @@ -3536,7 +3541,7 @@ msgid "" " (\"vt\", VARTYPE)]" msgstr "" -#: library/ctypes.rst:2566 +#: library/ctypes.rst:2597 msgid "" "The ``TYPEDESC`` structure describes a COM data type, the ``vt`` field " "specifies which one of the union fields is valid. Since the ``u`` field is " @@ -3546,7 +3551,7 @@ msgid "" "temporary union instance::" msgstr "" -#: library/ctypes.rst:2573 +#: library/ctypes.rst:2604 msgid "" "td = TYPEDESC()\n" "td.vt = VT_PTR\n" @@ -3554,7 +3559,7 @@ msgid "" "td.u.lptdesc = POINTER(some_type)" msgstr "" -#: library/ctypes.rst:2578 +#: library/ctypes.rst:2609 msgid "" "It is possible to define sub-subclasses of structures, they inherit the " "fields of the base class. If the subclass definition has a separate :attr:" @@ -3562,7 +3567,7 @@ msgid "" "of the base class." msgstr "" -#: library/ctypes.rst:2583 +#: library/ctypes.rst:2614 msgid "" "Structure and union constructors accept both positional and keyword " "arguments. Positional arguments are used to initialize member fields in the " @@ -3572,15 +3577,15 @@ msgid "" "names not present in :attr:`_fields_`." msgstr "" -#: library/ctypes.rst:2594 +#: library/ctypes.rst:2625 msgid "Arrays and pointers" msgstr "" -#: library/ctypes.rst:2598 +#: library/ctypes.rst:2629 msgid "Abstract base class for arrays." msgstr "" -#: library/ctypes.rst:2600 +#: library/ctypes.rst:2631 msgid "" "The recommended way to create concrete array types is by multiplying any :" "mod:`ctypes` data type with a non-negative integer. Alternatively, you can " @@ -3590,34 +3595,34 @@ msgid "" "an :class:`Array`." msgstr "" -#: library/ctypes.rst:2610 +#: library/ctypes.rst:2641 msgid "" "A positive integer specifying the number of elements in the array. Out-of-" "range subscripts result in an :exc:`IndexError`. Will be returned by :func:" "`len`." msgstr "" -#: library/ctypes.rst:2617 +#: library/ctypes.rst:2648 msgid "Specifies the type of each element in the array." msgstr "" -#: library/ctypes.rst:2620 +#: library/ctypes.rst:2651 msgid "" "Array subclass constructors accept positional arguments, used to initialize " "the elements in order." msgstr "" -#: library/ctypes.rst:2626 +#: library/ctypes.rst:2657 msgid "Private, abstract base class for pointers." msgstr "" -#: library/ctypes.rst:2628 +#: library/ctypes.rst:2659 msgid "" "Concrete pointer types are created by calling :func:`POINTER` with the type " "that will be pointed to; this is done automatically by :func:`pointer`." msgstr "" -#: library/ctypes.rst:2632 +#: library/ctypes.rst:2663 msgid "" "If a pointer points to an array, its elements can be read and written using " "standard subscript and slice accesses. Pointer objects have no size, so :" @@ -3626,11 +3631,11 @@ msgid "" "probably crash with an access violation (if you're lucky)." msgstr "" -#: library/ctypes.rst:2642 +#: library/ctypes.rst:2673 msgid "Specifies the type pointed to." msgstr "" -#: library/ctypes.rst:2646 +#: library/ctypes.rst:2677 msgid "" "Returns the object to which to pointer points. Assigning to this attribute " "changes the pointer to point to the assigned object." diff --git a/library/enum.po b/library/enum.po index be20d405a..4a57c66ff 100644 --- a/library/enum.po +++ b/library/enum.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -81,7 +81,7 @@ msgid "" "... BLUE = 3\n" "\n" ">>> # functional syntax\n" -">>> Color = Enum('Color', ['RED', 'GREEN', 'BLUE'])" +">>> Color = Enum('Color', [('RED', 1), ('GREEN', 2), ('BLUE', 3)])" msgstr "" #: library/enum.rst:49 diff --git a/library/getopt.po b/library/getopt.po index a32ea796a..c231c4bd3 100644 --- a/library/getopt.po +++ b/library/getopt.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -124,15 +124,44 @@ msgstr "" msgid "An example using only Unix style options:" msgstr "" -#: library/getopt.rst:105 +#: library/getopt.rst:95 +msgid "" +">>> import getopt\n" +">>> args = '-a -b -cfoo -d bar a1 a2'.split()\n" +">>> args\n" +"['-a', '-b', '-cfoo', '-d', 'bar', 'a1', 'a2']\n" +">>> optlist, args = getopt.getopt(args, 'abc:d:')\n" +">>> optlist\n" +"[('-a', ''), ('-b', ''), ('-c', 'foo'), ('-d', 'bar')]\n" +">>> args\n" +"['a1', 'a2']" +msgstr "" + +#: library/getopt.rst:107 msgid "Using long option names is equally easy:" msgstr "" -#: library/getopt.rst:118 -msgid "In a script, typical usage is something like this::" +#: library/getopt.rst:109 +msgid "" +">>> s = '--condition=foo --testing --output-file abc.def -x a1 a2'\n" +">>> args = s.split()\n" +">>> args\n" +"['--condition=foo', '--testing', '--output-file', 'abc.def', '-x', 'a1', " +"'a2']\n" +">>> optlist, args = getopt.getopt(args, 'x', [\n" +"... 'condition=', 'output-file=', 'testing'])\n" +">>> optlist\n" +"[('--condition', 'foo'), ('--testing', ''), ('--output-file', 'abc.def'), ('-" +"x', '')]\n" +">>> args\n" +"['a1', 'a2']" +msgstr "" + +#: library/getopt.rst:122 +msgid "In a script, typical usage is something like this:" msgstr "" -#: library/getopt.rst:120 +#: library/getopt.rst:124 msgid "" "import getopt, sys\n" "\n" @@ -164,14 +193,14 @@ msgid "" " main()" msgstr "" -#: library/getopt.rst:147 +#: library/getopt.rst:153 msgid "" "Note that an equivalent command line interface could be produced with less " "code and more informative help and error messages by using the :mod:" -"`argparse` module::" +"`argparse` module:" msgstr "" -#: library/getopt.rst:150 +#: library/getopt.rst:156 msgid "" "import argparse\n" "\n" @@ -184,10 +213,10 @@ msgid "" " # ... do something with args.verbose .." msgstr "" -#: library/getopt.rst:162 +#: library/getopt.rst:170 msgid "Module :mod:`argparse`" msgstr "" -#: library/getopt.rst:163 +#: library/getopt.rst:171 msgid "Alternative command line option and argument parsing library." msgstr "" diff --git a/library/http.cookies.po b/library/http.cookies.po index e7fdce535..9febdac85 100644 --- a/library/http.cookies.po +++ b/library/http.cookies.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -132,9 +132,9 @@ msgstr "" #: library/http.cookies.rst:100 msgid "" "Return a string representation suitable to be sent as HTTP headers. *attrs* " -"and *header* are sent to each :class:`Morsel`'s :meth:`output` method. *sep* " -"is used to join the headers together, and is by default the combination " -"``'\\r\\n'`` (CRLF)." +"and *header* are sent to each :class:`Morsel`'s :meth:`~Morsel.output` " +"method. *sep* is used to join the headers together, and is by default the " +"combination ``'\\r\\n'`` (CRLF)." msgstr "" #: library/http.cookies.rst:108 diff --git a/library/importlib.metadata.po b/library/importlib.metadata.po index b4badfd25..af6638eeb 100644 --- a/library/importlib.metadata.po +++ b/library/importlib.metadata.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -187,9 +187,9 @@ msgstr "" #: library/importlib.metadata.rst:136 msgid "" -"Also provides a ``.groups`` attribute that reports all identifed entry point " -"groups, and a ``.names`` attribute that reports all identified entry point " -"names." +"Also provides a ``.groups`` attribute that reports all identified entry " +"point groups, and a ``.names`` attribute that reports all identified entry " +"point names." msgstr "" #: library/importlib.metadata.rst:142 diff --git a/library/itertools.po b/library/itertools.po index 1c924bd56..a903a1455 100644 --- a/library/itertools.po +++ b/library/itertools.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1117,7 +1117,7 @@ msgid "" "the input iterator and there is no way to access it. This could be an issue " "if an application wants to further consume the input iterator after " "*takewhile* has been run to exhaustion. To work around this problem, " -"consider using `more-iterools before_and_after() `_ instead." msgstr "" diff --git a/library/locale.po b/library/locale.po index f20a9a07b..000e86edb 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -427,10 +427,12 @@ msgid "" msgstr "" #: library/locale.rst:284 -msgid "Get a string that represents the era used in the current locale." +msgid "" +"Get a string which describes how years are counted and displayed for each " +"era in a locale." msgstr "" -#: library/locale.rst:286 +#: library/locale.rst:287 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 " @@ -438,47 +440,48 @@ msgid "" "then-emperor's reign." msgstr "" -#: library/locale.rst:291 +#: library/locale.rst:292 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` " -"function to use this information. The format of the returned string is not " -"specified, and therefore you should not assume knowledge of it on different " -"systems." +"function to use this information. The format of the returned string is " +"specified in *The Open Group Base Specifications Issue 8*, paragraph " +"`7.3.5.2 LC_TIME C-Language Access `_." msgstr "" -#: library/locale.rst:299 +#: library/locale.rst:301 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:304 +#: library/locale.rst:306 msgid "" "Get a format string for :func:`time.strftime` to represent a date in a " "locale-specific era-based way." msgstr "" -#: library/locale.rst:309 +#: library/locale.rst:311 msgid "" "Get a format string for :func:`time.strftime` to represent a time in a " "locale-specific era-based way." msgstr "" -#: library/locale.rst:314 +#: library/locale.rst:316 msgid "" "Get a string consisting of up to 100 semicolon-separated symbols used to " "represent the values 0 to 99 in a locale-specific way. In most locales this " "is an empty string." msgstr "" -#: library/locale.rst:321 +#: library/locale.rst:323 msgid "" "Tries to determine the default locale settings and returns them as a tuple " "of the form ``(language code, encoding)``." msgstr "" -#: library/locale.rst:324 +#: library/locale.rst:326 msgid "" "According to POSIX, a program which has not called ``setlocale(LC_ALL, '')`` " "runs using the portable ``'C'`` locale. Calling ``setlocale(LC_ALL, '')`` " @@ -487,7 +490,7 @@ msgid "" "emulate the behavior in the way described above." msgstr "" -#: library/locale.rst:330 +#: library/locale.rst:332 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 " @@ -497,21 +500,21 @@ msgid "" "``'LC_CTYPE'``, ``'LANG'`` and ``'LANGUAGE'``, in that order." msgstr "" -#: library/locale.rst:350 +#: library/locale.rst:352 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:346 +#: library/locale.rst:348 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:357 +#: library/locale.rst:359 msgid "" "Return the :term:`locale encoding` used for text data, according to user " "preferences. User preferences are expressed differently on different " @@ -519,82 +522,82 @@ msgid "" "this function only returns a guess." msgstr "" -#: library/locale.rst:362 +#: library/locale.rst:364 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:366 +#: library/locale.rst:368 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:388 +#: library/locale.rst:390 msgid "" "The :ref:`Python preinitialization ` configures the LC_CTYPE " "locale. See also the :term:`filesystem encoding and error handler`." msgstr "" -#: library/locale.rst:373 +#: library/locale.rst:375 msgid "" "The function now always returns ``\"utf-8\"`` on Android or if the :ref:" "`Python UTF-8 Mode ` is enabled." msgstr "" -#: library/locale.rst:380 +#: library/locale.rst:382 msgid "Get the current :term:`locale encoding`:" msgstr "" -#: library/locale.rst:382 +#: library/locale.rst:384 msgid "On Android and VxWorks, return ``\"utf-8\"``." msgstr "" -#: library/locale.rst:383 +#: library/locale.rst:385 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:386 +#: library/locale.rst:388 msgid "On Windows, return the ANSI code page." msgstr "" -#: library/locale.rst:391 +#: library/locale.rst:393 msgid "" "This function is similar to :func:`getpreferredencoding(False) " "` except this function ignores the :ref:`Python UTF-8 " "Mode `." msgstr "" -#: library/locale.rst:400 +#: library/locale.rst:402 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:404 +#: library/locale.rst:406 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:410 +#: library/locale.rst:412 msgid "Sets the locale for *category* to the default setting." msgstr "" -#: library/locale.rst:412 +#: library/locale.rst:414 msgid "" "The default setting is determined by calling :func:`getdefaultlocale`. " "*category* defaults to :const:`LC_ALL`." msgstr "" -#: library/locale.rst:420 +#: library/locale.rst:422 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 " @@ -602,7 +605,7 @@ msgid "" "is equal to it." msgstr "" -#: library/locale.rst:428 +#: library/locale.rst:430 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, " @@ -610,7 +613,7 @@ msgid "" "repeatedly, e.g. when collating a sequence of strings." msgstr "" -#: library/locale.rst:437 +#: library/locale.rst:439 msgid "" "Formats a number *val* according to the current :const:`LC_NUMERIC` setting. " "The format follows the conventions of the ``%`` operator. For floating-" @@ -618,29 +621,29 @@ msgid "" "is ``True``, also takes the grouping into account." msgstr "" -#: library/locale.rst:442 +#: library/locale.rst:444 msgid "" "If *monetary* is true, the conversion uses monetary thousands separator and " "grouping strings." msgstr "" -#: library/locale.rst:445 +#: library/locale.rst:447 msgid "" "Processes formatting specifiers as in ``format % val``, but takes the " "current locale settings into account." msgstr "" -#: library/locale.rst:448 +#: library/locale.rst:450 msgid "The *monetary* keyword parameter was added." msgstr "" -#: library/locale.rst:454 +#: library/locale.rst:456 msgid "" "Formats a number *val* according to the current :const:`LC_MONETARY` " "settings." msgstr "" -#: library/locale.rst:456 +#: library/locale.rst:458 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), " @@ -648,43 +651,43 @@ msgid "" "not the default), the international currency symbol is used." msgstr "" -#: library/locale.rst:463 +#: library/locale.rst:465 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:469 +#: library/locale.rst:471 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:475 +#: library/locale.rst:477 msgid "" "Converts a string into a normalized number string, following the :const:" "`LC_NUMERIC` settings." msgstr "" -#: library/locale.rst:483 +#: library/locale.rst:485 msgid "" "Converts a normalized number string into a formatted string following the :" "const:`LC_NUMERIC` settings." msgstr "" -#: library/locale.rst:491 +#: library/locale.rst:493 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:497 +#: library/locale.rst:499 msgid "" "Converts a string to an integer, following the :const:`LC_NUMERIC` " "conventions." msgstr "" -#: library/locale.rst:502 +#: library/locale.rst:504 msgid "" "Locale category for the character type functions. Most importantly, this " "category defines the text encoding, i.e. how bytes are interpreted as " @@ -694,32 +697,32 @@ msgid "" "SSH connections." msgstr "" -#: library/locale.rst:509 +#: library/locale.rst:511 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:516 +#: library/locale.rst:518 msgid "" "Locale category for sorting strings. The functions :func:`strcoll` and :" "func:`strxfrm` of the :mod:`locale` module are affected." msgstr "" -#: library/locale.rst:522 +#: library/locale.rst:524 msgid "" "Locale category for the formatting of time. The function :func:`time." "strftime` follows these conventions." msgstr "" -#: library/locale.rst:528 +#: library/locale.rst:530 msgid "" "Locale category for formatting of monetary values. The available options " "are available from the :func:`localeconv` function." msgstr "" -#: library/locale.rst:534 +#: library/locale.rst:536 msgid "" "Locale category for message display. Python currently does not support " "application specific locale-aware messages. Messages displayed by the " @@ -727,13 +730,13 @@ msgid "" "affected by this category." msgstr "" -#: library/locale.rst:539 +#: library/locale.rst:541 msgid "" "This value may not be available on operating systems not conforming to the " "POSIX standard, most notably Windows." msgstr "" -#: library/locale.rst:545 +#: library/locale.rst:547 msgid "" "Locale category for formatting numbers. The functions :func:" "`format_string`, :func:`atoi`, :func:`atof` and :func:`.str` of the :mod:" @@ -741,7 +744,7 @@ msgid "" "operations are not affected." msgstr "" -#: library/locale.rst:553 +#: library/locale.rst:555 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 " @@ -751,17 +754,17 @@ msgid "" "settings." msgstr "" -#: library/locale.rst:562 +#: library/locale.rst:564 msgid "" "This is a symbolic constant used for different values returned by :func:" "`localeconv`." msgstr "" -#: library/locale.rst:566 +#: library/locale.rst:568 msgid "Example::" msgstr "" -#: library/locale.rst:568 +#: library/locale.rst:570 msgid "" ">>> import locale\n" ">>> loc = locale.getlocale() # get current locale\n" @@ -774,11 +777,11 @@ msgid "" ">>> locale.setlocale(locale.LC_ALL, loc) # restore saved locale" msgstr "" -#: library/locale.rst:579 +#: library/locale.rst:581 msgid "Background, details, hints, tips and caveats" msgstr "" -#: library/locale.rst:581 +#: library/locale.rst:583 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 " @@ -786,7 +789,7 @@ msgid "" "This makes the locale somewhat painful to use correctly." msgstr "" -#: library/locale.rst:586 +#: library/locale.rst:588 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 :" @@ -796,7 +799,7 @@ msgid "" "categories by calling ``setlocale(LC_ALL, '')``." msgstr "" -#: library/locale.rst:593 +#: library/locale.rst:595 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 " @@ -804,7 +807,7 @@ msgid "" "that happen to run before the settings have been restored." msgstr "" -#: library/locale.rst:598 +#: library/locale.rst:600 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 " @@ -815,14 +818,14 @@ msgid "" "settings." msgstr "" -#: library/locale.rst:605 +#: library/locale.rst:607 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:609 +#: library/locale.rst:611 msgid "" "There is no way to perform case conversions and character classifications " "according to the locale. For (Unicode) text strings these are done " @@ -833,11 +836,11 @@ msgid "" "whitespace." msgstr "" -#: library/locale.rst:620 +#: library/locale.rst:622 msgid "For extension writers and programs that embed Python" msgstr "" -#: library/locale.rst:622 +#: library/locale.rst:624 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 " @@ -845,7 +848,7 @@ msgid "" "whether or not the locale is ``C``)." msgstr "" -#: library/locale.rst:627 +#: library/locale.rst:629 msgid "" "When Python code uses the :mod:`locale` module to change the locale, this " "also affects the embedding application. If the embedding application " @@ -855,11 +858,11 @@ msgid "" "accessible as a shared library." msgstr "" -#: library/locale.rst:638 +#: library/locale.rst:640 msgid "Access to message catalogs" msgstr "" -#: library/locale.rst:647 +#: library/locale.rst:649 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:" @@ -870,7 +873,7 @@ msgid "" "locating message catalogs." msgstr "" -#: library/locale.rst:654 +#: library/locale.rst:656 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 " diff --git a/library/math.po b/library/math.po index b3113cb90..097ff1356 100644 --- a/library/math.po +++ b/library/math.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: 2023-03-31 00:00+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -95,7 +95,7 @@ msgstr "" "Binom katsayısı olarak da adlandırılır. Çünkü ``(1 + x)ⁿ`` polinom " "açılımındaki k. terimin katsayısına eşittir." -#: library/math.rst:258 +#: library/math.rst:260 msgid "" "Raises :exc:`TypeError` if either of the arguments are not integers. Raises :" "exc:`ValueError` if either of the arguments are negative." @@ -250,20 +250,24 @@ msgstr "" "döndürür." #: library/math.rst:144 +#, fuzzy msgid "" "Whether or not two values are considered close is determined according to " -"given absolute and relative tolerances." +"given absolute and relative tolerances. If no errors occur, the result will " +"be: ``abs(a-b) <= max(rel_tol * max(abs(a), abs(b)), abs_tol)``." msgstr "" "İki değerin yakın kabul edilip edilmeyeceği, verilen mutlak ve göreceli " "toleranslara göre belirlenir." -#: library/math.rst:147 +#: library/math.rst:148 +#, fuzzy msgid "" "*rel_tol* is the relative tolerance -- it is the maximum allowed difference " "between *a* and *b*, relative to the larger absolute value of *a* or *b*. " "For example, to set a tolerance of 5%, pass ``rel_tol=0.05``. The default " "tolerance is ``1e-09``, which assures that the two values are the same " -"within about 9 decimal digits. *rel_tol* must be greater than zero." +"within about 9 decimal digits. *rel_tol* must be nonnegative and less than " +"``1.0``." msgstr "" "*rel_tol* göreli toleranstır - *a* veya *b*'nin daha büyük mutlak değerine " "göre *a* ve *b* arasında izin verilen maksimum farktır. Örneğin, %5'lik bir " @@ -271,23 +275,16 @@ msgstr "" "tolerans, iki değerin yaklaşık 9 ondalık basamak içinde aynı olmasını " "sağlayan ``1e-09`` değeridir. *rel_tol* sıfırdan büyük olmalıdır." -#: library/math.rst:153 -msgid "" -"*abs_tol* is the minimum absolute tolerance -- useful for comparisons near " -"zero. *abs_tol* must be at least zero." -msgstr "" -"*abs_tol* minimum mutlak toleranstır -- sıfıra yakın karşılaştırmalar için " -"kullanışlıdır. *abs_tol* en az sıfır olmalıdır." - -#: library/math.rst:156 +#: library/math.rst:155 msgid "" -"If no errors occur, the result will be: ``abs(a-b) <= max(rel_tol * " -"max(abs(a), abs(b)), abs_tol)``." +"*abs_tol* is the absolute tolerance; it defaults to ``0.0`` and it must be " +"nonnegative. When comparing ``x`` to ``0.0``, ``isclose(x, 0)`` is computed " +"as ``abs(x) <= rel_tol * abs(x)``, which is ``False`` for any ``x`` and " +"rel_tol less than ``1.0``. So add an appropriate positive abs_tol argument " +"to the call." msgstr "" -"Herhangi bir hata oluşmazsa, sonuç şöyle olacaktır: ``abs(a-b) <= " -"max(rel_tol * max(abs(a), abs(b)), abs_tol)``." -#: library/math.rst:159 +#: library/math.rst:161 msgid "" "The IEEE 754 special values of ``NaN``, ``inf``, and ``-inf`` will be " "handled according to IEEE rules. Specifically, ``NaN`` is not considered " @@ -299,11 +296,11 @@ msgstr "" "hiçbir değere yakın kabul edilmez. ``inf`` ve ``-inf`` yalnızca kendilerine " "yakın kabul edilir." -#: library/math.rst:168 +#: library/math.rst:170 msgid ":pep:`485` -- A function for testing approximate equality" msgstr ":pep:`485` -- Yaklaşık eşitliği test etmek için bir fonksiyon" -#: library/math.rst:173 +#: library/math.rst:175 msgid "" "Return ``True`` if *x* is neither an infinity nor a NaN, and ``False`` " "otherwise. (Note that ``0.0`` *is* considered finite.)" @@ -311,7 +308,7 @@ msgstr "" "Eğer *x* sonsuz bir değer ya da NaN ise ``True``, aksi takdirde ``False`` " "döndürür. (``0.0`` *sonlu* olarak kabul edilir.)" -#: library/math.rst:181 +#: library/math.rst:183 msgid "" "Return ``True`` if *x* is a positive or negative infinity, and ``False`` " "otherwise." @@ -319,13 +316,13 @@ msgstr "" "Eğer *x* pozitif veya negatif bir sonsuz ise ``True``, aksi takdirde " "``False`` döndürür." -#: library/math.rst:187 +#: library/math.rst:189 msgid "" "Return ``True`` if *x* is a NaN (not a number), and ``False`` otherwise." msgstr "" "Eğer *x* bir NaN (sayı değil) ise ``True``, aksi takdirde ``False`` döndürür." -#: library/math.rst:192 +#: library/math.rst:194 msgid "" "Return the integer square root of the nonnegative integer *n*. This is the " "floor of the exact square root of *n*, or equivalently the greatest integer " @@ -335,7 +332,7 @@ msgstr "" "karekökünün tabanıdır veya eşdeğer olarak *a*\\ ² |nbsp| ≤ |nbsp| *n* olacak " "şekilde en büyük *a* tamsayısıdır." -#: library/math.rst:196 +#: library/math.rst:198 msgid "" "For some applications, it may be more convenient to have the least integer " "*a* such that *n* |nbsp| ≤ |nbsp| *a*\\ ², or in other words the ceiling of " @@ -347,7 +344,7 @@ msgstr "" "sahip olmak daha uygun olabilir. Pozitif *n* için bu, ``a = 1 + isqrt(n - " "1)`` kullanılarak hesaplanabilir." -#: library/math.rst:206 +#: library/math.rst:208 msgid "" "Return the least common multiple of the specified integer arguments. If all " "arguments are nonzero, then the returned value is the smallest positive " @@ -361,14 +358,14 @@ msgstr "" "değişkenlerden herhangi biri sıfırsa, döndürülen değer ``0`` olur. Bağımsız " "değişkenler olmadan ``lcm()`` işlevi ``1`` değerini döndürür." -#: library/math.rst:217 +#: library/math.rst:219 msgid "" "Return ``x * (2**i)``. This is essentially the inverse of function :func:" "`frexp`." msgstr "" "``x * (2**i)`` döndürür. Bu aslında :func:`frexp` fonksiyonunun tersidir." -#: library/math.rst:223 +#: library/math.rst:225 msgid "" "Return the fractional and integer parts of *x*. Both results carry the sign " "of *x* and are floats." @@ -376,47 +373,47 @@ msgstr "" "x*'in kesirli ve tamsayı kısımlarını döndürür. Her iki sonuç da *x* " "işaretini taşır ve kayan değerdir." -#: library/math.rst:229 +#: library/math.rst:231 #, fuzzy msgid "Return the floating-point value *steps* steps after *x* towards *y*." msgstr "" "x* değerinden sonra *y* değerine doğru bir sonraki kayan noktalı değeri " "döndürür." -#: library/math.rst:231 +#: library/math.rst:233 #, fuzzy msgid "If *x* is equal to *y*, return *y*, unless *steps* is zero." msgstr "Eğer *x*, *y*'ye eşitse, *y* değerini döndürür." -#: library/math.rst:233 +#: library/math.rst:235 msgid "Examples:" msgstr "Örnekler:" -#: library/math.rst:235 +#: library/math.rst:237 msgid "``math.nextafter(x, math.inf)`` goes up: towards positive infinity." msgstr "``math.nextafter(x, math.inf)`` yukarı gider: pozitif sonsuza doğru." -#: library/math.rst:236 +#: library/math.rst:238 msgid "``math.nextafter(x, -math.inf)`` goes down: towards minus infinity." msgstr "``math.nextafter(x, -math.inf)`` aşağı iner: eksi sonsuza doğru." -#: library/math.rst:237 +#: library/math.rst:239 msgid "``math.nextafter(x, 0.0)`` goes towards zero." msgstr "``math.nextafter(x, 0.0)`` sıfıra doğru gider." -#: library/math.rst:238 +#: library/math.rst:240 msgid "``math.nextafter(x, math.copysign(math.inf, x))`` goes away from zero." msgstr "``math.nextafter(x, math.copysign(math.inf, x))`` sıfırdan uzaklaşır." -#: library/math.rst:240 +#: library/math.rst:242 msgid "See also :func:`math.ulp`." msgstr "Ayrıca bakınız :func:`math.ulp`." -#: library/math.rst:244 +#: library/math.rst:246 msgid "Added the *steps* argument." msgstr "" -#: library/math.rst:249 +#: library/math.rst:251 msgid "" "Return the number of ways to choose *k* items from *n* items without " "repetition and with order." @@ -424,7 +421,7 @@ msgstr "" "Tekrarlama olmadan ve sırayla *n* öğe arasından *k* öğeyi seçmenin " "yollarının sayısını döndürür." -#: library/math.rst:252 +#: library/math.rst:254 msgid "" "Evaluates to ``n! / (n - k)!`` when ``k <= n`` and evaluates to zero when " "``k > n``." @@ -432,7 +429,7 @@ msgstr "" "``n! / (k! * (n - k)!)`` değerini ``k <= n`` olduğunda verir ve ``k > n`` " "olduğunda sıfır olarak değerlendirir." -#: library/math.rst:255 +#: library/math.rst:257 #, fuzzy msgid "" "If *k* is not specified or is ``None``, then *k* defaults to *n* and the " @@ -441,7 +438,7 @@ msgstr "" "Eğer *k* belirtilmemişse veya None ise, *k* varsayılan olarak *n* değerini " "alır ve fonksiyon ``n!`` döndürür." -#: library/math.rst:266 +#: library/math.rst:268 msgid "" "Calculate the product of all the elements in the input *iterable*. The " "default *start* value for the product is ``1``." @@ -449,7 +446,7 @@ msgstr "" "Girdi *iterable* içindeki tüm elemanların çarpımını hesaplar. Çarpım için " "varsayılan *başlangıç* değeri ``1`` 'dir." -#: library/math.rst:269 +#: library/math.rst:271 msgid "" "When the iterable is empty, return the start value. This function is " "intended specifically for use with numeric values and may reject non-numeric " @@ -459,7 +456,7 @@ msgstr "" "özellikle sayısal değerlerle kullanılmak üzere tasarlanmıştır ve sayısal " "olmayan türleri reddedebilir." -#: library/math.rst:278 +#: library/math.rst:280 msgid "" "Return the IEEE 754-style remainder of *x* with respect to *y*. For finite " "*x* and finite nonzero *y*, this is the difference ``x - n*y``, where ``n`` " @@ -475,7 +472,7 @@ msgstr "" "Kalan ``r = remainder(x, y)`` böylece her zaman ``abs(r) <= 0.5 * abs(y)`` " "sağlar." -#: library/math.rst:285 +#: library/math.rst:287 msgid "" "Special cases follow IEEE 754: in particular, ``remainder(x, math.inf)`` is " "*x* for any finite *x*, and ``remainder(x, 0)`` and ``remainder(math.inf, " @@ -488,7 +485,7 @@ msgstr "" "`ValueError` yükseltir. Eğer kalan işleminin sonucu sıfır ise, bu sıfır *x* " "ile aynı işarete sahip olacaktır." -#: library/math.rst:291 +#: library/math.rst:293 #, fuzzy msgid "" "On platforms using IEEE 754 binary floating point, the result of this " @@ -497,29 +494,29 @@ msgstr "" "IEEE 754 ikili kayan nokta kullanan platformlarda, bu işlemin sonucu her " "zaman tam olarak gösterilebilir: yuvarlama hatası oluşmaz." -#: library/math.rst:299 +#: library/math.rst:301 msgid "Return the sum of products of values from two iterables *p* and *q*." msgstr "" -#: library/math.rst:301 +#: library/math.rst:303 msgid "Raises :exc:`ValueError` if the inputs do not have the same length." msgstr "" -#: library/math.rst:498 +#: library/math.rst:500 msgid "Roughly equivalent to::" msgstr "Kabaca şuna eşdeğerdir::" -#: library/math.rst:305 +#: library/math.rst:307 msgid "sum(itertools.starmap(operator.mul, zip(p, q, strict=True)))" msgstr "" -#: library/math.rst:307 +#: library/math.rst:309 msgid "" "For float and mixed int/float inputs, the intermediate products and sums are " "computed with extended precision." msgstr "" -#: library/math.rst:315 +#: library/math.rst:317 msgid "" "Return *x* with the fractional part removed, leaving the integer part. This " "rounds toward 0: ``trunc()`` is equivalent to :func:`floor` for positive " @@ -533,24 +530,24 @@ msgstr "" "Integral` değeri döndürmesi gereken :meth:`x.__trunc__ `'a " "delege eder." -#: library/math.rst:323 +#: library/math.rst:325 msgid "Return the value of the least significant bit of the float *x*:" msgstr "float *x* öğesinin en az anlamlı bitinin değerini döndürür:" -#: library/math.rst:325 +#: library/math.rst:327 msgid "If *x* is a NaN (not a number), return *x*." msgstr "" "Eğer *x* bir NaN (sayı değil) ise ``True``, aksi takdirde ``False`` döndürür." -#: library/math.rst:326 +#: library/math.rst:328 msgid "If *x* is negative, return ``ulp(-x)``." msgstr "Eğer *x* negatif ise, ``ulp(-x)`` döndürür." -#: library/math.rst:327 +#: library/math.rst:329 msgid "If *x* is a positive infinity, return *x*." msgstr "Eğer *x* pozitif bir sonsuzluk ise, *x* değerini döndürür." -#: library/math.rst:328 +#: library/math.rst:330 msgid "" "If *x* is equal to zero, return the smallest positive *denormalized* " "representable float (smaller than the minimum positive *normalized* float, :" @@ -560,7 +557,7 @@ msgstr "" "floatı döndürür (minimum pozitif *normalize* floattan daha küçük, :data:`sys." "float_info.min `)." -#: library/math.rst:331 +#: library/math.rst:333 msgid "" "If *x* is equal to the largest positive representable float, return the " "value of the least significant bit of *x*, such that the first float smaller " @@ -570,7 +567,7 @@ msgstr "" "*x* değerinden küçük olan ilk float değeri ``x - ulp(x)`` olacak şekilde *x* " "değerinin en küçük anlamlı bitinin değerini döndürür." -#: library/math.rst:334 +#: library/math.rst:336 msgid "" "Otherwise (*x* is a positive finite number), return the value of the least " "significant bit of *x*, such that the first float bigger than *x* is ``x + " @@ -579,11 +576,11 @@ msgstr "" "Aksi takdirde (*x* pozitif bir sonlu sayıdır), *x*'in en az anlamlı bitinin " "değerini döndürür, öyle ki *x*'ten büyük ilk float ``x + ulp(x)`` olur." -#: library/math.rst:338 +#: library/math.rst:340 msgid "ULP stands for \"Unit in the Last Place\"." msgstr "ULP, \"Son Yerdeki Birim\" anlamına gelmektedir." -#: library/math.rst:340 +#: library/math.rst:342 msgid "" "See also :func:`math.nextafter` and :data:`sys.float_info.epsilon `." @@ -591,7 +588,7 @@ msgstr "" "Ayrıca bakınız :func:`math.nextafter` ve :data:`sys.float_info.epsilon `." -#: library/math.rst:346 +#: library/math.rst:348 msgid "" "Note that :func:`frexp` and :func:`modf` have a different call/return " "pattern than their C equivalents: they take a single argument and return a " @@ -603,7 +600,7 @@ msgstr "" "dönüş değerlerini bir 'çıktı parametresi' aracılığıyla döndürmek yerine bir " "çift değer döndürürler (Python'da böyle bir şey yoktur)." -#: library/math.rst:351 +#: library/math.rst:353 msgid "" "For the :func:`ceil`, :func:`floor`, and :func:`modf` functions, note that " "*all* floating-point numbers of sufficiently large magnitude are exact " @@ -618,15 +615,15 @@ msgstr "" "``abs(x) >= 2**52`` olan herhangi bir *x* kayan noktalı sayısı zorunlu " "olarak kesirli bitlere sahip değildir." -#: library/math.rst:359 +#: library/math.rst:361 msgid "Power and logarithmic functions" msgstr "Güç ve logaritmik fonksiyonlar" -#: library/math.rst:363 +#: library/math.rst:365 msgid "Return the cube root of *x*." msgstr "x*'in küp kökünü döndürür." -#: library/math.rst:370 +#: library/math.rst:372 msgid "" "Return *e* raised to the power *x*, where *e* = 2.718281... is the base of " "natural logarithms. This is usually more accurate than ``math.e ** x`` or " @@ -636,11 +633,11 @@ msgstr "" "doğal logaritma tabanıdır. Bu genellikle ``math.e ** x`` veya ``pow(math.e, " "x)`` değerinden daha doğrudur." -#: library/math.rst:377 +#: library/math.rst:379 msgid "Return *2* raised to the power *x*." msgstr "*2*'nin *x* kuvvetine yükseltilmiş halini döndürür." -#: library/math.rst:384 +#: library/math.rst:386 #, fuzzy msgid "" "Return *e* raised to the power *x*, minus 1. Here *e* is the base of " @@ -655,13 +652,13 @@ msgstr "" "Loss_of_significance>`_\\ neden olabilir; :func:`expm1` fonksiyonu bu " "miktarı tam hassasiyetle hesaplamak için bir yol sağlar::" -#: library/math.rst:401 +#: library/math.rst:403 msgid "With one argument, return the natural logarithm of *x* (to base *e*)." msgstr "" "Bir bağımsız değişkenle, *x*'in doğal logaritmasını döndürür (*e* tabanına " "göre)." -#: library/math.rst:403 +#: library/math.rst:405 msgid "" "With two arguments, return the logarithm of *x* to the given *base*, " "calculated as ``log(x)/log(base)``." @@ -669,7 +666,7 @@ msgstr "" "İki bağımsız değişkenle, ``log(x)/log(taban)`` şeklinde hesaplanan *x* " "değerinin verilen *taban* değerine göre logaritmasını döndürür." -#: library/math.rst:409 +#: library/math.rst:411 msgid "" "Return the natural logarithm of *1+x* (base *e*). The result is calculated " "in a way which is accurate for *x* near zero." @@ -677,7 +674,7 @@ msgstr "" "*1+x*'in (*e* tabanı) doğal logaritmasını döndürür. Sonuç, sıfıra yakın *x* " "için doğru olacak şekilde hesaplanır." -#: library/math.rst:415 +#: library/math.rst:417 msgid "" "Return the base-2 logarithm of *x*. This is usually more accurate than " "``log(x, 2)``." @@ -685,7 +682,7 @@ msgstr "" "x*'in 2 taban logaritmasını döndürür. Bu genellikle ``log(x, 2)`` değerinden " "daha doğrudur." -#: library/math.rst:422 +#: library/math.rst:424 msgid "" ":meth:`int.bit_length` returns the number of bits necessary to represent an " "integer in binary, excluding the sign and leading zeros." @@ -693,7 +690,7 @@ msgstr "" ":meth:`int.bit_length`, işaret ve baştaki sıfırlar hariç olmak üzere, bir " "tamsayıyı ikili olarak temsil etmek için gerekli bit sayısını döndürür." -#: library/math.rst:428 +#: library/math.rst:430 msgid "" "Return the base-10 logarithm of *x*. This is usually more accurate than " "``log(x, 10)``." @@ -701,7 +698,7 @@ msgstr "" "*x* 'in 10 tabanında logaritmasını döndürür. Bu genellikle ``log(x, 10)`` " "'dan daha doğrudur." -#: library/math.rst:434 +#: library/math.rst:436 msgid "" "Return ``x`` raised to the power ``y``. Exceptional cases follow the IEEE " "754 standard as far as possible. In particular, ``pow(1.0, x)`` and " @@ -715,7 +712,7 @@ msgstr "" "Eğer hem ``x`` hem de ``y`` sonlu ise, ``x`` negatif ise ve ``y`` bir " "tamsayı değilse, ``pow(x, y)`` tanımsızdır ve :exc:`ValueError` yükseltir." -#: library/math.rst:441 +#: library/math.rst:443 msgid "" "Unlike the built-in ``**`` operator, :func:`math.pow` converts both its " "arguments to type :class:`float`. Use ``**`` or the built-in :func:`pow` " @@ -725,7 +722,7 @@ msgstr "" "class:`float` türüne dönüştürür. Tam sayı kuvvetlerini hesaplamak için " "``**`` veya yerleşik :func:`pow` fonksiyonunu kullanın." -#: library/math.rst:445 +#: library/math.rst:447 msgid "" "The special cases ``pow(0.0, -inf)`` and ``pow(-0.0, -inf)`` were changed to " "return ``inf`` instead of raising :exc:`ValueError`, for consistency with " @@ -735,15 +732,15 @@ msgstr "" "tutarlılık için :exc:`ValueError`` yükseltmek yerine ``inf`` döndürmek üzere " "değiştirildi." -#: library/math.rst:453 +#: library/math.rst:455 msgid "Return the square root of *x*." msgstr "*x*'in karekökünü döndürür." -#: library/math.rst:457 +#: library/math.rst:459 msgid "Trigonometric functions" msgstr "Trigonometrik fonksiyonlar" -#: library/math.rst:461 +#: library/math.rst:463 msgid "" "Return the arc cosine of *x*, in radians. The result is between ``0`` and " "``pi``." @@ -751,7 +748,7 @@ msgstr "" "Radyan cinsinden *x*'in yay kosinüsünü döndürür. Sonuç ``0`` ile ``pi`` " "arasındadır." -#: library/math.rst:467 +#: library/math.rst:469 msgid "" "Return the arc sine of *x*, in radians. The result is between ``-pi/2`` and " "``pi/2``." @@ -759,7 +756,7 @@ msgstr "" "Radyan cinsinden *x*'in yay sinüsünü döndürür. Sonuç ``-pi/2`` ile ``pi/2`` " "arasındadır." -#: library/math.rst:473 +#: library/math.rst:475 msgid "" "Return the arc tangent of *x*, in radians. The result is between ``-pi/2`` " "and ``pi/2``." @@ -767,7 +764,7 @@ msgstr "" "Radyan cinsinden *x*'in yay tanjantını döndürür. Sonuç ``-pi/2`` ile " "``pi/2`` arasındadır." -#: library/math.rst:479 +#: library/math.rst:481 msgid "" "Return ``atan(y / x)``, in radians. The result is between ``-pi`` and " "``pi``. The vector in the plane from the origin to point ``(x, y)`` makes " @@ -783,11 +780,11 @@ msgstr "" "hesaplayabilir. Örneğin, ``atan(1)`` ve ``atan2(1, 1)`` her ikisi de " "``pi/4`` 'tür, ancak ``atan2(-1, -1)`` ise ``-3*pi/4`` 'tür." -#: library/math.rst:489 +#: library/math.rst:491 msgid "Return the cosine of *x* radians." msgstr "*x* radyanın kosinüsünü döndürür." -#: library/math.rst:494 +#: library/math.rst:496 msgid "" "Return the Euclidean distance between two points *p* and *q*, each given as " "a sequence (or iterable) of coordinates. The two points must have the same " @@ -797,11 +794,11 @@ msgstr "" "*q* noktası arasındaki Öklid mesafesini döndürür. İki nokta aynı boyuta " "sahip olmalıdır." -#: library/math.rst:500 +#: library/math.rst:502 msgid "sqrt(sum((px - qx) ** 2.0 for px, qx in zip(p, q)))" msgstr "" -#: library/math.rst:507 +#: library/math.rst:509 msgid "" "Return the Euclidean norm, ``sqrt(sum(x**2 for x in coordinates))``. This is " "the length of the vector from the origin to the point given by the " @@ -810,7 +807,7 @@ msgstr "" "Öklid normunu döndürür, ``sqrt(sum(x**2 for x in coordinates))``. Bu, " "vektörün orijinden koordinatlar tarafından verilen noktaya olan uzunluğudur." -#: library/math.rst:511 +#: library/math.rst:513 msgid "" "For a two dimensional point ``(x, y)``, this is equivalent to computing the " "hypotenuse of a right triangle using the Pythagorean theorem, ``sqrt(x*x + " @@ -819,7 +816,7 @@ msgstr "" "İki boyutlu bir ``(x, y)`` noktası için bu, Pisagor teoremi ``sqrt(x*x + " "y*y)`` kullanılarak bir dik üçgenin hipotenüsünün hesaplanmasına eşdeğerdir." -#: library/math.rst:515 +#: library/math.rst:517 msgid "" "Added support for n-dimensional points. Formerly, only the two dimensional " "case was supported." @@ -827,7 +824,7 @@ msgstr "" "n boyutlu noktalar için destek eklendi. Önceden sadece iki boyutlu durum " "destekleniyordu." -#: library/math.rst:519 +#: library/math.rst:521 msgid "" "Improved the algorithm's accuracy so that the maximum error is under 1 ulp " "(unit in the last place). More typically, the result is almost always " @@ -837,31 +834,31 @@ msgstr "" "olacak şekilde geliştirildi. Daha tipik olarak, sonuç neredeyse her zaman " "1/2 ulp içinde doğru şekilde yuvarlanır." -#: library/math.rst:527 +#: library/math.rst:529 msgid "Return the sine of *x* radians." msgstr "*x* radyanın sinüsünü döndürür." -#: library/math.rst:532 +#: library/math.rst:534 msgid "Return the tangent of *x* radians." msgstr "*x* radyanın tanjantını döndürür." -#: library/math.rst:536 +#: library/math.rst:538 msgid "Angular conversion" msgstr "Açısal dönüşüm" -#: library/math.rst:540 +#: library/math.rst:542 msgid "Convert angle *x* from radians to degrees." msgstr "Açıyı *x* radyandan dereceye dönüştürür." -#: library/math.rst:545 +#: library/math.rst:547 msgid "Convert angle *x* from degrees to radians." msgstr "Açıyı *x* dereceden radyana dönüştürür." -#: library/math.rst:549 +#: library/math.rst:551 msgid "Hyperbolic functions" msgstr "Hiberbolik fonksiyonlar" -#: library/math.rst:551 +#: library/math.rst:553 #, fuzzy msgid "" "`Hyperbolic functions `_ " @@ -872,35 +869,35 @@ msgstr "" "Hyperbolic_function>`_ trigonometrik fonksiyonların çemberler yerine " "hiperbollere dayanan analoglarıdır." -#: library/math.rst:557 +#: library/math.rst:559 msgid "Return the inverse hyperbolic cosine of *x*." msgstr "*x*'in ters hiperbolik kosinüsünü döndürür." -#: library/math.rst:562 +#: library/math.rst:564 msgid "Return the inverse hyperbolic sine of *x*." msgstr "*x*'in ters hiperbolik sinüsünü döndürür." -#: library/math.rst:567 +#: library/math.rst:569 msgid "Return the inverse hyperbolic tangent of *x*." msgstr "*x*'in ters hiperbolik tanjantını döndürür." -#: library/math.rst:572 +#: library/math.rst:574 msgid "Return the hyperbolic cosine of *x*." msgstr "*x*'in hiperbolik kosinüsünü döndürür." -#: library/math.rst:577 +#: library/math.rst:579 msgid "Return the hyperbolic sine of *x*." msgstr "*x*'in hiperbolik sinüsünü döndürür." -#: library/math.rst:582 +#: library/math.rst:584 msgid "Return the hyperbolic tangent of *x*." msgstr "*x*'in hiperbolik tanjantını döndürür." -#: library/math.rst:586 +#: library/math.rst:588 msgid "Special functions" msgstr "Özel fonksiyonlar" -#: library/math.rst:590 +#: library/math.rst:592 msgid "" "Return the `error function `_ " "at *x*." @@ -908,7 +905,7 @@ msgstr "" "*x* adresindeki `hata fonksiyonunu `_ döndürür." -#: library/math.rst:593 +#: library/math.rst:595 #, fuzzy msgid "" "The :func:`erf` function can be used to compute traditional statistical " @@ -919,14 +916,14 @@ msgstr "" "wikipedia.org/wiki/Normal_distribution#Cumulative_distribution_functions>`_: " "gibi geleneksel istatistiksel fonksiyonları hesaplamak için kullanılabilir:" -#: library/math.rst:597 +#: library/math.rst:599 msgid "" "def phi(x):\n" " 'Cumulative distribution function for the standard normal distribution'\n" " return (1.0 + erf(x / sqrt(2.0))) / 2.0" msgstr "" -#: library/math.rst:606 +#: library/math.rst:608 msgid "" "Return the complementary error function at *x*. The `complementary error " "function `_ is defined as " @@ -940,7 +937,7 @@ msgstr "" "wikipedia.org/wiki/Loss_of_significance>`_ neden olacağı büyük *x* değerleri " "için kullanılır.\\" -#: library/math.rst:617 +#: library/math.rst:619 msgid "" "Return the `Gamma function `_ " "at *x*." @@ -948,26 +945,26 @@ msgstr "" "*x* adresindeki `Gamma fonksiyonunu `_ döndürür." -#: library/math.rst:625 +#: library/math.rst:627 msgid "" "Return the natural logarithm of the absolute value of the Gamma function at " "*x*." msgstr "" "Gama fonksiyonunun *x*'deki mutlak değerinin doğal logaritmasını döndürür." -#: library/math.rst:632 +#: library/math.rst:634 msgid "Constants" msgstr "Sabitler" -#: library/math.rst:636 +#: library/math.rst:638 msgid "The mathematical constant *π* = 3.141592..., to available precision." msgstr "Matematiksel sabit *π* = 3.141592..., mevcut hassasiyete göre." -#: library/math.rst:641 +#: library/math.rst:643 msgid "The mathematical constant *e* = 2.718281..., to available precision." msgstr "Matematiksel sabit *e* = 2,718281..., mevcut hassasiyete göre." -#: library/math.rst:646 +#: library/math.rst:648 msgid "" "The mathematical constant *τ* = 6.283185..., to available precision. Tau is " "a circle constant equal to 2\\ *π*, the ratio of a circle's circumference to " @@ -982,7 +979,7 @@ msgstr "" "`Tau gününü `_ iki kat daha fazla turta yiyerek " "kutlamaya başlayın!" -#: library/math.rst:657 +#: library/math.rst:659 msgid "" "A floating-point positive infinity. (For negative infinity, use ``-math." "inf``.) Equivalent to the output of ``float('inf')``." @@ -990,7 +987,7 @@ msgstr "" "Bir kayan noktalı pozitif sonsuzluk. (Negatif sonsuzluk için ``-math.inf`` " "kullanın.) ``float('inf')`` çıktısına eşdeğerdir." -#: library/math.rst:665 +#: library/math.rst:667 #, fuzzy msgid "" "A floating-point \"not a number\" (NaN) value. Equivalent to the output of " @@ -1008,11 +1005,11 @@ msgstr "" "``==`` yerine NaN'leri test etmek için :func:`isnan` fonksiyonunu kullanın. " "Örnek::" -#: library/math.rst:685 +#: library/math.rst:687 msgid "It is now always available." msgstr "Artık her zaman kullanılabilir." -#: library/math.rst:691 +#: library/math.rst:693 msgid "" "The :mod:`math` module consists mostly of thin wrappers around the platform " "C math library functions. Behavior in exceptional cases follows Annex F of " @@ -1038,7 +1035,7 @@ msgstr "" "bu kuralın bazı istisnaları vardır, örneğin ``pow(float('nan'), 0.0)`` veya " "``hypot(float('nan'), float('inf'))``." -#: library/math.rst:703 +#: library/math.rst:705 msgid "" "Note that Python makes no effort to distinguish signaling NaNs from quiet " "NaNs, and behavior for signaling NaNs remains unspecified. Typical behavior " @@ -1048,10 +1045,24 @@ msgstr "" "çaba göstermediğini ve sinyal veren NaN'lar için davranışın belirtilmediğini " "unutmayın. Tipik davranış, tüm NaN'lara sessizmiş gibi davranmaktır." -#: library/math.rst:710 +#: library/math.rst:712 msgid "Module :mod:`cmath`" msgstr "Modül :mod:`cmath`" -#: library/math.rst:711 +#: library/math.rst:713 msgid "Complex number versions of many of these functions." msgstr "Bu fonksiyonların çoğunun karmaşık sayı versiyonları." + +#~ msgid "" +#~ "*abs_tol* is the minimum absolute tolerance -- useful for comparisons " +#~ "near zero. *abs_tol* must be at least zero." +#~ msgstr "" +#~ "*abs_tol* minimum mutlak toleranstır -- sıfıra yakın karşılaştırmalar " +#~ "için kullanışlıdır. *abs_tol* en az sıfır olmalıdır." + +#~ msgid "" +#~ "If no errors occur, the result will be: ``abs(a-b) <= max(rel_tol * " +#~ "max(abs(a), abs(b)), abs_tol)``." +#~ msgstr "" +#~ "Herhangi bir hata oluşmazsa, sonuç şöyle olacaktır: ``abs(a-b) <= " +#~ "max(rel_tol * max(abs(a), abs(b)), abs_tol)``." diff --git a/library/multiprocessing.po b/library/multiprocessing.po index f8e0da255..4351dd7c1 100644 --- a/library/multiprocessing.po +++ b/library/multiprocessing.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -412,7 +412,7 @@ msgstr "" #: library/multiprocessing.rst:285 msgid "" -"The :meth:`~Connection.send` method serializes the the object and :meth:" +"The :meth:`~Connection.send` method serializes the object and :meth:" "`~Connection.recv` re-creates the object." msgstr "" @@ -1147,9 +1147,9 @@ msgstr "" #: library/multiprocessing.rst:822 msgid "" -"The :meth:`~multiprocessing.Connection.send` method serializes the the " -"object using :mod:`pickle` and the :meth:`~multiprocessing.Connection.recv` " -"re-creates the object." +"The :meth:`~multiprocessing.Connection.send` method serializes the object " +"using :mod:`pickle` and the :meth:`~multiprocessing.Connection.recv` re-" +"creates the object." msgstr "" #: library/multiprocessing.rst:827 diff --git a/library/os.po b/library/os.po index 1772ec1da..3c5eafd2c 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -301,15 +301,15 @@ msgstr "" #: library/os.rst:3787 library/os.rst:4001 library/os.rst:4044 #: library/os.rst:4058 library/os.rst:4072 library/os.rst:4086 #: library/os.rst:4102 library/os.rst:4116 library/os.rst:4133 -#: library/os.rst:4148 library/os.rst:4204 library/os.rst:4255 -#: library/os.rst:4278 library/os.rst:4299 library/os.rst:4340 -#: library/os.rst:4451 library/os.rst:4553 library/os.rst:4583 -#: library/os.rst:4640 library/os.rst:4700 library/os.rst:4755 -#: library/os.rst:4816 library/os.rst:4847 library/os.rst:4873 -#: library/os.rst:4898 library/os.rst:4917 library/os.rst:4965 -#: library/os.rst:4992 library/os.rst:5011 library/os.rst:5029 -#: library/os.rst:5047 library/os.rst:5204 library/os.rst:5235 -#: library/os.rst:5367 +#: library/os.rst:4148 library/os.rst:4204 library/os.rst:4254 +#: library/os.rst:4277 library/os.rst:4298 library/os.rst:4339 +#: library/os.rst:4450 library/os.rst:4552 library/os.rst:4582 +#: library/os.rst:4639 library/os.rst:4699 library/os.rst:4754 +#: library/os.rst:4815 library/os.rst:4846 library/os.rst:4872 +#: library/os.rst:4897 library/os.rst:4916 library/os.rst:4964 +#: library/os.rst:4991 library/os.rst:5010 library/os.rst:5028 +#: library/os.rst:5046 library/os.rst:5203 library/os.rst:5234 +#: library/os.rst:5366 msgid "Availability" msgstr "" @@ -836,7 +836,7 @@ msgid "" "or even ``socket.gethostbyaddr(socket.gethostname())``." msgstr "" -#: library/os.rst:4702 +#: library/os.rst:4701 msgid "" "Return type changed from a tuple to a tuple-like object with named " "attributes." @@ -1363,7 +1363,7 @@ msgstr "" msgid "Added the *dir_fd* parameter." msgstr "" -#: library/os.rst:1576 library/os.rst:4798 +#: library/os.rst:1576 library/os.rst:4797 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 :" @@ -1374,7 +1374,7 @@ msgstr "" #: library/os.rst:2170 library/os.rst:2242 library/os.rst:2374 #: library/os.rst:2445 library/os.rst:2508 library/os.rst:2597 #: library/os.rst:2975 library/os.rst:3426 library/os.rst:3482 -#: library/os.rst:3643 library/os.rst:4007 library/os.rst:4560 +#: library/os.rst:3643 library/os.rst:4007 library/os.rst:4559 msgid "Accepts a :term:`path-like object`." msgstr "" @@ -2315,7 +2315,7 @@ msgid "" "``src``, ``dst``, ``src_dir_fd``, ``dst_dir_fd``." msgstr "" -#: library/os.rst:4257 +#: library/os.rst:4256 msgid "Added Windows support." msgstr "" @@ -4538,47 +4538,46 @@ msgid "" "console processes which share a common console window, e.g., some " "subprocesses. Any other value for *sig* will cause the process to be " "unconditionally killed by the TerminateProcess API, and the exit code will " -"be set to *sig*. The Windows version of :func:`kill` additionally takes " -"process handles to be killed." +"be set to *sig*." msgstr "" -#: library/os.rst:4251 +#: library/os.rst:4250 msgid "See also :func:`signal.pthread_kill`." msgstr "" -#: library/os.rst:4253 +#: library/os.rst:4252 msgid "" "Raises an :ref:`auditing event ` ``os.kill`` with arguments " "``pid``, ``sig``." msgstr "" -#: library/os.rst:4267 +#: library/os.rst:4266 msgid "Send the signal *sig* to the process group *pgid*." msgstr "" -#: library/os.rst:4269 +#: library/os.rst:4268 msgid "" "Raises an :ref:`auditing event ` ``os.killpg`` with arguments " "``pgid``, ``sig``." msgstr "" -#: library/os.rst:4276 +#: library/os.rst:4275 msgid "" "Add *increment* to the process's \"niceness\". Return the new niceness." msgstr "" -#: library/os.rst:4283 +#: library/os.rst:4282 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:4287 +#: library/os.rst:4286 msgid "See the :manpage:`pidfd_open(2)` man page for more details." msgstr "" -#: library/os.rst:4294 +#: library/os.rst:4293 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 " @@ -4586,13 +4585,13 @@ msgid "" "immediately return the error :const:`~errno.EAGAIN` rather than blocking." msgstr "" -#: library/os.rst:4305 +#: library/os.rst:4304 msgid "" "Lock program segments into memory. The value of *op* (defined in ````) determines which segments are locked." msgstr "" -#: library/os.rst:4313 +#: library/os.rst:4312 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 " @@ -4602,7 +4601,7 @@ msgid "" "rather than bytes." msgstr "" -#: library/os.rst:4321 +#: library/os.rst:4320 msgid "" "The ``close`` method returns :const:`None` if the subprocess exited " "successfully, or the subprocess's return code if there was an error. On " @@ -4614,56 +4613,56 @@ msgid "" "contains the signed integer return code from the child process." msgstr "" -#: library/os.rst:4331 +#: library/os.rst:4330 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:4336 +#: library/os.rst:4335 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:4343 +#: library/os.rst:4342 msgid "" "The :ref:`Python UTF-8 Mode ` affects encodings used for *cmd* " "and pipe contents." msgstr "" -#: library/os.rst:4346 +#: library/os.rst:4345 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:4355 +#: library/os.rst:4354 msgid "Wraps the :c:func:`!posix_spawn` C library API for use from Python." msgstr "" -#: library/os.rst:4357 +#: library/os.rst:4356 msgid "" "Most users should use :func:`subprocess.run` instead of :func:`posix_spawn`." msgstr "" -#: library/os.rst:4359 +#: library/os.rst:4358 msgid "" "The positional-only arguments *path*, *args*, and *env* are similar to :func:" "`execve`." msgstr "" -#: library/os.rst:4362 +#: library/os.rst:4361 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:4366 +#: library/os.rst:4365 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 " @@ -4672,31 +4671,31 @@ msgid "" "describing the remaining tuple elements:" msgstr "" -#: library/os.rst:4374 +#: library/os.rst:4373 msgid "(``os.POSIX_SPAWN_OPEN``, *fd*, *path*, *flags*, *mode*)" msgstr "" -#: library/os.rst:4376 +#: library/os.rst:4375 msgid "Performs ``os.dup2(os.open(path, flags, mode), fd)``." msgstr "" -#: library/os.rst:4380 +#: library/os.rst:4379 msgid "(``os.POSIX_SPAWN_CLOSE``, *fd*)" msgstr "" -#: library/os.rst:4382 +#: library/os.rst:4381 msgid "Performs ``os.close(fd)``." msgstr "" -#: library/os.rst:4386 +#: library/os.rst:4385 msgid "(``os.POSIX_SPAWN_DUP2``, *fd*, *new_fd*)" msgstr "" -#: library/os.rst:4388 +#: library/os.rst:4387 msgid "Performs ``os.dup2(fd, new_fd)``." msgstr "" -#: library/os.rst:4390 +#: library/os.rst:4389 msgid "" "These tuples correspond to the C library :c:func:`!" "posix_spawn_file_actions_addopen`, :c:func:`!" @@ -4705,7 +4704,7 @@ msgid "" "`!posix_spawn` call itself." msgstr "" -#: library/os.rst:4396 +#: library/os.rst:4395 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 " @@ -4714,7 +4713,7 @@ msgid "" "corresponds to the C library :c:macro:`!POSIX_SPAWN_SETPGROUP` flag." msgstr "" -#: library/os.rst:4402 +#: library/os.rst:4401 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 " @@ -4725,7 +4724,7 @@ msgid "" "library :c:macro:`!POSIX_SPAWN_RESETIDS` flag." msgstr "" -#: library/os.rst:4410 +#: library/os.rst:4409 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:" @@ -4733,7 +4732,7 @@ msgid "" "is raised." msgstr "" -#: library/os.rst:4415 +#: library/os.rst:4414 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 " @@ -4741,14 +4740,14 @@ msgid "" "POSIX_SPAWN_SETSIGMASK` flag." msgstr "" -#: library/os.rst:4420 +#: library/os.rst:4419 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:4424 +#: library/os.rst:4423 msgid "" "The *scheduler* argument must be a tuple containing the (optional) scheduler " "policy and an instance of :class:`sched_param` with the scheduler " @@ -4758,78 +4757,78 @@ msgid "" "POSIX_SPAWN_SETSCHEDULER` flags." msgstr "" -#: library/os.rst:4447 +#: library/os.rst:4446 msgid "" "Raises an :ref:`auditing event ` ``os.posix_spawn`` with arguments " "``path``, ``argv``, ``env``." msgstr "" -#: library/os.rst:4441 +#: library/os.rst:4440 msgid "Wraps the :c:func:`!posix_spawnp` C library API for use from Python." msgstr "" -#: library/os.rst:4443 +#: library/os.rst:4442 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:4453 +#: library/os.rst:4452 msgid "See :func:`posix_spawn` documentation." msgstr "" -#: library/os.rst:4459 +#: library/os.rst:4458 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:4464 +#: library/os.rst:4463 msgid "*before* is a function called before forking a child process." msgstr "" -#: library/os.rst:4465 +#: library/os.rst:4464 msgid "" "*after_in_parent* is a function called from the parent process after forking " "a child process." msgstr "" -#: library/os.rst:4467 +#: library/os.rst:4466 msgid "*after_in_child* is a function called from the child process." msgstr "" -#: library/os.rst:4469 +#: library/os.rst:4468 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:4473 +#: library/os.rst:4472 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:4478 +#: library/os.rst:4477 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:4482 +#: library/os.rst:4481 msgid "There is no way to unregister a function." msgstr "" -#: library/os.rst:4498 +#: library/os.rst:4497 msgid "Execute the program *path* in a new process." msgstr "" -#: library/os.rst:4500 +#: library/os.rst:4499 msgid "" "(Note that the :mod:`subprocess` module provides more powerful facilities " "for spawning new processes and retrieving their results; using that module " @@ -4837,7 +4836,7 @@ msgid "" "`subprocess-replacements` section.)" msgstr "" -#: library/os.rst:4505 +#: library/os.rst:4504 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 " @@ -4846,13 +4845,13 @@ msgid "" "handle, so can be used with the :func:`waitpid` function." msgstr "" -#: library/os.rst:4511 +#: library/os.rst:4510 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:4514 +#: library/os.rst:4513 msgid "" "The \"l\" and \"v\" variants of the :func:`spawn\\* ` functions " "differ in how command-line arguments are passed. The \"l\" variants are " @@ -4864,7 +4863,7 @@ msgid "" "to the child process must start with the name of the command being run." msgstr "" -#: library/os.rst:4523 +#: library/os.rst:4522 msgid "" "The variants which include a second \"p\" near the end (:func:`spawnlp`, :" "func:`spawnlpe`, :func:`spawnvp`, and :func:`spawnvpe`) will use the :envvar:" @@ -4877,7 +4876,7 @@ msgid "" "appropriate absolute or relative path." msgstr "" -#: library/os.rst:4533 +#: library/os.rst:4532 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 " @@ -4889,13 +4888,13 @@ msgid "" "values will cause the function to fail, with a return value of ``127``." msgstr "" -#: library/os.rst:4542 +#: library/os.rst:4541 msgid "" "As an example, the following calls to :func:`spawnlp` and :func:`spawnvpe` " "are equivalent::" msgstr "" -#: library/os.rst:4545 +#: library/os.rst:4544 msgid "" "import os\n" "os.spawnlp(os.P_WAIT, 'cp', 'cp', 'index.html', '/dev/null')\n" @@ -4904,13 +4903,13 @@ msgid "" "os.spawnvpe(os.P_WAIT, 'cp', L, os.environ)" msgstr "" -#: library/os.rst:4551 +#: library/os.rst:4550 msgid "" "Raises an :ref:`auditing event ` ``os.spawn`` with arguments " "``mode``, ``path``, ``args``, ``env``." msgstr "" -#: library/os.rst:4555 +#: library/os.rst:4554 msgid "" ":func:`spawnlp`, :func:`spawnlpe`, :func:`spawnvp` and :func:`spawnvpe` are " "not available on Windows. :func:`spawnle` and :func:`spawnve` are not " @@ -4918,7 +4917,7 @@ msgid "" "instead." msgstr "" -#: library/os.rst:4567 +#: library/os.rst:4566 msgid "" "Possible values for the *mode* parameter to the :func:`spawn\\* ` " "family of functions. If either of these values is given, the :func:" @@ -4926,7 +4925,7 @@ msgid "" "been created, with the process id as the return value." msgstr "" -#: library/os.rst:4577 +#: library/os.rst:4576 msgid "" "Possible value for the *mode* parameter to the :func:`spawn\\* ` " "family of functions. If this is given as *mode*, the :func:`spawn\\* " @@ -4935,7 +4934,7 @@ msgid "" "successful, or ``-signal`` if a signal kills the process." msgstr "" -#: library/os.rst:4589 +#: library/os.rst:4588 msgid "" "Possible values for the *mode* parameter to the :func:`spawn\\* ` " "family of functions. These are less portable than those listed above. :" @@ -4945,11 +4944,11 @@ msgid "" "function will not return." msgstr "" -#: library/os.rst:4600 +#: library/os.rst:4599 msgid "Start a file with its associated application." msgstr "" -#: library/os.rst:4602 +#: library/os.rst:4601 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:" @@ -4957,7 +4956,7 @@ msgid "" "whatever application (if any) its extension is associated." msgstr "" -#: library/os.rst:4607 +#: library/os.rst:4606 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 " @@ -4965,28 +4964,28 @@ msgid "" "as well as ``'explore'`` and ``'find'`` (to be used on directories)." msgstr "" -#: library/os.rst:4612 +#: library/os.rst:4611 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:4616 +#: library/os.rst:4615 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:4620 +#: library/os.rst:4619 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:4624 +#: library/os.rst:4623 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 " @@ -4997,32 +4996,32 @@ msgid "" "encoded for Win32." msgstr "" -#: library/os.rst:4632 +#: library/os.rst:4631 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:4636 +#: library/os.rst:4635 msgid "" "Raises an :ref:`auditing event ` ``os.startfile`` with arguments " "``path``, ``operation``." msgstr "" -#: library/os.rst:4638 +#: library/os.rst:4637 msgid "" "Raises an :ref:`auditing event ` ``os.startfile/2`` with arguments " "``path``, ``operation``, ``arguments``, ``cwd``, ``show_cmd``." msgstr "" -#: library/os.rst:4642 +#: library/os.rst:4641 msgid "" "Added the *arguments*, *cwd* and *show_cmd* arguments, and the ``os." "startfile/2`` audit event." msgstr "" -#: library/os.rst:4649 +#: library/os.rst:4648 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 " @@ -5033,13 +5032,13 @@ msgid "" "value of the Python function is system-dependent." msgstr "" -#: library/os.rst:4657 +#: library/os.rst:4656 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:4660 +#: library/os.rst:4659 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 :" @@ -5048,7 +5047,7 @@ msgid "" "shell documentation." msgstr "" -#: library/os.rst:4666 +#: library/os.rst:4665 msgid "" "The :mod:`subprocess` module provides more powerful facilities for spawning " "new processes and retrieving their results; using that module is preferable " @@ -5056,53 +5055,53 @@ msgid "" "the :mod:`subprocess` documentation for some helpful recipes." msgstr "" -#: library/os.rst:4671 +#: library/os.rst:4670 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:4675 +#: library/os.rst:4674 msgid "" "Raises an :ref:`auditing event ` ``os.system`` with argument " "``command``." msgstr "" -#: library/os.rst:4682 +#: library/os.rst:4681 msgid "" "Returns the current global process times. The return value is an object with " "five attributes:" msgstr "" -#: library/os.rst:4685 +#: library/os.rst:4684 msgid ":attr:`!user` - user time" msgstr "" -#: library/os.rst:4686 +#: library/os.rst:4685 msgid ":attr:`!system` - system time" msgstr "" -#: library/os.rst:4687 +#: library/os.rst:4686 msgid ":attr:`!children_user` - user time of all child processes" msgstr "" -#: library/os.rst:4688 +#: library/os.rst:4687 msgid ":attr:`!children_system` - system time of all child processes" msgstr "" -#: library/os.rst:4689 +#: library/os.rst:4688 msgid ":attr:`!elapsed` - elapsed real time since a fixed point in the past" msgstr "" -#: library/os.rst:4691 +#: library/os.rst:4690 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:4695 +#: library/os.rst:4694 msgid "" "See the Unix manual page :manpage:`times(2)` and `times(3) `_ manual page on Unix or `the " @@ -5112,7 +5111,7 @@ msgid "" "attributes are zero." msgstr "" -#: library/os.rst:4709 +#: library/os.rst:4708 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 " @@ -5121,87 +5120,87 @@ msgid "" "if a core file was produced." msgstr "" -#: library/os.rst:4715 +#: library/os.rst:4714 msgid "" "If there are no children that could be waited for, :exc:`ChildProcessError` " "is raised." msgstr "" -#: library/os.rst:4793 +#: library/os.rst:4792 msgid "" ":func:`waitstatus_to_exitcode` can be used to convert the exit status into " "an exit code." msgstr "" -#: library/os.rst:4725 +#: library/os.rst:4724 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:4732 +#: library/os.rst:4731 msgid "Wait for the completion of a child process." msgstr "" -#: library/os.rst:4734 +#: library/os.rst:4733 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:4737 +#: library/os.rst:4736 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:4741 +#: library/os.rst:4740 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:4744 +#: library/os.rst:4743 msgid ":attr:`!si_pid` (process ID)" msgstr "" -#: library/os.rst:4745 +#: library/os.rst:4744 msgid ":attr:`!si_uid` (real user ID of the child)" msgstr "" -#: library/os.rst:4746 +#: library/os.rst:4745 msgid ":attr:`!si_signo` (always :const:`~signal.SIGCHLD`)" msgstr "" -#: library/os.rst:4747 +#: library/os.rst:4746 msgid "" ":attr:`!si_status` (the exit status or signal number, depending on :attr:`!" "si_code`)" msgstr "" -#: library/os.rst:4748 +#: library/os.rst:4747 msgid ":attr:`!si_code` (see :data:`CLD_EXITED` for possible values)" msgstr "" -#: library/os.rst:4750 +#: library/os.rst:4749 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:4758 +#: library/os.rst:4757 msgid "This function is not available on macOS." msgstr "" -#: library/os.rst:4765 +#: library/os.rst:4764 msgid "The details of this function differ on Unix and Windows." msgstr "" -#: library/os.rst:4767 +#: library/os.rst:4766 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 " @@ -5210,7 +5209,7 @@ msgid "" "operation." msgstr "" -#: library/os.rst:4772 +#: library/os.rst:4771 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 " @@ -5220,7 +5219,7 @@ msgid "" "group ``-pid`` (the absolute value of *pid*)." msgstr "" -#: library/os.rst:4779 +#: library/os.rst:4778 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 " @@ -5229,7 +5228,7 @@ msgid "" "are :data:`WUNTRACED` and :data:`WCONTINUED`." msgstr "" -#: library/os.rst:4785 +#: library/os.rst:4784 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 " @@ -5241,7 +5240,7 @@ msgid "" "process handles." msgstr "" -#: library/os.rst:4806 +#: library/os.rst:4805 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 " @@ -5250,13 +5249,13 @@ msgid "" "same as that provided to :func:`waitpid` and :func:`wait4`." msgstr "" -#: library/os.rst:4827 +#: library/os.rst:4826 msgid "" ":func:`waitstatus_to_exitcode` can be used to convert the exit status into " "an exitcode." msgstr "" -#: library/os.rst:4821 +#: library/os.rst:4820 msgid "" "Similar to :func:`waitpid`, except a 3-element tuple, containing the child's " "process id, exit status indication, and resource usage information is " @@ -5265,118 +5264,118 @@ msgid "" "to :func:`waitpid`." msgstr "" -#: library/os.rst:4838 +#: library/os.rst:4837 msgid "" "These are the possible values for *idtype* in :func:`waitid`. They affect " "how *id* is interpreted:" msgstr "" -#: library/os.rst:4841 +#: library/os.rst:4840 msgid ":data:`!P_PID` - wait for the child whose PID is *id*." msgstr "" -#: library/os.rst:4842 +#: library/os.rst:4841 msgid ":data:`!P_PGID` - wait for any child whose progress group ID is *id*." msgstr "" -#: library/os.rst:4843 +#: library/os.rst:4842 msgid ":data:`!P_ALL` - wait for any child; *id* is ignored." msgstr "" -#: library/os.rst:4844 +#: library/os.rst:4843 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:4849 +#: library/os.rst:4848 msgid ":data:`!P_PIDFD` is only available on Linux >= 5.4." msgstr "" -#: library/os.rst:4852 +#: library/os.rst:4851 msgid "The :data:`!P_PIDFD` constant." msgstr "" -#: library/os.rst:4858 +#: library/os.rst:4857 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:4867 +#: library/os.rst:4866 msgid "" "This *options* flag for :func:`waitid` causes child processes that have " "terminated to be reported." msgstr "" -#: library/os.rst:4870 +#: library/os.rst:4869 msgid "" "The other ``wait*`` functions always report children that have terminated, " "so this option is not available for them." msgstr "" -#: library/os.rst:4880 +#: library/os.rst:4879 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:4915 +#: library/os.rst:4914 msgid "This option is not available for the other ``wait*`` functions." msgstr "" -#: library/os.rst:4892 +#: library/os.rst:4891 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:4896 +#: library/os.rst:4895 msgid "This option is not available for :func:`waitid`." msgstr "" -#: library/os.rst:4903 +#: library/os.rst:4902 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:4912 +#: library/os.rst:4911 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:4927 +#: library/os.rst:4926 msgid "" "These are the possible values for :attr:`!si_code` in the result returned " "by :func:`waitid`." msgstr "" -#: library/os.rst:4934 +#: library/os.rst:4933 msgid "Added :data:`CLD_KILLED` and :data:`CLD_STOPPED` values." msgstr "" -#: library/os.rst:4940 +#: library/os.rst:4939 msgid "Convert a wait status to an exit code." msgstr "" -#: library/os.rst:4942 +#: library/os.rst:4941 msgid "On Unix:" msgstr "" -#: library/os.rst:4944 +#: library/os.rst:4943 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:4947 +#: library/os.rst:4946 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 " @@ -5384,15 +5383,15 @@ msgid "" "than 0." msgstr "" -#: library/os.rst:4951 +#: library/os.rst:4950 msgid "Otherwise, raise a :exc:`ValueError`." msgstr "" -#: library/os.rst:4953 +#: library/os.rst:4952 msgid "On Windows, return *status* shifted right by 8 bits." msgstr "" -#: library/os.rst:4955 +#: library/os.rst:4954 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 " @@ -5400,221 +5399,221 @@ msgid "" "``WIFSTOPPED(status)`` is true." msgstr "" -#: library/os.rst:4962 +#: library/os.rst:4961 msgid "" ":func:`WIFEXITED`, :func:`WEXITSTATUS`, :func:`WIFSIGNALED`, :func:" "`WTERMSIG`, :func:`WIFSTOPPED`, :func:`WSTOPSIG` functions." msgstr "" -#: library/os.rst:4970 +#: library/os.rst:4969 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:4976 +#: library/os.rst:4975 msgid "" "Return ``True`` if a core dump was generated for the process, otherwise " "return ``False``." msgstr "" -#: library/os.rst:5045 +#: library/os.rst:5044 msgid "This function should be employed only if :func:`WIFSIGNALED` is true." msgstr "" -#: library/os.rst:4986 +#: library/os.rst:4985 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:4990 +#: library/os.rst:4989 msgid "See :data:`WCONTINUED` option." msgstr "" -#: library/os.rst:4997 +#: library/os.rst:4996 msgid "" "Return ``True`` if the process was stopped by delivery of a signal, " "otherwise return ``False``." msgstr "" -#: library/os.rst:5000 +#: library/os.rst:4999 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:5008 +#: library/os.rst:5007 msgid "" "Return ``True`` if the process was terminated by a signal, otherwise return " "``False``." msgstr "" -#: library/os.rst:5016 +#: library/os.rst:5015 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:5025 +#: library/os.rst:5024 msgid "Return the process exit status." msgstr "" -#: library/os.rst:5027 +#: library/os.rst:5026 msgid "This function should be employed only if :func:`WIFEXITED` is true." msgstr "" -#: library/os.rst:5034 +#: library/os.rst:5033 msgid "Return the signal which caused the process to stop." msgstr "" -#: library/os.rst:5036 +#: library/os.rst:5035 msgid "This function should be employed only if :func:`WIFSTOPPED` is true." msgstr "" -#: library/os.rst:5043 +#: library/os.rst:5042 msgid "Return the number of the signal that caused the process to terminate." msgstr "" -#: library/os.rst:5051 +#: library/os.rst:5050 msgid "Interface to the scheduler" msgstr "" -#: library/os.rst:5053 +#: library/os.rst:5052 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:5059 +#: library/os.rst:5058 msgid "" "The following scheduling policies are exposed if they are supported by the " "operating system." msgstr "" -#: library/os.rst:5064 +#: library/os.rst:5063 msgid "The default scheduling policy." msgstr "" -#: library/os.rst:5068 +#: library/os.rst:5067 msgid "" "Scheduling policy for CPU-intensive processes that tries to preserve " "interactivity on the rest of the computer." msgstr "" -#: library/os.rst:5073 +#: library/os.rst:5072 msgid "Scheduling policy for extremely low priority background tasks." msgstr "" -#: library/os.rst:5077 +#: library/os.rst:5076 msgid "Scheduling policy for sporadic server programs." msgstr "" -#: library/os.rst:5081 +#: library/os.rst:5080 msgid "A First In First Out scheduling policy." msgstr "" -#: library/os.rst:5085 +#: library/os.rst:5084 msgid "A round-robin scheduling policy." msgstr "" -#: library/os.rst:5089 +#: library/os.rst:5088 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:5096 +#: library/os.rst:5095 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:5100 +#: library/os.rst:5099 msgid "At the moment, there is only one possible parameter:" msgstr "" -#: library/os.rst:5104 +#: library/os.rst:5103 msgid "The scheduling priority for a scheduling policy." msgstr "" -#: library/os.rst:5109 +#: library/os.rst:5108 msgid "" "Get the minimum priority value for *policy*. *policy* is one of the " "scheduling policy constants above." msgstr "" -#: library/os.rst:5115 +#: library/os.rst:5114 msgid "" "Get the maximum priority value for *policy*. *policy* is one of the " "scheduling policy constants above." msgstr "" -#: library/os.rst:5121 +#: library/os.rst:5120 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:5128 +#: library/os.rst:5127 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:5135 +#: library/os.rst:5134 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:5141 +#: library/os.rst:5140 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:5147 +#: library/os.rst:5146 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:5153 +#: library/os.rst:5152 msgid "Voluntarily relinquish the CPU." msgstr "" -#: library/os.rst:5158 +#: library/os.rst:5157 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:5165 +#: library/os.rst:5164 msgid "Return the set of CPUs the process with PID *pid* is restricted to." msgstr "" -#: library/os.rst:5167 +#: library/os.rst:5166 msgid "" "If *pid* is zero, return the set of CPUs the calling thread of the current " "process is restricted to." msgstr "" -#: library/os.rst:5174 +#: library/os.rst:5173 msgid "Miscellaneous System Information" msgstr "" -#: library/os.rst:5179 +#: library/os.rst:5178 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 " @@ -5625,13 +5624,13 @@ msgid "" "included in that mapping, passing an integer for *name* is also accepted." msgstr "" -#: library/os.rst:5187 +#: library/os.rst:5186 msgid "" "If the configuration value specified by *name* isn't defined, ``None`` is " "returned." msgstr "" -#: library/os.rst:5190 +#: library/os.rst:5189 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 " @@ -5639,34 +5638,34 @@ msgid "" "`errno.EINVAL` for the error number." msgstr "" -#: library/os.rst:5200 +#: library/os.rst:5199 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:5209 +#: library/os.rst:5208 msgid "" "Return the number of logical CPUs in the system. Returns ``None`` if " "undetermined." msgstr "" -#: library/os.rst:5212 +#: library/os.rst:5211 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:5221 +#: library/os.rst:5220 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:5230 +#: library/os.rst:5229 msgid "" "Return integer-valued system configuration values. If the configuration " "value specified by *name* isn't defined, ``-1`` is returned. The comments " @@ -5675,44 +5674,44 @@ msgid "" "``sysconf_names``." msgstr "" -#: library/os.rst:5240 +#: library/os.rst:5239 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:5246 +#: library/os.rst:5245 msgid "Add ``'SC_MINSIGSTKSZ'`` name." msgstr "" -#: library/os.rst:5249 +#: library/os.rst:5248 msgid "" "The following data values are used to support path manipulation operations. " "These are defined for all platforms." msgstr "" -#: library/os.rst:5252 +#: library/os.rst:5251 msgid "" "Higher-level operations on pathnames are defined in the :mod:`os.path` " "module." msgstr "" -#: library/os.rst:5258 +#: library/os.rst:5257 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:5266 +#: library/os.rst:5265 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:5275 +#: library/os.rst:5274 msgid "" "The character used by the operating system to separate pathname components. " "This is ``'/'`` for POSIX and ``'\\\\'`` for Windows. Note that knowing " @@ -5721,7 +5720,7 @@ msgid "" "useful. Also available via :mod:`os.path`." msgstr "" -#: library/os.rst:5285 +#: library/os.rst:5284 msgid "" "An alternative character used by the operating system to separate pathname " "components, or ``None`` if only one separator character exists. This is set " @@ -5729,27 +5728,27 @@ msgid "" "via :mod:`os.path`." msgstr "" -#: library/os.rst:5294 +#: library/os.rst:5293 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:5302 +#: library/os.rst:5301 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:5309 +#: library/os.rst:5308 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:5316 +#: library/os.rst:5315 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 " @@ -5758,36 +5757,36 @@ msgid "" "default); use a single ``'\\n'`` instead, on all platforms." msgstr "" -#: library/os.rst:5325 +#: library/os.rst:5324 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:5336 +#: library/os.rst:5335 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:5344 +#: library/os.rst:5343 msgid "Random numbers" msgstr "" -#: library/os.rst:5349 +#: library/os.rst:5348 msgid "" "Get up to *size* random bytes. The function can return less bytes than " "requested." msgstr "" -#: library/os.rst:5352 +#: library/os.rst:5351 msgid "" "These bytes can be used to seed user-space random number generators or for " "cryptographic purposes." msgstr "" -#: library/os.rst:5355 +#: library/os.rst:5354 msgid "" "``getrandom()`` relies on entropy gathered from device drivers and other " "sources of environmental noise. Unnecessarily reading large quantities of " @@ -5795,32 +5794,32 @@ msgid "" "``/dev/urandom`` devices." msgstr "" -#: library/os.rst:5360 +#: library/os.rst:5359 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:5364 +#: library/os.rst:5363 msgid "" "See also the `Linux getrandom() manual page `_." msgstr "" -#: library/os.rst:5373 +#: library/os.rst:5372 msgid "" "Return a bytestring of *size* random bytes suitable for cryptographic use." msgstr "" -#: library/os.rst:5375 +#: library/os.rst:5374 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:5379 +#: library/os.rst:5378 msgid "" "On Linux, if the ``getrandom()`` syscall is available, it is used in " "blocking mode: block until the system urandom entropy pool is initialized " @@ -5830,63 +5829,63 @@ msgid "" "to poll until the system urandom entropy pool is initialized." msgstr "" -#: library/os.rst:5386 +#: library/os.rst:5385 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:5390 +#: library/os.rst:5389 msgid "On Windows, it will use ``BCryptGenRandom()``." msgstr "" -#: library/os.rst:5393 +#: library/os.rst:5392 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:5397 +#: library/os.rst:5396 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:5403 +#: library/os.rst:5402 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:5407 +#: library/os.rst:5406 msgid "" "On Linux, ``getrandom()`` is now used in blocking mode to increase the " "security." msgstr "" -#: library/os.rst:5411 +#: library/os.rst:5410 msgid "" "On Windows, ``BCryptGenRandom()`` is used instead of ``CryptGenRandom()`` " "which is deprecated." msgstr "" -#: library/os.rst:5417 +#: library/os.rst:5416 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:5421 +#: library/os.rst:5420 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:5428 +#: library/os.rst:5427 msgid "" "If this bit is set, then random bytes are drawn from the ``/dev/" "random`` pool instead of the ``/dev/urandom`` pool." @@ -5900,7 +5899,7 @@ msgstr "" msgid "effective id" msgstr "" -#: library/os.rst:438 library/os.rst:456 library/os.rst:666 library/os.rst:4263 +#: library/os.rst:438 library/os.rst:456 library/os.rst:666 library/os.rst:4262 msgid "process" msgstr "" @@ -5984,46 +5983,46 @@ msgstr "" msgid "traversal" msgstr "" -#: library/os.rst:4263 +#: library/os.rst:4262 msgid "killing" msgstr "" -#: library/os.rst:4263 +#: library/os.rst:4262 msgid "signalling" msgstr "" -#: library/os.rst:5291 +#: library/os.rst:5290 msgid ". (dot)" msgstr "" -#: library/os.rst:5263 library/os.rst:5282 library/os.rst:5291 +#: library/os.rst:5262 library/os.rst:5281 library/os.rst:5290 msgid "in pathnames" msgstr "" -#: library/os.rst:5263 +#: library/os.rst:5262 msgid ".." msgstr "" -#: library/os.rst:5282 +#: library/os.rst:5281 msgid "/ (slash)" msgstr "" -#: library/os.rst:5272 +#: library/os.rst:5271 msgid "\\ (backslash)" msgstr "" -#: library/os.rst:5272 +#: library/os.rst:5271 msgid "in pathnames (Windows)" msgstr "" -#: library/os.rst:5298 +#: library/os.rst:5297 msgid ": (colon)" msgstr "" -#: library/os.rst:5298 +#: library/os.rst:5297 msgid "path separator (POSIX)" msgstr "" -#: library/os.rst:5298 +#: library/os.rst:5297 msgid "; (semicolon)" msgstr "" diff --git a/library/pprint.po b/library/pprint.po index 89d580bb5..7bef78380 100644 --- a/library/pprint.po +++ b/library/pprint.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -265,7 +265,7 @@ msgid "" ">>> import json\n" ">>> import pprint\n" ">>> from urllib.request import urlopen\n" -">>> with urlopen('https://pypi.org/pypi/sampleproject/json') as resp:\n" +">>> with urlopen('https://pypi.org/pypi/sampleproject/1.2.0/json') as resp:\n" "... project_info = json.load(resp)['info']" msgstr "" diff --git a/library/shutil.po b/library/shutil.po index e6dfca1f2..656cc5586 100644 --- a/library/shutil.po +++ b/library/shutil.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -616,25 +616,18 @@ msgid "" "now be found." msgstr "" -#: library/shutil.rst:484 -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:492 +#: library/shutil.rst:486 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:499 +#: library/shutil.rst:493 msgid "Platform-dependent efficient copy operations" msgstr "" -#: library/shutil.rst:501 +#: library/shutil.rst:495 msgid "" "Starting from Python 3.8, all functions involving a file copy (:func:" "`copyfile`, :func:`~shutil.copy`, :func:`copy2`, :func:`copytree`, and :func:" @@ -644,54 +637,54 @@ msgid "" "buffers in Python as in \"``outfd.write(infd.read())``\"." msgstr "" -#: library/shutil.rst:509 +#: library/shutil.rst:503 msgid "On macOS `fcopyfile`_ is used to copy the file content (not metadata)." msgstr "" -#: library/shutil.rst:511 +#: library/shutil.rst:505 msgid "On Linux :func:`os.sendfile` is used." msgstr "" -#: library/shutil.rst:513 +#: library/shutil.rst:507 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:517 +#: library/shutil.rst:511 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:526 +#: library/shutil.rst:520 msgid "copytree example" msgstr "" -#: library/shutil.rst:528 +#: library/shutil.rst:522 msgid "An example that uses the :func:`ignore_patterns` helper::" msgstr "" -#: library/shutil.rst:530 +#: library/shutil.rst:524 msgid "" "from shutil import copytree, ignore_patterns\n" "\n" "copytree(source, destination, ignore=ignore_patterns('*.pyc', 'tmp*'))" msgstr "" -#: library/shutil.rst:534 +#: library/shutil.rst:528 msgid "" "This will copy everything except ``.pyc`` files and files or directories " "whose name starts with ``tmp``." msgstr "" -#: library/shutil.rst:537 +#: library/shutil.rst:531 msgid "Another example that uses the *ignore* argument to add a logging call::" msgstr "" -#: library/shutil.rst:539 +#: library/shutil.rst:533 msgid "" "from shutil import copytree\n" "import logging\n" @@ -703,11 +696,11 @@ msgid "" "copytree(source, destination, ignore=_logpath)" msgstr "" -#: library/shutil.rst:552 +#: library/shutil.rst:546 msgid "rmtree example" msgstr "" -#: library/shutil.rst:554 +#: library/shutil.rst:548 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 " @@ -715,7 +708,7 @@ msgid "" "propagate. ::" msgstr "" -#: library/shutil.rst:559 +#: library/shutil.rst:553 msgid "" "import os, stat\n" "import shutil\n" @@ -728,31 +721,31 @@ msgid "" "shutil.rmtree(directory, onexc=remove_readonly)" msgstr "" -#: library/shutil.rst:572 +#: library/shutil.rst:566 msgid "Archiving operations" msgstr "" -#: library/shutil.rst:576 +#: library/shutil.rst:570 msgid "Added support for the *xztar* format." msgstr "" -#: library/shutil.rst:580 +#: library/shutil.rst:574 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:585 +#: library/shutil.rst:579 msgid "Create an archive file (such as zip or tar) and return its name." msgstr "" -#: library/shutil.rst:587 +#: library/shutil.rst:581 msgid "" "*base_name* is the name of the file to create, including the path, minus any " "format-specific extension." msgstr "" -#: library/shutil.rst:590 +#: library/shutil.rst:584 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), " @@ -760,14 +753,14 @@ msgid "" "`lzma` module is available)." msgstr "" -#: library/shutil.rst:595 +#: library/shutil.rst:589 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:599 +#: library/shutil.rst:593 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. " @@ -775,39 +768,39 @@ msgid "" "example-with-basedir` for how to use *base_dir* and *root_dir* together." msgstr "" -#: library/shutil.rst:605 +#: library/shutil.rst:599 msgid "*root_dir* and *base_dir* both default to the current directory." msgstr "" -#: library/shutil.rst:607 +#: library/shutil.rst:601 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:610 +#: library/shutil.rst:604 msgid "" "*owner* and *group* are used when creating a tar archive. By default, uses " "the current owner and group." msgstr "" -#: library/shutil.rst:613 +#: library/shutil.rst:607 msgid "" "*logger* must be an object compatible with :pep:`282`, usually an instance " "of :class:`logging.Logger`." msgstr "" -#: library/shutil.rst:616 +#: library/shutil.rst:610 msgid "The *verbose* argument is unused and deprecated." msgstr "" -#: library/shutil.rst:618 +#: library/shutil.rst:612 msgid "" "Raises an :ref:`auditing event ` ``shutil.make_archive`` with " "arguments ``base_name``, ``format``, ``root_dir``, ``base_dir``." msgstr "" -#: library/shutil.rst:622 +#: library/shutil.rst:616 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 " @@ -815,60 +808,60 @@ msgid "" "*root_dir* to perform archiving." msgstr "" -#: library/shutil.rst:628 +#: library/shutil.rst:622 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:632 +#: library/shutil.rst:626 msgid "" "This function is now made thread-safe during creation of standard ``.zip`` " "and tar archives." msgstr "" -#: library/shutil.rst:638 +#: library/shutil.rst:632 msgid "" "Return a list of supported formats for archiving. Each element of the " "returned sequence is a tuple ``(name, description)``." msgstr "" -#: library/shutil.rst:752 +#: library/shutil.rst:746 msgid "By default :mod:`shutil` provides these formats:" msgstr "" -#: library/shutil.rst:643 +#: library/shutil.rst:637 msgid "*zip*: ZIP file (if the :mod:`zlib` module is available)." msgstr "" -#: library/shutil.rst:644 +#: library/shutil.rst:638 msgid "" "*tar*: Uncompressed tar file. Uses POSIX.1-2001 pax format for new archives." msgstr "" -#: library/shutil.rst:757 +#: library/shutil.rst:751 msgid "*gztar*: gzip'ed tar-file (if the :mod:`zlib` module is available)." msgstr "" -#: library/shutil.rst:758 +#: library/shutil.rst:752 msgid "*bztar*: bzip2'ed tar-file (if the :mod:`bz2` module is available)." msgstr "" -#: library/shutil.rst:759 +#: library/shutil.rst:753 msgid "*xztar*: xz'ed tar-file (if the :mod:`lzma` module is available)." msgstr "" -#: library/shutil.rst:649 +#: library/shutil.rst:643 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:655 +#: library/shutil.rst:649 msgid "Register an archiver for the format *name*." msgstr "" -#: library/shutil.rst:657 +#: library/shutil.rst:651 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 " @@ -877,7 +870,7 @@ msgid "" "*dry_run* and *logger* (as passed in :func:`make_archive`)." msgstr "" -#: library/shutil.rst:663 +#: library/shutil.rst:657 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 " @@ -886,37 +879,37 @@ msgid "" "not thread-safe." msgstr "" -#: library/shutil.rst:669 +#: library/shutil.rst:663 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:672 +#: library/shutil.rst:666 msgid "" "*description* is used by :func:`get_archive_formats` which returns the list " "of archivers. Defaults to an empty string." msgstr "" -#: library/shutil.rst:675 +#: library/shutil.rst:669 msgid "Added support for functions supporting the *root_dir* argument." msgstr "" -#: library/shutil.rst:681 +#: library/shutil.rst:675 msgid "Remove the archive format *name* from the list of supported formats." msgstr "" -#: library/shutil.rst:686 +#: library/shutil.rst:680 msgid "Unpack an archive. *filename* is the full path of the archive." msgstr "" -#: library/shutil.rst:688 +#: library/shutil.rst:682 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:691 +#: library/shutil.rst:685 msgid "" "*format* is the archive format: one of \"zip\", \"tar\", \"gztar\", " "\"bztar\", or \"xztar\". Or any other format registered with :func:" @@ -925,7 +918,7 @@ msgid "" "that extension. In case none is found, a :exc:`ValueError` is raised." msgstr "" -#: library/shutil.rst:698 +#: library/shutil.rst:692 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 " @@ -935,13 +928,13 @@ msgid "" "Python 3.14." msgstr "" -#: library/shutil.rst:706 +#: library/shutil.rst:700 msgid "" "Raises an :ref:`auditing event ` ``shutil.unpack_archive`` with " "arguments ``filename``, ``extract_dir``, ``format``." msgstr "" -#: library/shutil.rst:710 +#: library/shutil.rst:704 msgid "" "Never extract archives from untrusted sources without prior inspection. It " "is possible that files are created outside of the path specified in the " @@ -949,91 +942,91 @@ msgid "" "with \"/\" or filenames with two dots \"..\"." msgstr "" -#: library/shutil.rst:715 +#: library/shutil.rst:709 msgid "Accepts a :term:`path-like object` for *filename* and *extract_dir*." msgstr "" -#: library/shutil.rst:718 +#: library/shutil.rst:712 msgid "Added the *filter* argument." msgstr "" -#: library/shutil.rst:723 +#: library/shutil.rst:717 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:727 +#: library/shutil.rst:721 msgid "" "*function* is the callable that will be used to unpack archives. The " "callable will receive:" msgstr "" -#: library/shutil.rst:730 +#: library/shutil.rst:724 msgid "the path of the archive, as a positional argument;" msgstr "" -#: library/shutil.rst:731 +#: library/shutil.rst:725 msgid "" "the directory the archive must be extracted to, as a positional argument;" msgstr "" -#: library/shutil.rst:732 +#: library/shutil.rst:726 msgid "" "possibly a *filter* keyword argument, if it was given to :func:" "`unpack_archive`;" msgstr "" -#: library/shutil.rst:734 +#: library/shutil.rst:728 msgid "" "additional keyword arguments, specified by *extra_args* as a sequence of " "``(name, value)`` tuples." msgstr "" -#: library/shutil.rst:737 +#: library/shutil.rst:731 msgid "" "*description* can be provided to describe the format, and will be returned " "by the :func:`get_unpack_formats` function." msgstr "" -#: library/shutil.rst:743 +#: library/shutil.rst:737 msgid "Unregister an unpack format. *name* is the name of the format." msgstr "" -#: library/shutil.rst:748 +#: library/shutil.rst:742 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:754 +#: library/shutil.rst:748 msgid "" "*zip*: ZIP file (unpacking compressed files works only if the corresponding " "module is available)." msgstr "" -#: library/shutil.rst:756 +#: library/shutil.rst:750 msgid "*tar*: uncompressed tar file." msgstr "" -#: library/shutil.rst:761 +#: library/shutil.rst:755 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:768 +#: library/shutil.rst:762 msgid "Archiving example" msgstr "" -#: library/shutil.rst:770 +#: library/shutil.rst:764 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:767 msgid "" ">>> from shutil import make_archive\n" ">>> import os\n" @@ -1043,11 +1036,11 @@ msgid "" "'/Users/tarek/myarchive.tar.gz'" msgstr "" -#: library/shutil.rst:780 +#: library/shutil.rst:774 msgid "The resulting archive contains:" msgstr "" -#: library/shutil.rst:782 +#: library/shutil.rst:776 msgid "" "$ tar -tzvf /Users/tarek/myarchive.tar.gz\n" "drwx------ tarek/staff 0 2010-02-01 16:23:40 ./\n" @@ -1060,18 +1053,18 @@ msgid "" "-rw-r--r-- tarek/staff 37192 2010-02-06 18:23:10 ./known_hosts" msgstr "" -#: library/shutil.rst:798 +#: library/shutil.rst:792 msgid "Archiving example with *base_dir*" msgstr "" -#: library/shutil.rst:800 +#: library/shutil.rst:794 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:804 +#: library/shutil.rst:798 msgid "" "$ tree tmp\n" "tmp\n" @@ -1082,13 +1075,13 @@ msgid "" " └── do_not_add.txt" msgstr "" -#: library/shutil.rst:814 +#: library/shutil.rst:808 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:817 +#: library/shutil.rst:811 msgid "" ">>> from shutil import make_archive\n" ">>> import os\n" @@ -1102,40 +1095,40 @@ msgid "" "'/Users/tarek/my_archive.tar'" msgstr "" -#: library/shutil.rst:828 +#: library/shutil.rst:822 msgid "Listing the files in the resulting archive gives us:" msgstr "" -#: library/shutil.rst:830 +#: library/shutil.rst:824 msgid "" "$ python -m tarfile -l /Users/tarek/myarchive.tar\n" "structure/content/\n" "structure/content/please_add.txt" msgstr "" -#: library/shutil.rst:838 +#: library/shutil.rst:832 msgid "Querying the size of the output terminal" msgstr "" -#: library/shutil.rst:842 +#: library/shutil.rst:836 msgid "Get the size of the terminal window." msgstr "" -#: library/shutil.rst:844 +#: library/shutil.rst:838 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:848 +#: library/shutil.rst:842 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:852 +#: library/shutil.rst:846 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 " @@ -1144,17 +1137,17 @@ msgid "" "emulators." msgstr "" -#: library/shutil.rst:858 +#: library/shutil.rst:852 msgid "The value returned is a named tuple of type :class:`os.terminal_size`." msgstr "" -#: library/shutil.rst:860 +#: library/shutil.rst:854 msgid "" "See also: The Single UNIX Specification, Version 2, `Other Environment " "Variables`_." msgstr "" -#: library/shutil.rst:865 +#: library/shutil.rst:859 msgid "" "The ``fallback`` values are also used if :func:`os.get_terminal_size` " "returns zeroes." diff --git a/library/socket.po b/library/socket.po index b2165d771..b4b59bd7f 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -41,12 +41,12 @@ msgstr "" #: library/socket.rst:470 library/socket.rst:496 library/socket.rst:514 #: library/socket.rst:537 library/socket.rst:561 library/socket.rst:601 #: library/socket.rst:638 library/socket.rst:662 library/socket.rst:694 -#: library/socket.rst:893 library/socket.rst:1005 library/socket.rst:1033 -#: library/socket.rst:1061 library/socket.rst:1083 library/socket.rst:1192 -#: library/socket.rst:1241 library/socket.rst:1281 library/socket.rst:1325 -#: library/socket.rst:1356 library/socket.rst:1454 library/socket.rst:1488 -#: library/socket.rst:1580 library/socket.rst:1754 library/socket.rst:1880 -#: library/socket.rst:1974 includes/wasm-notavail.rst:3 +#: library/socket.rst:893 library/socket.rst:1034 library/socket.rst:1062 +#: library/socket.rst:1090 library/socket.rst:1112 library/socket.rst:1221 +#: library/socket.rst:1270 library/socket.rst:1310 library/socket.rst:1354 +#: library/socket.rst:1385 library/socket.rst:1483 library/socket.rst:1517 +#: library/socket.rst:1609 library/socket.rst:1783 library/socket.rst:1909 +#: library/socket.rst:2003 includes/wasm-notavail.rst:3 msgid "Availability" msgstr "" @@ -118,7 +118,7 @@ msgid "" "Previously, :const:`AF_UNIX` socket paths were assumed to use UTF-8 encoding." msgstr "" -#: library/socket.rst:1155 library/socket.rst:1958 +#: library/socket.rst:1184 library/socket.rst:1987 msgid "Writable :term:`bytes-like object` is now accepted." msgstr "" @@ -705,7 +705,7 @@ msgid "" "the :meth:`~socket.socket.ioctl` method of socket objects." msgstr "" -#: library/socket.rst:1570 +#: library/socket.rst:1599 msgid "``SIO_LOOPBACK_FAST_PATH`` was added." msgstr "" @@ -817,7 +817,7 @@ msgid "" "This may help close a detached socket using :meth:`socket.close`." msgstr "" -#: library/socket.rst:882 library/socket.rst:1483 +#: library/socket.rst:882 library/socket.rst:1512 msgid "The newly created socket is :ref:`non-inheritable `." msgstr "" @@ -1033,6 +1033,11 @@ msgstr "" #: library/socket.rst:920 msgid "" +"This function wraps the C function ``getaddrinfo`` of the underlying system." +msgstr "" + +#: library/socket.rst:922 +msgid "" "Translate the *host*/*port* argument into a sequence of 5-tuples that " "contain all the necessary arguments for creating a socket connected to that " "service. *host* is a domain name, a string representation of an IPv4/v6 " @@ -1041,26 +1046,31 @@ msgid "" "and *port*, you can pass ``NULL`` to the underlying C API." msgstr "" -#: library/socket.rst:927 +#: library/socket.rst:929 msgid "" "The *family*, *type* and *proto* arguments can be optionally specified in " -"order to narrow the list of addresses returned. Passing zero as a value for " -"each of these arguments selects the full range of results. The *flags* " -"argument can be one or several of the ``AI_*`` constants, and will influence " -"how results are computed and returned. For example, :const:`AI_NUMERICHOST` " -"will disable domain name resolution and will raise an error if *host* is a " -"domain name." +"order to provide options and limit the list of addresses returned. Pass " +"their default values (:data:`AF_UNSPEC`, 0, and 0, respectively) to not " +"limit the results. See the note below for details." +msgstr "" + +#: library/socket.rst:934 +msgid "" +"The *flags* argument can be one or several of the ``AI_*`` constants, and " +"will influence how results are computed and returned. For example, :const:" +"`AI_NUMERICHOST` will disable domain name resolution and will raise an error " +"if *host* is a domain name." msgstr "" -#: library/socket.rst:935 +#: library/socket.rst:939 msgid "The function returns a list of 5-tuples with the following structure:" msgstr "" -#: library/socket.rst:937 +#: library/socket.rst:941 msgid "``(family, type, proto, canonname, sockaddr)``" msgstr "" -#: library/socket.rst:939 +#: library/socket.rst:943 msgid "" "In these tuples, *family*, *type*, *proto* are all integers and are meant to " "be passed to the :func:`~socket.socket` function. *canonname* will be a " @@ -1072,20 +1082,52 @@ msgid "" "`AF_INET6`), and is meant to be passed to the :meth:`socket.connect` method." msgstr "" -#: library/socket.rst:949 +#: library/socket.rst:955 +msgid "" +"If you intend to use results from :func:`!getaddrinfo` to create a socket " +"(rather than, for example, retrieve *canonname*), consider limiting the " +"results by *type* (e.g. :data:`SOCK_STREAM` or :data:`SOCK_DGRAM`) and/or " +"*proto* (e.g. :data:`IPPROTO_TCP` or :data:`IPPROTO_UDP`) that your " +"application can handle." +msgstr "" + +#: library/socket.rst:961 +msgid "" +"The behavior with default values of *family*, *type*, *proto* and *flags* is " +"system-specific." +msgstr "" + +#: library/socket.rst:964 +msgid "" +"Many systems (for example, most Linux configurations) will return a sorted " +"list of all matching addresses. These addresses should generally be tried in " +"order until a connection succeeds (possibly tried in parallel, for example, " +"using a `Happy Eyeballs`_ algorithm). In these cases, limiting the *type* " +"and/or *proto* can help eliminate unsuccessful or unusable connection " +"attempts." +msgstr "" + +#: library/socket.rst:971 +msgid "" +"Some systems will, however, only return a single address. (For example, this " +"was reported on Solaris and AIX configurations.) On these systems, limiting " +"the *type* and/or *proto* helps ensure that this address is usable." +msgstr "" + +#: library/socket.rst:976 msgid "" "Raises an :ref:`auditing event ` ``socket.getaddrinfo`` with " "arguments ``host``, ``port``, ``family``, ``type``, ``protocol``." msgstr "" -#: library/socket.rst:951 +#: library/socket.rst:978 msgid "" "The following example fetches address information for a hypothetical TCP " "connection to ``example.org`` on port 80 (results may differ on your system " "if IPv6 isn't enabled)::" msgstr "" -#: library/socket.rst:955 +#: library/socket.rst:982 msgid "" ">>> socket.getaddrinfo(\"example.org\", 80, proto=socket.IPPROTO_TCP)\n" "[(socket.AF_INET6, socket.SOCK_STREAM,\n" @@ -1094,17 +1136,17 @@ msgid "" " 6, '', ('93.184.216.34', 80))]" msgstr "" -#: library/socket.rst:961 +#: library/socket.rst:988 msgid "parameters can now be passed using keyword arguments." msgstr "" -#: library/socket.rst:964 +#: library/socket.rst:991 msgid "" "for IPv6 multicast addresses, string representing an address will not " "contain ``%scope_id`` part." msgstr "" -#: library/socket.rst:970 +#: library/socket.rst:999 msgid "" "Return a fully qualified domain name for *name*. If *name* is omitted or " "empty, it is interpreted as the local host. To find the fully qualified " @@ -1115,7 +1157,7 @@ msgid "" "``'0.0.0.0'``, the hostname from :func:`gethostname` is returned." msgstr "" -#: library/socket.rst:981 +#: library/socket.rst:1010 msgid "" "Translate a host name to IPv4 address format. The IPv4 address is returned " "as a string, such as ``'100.50.200.5'``. If the host name is an IPv4 " @@ -1125,13 +1167,13 @@ msgid "" "stack support." msgstr "" -#: library/socket.rst:1003 +#: library/socket.rst:1032 msgid "" "Raises an :ref:`auditing event ` ``socket.gethostbyname`` with " "argument ``hostname``." msgstr "" -#: library/socket.rst:994 +#: library/socket.rst:1023 msgid "" "Translate a host name to IPv4 address format, extended interface. Return a 3-" "tuple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is the host's " @@ -1143,25 +1185,25 @@ msgid "" "stack support." msgstr "" -#: library/socket.rst:1010 +#: library/socket.rst:1039 msgid "" "Return a string containing the hostname of the machine where the Python " "interpreter is currently executing." msgstr "" -#: library/socket.rst:1013 +#: library/socket.rst:1042 msgid "" "Raises an :ref:`auditing event ` ``socket.gethostname`` with no " "arguments." msgstr "" -#: library/socket.rst:1015 +#: library/socket.rst:1044 msgid "" "Note: :func:`gethostname` doesn't always return the fully qualified domain " "name; use :func:`getfqdn` for that." msgstr "" -#: library/socket.rst:1023 +#: library/socket.rst:1052 msgid "" "Return a 3-tuple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is " "the primary host name responding to the given *ip_address*, *aliaslist* is a " @@ -1172,13 +1214,13 @@ msgid "" "`gethostbyaddr` supports both IPv4 and IPv6." msgstr "" -#: library/socket.rst:1031 +#: library/socket.rst:1060 msgid "" "Raises an :ref:`auditing event ` ``socket.gethostbyaddr`` with " "argument ``ip_address``." msgstr "" -#: library/socket.rst:1038 +#: library/socket.rst:1067 msgid "" "Translate a socket address *sockaddr* into a 2-tuple ``(host, port)``. " "Depending on the settings of *flags*, the result can contain a fully " @@ -1186,24 +1228,24 @@ msgid "" "Similarly, *port* can contain a string port name or a numeric port number." msgstr "" -#: library/socket.rst:1043 +#: library/socket.rst:1072 msgid "" "For IPv6 addresses, ``%scope_id`` is appended to the host part if *sockaddr* " "contains meaningful *scope_id*. Usually this happens for multicast addresses." msgstr "" -#: library/socket.rst:1046 +#: library/socket.rst:1075 msgid "" "For more information about *flags* you can consult :manpage:`getnameinfo(3)`." msgstr "" -#: library/socket.rst:1048 +#: library/socket.rst:1077 msgid "" "Raises an :ref:`auditing event ` ``socket.getnameinfo`` with " "argument ``sockaddr``." msgstr "" -#: library/socket.rst:1055 +#: library/socket.rst:1084 msgid "" "Translate an internet protocol name (for example, ``'icmp'``) to a constant " "suitable for passing as the (optional) third argument to the :func:`~socket." @@ -1212,66 +1254,66 @@ msgid "" "is chosen automatically if the protocol is omitted or zero." msgstr "" -#: library/socket.rst:1066 +#: library/socket.rst:1095 msgid "" "Translate an internet service name and protocol name to a port number for " "that service. The optional protocol name, if given, should be ``'tcp'`` or " "``'udp'``, otherwise any protocol will match." msgstr "" -#: library/socket.rst:1070 +#: library/socket.rst:1099 msgid "" "Raises an :ref:`auditing event ` ``socket.getservbyname`` with " "arguments ``servicename``, ``protocolname``." msgstr "" -#: library/socket.rst:1077 +#: library/socket.rst:1106 msgid "" "Translate an internet port number and protocol name to a service name for " "that service. The optional protocol name, if given, should be ``'tcp'`` or " "``'udp'``, otherwise any protocol will match." msgstr "" -#: library/socket.rst:1081 +#: library/socket.rst:1110 msgid "" "Raises an :ref:`auditing event ` ``socket.getservbyport`` with " "arguments ``port``, ``protocolname``." msgstr "" -#: library/socket.rst:1088 +#: library/socket.rst:1117 msgid "" "Convert 32-bit positive integers from network to host byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 4-byte swap operation." msgstr "" -#: library/socket.rst:1095 +#: library/socket.rst:1124 msgid "" "Convert 16-bit positive integers from network to host byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 2-byte swap operation." msgstr "" -#: library/socket.rst:1117 +#: library/socket.rst:1146 msgid "" "Raises :exc:`OverflowError` if *x* does not fit in a 16-bit unsigned integer." msgstr "" -#: library/socket.rst:1106 +#: library/socket.rst:1135 msgid "" "Convert 32-bit positive integers from host to network byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 4-byte swap operation." msgstr "" -#: library/socket.rst:1113 +#: library/socket.rst:1142 msgid "" "Convert 16-bit positive integers from host to network byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 2-byte swap operation." msgstr "" -#: library/socket.rst:1124 +#: library/socket.rst:1153 msgid "" "Convert an IPv4 address from dotted-quad string format (for example, " "'123.45.67.89') to 32-bit packed binary format, as a bytes object four " @@ -1280,26 +1322,26 @@ msgid "" "which is the C type for the 32-bit packed binary this function returns." msgstr "" -#: library/socket.rst:1130 +#: library/socket.rst:1159 msgid "" ":func:`inet_aton` also accepts strings with less than three dots; see the " "Unix manual page :manpage:`inet(3)` for details." msgstr "" -#: library/socket.rst:1133 +#: library/socket.rst:1162 msgid "" "If the IPv4 address string passed to this function is invalid, :exc:" "`OSError` will be raised. Note that exactly what is valid depends on the " "underlying C implementation of :c:func:`inet_aton`." msgstr "" -#: library/socket.rst:1137 +#: library/socket.rst:1166 msgid "" ":func:`inet_aton` does not support IPv6, and :func:`inet_pton` should be " "used instead for IPv4/v6 dual stack support." msgstr "" -#: library/socket.rst:1143 +#: library/socket.rst:1172 msgid "" "Convert a 32-bit packed IPv4 address (a :term:`bytes-like object` four bytes " "in length) to its standard dotted-quad string representation (for example, " @@ -1309,7 +1351,7 @@ msgid "" "argument." msgstr "" -#: library/socket.rst:1150 +#: library/socket.rst:1179 msgid "" "If the byte sequence passed to this function is not exactly 4 bytes in " "length, :exc:`OSError` will be raised. :func:`inet_ntoa` does not support " @@ -1317,7 +1359,7 @@ msgid "" "support." msgstr "" -#: library/socket.rst:1161 +#: library/socket.rst:1190 msgid "" "Convert an IP address from its family-specific string format to a packed, " "binary format. :func:`inet_pton` is useful when a library or network " @@ -1325,7 +1367,7 @@ msgid "" "`inet_aton`) or :c:struct:`in6_addr`." msgstr "" -#: library/socket.rst:1166 +#: library/socket.rst:1195 msgid "" "Supported values for *address_family* are currently :const:`AF_INET` and :" "const:`AF_INET6`. If the IP address string *ip_string* is invalid, :exc:" @@ -1334,11 +1376,11 @@ msgid "" "`inet_pton`." msgstr "" -#: library/socket.rst:1194 +#: library/socket.rst:1223 msgid "Windows support added" msgstr "" -#: library/socket.rst:1180 +#: library/socket.rst:1209 msgid "" "Convert a packed IP address (a :term:`bytes-like object` of some number of " "bytes) to its standard, family-specific string representation (for example, " @@ -1347,7 +1389,7 @@ msgid "" "(similar to :func:`inet_ntoa`) or :c:struct:`in6_addr`." msgstr "" -#: library/socket.rst:1187 +#: library/socket.rst:1216 msgid "" "Supported values for *address_family* are currently :const:`AF_INET` and :" "const:`AF_INET6`. If the bytes object *packed_ip* is not the correct length " @@ -1355,7 +1397,7 @@ msgid "" "`OSError` is raised for errors from the call to :func:`inet_ntop`." msgstr "" -#: library/socket.rst:1209 +#: library/socket.rst:1238 msgid "" "Return the total length, without trailing padding, of an ancillary data item " "with associated data of the given *length*. This value can often be used as " @@ -1366,11 +1408,11 @@ msgid "" "the permissible range of values." msgstr "" -#: library/socket.rst:1712 library/socket.rst:1864 +#: library/socket.rst:1741 library/socket.rst:1893 msgid "Most Unix platforms." msgstr "" -#: library/socket.rst:1227 +#: library/socket.rst:1256 msgid "" "Return the buffer size needed for :meth:`~socket.recvmsg` to receive an " "ancillary data item with associated data of the given *length*, along with " @@ -1380,7 +1422,7 @@ msgid "" "values." msgstr "" -#: library/socket.rst:1235 +#: library/socket.rst:1264 msgid "" "Note that some systems might support ancillary data without providing this " "function. Also note that setting the buffer size using the results of this " @@ -1388,131 +1430,131 @@ msgid "" "received, since additional data may be able to fit into the padding area." msgstr "" -#: library/socket.rst:1243 +#: library/socket.rst:1272 msgid "most Unix platforms." msgstr "" -#: library/socket.rst:1250 +#: library/socket.rst:1279 msgid "" "Return the default timeout in seconds (float) for new socket objects. A " "value of ``None`` indicates that new socket objects have no timeout. When " "the socket module is first imported, the default is ``None``." msgstr "" -#: library/socket.rst:1257 +#: library/socket.rst:1286 msgid "" "Set the default timeout in seconds (float) for new socket objects. When the " "socket module is first imported, the default is ``None``. See :meth:" "`~socket.settimeout` for possible values and their respective meanings." msgstr "" -#: library/socket.rst:1265 +#: library/socket.rst:1294 msgid "" "Set the machine's hostname to *name*. This will raise an :exc:`OSError` if " "you don't have enough rights." msgstr "" -#: library/socket.rst:1268 +#: library/socket.rst:1297 msgid "" "Raises an :ref:`auditing event ` ``socket.sethostname`` with " "argument ``name``." msgstr "" -#: library/socket.rst:1277 +#: library/socket.rst:1306 msgid "" "Return a list of network interface information (index int, name string) " "tuples. :exc:`OSError` if the system call fails." msgstr "" -#: library/socket.rst:1312 library/socket.rst:1329 +#: library/socket.rst:1341 library/socket.rst:1358 msgid "Windows support was added." msgstr "" -#: library/socket.rst:1290 +#: library/socket.rst:1319 msgid "" "On Windows network interfaces have different names in different contexts " "(all names are examples):" msgstr "" -#: library/socket.rst:1293 +#: library/socket.rst:1322 msgid "UUID: ``{FB605B73-AAC2-49A6-9A2F-25416AEA0573}``" msgstr "" -#: library/socket.rst:1294 +#: library/socket.rst:1323 msgid "name: ``ethernet_32770``" msgstr "" -#: library/socket.rst:1295 +#: library/socket.rst:1324 msgid "friendly name: ``vEthernet (nat)``" msgstr "" -#: library/socket.rst:1296 +#: library/socket.rst:1325 msgid "description: ``Hyper-V Virtual Ethernet Adapter``" msgstr "" -#: library/socket.rst:1298 +#: library/socket.rst:1327 msgid "" "This function returns names of the second form from the list, " "``ethernet_32770`` in this example case." msgstr "" -#: library/socket.rst:1304 +#: library/socket.rst:1333 msgid "" "Return a network interface index number corresponding to an interface name. :" "exc:`OSError` if no interface with the given name exists." msgstr "" -#: library/socket.rst:1333 +#: library/socket.rst:1362 msgid "\"Interface name\" is a name as documented in :func:`if_nameindex`." msgstr "" -#: library/socket.rst:1321 +#: library/socket.rst:1350 msgid "" "Return a network interface name corresponding to an interface index number. :" "exc:`OSError` if no interface with the given index exists." msgstr "" -#: library/socket.rst:1338 +#: library/socket.rst:1367 msgid "" "Send the list of file descriptors *fds* over an :const:`AF_UNIX` socket " "*sock*. The *fds* parameter is a sequence of file descriptors. Consult :meth:" "`~socket.sendmsg` for the documentation of these parameters." msgstr "" -#: library/socket.rst:1358 +#: library/socket.rst:1387 msgid "" "Unix platforms supporting :meth:`~socket.sendmsg` and :const:`SCM_RIGHTS` " "mechanism." msgstr "" -#: library/socket.rst:1352 +#: library/socket.rst:1381 msgid "" "Receive up to *maxfds* file descriptors from an :const:`AF_UNIX` socket " "*sock*. Return ``(msg, list(fds), flags, addr)``. Consult :meth:`~socket." "recvmsg` for the documentation of these parameters." msgstr "" -#: library/socket.rst:1365 +#: library/socket.rst:1394 msgid "Any truncated integers at the end of the list of file descriptors." msgstr "" -#: library/socket.rst:1371 +#: library/socket.rst:1400 msgid "Socket Objects" msgstr "" -#: library/socket.rst:1373 +#: library/socket.rst:1402 msgid "" "Socket objects have the following methods. Except for :meth:`~socket." "makefile`, these correspond to Unix system calls applicable to sockets." msgstr "" -#: library/socket.rst:1377 +#: library/socket.rst:1406 msgid "" "Support for the :term:`context manager` protocol was added. Exiting the " "context manager is equivalent to calling :meth:`~socket.close`." msgstr "" -#: library/socket.rst:1384 +#: library/socket.rst:1413 msgid "" "Accept a connection. The socket must be bound to an address and listening " "for connections. The return value is a pair ``(conn, address)`` where *conn* " @@ -1521,31 +1563,31 @@ msgid "" "connection." msgstr "" -#: library/socket.rst:1485 +#: library/socket.rst:1514 msgid "The socket is now non-inheritable." msgstr "" -#: library/socket.rst:1625 library/socket.rst:1716 library/socket.rst:1808 -#: library/socket.rst:1870 +#: library/socket.rst:1654 library/socket.rst:1745 library/socket.rst:1837 +#: library/socket.rst:1899 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:" "`InterruptedError` exception (see :pep:`475` for the rationale)." msgstr "" -#: library/socket.rst:1402 +#: library/socket.rst:1431 msgid "" "Bind the socket to *address*. The socket must not already be bound. (The " "format of *address* depends on the address family --- see above.)" msgstr "" -#: library/socket.rst:1405 +#: library/socket.rst:1434 msgid "" "Raises an :ref:`auditing event ` ``socket.bind`` with arguments " "``self``, ``address``." msgstr "" -#: library/socket.rst:1412 +#: library/socket.rst:1441 msgid "" "Mark the socket closed. The underlying system resource (e.g. a file " "descriptor) is also closed when all file objects from :meth:`makefile` are " @@ -1554,33 +1596,33 @@ msgid "" "flushed)." msgstr "" -#: library/socket.rst:1418 +#: library/socket.rst:1447 msgid "" "Sockets are automatically closed when they are garbage-collected, but it is " "recommended to :meth:`close` them explicitly, or to use a :keyword:`with` " "statement around them." msgstr "" -#: library/socket.rst:1422 +#: library/socket.rst:1451 msgid "" ":exc:`OSError` is now raised if an error occurs when the underlying :c:func:" "`close` call is made." msgstr "" -#: library/socket.rst:1428 +#: library/socket.rst:1457 msgid "" ":meth:`close` releases the resource associated with a connection but does " "not necessarily close the connection immediately. If you want to close the " "connection in a timely fashion, call :meth:`shutdown` before :meth:`close`." msgstr "" -#: library/socket.rst:1436 +#: library/socket.rst:1465 msgid "" "Connect to a remote socket at *address*. (The format of *address* depends on " "the address family --- see above.)" msgstr "" -#: library/socket.rst:1439 +#: library/socket.rst:1468 msgid "" "If the connection is interrupted by a signal, the method waits until the " "connection completes, or raise a :exc:`TimeoutError` on timeout, if the " @@ -1590,13 +1632,13 @@ msgid "" "(or the exception raised by the signal handler)." msgstr "" -#: library/socket.rst:1466 +#: library/socket.rst:1495 msgid "" "Raises an :ref:`auditing event ` ``socket.connect`` with arguments " "``self``, ``address``." msgstr "" -#: library/socket.rst:1448 +#: library/socket.rst:1477 msgid "" "The method now waits until the connection completes instead of raising an :" "exc:`InterruptedError` exception if the connection is interrupted by a " @@ -1604,7 +1646,7 @@ msgid "" "blocking or has a timeout (see the :pep:`475` for the rationale)." msgstr "" -#: library/socket.rst:1459 +#: library/socket.rst:1488 msgid "" "Like ``connect(address)``, but return an error indicator instead of raising " "an exception for errors returned by the C-level :c:func:`connect` call " @@ -1614,38 +1656,38 @@ msgid "" "asynchronous connects." msgstr "" -#: library/socket.rst:1472 +#: library/socket.rst:1501 msgid "" "Put the socket object into closed state without actually closing the " "underlying file descriptor. The file descriptor is returned, and can be " "reused for other purposes." msgstr "" -#: library/socket.rst:1481 +#: library/socket.rst:1510 msgid "Duplicate the socket." msgstr "" -#: library/socket.rst:1493 +#: library/socket.rst:1522 msgid "" "Return the socket's file descriptor (a small integer), or -1 on failure. " "This is useful with :func:`select.select`." msgstr "" -#: library/socket.rst:1496 +#: library/socket.rst:1525 msgid "" "Under Windows the small integer returned by this method cannot be used where " "a file descriptor can be used (such as :func:`os.fdopen`). Unix does not " "have this limitation." msgstr "" -#: library/socket.rst:1502 +#: library/socket.rst:1531 msgid "" "Get the :ref:`inheritable flag ` of the socket's file " "descriptor or socket's handle: ``True`` if the socket can be inherited in " "child processes, ``False`` if it cannot." msgstr "" -#: library/socket.rst:1511 +#: library/socket.rst:1540 msgid "" "Return the remote address to which the socket is connected. This is useful " "to find out the port number of a remote IPv4/v6 socket, for instance. (The " @@ -1653,14 +1695,14 @@ msgid "" "above.) On some systems this function is not supported." msgstr "" -#: library/socket.rst:1519 +#: library/socket.rst:1548 msgid "" "Return the socket's own address. This is useful to find out the port number " "of an IPv4/v6 socket, for instance. (The format of the address returned " "depends on the address family --- see above.)" msgstr "" -#: library/socket.rst:1526 +#: library/socket.rst:1555 msgid "" "Return the value of the given socket option (see the Unix man page :manpage:" "`getsockopt(2)`). The needed symbolic constants (:ref:`SO_\\* etc. `_ for more information." msgstr "" -#: library/socket.rst:1564 +#: library/socket.rst:1593 msgid "" "On other platforms, the generic :func:`fcntl.fcntl` and :func:`fcntl.ioctl` " "functions may be used; they accept a socket object as their first argument." msgstr "" -#: library/socket.rst:1567 +#: library/socket.rst:1596 msgid "" "Currently only the following control codes are supported: ``SIO_RCVALL``, " "``SIO_KEEPALIVE_VALS``, and ``SIO_LOOPBACK_FAST_PATH``." msgstr "" -#: library/socket.rst:1575 +#: library/socket.rst:1604 msgid "" "Enable a server to accept connections. If *backlog* is specified, it must " "be at least 0 (if it is lower, it is set to 0); it specifies the number of " @@ -1724,11 +1766,11 @@ msgid "" "connections. If not specified, a default reasonable value is chosen." msgstr "" -#: library/socket.rst:1582 +#: library/socket.rst:1611 msgid "The *backlog* parameter is now optional." msgstr "" -#: library/socket.rst:1591 +#: library/socket.rst:1620 msgid "" "Return a :term:`file object` associated with the socket. The exact returned " "type depends on the arguments given to :meth:`makefile`. These arguments " @@ -1737,28 +1779,28 @@ msgid "" "``'b'``, or a combination of those." msgstr "" -#: library/socket.rst:1597 +#: library/socket.rst:1626 msgid "" "The socket must be in blocking mode; it can have a timeout, but the file " "object's internal buffer may end up in an inconsistent state if a timeout " "occurs." msgstr "" -#: library/socket.rst:1601 +#: library/socket.rst:1630 msgid "" "Closing the file object returned by :meth:`makefile` won't close the " "original socket unless all other file objects have been closed and :meth:" "`socket.close` has been called on the socket object." msgstr "" -#: library/socket.rst:1607 +#: library/socket.rst:1636 msgid "" "On Windows, the file-like object created by :meth:`makefile` cannot be used " "where a file object with a file descriptor is expected, such as the stream " "arguments of :meth:`subprocess.Popen`." msgstr "" -#: library/socket.rst:1614 +#: library/socket.rst:1643 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 " @@ -1768,13 +1810,13 @@ msgid "" "zero." msgstr "" -#: library/socket.rst:1622 +#: library/socket.rst:1651 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:1633 +#: library/socket.rst:1662 msgid "" "Receive data from the socket. The return value is a pair ``(bytes, " "address)`` where *bytes* is a bytes object representing the data received " @@ -1784,14 +1826,14 @@ msgid "" "address family --- see above.)" msgstr "" -#: library/socket.rst:1644 +#: library/socket.rst:1673 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:1651 +#: library/socket.rst:1680 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 " @@ -1802,7 +1844,7 @@ msgid "" "*flags* argument defaults to 0 and has the same meaning as for :meth:`recv`." msgstr "" -#: library/socket.rst:1661 +#: library/socket.rst:1690 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 " @@ -1817,7 +1859,7 @@ msgid "" "socket, if available; otherwise, its value is unspecified." msgstr "" -#: library/socket.rst:1675 +#: library/socket.rst:1704 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 " @@ -1830,7 +1872,7 @@ msgid "" "descriptors received via this mechanism." msgstr "" -#: library/socket.rst:1686 +#: library/socket.rst:1715 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 " @@ -1839,7 +1881,7 @@ msgid "" "provided it has not been truncated before the start of its associated data." msgstr "" -#: library/socket.rst:1693 +#: library/socket.rst:1722 msgid "" "On systems which support the :const:`SCM_RIGHTS` mechanism, the following " "function will receive up to *maxfds* file descriptors, returning the message " @@ -1848,7 +1890,7 @@ msgid "" "meth:`sendmsg`. ::" msgstr "" -#: library/socket.rst:1699 +#: library/socket.rst:1728 msgid "" "import socket, array\n" "\n" @@ -1865,7 +1907,7 @@ msgid "" " return msg, list(fds)" msgstr "" -#: library/socket.rst:1724 +#: library/socket.rst:1753 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 " @@ -1878,7 +1920,7 @@ msgid "" "arguments have the same meaning as for :meth:`recvmsg`." msgstr "" -#: library/socket.rst:1735 +#: library/socket.rst:1764 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 " @@ -1886,11 +1928,11 @@ msgid "" "for :meth:`recvmsg`." msgstr "" -#: library/socket.rst:1740 +#: library/socket.rst:1769 msgid "Example::" msgstr "" -#: library/socket.rst:1742 +#: library/socket.rst:1771 msgid "" ">>> import socket\n" ">>> s1, s2 = socket.socketpair()\n" @@ -1905,7 +1947,7 @@ msgid "" "[bytearray(b'Mary'), bytearray(b'01 had a 9'), bytearray(b'little lamb---')]" msgstr "" -#: library/socket.rst:1763 +#: library/socket.rst:1792 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 " @@ -1915,7 +1957,7 @@ msgid "" "format of *address* depends on the address family --- see above.)" msgstr "" -#: library/socket.rst:1773 +#: library/socket.rst:1802 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), " @@ -1924,7 +1966,7 @@ msgid "" "of the optional argument *flags*; it defaults to zero." msgstr "" -#: library/socket.rst:1782 +#: library/socket.rst:1811 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` " @@ -1934,7 +1976,7 @@ msgid "" "data. For further information on this topic, consult the :ref:`socket-howto`." msgstr "" -#: library/socket.rst:1797 +#: library/socket.rst:1826 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` " @@ -1944,13 +1986,13 @@ msgid "" "to determine how much data, if any, was successfully sent." msgstr "" -#: library/socket.rst:1804 +#: library/socket.rst:1833 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:1817 +#: library/socket.rst:1846 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 " @@ -1959,13 +2001,13 @@ msgid "" "address family --- see above.)" msgstr "" -#: library/socket.rst:1823 +#: library/socket.rst:1852 msgid "" "Raises an :ref:`auditing event ` ``socket.sendto`` with arguments " "``self``, ``address``." msgstr "" -#: library/socket.rst:1833 +#: library/socket.rst:1862 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. " @@ -1985,14 +2027,14 @@ msgid "" "bytes of non-ancillary data sent." msgstr "" -#: library/socket.rst:1853 +#: library/socket.rst:1882 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:1857 +#: library/socket.rst:1886 msgid "" "import socket, array\n" "\n" @@ -2001,20 +2043,20 @@ msgid "" "array(\"i\", fds))])" msgstr "" -#: library/socket.rst:1866 +#: library/socket.rst:1895 msgid "" "Raises an :ref:`auditing event ` ``socket.sendmsg`` with arguments " "``self``, ``address``." msgstr "" -#: library/socket.rst:1877 +#: library/socket.rst:1906 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:1886 +#: library/socket.rst:1915 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 " @@ -2028,38 +2070,38 @@ msgid "" "be of :const:`SOCK_STREAM` type. Non-blocking sockets are not supported." msgstr "" -#: library/socket.rst:1902 +#: library/socket.rst:1931 msgid "" "Set the :ref:`inheritable flag ` of the socket's file " "descriptor or socket's handle." msgstr "" -#: library/socket.rst:1910 +#: library/socket.rst:1939 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:1913 +#: library/socket.rst:1942 msgid "" "This method is a shorthand for certain :meth:`~socket.settimeout` calls:" msgstr "" -#: library/socket.rst:1915 +#: library/socket.rst:1944 msgid "``sock.setblocking(True)`` is equivalent to ``sock.settimeout(None)``" msgstr "" -#: library/socket.rst:1917 +#: library/socket.rst:1946 msgid "``sock.setblocking(False)`` is equivalent to ``sock.settimeout(0.0)``" msgstr "" -#: library/socket.rst:1919 +#: library/socket.rst:1948 msgid "" "The method no longer applies :const:`SOCK_NONBLOCK` flag on :attr:`socket." "type`." msgstr "" -#: library/socket.rst:1926 +#: library/socket.rst:1955 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-" @@ -2069,19 +2111,19 @@ msgid "" "blocking mode. If ``None`` is given, the socket is put in blocking mode." msgstr "" -#: library/socket.rst:1933 +#: library/socket.rst:1962 msgid "" "For further information, please consult the :ref:`notes on socket timeouts " "`." msgstr "" -#: library/socket.rst:1935 +#: library/socket.rst:1964 msgid "" "The method no longer toggles :const:`SOCK_NONBLOCK` flag on :attr:`socket." "type`." msgstr "" -#: library/socket.rst:1948 +#: library/socket.rst:1977 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 " @@ -2094,11 +2136,11 @@ msgid "" "C function with ``optval=NULL`` and ``optlen=optlen``." msgstr "" -#: library/socket.rst:1961 +#: library/socket.rst:1990 msgid "setsockopt(level, optname, None, optlen: int) form added." msgstr "" -#: library/socket.rst:1969 +#: library/socket.rst:1998 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`, " @@ -2106,7 +2148,7 @@ msgid "" "and receives are disallowed." msgstr "" -#: library/socket.rst:1979 +#: library/socket.rst:2008 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 " @@ -2117,48 +2159,48 @@ msgid "" "process." msgstr "" -#: library/socket.rst:1991 +#: library/socket.rst:2020 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:1994 +#: library/socket.rst:2023 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:2000 +#: library/socket.rst:2029 msgid "The socket family." msgstr "" -#: library/socket.rst:2005 +#: library/socket.rst:2034 msgid "The socket type." msgstr "" -#: library/socket.rst:2010 +#: library/socket.rst:2039 msgid "The socket protocol." msgstr "" -#: library/socket.rst:2017 +#: library/socket.rst:2046 msgid "Notes on socket timeouts" msgstr "" -#: library/socket.rst:2019 +#: library/socket.rst:2048 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:2023 +#: library/socket.rst:2052 msgid "" "In *blocking mode*, operations block until complete or the system returns an " "error (such as connection timed out)." msgstr "" -#: library/socket.rst:2026 +#: library/socket.rst:2055 msgid "" "In *non-blocking mode*, operations fail (with an error that is unfortunately " "system-dependent) if they cannot be completed immediately: functions from " @@ -2166,14 +2208,14 @@ msgid "" "available for reading or writing." msgstr "" -#: library/socket.rst:2031 +#: library/socket.rst:2060 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:2036 +#: library/socket.rst:2065 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 " @@ -2182,11 +2224,11 @@ msgid "" "you decide to use the :meth:`~socket.fileno` of a socket." msgstr "" -#: library/socket.rst:2043 +#: library/socket.rst:2072 msgid "Timeouts and the ``connect`` method" msgstr "" -#: library/socket.rst:2045 +#: library/socket.rst:2074 msgid "" "The :meth:`~socket.connect` operation is also subject to the timeout " "setting, and in general it is recommended to call :meth:`~socket.settimeout` " @@ -2196,24 +2238,24 @@ msgid "" "setting." msgstr "" -#: library/socket.rst:2053 +#: library/socket.rst:2082 msgid "Timeouts and the ``accept`` method" msgstr "" -#: library/socket.rst:2055 +#: library/socket.rst:2084 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:2059 +#: library/socket.rst:2088 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:2062 +#: library/socket.rst:2091 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 " @@ -2221,11 +2263,11 @@ msgid "" "it is recommended you manually override this setting." msgstr "" -#: library/socket.rst:2071 +#: library/socket.rst:2100 msgid "Example" msgstr "" -#: library/socket.rst:2073 +#: library/socket.rst:2102 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 " @@ -2238,11 +2280,11 @@ msgid "" "on the new socket returned by :meth:`~socket.accept`." msgstr "" -#: library/socket.rst:2083 +#: library/socket.rst:2112 msgid "The first two examples support IPv4 only. ::" msgstr "" -#: library/socket.rst:2085 +#: library/socket.rst:2114 msgid "" "# Echo server program\n" "import socket\n" @@ -2261,7 +2303,7 @@ msgid "" " conn.sendall(data)" msgstr "" -#: library/socket.rst:2103 +#: library/socket.rst:2132 msgid "" "# Echo client program\n" "import socket\n" @@ -2275,7 +2317,7 @@ msgid "" "print('Received', repr(data))" msgstr "" -#: library/socket.rst:2114 +#: library/socket.rst:2143 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 " @@ -2285,7 +2327,7 @@ msgid "" "resolution, and sends traffic to the first one connected successfully. ::" msgstr "" -#: library/socket.rst:2121 +#: library/socket.rst:2150 msgid "" "# Echo server program\n" "import socket\n" @@ -2322,7 +2364,7 @@ msgid "" " conn.send(data)" msgstr "" -#: library/socket.rst:2157 +#: library/socket.rst:2186 msgid "" "# Echo client program\n" "import socket\n" @@ -2355,14 +2397,14 @@ msgid "" "print('Received', repr(data))" msgstr "" -#: library/socket.rst:2186 +#: library/socket.rst:2215 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:2190 +#: library/socket.rst:2219 msgid "" "import socket\n" "\n" @@ -2386,29 +2428,29 @@ msgid "" "s.ioctl(socket.SIO_RCVALL, socket.RCVALL_OFF)" msgstr "" -#: library/socket.rst:2211 +#: library/socket.rst:2240 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:2215 +#: library/socket.rst:2244 msgid "socket.socket(socket.AF_CAN, socket.SOCK_DGRAM, socket.CAN_BCM)" msgstr "" -#: library/socket.rst:2217 +#: library/socket.rst:2246 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:2221 +#: library/socket.rst:2250 msgid "This last example might require special privileges::" msgstr "" -#: library/socket.rst:2223 +#: library/socket.rst:2252 msgid "" "import socket\n" "import struct\n" @@ -2450,59 +2492,59 @@ msgid "" " print('Error sending CAN frame')" msgstr "" -#: library/socket.rst:2261 +#: library/socket.rst:2290 msgid "" "Running an example several times with too small delay between executions, " "could lead to this error::" msgstr "" -#: library/socket.rst:2264 +#: library/socket.rst:2293 msgid "OSError: [Errno 98] Address already in use" msgstr "" -#: library/socket.rst:2266 +#: library/socket.rst:2295 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:2269 +#: library/socket.rst:2298 msgid "" "There is a :mod:`socket` flag to set, in order to prevent this, :const:" "`socket.SO_REUSEADDR`::" msgstr "" -#: library/socket.rst:2272 +#: library/socket.rst:2301 msgid "" "s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)\n" "s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)\n" "s.bind((HOST, PORT))" msgstr "" -#: library/socket.rst:2276 +#: library/socket.rst:2305 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:2282 +#: library/socket.rst:2311 msgid "" "For an introduction to socket programming (in C), see the following papers:" msgstr "" -#: library/socket.rst:2284 +#: library/socket.rst:2313 msgid "" "*An Introductory 4.3BSD Interprocess Communication Tutorial*, by Stuart " "Sechrest" msgstr "" -#: library/socket.rst:2286 +#: library/socket.rst:2315 msgid "" "*An Advanced 4.3BSD Interprocess Communication Tutorial*, by Samuel J. " "Leffler et al," msgstr "" -#: library/socket.rst:2289 +#: library/socket.rst:2318 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 " @@ -2521,18 +2563,18 @@ msgstr "" msgid "socket" msgstr "" -#: library/socket.rst:1589 +#: library/socket.rst:1618 msgid "I/O control" msgstr "" -#: library/socket.rst:1589 +#: library/socket.rst:1618 msgid "buffering" msgstr "" -#: library/socket.rst:1946 +#: library/socket.rst:1975 msgid "module" msgstr "" -#: library/socket.rst:1946 +#: library/socket.rst:1975 msgid "struct" msgstr "" diff --git a/library/sqlite3.po b/library/sqlite3.po index 855bd328d..21afb7f12 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2740,27 +2740,28 @@ msgid "" ">>> con = sqlite3.connect(\"file:tutorial.db?mode=ro\", uri=True)\n" ">>> con.execute(\"CREATE TABLE readonly(data)\")\n" "Traceback (most recent call last):\n" -"OperationalError: attempt to write a readonly database" +"OperationalError: attempt to write a readonly database\n" +">>> con.close()" msgstr "" -#: library/sqlite3.rst:2424 +#: library/sqlite3.rst:2425 msgid "" "Do not implicitly create a new database file if it does not already exist; " "will raise :exc:`~sqlite3.OperationalError` if unable to create a new file:" msgstr "" -#: library/sqlite3.rst:2427 +#: library/sqlite3.rst:2428 msgid "" ">>> con = sqlite3.connect(\"file:nosuchdb.db?mode=rw\", uri=True)\n" "Traceback (most recent call last):\n" "OperationalError: unable to open database file" msgstr "" -#: library/sqlite3.rst:2434 +#: library/sqlite3.rst:2435 msgid "Create a shared named in-memory database:" msgstr "" -#: library/sqlite3.rst:2436 +#: library/sqlite3.rst:2437 msgid "" "db = \"file:mem1?mode=memory&cache=shared\"\n" "con1 = sqlite3.connect(db, uri=True)\n" @@ -2775,24 +2776,24 @@ msgid "" "con2.close()" msgstr "" -#: library/sqlite3.rst:2450 +#: library/sqlite3.rst:2451 msgid "" "More information about this feature, including a list of parameters, can be " "found in the `SQLite URI documentation`_." msgstr "" -#: library/sqlite3.rst:2459 +#: library/sqlite3.rst:2460 msgid "How to create and use row factories" msgstr "" -#: library/sqlite3.rst:2461 +#: library/sqlite3.rst:2462 msgid "" "By default, :mod:`!sqlite3` represents each row as a :class:`tuple`. If a :" "class:`!tuple` does not suit your needs, you can use the :class:`sqlite3." "Row` class or a custom :attr:`~Cursor.row_factory`." msgstr "" -#: library/sqlite3.rst:2466 +#: library/sqlite3.rst:2467 msgid "" "While :attr:`!row_factory` exists as an attribute both on the :class:" "`Cursor` and the :class:`Connection`, it is recommended to set :class:" @@ -2800,7 +2801,7 @@ msgid "" "use the same row factory." msgstr "" -#: library/sqlite3.rst:2471 +#: library/sqlite3.rst:2472 msgid "" ":class:`!Row` provides indexed and case-insensitive named access to columns, " "with minimal memory overhead and performance impact over a :class:`!tuple`. " @@ -2808,17 +2809,17 @@ msgid "" "attribute:" msgstr "" -#: library/sqlite3.rst:2476 +#: library/sqlite3.rst:2477 msgid "" ">>> con = sqlite3.connect(\":memory:\")\n" ">>> con.row_factory = sqlite3.Row" msgstr "" -#: library/sqlite3.rst:2481 +#: library/sqlite3.rst:2482 msgid "Queries now return :class:`!Row` objects:" msgstr "" -#: library/sqlite3.rst:2483 +#: library/sqlite3.rst:2484 msgid "" ">>> res = con.execute(\"SELECT 'Earth' AS name, 6378 AS radius\")\n" ">>> row = res.fetchone()\n" @@ -2833,7 +2834,7 @@ msgid "" ">>> con.close()" msgstr "" -#: library/sqlite3.rst:2499 +#: library/sqlite3.rst:2500 msgid "" "The ``FROM`` clause can be omitted in the ``SELECT`` statement, as in the " "above example. In such cases, SQLite returns a single row with columns " @@ -2841,25 +2842,25 @@ msgid "" "alias``." msgstr "" -#: library/sqlite3.rst:2504 +#: library/sqlite3.rst:2505 msgid "" "You can create a custom :attr:`~Cursor.row_factory` that returns each row as " "a :class:`dict`, with column names mapped to values:" msgstr "" -#: library/sqlite3.rst:2507 +#: library/sqlite3.rst:2508 msgid "" "def dict_factory(cursor, row):\n" " fields = [column[0] for column in cursor.description]\n" " return {key: value for key, value in zip(fields, row)}" msgstr "" -#: library/sqlite3.rst:2513 +#: library/sqlite3.rst:2514 msgid "" "Using it, queries now return a :class:`!dict` instead of a :class:`!tuple`:" msgstr "" -#: library/sqlite3.rst:2515 +#: library/sqlite3.rst:2516 msgid "" ">>> con = sqlite3.connect(\":memory:\")\n" ">>> con.row_factory = dict_factory\n" @@ -2869,11 +2870,11 @@ msgid "" ">>> con.close()" msgstr "" -#: library/sqlite3.rst:2524 +#: library/sqlite3.rst:2525 msgid "The following row factory returns a :term:`named tuple`:" msgstr "" -#: library/sqlite3.rst:2526 +#: library/sqlite3.rst:2527 msgid "" "from collections import namedtuple\n" "\n" @@ -2883,11 +2884,11 @@ msgid "" " return cls._make(row)" msgstr "" -#: library/sqlite3.rst:2535 +#: library/sqlite3.rst:2536 msgid ":func:`!namedtuple_factory` can be used as follows:" msgstr "" -#: library/sqlite3.rst:2537 +#: library/sqlite3.rst:2538 msgid "" ">>> con = sqlite3.connect(\":memory:\")\n" ">>> con.row_factory = namedtuple_factory\n" @@ -2902,18 +2903,18 @@ msgid "" ">>> con.close()" msgstr "" -#: library/sqlite3.rst:2551 +#: library/sqlite3.rst:2552 msgid "" "With some adjustments, the above recipe can be adapted to use a :class:" "`~dataclasses.dataclass`, or any other custom class, instead of a :class:" "`~collections.namedtuple`." msgstr "" -#: library/sqlite3.rst:2559 +#: library/sqlite3.rst:2560 msgid "How to handle non-UTF-8 text encodings" msgstr "" -#: library/sqlite3.rst:2561 +#: library/sqlite3.rst:2562 msgid "" "By default, :mod:`!sqlite3` uses :class:`str` to adapt SQLite values with " "the ``TEXT`` data type. This works well for UTF-8 encoded text, but it might " @@ -2921,7 +2922,7 @@ msgid "" "`~Connection.text_factory` to handle such cases." msgstr "" -#: library/sqlite3.rst:2567 +#: library/sqlite3.rst:2568 msgid "" "Because of SQLite's `flexible typing`_, it is not uncommon to encounter " "table columns with the ``TEXT`` data type containing non-UTF-8 encodings, or " @@ -2932,39 +2933,39 @@ msgid "" "text using this :attr:`~Connection.text_factory`:" msgstr "" -#: library/sqlite3.rst:2576 +#: library/sqlite3.rst:2577 msgid "con.text_factory = lambda data: str(data, encoding=\"latin2\")" msgstr "" -#: library/sqlite3.rst:2580 +#: library/sqlite3.rst:2581 msgid "" "For invalid UTF-8 or arbitrary data in stored in ``TEXT`` table columns, you " "can use the following technique, borrowed from the :ref:`unicode-howto`:" msgstr "" -#: library/sqlite3.rst:2583 +#: library/sqlite3.rst:2584 msgid "con.text_factory = lambda data: str(data, errors=\"surrogateescape\")" msgstr "" -#: library/sqlite3.rst:2589 +#: library/sqlite3.rst:2590 msgid "" "The :mod:`!sqlite3` module API does not support strings containing " "surrogates." msgstr "" -#: library/sqlite3.rst:2594 +#: library/sqlite3.rst:2595 msgid ":ref:`unicode-howto`" msgstr "" -#: library/sqlite3.rst:2600 +#: library/sqlite3.rst:2601 msgid "Explanation" msgstr "" -#: library/sqlite3.rst:2606 +#: library/sqlite3.rst:2607 msgid "Transaction control" msgstr "" -#: library/sqlite3.rst:2608 +#: library/sqlite3.rst:2609 msgid "" ":mod:`!sqlite3` offers multiple methods of controlling whether, when and how " "database transactions are opened and closed. :ref:`sqlite3-transaction-" @@ -2972,24 +2973,24 @@ msgid "" "isolation-level` retains the pre-Python 3.12 behaviour." msgstr "" -#: library/sqlite3.rst:2617 +#: library/sqlite3.rst:2618 msgid "Transaction control via the ``autocommit`` attribute" msgstr "" -#: library/sqlite3.rst:2619 +#: library/sqlite3.rst:2620 msgid "" "The recommended way of controlling transaction behaviour is through the :" "attr:`Connection.autocommit` attribute, which should preferably be set using " "the *autocommit* parameter of :func:`connect`." msgstr "" -#: library/sqlite3.rst:2624 +#: library/sqlite3.rst:2625 msgid "" "It is suggested to set *autocommit* to ``False``, which implies :pep:`249`-" "compliant transaction control. This means:" msgstr "" -#: library/sqlite3.rst:2628 +#: library/sqlite3.rst:2629 msgid "" ":mod:`!sqlite3` ensures that a transaction is always open, so :func:" "`connect`, :meth:`Connection.commit`, and :meth:`Connection.rollback` will " @@ -2998,21 +2999,21 @@ msgid "" "when opening transactions." msgstr "" -#: library/sqlite3.rst:2633 +#: library/sqlite3.rst:2634 msgid "Transactions should be committed explicitly using :meth:`!commit`." msgstr "" -#: library/sqlite3.rst:2634 +#: library/sqlite3.rst:2635 msgid "Transactions should be rolled back explicitly using :meth:`!rollback`." msgstr "" -#: library/sqlite3.rst:2635 +#: library/sqlite3.rst:2636 msgid "" "An implicit rollback is performed if the database is :meth:`~Connection." "close`-ed with pending changes." msgstr "" -#: library/sqlite3.rst:2638 +#: library/sqlite3.rst:2639 msgid "" "Set *autocommit* to ``True`` to enable SQLite's `autocommit mode`_. In this " "mode, :meth:`Connection.commit` and :meth:`Connection.rollback` have no " @@ -3021,25 +3022,25 @@ msgid "" "in_transaction` to query the low-level SQLite autocommit mode." msgstr "" -#: library/sqlite3.rst:2646 +#: library/sqlite3.rst:2647 msgid "" "Set *autocommit* to :data:`LEGACY_TRANSACTION_CONTROL` to leave transaction " "control behaviour to the :attr:`Connection.isolation_level` attribute. See :" "ref:`sqlite3-transaction-control-isolation-level` for more information." msgstr "" -#: library/sqlite3.rst:2655 +#: library/sqlite3.rst:2656 msgid "Transaction control via the ``isolation_level`` attribute" msgstr "" -#: library/sqlite3.rst:2659 +#: library/sqlite3.rst:2660 msgid "" "The recommended way of controlling transactions is via the :attr:" "`~Connection.autocommit` attribute. See :ref:`sqlite3-transaction-control-" "autocommit`." msgstr "" -#: library/sqlite3.rst:2663 +#: library/sqlite3.rst:2664 msgid "" "If :attr:`Connection.autocommit` is set to :data:" "`LEGACY_TRANSACTION_CONTROL` (the default), transaction behaviour is " @@ -3047,7 +3048,7 @@ msgid "" "Otherwise, :attr:`!isolation_level` has no effect." msgstr "" -#: library/sqlite3.rst:2669 +#: library/sqlite3.rst:2670 msgid "" "If the connection attribute :attr:`~Connection.isolation_level` is not " "``None``, new transactions are implicitly opened before :meth:`~Cursor." @@ -3061,7 +3062,7 @@ msgid "" "attribute." msgstr "" -#: library/sqlite3.rst:2682 +#: library/sqlite3.rst:2683 msgid "" "If :attr:`~Connection.isolation_level` is set to ``None``, no transactions " "are implicitly opened at all. This leaves the underlying SQLite library in " @@ -3071,20 +3072,20 @@ msgid "" "in_transaction` attribute." msgstr "" -#: library/sqlite3.rst:2690 +#: library/sqlite3.rst:2691 msgid "" "The :meth:`~Cursor.executescript` method implicitly commits any pending " "transaction before execution of the given SQL script, regardless of the " "value of :attr:`~Connection.isolation_level`." msgstr "" -#: library/sqlite3.rst:2694 +#: library/sqlite3.rst:2695 msgid "" ":mod:`!sqlite3` used to implicitly commit an open transaction before DDL " "statements. This is no longer the case." msgstr "" -#: library/sqlite3.rst:2698 +#: library/sqlite3.rst:2699 msgid "" "The recommended way of controlling transactions is now via the :attr:" "`~Connection.autocommit` attribute." diff --git a/library/ssl.po b/library/ssl.po index fa1a99248..653d4599f 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2862,10 +2862,11 @@ msgstr "" #: library/ssl.rst:2371 msgid "" "The :mod:`asyncio` module supports :ref:`non-blocking SSL sockets ` and provides a higher level API. It polls for events using " -"the :mod:`selectors` module and handles :exc:`SSLWantWriteError`, :exc:" -"`SSLWantReadError` and :exc:`BlockingIOError` exceptions. It runs the SSL " -"handshake asynchronously as well." +"nonblocking>` and provides a higher level :ref:`Streams API `. It polls for events using the :mod:`selectors` module and " +"handles :exc:`SSLWantWriteError`, :exc:`SSLWantReadError` and :exc:" +"`BlockingIOError` exceptions. It runs the SSL handshake asynchronously as " +"well." msgstr "" #: library/ssl.rst:2380 diff --git a/library/string.po b/library/string.po index e4cfb62af..945c4a9e5 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -413,11 +413,11 @@ msgstr "" msgid "The meaning of the various alignment options is as follows:" msgstr "" -#: library/string.rst:373 +#: library/string.rst:374 msgid "Option" msgstr "" -#: library/string.rst:373 library/string.rst:467 library/string.rst:502 +#: library/string.rst:374 library/string.rst:470 library/string.rst:505 msgid "Meaning" msgstr "" @@ -449,73 +449,74 @@ msgstr "" msgid "" "Forces the padding to be placed after the sign (if any) but before the " "digits. This is used for printing fields in the form '+000000120'. This " -"alignment option is only valid for numeric types. It becomes the default " -"for numbers when '0' immediately precedes the field width." +"alignment option is only valid for numeric types, excluding :class:" +"`complex`. It becomes the default for numbers when '0' immediately precedes " +"the field width." msgstr "" -#: library/string.rst:356 +#: library/string.rst:357 msgid "``'^'``" msgstr "" -#: library/string.rst:356 +#: library/string.rst:357 msgid "Forces the field to be centered within the available space." msgstr "" -#: library/string.rst:360 +#: library/string.rst:361 msgid "" "Note that unless a minimum field width is defined, the field width will " "always be the same size as the data to fill it, so that the alignment option " "has no meaning in this case." msgstr "" -#: library/string.rst:364 +#: library/string.rst:365 msgid "" "The *sign* option is only valid for number types, and can be one of the " "following:" msgstr "" -#: library/string.rst:375 +#: library/string.rst:376 msgid "``'+'``" msgstr "" -#: library/string.rst:375 +#: library/string.rst:376 msgid "" "indicates that a sign should be used for both positive as well as negative " "numbers." msgstr "" -#: library/string.rst:378 +#: library/string.rst:379 msgid "``'-'``" msgstr "" -#: library/string.rst:378 +#: library/string.rst:379 msgid "" "indicates that a sign should be used only for negative numbers (this is the " "default behavior)." msgstr "" -#: library/string.rst:381 +#: library/string.rst:382 msgid "space" msgstr "" -#: library/string.rst:381 +#: library/string.rst:382 msgid "" "indicates that a leading space should be used on positive numbers, and a " "minus sign on negative numbers." msgstr "" -#: library/string.rst:388 +#: library/string.rst:389 msgid "" "The ``'z'`` option coerces negative zero floating-point values to positive " "zero after rounding to the format precision. This option is only valid for " "floating-point presentation types." msgstr "" -#: library/string.rst:392 +#: library/string.rst:393 msgid "Added the ``'z'`` option (see also :pep:`682`)." msgstr "" -#: library/string.rst:397 +#: library/string.rst:398 msgid "" "The ``'#'`` option causes the \"alternate form\" to be used for the " "conversion. The alternate form is defined differently for different types. " @@ -529,17 +530,19 @@ msgid "" "and ``'G'`` conversions, trailing zeros are not removed from the result." msgstr "" -#: library/string.rst:411 +#: library/string.rst:412 msgid "" -"The ``','`` option signals the use of a comma for a thousands separator. For " -"a locale aware separator, use the ``'n'`` integer presentation type instead." +"The ``','`` option signals the use of a comma for a thousands separator for " +"floating-point presentation types and for integer presentation type ``'d'``. " +"For other presentation types, this option is an error. For a locale aware " +"separator, use the ``'n'`` integer presentation type instead." msgstr "" -#: library/string.rst:415 +#: library/string.rst:418 msgid "Added the ``','`` option (see also :pep:`378`)." msgstr "" -#: library/string.rst:420 +#: library/string.rst:423 msgid "" "The ``'_'`` option signals the use of an underscore for a thousands " "separator for floating-point presentation types and for integer presentation " @@ -548,32 +551,32 @@ msgid "" "presentation types, specifying this option is an error." msgstr "" -#: library/string.rst:427 +#: library/string.rst:430 msgid "Added the ``'_'`` option (see also :pep:`515`)." msgstr "" -#: library/string.rst:430 +#: library/string.rst:433 msgid "" "*width* is a decimal integer defining the minimum total field width, " "including any prefixes, separators, and other formatting characters. If not " "specified, then the field width will be determined by the content." msgstr "" -#: library/string.rst:434 +#: library/string.rst:437 msgid "" "When no explicit alignment is given, preceding the *width* field by a zero " -"(``'0'``) character enables sign-aware zero-padding for numeric types. This " -"is equivalent to a *fill* character of ``'0'`` with an *alignment* type of " -"``'='``." +"(``'0'``) character enables sign-aware zero-padding for numeric types, " +"excluding :class:`complex`. This is equivalent to a *fill* character of " +"``'0'`` with an *alignment* type of ``'='``." msgstr "" -#: library/string.rst:439 +#: library/string.rst:442 msgid "" "Preceding the *width* field by ``'0'`` no longer affects the default " "alignment for strings." msgstr "" -#: library/string.rst:443 +#: library/string.rst:446 msgid "" "The *precision* is a decimal integer indicating how many digits should be " "displayed after the decimal point for presentation types ``'f'`` and " @@ -584,108 +587,108 @@ msgid "" "types." msgstr "" -#: library/string.rst:451 +#: library/string.rst:454 msgid "Finally, the *type* determines how the data should be presented." msgstr "" -#: library/string.rst:453 +#: library/string.rst:456 msgid "The available string presentation types are:" msgstr "" -#: library/string.rst:467 library/string.rst:502 +#: library/string.rst:470 library/string.rst:505 msgid "Type" msgstr "" -#: library/string.rst:458 +#: library/string.rst:461 msgid "``'s'``" msgstr "" -#: library/string.rst:458 +#: library/string.rst:461 msgid "String format. This is the default type for strings and may be omitted." msgstr "" -#: library/string.rst:490 library/string.rst:575 +#: library/string.rst:493 library/string.rst:578 msgid "None" msgstr "" -#: library/string.rst:461 +#: library/string.rst:464 msgid "The same as ``'s'``." msgstr "" -#: library/string.rst:464 +#: library/string.rst:467 msgid "The available integer presentation types are:" msgstr "" -#: library/string.rst:469 +#: library/string.rst:472 msgid "``'b'``" msgstr "" -#: library/string.rst:469 +#: library/string.rst:472 msgid "Binary format. Outputs the number in base 2." msgstr "" -#: library/string.rst:471 +#: library/string.rst:474 msgid "``'c'``" msgstr "" -#: library/string.rst:471 +#: library/string.rst:474 msgid "" "Character. Converts the integer to the corresponding unicode character " "before printing." msgstr "" -#: library/string.rst:474 +#: library/string.rst:477 msgid "``'d'``" msgstr "" -#: library/string.rst:474 +#: library/string.rst:477 msgid "Decimal Integer. Outputs the number in base 10." msgstr "" -#: library/string.rst:476 +#: library/string.rst:479 msgid "``'o'``" msgstr "" -#: library/string.rst:476 +#: library/string.rst:479 msgid "Octal format. Outputs the number in base 8." msgstr "" -#: library/string.rst:478 +#: library/string.rst:481 msgid "``'x'``" msgstr "" -#: library/string.rst:478 +#: library/string.rst:481 msgid "" "Hex format. Outputs the number in base 16, using lower-case letters for the " "digits above 9." msgstr "" -#: library/string.rst:481 +#: library/string.rst:484 msgid "``'X'``" msgstr "" -#: library/string.rst:481 +#: library/string.rst:484 msgid "" "Hex format. Outputs the number in base 16, using upper-case letters for the " "digits above 9. In case ``'#'`` is specified, the prefix ``'0x'`` will be " "upper-cased to ``'0X'`` as well." msgstr "" -#: library/string.rst:568 +#: library/string.rst:571 msgid "``'n'``" msgstr "" -#: library/string.rst:486 +#: library/string.rst:489 msgid "" "Number. This is the same as ``'d'``, except that it uses the current locale " "setting to insert the appropriate number separator characters." msgstr "" -#: library/string.rst:490 +#: library/string.rst:493 msgid "The same as ``'d'``." msgstr "" -#: library/string.rst:493 +#: library/string.rst:496 msgid "" "In addition to the above presentation types, integers can be formatted with " "the floating-point presentation types listed below (except ``'n'`` and " @@ -693,17 +696,17 @@ msgid "" "floating-point number before formatting." msgstr "" -#: library/string.rst:498 +#: library/string.rst:501 msgid "" "The available presentation types for :class:`float` and :class:`~decimal." "Decimal` values are:" msgstr "" -#: library/string.rst:504 +#: library/string.rst:507 msgid "``'e'``" msgstr "" -#: library/string.rst:504 +#: library/string.rst:507 msgid "" "Scientific notation. For a given precision ``p``, formats the number in " "scientific notation with the letter 'e' separating the coefficient from the " @@ -715,21 +718,21 @@ msgid "" "is used." msgstr "" -#: library/string.rst:515 +#: library/string.rst:518 msgid "``'E'``" msgstr "" -#: library/string.rst:515 +#: library/string.rst:518 msgid "" "Scientific notation. Same as ``'e'`` except it uses an upper case 'E' as the " "separator character." msgstr "" -#: library/string.rst:518 +#: library/string.rst:521 msgid "``'f'``" msgstr "" -#: library/string.rst:518 +#: library/string.rst:521 msgid "" "Fixed-point notation. For a given precision ``p``, formats the number as a " "decimal number with exactly ``p`` digits following the decimal point. With " @@ -739,21 +742,21 @@ msgid "" "point is omitted unless the ``#`` option is used." msgstr "" -#: library/string.rst:527 +#: library/string.rst:530 msgid "``'F'``" msgstr "" -#: library/string.rst:527 +#: library/string.rst:530 msgid "" "Fixed-point notation. Same as ``'f'``, but converts ``nan`` to ``NAN`` and " "``inf`` to ``INF``." msgstr "" -#: library/string.rst:530 +#: library/string.rst:533 msgid "``'g'``" msgstr "" -#: library/string.rst:530 +#: library/string.rst:533 msgid "" "General format. For a given precision ``p >= 1``, this rounds the number to " "``p`` significant digits and then formats the result in either fixed-point " @@ -761,7 +764,7 @@ msgid "" "``0`` is treated as equivalent to a precision of ``1``." msgstr "" -#: library/string.rst:537 +#: library/string.rst:540 msgid "" "The precise rules are as follows: suppose that the result formatted with " "presentation type ``'e'`` and precision ``p-1`` would have exponent " @@ -774,7 +777,7 @@ msgid "" "unless the ``'#'`` option is used." msgstr "" -#: library/string.rst:550 +#: library/string.rst:553 msgid "" "With no precision given, uses a precision of ``6`` significant digits for :" "class:`float`. For :class:`~decimal.Decimal`, the coefficient of the result " @@ -784,40 +787,40 @@ msgid "" "notation is used otherwise." msgstr "" -#: library/string.rst:559 +#: library/string.rst:562 msgid "" "Positive and negative infinity, positive and negative zero, and nans, are " "formatted as ``inf``, ``-inf``, ``0``, ``-0`` and ``nan`` respectively, " "regardless of the precision." msgstr "" -#: library/string.rst:564 +#: library/string.rst:567 msgid "``'G'``" msgstr "" -#: library/string.rst:564 +#: library/string.rst:567 msgid "" "General format. Same as ``'g'`` except switches to ``'E'`` if the number " "gets too large. The representations of infinity and NaN are uppercased, too." msgstr "" -#: library/string.rst:568 +#: library/string.rst:571 msgid "" "Number. This is the same as ``'g'``, except that it uses the current locale " "setting to insert the appropriate number separator characters." msgstr "" -#: library/string.rst:572 +#: library/string.rst:575 msgid "``'%'``" msgstr "" -#: library/string.rst:572 +#: library/string.rst:575 msgid "" "Percentage. Multiplies the number by 100 and displays in fixed (``'f'``) " "format, followed by a percent sign." msgstr "" -#: library/string.rst:575 +#: library/string.rst:578 msgid "" "For :class:`float` this is like the ``'g'`` type, except that when fixed-" "point notation is used to format the result, it always includes at least one " @@ -826,47 +829,67 @@ msgid "" "as large as needed to represent the given value faithfully." msgstr "" -#: library/string.rst:583 +#: library/string.rst:586 msgid "" "For :class:`~decimal.Decimal`, this is the same as either ``'g'`` or ``'G'`` " "depending on the value of ``context.capitals`` for the current decimal " "context." msgstr "" -#: library/string.rst:587 +#: library/string.rst:590 msgid "" "The overall effect is to match the output of :func:`str` as altered by the " "other format modifiers." msgstr "" -#: library/string.rst:595 +#: library/string.rst:594 +msgid "" +"The result should be correctly rounded to a given precision ``p`` of digits " +"after the decimal point. The rounding mode for :class:`float` matches that " +"of the :func:`round` builtin. For :class:`~decimal.Decimal`, the rounding " +"mode of the current :ref:`context ` will be used." +msgstr "" + +#: library/string.rst:599 +msgid "" +"The available presentation types for :class:`complex` are the same as those " +"for :class:`float` (``'%'`` is not allowed). Both the real and imaginary " +"components of a complex number are formatted as floating-point numbers, " +"according to the specified presentation type. They are separated by the " +"mandatory sign of the imaginary part, the latter being terminated by a ``j`` " +"suffix. If the presentation type is missing, the result will match the " +"output of :func:`str` (complex numbers with a non-zero real part are also " +"surrounded by parentheses), possibly altered by other format modifiers." +msgstr "" + +#: library/string.rst:612 msgid "Format examples" msgstr "" -#: library/string.rst:597 +#: library/string.rst:614 msgid "" "This section contains examples of the :meth:`str.format` syntax and " "comparison with the old ``%``-formatting." msgstr "" -#: library/string.rst:600 +#: library/string.rst:617 msgid "" "In most of the cases the syntax is similar to the old ``%``-formatting, with " "the addition of the ``{}`` and with ``:`` used instead of ``%``. For " "example, ``'%03.2f'`` can be translated to ``'{:03.2f}'``." msgstr "" -#: library/string.rst:604 +#: library/string.rst:621 msgid "" "The new format syntax also supports new and different options, shown in the " "following examples." msgstr "" -#: library/string.rst:607 +#: library/string.rst:624 msgid "Accessing arguments by position::" msgstr "" -#: library/string.rst:609 +#: library/string.rst:626 msgid "" ">>> '{0}, {1}, {2}'.format('a', 'b', 'c')\n" "'a, b, c'\n" @@ -881,11 +904,11 @@ msgid "" "'abracadabra'" msgstr "" -#: library/string.rst:620 +#: library/string.rst:637 msgid "Accessing arguments by name::" msgstr "" -#: library/string.rst:622 +#: library/string.rst:639 msgid "" ">>> 'Coordinates: {latitude}, {longitude}'.format(latitude='37.24N', " "longitude='-115.81W')\n" @@ -895,11 +918,11 @@ msgid "" "'Coordinates: 37.24N, -115.81W'" msgstr "" -#: library/string.rst:628 +#: library/string.rst:645 msgid "Accessing arguments' attributes::" msgstr "" -#: library/string.rst:630 +#: library/string.rst:647 msgid "" ">>> c = 3-5j\n" ">>> ('The complex number {0} is formed from the real part {0.real} '\n" @@ -916,33 +939,33 @@ msgid "" "'Point(4, 2)'" msgstr "" -#: library/string.rst:643 +#: library/string.rst:660 msgid "Accessing arguments' items::" msgstr "" -#: library/string.rst:645 +#: library/string.rst:662 msgid "" ">>> coord = (3, 5)\n" ">>> 'X: {0[0]}; Y: {0[1]}'.format(coord)\n" "'X: 3; Y: 5'" msgstr "" -#: library/string.rst:649 +#: library/string.rst:666 msgid "Replacing ``%s`` and ``%r``::" msgstr "" -#: library/string.rst:651 +#: library/string.rst:668 msgid "" ">>> \"repr() shows quotes: {!r}; str() doesn't: {!s}\".format('test1', " "'test2')\n" "\"repr() shows quotes: 'test1'; str() doesn't: test2\"" msgstr "" -#: library/string.rst:654 +#: library/string.rst:671 msgid "Aligning the text and specifying a width::" msgstr "" -#: library/string.rst:656 +#: library/string.rst:673 msgid "" ">>> '{:<30}'.format('left aligned')\n" "'left aligned '\n" @@ -954,11 +977,11 @@ msgid "" "'***********centered***********'" msgstr "" -#: library/string.rst:665 +#: library/string.rst:682 msgid "Replacing ``%+f``, ``%-f``, and ``% f`` and specifying a sign::" msgstr "" -#: library/string.rst:667 +#: library/string.rst:684 msgid "" ">>> '{:+f}; {:+f}'.format(3.14, -3.14) # show it always\n" "'+3.140000; -3.140000'\n" @@ -969,12 +992,12 @@ msgid "" "'3.140000; -3.140000'" msgstr "" -#: library/string.rst:674 +#: library/string.rst:691 msgid "" "Replacing ``%x`` and ``%o`` and converting the value to different bases::" msgstr "" -#: library/string.rst:676 +#: library/string.rst:693 msgid "" ">>> # format also supports binary numbers\n" ">>> \"int: {0:d}; hex: {0:x}; oct: {0:o}; bin: {0:b}\".format(42)\n" @@ -984,21 +1007,21 @@ msgid "" "'int: 42; hex: 0x2a; oct: 0o52; bin: 0b101010'" msgstr "" -#: library/string.rst:683 +#: library/string.rst:700 msgid "Using the comma as a thousands separator::" msgstr "" -#: library/string.rst:685 +#: library/string.rst:702 msgid "" ">>> '{:,}'.format(1234567890)\n" "'1,234,567,890'" msgstr "" -#: library/string.rst:688 +#: library/string.rst:705 msgid "Expressing a percentage::" msgstr "" -#: library/string.rst:690 +#: library/string.rst:707 msgid "" ">>> points = 19\n" ">>> total = 22\n" @@ -1006,11 +1029,11 @@ msgid "" "'Correct answers: 86.36%'" msgstr "" -#: library/string.rst:695 +#: library/string.rst:712 msgid "Using type-specific formatting::" msgstr "" -#: library/string.rst:697 +#: library/string.rst:714 msgid "" ">>> import datetime\n" ">>> d = datetime.datetime(2010, 7, 4, 12, 15, 58)\n" @@ -1018,11 +1041,11 @@ msgid "" "'2010-07-04 12:15:58'" msgstr "" -#: library/string.rst:702 +#: library/string.rst:719 msgid "Nesting arguments and more complex examples::" msgstr "" -#: library/string.rst:704 +#: library/string.rst:721 msgid "" ">>> for align, text in zip('<^>', ['left', 'center', 'right']):\n" "... '{0:{fill}{align}16}'.format(text, fill=align, align=align)\n" @@ -1053,11 +1076,11 @@ msgid "" " 11 B 13 1011" msgstr "" -#: library/string.rst:736 +#: library/string.rst:753 msgid "Template strings" msgstr "" -#: library/string.rst:738 +#: library/string.rst:755 msgid "" "Template strings provide simpler string substitutions as described in :pep:" "`292`. A primary use case for template strings is for internationalization " @@ -1067,17 +1090,17 @@ msgid "" "the `flufl.i18n `_ package." msgstr "" -#: library/string.rst:748 +#: library/string.rst:765 msgid "" "Template strings support ``$``-based substitutions, using the following " "rules:" msgstr "" -#: library/string.rst:750 +#: library/string.rst:767 msgid "``$$`` is an escape; it is replaced with a single ``$``." msgstr "" -#: library/string.rst:752 +#: library/string.rst:769 msgid "" "``$identifier`` names a substitution placeholder matching a mapping key of " "``\"identifier\"``. By default, ``\"identifier\"`` is restricted to any " @@ -1087,30 +1110,30 @@ msgid "" "specification." msgstr "" -#: library/string.rst:759 +#: library/string.rst:776 msgid "" "``${identifier}`` is equivalent to ``$identifier``. It is required when " "valid identifier characters follow the placeholder but are not part of the " "placeholder, such as ``\"${noun}ification\"``." msgstr "" -#: library/string.rst:763 +#: library/string.rst:780 msgid "" "Any other appearance of ``$`` in the string will result in a :exc:" "`ValueError` being raised." msgstr "" -#: library/string.rst:766 +#: library/string.rst:783 msgid "" "The :mod:`string` module provides a :class:`Template` class that implements " "these rules. The methods of :class:`Template` are:" msgstr "" -#: library/string.rst:772 +#: library/string.rst:789 msgid "The constructor takes a single argument which is the template string." msgstr "" -#: library/string.rst:777 +#: library/string.rst:794 msgid "" "Performs the template substitution, returning a new string. *mapping* is " "any dictionary-like object with keys that match the placeholders in the " @@ -1119,7 +1142,7 @@ msgid "" "there are duplicates, the placeholders from *kwds* take precedence." msgstr "" -#: library/string.rst:786 +#: library/string.rst:803 msgid "" "Like :meth:`substitute`, except that if placeholders are missing from " "*mapping* and *kwds*, instead of raising a :exc:`KeyError` exception, the " @@ -1128,7 +1151,7 @@ msgid "" "simply return ``$`` instead of raising :exc:`ValueError`." msgstr "" -#: library/string.rst:792 +#: library/string.rst:809 msgid "" "While other exceptions may still occur, this method is called \"safe\" " "because it always tries to return a usable string instead of raising an " @@ -1138,33 +1161,33 @@ msgid "" "Python identifiers." msgstr "" -#: library/string.rst:802 +#: library/string.rst:819 msgid "" "Returns false if the template has invalid placeholders that will cause :meth:" "`substitute` to raise :exc:`ValueError`." msgstr "" -#: library/string.rst:810 +#: library/string.rst:827 msgid "" "Returns a list of the valid identifiers in the template, in the order they " "first appear, ignoring any invalid identifiers." msgstr "" -#: library/string.rst:815 +#: library/string.rst:832 msgid ":class:`Template` instances also provide one public data attribute:" msgstr "" -#: library/string.rst:819 +#: library/string.rst:836 msgid "" "This is the object passed to the constructor's *template* argument. In " "general, you shouldn't change it, but read-only access is not enforced." msgstr "" -#: library/string.rst:822 +#: library/string.rst:839 msgid "Here is an example of how to use a Template::" msgstr "" -#: library/string.rst:824 +#: library/string.rst:841 msgid "" ">>> from string import Template\n" ">>> s = Template('$who likes $what')\n" @@ -1183,7 +1206,7 @@ msgid "" "'tim likes $what'" msgstr "" -#: library/string.rst:840 +#: library/string.rst:857 msgid "" "Advanced usage: you can derive subclasses of :class:`Template` to customize " "the placeholder syntax, delimiter character, or the entire regular " @@ -1191,7 +1214,7 @@ msgid "" "these class attributes:" msgstr "" -#: library/string.rst:845 +#: library/string.rst:862 msgid "" "*delimiter* -- This is the literal string describing a placeholder " "introducing delimiter. The default value is ``$``. Note that this should " @@ -1201,7 +1224,7 @@ msgid "" "the subclass's class namespace)." msgstr "" -#: library/string.rst:852 +#: library/string.rst:869 msgid "" "*idpattern* -- This is the regular expression describing the pattern for non-" "braced placeholders. The default value is the regular expression ``(?a:[_a-" @@ -1209,19 +1232,19 @@ msgid "" "pattern will also apply to braced placeholders." msgstr "" -#: library/string.rst:859 +#: library/string.rst:876 msgid "" "Since default *flags* is ``re.IGNORECASE``, pattern ``[a-z]`` can match with " "some non-ASCII characters. That's why we use the local ``a`` flag here." msgstr "" -#: library/string.rst:863 +#: library/string.rst:880 msgid "" "*braceidpattern* can be used to define separate patterns used inside and " "outside the braces." msgstr "" -#: library/string.rst:867 +#: library/string.rst:884 msgid "" "*braceidpattern* -- This is like *idpattern* but describes the pattern for " "braced placeholders. Defaults to ``None`` which means to fall back to " @@ -1230,7 +1253,7 @@ msgid "" "unbraced placeholders." msgstr "" -#: library/string.rst:875 +#: library/string.rst:892 msgid "" "*flags* -- The regular expression flags that will be applied when compiling " "the regular expression used for recognizing substitutions. The default " @@ -1239,7 +1262,7 @@ msgid "" "regular expressions." msgstr "" -#: library/string.rst:883 +#: library/string.rst:900 msgid "" "Alternatively, you can provide the entire regular expression pattern by " "overriding the class attribute *pattern*. If you do this, the value must be " @@ -1248,41 +1271,41 @@ msgid "" "placeholder rule:" msgstr "" -#: library/string.rst:889 +#: library/string.rst:906 msgid "" "*escaped* -- This group matches the escape sequence, e.g. ``$$``, in the " "default pattern." msgstr "" -#: library/string.rst:892 +#: library/string.rst:909 msgid "" "*named* -- This group matches the unbraced placeholder name; it should not " "include the delimiter in capturing group." msgstr "" -#: library/string.rst:895 +#: library/string.rst:912 msgid "" "*braced* -- This group matches the brace enclosed placeholder name; it " "should not include either the delimiter or braces in the capturing group." msgstr "" -#: library/string.rst:898 +#: library/string.rst:915 msgid "" "*invalid* -- This group matches any other delimiter pattern (usually a " "single delimiter), and it should appear last in the regular expression." msgstr "" -#: library/string.rst:901 +#: library/string.rst:918 msgid "" "The methods on this class will raise :exc:`ValueError` if the pattern " "matches the template without one of these named groups matching." msgstr "" -#: library/string.rst:906 +#: library/string.rst:923 msgid "Helper functions" msgstr "" -#: library/string.rst:910 +#: library/string.rst:927 msgid "" "Split the argument into words using :meth:`str.split`, capitalize each word " "using :meth:`str.capitalize`, and join the capitalized words using :meth:" @@ -1296,8 +1319,8 @@ msgstr "" msgid "{} (curly brackets)" msgstr "" -#: library/string.rst:335 library/string.rst:386 library/string.rst:409 -#: library/string.rst:418 +#: library/string.rst:335 library/string.rst:387 library/string.rst:410 +#: library/string.rst:421 msgid "in string formatting" msgstr "" @@ -1333,34 +1356,34 @@ msgstr "" msgid "^ (caret)" msgstr "" -#: library/string.rst:367 +#: library/string.rst:368 msgid "+ (plus)" msgstr "" -#: library/string.rst:367 +#: library/string.rst:368 msgid "- (minus)" msgstr "" -#: library/string.rst:386 +#: library/string.rst:387 msgid "z" msgstr "" -#: library/string.rst:395 +#: library/string.rst:396 msgid "# (hash)" msgstr "" -#: library/string.rst:409 +#: library/string.rst:410 msgid ", (comma)" msgstr "" -#: library/string.rst:418 +#: library/string.rst:421 msgid "_ (underscore)" msgstr "" -#: library/string.rst:746 +#: library/string.rst:763 msgid "$ (dollar)" msgstr "" -#: library/string.rst:746 +#: library/string.rst:763 msgid "in template strings" msgstr "" diff --git a/library/sys.po b/library/sys.po index 41153f80d..41dfba619 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -39,8 +39,8 @@ msgid "" "removed)." msgstr "" -#: library/sys.rst:288 library/sys.rst:747 library/sys.rst:978 -#: library/sys.rst:1707 library/sys.rst:1730 library/sys.rst:1982 +#: library/sys.rst:288 library/sys.rst:747 library/sys.rst:1007 +#: library/sys.rst:1736 library/sys.rst:1759 library/sys.rst:2011 msgid "Availability" msgstr "" @@ -1135,15 +1135,48 @@ msgid "" "argument ``depth``." msgstr "" +#: library/sys.rst:912 +msgid "" +"This function only exists if CPython was built using the specialized " +"configure option :option:`--with-trace-refs`. It is intended only for " +"debugging garbage-collection issues." +msgstr "" + #: library/sys.rst:916 +msgid "" +"Return a list of up to *limit* dynamically allocated Python objects. If " +"*type* is given, only objects of that exact type (not subtypes) are included." +msgstr "" + +#: library/sys.rst:920 +msgid "" +"Objects from the list are not safe to use. Specifically, the result will " +"include objects from all interpreters that share their object allocator " +"state (that is, ones created with :c:member:`PyInterpreterConfig." +"use_main_obmalloc` set to 1 or using :c:func:`Py_NewInterpreter`, and the :" +"ref:`main interpreter `). Mixing objects from " +"different interpreters may lead to crashes or other unexpected behavior." +msgstr "" + +#: library/sys.rst:931 +msgid "" +"This function should be used for specialized purposes only. It is not " +"guaranteed to exist in all implementations of Python." +msgstr "" + +#: library/sys.rst:936 +msgid "The result may include objects from other interpreters." +msgstr "" + +#: library/sys.rst:945 msgid "Get the profiler function as set by :func:`setprofile`." msgstr "" -#: library/sys.rst:925 +#: library/sys.rst:954 msgid "Get the trace function as set by :func:`settrace`." msgstr "" -#: library/sys.rst:929 +#: library/sys.rst:958 msgid "" "The :func:`gettrace` function is intended only for implementing debuggers, " "profilers, coverage tools and the like. Its behavior is part of the " @@ -1151,7 +1184,7 @@ msgid "" "thus may not be available in all Python implementations." msgstr "" -#: library/sys.rst:937 +#: library/sys.rst:966 msgid "" "Return a named tuple describing the Windows version currently running. The " "named elements are *major*, *minor*, *build*, *platform*, *service_pack*, " @@ -1163,54 +1196,54 @@ msgid "" "first 5 elements are retrievable by indexing." msgstr "" -#: library/sys.rst:948 +#: library/sys.rst:977 msgid "*platform* will be ``2`` (VER_PLATFORM_WIN32_NT)." msgstr "" -#: library/sys.rst:950 +#: library/sys.rst:979 msgid "*product_type* may be one of the following values:" msgstr "" -#: library/sys.rst:953 +#: library/sys.rst:982 msgid "Constant" msgstr "" -#: library/sys.rst:953 +#: library/sys.rst:982 msgid "Meaning" msgstr "" -#: library/sys.rst:955 +#: library/sys.rst:984 msgid "``1`` (VER_NT_WORKSTATION)" msgstr "" -#: library/sys.rst:955 +#: library/sys.rst:984 msgid "The system is a workstation." msgstr "" -#: library/sys.rst:957 +#: library/sys.rst:986 msgid "``2`` (VER_NT_DOMAIN_CONTROLLER)" msgstr "" -#: library/sys.rst:957 +#: library/sys.rst:986 msgid "The system is a domain controller." msgstr "" -#: library/sys.rst:960 +#: library/sys.rst:989 msgid "``3`` (VER_NT_SERVER)" msgstr "" -#: library/sys.rst:960 +#: library/sys.rst:989 msgid "The system is a server, but not a domain controller." msgstr "" -#: library/sys.rst:964 +#: library/sys.rst:993 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:968 +#: library/sys.rst:997 msgid "" "*platform_version* returns the major version, minor version and build number " "of the current operating system, rather than the version that is being " @@ -1218,24 +1251,24 @@ msgid "" "feature detection." msgstr "" -#: library/sys.rst:974 +#: library/sys.rst:1003 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:980 +#: library/sys.rst:1009 msgid "" "Changed to a named tuple and added *service_pack_minor*, " "*service_pack_major*, *suite_mask*, and *product_type*." msgstr "" -#: library/sys.rst:984 +#: library/sys.rst:1013 msgid "Added *platform_version*" msgstr "" -#: library/sys.rst:990 +#: library/sys.rst:1019 msgid "" "Returns an *asyncgen_hooks* object, which is similar to a :class:" "`~collections.namedtuple` of the form ``(firstiter, finalizer)``, where " @@ -1245,71 +1278,71 @@ msgid "" "loop." msgstr "" -#: library/sys.rst:997 +#: library/sys.rst:1026 msgid "See :pep:`525` for more details." msgstr "" -#: library/sys.rst:1678 +#: library/sys.rst:1707 msgid "" "This function has been added on a provisional basis (see :pep:`411` for " "details.)" msgstr "" -#: library/sys.rst:1007 +#: library/sys.rst:1036 msgid "" "Get the current coroutine origin tracking depth, as set by :func:" "`set_coroutine_origin_tracking_depth`." msgstr "" -#: library/sys.rst:1699 +#: library/sys.rst:1728 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:1019 +#: library/sys.rst:1048 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:1025 +#: library/sys.rst:1054 msgid "The width in bits used for hash values" msgstr "" -#: library/sys.rst:1029 +#: library/sys.rst:1058 msgid "The prime modulus P used for numeric hash scheme" msgstr "" -#: library/sys.rst:1033 +#: library/sys.rst:1062 msgid "The hash value returned for a positive infinity" msgstr "" -#: library/sys.rst:1037 +#: library/sys.rst:1066 msgid "(This attribute is no longer used)" msgstr "" -#: library/sys.rst:1041 +#: library/sys.rst:1070 msgid "The multiplier used for the imaginary part of a complex number" msgstr "" -#: library/sys.rst:1045 +#: library/sys.rst:1074 msgid "The name of the algorithm for hashing of str, bytes, and memoryview" msgstr "" -#: library/sys.rst:1049 +#: library/sys.rst:1078 msgid "The internal output size of the hash algorithm" msgstr "" -#: library/sys.rst:1053 +#: library/sys.rst:1082 msgid "The size of the seed key of the hash algorithm" msgstr "" -#: library/sys.rst:1057 +#: library/sys.rst:1086 msgid "Added *algorithm*, *hash_bits* and *seed_bits*" msgstr "" -#: library/sys.rst:1063 +#: library/sys.rst:1092 msgid "" "The version number encoded as a single integer. This is guaranteed to " "increase with each version, including proper support for non-production " @@ -1317,7 +1350,7 @@ msgid "" "version 1.5.2, use::" msgstr "" -#: library/sys.rst:1067 +#: library/sys.rst:1096 msgid "" "if sys.hexversion >= 0x010502F0:\n" " # use some advanced feature\n" @@ -1327,7 +1360,7 @@ msgid "" " ..." msgstr "" -#: library/sys.rst:1074 +#: library/sys.rst:1103 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. " @@ -1335,25 +1368,25 @@ msgid "" "human-friendly encoding of the same information." msgstr "" -#: library/sys.rst:1079 +#: library/sys.rst:1108 msgid "More details of ``hexversion`` can be found at :ref:`apiabiversion`." msgstr "" -#: library/sys.rst:1084 +#: library/sys.rst:1113 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:1088 +#: library/sys.rst:1117 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:1092 +#: library/sys.rst:1121 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 " @@ -1365,13 +1398,13 @@ msgid "" "the same value, since it is the reference implementation." msgstr "" -#: library/sys.rst:1102 +#: library/sys.rst:1131 msgid "" "*hexversion* is the implementation version in hexadecimal format, like :data:" "`sys.hexversion`." msgstr "" -#: library/sys.rst:1105 +#: library/sys.rst:1134 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 " @@ -1380,7 +1413,7 @@ msgid "" "set to ``None``, it indicates that module caching should be disabled." msgstr "" -#: library/sys.rst:1112 +#: library/sys.rst:1141 msgid "" ":data:`sys.implementation` may contain additional attributes specific to the " "Python implementation. These non-standard attributes must start with an " @@ -1390,47 +1423,47 @@ msgid "" "versions, however.) See :pep:`421` for more information." msgstr "" -#: library/sys.rst:1123 +#: library/sys.rst:1152 msgid "" "The addition of new required attributes must go through the normal PEP " "process. See :pep:`421` for more information." msgstr "" -#: library/sys.rst:1128 +#: library/sys.rst:1157 msgid "" "A :term:`named tuple` that holds information about Python's internal " "representation of integers. The attributes are read only." msgstr "" -#: library/sys.rst:1133 +#: library/sys.rst:1162 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:1138 +#: library/sys.rst:1167 msgid "The size in bytes of the C type used to represent a digit." msgstr "" -#: library/sys.rst:1142 +#: library/sys.rst:1171 msgid "" "The default value for :func:`sys.get_int_max_str_digits` when it is not " "otherwise explicitly configured." msgstr "" -#: library/sys.rst:1147 +#: library/sys.rst:1176 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:1154 +#: library/sys.rst:1183 msgid "" "Added :attr:`~int_info.default_max_str_digits` and :attr:`~int_info." "str_digits_check_threshold`." msgstr "" -#: library/sys.rst:1160 +#: library/sys.rst:1189 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:1168 +#: library/sys.rst:1197 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:1177 +#: library/sys.rst:1206 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 " @@ -1457,19 +1490,19 @@ msgid "" "attributes have interned keys." msgstr "" -#: library/sys.rst:1185 +#: library/sys.rst:1214 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:1191 +#: library/sys.rst:1220 msgid "" "Return :const:`True` if the Python interpreter is :term:`shutting down " "`, :const:`False` otherwise." msgstr "" -#: library/sys.rst:1198 +#: library/sys.rst:1227 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 " @@ -1480,34 +1513,34 @@ msgid "" "more information.)" msgstr "" -#: library/sys.rst:1212 +#: library/sys.rst:1241 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:1218 +#: library/sys.rst:1247 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:1225 +#: library/sys.rst:1254 msgid "" "An integer giving the value of the largest Unicode code point, i.e. " "``1114111`` (``0x10FFFF`` in hexadecimal)." msgstr "" -#: library/sys.rst:1228 +#: library/sys.rst:1257 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:1236 +#: library/sys.rst:1265 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 " @@ -1520,40 +1553,40 @@ msgid "" "``None`` if the module cannot be found." msgstr "" -#: library/sys.rst:1249 +#: library/sys.rst:1278 msgid ":class:`importlib.abc.MetaPathFinder`" msgstr "" -#: library/sys.rst:1250 +#: library/sys.rst:1279 msgid "" "The abstract base class defining the interface of finder objects on :data:" "`meta_path`." msgstr "" -#: library/sys.rst:1252 +#: library/sys.rst:1281 msgid ":class:`importlib.machinery.ModuleSpec`" msgstr "" -#: library/sys.rst:1253 +#: library/sys.rst:1282 msgid "" "The concrete class which :meth:`~importlib.abc.MetaPathFinder.find_spec` " "should return instances of." msgstr "" -#: library/sys.rst:1259 +#: library/sys.rst:1288 msgid "" ":term:`Module specs ` were introduced in Python 3.4, by :pep:" "`451`." msgstr "" -#: library/sys.rst:1264 +#: library/sys.rst:1293 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:1270 +#: library/sys.rst:1299 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 " @@ -1565,13 +1598,13 @@ msgid "" "other threads." msgstr "" -#: library/sys.rst:1282 +#: library/sys.rst:1311 msgid "" "The list of the original command line arguments passed to the Python " "executable." msgstr "" -#: library/sys.rst:1285 +#: library/sys.rst:1314 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 " @@ -1579,68 +1612,68 @@ msgid "" "in :data:`sys.orig_argv` and missing from :data:`sys.argv`." msgstr "" -#: library/sys.rst:1297 +#: library/sys.rst:1326 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:1301 +#: library/sys.rst:1330 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:1305 +#: library/sys.rst:1334 msgid "" "``python -m module`` command line: prepend the current working directory." msgstr "" -#: library/sys.rst:1307 +#: library/sys.rst:1336 msgid "" "``python script.py`` command line: prepend the script's directory. If it's a " "symbolic link, resolve symbolic links." msgstr "" -#: library/sys.rst:1309 +#: library/sys.rst:1338 msgid "" "``python -c code`` and ``python`` (REPL) command lines: prepend an empty " "string, which means the current working directory." msgstr "" -#: library/sys.rst:1312 +#: library/sys.rst:1341 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:1315 +#: library/sys.rst:1344 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:1321 +#: library/sys.rst:1350 msgid "" "Module :mod:`site` This describes how to use .pth files to extend :data:`sys." "path`." msgstr "" -#: library/sys.rst:1326 +#: library/sys.rst:1355 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:1341 +#: library/sys.rst:1370 msgid "Originally specified in :pep:`302`." msgstr "" -#: library/sys.rst:1335 +#: library/sys.rst:1364 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 " @@ -1648,13 +1681,13 @@ msgid "" "is found on :data:`sys.path_hooks` then ``None`` is stored." msgstr "" -#: library/sys.rst:1346 +#: library/sys.rst:1375 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:1349 +#: library/sys.rst:1378 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 " @@ -1663,7 +1696,7 @@ msgid "" "version, it is therefore recommended to use the following idiom::" msgstr "" -#: library/sys.rst:1355 +#: library/sys.rst:1384 msgid "" "if sys.platform.startswith('freebsd'):\n" " # FreeBSD-specific code here...\n" @@ -1673,75 +1706,75 @@ msgid "" " # AIX-specific code here..." msgstr "" -#: library/sys.rst:1362 +#: library/sys.rst:1391 msgid "For other systems, the values are:" msgstr "" -#: library/sys.rst:1365 +#: library/sys.rst:1394 msgid "System" msgstr "" -#: library/sys.rst:1365 +#: library/sys.rst:1394 msgid "``platform`` value" msgstr "" -#: library/sys.rst:1367 +#: library/sys.rst:1396 msgid "AIX" msgstr "" -#: library/sys.rst:1367 +#: library/sys.rst:1396 msgid "``'aix'``" msgstr "" -#: library/sys.rst:1368 +#: library/sys.rst:1397 msgid "Emscripten" msgstr "" -#: library/sys.rst:1368 +#: library/sys.rst:1397 msgid "``'emscripten'``" msgstr "" -#: library/sys.rst:1369 +#: library/sys.rst:1398 msgid "Linux" msgstr "" -#: library/sys.rst:1369 +#: library/sys.rst:1398 msgid "``'linux'``" msgstr "" -#: library/sys.rst:1370 +#: library/sys.rst:1399 msgid "WASI" msgstr "" -#: library/sys.rst:1370 +#: library/sys.rst:1399 msgid "``'wasi'``" msgstr "" -#: library/sys.rst:1371 +#: library/sys.rst:1400 msgid "Windows" msgstr "" -#: library/sys.rst:1371 +#: library/sys.rst:1400 msgid "``'win32'``" msgstr "" -#: library/sys.rst:1372 +#: library/sys.rst:1401 msgid "Windows/Cygwin" msgstr "" -#: library/sys.rst:1372 +#: library/sys.rst:1401 msgid "``'cygwin'``" msgstr "" -#: library/sys.rst:1373 +#: library/sys.rst:1402 msgid "macOS" msgstr "" -#: library/sys.rst:1373 +#: library/sys.rst:1402 msgid "``'darwin'``" msgstr "" -#: library/sys.rst:1376 +#: library/sys.rst:1405 msgid "" "On Linux, :data:`sys.platform` doesn't contain the major version anymore. It " "is always ``'linux'``, instead of ``'linux2'`` or ``'linux3'``. Since older " @@ -1749,7 +1782,7 @@ msgid "" "the ``startswith`` idiom presented above." msgstr "" -#: library/sys.rst:1382 +#: library/sys.rst:1411 msgid "" "On AIX, :data:`sys.platform` doesn't contain the major version anymore. It " "is always ``'aix'``, instead of ``'aix5'`` or ``'aix7'``. Since older " @@ -1757,57 +1790,57 @@ msgid "" "the ``startswith`` idiom presented above." msgstr "" -#: library/sys.rst:1390 +#: library/sys.rst:1419 msgid "" ":data:`os.name` has a coarser granularity. :func:`os.uname` gives system-" "dependent version information." msgstr "" -#: library/sys.rst:1393 +#: library/sys.rst:1422 msgid "" "The :mod:`platform` module provides detailed checks for the system's " "identity." msgstr "" -#: library/sys.rst:1399 +#: library/sys.rst:1428 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:1402 +#: library/sys.rst:1431 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:1406 +#: library/sys.rst:1435 msgid "" "``/usr/lib64/pythonX.Y/``: Standard library (like ``os.py`` of the :mod:`os` " "module)" msgstr "" -#: library/sys.rst:1408 +#: library/sys.rst:1437 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:1411 +#: library/sys.rst:1440 msgid "" "``/usr/lib/pythonX.Y/site-packages/`` (always use ``lib``, not :data:`sys." "platlibdir`): Third-party modules" msgstr "" -#: library/sys.rst:1413 +#: library/sys.rst:1442 msgid "" "``/usr/lib64/pythonX.Y/site-packages/``: C extension modules of third-party " "packages" msgstr "" -#: library/sys.rst:1421 +#: library/sys.rst:1450 msgid "" "A string giving the site-specific directory prefix where the platform " "independent Python files are installed; on Unix, the default is :file:`/usr/" @@ -1816,14 +1849,14 @@ msgid "" "derived paths." msgstr "" -#: library/sys.rst:1427 +#: library/sys.rst:1456 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:1442 +#: library/sys.rst:1471 msgid "" "Strings specifying the primary and secondary prompt of the interpreter. " "These are only defined if the interpreter is in interactive mode. Their " @@ -1833,7 +1866,7 @@ msgid "" "used to implement a dynamic prompt." msgstr "" -#: library/sys.rst:1452 +#: library/sys.rst:1481 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 " @@ -1844,14 +1877,14 @@ msgid "" "g. :const:`os.RTLD_LAZY`)." msgstr "" -#: library/sys.rst:1464 +#: library/sys.rst:1493 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:1476 +#: library/sys.rst:1505 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 " @@ -1866,14 +1899,14 @@ msgid "" "in the profile function will cause itself unset." msgstr "" -#: library/sys.rst:1488 +#: library/sys.rst:1517 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:1492 +#: library/sys.rst:1521 msgid "" "Profile functions should have three arguments: *frame*, *event*, and *arg*. " "*frame* is the current stack frame. *event* is a string: ``'call'``, " @@ -1881,71 +1914,71 @@ msgid "" "depends on the event type." msgstr "" -#: library/sys.rst:1584 +#: library/sys.rst:1613 msgid "The events have the following meaning:" msgstr "" -#: library/sys.rst:1586 +#: library/sys.rst:1615 msgid "``'call'``" msgstr "" -#: library/sys.rst:1500 +#: library/sys.rst:1529 msgid "" "A function is called (or some other code block entered). The profile " "function is called; *arg* is ``None``." msgstr "" -#: library/sys.rst:1601 +#: library/sys.rst:1630 msgid "``'return'``" msgstr "" -#: library/sys.rst:1504 +#: library/sys.rst:1533 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:1508 +#: library/sys.rst:1537 msgid "``'c_call'``" msgstr "" -#: library/sys.rst:1509 +#: library/sys.rst:1538 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:1512 +#: library/sys.rst:1541 msgid "``'c_return'``" msgstr "" -#: library/sys.rst:1513 +#: library/sys.rst:1542 msgid "A C function has returned. *arg* is the C function object." msgstr "" -#: library/sys.rst:1515 +#: library/sys.rst:1544 msgid "``'c_exception'``" msgstr "" -#: library/sys.rst:1516 +#: library/sys.rst:1545 msgid "A C function has raised an exception. *arg* is the C function object." msgstr "" -#: library/sys.rst:1518 +#: library/sys.rst:1547 msgid "" "Raises an :ref:`auditing event ` ``sys.setprofile`` with no " "arguments." msgstr "" -#: library/sys.rst:1523 +#: library/sys.rst:1552 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:1527 +#: library/sys.rst:1556 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 " @@ -1953,19 +1986,19 @@ msgid "" "because a too-high limit can lead to a crash." msgstr "" -#: library/sys.rst:1532 +#: library/sys.rst:1561 msgid "" "If the new limit is too low at the current recursion depth, a :exc:" "`RecursionError` exception is raised." msgstr "" -#: library/sys.rst:1535 +#: library/sys.rst:1564 msgid "" "A :exc:`RecursionError` exception is now raised if the new limit is too low " "at the current recursion depth." msgstr "" -#: library/sys.rst:1542 +#: library/sys.rst:1571 msgid "" "Set the interpreter's thread switch interval (in seconds). This floating-" "point value determines the ideal duration of the \"timeslices\" allocated to " @@ -1976,7 +2009,7 @@ msgid "" "scheduler." msgstr "" -#: library/sys.rst:1559 +#: library/sys.rst:1588 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 " @@ -1985,7 +2018,7 @@ msgid "" "`threading.settrace`." msgstr "" -#: library/sys.rst:1564 +#: library/sys.rst:1593 msgid "" "Trace functions should have three arguments: *frame*, *event*, and *arg*. " "*frame* is the current stack frame. *event* is a string: ``'call'``, " @@ -1993,7 +2026,7 @@ msgid "" "the event type." msgstr "" -#: library/sys.rst:1569 +#: library/sys.rst:1598 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 " @@ -2001,36 +2034,36 @@ msgid "" "traced." msgstr "" -#: library/sys.rst:1574 +#: library/sys.rst:1603 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:1577 +#: library/sys.rst:1606 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:1581 +#: library/sys.rst:1610 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:1587 +#: library/sys.rst:1616 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:1591 +#: library/sys.rst:1620 msgid "``'line'``" msgstr "" -#: library/sys.rst:1592 +#: library/sys.rst:1621 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``; " @@ -2040,7 +2073,7 @@ msgid "" "to :const:`False` on that :ref:`frame `." msgstr "" -#: library/sys.rst:1602 +#: library/sys.rst:1631 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 " @@ -2048,22 +2081,22 @@ msgid "" "return value is ignored." msgstr "" -#: library/sys.rst:1607 +#: library/sys.rst:1636 msgid "``'exception'``" msgstr "" -#: library/sys.rst:1608 +#: library/sys.rst:1637 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:1612 +#: library/sys.rst:1641 msgid "``'opcode'``" msgstr "" -#: library/sys.rst:1613 +#: library/sys.rst:1642 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 " @@ -2073,13 +2106,13 @@ msgid "" "objects>`." msgstr "" -#: library/sys.rst:1620 +#: library/sys.rst:1649 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:1623 +#: library/sys.rst:1652 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 " @@ -2093,17 +2126,17 @@ msgid "" "on each frame)." msgstr "" -#: library/sys.rst:1634 +#: library/sys.rst:1663 msgid "For more information on code and frame objects, refer to :ref:`types`." msgstr "" -#: library/sys.rst:1636 +#: library/sys.rst:1665 msgid "" "Raises an :ref:`auditing event ` ``sys.settrace`` with no " "arguments." msgstr "" -#: library/sys.rst:1640 +#: library/sys.rst:1669 msgid "" "The :func:`settrace` function is intended only for implementing debuggers, " "profilers, coverage tools and the like. Its behavior is part of the " @@ -2111,13 +2144,13 @@ msgid "" "thus may not be available in all Python implementations." msgstr "" -#: library/sys.rst:1647 +#: library/sys.rst:1676 msgid "" "``'opcode'`` event type added; :attr:`~frame.f_trace_lines` and :attr:" "`~frame.f_trace_opcodes` attributes added to frames" msgstr "" -#: library/sys.rst:1650 +#: library/sys.rst:1679 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 " @@ -2125,7 +2158,7 @@ msgid "" "previous versions." msgstr "" -#: library/sys.rst:1658 +#: library/sys.rst:1687 msgid "" "Accepts two optional keyword arguments which are callables that accept an :" "term:`asynchronous generator iterator` as an argument. The *firstiter* " @@ -2134,32 +2167,32 @@ msgid "" "about to be garbage collected." msgstr "" -#: library/sys.rst:1664 +#: library/sys.rst:1693 msgid "" "Raises an :ref:`auditing event ` ``sys." "set_asyncgen_hooks_firstiter`` with no arguments." msgstr "" -#: library/sys.rst:1666 +#: library/sys.rst:1695 msgid "" "Raises an :ref:`auditing event ` ``sys." "set_asyncgen_hooks_finalizer`` with no arguments." msgstr "" -#: library/sys.rst:1668 +#: library/sys.rst:1697 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:1671 +#: library/sys.rst:1700 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:1683 +#: library/sys.rst:1712 msgid "" "Allows enabling or disabling coroutine origin tracking. When enabled, the " "``cr_origin`` attribute on coroutine objects will contain a tuple of " @@ -2168,100 +2201,100 @@ msgid "" "disabled, ``cr_origin`` will be ``None``." msgstr "" -#: library/sys.rst:1690 +#: library/sys.rst:1719 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:1694 +#: library/sys.rst:1723 msgid "This setting is thread-specific." msgstr "" -#: library/sys.rst:1704 +#: library/sys.rst:1733 msgid "" "Activate the stack profiler trampoline *backend*. The only supported backend " "is ``\"perf\"``." msgstr "" -#: library/sys.rst:1713 +#: library/sys.rst:1742 msgid ":ref:`perf_profiling`" msgstr "" -#: library/sys.rst:1714 +#: library/sys.rst:1743 msgid "https://perf.wiki.kernel.org" msgstr "" -#: library/sys.rst:1718 +#: library/sys.rst:1747 msgid "Deactivate the current stack profiler trampoline backend." msgstr "" -#: library/sys.rst:1720 +#: library/sys.rst:1749 msgid "If no stack profiler is activated, this function has no effect." msgstr "" -#: library/sys.rst:1728 +#: library/sys.rst:1757 msgid "Return ``True`` if a stack profiler trampoline is active." msgstr "" -#: library/sys.rst:1736 +#: library/sys.rst:1765 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:1740 +#: library/sys.rst:1769 msgid "" "This is equivalent to defining the :envvar:`PYTHONLEGACYWINDOWSFSENCODING` " "environment variable before launching Python." msgstr "" -#: library/sys.rst:1743 +#: library/sys.rst:1772 msgid "" "See also :func:`sys.getfilesystemencoding` and :func:`sys." "getfilesystemencodeerrors`." msgstr "" -#: library/sys.rst:1748 +#: library/sys.rst:1777 msgid "See :pep:`529` for more details." msgstr "" -#: library/sys.rst:1755 +#: library/sys.rst:1784 msgid "" ":term:`File objects ` used by the interpreter for standard " "input, output and errors:" msgstr "" -#: library/sys.rst:1758 +#: library/sys.rst:1787 msgid "" "``stdin`` is used for all interactive input (including calls to :func:" "`input`);" msgstr "" -#: library/sys.rst:1760 +#: library/sys.rst:1789 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:1762 +#: library/sys.rst:1791 msgid "The interpreter's own prompts and its error messages go to ``stderr``." msgstr "" -#: library/sys.rst:1764 +#: library/sys.rst:1793 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:1768 +#: library/sys.rst:1797 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:1771 +#: library/sys.rst:1800 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 " @@ -2272,14 +2305,14 @@ msgid "" "initially attached to a console." msgstr "" -#: library/sys.rst:1780 +#: library/sys.rst:1809 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:1785 +#: library/sys.rst:1814 msgid "" "Under all platforms, you can override the character encoding by setting the :" "envvar:`PYTHONIOENCODING` environment variable before starting Python or by " @@ -2288,7 +2321,7 @@ msgid "" "only applies when :envvar:`PYTHONLEGACYWINDOWSSTDIO` is also set." msgstr "" -#: library/sys.rst:1792 +#: library/sys.rst:1821 msgid "" "When interactive, the ``stdout`` stream is line-buffered. Otherwise, it is " "block-buffered like regular text files. The ``stderr`` stream is line-" @@ -2297,19 +2330,19 @@ msgid "" "`PYTHONUNBUFFERED` environment variable." msgstr "" -#: library/sys.rst:1798 +#: library/sys.rst:1827 msgid "" "Non-interactive ``stderr`` is now line-buffered instead of fully buffered." msgstr "" -#: library/sys.rst:1804 +#: library/sys.rst:1833 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:1808 +#: library/sys.rst:1837 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 " @@ -2317,7 +2350,7 @@ msgid "" "support the :attr:`!buffer` attribute." msgstr "" -#: library/sys.rst:1818 +#: library/sys.rst:1847 msgid "" "These objects contain the original values of ``stdin``, ``stderr`` and " "``stdout`` at the start of the program. They are used during finalization, " @@ -2325,7 +2358,7 @@ msgid "" "``sys.std*`` object has been redirected." msgstr "" -#: library/sys.rst:1823 +#: library/sys.rst:1852 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, " @@ -2333,7 +2366,7 @@ msgid "" "before replacing it, and restore the saved object." msgstr "" -#: library/sys.rst:1829 +#: library/sys.rst:1858 msgid "" "Under some conditions ``stdin``, ``stdout`` and ``stderr`` as well as the " "original values ``__stdin__``, ``__stdout__`` and ``__stderr__`` can be " @@ -2341,12 +2374,12 @@ msgid "" "to a console and Python apps started with :program:`pythonw`." msgstr "" -#: library/sys.rst:1837 +#: library/sys.rst:1866 msgid "" "A frozenset of strings containing the names of standard library modules." msgstr "" -#: library/sys.rst:1839 +#: library/sys.rst:1868 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 " @@ -2354,7 +2387,7 @@ msgid "" "modules are excluded." msgstr "" -#: library/sys.rst:1844 +#: library/sys.rst:1873 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 " @@ -2362,60 +2395,60 @@ msgid "" "listed." msgstr "" -#: library/sys.rst:1849 +#: library/sys.rst:1878 msgid "See also the :data:`sys.builtin_module_names` list." msgstr "" -#: library/sys.rst:1856 +#: library/sys.rst:1885 msgid "" "A :term:`named tuple` holding information about the thread implementation." msgstr "" -#: library/sys.rst:1861 +#: library/sys.rst:1890 msgid "The name of the thread implementation:" msgstr "" -#: library/sys.rst:1863 +#: library/sys.rst:1892 msgid "``\"nt\"``: Windows threads" msgstr "" -#: library/sys.rst:1864 +#: library/sys.rst:1893 msgid "``\"pthread\"``: POSIX threads" msgstr "" -#: library/sys.rst:1865 +#: library/sys.rst:1894 msgid "" "``\"pthread-stubs\"``: stub POSIX threads (on WebAssembly platforms without " "threading support)" msgstr "" -#: library/sys.rst:1867 +#: library/sys.rst:1896 msgid "``\"solaris\"``: Solaris threads" msgstr "" -#: library/sys.rst:1871 +#: library/sys.rst:1900 msgid "The name of the lock implementation:" msgstr "" -#: library/sys.rst:1873 +#: library/sys.rst:1902 msgid "``\"semaphore\"``: a lock uses a semaphore" msgstr "" -#: library/sys.rst:1874 +#: library/sys.rst:1903 msgid "``\"mutex+cond\"``: a lock uses a mutex and a condition variable" msgstr "" -#: library/sys.rst:1875 +#: library/sys.rst:1904 msgid "``None`` if this information is unknown" msgstr "" -#: library/sys.rst:1879 +#: library/sys.rst:1908 msgid "" "The name and version of the thread library. It is a string, or ``None`` if " "this information is unknown." msgstr "" -#: library/sys.rst:1887 +#: library/sys.rst:1916 msgid "" "When this variable is set to an integer value, it determines the maximum " "number of levels of traceback information printed when an unhandled " @@ -2424,73 +2457,73 @@ msgid "" "are printed." msgstr "" -#: library/sys.rst:1895 +#: library/sys.rst:1924 msgid "Handle an unraisable exception." msgstr "" -#: library/sys.rst:1897 +#: library/sys.rst:1926 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:1901 +#: library/sys.rst:1930 msgid "The *unraisable* argument has the following attributes:" msgstr "" -#: library/sys.rst:1903 +#: library/sys.rst:1932 msgid ":attr:`!exc_type`: Exception type." msgstr "" -#: library/sys.rst:1904 +#: library/sys.rst:1933 msgid ":attr:`!exc_value`: Exception value, can be ``None``." msgstr "" -#: library/sys.rst:1905 +#: library/sys.rst:1934 msgid ":attr:`!exc_traceback`: Exception traceback, can be ``None``." msgstr "" -#: library/sys.rst:1906 +#: library/sys.rst:1935 msgid ":attr:`!err_msg`: Error message, can be ``None``." msgstr "" -#: library/sys.rst:1907 +#: library/sys.rst:1936 msgid ":attr:`!object`: Object causing the exception, can be ``None``." msgstr "" -#: library/sys.rst:1909 +#: library/sys.rst:1938 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:1913 +#: library/sys.rst:1942 msgid "" ":func:`sys.unraisablehook` can be overridden to control how unraisable " "exceptions are handled." msgstr "" -#: library/sys.rst:1918 +#: library/sys.rst:1947 msgid ":func:`excepthook` which handles uncaught exceptions." msgstr "" -#: library/sys.rst:1922 +#: library/sys.rst:1951 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:1926 +#: library/sys.rst:1955 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:1932 +#: library/sys.rst:1961 msgid "" "Raise an auditing event ``sys.unraisablehook`` with arguments *hook*, " "*unraisable* when an exception that cannot be handled occurs. The " @@ -2498,7 +2531,7 @@ msgid "" "hook has been set, *hook* may be ``None``." msgstr "" -#: library/sys.rst:1941 +#: library/sys.rst:1970 msgid "" "A string containing the version number of the Python interpreter plus " "additional information on the build number and compiler used. This string " @@ -2507,13 +2540,13 @@ msgid "" "functions provided by the :mod:`platform` module." msgstr "" -#: library/sys.rst:1950 +#: library/sys.rst:1979 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:1956 +#: library/sys.rst:1985 msgid "" "A tuple containing the five components of the version number: *major*, " "*minor*, *micro*, *releaselevel*, and *serial*. All values except " @@ -2524,18 +2557,18 @@ msgid "" "version_info.major`` and so on." msgstr "" -#: library/sys.rst:1964 +#: library/sys.rst:1993 msgid "Added named component attributes." msgstr "" -#: library/sys.rst:1969 +#: library/sys.rst:1998 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:1976 +#: library/sys.rst:2005 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 " @@ -2544,20 +2577,20 @@ msgid "" "has no effect on the registry keys used by Python." msgstr "" -#: library/sys.rst:1988 +#: library/sys.rst:2017 msgid "" "Namespace containing functions and constants for register callbacks and " "controlling monitoring events. See :mod:`sys.monitoring` for details." msgstr "" -#: library/sys.rst:1994 +#: library/sys.rst:2023 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:1998 +#: library/sys.rst:2027 msgid "" "$ ./python -Xa=b -Xc\n" "Python 3.2a3+ (py3k, Oct 16 2010, 20:14:50)\n" @@ -2569,18 +2602,18 @@ msgid "" "{'a': 'b', 'c': True}" msgstr "" -#: library/sys.rst:2010 +#: library/sys.rst:2039 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:2018 +#: library/sys.rst:2047 msgid "Citations" msgstr "" -#: library/sys.rst:2019 +#: library/sys.rst:2048 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/" @@ -2599,50 +2632,50 @@ msgstr "" msgid "traceback" msgstr "" -#: library/sys.rst:1472 +#: library/sys.rst:1501 msgid "profile function" msgstr "" -#: library/sys.rst:1472 +#: library/sys.rst:1501 msgid "profiler" msgstr "" -#: library/sys.rst:1555 +#: library/sys.rst:1584 msgid "trace function" msgstr "" -#: library/sys.rst:1555 +#: library/sys.rst:1584 msgid "debugger" msgstr "" -#: library/sys.rst:1295 +#: library/sys.rst:1324 msgid "module" msgstr "" -#: library/sys.rst:1295 +#: library/sys.rst:1324 msgid "search" msgstr "" -#: library/sys.rst:1295 +#: library/sys.rst:1324 msgid "path" msgstr "" -#: library/sys.rst:1436 +#: library/sys.rst:1465 msgid "interpreter prompts" msgstr "" -#: library/sys.rst:1436 +#: library/sys.rst:1465 msgid "prompts, interpreter" msgstr "" -#: library/sys.rst:1436 +#: library/sys.rst:1465 msgid ">>>" msgstr "" -#: library/sys.rst:1436 +#: library/sys.rst:1465 msgid "interpreter prompt" msgstr "" -#: library/sys.rst:1436 +#: library/sys.rst:1465 msgid "..." msgstr "" diff --git a/library/time.po b/library/time.po index 739e19225..f7a0f8957 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: 2023-03-01 11:44+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -617,13 +617,14 @@ msgstr "" "planlanmasıdır." #: library/time.rst:370 +#, fuzzy msgid "" "On Windows, if *secs* is zero, the thread relinquishes the remainder of its " "time slice to any other thread that is ready to run. If there are no other " "threads ready to run, the function returns immediately, and the thread " "continues execution. On Windows 8.1 and newer the implementation uses a " -"`high-resolution timer `_ which provides resolution of 100 " +"`high-resolution timer `_ which provides resolution of 100 " "nanoseconds. If *secs* is zero, ``Sleep(0)`` is used." msgstr "" "Windows'ta *secs* sıfırsa, iş parçacığı zaman diliminin geri kalanını " diff --git a/library/token.po b/library/token.po index 096fe9525..439453f6f 100644 --- a/library/token.po +++ b/library/token.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -285,21 +285,27 @@ msgid "" "only produced when :func:`ast.parse` is invoked with ``type_comments=True``." msgstr "" -#: library/token.rst:82 +#: library/token.rst:84 +msgid "" +"A dictionary mapping the string representation of a token to its numeric " +"code." +msgstr "" + +#: library/token.rst:89 msgid "Added :data:`AWAIT` and :data:`ASYNC` tokens." msgstr "" -#: library/token.rst:85 +#: library/token.rst:92 msgid "Added :data:`COMMENT`, :data:`NL` and :data:`ENCODING` tokens." msgstr "" -#: library/token.rst:88 +#: library/token.rst:95 msgid "" "Removed :data:`AWAIT` and :data:`ASYNC` tokens. \"async\" and \"await\" are " "now tokenized as :data:`NAME` tokens." msgstr "" -#: library/token.rst:92 +#: library/token.rst:99 msgid "" "Added :data:`TYPE_COMMENT`, :data:`TYPE_IGNORE`, :data:`COLONEQUAL`. Added :" "data:`AWAIT` and :data:`ASYNC` tokens back (they're needed to support " diff --git a/library/traceback.po b/library/traceback.po index c580d326e..811dc6720 100644 --- a/library/traceback.po +++ b/library/traceback.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -148,11 +148,11 @@ msgid "" "when printing an unhandled exception." msgstr "" -#: library/traceback.rst:201 +#: library/traceback.rst:208 msgid "The *etype* argument is ignored and inferred from the type of *value*." msgstr "" -#: library/traceback.rst:184 +#: library/traceback.rst:191 msgid "" "The *etype* parameter has been renamed to *exc* and is now positional-only." msgstr "" @@ -203,6 +203,13 @@ msgstr "" #: library/traceback.rst:162 msgid "" +"Print the list of tuples as returned by :func:`extract_tb` or :func:" +"`extract_stack` as a formatted stack trace to the given file. If *file* is " +"``None``, the output is written to :data:`sys.stderr`." +msgstr "" + +#: library/traceback.rst:169 +msgid "" "Given a list of tuples or :class:`FrameSummary` objects as returned by :func:" "`extract_tb` or :func:`extract_stack`, return a list of strings ready for " "printing. Each string in the resulting list corresponds to the item with " @@ -211,7 +218,7 @@ msgid "" "text line is not ``None``." msgstr "" -#: library/traceback.rst:172 +#: library/traceback.rst:179 msgid "" "Format the exception part of a traceback using an exception value such as " "given by :data:`sys.last_value`. The return value is a list of strings, " @@ -222,20 +229,20 @@ msgid "" "contains the exception's :attr:`notes `." msgstr "" -#: library/traceback.rst:180 +#: library/traceback.rst:187 msgid "" "Since Python 3.10, instead of passing *value*, an exception object can be " "passed as the first argument. If *value* is provided, the first argument is " "ignored in order to provide backwards compatibility." msgstr "" -#: library/traceback.rst:188 +#: library/traceback.rst:195 msgid "" "The returned list now includes any :attr:`notes ` " "attached to the exception." msgstr "" -#: library/traceback.rst:195 +#: library/traceback.rst:202 msgid "" "Format a stack trace and the exception information. The arguments have the " "same meaning as the corresponding arguments to :func:`print_exception`. The " @@ -244,69 +251,69 @@ msgid "" "printed, exactly the same text is printed as does :func:`print_exception`." msgstr "" -#: library/traceback.rst:204 +#: library/traceback.rst:211 msgid "" "This function's behavior and signature were modified to match :func:" "`print_exception`." msgstr "" -#: library/traceback.rst:211 +#: library/traceback.rst:218 msgid "" "This is like ``print_exc(limit)`` but returns a string instead of printing " "to a file." msgstr "" -#: library/traceback.rst:217 +#: library/traceback.rst:224 msgid "A shorthand for ``format_list(extract_tb(tb, limit))``." msgstr "" -#: library/traceback.rst:222 +#: library/traceback.rst:229 msgid "A shorthand for ``format_list(extract_stack(f, limit))``." msgstr "" -#: library/traceback.rst:226 +#: library/traceback.rst:233 msgid "" "Clears the local variables of all the stack frames in a :ref:`traceback " "` *tb* by calling the :meth:`~frame.clear` method of " "each :ref:`frame object `." msgstr "" -#: library/traceback.rst:235 +#: library/traceback.rst:242 msgid "" "Walk a stack following :attr:`f.f_back ` from the given frame, " "yielding the frame and line number for each frame. If *f* is ``None``, the " "current stack is used. This helper is used with :meth:`StackSummary.extract`." msgstr "" -#: library/traceback.rst:244 +#: library/traceback.rst:251 msgid "" "Walk a traceback following :attr:`~traceback.tb_next` yielding the frame and " "line number for each frame. This helper is used with :meth:`StackSummary." "extract`." msgstr "" -#: library/traceback.rst:252 +#: library/traceback.rst:259 msgid ":class:`!TracebackException` Objects" msgstr "" -#: library/traceback.rst:256 +#: library/traceback.rst:263 msgid "" ":class:`!TracebackException` objects are created from actual exceptions to " "capture data for later printing. They offer a more lightweight method of " "storing this information by avoiding holding references to :ref:" -"`traceback` and :ref:`frame` objects In " +"`traceback` and :ref:`frame` objects. In " "addition, they expose more options to configure the output compared to the " "module-level functions described above." msgstr "" -#: library/traceback.rst:265 +#: library/traceback.rst:272 msgid "" "Capture an exception for later rendering. The meaning of *limit*, " "*lookup_lines* and *capture_locals* are as for the :class:`StackSummary` " "class." msgstr "" -#: library/traceback.rst:269 +#: library/traceback.rst:276 msgid "" "If *compact* is true, only data that is required by :class:`!" "TracebackException`'s :meth:`format` method is saved in the class " @@ -314,12 +321,12 @@ msgid "" "if :attr:`__cause__` is ``None`` and :attr:`__suppress_context__` is false." msgstr "" -#: library/traceback.rst:368 +#: library/traceback.rst:375 msgid "" "Note that when locals are captured, they are also shown in the traceback." msgstr "" -#: library/traceback.rst:277 +#: library/traceback.rst:284 msgid "" "*max_group_width* and *max_group_depth* control the formatting of exception " "groups (see :exc:`BaseExceptionGroup`). The depth refers to the nesting " @@ -328,124 +335,124 @@ msgid "" "limit is exceeded." msgstr "" -#: library/traceback.rst:283 +#: library/traceback.rst:290 msgid "Added the *compact* parameter." msgstr "" -#: library/traceback.rst:286 +#: library/traceback.rst:293 msgid "Added the *max_group_width* and *max_group_depth* parameters." msgstr "" -#: library/traceback.rst:291 +#: library/traceback.rst:298 msgid "" "A :class:`!TracebackException` of the original :attr:`~BaseException." "__cause__`." msgstr "" -#: library/traceback.rst:296 +#: library/traceback.rst:303 msgid "" "A :class:`!TracebackException` of the original :attr:`~BaseException." "__context__`." msgstr "" -#: library/traceback.rst:301 +#: library/traceback.rst:308 msgid "" "If ``self`` represents an :exc:`ExceptionGroup`, this field holds a list of :" "class:`!TracebackException` instances representing the nested exceptions. " "Otherwise it is ``None``." msgstr "" -#: library/traceback.rst:309 +#: library/traceback.rst:316 msgid "" "The :attr:`~BaseException.__suppress_context__` value from the original " "exception." msgstr "" -#: library/traceback.rst:314 +#: library/traceback.rst:321 msgid "" "The :attr:`~BaseException.__notes__` value from the original exception, or " "``None`` if the exception does not have any notes. If it is not ``None`` is " "it formatted in the traceback after the exception string." msgstr "" -#: library/traceback.rst:323 +#: library/traceback.rst:330 msgid "A :class:`StackSummary` representing the traceback." msgstr "" -#: library/traceback.rst:327 +#: library/traceback.rst:334 msgid "The class of the original traceback." msgstr "" -#: library/traceback.rst:331 +#: library/traceback.rst:338 msgid "For syntax errors - the file name where the error occurred." msgstr "" -#: library/traceback.rst:335 +#: library/traceback.rst:342 msgid "For syntax errors - the line number where the error occurred." msgstr "" -#: library/traceback.rst:339 +#: library/traceback.rst:346 msgid "" "For syntax errors - the end line number where the error occurred. Can be " "``None`` if not present." msgstr "" -#: library/traceback.rst:346 +#: library/traceback.rst:353 msgid "For syntax errors - the text where the error occurred." msgstr "" -#: library/traceback.rst:350 +#: library/traceback.rst:357 msgid "For syntax errors - the offset into the text where the error occurred." msgstr "" -#: library/traceback.rst:354 +#: library/traceback.rst:361 msgid "" "For syntax errors - the end offset into the text where the error occurred. " "Can be ``None`` if not present." msgstr "" -#: library/traceback.rst:361 +#: library/traceback.rst:368 msgid "For syntax errors - the compiler error message." msgstr "" -#: library/traceback.rst:365 +#: library/traceback.rst:372 msgid "" "Capture an exception for later rendering. *limit*, *lookup_lines* and " "*capture_locals* are as for the :class:`StackSummary` class." msgstr "" -#: library/traceback.rst:372 +#: library/traceback.rst:379 msgid "" "Print to *file* (default ``sys.stderr``) the exception information returned " "by :meth:`format`." msgstr "" -#: library/traceback.rst:379 +#: library/traceback.rst:386 msgid "Format the exception." msgstr "" -#: library/traceback.rst:381 +#: library/traceback.rst:388 msgid "" "If *chain* is not ``True``, :attr:`__cause__` and :attr:`__context__` will " "not be formatted." msgstr "" -#: library/traceback.rst:384 +#: library/traceback.rst:391 msgid "" "The return value is a generator of strings, each ending in a newline and " "some containing internal newlines. :func:`~traceback.print_exception` is a " "wrapper around this method which just prints the lines to a file." msgstr "" -#: library/traceback.rst:390 +#: library/traceback.rst:397 msgid "Format the exception part of the traceback." msgstr "" -#: library/traceback.rst:392 +#: library/traceback.rst:399 msgid "The return value is a generator of strings, each ending in a newline." msgstr "" -#: library/traceback.rst:394 +#: library/traceback.rst:401 msgid "" "The generator emits the exception's message followed by its notes (if it has " "any). The exception message is normally a single string; however, for :exc:" @@ -453,28 +460,28 @@ msgid "" "display detailed information about where the syntax error occurred." msgstr "" -#: library/traceback.rst:400 +#: library/traceback.rst:407 msgid "" "The exception's :attr:`notes ` are now included in " "the output." msgstr "" -#: library/traceback.rst:407 +#: library/traceback.rst:414 msgid ":class:`!StackSummary` Objects" msgstr "" -#: library/traceback.rst:411 +#: library/traceback.rst:418 msgid "" ":class:`!StackSummary` objects represent a call stack ready for formatting." msgstr "" -#: library/traceback.rst:417 +#: library/traceback.rst:424 msgid "" "Construct a :class:`!StackSummary` object from a frame generator (such as is " "returned by :func:`~traceback.walk_stack` or :func:`~traceback.walk_tb`)." msgstr "" -#: library/traceback.rst:421 +#: library/traceback.rst:428 msgid "" "If *limit* is supplied, only this many frames are taken from *frame_gen*. If " "*lookup_lines* is ``False``, the returned :class:`FrameSummary` objects will " @@ -484,20 +491,20 @@ msgid "" "class:`!FrameSummary` are captured as object representations." msgstr "" -#: library/traceback.rst:429 +#: library/traceback.rst:436 msgid "" "Exceptions raised from :func:`repr` on a local variable (when " "*capture_locals* is ``True``) are no longer propagated to the caller." msgstr "" -#: library/traceback.rst:435 +#: library/traceback.rst:442 msgid "" "Construct a :class:`!StackSummary` object from a supplied list of :class:" "`FrameSummary` objects or old-style list of tuples. Each tuple should be a " "4-tuple with *filename*, *lineno*, *name*, *line* as the elements." msgstr "" -#: library/traceback.rst:442 +#: library/traceback.rst:449 msgid "" "Returns a list of strings ready for printing. Each string in the resulting " "list corresponds to a single :ref:`frame ` from the stack. " @@ -505,18 +512,18 @@ msgid "" "well, for those items with source text lines." msgstr "" -#: library/traceback.rst:448 +#: library/traceback.rst:455 msgid "" "For long sequences of the same frame and line, the first few repetitions are " "shown, followed by a summary line stating the exact number of further " "repetitions." msgstr "" -#: library/traceback.rst:452 +#: library/traceback.rst:459 msgid "Long sequences of repeated frames are now abbreviated." msgstr "" -#: library/traceback.rst:457 +#: library/traceback.rst:464 msgid "" "Returns a string for printing one of the :ref:`frames ` " "involved in the stack. This method is called for each :class:`FrameSummary` " @@ -524,17 +531,17 @@ msgid "" "the frame is omitted from the output." msgstr "" -#: library/traceback.rst:467 +#: library/traceback.rst:474 msgid ":class:`!FrameSummary` Objects" msgstr "" -#: library/traceback.rst:471 +#: library/traceback.rst:478 msgid "" "A :class:`!FrameSummary` object represents a single :ref:`frame ` in a :ref:`traceback `." msgstr "" -#: library/traceback.rst:476 +#: library/traceback.rst:483 msgid "" "Represents a single :ref:`frame ` in the :ref:`traceback " "` or stack that is being formatted or printed. It may " @@ -548,38 +555,38 @@ msgid "" "display." msgstr "" -#: library/traceback.rst:487 +#: library/traceback.rst:494 msgid ":class:`!FrameSummary` instances have the following attributes:" msgstr "" -#: library/traceback.rst:491 +#: library/traceback.rst:498 msgid "" "The filename of the source code for this frame. Equivalent to accessing :" "attr:`f.f_code.co_filename ` on a :ref:`frame object " "` *f*." msgstr "" -#: library/traceback.rst:497 +#: library/traceback.rst:504 msgid "The line number of the source code for this frame." msgstr "" -#: library/traceback.rst:501 +#: library/traceback.rst:508 msgid "" "Equivalent to accessing :attr:`f.f_code.co_name ` on a :" "ref:`frame object ` *f*." msgstr "" -#: library/traceback.rst:506 +#: library/traceback.rst:513 msgid "" "A string representing the source code for this frame, with leading and " "trailing whitespace stripped. If the source is not available, it is ``None``." msgstr "" -#: library/traceback.rst:513 +#: library/traceback.rst:520 msgid "Examples of Using the Module-Level Functions" msgstr "" -#: library/traceback.rst:515 +#: library/traceback.rst:522 msgid "" "This simple example implements a basic read-eval-print loop, similar to (but " "less useful than) the standard Python interactive interpreter loop. For a " @@ -587,7 +594,7 @@ msgid "" "`code` module. ::" msgstr "" -#: library/traceback.rst:520 +#: library/traceback.rst:527 msgid "" "import sys, traceback\n" "\n" @@ -606,13 +613,13 @@ msgid "" " run_user_code(envdir)" msgstr "" -#: library/traceback.rst:537 +#: library/traceback.rst:544 msgid "" "The following example demonstrates the different ways to print and format " "the exception and traceback:" msgstr "" -#: library/traceback.rst:540 +#: library/traceback.rst:547 msgid "" "import sys, traceback\n" "\n" @@ -644,11 +651,11 @@ msgid "" " print(\"*** tb_lineno:\", exc.__traceback__.tb_lineno)" msgstr "" -#: library/traceback.rst:571 +#: library/traceback.rst:578 msgid "The output for the example would look similar to this:" msgstr "" -#: library/traceback.rst:573 +#: library/traceback.rst:580 msgid "" "*** print_tb:\n" " File \"\", line 10, in \n" @@ -693,13 +700,13 @@ msgid "" "*** tb_lineno: 10" msgstr "" -#: library/traceback.rst:613 +#: library/traceback.rst:620 msgid "" "The following example shows the different ways to print and format the " "stack::" msgstr "" -#: library/traceback.rst:615 +#: library/traceback.rst:622 msgid "" ">>> import traceback\n" ">>> def another_function():\n" @@ -727,11 +734,11 @@ msgid "" "format_stack()))\\n']" msgstr "" -#: library/traceback.rst:639 +#: library/traceback.rst:646 msgid "This last example demonstrates the final few formatting functions:" msgstr "" -#: library/traceback.rst:641 +#: library/traceback.rst:648 msgid "" ">>> import traceback\n" ">>> traceback.format_list([('spam.py', 3, '', 'spam.eggs()'),\n" @@ -743,15 +750,15 @@ msgid "" "['IndexError: tuple index out of range\\n']" msgstr "" -#: library/traceback.rst:655 +#: library/traceback.rst:662 msgid "Examples of Using :class:`TracebackException`" msgstr "" -#: library/traceback.rst:657 +#: library/traceback.rst:664 msgid "With the helper class, we have more options::" msgstr "" -#: library/traceback.rst:659 +#: library/traceback.rst:666 msgid "" ">>> import sys\n" ">>> from traceback import TracebackException\n" diff --git a/library/typing.po b/library/typing.po index 96237b95c..629dae655 100644 --- a/library/typing.po +++ b/library/typing.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2313,13 +2313,14 @@ msgstr "" #: library/typing.rst:1612 msgid "" -"This syntax can also be used to create bound and constrained type variables::" +"This syntax can also be used to create bounded and constrained type " +"variables::" msgstr "" #: library/typing.rst:1615 msgid "" -"class StrSequence[S: str]: # S is a TypeVar bound to str\n" -" ...\n" +"class StrSequence[S: str]: # S is a TypeVar with a `str` upper bound;\n" +" ... # we can say that S is \"bounded by `str`\"\n" "\n" "\n" "class StrOrBytesSequence[A: (str, bytes)]: # A is a TypeVar constrained to " @@ -2368,8 +2369,8 @@ msgstr "" #: library/typing.rst:1649 msgid "" -"Note that type variables can be *bound*, *constrained*, or neither, but " -"cannot be both bound *and* constrained." +"Note that type variables can be *bounded*, *constrained*, or neither, but " +"cannot be both bounded *and* constrained." msgstr "" #: library/typing.rst:1652 @@ -2384,9 +2385,9 @@ msgstr "" #: library/typing.rst:1660 msgid "" -"Bound type variables and constrained type variables have different semantics " -"in several important ways. Using a *bound* type variable means that the " -"``TypeVar`` will be solved using the most specific type possible::" +"Bounded type variables and constrained type variables have different " +"semantics in several important ways. Using a *bounded* type variable means " +"that the ``TypeVar`` will be solved using the most specific type possible::" msgstr "" #: library/typing.rst:1664 @@ -2405,8 +2406,8 @@ msgstr "" #: library/typing.rst:1675 msgid "" -"Type variables can be bound to concrete types, abstract types (ABCs or " -"protocols), and even unions of types::" +"The upper bound of a type variable can be a concrete type, abstract type " +"(ABC or Protocol), or even a union of types::" msgstr "" #: library/typing.rst:1678 @@ -2461,7 +2462,7 @@ msgid "" msgstr "" #: library/typing.rst:1720 -msgid "The bound of the type variable, if any." +msgid "The upper bound of the type variable, if any." msgstr "" #: library/typing.rst:1724 @@ -2723,8 +2724,8 @@ msgstr "" #: library/typing.rst:1905 msgid "" "Without ``ParamSpec``, the simplest way to annotate this previously was to " -"use a :class:`TypeVar` with bound ``Callable[..., Any]``. However this " -"causes two problems:" +"use a :class:`TypeVar` with upper bound ``Callable[..., Any]``. However " +"this causes two problems:" msgstr "" #: library/typing.rst:1909 diff --git a/library/urllib.parse.po b/library/urllib.parse.po index 3dd0601e1..4b6114282 100644 --- a/library/urllib.parse.po +++ b/library/urllib.parse.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -147,19 +147,19 @@ msgid "" "accessed by index or as named attributes, which are:" msgstr "" -#: library/urllib.parse.rst:302 library/urllib.parse.rst:415 +#: library/urllib.parse.rst:302 library/urllib.parse.rst:424 msgid "Attribute" msgstr "" -#: library/urllib.parse.rst:302 library/urllib.parse.rst:415 +#: library/urllib.parse.rst:302 library/urllib.parse.rst:424 msgid "Index" msgstr "" -#: library/urllib.parse.rst:302 library/urllib.parse.rst:415 +#: library/urllib.parse.rst:302 library/urllib.parse.rst:424 msgid "Value" msgstr "" -#: library/urllib.parse.rst:302 library/urllib.parse.rst:415 +#: library/urllib.parse.rst:302 library/urllib.parse.rst:424 msgid "Value if not present" msgstr "" @@ -167,7 +167,7 @@ msgstr "" msgid ":attr:`scheme`" msgstr "" -#: library/urllib.parse.rst:304 library/urllib.parse.rst:417 +#: library/urllib.parse.rst:304 library/urllib.parse.rst:426 msgid "0" msgstr "" @@ -183,7 +183,7 @@ msgstr "" msgid ":attr:`netloc`" msgstr "" -#: library/urllib.parse.rst:306 library/urllib.parse.rst:419 +#: library/urllib.parse.rst:306 library/urllib.parse.rst:428 msgid "1" msgstr "" @@ -193,7 +193,7 @@ msgstr "" #: library/urllib.parse.rst:119 library/urllib.parse.rst:124 #: library/urllib.parse.rst:306 library/urllib.parse.rst:310 -#: library/urllib.parse.rst:417 library/urllib.parse.rst:419 +#: library/urllib.parse.rst:426 library/urllib.parse.rst:428 msgid "empty string" msgstr "" @@ -233,7 +233,7 @@ msgstr "" msgid "Query component" msgstr "" -#: library/urllib.parse.rst:312 library/urllib.parse.rst:419 +#: library/urllib.parse.rst:312 library/urllib.parse.rst:428 msgid ":attr:`fragment`" msgstr "" @@ -241,7 +241,7 @@ msgstr "" msgid "5" msgstr "" -#: library/urllib.parse.rst:312 library/urllib.parse.rst:419 +#: library/urllib.parse.rst:312 library/urllib.parse.rst:428 msgid "Fragment identifier" msgstr "" @@ -457,7 +457,7 @@ msgid "" "(addressing scheme, network location, path, query, fragment identifier)." msgstr "" -#: library/urllib.parse.rst:411 +#: library/urllib.parse.rst:420 msgid "" "The return value is a :term:`named tuple`, its items can be accessed by " "index or as named attributes:" @@ -528,11 +528,20 @@ msgid "" "and :func:`urlunsplit`, removing possible *scheme* and *netloc* parts." msgstr "" -#: library/urllib.parse.rst:401 +#: library/urllib.parse.rst:400 +msgid "" +"Because an absolute URL may be passed as the ``url`` parameter, it is " +"generally **not secure** to use ``urljoin`` with an attacker-controlled " +"``url``. For example in, ``urljoin(\"https://website.com/users/\", " +"username)``, if ``username`` can contain an absolute URL, the result of " +"``urljoin`` will be the absolute URL." +msgstr "" + +#: library/urllib.parse.rst:410 msgid "Behavior updated to match the semantics defined in :rfc:`3986`." msgstr "" -#: library/urllib.parse.rst:406 +#: library/urllib.parse.rst:415 msgid "" "If *url* contains a fragment identifier, return a modified version of *url* " "with no fragment identifier, and the fragment identifier as a separate " @@ -540,25 +549,25 @@ msgid "" "unmodified and an empty string." msgstr "" -#: library/urllib.parse.rst:417 +#: library/urllib.parse.rst:426 msgid ":attr:`url`" msgstr "" -#: library/urllib.parse.rst:417 +#: library/urllib.parse.rst:426 msgid "URL with no fragment" msgstr "" -#: library/urllib.parse.rst:422 +#: library/urllib.parse.rst:431 msgid "" "See section :ref:`urlparse-result-object` for more information on the result " "object." msgstr "" -#: library/urllib.parse.rst:425 +#: library/urllib.parse.rst:434 msgid "Result is a structured object rather than a simple 2-tuple." msgstr "" -#: library/urllib.parse.rst:430 +#: library/urllib.parse.rst:439 msgid "" "Extract the url from a wrapped URL (that is, a string formatted as ````, ````, ``URL:scheme://host/path`` " @@ -566,11 +575,11 @@ msgid "" "without changes." msgstr "" -#: library/urllib.parse.rst:438 +#: library/urllib.parse.rst:447 msgid "URL parsing security" msgstr "" -#: library/urllib.parse.rst:440 +#: library/urllib.parse.rst:449 msgid "" "The :func:`urlsplit` and :func:`urlparse` APIs do not perform **validation** " "of inputs. They may not raise errors on inputs that other applications " @@ -579,14 +588,14 @@ msgid "" "rather than purity." msgstr "" -#: library/urllib.parse.rst:446 +#: library/urllib.parse.rst:455 msgid "" "Instead of raising an exception on unusual input, they may instead return " "some component parts as empty strings. Or components may contain more than " "perhaps they should." msgstr "" -#: library/urllib.parse.rst:450 +#: library/urllib.parse.rst:459 msgid "" "We recommend that users of these APIs where the values may be used anywhere " "with security implications code defensively. Do some verification within " @@ -595,7 +604,7 @@ msgid "" "that ``hostname``? etc." msgstr "" -#: library/urllib.parse.rst:456 +#: library/urllib.parse.rst:465 msgid "" "What constitutes a URL is not universally well defined. Different " "applications have different needs and desired constraints. For instance the " @@ -607,11 +616,11 @@ msgid "" "API behavior changes." msgstr "" -#: library/urllib.parse.rst:467 +#: library/urllib.parse.rst:476 msgid "Parsing ASCII Encoded Bytes" msgstr "" -#: library/urllib.parse.rst:469 +#: library/urllib.parse.rst:478 msgid "" "The URL parsing functions were originally designed to operate on character " "strings only. In practice, it is useful to be able to manipulate properly " @@ -620,14 +629,14 @@ msgid "" "`bytearray` objects in addition to :class:`str` objects." msgstr "" -#: library/urllib.parse.rst:475 +#: library/urllib.parse.rst:484 msgid "" "If :class:`str` data is passed in, the result will also contain only :class:" "`str` data. If :class:`bytes` or :class:`bytearray` data is passed in, the " "result will contain only :class:`bytes` data." msgstr "" -#: library/urllib.parse.rst:479 +#: library/urllib.parse.rst:488 msgid "" "Attempting to mix :class:`str` data with :class:`bytes` or :class:" "`bytearray` in a single function call will result in a :exc:`TypeError` " @@ -635,7 +644,7 @@ msgid "" "trigger :exc:`UnicodeDecodeError`." msgstr "" -#: library/urllib.parse.rst:484 +#: library/urllib.parse.rst:493 msgid "" "To support easier conversion of result objects between :class:`str` and :" "class:`bytes`, all return values from URL parsing functions provide either " @@ -648,14 +657,14 @@ msgid "" "`str` data (for :meth:`decode` methods)." msgstr "" -#: library/urllib.parse.rst:495 +#: library/urllib.parse.rst:504 msgid "" "Applications that need to operate on potentially improperly quoted URLs that " "may contain non-ASCII data will need to do their own decoding from bytes to " "characters before invoking the URL parsing methods." msgstr "" -#: library/urllib.parse.rst:499 +#: library/urllib.parse.rst:508 msgid "" "The behaviour described in this section applies only to the URL parsing " "functions. The URL quoting functions use their own rules when producing or " @@ -663,15 +672,15 @@ msgid "" "URL quoting functions." msgstr "" -#: library/urllib.parse.rst:504 +#: library/urllib.parse.rst:513 msgid "URL parsing functions now accept ASCII encoded byte sequences" msgstr "" -#: library/urllib.parse.rst:511 +#: library/urllib.parse.rst:520 msgid "Structured Parse Results" msgstr "" -#: library/urllib.parse.rst:513 +#: library/urllib.parse.rst:522 msgid "" "The result objects from the :func:`urlparse`, :func:`urlsplit` and :func:" "`urldefrag` functions are subclasses of the :class:`tuple` type. These " @@ -680,7 +689,7 @@ msgid "" "section, as well as an additional method:" msgstr "" -#: library/urllib.parse.rst:521 +#: library/urllib.parse.rst:530 msgid "" "Return the re-combined version of the original URL as a string. This may " "differ from the original URL in that the scheme may be normalized to lower " @@ -688,72 +697,72 @@ msgid "" "queries, and fragment identifiers will be removed." msgstr "" -#: library/urllib.parse.rst:526 +#: library/urllib.parse.rst:535 msgid "" "For :func:`urldefrag` results, only empty fragment identifiers will be " "removed. For :func:`urlsplit` and :func:`urlparse` results, all noted " "changes will be made to the URL returned by this method." msgstr "" -#: library/urllib.parse.rst:530 +#: library/urllib.parse.rst:539 msgid "" "The result of this method remains unchanged if passed back through the " "original parsing function:" msgstr "" -#: library/urllib.parse.rst:543 +#: library/urllib.parse.rst:552 msgid "" "The following classes provide the implementations of the structured parse " "results when operating on :class:`str` objects:" msgstr "" -#: library/urllib.parse.rst:548 +#: library/urllib.parse.rst:557 msgid "" "Concrete class for :func:`urldefrag` results containing :class:`str` data. " "The :meth:`encode` method returns a :class:`DefragResultBytes` instance." msgstr "" -#: library/urllib.parse.rst:556 +#: library/urllib.parse.rst:565 msgid "" "Concrete class for :func:`urlparse` results containing :class:`str` data. " "The :meth:`encode` method returns a :class:`ParseResultBytes` instance." msgstr "" -#: library/urllib.parse.rst:562 +#: library/urllib.parse.rst:571 msgid "" "Concrete class for :func:`urlsplit` results containing :class:`str` data. " "The :meth:`encode` method returns a :class:`SplitResultBytes` instance." msgstr "" -#: library/urllib.parse.rst:567 +#: library/urllib.parse.rst:576 msgid "" "The following classes provide the implementations of the parse results when " "operating on :class:`bytes` or :class:`bytearray` objects:" msgstr "" -#: library/urllib.parse.rst:572 +#: library/urllib.parse.rst:581 msgid "" "Concrete class for :func:`urldefrag` results containing :class:`bytes` data. " "The :meth:`decode` method returns a :class:`DefragResult` instance." msgstr "" -#: library/urllib.parse.rst:580 +#: library/urllib.parse.rst:589 msgid "" "Concrete class for :func:`urlparse` results containing :class:`bytes` data. " "The :meth:`decode` method returns a :class:`ParseResult` instance." msgstr "" -#: library/urllib.parse.rst:588 +#: library/urllib.parse.rst:597 msgid "" "Concrete class for :func:`urlsplit` results containing :class:`bytes` data. " "The :meth:`decode` method returns a :class:`SplitResult` instance." msgstr "" -#: library/urllib.parse.rst:596 +#: library/urllib.parse.rst:605 msgid "URL Quoting" msgstr "" -#: library/urllib.parse.rst:598 +#: library/urllib.parse.rst:607 msgid "" "The URL quoting functions focus on taking program data and making it safe " "for use as URL components by quoting special characters and appropriately " @@ -762,7 +771,7 @@ msgid "" "isn't already covered by the URL parsing functions above." msgstr "" -#: library/urllib.parse.rst:606 +#: library/urllib.parse.rst:615 msgid "" "Replace special characters in *string* using the :samp:`%{xx}` escape. " "Letters, digits, and the characters ``'_.-~'`` are never quoted. By default, " @@ -771,17 +780,17 @@ msgid "" "not be quoted --- its default value is ``'/'``." msgstr "" -#: library/urllib.parse.rst:658 library/urllib.parse.rst:687 +#: library/urllib.parse.rst:667 library/urllib.parse.rst:696 msgid "*string* may be either a :class:`str` or a :class:`bytes` object." msgstr "" -#: library/urllib.parse.rst:614 +#: library/urllib.parse.rst:623 msgid "" "Moved from :rfc:`2396` to :rfc:`3986` for quoting URL strings. \"~\" is now " "included in the set of unreserved characters." msgstr "" -#: library/urllib.parse.rst:618 +#: library/urllib.parse.rst:627 msgid "" "The optional *encoding* and *errors* parameters specify how to deal with non-" "ASCII characters, as accepted by the :meth:`str.encode` method. *encoding* " @@ -791,17 +800,17 @@ msgid "" "`TypeError` is raised." msgstr "" -#: library/urllib.parse.rst:626 +#: library/urllib.parse.rst:635 msgid "" "Note that ``quote(string, safe, encoding, errors)`` is equivalent to " "``quote_from_bytes(string.encode(encoding, errors), safe)``." msgstr "" -#: library/urllib.parse.rst:629 +#: library/urllib.parse.rst:638 msgid "Example: ``quote('/El Niño/')`` yields ``'/El%20Ni%C3%B1o/'``." msgstr "" -#: library/urllib.parse.rst:634 +#: library/urllib.parse.rst:643 msgid "" "Like :func:`quote`, but also replace spaces with plus signs, as required for " "quoting HTML form values when building up a query string to go into a URL. " @@ -809,21 +818,21 @@ msgid "" "*safe*. It also does not have *safe* default to ``'/'``." msgstr "" -#: library/urllib.parse.rst:639 +#: library/urllib.parse.rst:648 msgid "Example: ``quote_plus('/El Niño/')`` yields ``'%2FEl+Ni%C3%B1o%2F'``." msgstr "" -#: library/urllib.parse.rst:644 +#: library/urllib.parse.rst:653 msgid "" "Like :func:`quote`, but accepts a :class:`bytes` object rather than a :class:" "`str`, and does not perform string-to-bytes encoding." msgstr "" -#: library/urllib.parse.rst:647 +#: library/urllib.parse.rst:656 msgid "Example: ``quote_from_bytes(b'a&\\xef')`` yields ``'a%26%EF'``." msgstr "" -#: library/urllib.parse.rst:653 +#: library/urllib.parse.rst:662 msgid "" "Replace :samp:`%{xx}` escapes with their single-character equivalent. The " "optional *encoding* and *errors* parameters specify how to decode percent-" @@ -831,52 +840,52 @@ msgid "" "decode` method." msgstr "" -#: library/urllib.parse.rst:660 +#: library/urllib.parse.rst:669 msgid "" "*encoding* defaults to ``'utf-8'``. *errors* defaults to ``'replace'``, " "meaning invalid sequences are replaced by a placeholder character." msgstr "" -#: library/urllib.parse.rst:664 +#: library/urllib.parse.rst:673 msgid "Example: ``unquote('/El%20Ni%C3%B1o/')`` yields ``'/El Niño/'``." msgstr "" -#: library/urllib.parse.rst:666 +#: library/urllib.parse.rst:675 msgid "" "*string* parameter supports bytes and str objects (previously only str)." msgstr "" -#: library/urllib.parse.rst:674 +#: library/urllib.parse.rst:683 msgid "" "Like :func:`unquote`, but also replace plus signs with spaces, as required " "for unquoting HTML form values." msgstr "" -#: library/urllib.parse.rst:677 +#: library/urllib.parse.rst:686 msgid "*string* must be a :class:`str`." msgstr "" -#: library/urllib.parse.rst:679 +#: library/urllib.parse.rst:688 msgid "Example: ``unquote_plus('/El+Ni%C3%B1o/')`` yields ``'/El Niño/'``." msgstr "" -#: library/urllib.parse.rst:684 +#: library/urllib.parse.rst:693 msgid "" "Replace :samp:`%{xx}` escapes with their single-octet equivalent, and return " "a :class:`bytes` object." msgstr "" -#: library/urllib.parse.rst:689 +#: library/urllib.parse.rst:698 msgid "" "If it is a :class:`str`, unescaped non-ASCII characters in *string* are " "encoded into UTF-8 bytes." msgstr "" -#: library/urllib.parse.rst:692 +#: library/urllib.parse.rst:701 msgid "Example: ``unquote_to_bytes('a%26%EF')`` yields ``b'a&\\xef'``." msgstr "" -#: library/urllib.parse.rst:698 +#: library/urllib.parse.rst:707 msgid "" "Convert a mapping object or a sequence of two-element tuples, which may " "contain :class:`str` or :class:`bytes` objects, to a percent-encoded ASCII " @@ -885,7 +894,7 @@ msgid "" "be encoded to bytes, otherwise it would result in a :exc:`TypeError`." msgstr "" -#: library/urllib.parse.rst:705 +#: library/urllib.parse.rst:714 msgid "" "The resulting string is a series of ``key=value`` pairs separated by ``'&'`` " "characters, where both *key* and *value* are quoted using the *quote_via* " @@ -898,7 +907,7 @@ msgid "" "``quote`` and specify a value for *safe*." msgstr "" -#: library/urllib.parse.rst:715 +#: library/urllib.parse.rst:724 msgid "" "When a sequence of two-element tuples is used as the *query* argument, the " "first element of each tuple is a key and the second is a value. The value " @@ -909,49 +918,49 @@ msgid "" "order of parameter tuples in the sequence." msgstr "" -#: library/urllib.parse.rst:723 +#: library/urllib.parse.rst:732 msgid "" "The *safe*, *encoding*, and *errors* parameters are passed down to " "*quote_via* (the *encoding* and *errors* parameters are only passed when a " "query element is a :class:`str`)." msgstr "" -#: library/urllib.parse.rst:727 +#: library/urllib.parse.rst:736 msgid "" "To reverse this encoding process, :func:`parse_qs` and :func:`parse_qsl` are " "provided in this module to parse query strings into Python data structures." msgstr "" -#: library/urllib.parse.rst:730 +#: library/urllib.parse.rst:739 msgid "" "Refer to :ref:`urllib examples ` to find out how the :func:" "`urllib.parse.urlencode` method can be used for generating the query string " "of a URL or data for a POST request." msgstr "" -#: library/urllib.parse.rst:734 +#: library/urllib.parse.rst:743 msgid "*query* supports bytes and string objects." msgstr "" -#: library/urllib.parse.rst:737 +#: library/urllib.parse.rst:746 msgid "Added the *quote_via* parameter." msgstr "" -#: library/urllib.parse.rst:743 +#: library/urllib.parse.rst:752 msgid "`WHATWG`_ - URL Living standard" msgstr "" -#: library/urllib.parse.rst:744 +#: library/urllib.parse.rst:753 msgid "" "Working Group for the URL Standard that defines URLs, domains, IP addresses, " "the application/x-www-form-urlencoded format, and their API." msgstr "" -#: library/urllib.parse.rst:747 +#: library/urllib.parse.rst:756 msgid ":rfc:`3986` - Uniform Resource Identifiers" msgstr "" -#: library/urllib.parse.rst:748 +#: library/urllib.parse.rst:757 msgid "" "This is the current standard (STD66). Any changes to urllib.parse module " "should conform to this. Certain deviations could be observed, which are " @@ -959,48 +968,48 @@ msgid "" "requirements as commonly observed in major browsers." msgstr "" -#: library/urllib.parse.rst:753 +#: library/urllib.parse.rst:762 msgid ":rfc:`2732` - Format for Literal IPv6 Addresses in URL's." msgstr "" -#: library/urllib.parse.rst:754 +#: library/urllib.parse.rst:763 msgid "This specifies the parsing requirements of IPv6 URLs." msgstr "" -#: library/urllib.parse.rst:756 +#: library/urllib.parse.rst:765 msgid ":rfc:`2396` - Uniform Resource Identifiers (URI): Generic Syntax" msgstr "" -#: library/urllib.parse.rst:757 +#: library/urllib.parse.rst:766 msgid "" "Document describing the generic syntactic requirements for both Uniform " "Resource Names (URNs) and Uniform Resource Locators (URLs)." msgstr "" -#: library/urllib.parse.rst:760 +#: library/urllib.parse.rst:769 msgid ":rfc:`2368` - The mailto URL scheme." msgstr "" -#: library/urllib.parse.rst:761 +#: library/urllib.parse.rst:770 msgid "Parsing requirements for mailto URL schemes." msgstr "" -#: library/urllib.parse.rst:763 +#: library/urllib.parse.rst:772 msgid ":rfc:`1808` - Relative Uniform Resource Locators" msgstr "" -#: library/urllib.parse.rst:764 +#: library/urllib.parse.rst:773 msgid "" "This Request For Comments includes the rules for joining an absolute and a " "relative URL, including a fair number of \"Abnormal Examples\" which govern " "the treatment of border cases." msgstr "" -#: library/urllib.parse.rst:768 +#: library/urllib.parse.rst:777 msgid ":rfc:`1738` - Uniform Resource Locators (URL)" msgstr "" -#: library/urllib.parse.rst:769 +#: library/urllib.parse.rst:778 msgid "This specifies the formal syntax and semantics of absolute URLs." msgstr "" diff --git a/library/urllib.request.po b/library/urllib.request.po index 145b2e9d0..2461a2a3c 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -239,21 +239,38 @@ msgstr "" #: library/urllib.request.rst:163 msgid "" -"Convert the pathname *path* from the local syntax for a path to the form " -"used in the path component of a URL. This does not produce a complete URL. " -"The return value will already be quoted using the :func:`~urllib.parse." -"quote` function." +"Convert the given local path to a ``file:`` URL. This function uses :func:" +"`~urllib.parse.quote` function to encode the path. For historical reasons, " +"the return value omits the ``file:`` scheme prefix. This example shows the " +"function being used on Windows::" msgstr "" -#: library/urllib.request.rst:170 +#: library/urllib.request.rst:168 msgid "" -"Convert the path component *path* from a percent-encoded URL to the local " -"syntax for a path. This does not accept a complete URL. This function " -"uses :func:`~urllib.parse.unquote` to decode *path*." +">>> from urllib.request import pathname2url\n" +">>> path = 'C:\\\\Program Files'\n" +">>> 'file:' + pathname2url(path)\n" +"'file:///C:/Program%20Files'" msgstr "" #: library/urllib.request.rst:176 msgid "" +"Convert the given ``file:`` URL to a local path. This function uses :func:" +"`~urllib.parse.unquote` to decode the URL. For historical reasons, the given " +"value *must* omit the ``file:`` scheme prefix. This example shows the " +"function being used on Windows::" +msgstr "" + +#: library/urllib.request.rst:181 +msgid "" +">>> from urllib.request import url2pathname\n" +">>> url = 'file:///C:/Program%20Files'\n" +">>> url2pathname(url.removeprefix('file:'))\n" +"'C:\\\\Program Files'" +msgstr "" + +#: library/urllib.request.rst:188 +msgid "" "This helper function returns a dictionary of scheme to proxy server URL " "mappings. It scans the environment for variables named ``_proxy``, " "in a case insensitive approach, for all operating systems first, and when it " @@ -262,7 +279,7 @@ msgid "" "uppercase environment variables exist (and disagree), lowercase is preferred." msgstr "" -#: library/urllib.request.rst:186 +#: library/urllib.request.rst:198 msgid "" "If the environment variable ``REQUEST_METHOD`` is set, which usually " "indicates your script is running in a CGI environment, the environment " @@ -273,19 +290,19 @@ msgid "" "(or at least the ``_proxy`` suffix)." msgstr "" -#: library/urllib.request.rst:195 +#: library/urllib.request.rst:207 msgid "The following classes are provided:" msgstr "" -#: library/urllib.request.rst:199 +#: library/urllib.request.rst:211 msgid "This class is an abstraction of a URL request." msgstr "" -#: library/urllib.request.rst:201 +#: library/urllib.request.rst:213 msgid "*url* should be a string containing a valid, properly encoded URL." msgstr "" -#: library/urllib.request.rst:203 +#: library/urllib.request.rst:215 msgid "" "*data* must be an object specifying additional data to send to the server, " "or ``None`` if no such data is needed. Currently HTTP requests are the only " @@ -298,7 +315,7 @@ msgid "" "iterables." msgstr "" -#: library/urllib.request.rst:213 +#: library/urllib.request.rst:225 msgid "" "For an HTTP POST request method, *data* should be a buffer in the standard :" "mimetype:`application/x-www-form-urlencoded` format. The :func:`urllib." @@ -307,7 +324,7 @@ msgid "" "being used as the *data* parameter." msgstr "" -#: library/urllib.request.rst:219 +#: library/urllib.request.rst:231 msgid "" "*headers* should be a dictionary, and will be treated as if :meth:" "`add_header` was called with each key and value as arguments. This is often " @@ -320,7 +337,7 @@ msgid "" "case." msgstr "" -#: library/urllib.request.rst:230 +#: library/urllib.request.rst:242 msgid "" "An appropriate ``Content-Type`` header should be included if the *data* " "argument is present. If this header has not been provided and *data* is not " @@ -328,13 +345,13 @@ msgid "" "as a default." msgstr "" -#: library/urllib.request.rst:235 +#: library/urllib.request.rst:247 msgid "" "The next two arguments are only of interest for correct handling of third-" "party HTTP cookies:" msgstr "" -#: library/urllib.request.rst:238 +#: library/urllib.request.rst:250 msgid "" "*origin_req_host* should be the request-host of the origin transaction, as " "defined by :rfc:`2965`. It defaults to ``http.cookiejar." @@ -344,7 +361,7 @@ msgid "" "for the page containing the image." msgstr "" -#: library/urllib.request.rst:246 +#: library/urllib.request.rst:258 msgid "" "*unverifiable* should indicate whether the request is unverifiable, as " "defined by :rfc:`2965`. It defaults to ``False``. An unverifiable request " @@ -353,7 +370,7 @@ msgid "" "option to approve the automatic fetching of the image, this should be true." msgstr "" -#: library/urllib.request.rst:253 +#: library/urllib.request.rst:265 msgid "" "*method* should be a string that indicates the HTTP request method that will " "be used (e.g. ``'HEAD'``). If provided, its value is stored in the :attr:" @@ -363,7 +380,7 @@ msgid "" "attribute in the class itself." msgstr "" -#: library/urllib.request.rst:261 +#: library/urllib.request.rst:273 msgid "" "The request will not work as expected if the data object is unable to " "deliver its content more than once (e.g. a file or an iterable that can " @@ -373,49 +390,49 @@ msgid "" "library." msgstr "" -#: library/urllib.request.rst:268 +#: library/urllib.request.rst:280 msgid ":attr:`Request.method` argument is added to the Request class." msgstr "" -#: library/urllib.request.rst:271 +#: library/urllib.request.rst:283 msgid "Default :attr:`Request.method` may be indicated at the class level." msgstr "" -#: library/urllib.request.rst:274 +#: library/urllib.request.rst:286 msgid "" "Do not raise an error if the ``Content-Length`` has not been provided and " "*data* is neither ``None`` nor a bytes object. Fall back to use chunked " "transfer encoding instead." msgstr "" -#: library/urllib.request.rst:281 +#: library/urllib.request.rst:293 msgid "" "The :class:`OpenerDirector` class opens URLs via :class:`BaseHandler`\\ s " "chained together. It manages the chaining of handlers, and recovery from " "errors." msgstr "" -#: library/urllib.request.rst:287 +#: library/urllib.request.rst:299 msgid "" "This is the base class for all registered handlers --- and handles only the " "simple mechanics of registration." msgstr "" -#: library/urllib.request.rst:293 +#: library/urllib.request.rst:305 msgid "" "A class which defines a default handler for HTTP error responses; all " "responses are turned into :exc:`~urllib.error.HTTPError` exceptions." msgstr "" -#: library/urllib.request.rst:299 +#: library/urllib.request.rst:311 msgid "A class to handle redirections." msgstr "" -#: library/urllib.request.rst:304 +#: library/urllib.request.rst:316 msgid "A class to handle HTTP Cookies." msgstr "" -#: library/urllib.request.rst:309 +#: library/urllib.request.rst:321 msgid "" "Cause requests to go through a proxy. If *proxies* is given, it must be a " "dictionary mapping protocol names to URLs of proxies. The default is to read " @@ -426,11 +443,11 @@ msgid "" "Configuration Framework." msgstr "" -#: library/urllib.request.rst:317 +#: library/urllib.request.rst:329 msgid "To disable autodetected proxy pass an empty dictionary." msgstr "" -#: library/urllib.request.rst:319 +#: library/urllib.request.rst:331 msgid "" "The :envvar:`no_proxy` environment variable can be used to specify hosts " "which shouldn't be reached via proxy; if set, it should be a comma-separated " @@ -438,24 +455,24 @@ msgid "" "``cern.ch,ncsa.uiuc.edu,some.host:8080``." msgstr "" -#: library/urllib.request.rst:326 +#: library/urllib.request.rst:338 msgid "" "``HTTP_PROXY`` will be ignored if a variable ``REQUEST_METHOD`` is set; see " "the documentation on :func:`~urllib.request.getproxies`." msgstr "" -#: library/urllib.request.rst:332 +#: library/urllib.request.rst:344 msgid "Keep a database of ``(realm, uri) -> (user, password)`` mappings." msgstr "" -#: library/urllib.request.rst:337 +#: library/urllib.request.rst:349 msgid "" "Keep a database of ``(realm, uri) -> (user, password)`` mappings. A realm " "of ``None`` is considered a catch-all realm, which is searched if no other " "realm fits." msgstr "" -#: library/urllib.request.rst:344 +#: library/urllib.request.rst:356 msgid "" "A variant of :class:`HTTPPasswordMgrWithDefaultRealm` that also has a " "database of ``uri -> is_authenticated`` mappings. Can be used by a " @@ -463,7 +480,7 @@ msgid "" "immediately instead of waiting for a ``401`` response first." msgstr "" -#: library/urllib.request.rst:354 +#: library/urllib.request.rst:366 msgid "" "This is a mixin class that helps with HTTP authentication, both to the " "remote host and to a proxy. *password_mgr*, if given, should be something " @@ -482,11 +499,11 @@ msgid "" "will automatically include the authentication credentials." msgstr "" -#: library/urllib.request.rst:371 +#: library/urllib.request.rst:383 msgid "Added ``is_authenticated`` support." msgstr "" -#: library/urllib.request.rst:377 +#: library/urllib.request.rst:389 msgid "" "Handle authentication with the remote host. *password_mgr*, if given, should " "be something that is compatible with :class:`HTTPPasswordMgr`; refer to " @@ -495,7 +512,7 @@ msgid "" "presented with a wrong Authentication scheme." msgstr "" -#: library/urllib.request.rst:420 +#: library/urllib.request.rst:432 msgid "" "Handle authentication with the proxy. *password_mgr*, if given, should be " "something that is compatible with :class:`HTTPPasswordMgr`; refer to " @@ -503,7 +520,7 @@ msgid "" "be supported." msgstr "" -#: library/urllib.request.rst:394 +#: library/urllib.request.rst:406 msgid "" "This is a mixin class that helps with HTTP authentication, both to the " "remote host and to a proxy. *password_mgr*, if given, should be something " @@ -511,7 +528,7 @@ msgid "" "`http-password-mgr` for information on the interface that must be supported." msgstr "" -#: library/urllib.request.rst:403 +#: library/urllib.request.rst:415 msgid "" "Handle authentication with the remote host. *password_mgr*, if given, should " "be something that is compatible with :class:`HTTPPasswordMgr`; refer to " @@ -524,108 +541,108 @@ msgid "" "Digest or Basic." msgstr "" -#: library/urllib.request.rst:413 +#: library/urllib.request.rst:425 msgid "Raise :exc:`ValueError` on unsupported Authentication Scheme." msgstr "" -#: library/urllib.request.rst:428 +#: library/urllib.request.rst:440 msgid "A class to handle opening of HTTP URLs." msgstr "" -#: library/urllib.request.rst:433 +#: library/urllib.request.rst:445 msgid "" "A class to handle opening of HTTPS URLs. *context* and *check_hostname* " "have the same meaning as in :class:`http.client.HTTPSConnection`." msgstr "" -#: library/urllib.request.rst:436 +#: library/urllib.request.rst:448 msgid "*context* and *check_hostname* were added." msgstr "" -#: library/urllib.request.rst:442 +#: library/urllib.request.rst:454 msgid "Open local files." msgstr "" -#: library/urllib.request.rst:446 +#: library/urllib.request.rst:458 msgid "Open data URLs." msgstr "" -#: library/urllib.request.rst:452 +#: library/urllib.request.rst:464 msgid "Open FTP URLs." msgstr "" -#: library/urllib.request.rst:457 +#: library/urllib.request.rst:469 msgid "" "Open FTP URLs, keeping a cache of open FTP connections to minimize delays." msgstr "" -#: library/urllib.request.rst:462 +#: library/urllib.request.rst:474 msgid "A catch-all class to handle unknown URLs." msgstr "" -#: library/urllib.request.rst:1173 +#: library/urllib.request.rst:1185 msgid "Process HTTP error responses." msgstr "" -#: library/urllib.request.rst:473 +#: library/urllib.request.rst:485 msgid "Request Objects" msgstr "" -#: library/urllib.request.rst:475 +#: library/urllib.request.rst:487 msgid "" "The following methods describe :class:`Request`'s public interface, and so " "all may be overridden in subclasses. It also defines several public " "attributes that can be used by clients to inspect the parsed request." msgstr "" -#: library/urllib.request.rst:482 +#: library/urllib.request.rst:494 msgid "The original URL passed to the constructor." msgstr "" -#: library/urllib.request.rst:486 +#: library/urllib.request.rst:498 msgid "" "Request.full_url is a property with setter, getter and a deleter. Getting :" "attr:`~Request.full_url` returns the original request URL with the fragment, " "if it was present." msgstr "" -#: library/urllib.request.rst:492 +#: library/urllib.request.rst:504 msgid "The URI scheme." msgstr "" -#: library/urllib.request.rst:496 +#: library/urllib.request.rst:508 msgid "" "The URI authority, typically a host, but may also contain a port separated " "by a colon." msgstr "" -#: library/urllib.request.rst:501 +#: library/urllib.request.rst:513 msgid "The original host for the request, without port." msgstr "" -#: library/urllib.request.rst:505 +#: library/urllib.request.rst:517 msgid "" "The URI path. If the :class:`Request` uses a proxy, then selector will be " "the full URL that is passed to the proxy." msgstr "" -#: library/urllib.request.rst:510 +#: library/urllib.request.rst:522 msgid "The entity body for the request, or ``None`` if not specified." msgstr "" -#: library/urllib.request.rst:512 +#: library/urllib.request.rst:524 msgid "" "Changing value of :attr:`Request.data` now deletes \"Content-Length\" header " "if it was previously set or calculated." msgstr "" -#: library/urllib.request.rst:518 +#: library/urllib.request.rst:530 msgid "" "boolean, indicates whether the request is unverifiable as defined by :rfc:" "`2965`." msgstr "" -#: library/urllib.request.rst:523 +#: library/urllib.request.rst:535 msgid "" "The HTTP request method to use. By default its value is :const:`None`, " "which means that :meth:`~Request.get_method` will do its normal computation " @@ -636,13 +653,13 @@ msgid "" "argument." msgstr "" -#: library/urllib.request.rst:533 +#: library/urllib.request.rst:545 msgid "" "A default value can now be set in subclasses; previously it could only be " "set via the constructor argument." msgstr "" -#: library/urllib.request.rst:540 +#: library/urllib.request.rst:552 msgid "" "Return a string indicating the HTTP request method. If :attr:`Request." "method` is not ``None``, return its value, otherwise return ``'GET'`` if :" @@ -650,11 +667,11 @@ msgid "" "meaningful for HTTP requests." msgstr "" -#: library/urllib.request.rst:545 +#: library/urllib.request.rst:557 msgid "get_method now looks at the value of :attr:`Request.method`." msgstr "" -#: library/urllib.request.rst:551 +#: library/urllib.request.rst:563 msgid "" "Add another header to the request. Headers are currently ignored by all " "handlers except HTTP handlers, where they are added to the list of headers " @@ -666,64 +683,64 @@ msgid "" "headers added using this method are also added to redirected requests." msgstr "" -#: library/urllib.request.rst:563 +#: library/urllib.request.rst:575 msgid "Add a header that will not be added to a redirected request." msgstr "" -#: library/urllib.request.rst:568 +#: library/urllib.request.rst:580 msgid "" "Return whether the instance has the named header (checks both regular and " "unredirected)." msgstr "" -#: library/urllib.request.rst:574 +#: library/urllib.request.rst:586 msgid "" "Remove named header from the request instance (both from regular and " "unredirected headers)." msgstr "" -#: library/urllib.request.rst:582 +#: library/urllib.request.rst:594 msgid "Return the URL given in the constructor." msgstr "" -#: library/urllib.request.rst:586 +#: library/urllib.request.rst:598 msgid "Returns :attr:`Request.full_url`" msgstr "" -#: library/urllib.request.rst:591 +#: library/urllib.request.rst:603 msgid "" "Prepare the request by connecting to a proxy server. The *host* and *type* " "will replace those of the instance, and the instance's selector will be the " "original URL given in the constructor." msgstr "" -#: library/urllib.request.rst:598 +#: library/urllib.request.rst:610 msgid "" "Return the value of the given header. If the header is not present, return " "the default value." msgstr "" -#: library/urllib.request.rst:604 +#: library/urllib.request.rst:616 msgid "" "Return a list of tuples (header_name, header_value) of the Request headers." msgstr "" -#: library/urllib.request.rst:606 +#: library/urllib.request.rst:618 msgid "" "The request methods add_data, has_data, get_data, get_type, get_host, " "get_selector, get_origin_req_host and is_unverifiable that were deprecated " "since 3.3 have been removed." msgstr "" -#: library/urllib.request.rst:615 +#: library/urllib.request.rst:627 msgid "OpenerDirector Objects" msgstr "" -#: library/urllib.request.rst:617 +#: library/urllib.request.rst:629 msgid ":class:`OpenerDirector` instances have the following methods:" msgstr "" -#: library/urllib.request.rst:622 +#: library/urllib.request.rst:634 msgid "" "*handler* should be an instance of :class:`BaseHandler`. The following " "methods are searched, and added to the possible chains (note that HTTP " @@ -734,53 +751,53 @@ msgid "" "`http_error_404` would handle HTTP 404 errors." msgstr "" -#: library/urllib.request.rst:630 +#: library/urllib.request.rst:642 msgid "" ":meth:`!_open` --- signal that the handler knows how to open " "*protocol* URLs." msgstr "" -#: library/urllib.request.rst:633 +#: library/urllib.request.rst:645 msgid "See |protocol_open|_ for more information." msgstr "" -#: library/urllib.request.rst:635 +#: library/urllib.request.rst:647 msgid "" ":meth:`!http_error_\\` --- signal that the handler knows how to " "handle HTTP errors with HTTP error code *type*." msgstr "" -#: library/urllib.request.rst:638 +#: library/urllib.request.rst:650 msgid "See |http_error_nnn|_ for more information." msgstr "" -#: library/urllib.request.rst:640 +#: library/urllib.request.rst:652 msgid "" ":meth:`!_error` --- signal that the handler knows how to handle " "errors from (non-\\ ``http``) *protocol*." msgstr "" -#: library/urllib.request.rst:643 +#: library/urllib.request.rst:655 msgid "" ":meth:`!_request` --- signal that the handler knows how to pre-" "process *protocol* requests." msgstr "" -#: library/urllib.request.rst:646 +#: library/urllib.request.rst:658 msgid "See |protocol_request|_ for more information." msgstr "" -#: library/urllib.request.rst:648 +#: library/urllib.request.rst:660 msgid "" ":meth:`!_response` --- signal that the handler knows how to post-" "process *protocol* responses." msgstr "" -#: library/urllib.request.rst:651 +#: library/urllib.request.rst:663 msgid "See |protocol_response|_ for more information." msgstr "" -#: library/urllib.request.rst:660 +#: library/urllib.request.rst:672 msgid "" "Open the given *url* (which can be a request object or a string), optionally " "passing the given *data*. Arguments, return values and exceptions raised are " @@ -792,7 +809,7 @@ msgid "" "HTTP, HTTPS and FTP connections." msgstr "" -#: library/urllib.request.rst:672 +#: library/urllib.request.rst:684 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 " @@ -801,28 +818,28 @@ msgid "" "http_error_\\` methods of the handler classes." msgstr "" -#: library/urllib.request.rst:678 +#: library/urllib.request.rst:690 msgid "" "Return values and exceptions raised are the same as those of :func:`urlopen`." msgstr "" -#: library/urllib.request.rst:680 +#: library/urllib.request.rst:692 msgid "OpenerDirector objects open URLs in three stages:" msgstr "" -#: library/urllib.request.rst:682 +#: library/urllib.request.rst:694 msgid "" "The order in which these methods are called within each stage is determined " "by sorting the handler instances." msgstr "" -#: library/urllib.request.rst:685 +#: library/urllib.request.rst:697 msgid "" "Every handler with a method named like :meth:`!_request` has that " "method called to pre-process the request." msgstr "" -#: library/urllib.request.rst:688 +#: library/urllib.request.rst:700 msgid "" "Handlers with a method named like :meth:`!_open` are called to " "handle the request. This stage ends when a handler either returns a non-\\ :" @@ -830,7 +847,7 @@ msgid "" "`~urllib.error.URLError`). Exceptions are allowed to propagate." msgstr "" -#: library/urllib.request.rst:693 +#: library/urllib.request.rst:705 msgid "" "In fact, the above algorithm is first tried for methods named :meth:" "`~BaseHandler.default_open`. If all such methods return :const:`None`, the " @@ -839,64 +856,64 @@ msgid "" "named :meth:`~BaseHandler.unknown_open`." msgstr "" -#: library/urllib.request.rst:699 +#: library/urllib.request.rst:711 msgid "" "Note that the implementation of these methods may involve calls of the " "parent :class:`OpenerDirector` instance's :meth:`~OpenerDirector.open` and :" "meth:`~OpenerDirector.error` methods." msgstr "" -#: library/urllib.request.rst:703 +#: library/urllib.request.rst:715 msgid "" "Every handler with a method named like :meth:`!_response` has that " "method called to post-process the response." msgstr "" -#: library/urllib.request.rst:710 +#: library/urllib.request.rst:722 msgid "BaseHandler Objects" msgstr "" -#: library/urllib.request.rst:712 +#: library/urllib.request.rst:724 msgid "" ":class:`BaseHandler` objects provide a couple of methods that are directly " "useful, and others that are meant to be used by derived classes. These are " "intended for direct use:" msgstr "" -#: library/urllib.request.rst:719 +#: library/urllib.request.rst:731 msgid "Add a director as parent." msgstr "" -#: library/urllib.request.rst:724 +#: library/urllib.request.rst:736 msgid "Remove any parents." msgstr "" -#: library/urllib.request.rst:726 +#: library/urllib.request.rst:738 msgid "" "The following attribute and methods should only be used by classes derived " "from :class:`BaseHandler`." msgstr "" -#: library/urllib.request.rst:731 +#: library/urllib.request.rst:743 msgid "" "The convention has been adopted that subclasses defining :meth:`!" "_request` or :meth:`!_response` methods are named :class:" "`!\\*Processor`; all others are named :class:`!\\*Handler`." msgstr "" -#: library/urllib.request.rst:738 +#: library/urllib.request.rst:750 msgid "" "A valid :class:`OpenerDirector`, which can be used to open using a different " "protocol, or handle errors." msgstr "" -#: library/urllib.request.rst:744 +#: library/urllib.request.rst:756 msgid "" "This method is *not* defined in :class:`BaseHandler`, but subclasses should " "define it if they want to catch all URLs." msgstr "" -#: library/urllib.request.rst:747 +#: library/urllib.request.rst:759 msgid "" "This method, if implemented, will be called by the parent :class:" "`OpenerDirector`. It should return a file-like object as described in the " @@ -906,38 +923,38 @@ msgid "" "`MemoryError` should not be mapped to :exc:`~urllib.error.URLError`)." msgstr "" -#: library/urllib.request.rst:754 +#: library/urllib.request.rst:766 msgid "This method will be called before any protocol-specific open method." msgstr "" -#: library/urllib.request.rst:761 +#: library/urllib.request.rst:773 msgid "" "This method is *not* defined in :class:`BaseHandler`, but subclasses should " "define it if they want to handle URLs with the given protocol." msgstr "" -#: library/urllib.request.rst:764 +#: library/urllib.request.rst:776 msgid "" "This method, if defined, will be called by the parent :class:" "`OpenerDirector`. Return values should be the same as for :meth:" "`~BaseHandler.default_open`." msgstr "" -#: library/urllib.request.rst:770 +#: library/urllib.request.rst:782 msgid "" "This method is *not* defined in :class:`BaseHandler`, but subclasses should " "define it if they want to catch all URLs with no specific registered handler " "to open it." msgstr "" -#: library/urllib.request.rst:774 +#: library/urllib.request.rst:786 msgid "" "This method, if implemented, will be called by the :attr:`parent` :class:" "`OpenerDirector`. Return values should be the same as for :meth:" "`default_open`." msgstr "" -#: library/urllib.request.rst:781 +#: library/urllib.request.rst:793 msgid "" "This method is *not* defined in :class:`BaseHandler`, but subclasses should " "override it if they intend to provide a catch-all for otherwise unhandled " @@ -946,7 +963,7 @@ msgid "" "other circumstances." msgstr "" -#: library/urllib.request.rst:786 +#: library/urllib.request.rst:798 msgid "" "*req* will be a :class:`Request` object, *fp* will be a file-like object " "with the HTTP error body, *code* will be the three-digit code of the error, " @@ -954,49 +971,49 @@ msgid "" "mapping object with the headers of the error." msgstr "" -#: library/urllib.request.rst:791 +#: library/urllib.request.rst:803 msgid "" "Return values and exceptions raised should be the same as those of :func:" "`urlopen`." msgstr "" -#: library/urllib.request.rst:798 +#: library/urllib.request.rst:810 msgid "" "*nnn* should be a three-digit HTTP error code. This method is also not " "defined in :class:`BaseHandler`, but will be called, if it exists, on an " "instance of a subclass, when an HTTP error with code *nnn* occurs." msgstr "" -#: library/urllib.request.rst:802 +#: library/urllib.request.rst:814 msgid "Subclasses should override this method to handle specific HTTP errors." msgstr "" -#: library/urllib.request.rst:804 +#: library/urllib.request.rst:816 msgid "" "Arguments, return values and exceptions raised should be the same as for :" "meth:`~BaseHandler.http_error_default`." msgstr "" -#: library/urllib.request.rst:812 +#: library/urllib.request.rst:824 msgid "" "This method is *not* defined in :class:`BaseHandler`, but subclasses should " "define it if they want to pre-process requests of the given protocol." msgstr "" -#: library/urllib.request.rst:815 +#: library/urllib.request.rst:827 msgid "" "This method, if defined, will be called by the parent :class:" "`OpenerDirector`. *req* will be a :class:`Request` object. The return value " "should be a :class:`Request` object." msgstr "" -#: library/urllib.request.rst:824 +#: library/urllib.request.rst:836 msgid "" "This method is *not* defined in :class:`BaseHandler`, but subclasses should " "define it if they want to post-process responses of the given protocol." msgstr "" -#: library/urllib.request.rst:827 +#: library/urllib.request.rst:839 msgid "" "This method, if defined, will be called by the parent :class:" "`OpenerDirector`. *req* will be a :class:`Request` object. *response* will " @@ -1005,25 +1022,25 @@ msgid "" "return value of :func:`urlopen`." msgstr "" -#: library/urllib.request.rst:837 +#: library/urllib.request.rst:849 msgid "HTTPRedirectHandler Objects" msgstr "" -#: library/urllib.request.rst:841 +#: library/urllib.request.rst:853 msgid "" "Some HTTP redirections require action from this module's client code. If " "this is the case, :exc:`~urllib.error.HTTPError` is raised. See :rfc:`2616` " "for details of the precise meanings of the various redirection codes." msgstr "" -#: library/urllib.request.rst:845 +#: library/urllib.request.rst:857 msgid "" "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:852 +#: library/urllib.request.rst:864 msgid "" "Return a :class:`Request` or ``None`` in response to a redirect. This is " "called by the default implementations of the :meth:`!http_error_30\\*` " @@ -1034,7 +1051,7 @@ msgid "" "URL, or return ``None`` if you can't but another handler might." msgstr "" -#: library/urllib.request.rst:862 +#: library/urllib.request.rst:874 msgid "" "The default implementation of this method does not strictly follow :rfc:" "`2616`, which says that 301 and 302 responses to ``POST`` requests must not " @@ -1043,54 +1060,54 @@ msgid "" "POST to a ``GET``, and the default implementation reproduces this behavior." msgstr "" -#: library/urllib.request.rst:871 +#: library/urllib.request.rst:883 msgid "" "Redirect to the ``Location:`` or ``URI:`` URL. This method is called by the " "parent :class:`OpenerDirector` when getting an HTTP 'moved permanently' " "response." msgstr "" -#: library/urllib.request.rst:877 +#: library/urllib.request.rst:889 msgid "" "The same as :meth:`http_error_301`, but called for the 'found' response." msgstr "" -#: library/urllib.request.rst:882 +#: library/urllib.request.rst:894 msgid "" "The same as :meth:`http_error_301`, but called for the 'see other' response." msgstr "" -#: library/urllib.request.rst:887 +#: library/urllib.request.rst:899 msgid "" "The same as :meth:`http_error_301`, but called for the 'temporary redirect' " "response. It does not allow changing the request method from ``POST`` to " "``GET``." msgstr "" -#: library/urllib.request.rst:894 +#: library/urllib.request.rst:906 msgid "" "The same as :meth:`http_error_301`, but called for the 'permanent redirect' " "response. It does not allow changing the request method from ``POST`` to " "``GET``." msgstr "" -#: library/urllib.request.rst:904 +#: library/urllib.request.rst:916 msgid "HTTPCookieProcessor Objects" msgstr "" -#: library/urllib.request.rst:906 +#: library/urllib.request.rst:918 msgid ":class:`HTTPCookieProcessor` instances have one attribute:" msgstr "" -#: library/urllib.request.rst:910 +#: library/urllib.request.rst:922 msgid "The :class:`http.cookiejar.CookieJar` in which cookies are stored." msgstr "" -#: library/urllib.request.rst:916 +#: library/urllib.request.rst:928 msgid "ProxyHandler Objects" msgstr "" -#: library/urllib.request.rst:922 +#: library/urllib.request.rst:934 msgid "" "The :class:`ProxyHandler` will have a method :meth:`!_open` for " "every *protocol* which has a proxy in the *proxies* dictionary given in the " @@ -1099,17 +1116,17 @@ msgid "" "actually execute the protocol." msgstr "" -#: library/urllib.request.rst:932 +#: library/urllib.request.rst:944 msgid "HTTPPasswordMgr Objects" msgstr "" -#: library/urllib.request.rst:934 +#: library/urllib.request.rst:946 msgid "" "These methods are available on :class:`HTTPPasswordMgr` and :class:" "`HTTPPasswordMgrWithDefaultRealm` objects." msgstr "" -#: library/urllib.request.rst:940 +#: library/urllib.request.rst:952 msgid "" "*uri* can be either a single URI, or a sequence of URIs. *realm*, *user* and " "*passwd* must be strings. This causes ``(user, passwd)`` to be used as " @@ -1117,30 +1134,30 @@ msgid "" "of the given URIs is given." msgstr "" -#: library/urllib.request.rst:948 +#: library/urllib.request.rst:960 msgid "" "Get user/password for given realm and URI, if any. This method will return " "``(None, None)`` if there is no matching user/password." msgstr "" -#: library/urllib.request.rst:951 +#: library/urllib.request.rst:963 msgid "" "For :class:`HTTPPasswordMgrWithDefaultRealm` objects, the realm ``None`` " "will be searched if the given *realm* has no matching user/password." msgstr "" -#: library/urllib.request.rst:958 +#: library/urllib.request.rst:970 msgid "HTTPPasswordMgrWithPriorAuth Objects" msgstr "" -#: library/urllib.request.rst:960 +#: library/urllib.request.rst:972 msgid "" "This password manager extends :class:`HTTPPasswordMgrWithDefaultRealm` to " "support tracking URIs for which authentication credentials should always be " "sent." msgstr "" -#: library/urllib.request.rst:967 +#: library/urllib.request.rst:979 msgid "" "*realm*, *uri*, *user*, *passwd* are as for :meth:`HTTPPasswordMgr." "add_password`. *is_authenticated* sets the initial value of the " @@ -1148,25 +1165,25 @@ msgid "" "*is_authenticated* is specified as ``True``, *realm* is ignored." msgstr "" -#: library/urllib.request.rst:975 +#: library/urllib.request.rst:987 msgid "Same as for :class:`HTTPPasswordMgrWithDefaultRealm` objects" msgstr "" -#: library/urllib.request.rst:981 +#: library/urllib.request.rst:993 msgid "" "Update the ``is_authenticated`` flag for the given *uri* or list of URIs." msgstr "" -#: library/urllib.request.rst:987 +#: library/urllib.request.rst:999 msgid "" "Returns the current state of the ``is_authenticated`` flag for the given URI." msgstr "" -#: library/urllib.request.rst:994 +#: library/urllib.request.rst:1006 msgid "AbstractBasicAuthHandler Objects" msgstr "" -#: library/urllib.request.rst:999 +#: library/urllib.request.rst:1011 msgid "" "Handle an authentication request by getting a user/password pair, and re-" "trying the request. *authreq* should be the name of the header where the " @@ -1175,7 +1192,7 @@ msgid "" "`Request` object, and *headers* should be the error headers." msgstr "" -#: library/urllib.request.rst:1005 +#: library/urllib.request.rst:1017 msgid "" "*host* is either an authority (e.g. ``\"python.org\"``) or a URL containing " "an authority component (e.g. ``\"http://python.org/\"``). In either case, " @@ -1183,24 +1200,24 @@ msgid "" "and ``\"python.org:80\"`` are fine, ``\"joe:password@python.org\"`` is not)." msgstr "" -#: library/urllib.request.rst:1014 +#: library/urllib.request.rst:1026 msgid "HTTPBasicAuthHandler Objects" msgstr "" -#: library/urllib.request.rst:1019 library/urllib.request.rst:1030 -#: library/urllib.request.rst:1055 library/urllib.request.rst:1066 +#: library/urllib.request.rst:1031 library/urllib.request.rst:1042 +#: library/urllib.request.rst:1067 library/urllib.request.rst:1078 msgid "Retry the request with authentication information, if available." msgstr "" -#: library/urllib.request.rst:1025 +#: library/urllib.request.rst:1037 msgid "ProxyBasicAuthHandler Objects" msgstr "" -#: library/urllib.request.rst:1036 +#: library/urllib.request.rst:1048 msgid "AbstractDigestAuthHandler Objects" msgstr "" -#: library/urllib.request.rst:1041 +#: library/urllib.request.rst:1053 msgid "" "*authreq* should be the name of the header where the information about the " "realm is included in the request, *host* should be the host to authenticate " @@ -1208,55 +1225,55 @@ msgid "" "should be the error headers." msgstr "" -#: library/urllib.request.rst:1050 +#: library/urllib.request.rst:1062 msgid "HTTPDigestAuthHandler Objects" msgstr "" -#: library/urllib.request.rst:1061 +#: library/urllib.request.rst:1073 msgid "ProxyDigestAuthHandler Objects" msgstr "" -#: library/urllib.request.rst:1072 +#: library/urllib.request.rst:1084 msgid "HTTPHandler Objects" msgstr "" -#: library/urllib.request.rst:1077 +#: library/urllib.request.rst:1089 msgid "" "Send an HTTP request, which can be either GET or POST, depending on ``req." "has_data()``." msgstr "" -#: library/urllib.request.rst:1084 +#: library/urllib.request.rst:1096 msgid "HTTPSHandler Objects" msgstr "" -#: library/urllib.request.rst:1089 +#: library/urllib.request.rst:1101 msgid "" "Send an HTTPS request, which can be either GET or POST, depending on ``req." "has_data()``." msgstr "" -#: library/urllib.request.rst:1096 +#: library/urllib.request.rst:1108 msgid "FileHandler Objects" msgstr "" -#: library/urllib.request.rst:1101 +#: library/urllib.request.rst:1113 msgid "" "Open the file locally, if there is no host name, or the host name is " "``'localhost'``." msgstr "" -#: library/urllib.request.rst:1104 +#: library/urllib.request.rst:1116 msgid "" "This method is applicable only for local hostnames. When a remote hostname " "is given, a :exc:`~urllib.error.URLError` is raised." msgstr "" -#: library/urllib.request.rst:1112 +#: library/urllib.request.rst:1124 msgid "DataHandler Objects" msgstr "" -#: library/urllib.request.rst:1116 +#: library/urllib.request.rst:1128 msgid "" "Read a data URL. This kind of URL contains the content encoded in the URL " "itself. The data URL syntax is specified in :rfc:`2397`. This implementation " @@ -1266,51 +1283,51 @@ msgid "" "implementation will raise a :exc:`ValueError` in that case." msgstr "" -#: library/urllib.request.rst:1127 +#: library/urllib.request.rst:1139 msgid "FTPHandler Objects" msgstr "" -#: library/urllib.request.rst:1132 +#: library/urllib.request.rst:1144 msgid "" "Open the FTP file indicated by *req*. The login is always done with empty " "username and password." msgstr "" -#: library/urllib.request.rst:1139 +#: library/urllib.request.rst:1151 msgid "CacheFTPHandler Objects" msgstr "" -#: library/urllib.request.rst:1141 +#: library/urllib.request.rst:1153 msgid "" ":class:`CacheFTPHandler` objects are :class:`FTPHandler` objects with the " "following additional methods:" msgstr "" -#: library/urllib.request.rst:1147 +#: library/urllib.request.rst:1159 msgid "Set timeout of connections to *t* seconds." msgstr "" -#: library/urllib.request.rst:1152 +#: library/urllib.request.rst:1164 msgid "Set maximum number of cached connections to *m*." msgstr "" -#: library/urllib.request.rst:1158 +#: library/urllib.request.rst:1170 msgid "UnknownHandler Objects" msgstr "" -#: library/urllib.request.rst:1163 +#: library/urllib.request.rst:1175 msgid "Raise a :exc:`~urllib.error.URLError` exception." msgstr "" -#: library/urllib.request.rst:1169 +#: library/urllib.request.rst:1181 msgid "HTTPErrorProcessor Objects" msgstr "" -#: library/urllib.request.rst:1175 +#: library/urllib.request.rst:1187 msgid "For 200 error codes, the response object is returned immediately." msgstr "" -#: library/urllib.request.rst:1177 +#: library/urllib.request.rst:1189 msgid "" "For non-200 error codes, this simply passes the job on to the :meth:`!" "http_error_\\` handler methods, via :meth:`OpenerDirector.error`. " @@ -1318,31 +1335,31 @@ msgid "" "error.HTTPError` if no other handler handles the error." msgstr "" -#: library/urllib.request.rst:1185 +#: library/urllib.request.rst:1197 msgid "Process HTTPS error responses." msgstr "" -#: library/urllib.request.rst:1187 +#: library/urllib.request.rst:1199 msgid "The behavior is same as :meth:`http_response`." msgstr "" -#: library/urllib.request.rst:1193 +#: library/urllib.request.rst:1205 msgid "Examples" msgstr "" -#: library/urllib.request.rst:1195 +#: library/urllib.request.rst:1207 msgid "" "In addition to the examples below, more examples are given in :ref:`urllib-" "howto`." msgstr "" -#: library/urllib.request.rst:1198 +#: library/urllib.request.rst:1210 msgid "" "This example gets the python.org main page and displays the first 300 bytes " "of it. ::" msgstr "" -#: library/urllib.request.rst:1201 +#: library/urllib.request.rst:1213 msgid "" ">>> import urllib.request\n" ">>> with urllib.request.urlopen('http://www.python.org/') as f:\n" @@ -1357,7 +1374,7 @@ msgid "" "Python Programming '" msgstr "" -#: library/urllib.request.rst:1211 +#: library/urllib.request.rst:1223 msgid "" "Note that urlopen returns a bytes object. This is because there is no way " "for urlopen to automatically determine the encoding of the byte stream it " @@ -1366,20 +1383,20 @@ msgid "" "appropriate encoding." msgstr "" -#: library/urllib.request.rst:1217 +#: library/urllib.request.rst:1229 msgid "" "The following W3C document, https://www.w3.org/International/O-charset\\ , " "lists the various ways in which an (X)HTML or an XML document could have " "specified its encoding information." msgstr "" -#: library/urllib.request.rst:1221 +#: library/urllib.request.rst:1233 msgid "" "As the python.org website uses *utf-8* encoding as specified in its meta " "tag, we will use the same for decoding the bytes object. ::" msgstr "" -#: library/urllib.request.rst:1224 +#: library/urllib.request.rst:1236 msgid "" ">>> with urllib.request.urlopen('http://www.python.org/') as f:\n" "... print(f.read(100).decode('utf-8'))\n" @@ -1388,13 +1405,13 @@ msgid "" "\"http://www.w3.org/TR/xhtml1/DTD/xhtm" msgstr "" -#: library/urllib.request.rst:1230 +#: library/urllib.request.rst:1242 msgid "" "It is also possible to achieve the same result without using the :term:" "`context manager` approach. ::" msgstr "" -#: library/urllib.request.rst:1233 +#: library/urllib.request.rst:1245 msgid "" ">>> import urllib.request\n" ">>> f = urllib.request.urlopen('http://www.python.org/')\n" @@ -1403,14 +1420,14 @@ msgid "" "\"http://www.w3.org/TR/xhtml1/DTD/xhtm" msgstr "" -#: library/urllib.request.rst:1239 +#: library/urllib.request.rst:1251 msgid "" "In the following example, we are sending a data-stream to the stdin of a CGI " "and reading the data it returns to us. Note that this example will only work " "when the Python installation supports SSL. ::" msgstr "" -#: library/urllib.request.rst:1243 +#: library/urllib.request.rst:1255 msgid "" ">>> import urllib.request\n" ">>> req = urllib.request.Request(url='https://localhost/cgi-bin/test.cgi',\n" @@ -1421,11 +1438,11 @@ msgid "" "Got Data: \"This data is passed to stdin of the CGI\"" msgstr "" -#: library/urllib.request.rst:1251 +#: library/urllib.request.rst:1263 msgid "The code for the sample CGI used in the above example is::" msgstr "" -#: library/urllib.request.rst:1253 +#: library/urllib.request.rst:1265 msgid "" "#!/usr/bin/env python\n" "import sys\n" @@ -1433,11 +1450,11 @@ msgid "" "print('Content-type: text/plain\\n\\nGot Data: \"%s\"' % data)" msgstr "" -#: library/urllib.request.rst:1258 +#: library/urllib.request.rst:1270 msgid "Here is an example of doing a ``PUT`` request using :class:`Request`::" msgstr "" -#: library/urllib.request.rst:1260 +#: library/urllib.request.rst:1272 msgid "" "import urllib.request\n" "DATA = b'some data'\n" @@ -1449,11 +1466,11 @@ msgid "" "print(f.reason)" msgstr "" -#: library/urllib.request.rst:1268 +#: library/urllib.request.rst:1280 msgid "Use of Basic HTTP Authentication::" msgstr "" -#: library/urllib.request.rst:1270 +#: library/urllib.request.rst:1282 msgid "" "import urllib.request\n" "# Create an OpenerDirector with support for Basic HTTP Authentication...\n" @@ -1468,7 +1485,7 @@ msgid "" "urllib.request.urlopen('http://www.example.com/login.html')" msgstr "" -#: library/urllib.request.rst:1282 +#: library/urllib.request.rst:1294 msgid "" ":func:`build_opener` provides many handlers by default, including a :class:" "`ProxyHandler`. By default, :class:`ProxyHandler` uses the environment " @@ -1477,14 +1494,14 @@ msgid "" "read to obtain the HTTP proxy's URL." msgstr "" -#: library/urllib.request.rst:1288 +#: library/urllib.request.rst:1300 msgid "" "This example replaces the default :class:`ProxyHandler` with one that uses " "programmatically supplied proxy URLs, and adds proxy authorization support " "with :class:`ProxyBasicAuthHandler`. ::" msgstr "" -#: library/urllib.request.rst:1292 +#: library/urllib.request.rst:1304 msgid "" "proxy_handler = urllib.request.ProxyHandler({'http': 'http://www.example." "com:3128/'})\n" @@ -1496,15 +1513,15 @@ msgid "" "opener.open('http://www.example.com/login.html')" msgstr "" -#: library/urllib.request.rst:1300 +#: library/urllib.request.rst:1312 msgid "Adding HTTP headers:" msgstr "" -#: library/urllib.request.rst:1302 +#: library/urllib.request.rst:1314 msgid "Use the *headers* argument to the :class:`Request` constructor, or::" msgstr "" -#: library/urllib.request.rst:1304 +#: library/urllib.request.rst:1316 msgid "" "import urllib.request\n" "req = urllib.request.Request('http://www.example.com/')\n" @@ -1514,13 +1531,13 @@ msgid "" "r = urllib.request.urlopen(req)" msgstr "" -#: library/urllib.request.rst:1311 +#: library/urllib.request.rst:1323 msgid "" ":class:`OpenerDirector` automatically adds a :mailheader:`User-Agent` header " "to every :class:`Request`. To change this::" msgstr "" -#: library/urllib.request.rst:1314 +#: library/urllib.request.rst:1326 msgid "" "import urllib.request\n" "opener = urllib.request.build_opener()\n" @@ -1528,20 +1545,20 @@ msgid "" "opener.open('http://www.example.com/')" msgstr "" -#: library/urllib.request.rst:1319 +#: library/urllib.request.rst:1331 msgid "" "Also, remember that a few standard headers (:mailheader:`Content-Length`, :" "mailheader:`Content-Type` and :mailheader:`Host`) are added when the :class:" "`Request` is passed to :func:`urlopen` (or :meth:`OpenerDirector.open`)." msgstr "" -#: library/urllib.request.rst:1326 +#: library/urllib.request.rst:1338 msgid "" "Here is an example session that uses the ``GET`` method to retrieve a URL " "containing parameters::" msgstr "" -#: library/urllib.request.rst:1329 +#: library/urllib.request.rst:1341 msgid "" ">>> import urllib.request\n" ">>> import urllib.parse\n" @@ -1552,14 +1569,14 @@ msgid "" "..." msgstr "" -#: library/urllib.request.rst:1337 +#: library/urllib.request.rst:1349 msgid "" "The following example uses the ``POST`` method instead. Note that params " "output from urlencode is encoded to bytes before it is sent to urlopen as " "data::" msgstr "" -#: library/urllib.request.rst:1340 +#: library/urllib.request.rst:1352 msgid "" ">>> import urllib.request\n" ">>> import urllib.parse\n" @@ -1571,13 +1588,13 @@ msgid "" "..." msgstr "" -#: library/urllib.request.rst:1348 +#: library/urllib.request.rst:1360 msgid "" "The following example uses an explicitly specified HTTP proxy, overriding " "environment settings::" msgstr "" -#: library/urllib.request.rst:1351 +#: library/urllib.request.rst:1363 msgid "" ">>> import urllib.request\n" ">>> proxies = {'http': 'http://proxy.example.com:8080/'}\n" @@ -1587,13 +1604,13 @@ msgid "" "..." msgstr "" -#: library/urllib.request.rst:1358 +#: library/urllib.request.rst:1370 msgid "" "The following example uses no proxies at all, overriding environment " "settings::" msgstr "" -#: library/urllib.request.rst:1360 +#: library/urllib.request.rst:1372 msgid "" ">>> import urllib.request\n" ">>> opener = urllib.request.FancyURLopener({})\n" @@ -1602,18 +1619,18 @@ msgid "" "..." msgstr "" -#: library/urllib.request.rst:1368 +#: library/urllib.request.rst:1380 msgid "Legacy interface" msgstr "" -#: library/urllib.request.rst:1370 +#: library/urllib.request.rst:1382 msgid "" "The following functions and classes are ported from the Python 2 module " "``urllib`` (as opposed to ``urllib2``). They might become deprecated at " "some point in the future." msgstr "" -#: library/urllib.request.rst:1376 +#: library/urllib.request.rst:1388 msgid "" "Copy a network object denoted by a URL to a local file. If the URL points to " "a local file, the object will not be copied unless filename is supplied. " @@ -1623,7 +1640,7 @@ msgid "" "a remote object). Exceptions are the same as for :func:`urlopen`." msgstr "" -#: library/urllib.request.rst:1383 +#: library/urllib.request.rst:1395 msgid "" "The second argument, if present, specifies the file location to copy to (if " "absent, the location will be a tempfile with a generated name). The third " @@ -1635,11 +1652,11 @@ msgid "" "file size in response to a retrieval request." msgstr "" -#: library/urllib.request.rst:1392 +#: library/urllib.request.rst:1404 msgid "The following example illustrates the most common usage scenario::" msgstr "" -#: library/urllib.request.rst:1394 +#: library/urllib.request.rst:1406 msgid "" ">>> import urllib.request\n" ">>> local_filename, headers = urllib.request.urlretrieve('http://python." @@ -1648,7 +1665,7 @@ msgid "" ">>> html.close()" msgstr "" -#: library/urllib.request.rst:1399 +#: library/urllib.request.rst:1411 msgid "" "If the *url* uses the :file:`http:` scheme identifier, the optional *data* " "argument may be given to specify a ``POST`` request (normally the request " @@ -1657,7 +1674,7 @@ msgid "" "parse.urlencode` function." msgstr "" -#: library/urllib.request.rst:1405 +#: library/urllib.request.rst:1417 msgid "" ":func:`urlretrieve` will raise :exc:`~urllib.error.ContentTooShortError` " "when it detects that the amount of data available was less than the " @@ -1665,40 +1682,40 @@ msgid "" "This can occur, for example, when the download is interrupted." msgstr "" -#: library/urllib.request.rst:1410 +#: library/urllib.request.rst:1422 msgid "" "The *Content-Length* is treated as a lower bound: if there's more data to " "read, urlretrieve reads more data, but if less data is available, it raises " "the exception." msgstr "" -#: library/urllib.request.rst:1414 +#: library/urllib.request.rst:1426 msgid "" "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:1417 +#: library/urllib.request.rst:1429 msgid "" "If no *Content-Length* header was supplied, urlretrieve can not check the " "size of the data it has downloaded, and just returns it. In this case you " "just have to assume that the download was successful." msgstr "" -#: library/urllib.request.rst:1423 +#: library/urllib.request.rst:1435 msgid "" "Cleans up temporary files that may have been left behind by previous calls " "to :func:`urlretrieve`." msgstr "" -#: library/urllib.request.rst:1430 +#: library/urllib.request.rst:1442 msgid "" "Base class for opening and reading URLs. Unless you need to support opening " "objects using schemes other than :file:`http:`, :file:`ftp:`, or :file:`file:" "`, you probably want to use :class:`FancyURLopener`." msgstr "" -#: library/urllib.request.rst:1434 +#: library/urllib.request.rst:1446 msgid "" "By default, the :class:`URLopener` class sends a :mailheader:`User-Agent` " "header of ``urllib/VVV``, where *VVV* is the :mod:`urllib` version number. " @@ -1708,7 +1725,7 @@ msgid "" "subclass definition." msgstr "" -#: library/urllib.request.rst:1440 +#: library/urllib.request.rst:1452 msgid "" "The optional *proxies* parameter should be a dictionary mapping scheme names " "to proxy URLs, where an empty dictionary turns proxies off completely. Its " @@ -1716,7 +1733,7 @@ msgid "" "be used if present, as discussed in the definition of :func:`urlopen`, above." msgstr "" -#: library/urllib.request.rst:1445 +#: library/urllib.request.rst:1457 msgid "" "Additional keyword parameters, collected in *x509*, may be used for " "authentication of the client when using the :file:`https:` scheme. The " @@ -1724,13 +1741,13 @@ msgid "" "certificate; both are needed to support client authentication." msgstr "" -#: library/urllib.request.rst:1450 +#: library/urllib.request.rst:1462 msgid "" ":class:`URLopener` objects will raise an :exc:`OSError` exception if the " "server returns an error code." msgstr "" -#: library/urllib.request.rst:1455 +#: library/urllib.request.rst:1467 msgid "" "Open *fullurl* using the appropriate protocol. This method sets up cache " "and proxy information, then calls the appropriate open method with its input " @@ -1739,15 +1756,15 @@ msgid "" "`urlopen`." msgstr "" -#: library/urllib.request.rst:1461 +#: library/urllib.request.rst:1473 msgid "This method always quotes *fullurl* using :func:`~urllib.parse.quote`." msgstr "" -#: library/urllib.request.rst:1465 +#: library/urllib.request.rst:1477 msgid "Overridable interface to open unknown URL types." msgstr "" -#: library/urllib.request.rst:1470 +#: library/urllib.request.rst:1482 msgid "" "Retrieves the contents of *url* and places it in *filename*. The return " "value is a tuple consisting of a local filename and either an :class:`email." @@ -1764,7 +1781,7 @@ msgid "" "*reporthook* is ignored for local URLs." msgstr "" -#: library/urllib.request.rst:1483 +#: library/urllib.request.rst:1495 msgid "" "If the *url* uses the :file:`http:` scheme identifier, the optional *data* " "argument may be given to specify a ``POST`` request (normally the request " @@ -1773,7 +1790,7 @@ msgid "" "urlencode` function." msgstr "" -#: library/urllib.request.rst:1492 +#: library/urllib.request.rst:1504 msgid "" "Variable that specifies the user agent of the opener object. To get :mod:" "`urllib` to tell servers that it is a particular user agent, set this in a " @@ -1781,7 +1798,7 @@ msgid "" "constructor." msgstr "" -#: library/urllib.request.rst:1502 +#: library/urllib.request.rst:1514 msgid "" ":class:`FancyURLopener` subclasses :class:`URLopener` providing default " "handling for the following HTTP response codes: 301, 302, 303, 307 and 401. " @@ -1792,14 +1809,14 @@ msgid "" "defaults to 10." msgstr "" -#: library/urllib.request.rst:1509 +#: library/urllib.request.rst:1521 msgid "" "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:1514 +#: library/urllib.request.rst:1526 msgid "" "According to the letter of :rfc:`2616`, 301 and 302 responses to POST " "requests must not be automatically redirected without confirmation by the " @@ -1808,13 +1825,13 @@ msgid "" "behaviour." msgstr "" -#: library/urllib.request.rst:1519 +#: library/urllib.request.rst:1531 msgid "" "The parameters to the constructor are the same as those for :class:" "`URLopener`." msgstr "" -#: library/urllib.request.rst:1523 +#: library/urllib.request.rst:1535 msgid "" "When performing basic authentication, a :class:`FancyURLopener` instance " "calls its :meth:`prompt_user_passwd` method. The default implementation " @@ -1823,59 +1840,59 @@ msgid "" "needed." msgstr "" -#: library/urllib.request.rst:1528 +#: library/urllib.request.rst:1540 msgid "" "The :class:`FancyURLopener` class offers one additional method that should " "be overloaded to provide the appropriate behavior:" msgstr "" -#: library/urllib.request.rst:1533 +#: library/urllib.request.rst:1545 msgid "" "Return information needed to authenticate the user at the given host in the " "specified security realm. The return value should be a tuple, ``(user, " "password)``, which can be used for basic authentication." msgstr "" -#: library/urllib.request.rst:1537 +#: library/urllib.request.rst:1549 msgid "" "The implementation prompts for this information on the terminal; an " "application should override this method to use an appropriate interaction " "model in the local environment." msgstr "" -#: library/urllib.request.rst:1543 +#: library/urllib.request.rst:1555 msgid ":mod:`urllib.request` Restrictions" msgstr "" -#: library/urllib.request.rst:1549 +#: library/urllib.request.rst:1561 msgid "" "Currently, only the following protocols are supported: HTTP (versions 0.9 " "and 1.0), FTP, local files, and data URLs." msgstr "" -#: library/urllib.request.rst:1552 +#: library/urllib.request.rst:1564 msgid "Added support for data URLs." msgstr "" -#: library/urllib.request.rst:1554 +#: library/urllib.request.rst:1566 msgid "" "The caching feature of :func:`urlretrieve` has been disabled until someone " "finds the time to hack proper processing of Expiration time headers." msgstr "" -#: library/urllib.request.rst:1557 +#: library/urllib.request.rst:1569 msgid "" "There should be a function to query whether a particular URL is in the cache." msgstr "" -#: library/urllib.request.rst:1559 +#: library/urllib.request.rst:1571 msgid "" "For backward compatibility, if a URL appears to point to a local file but " "the file can't be opened, the URL is re-interpreted using the FTP protocol. " "This can sometimes cause confusing error messages." msgstr "" -#: library/urllib.request.rst:1563 +#: library/urllib.request.rst:1575 msgid "" "The :func:`urlopen` and :func:`urlretrieve` functions can cause arbitrarily " "long delays while waiting for a network connection to be set up. This means " @@ -1883,7 +1900,7 @@ msgid "" "functions without using threads." msgstr "" -#: library/urllib.request.rst:1572 +#: library/urllib.request.rst:1584 msgid "" "The data returned by :func:`urlopen` or :func:`urlretrieve` is the raw data " "returned by the server. This may be binary data (such as an image), plain " @@ -1893,7 +1910,7 @@ msgid "" "module :mod:`html.parser` to parse it." msgstr "" -#: library/urllib.request.rst:1581 +#: library/urllib.request.rst:1593 msgid "" "The code handling the FTP protocol cannot differentiate between a file and a " "directory. This can lead to unexpected behavior when attempting to read a " @@ -1911,11 +1928,11 @@ msgid "" "meet your needs." msgstr "" -#: library/urllib.request.rst:1598 +#: library/urllib.request.rst:1610 msgid ":mod:`urllib.response` --- Response classes used by urllib" msgstr "" -#: library/urllib.request.rst:1603 +#: library/urllib.request.rst:1615 msgid "" "The :mod:`urllib.response` module defines functions and classes which define " "a minimal file-like interface, including ``read()`` and ``readline()``. " @@ -1924,46 +1941,46 @@ msgid "" "addinfourl` instance:" msgstr "" -#: library/urllib.request.rst:1612 +#: library/urllib.request.rst:1624 msgid "" "URL of the resource retrieved, commonly used to determine if a redirect was " "followed." msgstr "" -#: library/urllib.request.rst:1616 +#: library/urllib.request.rst:1628 msgid "" "Returns the headers of the response in the form of an :class:`~email.message." "EmailMessage` instance." msgstr "" -#: library/urllib.request.rst:1622 +#: library/urllib.request.rst:1634 msgid "Status code returned by server." msgstr "" -#: library/urllib.request.rst:1626 +#: library/urllib.request.rst:1638 msgid "Deprecated in favor of :attr:`~addinfourl.url`." msgstr "" -#: library/urllib.request.rst:1631 +#: library/urllib.request.rst:1643 msgid "Deprecated in favor of :attr:`~addinfourl.headers`." msgstr "" -#: library/urllib.request.rst:1636 library/urllib.request.rst:1641 +#: library/urllib.request.rst:1648 library/urllib.request.rst:1653 msgid "Deprecated in favor of :attr:`~addinfourl.status`." msgstr "" -#: library/urllib.request.rst:1545 library/urllib.request.rst:1568 +#: library/urllib.request.rst:1557 library/urllib.request.rst:1580 msgid "HTTP" msgstr "" -#: library/urllib.request.rst:1545 library/urllib.request.rst:1568 +#: library/urllib.request.rst:1557 library/urllib.request.rst:1580 msgid "protocol" msgstr "" -#: library/urllib.request.rst:1545 library/urllib.request.rst:1579 +#: library/urllib.request.rst:1557 library/urllib.request.rst:1591 msgid "FTP" msgstr "" -#: library/urllib.request.rst:1568 +#: library/urllib.request.rst:1580 msgid "HTML" msgstr "" diff --git a/library/warnings.po b/library/warnings.po index 2932d88ea..6171e0341 100644 --- a/library/warnings.po +++ b/library/warnings.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -352,11 +352,39 @@ msgid "" "\"default\" action is applied (hence its name)." msgstr "" -#: library/warnings.rst:184 +#: library/warnings.rst:185 +msgid "Repeated Warning Suppression Criteria" +msgstr "" + +#: library/warnings.rst:187 +msgid "" +"The filters that suppress repeated warnings apply the following criteria to " +"determine if a warning is considered a repeat:" +msgstr "" + +#: library/warnings.rst:189 +msgid "" +"``\"default\"``: A warning is considered a repeat only if the (*message*, " +"*category*, *module*, *lineno*) are all the same." +msgstr "" + +#: library/warnings.rst:190 +msgid "" +"``\"module\"``: A warning is considered a repeat if the (*message*, " +"*category*, *module*) are the same, ignoring the line number." +msgstr "" + +#: library/warnings.rst:191 +msgid "" +"``\"once\"``: A warning is considered a repeat if the (*message*, " +"*category*) are the same, ignoring the module and line number." +msgstr "" + +#: library/warnings.rst:197 msgid "Describing Warning Filters" msgstr "" -#: library/warnings.rst:186 +#: library/warnings.rst:199 msgid "" "The warnings filter is initialized by :option:`-W` options passed to the " "Python interpreter command line and the :envvar:`PYTHONWARNINGS` environment " @@ -366,17 +394,17 @@ msgid "" "after printing a message to :data:`sys.stderr`)." msgstr "" -#: library/warnings.rst:193 +#: library/warnings.rst:206 msgid "" "Individual warnings filters are specified as a sequence of fields separated " "by colons::" msgstr "" -#: library/warnings.rst:196 +#: library/warnings.rst:209 msgid "action:message:category:module:line" msgstr "" -#: library/warnings.rst:198 +#: library/warnings.rst:211 msgid "" "The meaning of each of these fields is as described in :ref:`warning-" "filter`. When listing multiple filters on a single line (as for :envvar:" @@ -386,14 +414,14 @@ msgid "" "precedence over earlier ones)." msgstr "" -#: library/warnings.rst:205 +#: library/warnings.rst:218 msgid "" "Commonly used warning filters apply to either all warnings, warnings in a " "particular category, or warnings raised by particular modules or packages. " "Some examples::" msgstr "" -#: library/warnings.rst:209 +#: library/warnings.rst:222 msgid "" "default # Show all warnings (even those ignored by " "default)\n" @@ -406,24 +434,24 @@ msgid "" "error:::mymodule # Convert warnings to errors in \"mymodule\"" msgstr "" -#: library/warnings.rst:221 +#: library/warnings.rst:234 msgid "Default Warning Filter" msgstr "" -#: library/warnings.rst:223 +#: library/warnings.rst:236 msgid "" "By default, Python installs several warning filters, which can be overridden " "by the :option:`-W` command-line option, the :envvar:`PYTHONWARNINGS` " "environment variable and calls to :func:`filterwarnings`." msgstr "" -#: library/warnings.rst:227 +#: library/warnings.rst:240 msgid "" "In regular release builds, the default warning filter has the following " "entries (in order of precedence)::" msgstr "" -#: library/warnings.rst:230 +#: library/warnings.rst:243 msgid "" "default::DeprecationWarning:__main__\n" "ignore::DeprecationWarning\n" @@ -432,36 +460,36 @@ msgid "" "ignore::ResourceWarning" msgstr "" -#: library/warnings.rst:236 +#: library/warnings.rst:249 msgid "" "In a :ref:`debug build <debug-build>`, the list of default warning filters " "is empty." msgstr "" -#: library/warnings.rst:238 +#: library/warnings.rst:251 msgid "" ":exc:`DeprecationWarning` is now ignored by default in addition to :exc:" "`PendingDeprecationWarning`." msgstr "" -#: library/warnings.rst:242 +#: library/warnings.rst:255 msgid "" ":exc:`DeprecationWarning` is once again shown by default when triggered " "directly by code in ``__main__``." msgstr "" -#: library/warnings.rst:246 +#: library/warnings.rst:259 msgid "" ":exc:`BytesWarning` no longer appears in the default filter list and is " "instead configured via :data:`sys.warnoptions` when :option:`-b` is " "specified twice." msgstr "" -#: library/warnings.rst:255 +#: library/warnings.rst:268 msgid "Overriding the default filter" msgstr "" -#: library/warnings.rst:257 +#: library/warnings.rst:270 msgid "" "Developers of applications written in Python may wish to hide *all* Python " "level warnings from their users by default, and only display them when " @@ -471,7 +499,7 @@ msgid "" "disabled::" msgstr "" -#: library/warnings.rst:263 +#: library/warnings.rst:276 msgid "" "import sys\n" "\n" @@ -480,14 +508,14 @@ msgid "" " warnings.simplefilter(\"ignore\")" msgstr "" -#: library/warnings.rst:269 +#: library/warnings.rst:282 msgid "" "Developers of test runners for Python code are advised to instead ensure " "that *all* warnings are displayed by default for the code under test, using " "code like::" msgstr "" -#: library/warnings.rst:273 +#: library/warnings.rst:286 msgid "" "import sys\n" "\n" @@ -497,7 +525,7 @@ msgid "" " os.environ[\"PYTHONWARNINGS\"] = \"default\" # Also affect subprocesses" msgstr "" -#: library/warnings.rst:280 +#: library/warnings.rst:293 msgid "" "Finally, developers of interactive shells that run user code in a namespace " "other than ``__main__`` are advised to ensure that :exc:`DeprecationWarning` " @@ -505,18 +533,18 @@ msgid "" "``user_ns`` is the module used to execute code entered interactively)::" msgstr "" -#: library/warnings.rst:285 +#: library/warnings.rst:298 msgid "" "import warnings\n" "warnings.filterwarnings(\"default\", category=DeprecationWarning,\n" " module=user_ns.get(\"__name__\"))" msgstr "" -#: library/warnings.rst:293 +#: library/warnings.rst:306 msgid "Temporarily Suppressing Warnings" msgstr "" -#: library/warnings.rst:295 +#: library/warnings.rst:308 msgid "" "If you are using code that you know will raise a warning, such as a " "deprecated function, but do not want to see the warning (even when warnings " @@ -524,7 +552,7 @@ msgid "" "to suppress the warning using the :class:`catch_warnings` context manager::" msgstr "" -#: library/warnings.rst:300 +#: library/warnings.rst:313 msgid "" "import warnings\n" "\n" @@ -536,7 +564,7 @@ msgid "" " fxn()" msgstr "" -#: library/warnings.rst:309 +#: library/warnings.rst:322 msgid "" "While within the context manager all warnings will simply be ignored. This " "allows you to use known-deprecated code without having to see the warning " @@ -546,11 +574,11 @@ msgid "" "context manager at the same time, the behavior is undefined." msgstr "" -#: library/warnings.rst:321 +#: library/warnings.rst:334 msgid "Testing Warnings" msgstr "" -#: library/warnings.rst:323 +#: library/warnings.rst:336 msgid "" "To test warnings raised by code, use the :class:`catch_warnings` context " "manager. With it you can temporarily mutate the warnings filter to " @@ -558,7 +586,7 @@ msgid "" "raised warnings to check::" msgstr "" -#: library/warnings.rst:328 +#: library/warnings.rst:341 msgid "" "import warnings\n" "\n" @@ -576,7 +604,7 @@ msgid "" " assert \"deprecated\" in str(w[-1].message)" msgstr "" -#: library/warnings.rst:343 +#: library/warnings.rst:356 msgid "" "One can also cause all warnings to be exceptions by using ``error`` instead " "of ``always``. One thing to be aware of is that if a warning has already " @@ -585,7 +613,7 @@ msgid "" "registry related to the warning has been cleared." msgstr "" -#: library/warnings.rst:349 +#: library/warnings.rst:362 msgid "" "Once the context manager exits, the warnings filter is restored to its state " "when the context was entered. This prevents tests from changing the warnings " @@ -596,7 +624,7 @@ msgid "" "manager at the same time, the behavior is undefined." msgstr "" -#: library/warnings.rst:357 +#: library/warnings.rst:370 msgid "" "When testing multiple operations that raise the same kind of warning, it is " "important to test them in a manner that confirms each operation is raising a " @@ -606,18 +634,18 @@ msgid "" "entries from the warnings list before each new operation)." msgstr "" -#: library/warnings.rst:368 +#: library/warnings.rst:381 msgid "Updating Code For New Versions of Dependencies" msgstr "" -#: library/warnings.rst:370 +#: library/warnings.rst:383 msgid "" "Warning categories that are primarily of interest to Python developers " "(rather than end users of applications written in Python) are ignored by " "default." msgstr "" -#: library/warnings.rst:373 +#: library/warnings.rst:386 msgid "" "Notably, this \"ignored by default\" list includes :exc:`DeprecationWarning` " "(for every module except ``__main__``), which means developers should make " @@ -626,14 +654,14 @@ msgid "" "(whether in the standard library or third party packages)." msgstr "" -#: library/warnings.rst:379 +#: library/warnings.rst:392 msgid "" "In the ideal case, the code will have a suitable test suite, and the test " "runner will take care of implicitly enabling all warnings when running tests " "(the test runner provided by the :mod:`unittest` module does this)." msgstr "" -#: library/warnings.rst:383 +#: library/warnings.rst:396 msgid "" "In less ideal cases, applications can be checked for use of deprecated " "interfaces by passing :option:`-Wd <-W>` to the Python interpreter (this is " @@ -645,11 +673,11 @@ msgid "" "what is possible." msgstr "" -#: library/warnings.rst:396 +#: library/warnings.rst:409 msgid "Available Functions" msgstr "" -#: library/warnings.rst:401 +#: library/warnings.rst:414 msgid "" "Issue a warning, or maybe ignore it or raise an exception. The *category* " "argument, if given, must be a :ref:`warning category class <warning-" @@ -662,20 +690,20 @@ msgid "" "functions written in Python, like this::" msgstr "" -#: library/warnings.rst:410 +#: library/warnings.rst:423 msgid "" "def deprecated_api(message):\n" " warnings.warn(message, DeprecationWarning, stacklevel=2)" msgstr "" -#: library/warnings.rst:413 +#: library/warnings.rst:426 msgid "" "This makes the warning refer to ``deprecated_api``'s caller, rather than to " "the source of ``deprecated_api`` itself (since the latter would defeat the " "purpose of the warning message)." msgstr "" -#: library/warnings.rst:417 +#: library/warnings.rst:430 msgid "" "The *skip_file_prefixes* keyword argument can be used to indicate which " "stack frames are ignored when counting stack levels. This can be useful when " @@ -687,7 +715,7 @@ msgid "" "outside of the current package you might write::" msgstr "" -#: library/warnings.rst:426 +#: library/warnings.rst:439 msgid "" "# example/lower.py\n" "_warn_skips = (os.path.dirname(__file__),)\n" @@ -704,28 +732,28 @@ msgid "" " lower.one_way(**kw)" msgstr "" -#: library/warnings.rst:440 +#: library/warnings.rst:453 msgid "" "This makes the warning refer to both the ``example.lower.one_way()`` and " "``package.higher.another_way()`` call sites only from calling code living " "outside of ``example`` package." msgstr "" -#: library/warnings.rst:470 +#: library/warnings.rst:483 msgid "" "*source*, if supplied, is the destroyed object which emitted a :exc:" "`ResourceWarning`." msgstr "" -#: library/warnings.rst:447 +#: library/warnings.rst:460 msgid "Added *source* parameter." msgstr "" -#: library/warnings.rst:450 +#: library/warnings.rst:463 msgid "Added *skip_file_prefixes*." msgstr "" -#: library/warnings.rst:456 +#: library/warnings.rst:469 msgid "" "This is a low-level interface to the functionality of :func:`warn`, passing " "in explicitly the message, category, filename and line number, and " @@ -737,7 +765,7 @@ msgid "" "case *category* will be ignored." msgstr "" -#: library/warnings.rst:465 +#: library/warnings.rst:478 msgid "" "*module_globals*, if supplied, should be the global namespace in use by the " "code for which the warning is issued. (This argument is used to support " @@ -745,11 +773,11 @@ msgid "" "import sources)." msgstr "" -#: library/warnings.rst:473 +#: library/warnings.rst:486 msgid "Add the *source* parameter." msgstr "" -#: library/warnings.rst:479 +#: library/warnings.rst:492 msgid "" "Write a warning to a file. The default implementation calls " "``formatwarning(message, category, filename, lineno, line)`` and writes the " @@ -760,7 +788,7 @@ msgid "" "line specified by *filename* and *lineno*." msgstr "" -#: library/warnings.rst:490 +#: library/warnings.rst:503 msgid "" "Format a warning the standard way. This returns a string which may contain " "embedded newlines and ends in a newline. *line* is a line of source code to " @@ -769,7 +797,7 @@ msgid "" "*lineno*." msgstr "" -#: library/warnings.rst:499 +#: library/warnings.rst:512 msgid "" "Insert an entry into the list of :ref:`warnings filter specifications " "<warning-filter>`. The entry is inserted at the front by default; if " @@ -781,7 +809,7 @@ msgid "" "everything." msgstr "" -#: library/warnings.rst:511 +#: library/warnings.rst:524 msgid "" "Insert a simple entry into the list of :ref:`warnings filter specifications " "<warning-filter>`. The meaning of the function parameters is as for :func:" @@ -790,18 +818,18 @@ msgid "" "and line number match." msgstr "" -#: library/warnings.rst:520 +#: library/warnings.rst:533 msgid "" "Reset the warnings filter. This discards the effect of all previous calls " "to :func:`filterwarnings`, including that of the :option:`-W` command line " "options and calls to :func:`simplefilter`." msgstr "" -#: library/warnings.rst:526 +#: library/warnings.rst:539 msgid "Available Context Managers" msgstr "" -#: library/warnings.rst:530 +#: library/warnings.rst:543 msgid "" "A context manager that copies and, upon exit, restores the warnings filter " "and the :func:`showwarning` function. If the *record* argument is :const:" @@ -812,27 +840,27 @@ msgid "" "has attributes with the same names as the arguments to :func:`showwarning`." msgstr "" -#: library/warnings.rst:539 +#: library/warnings.rst:552 msgid "" "The *module* argument takes a module that will be used instead of the module " "returned when you import :mod:`warnings` whose filter will be protected. " "This argument exists primarily for testing the :mod:`warnings` module itself." msgstr "" -#: library/warnings.rst:544 +#: library/warnings.rst:557 msgid "" "If the *action* argument is not ``None``, the remaining arguments are passed " "to :func:`simplefilter` as if it were called immediately on entering the " "context." msgstr "" -#: library/warnings.rst:548 +#: library/warnings.rst:561 msgid "" "See :ref:`warning-filter` for the meaning of the *category* and *lineno* " "parameters." msgstr "" -#: library/warnings.rst:553 +#: library/warnings.rst:566 msgid "" "The :class:`catch_warnings` manager works by replacing and then later " "restoring the module's :func:`showwarning` function and internal list of " @@ -840,7 +868,7 @@ msgid "" "state and therefore is not thread-safe." msgstr "" -#: library/warnings.rst:561 +#: library/warnings.rst:574 msgid "Added the *action*, *category*, *lineno*, and *append* parameters." msgstr "" diff --git a/library/xmlrpc.po b/library/xmlrpc.po index a26b921e8..9b4452f70 100644 --- a/library/xmlrpc.po +++ b/library/xmlrpc.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: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -20,23 +20,23 @@ msgstr "" msgid ":mod:`!xmlrpc` --- XMLRPC server and client modules" msgstr "" -#: library/xmlrpc.rst:4 +#: library/xmlrpc.rst:7 msgid "" "XML-RPC is a Remote Procedure Call method that uses XML passed via HTTP as a " "transport. With it, a client can call methods with parameters on a remote " "server (the server is named by a URI) and get back structured data." msgstr "" -#: library/xmlrpc.rst:8 +#: library/xmlrpc.rst:11 msgid "" "``xmlrpc`` is a package that collects server and client modules implementing " "XML-RPC. The modules are:" msgstr "" -#: library/xmlrpc.rst:11 +#: library/xmlrpc.rst:14 msgid ":mod:`xmlrpc.client`" msgstr "" -#: library/xmlrpc.rst:12 +#: library/xmlrpc.rst:15 msgid ":mod:`xmlrpc.server`" msgstr "" diff --git a/reference/datamodel.po b/reference/datamodel.po index 35853b059..1fb059e2d 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -1130,7 +1130,7 @@ msgstr "" #: reference/datamodel.rst:1010 msgid "" "Setting :attr:`!__loader__` on a module while failing to set :attr:`!" -"__spec__.loader` is deprecated. In Python 3.14, :attr:`!__loader__` will " +"__spec__.loader` is deprecated. In Python 3.16, :attr:`!__loader__` will " "cease to be set or taken into consideration by the import system or the " "standard library." msgstr "" @@ -1559,7 +1559,7 @@ msgstr "" #: reference/datamodel.rst:1429 msgid "" "This attribute of code objects is deprecated, and may be removed in Python " -"3.14." +"3.15." msgstr "" #: reference/datamodel.rst:1434 diff --git a/reference/expressions.po b/reference/expressions.po index cc147946a..730a9236b 100644 --- a/reference/expressions.po +++ b/reference/expressions.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -1259,76 +1259,78 @@ msgid "" "The first thing the code block will do is bind the formal parameters to the " "arguments; this is described in section :ref:`function`. When the code " "block executes a :keyword:`return` statement, this specifies the return " -"value of the function call." +"value of the function call. If execution reaches the end of the code block " +"without executing a :keyword:`return` statement, the return value is " +"``None``." msgstr "" -#: reference/expressions.rst:1154 +#: reference/expressions.rst:1155 msgid "a built-in function or method:" msgstr "" -#: reference/expressions.rst:1165 +#: reference/expressions.rst:1166 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:1168 +#: reference/expressions.rst:1169 msgid "a class object:" msgstr "" -#: reference/expressions.rst:1173 +#: reference/expressions.rst:1174 msgid "A new instance of that class is returned." msgstr "" -#: reference/expressions.rst:1175 +#: reference/expressions.rst:1176 msgid "a class instance method:" msgstr "" -#: reference/expressions.rst:1181 +#: reference/expressions.rst:1182 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:1185 +#: reference/expressions.rst:1186 msgid "a class instance:" msgstr "" -#: reference/expressions.rst:1190 +#: reference/expressions.rst:1191 msgid "" "The class must define a :meth:`~object.__call__` method; the effect is then " "the same as if that method was called." msgstr "" -#: reference/expressions.rst:1996 +#: reference/expressions.rst:1997 msgid "Await expression" msgstr "" -#: reference/expressions.rst:1200 +#: reference/expressions.rst:1201 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:1212 +#: reference/expressions.rst:1213 msgid "The power operator" msgstr "" -#: reference/expressions.rst:1218 +#: reference/expressions.rst:1219 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:1224 +#: reference/expressions.rst:1225 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:1228 +#: reference/expressions.rst:1229 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 " @@ -1336,7 +1338,7 @@ msgid "" "converted to a common type, and the result is of that type." msgstr "" -#: reference/expressions.rst:1233 +#: reference/expressions.rst:1234 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 " @@ -1344,41 +1346,41 @@ msgid "" "``100``, but ``10**-2`` returns ``0.01``." msgstr "" -#: reference/expressions.rst:1238 +#: reference/expressions.rst:1239 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:1242 +#: reference/expressions.rst:1243 msgid "" "This operation can be customized using the special :meth:`~object.__pow__` " "and :meth:`~object.__rpow__` methods." msgstr "" -#: reference/expressions.rst:1248 +#: reference/expressions.rst:1249 msgid "Unary arithmetic and bitwise operations" msgstr "" -#: reference/expressions.rst:1254 +#: reference/expressions.rst:1255 msgid "All unary arithmetic and bitwise operations have the same priority:" msgstr "" -#: reference/expressions.rst:1265 +#: reference/expressions.rst:1266 msgid "" "The unary ``-`` (minus) operator yields the negation of its numeric " "argument; the operation can be overridden with the :meth:`~object.__neg__` " "special method." msgstr "" -#: reference/expressions.rst:1273 +#: reference/expressions.rst:1274 msgid "" "The unary ``+`` (plus) operator yields its numeric argument unchanged; the " "operation can be overridden with the :meth:`~object.__pos__` special method." msgstr "" -#: reference/expressions.rst:1280 +#: reference/expressions.rst:1281 msgid "" "The unary ``~`` (invert) operator yields the bitwise inversion of its " "integer argument. The bitwise inversion of ``x`` is defined as ``-(x+1)``. " @@ -1386,17 +1388,17 @@ msgid "" "meth:`~object.__invert__` special method." msgstr "" -#: reference/expressions.rst:1289 +#: reference/expressions.rst:1290 msgid "" "In all three cases, if the argument does not have the proper type, a :exc:" "`TypeError` exception is raised." msgstr "" -#: reference/expressions.rst:1296 +#: reference/expressions.rst:1297 msgid "Binary arithmetic operations" msgstr "" -#: reference/expressions.rst:1300 +#: reference/expressions.rst:1301 msgid "" "The binary arithmetic operations have the conventional priority levels. " "Note that some of these operations also apply to certain non-numeric types. " @@ -1404,7 +1406,7 @@ msgid "" "multiplicative operators and one for additive operators:" msgstr "" -#: reference/expressions.rst:1315 +#: reference/expressions.rst:1316 msgid "" "The ``*`` (multiplication) operator yields the product of its arguments. " "The arguments must either both be numbers, or one argument must be an " @@ -1414,25 +1416,25 @@ msgid "" "an empty sequence." msgstr "" -#: reference/expressions.rst:1321 +#: reference/expressions.rst:1322 msgid "" "This operation can be customized using the special :meth:`~object.__mul__` " "and :meth:`~object.__rmul__` methods." msgstr "" -#: reference/expressions.rst:1328 +#: reference/expressions.rst:1329 msgid "" "The ``@`` (at) operator is intended to be used for matrix multiplication. " "No builtin Python types implement this operator." msgstr "" -#: reference/expressions.rst:1331 +#: reference/expressions.rst:1332 msgid "" "This operation can be customized using the special :meth:`~object." "__matmul__` and :meth:`~object.__rmatmul__` methods." msgstr "" -#: reference/expressions.rst:1342 +#: reference/expressions.rst:1343 msgid "" "The ``/`` (division) and ``//`` (floor division) operators yield the " "quotient of their arguments. The numeric arguments are first converted to a " @@ -1442,7 +1444,7 @@ msgid "" "the :exc:`ZeroDivisionError` exception." msgstr "" -#: reference/expressions.rst:1349 +#: reference/expressions.rst:1350 msgid "" "The division operation can be customized using the special :meth:`~object." "__truediv__` and :meth:`~object.__rtruediv__` methods. The floor division " @@ -1450,7 +1452,7 @@ msgid "" "and :meth:`~object.__rfloordiv__` methods." msgstr "" -#: reference/expressions.rst:1358 +#: reference/expressions.rst:1359 msgid "" "The ``%`` (modulo) operator yields the remainder from the division of the " "first argument by the second. The numeric arguments are first converted to " @@ -1462,7 +1464,7 @@ msgid "" "absolute value of the second operand [#]_." msgstr "" -#: reference/expressions.rst:1367 +#: reference/expressions.rst:1368 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 " @@ -1470,7 +1472,7 @@ msgid "" "y, x%y)``. [#]_." msgstr "" -#: reference/expressions.rst:1372 +#: reference/expressions.rst:1373 msgid "" "In addition to performing the modulo operation on numbers, the ``%`` " "operator is also overloaded by string objects to perform old-style string " @@ -1479,20 +1481,20 @@ msgid "" "formatting`." msgstr "" -#: reference/expressions.rst:1377 +#: reference/expressions.rst:1378 msgid "" "The *modulo* operation can be customized using the special :meth:`~object." "__mod__` and :meth:`~object.__rmod__` methods." msgstr "" -#: reference/expressions.rst:1380 +#: reference/expressions.rst:1381 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:1389 +#: reference/expressions.rst:1390 msgid "" "The ``+`` (addition) operator yields the sum of its arguments. The " "arguments must either both be numbers or both be sequences of the same " @@ -1500,40 +1502,40 @@ msgid "" "then added together. In the latter case, the sequences are concatenated." msgstr "" -#: reference/expressions.rst:1394 +#: reference/expressions.rst:1395 msgid "" "This operation can be customized using the special :meth:`~object.__add__` " "and :meth:`~object.__radd__` methods." msgstr "" -#: reference/expressions.rst:1402 +#: reference/expressions.rst:1403 msgid "" "The ``-`` (subtraction) operator yields the difference of its arguments. " "The numeric arguments are first converted to a common type." msgstr "" -#: reference/expressions.rst:1405 +#: reference/expressions.rst:1406 msgid "" "This operation can be customized using the special :meth:`~object.__sub__` " "and :meth:`~object.__rsub__` methods." msgstr "" -#: reference/expressions.rst:1412 +#: reference/expressions.rst:1413 msgid "Shifting operations" msgstr "" -#: reference/expressions.rst:1419 +#: reference/expressions.rst:1420 msgid "" "The shifting operations have lower priority than the arithmetic operations:" msgstr "" -#: reference/expressions.rst:1424 +#: reference/expressions.rst:1425 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:1427 +#: reference/expressions.rst:1428 msgid "" "The left shift operation can be customized using the special :meth:`~object." "__lshift__` and :meth:`~object.__rlshift__` methods. The right shift " @@ -1541,46 +1543,46 @@ msgid "" "and :meth:`~object.__rrshift__` methods." msgstr "" -#: reference/expressions.rst:1434 +#: reference/expressions.rst:1435 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:1441 +#: reference/expressions.rst:1442 msgid "Binary bitwise operations" msgstr "" -#: reference/expressions.rst:1445 +#: reference/expressions.rst:1446 msgid "Each of the three bitwise operations has a different priority level:" msgstr "" -#: reference/expressions.rst:1456 +#: reference/expressions.rst:1457 msgid "" "The ``&`` operator yields the bitwise AND of its arguments, which must be " "integers or one of them must be a custom object overriding :meth:`~object." "__and__` or :meth:`~object.__rand__` special methods." msgstr "" -#: reference/expressions.rst:1465 +#: reference/expressions.rst:1466 msgid "" "The ``^`` operator yields the bitwise XOR (exclusive OR) of its arguments, " "which must be integers or one of them must be a custom object overriding :" "meth:`~object.__xor__` or :meth:`~object.__rxor__` special methods." msgstr "" -#: reference/expressions.rst:1474 +#: reference/expressions.rst:1475 msgid "" "The ``|`` operator yields the bitwise (inclusive) OR of its arguments, which " "must be integers or one of them must be a custom object overriding :meth:" "`~object.__or__` or :meth:`~object.__ror__` special methods." msgstr "" -#: reference/expressions.rst:1482 +#: reference/expressions.rst:1483 msgid "Comparisons" msgstr "" -#: reference/expressions.rst:1494 +#: reference/expressions.rst:1495 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 " @@ -1588,14 +1590,14 @@ msgid "" "conventional in mathematics:" msgstr "" -#: reference/expressions.rst:1504 +#: reference/expressions.rst:1505 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:1510 +#: reference/expressions.rst:1511 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 " @@ -1603,7 +1605,7 @@ msgid "" "false)." msgstr "" -#: reference/expressions.rst:1514 +#: reference/expressions.rst:1515 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 " @@ -1611,24 +1613,24 @@ msgid "" "each expression is evaluated at most once." msgstr "" -#: reference/expressions.rst:1519 +#: reference/expressions.rst:1520 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:1526 +#: reference/expressions.rst:1527 msgid "Value comparisons" msgstr "" -#: reference/expressions.rst:1528 +#: reference/expressions.rst:1529 msgid "" "The operators ``<``, ``>``, ``==``, ``>=``, ``<=``, and ``!=`` compare the " "values of two objects. The objects do not need to have the same type." msgstr "" -#: reference/expressions.rst:1531 +#: reference/expressions.rst:1532 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 " @@ -1640,7 +1642,7 @@ msgid "" "indirectly, by means of their comparison implementation." msgstr "" -#: reference/expressions.rst:1540 +#: reference/expressions.rst:1541 msgid "" "Because all types are (direct or indirect) subtypes of :class:`object`, they " "inherit the default comparison behavior from :class:`object`. Types can " @@ -1648,7 +1650,7 @@ msgid "" "methods` like :meth:`~object.__lt__`, described in :ref:`customization`." msgstr "" -#: reference/expressions.rst:1546 +#: reference/expressions.rst:1547 msgid "" "The default behavior for equality comparison (``==`` and ``!=``) is based on " "the identity of the objects. Hence, equality comparison of instances with " @@ -1658,14 +1660,14 @@ msgid "" "``x is y`` implies ``x == y``)." msgstr "" -#: reference/expressions.rst:1553 +#: reference/expressions.rst:1554 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:1557 +#: reference/expressions.rst:1558 msgid "" "The behavior of the default equality comparison, that instances with " "different identities are always unequal, may be in contrast to what types " @@ -1674,13 +1676,13 @@ msgid "" "in fact, a number of built-in types have done that." msgstr "" -#: reference/expressions.rst:1563 +#: reference/expressions.rst:1564 msgid "" "The following list describes the comparison behavior of the most important " "built-in types." msgstr "" -#: reference/expressions.rst:1566 +#: reference/expressions.rst:1567 msgid "" "Numbers of built-in numeric types (:ref:`typesnumeric`) and of the standard " "library types :class:`fractions.Fraction` and :class:`decimal.Decimal` can " @@ -1690,7 +1692,7 @@ msgid "" "of precision." msgstr "" -#: reference/expressions.rst:1573 +#: reference/expressions.rst:1574 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 " @@ -1700,32 +1702,32 @@ msgid "" "is compliant with IEEE 754." msgstr "" -#: reference/expressions.rst:1580 +#: reference/expressions.rst:1581 msgid "" "``None`` and :data:`NotImplemented` are singletons. :PEP:`8` advises that " "comparisons for singletons should always be done with ``is`` or ``is not``, " "never the equality operators." msgstr "" -#: reference/expressions.rst:1584 +#: reference/expressions.rst:1585 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:1588 +#: reference/expressions.rst:1589 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:1592 +#: reference/expressions.rst:1593 msgid "Strings and binary sequences cannot be directly compared." msgstr "" -#: reference/expressions.rst:1594 +#: reference/expressions.rst:1595 msgid "" "Sequences (instances of :class:`tuple`, :class:`list`, or :class:`range`) " "can be compared only within each of their types, with the restriction that " @@ -1734,7 +1736,7 @@ msgid "" "raises :exc:`TypeError`." msgstr "" -#: reference/expressions.rst:1600 +#: reference/expressions.rst:1601 msgid "" "Sequences compare lexicographically using comparison of corresponding " "elements. The built-in containers typically assume identical objects are " @@ -1742,19 +1744,19 @@ msgid "" "objects to improve performance and to maintain their internal invariants." msgstr "" -#: reference/expressions.rst:1605 +#: reference/expressions.rst:1606 msgid "" "Lexicographical comparison between built-in collections works as follows:" msgstr "" -#: reference/expressions.rst:1607 +#: reference/expressions.rst:1608 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:1612 +#: reference/expressions.rst:1613 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 " @@ -1763,25 +1765,25 @@ msgid "" "true)." msgstr "" -#: reference/expressions.rst:1618 +#: reference/expressions.rst:1619 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:1622 +#: reference/expressions.rst:1623 msgid "" "Order comparisons (``<``, ``>``, ``<=``, and ``>=``) raise :exc:`TypeError`." msgstr "" -#: reference/expressions.rst:1624 +#: reference/expressions.rst:1625 msgid "" "Sets (instances of :class:`set` or :class:`frozenset`) can be compared " "within and across their types." msgstr "" -#: reference/expressions.rst:1627 +#: reference/expressions.rst:1628 msgid "" "They define order comparison operators to mean subset and superset tests. " "Those relations do not define total orderings (for example, the two sets " @@ -1792,110 +1794,110 @@ msgid "" "sets as inputs)." msgstr "" -#: reference/expressions.rst:1635 +#: reference/expressions.rst:1636 msgid "Comparison of sets enforces reflexivity of its elements." msgstr "" -#: reference/expressions.rst:1637 +#: reference/expressions.rst:1638 msgid "" "Most other built-in types have no comparison methods implemented, so they " "inherit the default comparison behavior." msgstr "" -#: reference/expressions.rst:1640 +#: reference/expressions.rst:1641 msgid "" "User-defined classes that customize their comparison behavior should follow " "some consistency rules, if possible:" msgstr "" -#: reference/expressions.rst:1643 +#: reference/expressions.rst:1644 msgid "" "Equality comparison should be reflexive. In other words, identical objects " "should compare equal:" msgstr "" -#: reference/expressions.rst:1646 +#: reference/expressions.rst:1647 msgid "``x is y`` implies ``x == y``" msgstr "" -#: reference/expressions.rst:1648 +#: reference/expressions.rst:1649 msgid "" "Comparison should be symmetric. In other words, the following expressions " "should have the same result:" msgstr "" -#: reference/expressions.rst:1651 +#: reference/expressions.rst:1652 msgid "``x == y`` and ``y == x``" msgstr "" -#: reference/expressions.rst:1653 +#: reference/expressions.rst:1654 msgid "``x != y`` and ``y != x``" msgstr "" -#: reference/expressions.rst:1655 +#: reference/expressions.rst:1656 msgid "``x < y`` and ``y > x``" msgstr "" -#: reference/expressions.rst:1657 +#: reference/expressions.rst:1658 msgid "``x <= y`` and ``y >= x``" msgstr "" -#: reference/expressions.rst:1659 +#: reference/expressions.rst:1660 msgid "" "Comparison should be transitive. The following (non-exhaustive) examples " "illustrate that:" msgstr "" -#: reference/expressions.rst:1662 +#: reference/expressions.rst:1663 msgid "``x > y and y > z`` implies ``x > z``" msgstr "" -#: reference/expressions.rst:1664 +#: reference/expressions.rst:1665 msgid "``x < y and y <= z`` implies ``x < z``" msgstr "" -#: reference/expressions.rst:1666 +#: reference/expressions.rst:1667 msgid "" "Inverse comparison should result in the boolean negation. In other words, " "the following expressions should have the same result:" msgstr "" -#: reference/expressions.rst:1669 +#: reference/expressions.rst:1670 msgid "``x == y`` and ``not x != y``" msgstr "" -#: reference/expressions.rst:1671 +#: reference/expressions.rst:1672 msgid "``x < y`` and ``not x >= y`` (for total ordering)" msgstr "" -#: reference/expressions.rst:1673 +#: reference/expressions.rst:1674 msgid "``x > y`` and ``not x <= y`` (for total ordering)" msgstr "" -#: reference/expressions.rst:1675 +#: reference/expressions.rst:1676 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:1679 +#: reference/expressions.rst:1680 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:1683 +#: reference/expressions.rst:1684 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:1692 +#: reference/expressions.rst:1693 msgid "Membership test operations" msgstr "" -#: reference/expressions.rst:1694 +#: reference/expressions.rst:1695 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`` " @@ -1906,7 +1908,7 @@ msgid "" "expression ``x in y`` is equivalent to ``any(x is e or x == e for e in y)``." msgstr "" -#: reference/expressions.rst:1702 +#: reference/expressions.rst:1703 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 " @@ -1914,14 +1916,14 @@ msgid "" "``\"\" in \"abc\"`` will return ``True``." msgstr "" -#: reference/expressions.rst:1707 +#: reference/expressions.rst:1708 msgid "" "For user-defined classes which define the :meth:`~object.__contains__` " "method, ``x in y`` returns ``True`` if ``y.__contains__(x)`` returns a true " "value, and ``False`` otherwise." msgstr "" -#: reference/expressions.rst:1711 +#: reference/expressions.rst:1712 msgid "" "For user-defined classes which do not define :meth:`~object.__contains__` " "but do define :meth:`~object.__iter__`, ``x in y`` is ``True`` if some value " @@ -1930,7 +1932,7 @@ msgid "" "it is as if :keyword:`in` raised that exception." msgstr "" -#: reference/expressions.rst:1717 +#: reference/expressions.rst:1718 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-" @@ -1939,17 +1941,17 @@ msgid "" "exception is raised, it is as if :keyword:`in` raised that exception)." msgstr "" -#: reference/expressions.rst:1729 +#: reference/expressions.rst:1730 msgid "" "The operator :keyword:`not in` is defined to have the inverse truth value " "of :keyword:`in`." msgstr "" -#: reference/expressions.rst:1742 +#: reference/expressions.rst:1743 msgid "Identity comparisons" msgstr "" -#: reference/expressions.rst:1744 +#: reference/expressions.rst:1745 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 " @@ -1957,11 +1959,11 @@ msgid "" "``x is not y`` yields the inverse truth value. [#]_" msgstr "" -#: reference/expressions.rst:1756 +#: reference/expressions.rst:1757 msgid "Boolean operations" msgstr "" -#: reference/expressions.rst:1767 +#: reference/expressions.rst:1768 msgid "" "In the context of Boolean operations, and also when expressions are used by " "control flow statements, the following values are interpreted as false: " @@ -1972,25 +1974,25 @@ msgid "" "__bool__` method." msgstr "" -#: reference/expressions.rst:1776 +#: reference/expressions.rst:1777 msgid "" "The operator :keyword:`not` yields ``True`` if its argument is false, " "``False`` otherwise." msgstr "" -#: reference/expressions.rst:1781 +#: reference/expressions.rst:1782 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:1786 +#: reference/expressions.rst:1787 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:1789 +#: reference/expressions.rst:1790 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 " @@ -2001,11 +2003,11 @@ msgid "" "argument (for example, ``not 'foo'`` produces ``False`` rather than ``''``.)" msgstr "" -#: reference/expressions.rst:1805 +#: reference/expressions.rst:1806 msgid "Assignment expressions" msgstr "" -#: reference/expressions.rst:1810 +#: reference/expressions.rst:1811 msgid "" "An assignment expression (sometimes also called a \"named expression\" or " "\"walrus\") assigns an :token:`~python-grammar:expression` to an :token:" @@ -2013,27 +2015,27 @@ msgid "" "`~python-grammar:expression`." msgstr "" -#: reference/expressions.rst:1815 +#: reference/expressions.rst:1816 msgid "One common use case is when handling matched regular expressions:" msgstr "" -#: reference/expressions.rst:1817 +#: reference/expressions.rst:1818 msgid "" "if matching := pattern.search(data):\n" " do_something(matching)" msgstr "" -#: reference/expressions.rst:1822 +#: reference/expressions.rst:1823 msgid "Or, when processing a file stream in chunks:" msgstr "" -#: reference/expressions.rst:1824 +#: reference/expressions.rst:1825 msgid "" "while chunk := file.read(9000):\n" " process(chunk)" msgstr "" -#: reference/expressions.rst:1829 +#: reference/expressions.rst:1830 msgid "" "Assignment expressions must be surrounded by parentheses when used as " "expression statements and when used as sub-expressions in slicing, " @@ -2043,36 +2045,36 @@ msgid "" "and ``while`` statements." msgstr "" -#: reference/expressions.rst:1837 +#: reference/expressions.rst:1838 msgid "See :pep:`572` for more details about assignment expressions." msgstr "" -#: reference/expressions.rst:1844 +#: reference/expressions.rst:1845 msgid "Conditional expressions" msgstr "" -#: reference/expressions.rst:1856 +#: reference/expressions.rst:1857 msgid "" "Conditional expressions (sometimes called a \"ternary operator\") have the " "lowest priority of all Python operations." msgstr "" -#: reference/expressions.rst:1859 +#: reference/expressions.rst:1860 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:1863 +#: reference/expressions.rst:1864 msgid "See :pep:`308` for more details about conditional expressions." msgstr "" -#: reference/expressions.rst:1870 +#: reference/expressions.rst:1871 msgid "Lambdas" msgstr "" -#: reference/expressions.rst:1881 +#: reference/expressions.rst:1882 msgid "" "Lambda expressions (sometimes called lambda forms) are used to create " "anonymous functions. The expression ``lambda parameters: expression`` yields " @@ -2080,31 +2082,31 @@ msgid "" "defined with:" msgstr "" -#: reference/expressions.rst:1885 +#: reference/expressions.rst:1886 msgid "" "def <lambda>(parameters):\n" " return expression" msgstr "" -#: reference/expressions.rst:1890 +#: reference/expressions.rst:1891 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:1898 +#: reference/expressions.rst:1899 msgid "Expression lists" msgstr "" -#: reference/expressions.rst:1914 +#: reference/expressions.rst:1915 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:1923 +#: reference/expressions.rst:1924 msgid "" "An asterisk ``*`` denotes :dfn:`iterable unpacking`. Its operand must be " "an :term:`iterable`. The iterable is expanded into a sequence of items, " @@ -2112,16 +2114,16 @@ msgid "" "unpacking." msgstr "" -#: reference/expressions.rst:1928 +#: reference/expressions.rst:1929 msgid "" "Iterable unpacking in expression lists, originally proposed by :pep:`448`." msgstr "" -#: reference/expressions.rst:1931 +#: reference/expressions.rst:1932 msgid "Any item in an expression list may be starred. See :pep:`646`." msgstr "" -#: reference/expressions.rst:1936 +#: reference/expressions.rst:1937 msgid "" "A trailing comma is required only to create a one-item tuple, such as ``1," "``; it is optional in all other cases. A single expression without a " @@ -2130,24 +2132,24 @@ msgid "" "``()``.)" msgstr "" -#: reference/expressions.rst:1947 +#: reference/expressions.rst:1948 msgid "Evaluation order" msgstr "" -#: reference/expressions.rst:1951 +#: reference/expressions.rst:1952 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:1954 +#: reference/expressions.rst:1955 msgid "" "In the following lines, expressions will be evaluated in the arithmetic " "order of their suffixes::" msgstr "" -#: reference/expressions.rst:1957 +#: reference/expressions.rst:1958 msgid "" "expr1, expr2, expr3, expr4\n" "(expr1, expr2, expr3, expr4)\n" @@ -2157,11 +2159,11 @@ msgid "" "expr3, expr4 = expr1, expr2" msgstr "" -#: reference/expressions.rst:1968 +#: reference/expressions.rst:1969 msgid "Operator precedence" msgstr "" -#: reference/expressions.rst:1973 +#: reference/expressions.rst:1974 msgid "" "The following table summarizes the operator precedence in Python, from " "highest precedence (most binding) to lowest precedence (least binding). " @@ -2171,176 +2173,176 @@ msgid "" "group from right to left)." msgstr "" -#: reference/expressions.rst:1979 +#: reference/expressions.rst:1980 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:1985 +#: reference/expressions.rst:1986 msgid "Operator" msgstr "" -#: reference/expressions.rst:1985 +#: reference/expressions.rst:1986 msgid "Description" msgstr "" -#: reference/expressions.rst:1987 +#: reference/expressions.rst:1988 msgid "``(expressions...)``," msgstr "" -#: reference/expressions.rst:1989 +#: reference/expressions.rst:1990 msgid "``[expressions...]``, ``{key: value...}``, ``{expressions...}``" msgstr "" -#: reference/expressions.rst:1987 +#: reference/expressions.rst:1988 msgid "" "Binding or parenthesized expression, list display, dictionary display, set " "display" msgstr "" -#: reference/expressions.rst:1993 +#: reference/expressions.rst:1994 msgid "``x[index]``, ``x[index:index]``, ``x(arguments...)``, ``x.attribute``" msgstr "" -#: reference/expressions.rst:1993 +#: reference/expressions.rst:1994 msgid "Subscription, slicing, call, attribute reference" msgstr "" -#: reference/expressions.rst:1996 +#: reference/expressions.rst:1997 msgid ":keyword:`await x <await>`" msgstr "" -#: reference/expressions.rst:1998 +#: reference/expressions.rst:1999 msgid "``**``" msgstr "" -#: reference/expressions.rst:1998 +#: reference/expressions.rst:1999 msgid "Exponentiation [#]_" msgstr "" -#: reference/expressions.rst:2000 +#: reference/expressions.rst:2001 msgid "``+x``, ``-x``, ``~x``" msgstr "" -#: reference/expressions.rst:2000 +#: reference/expressions.rst:2001 msgid "Positive, negative, bitwise NOT" msgstr "" -#: reference/expressions.rst:2002 +#: reference/expressions.rst:2003 msgid "``*``, ``@``, ``/``, ``//``, ``%``" msgstr "" -#: reference/expressions.rst:2002 +#: reference/expressions.rst:2003 msgid "" "Multiplication, matrix multiplication, division, floor division, remainder " "[#]_" msgstr "" -#: reference/expressions.rst:2006 +#: reference/expressions.rst:2007 msgid "``+``, ``-``" msgstr "" -#: reference/expressions.rst:2006 +#: reference/expressions.rst:2007 msgid "Addition and subtraction" msgstr "" -#: reference/expressions.rst:2008 +#: reference/expressions.rst:2009 msgid "``<<``, ``>>``" msgstr "" -#: reference/expressions.rst:2008 +#: reference/expressions.rst:2009 msgid "Shifts" msgstr "" -#: reference/expressions.rst:2010 +#: reference/expressions.rst:2011 msgid "``&``" msgstr "" -#: reference/expressions.rst:2010 +#: reference/expressions.rst:2011 msgid "Bitwise AND" msgstr "" -#: reference/expressions.rst:2012 +#: reference/expressions.rst:2013 msgid "``^``" msgstr "" -#: reference/expressions.rst:2012 +#: reference/expressions.rst:2013 msgid "Bitwise XOR" msgstr "" -#: reference/expressions.rst:2014 +#: reference/expressions.rst:2015 msgid "``|``" msgstr "" -#: reference/expressions.rst:2014 +#: reference/expressions.rst:2015 msgid "Bitwise OR" msgstr "" -#: reference/expressions.rst:2016 +#: reference/expressions.rst:2017 msgid "" ":keyword:`in`, :keyword:`not in`, :keyword:`is`, :keyword:`is not`, ``<``, " "``<=``, ``>``, ``>=``, ``!=``, ``==``" msgstr "" -#: reference/expressions.rst:2016 +#: reference/expressions.rst:2017 msgid "Comparisons, including membership tests and identity tests" msgstr "" -#: reference/expressions.rst:2020 +#: reference/expressions.rst:2021 msgid ":keyword:`not x <not>`" msgstr "" -#: reference/expressions.rst:2020 +#: reference/expressions.rst:2021 msgid "Boolean NOT" msgstr "" -#: reference/expressions.rst:2022 +#: reference/expressions.rst:2023 msgid ":keyword:`and`" msgstr "" -#: reference/expressions.rst:2022 +#: reference/expressions.rst:2023 msgid "Boolean AND" msgstr "" -#: reference/expressions.rst:2024 +#: reference/expressions.rst:2025 msgid ":keyword:`or`" msgstr "" -#: reference/expressions.rst:2024 +#: reference/expressions.rst:2025 msgid "Boolean OR" msgstr "" -#: reference/expressions.rst:2026 +#: reference/expressions.rst:2027 msgid ":keyword:`if <if_expr>` -- :keyword:`!else`" msgstr "" -#: reference/expressions.rst:2026 +#: reference/expressions.rst:2027 msgid "Conditional expression" msgstr "" -#: reference/expressions.rst:2028 +#: reference/expressions.rst:2029 msgid ":keyword:`lambda`" msgstr "" -#: reference/expressions.rst:2028 +#: reference/expressions.rst:2029 msgid "Lambda expression" msgstr "" -#: reference/expressions.rst:2030 +#: reference/expressions.rst:2031 msgid "``:=``" msgstr "" -#: reference/expressions.rst:2030 +#: reference/expressions.rst:2031 msgid "Assignment expression" msgstr "" -#: reference/expressions.rst:2035 +#: reference/expressions.rst:2036 msgid "Footnotes" msgstr "" -#: reference/expressions.rst:2036 +#: reference/expressions.rst:2037 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 " @@ -2352,7 +2354,7 @@ msgid "" "approach is more appropriate depends on the application." msgstr "" -#: reference/expressions.rst:2045 +#: reference/expressions.rst:2046 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, " @@ -2360,7 +2362,7 @@ msgid "" "* y + x % y`` be very close to ``x``." msgstr "" -#: reference/expressions.rst:2050 +#: reference/expressions.rst:2051 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 " @@ -2374,7 +2376,7 @@ msgid "" "(COMBINING CEDILLA)." msgstr "" -#: reference/expressions.rst:2061 +#: reference/expressions.rst:2062 msgid "" "The comparison operators on strings compare at the level of Unicode code " "points. This may be counter-intuitive to humans. For example, ``\"\\u00C7\" " @@ -2382,13 +2384,13 @@ msgid "" "same abstract character \"LATIN CAPITAL LETTER C WITH CEDILLA\"." msgstr "" -#: reference/expressions.rst:2066 +#: reference/expressions.rst:2067 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:2069 +#: reference/expressions.rst:2070 msgid "" "Due to automatic garbage-collection, free lists, and the dynamic nature of " "descriptors, you may notice seemingly unusual behaviour in certain uses of " @@ -2396,20 +2398,20 @@ msgid "" "instance methods, or constants. Check their documentation for more info." msgstr "" -#: reference/expressions.rst:2074 +#: reference/expressions.rst:2075 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:2077 +#: reference/expressions.rst:2078 msgid "" "The ``%`` operator is also used for string formatting; the same precedence " "applies." msgstr "" -#: reference/expressions.rst:393 reference/expressions.rst:1758 -#: reference/expressions.rst:1872 reference/expressions.rst:1900 +#: reference/expressions.rst:393 reference/expressions.rst:1759 +#: reference/expressions.rst:1873 reference/expressions.rst:1901 msgid "expression" msgstr "" @@ -2417,7 +2419,7 @@ msgstr "" msgid "BNF" msgstr "" -#: reference/expressions.rst:1250 reference/expressions.rst:1298 +#: reference/expressions.rst:1251 reference/expressions.rst:1299 msgid "arithmetic" msgstr "" @@ -2438,8 +2440,8 @@ msgid "identifier" msgstr "" #: reference/expressions.rst:569 reference/expressions.rst:746 -#: reference/expressions.rst:844 reference/expressions.rst:1336 -#: reference/expressions.rst:1432 +#: reference/expressions.rst:844 reference/expressions.rst:1337 +#: reference/expressions.rst:1433 msgid "exception" msgstr "" @@ -2478,8 +2480,8 @@ msgstr "" #: reference/expressions.rst:275 reference/expressions.rst:329 #: reference/expressions.rst:393 reference/expressions.rst:736 #: reference/expressions.rst:873 reference/expressions.rst:994 -#: reference/expressions.rst:1155 reference/expressions.rst:1176 -#: reference/expressions.rst:1912 +#: reference/expressions.rst:1156 reference/expressions.rst:1177 +#: reference/expressions.rst:1913 msgid "object" msgstr "" @@ -2499,16 +2501,16 @@ msgstr "" msgid "empty" msgstr "" -#: reference/expressions.rst:873 reference/expressions.rst:1912 +#: reference/expressions.rst:873 reference/expressions.rst:1913 msgid "tuple" msgstr "" -#: reference/expressions.rst:1934 +#: reference/expressions.rst:1935 msgid "comma" msgstr "" #: reference/expressions.rst:275 reference/expressions.rst:329 -#: reference/expressions.rst:994 reference/expressions.rst:1900 +#: reference/expressions.rst:994 reference/expressions.rst:1901 msgid ", (comma)" msgstr "" @@ -2524,7 +2526,7 @@ msgstr "" msgid "in comprehensions" msgstr "" -#: reference/expressions.rst:1846 +#: reference/expressions.rst:1847 msgid "if" msgstr "" @@ -2532,12 +2534,12 @@ msgstr "" msgid "async for" msgstr "" -#: reference/expressions.rst:1194 +#: reference/expressions.rst:1195 msgid "await" msgstr "" #: reference/expressions.rst:844 reference/expressions.rst:950 -#: reference/expressions.rst:1900 +#: reference/expressions.rst:1901 msgid "list" msgstr "" @@ -2553,7 +2555,7 @@ msgstr "" msgid "list expression" msgstr "" -#: reference/expressions.rst:301 reference/expressions.rst:1900 +#: reference/expressions.rst:301 reference/expressions.rst:1901 msgid "expression list" msgstr "" @@ -2589,7 +2591,7 @@ msgstr "" msgid "dictionary expression" msgstr "" -#: reference/expressions.rst:944 reference/expressions.rst:1872 +#: reference/expressions.rst:944 reference/expressions.rst:1873 msgid ": (colon)" msgstr "" @@ -2601,11 +2603,11 @@ msgstr "" msgid "in dictionary displays" msgstr "" -#: reference/expressions.rst:1077 reference/expressions.rst:1919 +#: reference/expressions.rst:1077 reference/expressions.rst:1920 msgid "unpacking" msgstr "" -#: reference/expressions.rst:1107 reference/expressions.rst:1214 +#: reference/expressions.rst:1107 reference/expressions.rst:1215 msgid "**" msgstr "" @@ -2621,7 +2623,7 @@ msgstr "" msgid "generator expression" msgstr "" -#: reference/expressions.rst:1194 +#: reference/expressions.rst:1195 msgid "keyword" msgstr "" @@ -2633,7 +2635,7 @@ msgstr "" msgid "from" msgstr "" -#: reference/expressions.rst:1142 reference/expressions.rst:1872 +#: reference/expressions.rst:1142 reference/expressions.rst:1873 msgid "function" msgstr "" @@ -2697,7 +2699,7 @@ msgstr "" msgid "subscription" msgstr "" -#: reference/expressions.rst:950 reference/expressions.rst:1723 +#: reference/expressions.rst:950 reference/expressions.rst:1724 msgid "sequence" msgstr "" @@ -2741,8 +2743,8 @@ msgstr "" msgid "callable" msgstr "" -#: reference/expressions.rst:1142 reference/expressions.rst:1169 -#: reference/expressions.rst:1186 +#: reference/expressions.rst:1142 reference/expressions.rst:1170 +#: reference/expressions.rst:1187 msgid "call" msgstr "" @@ -2770,7 +2772,7 @@ msgstr "" msgid "parameter" msgstr "" -#: reference/expressions.rst:1311 reference/expressions.rst:1919 +#: reference/expressions.rst:1312 reference/expressions.rst:1920 msgid "* (asterisk)" msgstr "" @@ -2782,353 +2784,353 @@ msgstr "" msgid "user-defined function" msgstr "" -#: reference/expressions.rst:1155 +#: reference/expressions.rst:1156 msgid "built-in function" msgstr "" -#: reference/expressions.rst:1155 +#: reference/expressions.rst:1156 msgid "method" msgstr "" -#: reference/expressions.rst:1155 +#: reference/expressions.rst:1156 msgid "built-in method" msgstr "" -#: reference/expressions.rst:1169 +#: reference/expressions.rst:1170 msgid "class" msgstr "" -#: reference/expressions.rst:1169 +#: reference/expressions.rst:1170 msgid "class object" msgstr "" -#: reference/expressions.rst:1176 +#: reference/expressions.rst:1177 msgid "class instance" msgstr "" -#: reference/expressions.rst:1186 +#: reference/expressions.rst:1187 msgid "instance" msgstr "" -#: reference/expressions.rst:1186 +#: reference/expressions.rst:1187 msgid "__call__() (object method)" msgstr "" -#: reference/expressions.rst:1214 +#: reference/expressions.rst:1215 msgid "power" msgstr "" -#: reference/expressions.rst:1250 reference/expressions.rst:1414 -#: reference/expressions.rst:1758 +#: reference/expressions.rst:1251 reference/expressions.rst:1415 +#: reference/expressions.rst:1759 msgid "operation" msgstr "" -#: reference/expressions.rst:1259 reference/expressions.rst:1276 -#: reference/expressions.rst:1324 reference/expressions.rst:1354 -#: reference/expressions.rst:1397 reference/expressions.rst:1452 -#: reference/expressions.rst:1469 reference/expressions.rst:1723 -#: reference/expressions.rst:1774 reference/expressions.rst:1784 -#: reference/expressions.rst:1970 +#: reference/expressions.rst:1260 reference/expressions.rst:1277 +#: reference/expressions.rst:1325 reference/expressions.rst:1355 +#: reference/expressions.rst:1398 reference/expressions.rst:1453 +#: reference/expressions.rst:1470 reference/expressions.rst:1724 +#: reference/expressions.rst:1775 reference/expressions.rst:1785 +#: reference/expressions.rst:1971 msgid "operator" msgstr "" -#: reference/expressions.rst:1250 +#: reference/expressions.rst:1251 msgid "unary" msgstr "" -#: reference/expressions.rst:1443 reference/expressions.rst:1460 -#: reference/expressions.rst:1469 +#: reference/expressions.rst:1444 reference/expressions.rst:1461 +#: reference/expressions.rst:1470 msgid "bitwise" msgstr "" -#: reference/expressions.rst:1259 +#: reference/expressions.rst:1260 msgid "negation" msgstr "" -#: reference/expressions.rst:1259 +#: reference/expressions.rst:1260 msgid "minus" msgstr "" -#: reference/expressions.rst:1397 +#: reference/expressions.rst:1398 msgid "- (minus)" msgstr "" -#: reference/expressions.rst:1268 +#: reference/expressions.rst:1269 msgid "unary operator" msgstr "" -#: reference/expressions.rst:1268 +#: reference/expressions.rst:1269 msgid "plus" msgstr "" -#: reference/expressions.rst:1384 +#: reference/expressions.rst:1385 msgid "+ (plus)" msgstr "" -#: reference/expressions.rst:1276 +#: reference/expressions.rst:1277 msgid "inversion" msgstr "" -#: reference/expressions.rst:1276 +#: reference/expressions.rst:1277 msgid "~ (tilde)" msgstr "" -#: reference/expressions.rst:1287 +#: reference/expressions.rst:1288 msgid "TypeError" msgstr "" -#: reference/expressions.rst:1443 +#: reference/expressions.rst:1444 msgid "binary" msgstr "" -#: reference/expressions.rst:1311 +#: reference/expressions.rst:1312 msgid "multiplication" msgstr "" -#: reference/expressions.rst:1324 +#: reference/expressions.rst:1325 msgid "matrix multiplication" msgstr "" -#: reference/expressions.rst:1324 +#: reference/expressions.rst:1325 msgid "@ (at)" msgstr "" -#: reference/expressions.rst:1336 +#: reference/expressions.rst:1337 msgid "ZeroDivisionError" msgstr "" -#: reference/expressions.rst:1336 +#: reference/expressions.rst:1337 msgid "division" msgstr "" -#: reference/expressions.rst:1336 +#: reference/expressions.rst:1337 msgid "/ (slash)" msgstr "" -#: reference/expressions.rst:1336 +#: reference/expressions.rst:1337 msgid "//" msgstr "" -#: reference/expressions.rst:1354 +#: reference/expressions.rst:1355 msgid "modulo" msgstr "" -#: reference/expressions.rst:1354 +#: reference/expressions.rst:1355 msgid "% (percent)" msgstr "" -#: reference/expressions.rst:1384 +#: reference/expressions.rst:1385 msgid "addition" msgstr "" -#: reference/expressions.rst:1397 +#: reference/expressions.rst:1398 msgid "binary operator" msgstr "" -#: reference/expressions.rst:1397 +#: reference/expressions.rst:1398 msgid "subtraction" msgstr "" -#: reference/expressions.rst:1414 +#: reference/expressions.rst:1415 msgid "shifting" msgstr "" -#: reference/expressions.rst:1414 +#: reference/expressions.rst:1415 msgid "<<" msgstr "" -#: reference/expressions.rst:1414 +#: reference/expressions.rst:1415 msgid ">>" msgstr "" -#: reference/expressions.rst:1432 +#: reference/expressions.rst:1433 msgid "ValueError" msgstr "" -#: reference/expressions.rst:1779 +#: reference/expressions.rst:1780 msgid "and" msgstr "" -#: reference/expressions.rst:1452 +#: reference/expressions.rst:1453 msgid "& (ampersand)" msgstr "" -#: reference/expressions.rst:1460 +#: reference/expressions.rst:1461 msgid "xor" msgstr "" -#: reference/expressions.rst:1460 +#: reference/expressions.rst:1461 msgid "exclusive" msgstr "" -#: reference/expressions.rst:1469 reference/expressions.rst:1784 +#: reference/expressions.rst:1470 reference/expressions.rst:1785 msgid "or" msgstr "" -#: reference/expressions.rst:1460 +#: reference/expressions.rst:1461 msgid "^ (caret)" msgstr "" -#: reference/expressions.rst:1469 +#: reference/expressions.rst:1470 msgid "inclusive" msgstr "" -#: reference/expressions.rst:1469 +#: reference/expressions.rst:1470 msgid "| (vertical bar)" msgstr "" -#: reference/expressions.rst:1484 +#: reference/expressions.rst:1485 msgid "comparison" msgstr "" -#: reference/expressions.rst:1484 +#: reference/expressions.rst:1485 msgid "C" msgstr "" -#: reference/expressions.rst:1484 +#: reference/expressions.rst:1485 msgid "language" msgstr "" -#: reference/expressions.rst:1484 +#: reference/expressions.rst:1485 msgid "< (less)" msgstr "" -#: reference/expressions.rst:1484 +#: reference/expressions.rst:1485 msgid "> (greater)" msgstr "" -#: reference/expressions.rst:1484 +#: reference/expressions.rst:1485 msgid "<=" msgstr "" -#: reference/expressions.rst:1484 +#: reference/expressions.rst:1485 msgid ">=" msgstr "" -#: reference/expressions.rst:1484 +#: reference/expressions.rst:1485 msgid "==" msgstr "" -#: reference/expressions.rst:1484 +#: reference/expressions.rst:1485 msgid "!=" msgstr "" -#: reference/expressions.rst:1508 +#: reference/expressions.rst:1509 msgid "chaining" msgstr "" -#: reference/expressions.rst:1508 +#: reference/expressions.rst:1509 msgid "comparisons" msgstr "" -#: reference/expressions.rst:1723 +#: reference/expressions.rst:1724 msgid "in" msgstr "" -#: reference/expressions.rst:1723 +#: reference/expressions.rst:1724 msgid "not in" msgstr "" -#: reference/expressions.rst:1723 +#: reference/expressions.rst:1724 msgid "membership" msgstr "" -#: reference/expressions.rst:1732 +#: reference/expressions.rst:1733 msgid "test" msgstr "" -#: reference/expressions.rst:1732 +#: reference/expressions.rst:1733 msgid "is" msgstr "" -#: reference/expressions.rst:1732 +#: reference/expressions.rst:1733 msgid "is not" msgstr "" -#: reference/expressions.rst:1732 +#: reference/expressions.rst:1733 msgid "identity" msgstr "" -#: reference/expressions.rst:1758 +#: reference/expressions.rst:1759 msgid "Conditional" msgstr "" -#: reference/expressions.rst:1758 +#: reference/expressions.rst:1759 msgid "Boolean" msgstr "" -#: reference/expressions.rst:1774 +#: reference/expressions.rst:1775 msgid "not" msgstr "" -#: reference/expressions.rst:1798 +#: reference/expressions.rst:1799 msgid ":= (colon equals)" msgstr "" -#: reference/expressions.rst:1798 +#: reference/expressions.rst:1799 msgid "assignment expression" msgstr "" -#: reference/expressions.rst:1798 +#: reference/expressions.rst:1799 msgid "walrus operator" msgstr "" -#: reference/expressions.rst:1798 +#: reference/expressions.rst:1799 msgid "named expression" msgstr "" -#: reference/expressions.rst:1846 +#: reference/expressions.rst:1847 msgid "conditional" msgstr "" -#: reference/expressions.rst:1846 +#: reference/expressions.rst:1847 msgid "ternary" msgstr "" -#: reference/expressions.rst:1846 +#: reference/expressions.rst:1847 msgid "conditional expression" msgstr "" -#: reference/expressions.rst:1846 +#: reference/expressions.rst:1847 msgid "else" msgstr "" -#: reference/expressions.rst:1872 +#: reference/expressions.rst:1873 msgid "lambda" msgstr "" -#: reference/expressions.rst:1872 +#: reference/expressions.rst:1873 msgid "form" msgstr "" -#: reference/expressions.rst:1872 +#: reference/expressions.rst:1873 msgid "anonymous" msgstr "" -#: reference/expressions.rst:1872 +#: reference/expressions.rst:1873 msgid "lambda expression" msgstr "" -#: reference/expressions.rst:1919 +#: reference/expressions.rst:1920 msgid "iterable" msgstr "" -#: reference/expressions.rst:1919 +#: reference/expressions.rst:1920 msgid "in expression lists" msgstr "" -#: reference/expressions.rst:1934 +#: reference/expressions.rst:1935 msgid "trailing" msgstr "" -#: reference/expressions.rst:1949 +#: reference/expressions.rst:1950 msgid "evaluation" msgstr "" -#: reference/expressions.rst:1949 +#: reference/expressions.rst:1950 msgid "order" msgstr "" -#: reference/expressions.rst:1970 +#: reference/expressions.rst:1971 msgid "precedence" msgstr "" diff --git a/reference/simple_stmts.po b/reference/simple_stmts.po index 70127a27b..788215ef8 100644 --- a/reference/simple_stmts.po +++ b/reference/simple_stmts.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -442,12 +442,13 @@ msgstr "" msgid "" "These equivalences assume that :const:`__debug__` and :exc:`AssertionError` " "refer to the built-in variables with those names. In the current " -"implementation, the built-in variable :const:`__debug__` is ``True`` under " -"normal circumstances, ``False`` when optimization is requested (command line " -"option :option:`-O`). The current code generator emits no code for an " -"assert statement when optimization is requested at compile time. Note that " -"it is unnecessary to include the source code for the expression that failed " -"in the error message; it will be displayed as part of the stack trace." +"implementation, the built-in variable ``__debug__`` is ``True`` under normal " +"circumstances, ``False`` when optimization is requested (command line " +"option :option:`-O`). The current code generator emits no code for an :" +"keyword:`assert` statement when optimization is requested at compile time. " +"Note that it is unnecessary to include the source code for the expression " +"that failed in the error message; it will be displayed as part of the stack " +"trace." msgstr "" #: reference/simple_stmts.rst:416 @@ -564,7 +565,7 @@ msgstr "" #: reference/simple_stmts.rst:533 msgid "" "A :keyword:`yield` statement is semantically equivalent to a :ref:`yield " -"expression <yieldexpr>`. The yield statement can be used to omit the " +"expression <yieldexpr>`. The ``yield`` statement can be used to omit the " "parentheses that would otherwise be required in the equivalent yield " "expression statement. For example, the yield statements ::" msgstr "" @@ -589,8 +590,9 @@ msgstr "" msgid "" "Yield expressions and statements are only used when defining a :term:" "`generator` function, and are only used in the body of the generator " -"function. Using yield in a function definition is sufficient to cause that " -"definition to create a generator function instead of a normal function." +"function. Using :keyword:`yield` in a function definition is sufficient to " +"cause that definition to create a generator function instead of a normal " +"function." msgstr "" #: reference/simple_stmts.rst:551 @@ -1100,35 +1102,20 @@ msgstr "" #: reference/simple_stmts.rst:967 msgid "" -"The :keyword:`global` statement is a declaration which holds for the entire " -"current code block. It means that the listed identifiers are to be " -"interpreted as globals. It would be impossible to assign to a global " +"The :keyword:`global` statement causes the listed identifiers to be " +"interpreted as globals. It would be impossible to assign to a global " "variable without :keyword:`!global`, although free variables may refer to " "globals without being declared global." msgstr "" -#: reference/simple_stmts.rst:973 +#: reference/simple_stmts.rst:972 msgid "" -"Names listed in a :keyword:`global` statement must not be used in the same " -"code block textually preceding that :keyword:`!global` statement." +"The :keyword:`global` statement applies to the entire scope of a function or " +"class body. A :exc:`SyntaxError` is raised if a variable is used or assigned " +"to prior to its global declaration in the scope." msgstr "" -#: reference/simple_stmts.rst:976 -msgid "" -"Names listed in a :keyword:`global` statement must not be defined as formal " -"parameters, or as targets in :keyword:`with` statements or :keyword:`except` " -"clauses, or in a :keyword:`for` target list, :keyword:`class` definition, " -"function definition, :keyword:`import` statement, or variable annotation." -msgstr "" - -#: reference/simple_stmts.rst:983 -msgid "" -"The current implementation does not enforce some of these restrictions, but " -"programs should not abuse this freedom, as future implementations may " -"enforce them or silently change the meaning of the program." -msgstr "" - -#: reference/simple_stmts.rst:992 +#: reference/simple_stmts.rst:981 msgid "" "**Programmer's note:** :keyword:`global` is a directive to the parser. It " "applies only to code parsed at the same time as the :keyword:`!global` " @@ -1140,11 +1127,11 @@ msgid "" "func:`compile` functions." msgstr "" -#: reference/simple_stmts.rst:1004 +#: reference/simple_stmts.rst:993 msgid "The :keyword:`!nonlocal` statement" msgstr "" -#: reference/simple_stmts.rst:1012 +#: reference/simple_stmts.rst:1001 msgid "" "When the definition of a function or class is nested (enclosed) within the " "definitions of other functions, its nonlocal scopes are the local scopes of " @@ -1156,64 +1143,64 @@ msgid "" "`SyntaxError` is raised." msgstr "" -#: reference/simple_stmts.rst:1021 +#: reference/simple_stmts.rst:1010 msgid "" -"The nonlocal statement applies to the entire scope of a function or class " -"body. A :exc:`SyntaxError` is raised if a variable is used or assigned to " -"prior to its nonlocal declaration in the scope." +"The :keyword:`nonlocal` statement applies to the entire scope of a function " +"or class body. A :exc:`SyntaxError` is raised if a variable is used or " +"assigned to prior to its nonlocal declaration in the scope." msgstr "" -#: reference/simple_stmts.rst:1027 +#: reference/simple_stmts.rst:1016 msgid ":pep:`3104` - Access to Names in Outer Scopes" msgstr "" -#: reference/simple_stmts.rst:1028 +#: reference/simple_stmts.rst:1017 msgid "The specification for the :keyword:`nonlocal` statement." msgstr "" -#: reference/simple_stmts.rst:1030 +#: reference/simple_stmts.rst:1019 msgid "" "**Programmer's note:** :keyword:`nonlocal` is a directive to the parser and " "applies only to code parsed along with it. See the note for the :keyword:" "`global` statement." msgstr "" -#: reference/simple_stmts.rst:1038 +#: reference/simple_stmts.rst:1027 msgid "The :keyword:`!type` statement" msgstr "" -#: reference/simple_stmts.rst:1045 +#: reference/simple_stmts.rst:1034 msgid "" "The :keyword:`!type` statement declares a type alias, which is an instance " "of :class:`typing.TypeAliasType`." msgstr "" -#: reference/simple_stmts.rst:1048 +#: reference/simple_stmts.rst:1037 msgid "For example, the following statement creates a type alias::" msgstr "" -#: reference/simple_stmts.rst:1050 +#: reference/simple_stmts.rst:1039 msgid "type Point = tuple[float, float]" msgstr "" -#: reference/simple_stmts.rst:1052 +#: reference/simple_stmts.rst:1041 msgid "This code is roughly equivalent to::" msgstr "" -#: reference/simple_stmts.rst:1054 +#: reference/simple_stmts.rst:1043 msgid "" "annotation-def VALUE_OF_Point():\n" " return tuple[float, float]\n" "Point = typing.TypeAliasType(\"Point\", VALUE_OF_Point())" msgstr "" -#: reference/simple_stmts.rst:1058 +#: reference/simple_stmts.rst:1047 msgid "" "``annotation-def`` indicates an :ref:`annotation scope <annotation-scopes>`, " "which behaves mostly like a function, but with several small differences." msgstr "" -#: reference/simple_stmts.rst:1061 +#: reference/simple_stmts.rst:1050 msgid "" "The value of the type alias is evaluated in the annotation scope. It is not " "evaluated when the type alias is created, but only when the value is " @@ -1222,21 +1209,21 @@ msgid "" "not yet defined." msgstr "" -#: reference/simple_stmts.rst:1067 +#: reference/simple_stmts.rst:1056 msgid "" "Type aliases may be made generic by adding a :ref:`type parameter list <type-" "params>` after the name. See :ref:`generic-type-aliases` for more." msgstr "" -#: reference/simple_stmts.rst:1070 +#: reference/simple_stmts.rst:1059 msgid ":keyword:`!type` is a :ref:`soft keyword <soft-keywords>`." msgstr "" -#: reference/simple_stmts.rst:1076 +#: reference/simple_stmts.rst:1065 msgid ":pep:`695` - Type Parameter Syntax" msgstr "" -#: reference/simple_stmts.rst:1077 +#: reference/simple_stmts.rst:1066 msgid "" "Introduced the :keyword:`!type` statement and syntax for generic classes and " "functions." @@ -1250,7 +1237,7 @@ msgstr "" #: reference/simple_stmts.rst:382 reference/simple_stmts.rst:447 #: reference/simple_stmts.rst:486 reference/simple_stmts.rst:559 #: reference/simple_stmts.rst:718 reference/simple_stmts.rst:873 -#: reference/simple_stmts.rst:1006 reference/simple_stmts.rst:1040 +#: reference/simple_stmts.rst:995 reference/simple_stmts.rst:1029 msgid "statement" msgstr "" @@ -1263,7 +1250,7 @@ msgstr "" msgid "list" msgstr "" -#: reference/simple_stmts.rst:987 +#: reference/simple_stmts.rst:976 msgid "built-in function" msgstr "" @@ -1351,7 +1338,7 @@ msgid "target" msgstr "" #: reference/simple_stmts.rst:382 reference/simple_stmts.rst:959 -#: reference/simple_stmts.rst:1006 +#: reference/simple_stmts.rst:995 msgid ", (comma)" msgstr "" @@ -1677,26 +1664,26 @@ msgstr "" msgid "future statement" msgstr "" -#: reference/simple_stmts.rst:1006 +#: reference/simple_stmts.rst:995 msgid "identifier list" msgstr "" -#: reference/simple_stmts.rst:987 +#: reference/simple_stmts.rst:976 msgid "exec" msgstr "" -#: reference/simple_stmts.rst:987 +#: reference/simple_stmts.rst:976 msgid "eval" msgstr "" -#: reference/simple_stmts.rst:987 +#: reference/simple_stmts.rst:976 msgid "compile" msgstr "" -#: reference/simple_stmts.rst:1006 +#: reference/simple_stmts.rst:995 msgid "nonlocal" msgstr "" -#: reference/simple_stmts.rst:1040 +#: reference/simple_stmts.rst:1029 msgid "type" msgstr "" diff --git a/tutorial/datastructures.po b/tutorial/datastructures.po index dfe5d3722..cd8f25491 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: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: 2022-12-28 21:39+0300\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -200,9 +200,9 @@ msgstr "Listeleri Yığın Olarak Kullanma" msgid "" "The list methods make it very easy to use a list as a stack, where the last " "element added is the first element retrieved (\"last-in, first-out\"). To " -"add an item to the top of the stack, use :meth:`~list.append`. To retrieve " -"an item from the top of the stack, use :meth:`~list.pop` without an explicit " -"index. For example::" +"add an item to the top of the stack, use :meth:`!append`. To retrieve an " +"item from the top of the stack, use :meth:`!pop` without an explicit index. " +"For example::" msgstr "" "Liste yöntemleri, bir listeyi, eklenen son öğenin alınan ilk öğe olduğu bir " "yığın olarak kullanmayı çok kolaylaştırır (\"son giren ilk çıkar\"). " @@ -532,9 +532,9 @@ msgstr ":keyword:`!del` ifadesi" #, fuzzy msgid "" "There is a way to remove an item from a list given its index instead of its " -"value: the :keyword:`del` statement. This differs from the :meth:`~list." -"pop` method which returns a value. The :keyword:`!del` statement can also " -"be used to remove slices from a list or clear the entire list (which we did " +"value: the :keyword:`del` statement. This differs from the :meth:`!pop` " +"method which returns a value. The :keyword:`!del` statement can also be " +"used to remove slices from a list or clear the entire list (which we did " "earlier by assignment of an empty list to the slice). For example::" msgstr "" "Değer yerine indeksi verilen bir öğeyi listeden kaldırmanın bir yolu " @@ -798,8 +798,8 @@ msgid "" "can be used as keys if they contain only strings, numbers, or tuples; if a " "tuple contains any mutable object either directly or indirectly, it cannot " "be used as a key. You can't use lists as keys, since lists can be modified " -"in place using index assignments, slice assignments, or methods like :meth:" -"`~list.append` and :meth:`~list.extend`." +"in place using index assignments, slice assignments, or methods like :meth:`!" +"append` and :meth:`!extend`." msgstr "" "Python'da yerleşik olarak bulunan bir başka kullanışlı veri türü de " "*sözlüktür* (bkz :ref:`typesmapping`). Sözlükler bazen diğer dillerde " diff --git a/tutorial/errors.po b/tutorial/errors.po index 85e7eb440..fe46112bf 100644 --- a/tutorial/errors.po +++ b/tutorial/errors.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: 2022-12-28 22:18+0300\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -56,12 +56,12 @@ msgstr "" #: tutorial/errors.rst:26 #, fuzzy msgid "" -"The parser repeats the offending line and displays little 'arrow's pointing " -"at the token in the line where the error was detected. The error may be " -"caused by the absence of a token *before* the indicated token. In the " -"example, the error is detected at the function :func:`print`, since a colon " -"(``':'``) is missing before it. File name and line number are printed so " -"you know where to look in case the input came from a script." +"The parser repeats the offending line and displays little arrows pointing at " +"the token in the line where the error was detected. The error may be caused " +"by the absence of a token *before* the indicated token. In the example, the " +"error is detected at the function :func:`print`, since a colon (``':'``) is " +"missing before it. File name and line number are printed so you know where " +"to look in case the input came from a script." msgstr "" "Ayrıştırıcı, hatalı satırı yineler ve hatanın algılandığı en erken noktayı " "gösteren küçük bir 'ok' görüntüler. Hata oktan *önceki* dizgede meydana " diff --git a/tutorial/introduction.po b/tutorial/introduction.po index b313108fe..a0dd5b3bd 100644 --- a/tutorial/introduction.po +++ b/tutorial/introduction.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: 2024-02-27 22:42+0300\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -357,41 +357,34 @@ msgstr "" "<faq-programming-raw-string-backslash>` 'e bakın." #: tutorial/introduction.rst:197 +#, fuzzy msgid "" "String literals can span multiple lines. One way is using triple-quotes: " "``\"\"\"...\"\"\"`` or ``'''...'''``. End of lines are automatically " "included in the string, but it's possible to prevent this by adding a ``\\`` " -"at the end of the line. The following example::" +"at the end of the line. In the following example, the initial newline is " +"not included::" msgstr "" "Dize sabitleri birden çok satıra yayılabilir. Bunun bir yolu üçlü tırnak " "kullanmaktır: ``\"\"\"...\"\"\"`` veya ``'''...'''``. Satır sonu otomatik " "olarak dizeye dahil edilir, ancak satırın sonuna ``\\`` ekleyerek bunu " "önlemek mümkündür. Aşağıdaki örnek::" -#: tutorial/introduction.rst:202 +#: tutorial/introduction.rst:203 msgid "" -"print(\"\"\"\\\n" +">>> print(\"\"\"\\\n" +"... Usage: thingy [OPTIONS]\n" +"... -h Display this usage message\n" +"... -H hostname Hostname to connect to\n" +"... \"\"\")\n" "Usage: thingy [OPTIONS]\n" " -h Display this usage message\n" " -H hostname Hostname to connect to\n" -"\"\"\")" -msgstr "" - -#: tutorial/introduction.rst:208 -msgid "" -"produces the following output (note that the initial newline is not " -"included):" +"\n" +">>>" msgstr "" -"aşağıdaki çıktıyı üretir (ilk yeni satırın dahil olmadığını unutmayın):" -#: tutorial/introduction.rst:210 -msgid "" -"Usage: thingy [OPTIONS]\n" -" -h Display this usage message\n" -" -H hostname Hostname to connect to" -msgstr "" - -#: tutorial/introduction.rst:216 +#: tutorial/introduction.rst:214 msgid "" "Strings can be concatenated (glued together) with the ``+`` operator, and " "repeated with ``*``::" @@ -399,14 +392,14 @@ msgstr "" "Dizeler ``+`` operatörüyle birleştirilebilir (birbirine yapıştırılabilir) ve " "``*`` ile tekrarlanabilir::" -#: tutorial/introduction.rst:219 +#: tutorial/introduction.rst:217 msgid "" ">>> # 3 times 'un', followed by 'ium'\n" ">>> 3 * 'un' + 'ium'\n" "'unununium'" msgstr "" -#: tutorial/introduction.rst:223 +#: tutorial/introduction.rst:221 msgid "" "Two or more *string literals* (i.e. the ones enclosed between quotes) next " "to each other are automatically concatenated. ::" @@ -414,19 +407,19 @@ msgstr "" "Yan yana iki veya daha fazla *dize sabiti* (yani, tırnak işaretleri arasına " "alınanlar) otomatik olarak birleştirilir. ::" -#: tutorial/introduction.rst:226 +#: tutorial/introduction.rst:224 msgid "" ">>> 'Py' 'thon'\n" "'Python'" msgstr "" -#: tutorial/introduction.rst:229 +#: tutorial/introduction.rst:227 msgid "" "This feature is particularly useful when you want to break long strings::" msgstr "" "Bu özellik, özellikle uzun dizeleri kırmak istediğinizde kullanışlıdır::" -#: tutorial/introduction.rst:231 +#: tutorial/introduction.rst:229 msgid "" ">>> text = ('Put several strings within parentheses '\n" "... 'to have them joined together.')\n" @@ -434,13 +427,13 @@ msgid "" "'Put several strings within parentheses to have them joined together.'" msgstr "" -#: tutorial/introduction.rst:236 +#: tutorial/introduction.rst:234 msgid "" "This only works with two literals though, not with variables or expressions::" msgstr "" "Bu, değişkenler veya ifadelerle değil, yalnızca iki sabit değerle çalışır::" -#: tutorial/introduction.rst:238 +#: tutorial/introduction.rst:236 msgid "" ">>> prefix = 'Py'\n" ">>> prefix 'thon' # can't concatenate a variable and a string literal\n" @@ -455,20 +448,20 @@ msgid "" "SyntaxError: invalid syntax" msgstr "" -#: tutorial/introduction.rst:250 +#: tutorial/introduction.rst:248 msgid "" "If you want to concatenate variables or a variable and a literal, use ``+``::" msgstr "" "Değişkenleri veya bir değişkeni ve bir sabiti birleştirmek istiyorsanız, " "``+`` kullanın:" -#: tutorial/introduction.rst:252 +#: tutorial/introduction.rst:250 msgid "" ">>> prefix + 'thon'\n" "'Python'" msgstr "" -#: tutorial/introduction.rst:255 +#: tutorial/introduction.rst:253 msgid "" "Strings can be *indexed* (subscripted), with the first character having " "index 0. There is no separate character type; a character is simply a string " @@ -478,7 +471,7 @@ msgstr "" "olabilir). Karakterler için ayrı bir tür yoktur; karakterler yalnızca *bir* " "uzunluğunda dizelerdir::" -#: tutorial/introduction.rst:259 +#: tutorial/introduction.rst:257 msgid "" ">>> word = 'Python'\n" ">>> word[0] # character in position 0\n" @@ -487,12 +480,12 @@ msgid "" "'n'" msgstr "" -#: tutorial/introduction.rst:265 +#: tutorial/introduction.rst:263 msgid "" "Indices may also be negative numbers, to start counting from the right::" msgstr "Sağdan saymaya başlamak için indeksler negatif sayılar da olabilir::" -#: tutorial/introduction.rst:267 +#: tutorial/introduction.rst:265 msgid "" ">>> word[-1] # last character\n" "'n'\n" @@ -502,12 +495,12 @@ msgid "" "'P'" msgstr "" -#: tutorial/introduction.rst:274 +#: tutorial/introduction.rst:272 msgid "Note that since -0 is the same as 0, negative indices start from -1." msgstr "" "-0 ile 0 aynı olduğundan, negatif endekslerin -1'den başladığını unutmayın." -#: tutorial/introduction.rst:276 +#: tutorial/introduction.rst:274 #, fuzzy msgid "" "In addition to indexing, *slicing* is also supported. While indexing is " @@ -518,7 +511,7 @@ msgstr "" "etmek için indeksleme kullanılırken, *dilimleme* alt dizeyi elde etmenizi " "sağlar::" -#: tutorial/introduction.rst:279 +#: tutorial/introduction.rst:277 msgid "" ">>> word[0:2] # characters from position 0 (included) to 2 (excluded)\n" "'Py'\n" @@ -526,7 +519,7 @@ msgid "" "'tho'" msgstr "" -#: tutorial/introduction.rst:284 +#: tutorial/introduction.rst:282 msgid "" "Slice indices have useful defaults; an omitted first index defaults to zero, " "an omitted second index defaults to the size of the string being sliced. ::" @@ -535,7 +528,7 @@ msgstr "" "varsayılanı sıfırdır, atlanmış bir ikinci dizin varsayılanı dilimlenmekte " "olan dizenin boyutudur. ::" -#: tutorial/introduction.rst:287 +#: tutorial/introduction.rst:285 msgid "" ">>> word[:2] # character from the beginning to position 2 (excluded)\n" "'Py'\n" @@ -545,7 +538,7 @@ msgid "" "'on'" msgstr "" -#: tutorial/introduction.rst:294 +#: tutorial/introduction.rst:292 msgid "" "Note how the start is always included, and the end always excluded. This " "makes sure that ``s[:i] + s[i:]`` is always equal to ``s``::" @@ -554,7 +547,7 @@ msgstr "" "dikkat edin. Bu, ``s[:i] + s[i:]`` değerinin her zaman ``s`` değerine eşit " "olmasını sağlar::" -#: tutorial/introduction.rst:297 +#: tutorial/introduction.rst:295 msgid "" ">>> word[:2] + word[2:]\n" "'Python'\n" @@ -562,7 +555,7 @@ msgid "" "'Python'" msgstr "" -#: tutorial/introduction.rst:302 +#: tutorial/introduction.rst:300 msgid "" "One way to remember how slices work is to think of the indices as pointing " "*between* characters, with the left edge of the first character numbered 0. " @@ -574,7 +567,7 @@ msgstr "" "Ardından, *n* karakterli bir dizenin son karakterinin sağ kenarında *n* " "dizini vardır, örneğin::" -#: tutorial/introduction.rst:307 +#: tutorial/introduction.rst:305 msgid "" " +---+---+---+---+---+---+\n" " | P | y | t | h | o | n |\n" @@ -583,7 +576,7 @@ msgid "" "-6 -5 -4 -3 -2 -1" msgstr "" -#: tutorial/introduction.rst:313 +#: tutorial/introduction.rst:311 msgid "" "The first row of numbers gives the position of the indices 0...6 in the " "string; the second row gives the corresponding negative indices. The slice " @@ -594,7 +587,7 @@ msgstr "" "karşılık gelen negatif endeksleri verir. *i* ile *j* arasındaki dilim, " "sırasıyla *i* ve *j* etiketli kenarlar arasındaki tüm karakterlerden oluşur." -#: tutorial/introduction.rst:318 +#: tutorial/introduction.rst:316 msgid "" "For non-negative indices, the length of a slice is the difference of the " "indices, if both are within bounds. For example, the length of " @@ -603,11 +596,11 @@ msgstr "" "Negatif olmayan indeksler için, her ikisi de sınırlar içindeyse, bir dilimin " "uzunluğu indekslerin farkıdır. Örneğin, ``kelime[1:3]`` 'ün uzunluğu 2'dir." -#: tutorial/introduction.rst:322 +#: tutorial/introduction.rst:320 msgid "Attempting to use an index that is too large will result in an error::" msgstr "Çok büyük bir dizin kullanmaya çalışmak bir hataya neden olur::" -#: tutorial/introduction.rst:324 +#: tutorial/introduction.rst:322 msgid "" ">>> word[42] # the word only has 6 characters\n" "Traceback (most recent call last):\n" @@ -615,7 +608,7 @@ msgid "" "IndexError: string index out of range" msgstr "" -#: tutorial/introduction.rst:329 +#: tutorial/introduction.rst:327 msgid "" "However, out of range slice indexes are handled gracefully when used for " "slicing::" @@ -623,7 +616,7 @@ msgstr "" "Ancak, aralık dışı dilim endeksleri, dilimleme için kullanıldığında zarif " "bir şekilde işlenir::" -#: tutorial/introduction.rst:332 +#: tutorial/introduction.rst:330 msgid "" ">>> word[4:42]\n" "'on'\n" @@ -631,7 +624,7 @@ msgid "" "''" msgstr "" -#: tutorial/introduction.rst:337 +#: tutorial/introduction.rst:335 msgid "" "Python strings cannot be changed --- they are :term:`immutable`. Therefore, " "assigning to an indexed position in the string results in an error::" @@ -639,7 +632,7 @@ msgstr "" "Python dizeleri değiştirilemez --- bunlar :term:`immutable` 'dır. Bu " "nedenle, dizide dizine alınmış bir konuma atamak bir hatayla sonuçlanır::" -#: tutorial/introduction.rst:340 +#: tutorial/introduction.rst:338 msgid "" ">>> word[0] = 'J'\n" "Traceback (most recent call last):\n" @@ -651,11 +644,11 @@ msgid "" "TypeError: 'str' object does not support item assignment" msgstr "" -#: tutorial/introduction.rst:349 +#: tutorial/introduction.rst:347 msgid "If you need a different string, you should create a new one::" msgstr "Farklı bir dizeye ihtiyacınız varsa, yeni bir tane oluşturmalısınız::" -#: tutorial/introduction.rst:351 +#: tutorial/introduction.rst:349 msgid "" ">>> 'J' + word[1:]\n" "'Jython'\n" @@ -663,22 +656,22 @@ msgid "" "'Pypy'" msgstr "" -#: tutorial/introduction.rst:356 +#: tutorial/introduction.rst:354 msgid "The built-in function :func:`len` returns the length of a string::" msgstr "Yerleşik işlev :func:`len`, bir dizenin uzunluğunu döndürür::" -#: tutorial/introduction.rst:358 +#: tutorial/introduction.rst:356 msgid "" ">>> s = 'supercalifragilisticexpialidocious'\n" ">>> len(s)\n" "34" msgstr "" -#: tutorial/introduction.rst:365 +#: tutorial/introduction.rst:363 msgid ":ref:`textseq`" msgstr ":ref:`textseq`" -#: tutorial/introduction.rst:366 +#: tutorial/introduction.rst:364 msgid "" "Strings are examples of *sequence types*, and support the common operations " "supported by such types." @@ -686,37 +679,37 @@ msgstr "" "Dizeler, *sıra türlerinin* örnekleridir ve bu türler tarafından desteklenen " "genel işlemleri destekler." -#: tutorial/introduction.rst:369 +#: tutorial/introduction.rst:367 msgid ":ref:`string-methods`" msgstr ":ref:`dize-yöntemleri <string-methods>`" -#: tutorial/introduction.rst:370 +#: tutorial/introduction.rst:368 msgid "" "Strings support a large number of methods for basic transformations and " "searching." msgstr "Dizeler, temel dönüşümler ve arama için çok sayıda yöntemi destekler." -#: tutorial/introduction.rst:373 +#: tutorial/introduction.rst:371 msgid ":ref:`f-strings`" msgstr ":ref:`f-strings`" -#: tutorial/introduction.rst:374 +#: tutorial/introduction.rst:372 msgid "String literals that have embedded expressions." msgstr "Gömülü ifadelere sahip dize sabitleri." -#: tutorial/introduction.rst:376 +#: tutorial/introduction.rst:374 msgid ":ref:`formatstrings`" msgstr ":ref:`formatstrings`" -#: tutorial/introduction.rst:377 +#: tutorial/introduction.rst:375 msgid "Information about string formatting with :meth:`str.format`." msgstr ":meth:`str.format` ile dize biçimlendirme hakkında bilgi." -#: tutorial/introduction.rst:379 +#: tutorial/introduction.rst:377 msgid ":ref:`old-string-formatting`" msgstr ":ref:`old-string-formatting`" -#: tutorial/introduction.rst:380 +#: tutorial/introduction.rst:378 msgid "" "The old formatting operations invoked when strings are the left operand of " "the ``%`` operator are described in more detail here." @@ -724,11 +717,11 @@ msgstr "" "Dizeler ``%`` operatörünün sol işleneni olduğunda çağrılan eski " "biçimlendirme işlemleri burada daha ayrıntılı olarak açıklanmaktadır." -#: tutorial/introduction.rst:387 +#: tutorial/introduction.rst:385 msgid "Lists" msgstr "Listeler" -#: tutorial/introduction.rst:389 +#: tutorial/introduction.rst:387 msgid "" "Python knows a number of *compound* data types, used to group together other " "values. The most versatile is the *list*, which can be written as a list of " @@ -741,14 +734,14 @@ msgstr "" "Listeler farklı türde ögeler içerebilir, ancak genellikle ögelerin tümü aynı " "türdedir. ::" -#: tutorial/introduction.rst:394 +#: tutorial/introduction.rst:392 msgid "" ">>> squares = [1, 4, 9, 16, 25]\n" ">>> squares\n" "[1, 4, 9, 16, 25]" msgstr "" -#: tutorial/introduction.rst:398 +#: tutorial/introduction.rst:396 msgid "" "Like strings (and all other built-in :term:`sequence` types), lists can be " "indexed and sliced::" @@ -756,7 +749,7 @@ msgstr "" "Dizeler gibi (ve diğer tüm yerleşik :term:`sequence` türleri), listeler " "dizine alınabilir ve dilimlenebilir::" -#: tutorial/introduction.rst:401 +#: tutorial/introduction.rst:399 msgid "" ">>> squares[0] # indexing returns the item\n" "1\n" @@ -766,17 +759,17 @@ msgid "" "[9, 16, 25]" msgstr "" -#: tutorial/introduction.rst:408 +#: tutorial/introduction.rst:406 msgid "Lists also support operations like concatenation::" msgstr "Ayrıca listeler birleştirme gibi işlemleri de destekler::" -#: tutorial/introduction.rst:410 +#: tutorial/introduction.rst:408 msgid "" ">>> squares + [36, 49, 64, 81, 100]\n" "[1, 4, 9, 16, 25, 36, 49, 64, 81, 100]" msgstr "" -#: tutorial/introduction.rst:413 +#: tutorial/introduction.rst:411 msgid "" "Unlike strings, which are :term:`immutable`, lists are a :term:`mutable` " "type, i.e. it is possible to change their content::" @@ -784,7 +777,7 @@ msgstr "" ":term:`immutable` olan dizelerin aksine, listeler :term:`mutable` " "türündedir, yani içeriklerini değiştirmek mümkündür::" -#: tutorial/introduction.rst:416 +#: tutorial/introduction.rst:414 msgid "" ">>> cubes = [1, 8, 27, 65, 125] # something's wrong here\n" ">>> 4 ** 3 # the cube of 4 is 64, not 65!\n" @@ -794,7 +787,7 @@ msgid "" "[1, 8, 27, 64, 125]" msgstr "" -#: tutorial/introduction.rst:423 +#: tutorial/introduction.rst:421 #, fuzzy msgid "" "You can also add new items at the end of the list, by using the :meth:`!list." @@ -804,7 +797,7 @@ msgstr "" "öğeler ekleyebilirsiniz (yöntemler hakkında daha fazla bilgiyi daha sonra " "göreceğiz)::" -#: tutorial/introduction.rst:426 +#: tutorial/introduction.rst:424 msgid "" ">>> cubes.append(216) # add the cube of 6\n" ">>> cubes.append(7 ** 3) # and the cube of 7\n" @@ -812,7 +805,7 @@ msgid "" "[1, 8, 27, 64, 125, 216, 343]" msgstr "" -#: tutorial/introduction.rst:431 +#: tutorial/introduction.rst:429 msgid "" "Simple assignment in Python never copies data. When you assign a list to a " "variable, the variable refers to the *existing list*. Any changes you make " @@ -820,7 +813,7 @@ msgid "" "that refer to it.::" msgstr "" -#: tutorial/introduction.rst:436 +#: tutorial/introduction.rst:434 msgid "" ">>> rgb = [\"Red\", \"Green\", \"Blue\"]\n" ">>> rgba = rgb\n" @@ -831,7 +824,7 @@ msgid "" "[\"Red\", \"Green\", \"Blue\", \"Alph\"]" msgstr "" -#: tutorial/introduction.rst:444 +#: tutorial/introduction.rst:442 msgid "" "All slice operations return a new list containing the requested elements. " "This means that the following slice returns a :ref:`shallow copy " @@ -841,7 +834,7 @@ msgstr "" "aşağıdaki dilimin listenin bir :ref:`shallow copy <shallow_vs_deep_copy>` " "döndürdüğü anlamına gelir::" -#: tutorial/introduction.rst:448 +#: tutorial/introduction.rst:446 msgid "" ">>> correct_rgba = rgba[:]\n" ">>> correct_rgba[-1] = \"Alpha\"\n" @@ -851,7 +844,7 @@ msgid "" "[\"Red\", \"Green\", \"Blue\", \"Alph\"]" msgstr "" -#: tutorial/introduction.rst:455 +#: tutorial/introduction.rst:453 msgid "" "Assignment to slices is also possible, and this can even change the size of " "the list or clear it entirely::" @@ -859,7 +852,7 @@ msgstr "" "Dilimlere atama da mümkündür ve bu, listenin boyutunu bile değiştirebilir " "veya tamamen temizleyebilir::" -#: tutorial/introduction.rst:458 +#: tutorial/introduction.rst:456 msgid "" ">>> letters = ['a', 'b', 'c', 'd', 'e', 'f', 'g']\n" ">>> letters\n" @@ -878,18 +871,18 @@ msgid "" "[]" msgstr "" -#: tutorial/introduction.rst:474 +#: tutorial/introduction.rst:472 msgid "The built-in function :func:`len` also applies to lists::" msgstr "Yerleşik işlev :func:`len` ayrıca listeler için de geçerlidir::" -#: tutorial/introduction.rst:476 +#: tutorial/introduction.rst:474 msgid "" ">>> letters = ['a', 'b', 'c', 'd']\n" ">>> len(letters)\n" "4" msgstr "" -#: tutorial/introduction.rst:480 +#: tutorial/introduction.rst:478 msgid "" "It is possible to nest lists (create lists containing other lists), for " "example::" @@ -897,7 +890,7 @@ msgstr "" "Listeleri iç içe yerleştirmek (diğer listeleri içeren listeler oluşturmak) " "mümkündür, örneğin::" -#: tutorial/introduction.rst:483 +#: tutorial/introduction.rst:481 msgid "" ">>> a = ['a', 'b', 'c']\n" ">>> n = [1, 2, 3]\n" @@ -910,11 +903,11 @@ msgid "" "'b'" msgstr "" -#: tutorial/introduction.rst:496 +#: tutorial/introduction.rst:494 msgid "First Steps Towards Programming" msgstr "Programlamaya Doğru İlk Adımlar" -#: tutorial/introduction.rst:498 +#: tutorial/introduction.rst:496 msgid "" "Of course, we can use Python for more complicated tasks than adding two and " "two together. For instance, we can write an initial sub-sequence of the " @@ -925,7 +918,7 @@ msgstr "" "kullanabiliriz. Örneğin, `Fibonacci serisinin <https://en.wikipedia.org/wiki/" "Fibonacci_sequence>`_ ilk alt dizisini aşağıdaki gibi yazabiliriz:" -#: tutorial/introduction.rst:503 +#: tutorial/introduction.rst:501 msgid "" ">>> # Fibonacci series:\n" ">>> # the sum of two elements defines the next\n" @@ -943,11 +936,11 @@ msgid "" "8" msgstr "" -#: tutorial/introduction.rst:518 +#: tutorial/introduction.rst:516 msgid "This example introduces several new features." msgstr "Bu örnek, birkaç yeni özellik sunar." -#: tutorial/introduction.rst:520 +#: tutorial/introduction.rst:518 msgid "" "The first line contains a *multiple assignment*: the variables ``a`` and " "``b`` simultaneously get the new values 0 and 1. On the last line this is " @@ -959,7 +952,7 @@ msgstr "" "1 değerlerini alır. Tarafların tümü, herhangi bir görev yapılmadan önce " "değerlendirilir. Sağ taraftaki ifadeler soldan sağa doğru değerlendirilir." -#: tutorial/introduction.rst:526 +#: tutorial/introduction.rst:524 msgid "" "The :keyword:`while` loop executes as long as the condition (here: ``a < " "10``) remains true. In Python, like in C, any non-zero integer value is " @@ -979,7 +972,7 @@ msgstr "" "(küçüktür), ``>`` (büyüktür), ``==`` (eşittir), ``<=`` ( küçük veya eşit), " "``>=`` (büyük veya eşit) ve ``!=`` (eşit değil)." -#: tutorial/introduction.rst:535 +#: tutorial/introduction.rst:533 msgid "" "The *body* of the loop is *indented*: indentation is Python's way of " "grouping statements. At the interactive prompt, you have to type a tab or " @@ -1000,7 +993,7 @@ msgstr "" "tahmin edemez). Bir temel blok içindeki her satırın aynı miktarda girintili " "olması gerektiğini unutmayın." -#: tutorial/introduction.rst:544 +#: tutorial/introduction.rst:542 #, fuzzy msgid "" "The :func:`print` function writes the value of the argument(s) it is given. " @@ -1017,14 +1010,14 @@ msgstr "" "işaretleri olmadan yazdırılır ve öğelerin arasına bir boşluk eklenir, " "böylece şunları güzel bir şekilde biçimlendirebilirsiniz:" -#: tutorial/introduction.rst:551 +#: tutorial/introduction.rst:549 msgid "" ">>> i = 256*256\n" ">>> print('The value of i is', i)\n" "The value of i is 65536" msgstr "" -#: tutorial/introduction.rst:555 +#: tutorial/introduction.rst:553 msgid "" "The keyword argument *end* can be used to avoid the newline after the " "output, or end the output with a different string::" @@ -1032,7 +1025,7 @@ msgstr "" "*end* anahtar sözcüğü argümanı, çıktıdan sonra yeni satırı önlemek veya " "çıktıyı farklı bir dizeyle bitirmek için kullanılabilir::" -#: tutorial/introduction.rst:558 +#: tutorial/introduction.rst:556 msgid "" ">>> a, b = 0, 1\n" ">>> while a < 1000:\n" @@ -1042,11 +1035,11 @@ msgid "" "0,1,1,2,3,5,8,13,21,34,55,89,144,233,377,610,987," msgstr "" -#: tutorial/introduction.rst:567 +#: tutorial/introduction.rst:565 msgid "Footnotes" msgstr "Dipnotlar" -#: tutorial/introduction.rst:568 +#: tutorial/introduction.rst:566 msgid "" "Since ``**`` has higher precedence than ``-``, ``-3**2`` will be interpreted " "as ``-(3**2)`` and thus result in ``-9``. To avoid this and get ``9``, you " @@ -1056,7 +1049,7 @@ msgstr "" "(3**2)`` olarak yorumlanacak ve dolayısıyla ``-9`` ile sonuçlanacaktır. " "Bundan kaçınmak ve ``9`` elde etmek için ``(-3)**2`` kullanabilirsiniz." -#: tutorial/introduction.rst:572 +#: tutorial/introduction.rst:570 msgid "" "Unlike other languages, special characters such as ``\\n`` have the same " "meaning with both single (``'...'``) and double (``\"...\"``) quotes. The " @@ -1077,6 +1070,12 @@ msgstr "" msgid "comment" msgstr "yorum" +#~ msgid "" +#~ "produces the following output (note that the initial newline is not " +#~ "included):" +#~ msgstr "" +#~ "aşağıdaki çıktıyı üretir (ilk yeni satırın dahil olmadığını unutmayın):" + #~ msgid "Strings" #~ msgstr "Dizeler" diff --git a/using/configure.po b/using/configure.po index b1c0bfa8b..e556d6a9a 100644 --- a/using/configure.po +++ b/using/configure.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -691,7 +691,7 @@ msgid "Define the ``Py_TRACE_REFS`` macro." msgstr "" #: using/configure.rst:462 -msgid "Add :func:`!sys.getobjects` function." +msgid "Add :func:`sys.getobjects` function." msgstr "" #: using/configure.rst:463 diff --git a/using/windows.po b/using/windows.po index ed72df740..819cd1bae 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: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -804,7 +804,7 @@ msgid "" "For more detail on the technical basis for these limitations, please consult " "Microsoft's documentation on packaged full-trust apps, currently available " "at `docs.microsoft.com/en-us/windows/msix/desktop/desktop-to-uwp-behind-the-" -"scenes <https://docs.microsoft.com/en-us/windows/msix/desktop/desktop-to-uwp-" +"scenes <https://learn.microsoft.com/windows/msix/desktop/desktop-to-uwp-" "behind-the-scenes>`_" msgstr "" @@ -911,7 +911,7 @@ msgstr "" #: using/windows.rst:477 msgid "" "The embedded distribution does not include the `Microsoft C Runtime <https://" -"docs.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist#visual-" +"learn.microsoft.com/cpp/windows/latest-supported-vc-redist#visual-" "studio-2015-2017-2019-and-2022>`_ and it is the responsibility of the " "application installer to provide this. The runtime may have already been " "installed on a user's system previously or automatically via Windows Update, " @@ -1137,8 +1137,7 @@ msgstr "" #: using/windows.rst:621 msgid "" -"https://docs.microsoft.com/en-us/windows/win32/procthread/environment-" -"variables" +"https://learn.microsoft.com/windows/win32/procthread/environment-variables" msgstr "" #: using/windows.rst:622 @@ -1147,8 +1146,8 @@ msgstr "" #: using/windows.rst:624 msgid "" -"https://docs.microsoft.com/en-us/windows-server/administration/windows-" -"commands/set_1" +"https://learn.microsoft.com/windows-server/administration/windows-commands/" +"set_1" msgstr "" #: using/windows.rst:625 @@ -1157,8 +1156,8 @@ msgstr "" #: using/windows.rst:627 msgid "" -"https://docs.microsoft.com/en-us/windows-server/administration/windows-" -"commands/setx" +"https://learn.microsoft.com/windows-server/administration/windows-commands/" +"setx" msgstr "" #: using/windows.rst:628 @@ -2124,7 +2123,7 @@ msgstr "" #: using/windows.rst:1224 msgid "" -"`Component Object Model <https://docs.microsoft.com/en-us/windows/win32/com/" +"`Component Object Model <https://learn.microsoft.com/windows/win32/com/" "component-object-model--com--portal>`_ (COM)" msgstr "" @@ -2142,7 +2141,7 @@ msgstr "" #: using/windows.rst:1230 msgid "" -"`Microsoft Foundation Classes <https://docs.microsoft.com/en-us/cpp/mfc/mfc-" +"`Microsoft Foundation Classes <https://learn.microsoft.com/cpp/mfc/mfc-" "desktop-applications>`_ (MFC) user interfaces" msgstr "" diff --git a/whatsnew/3.0.po b/whatsnew/3.0.po index 87b29d22c..a8a5915c3 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -157,7 +157,7 @@ msgstr "" #: whatsnew/3.0.rst:153 msgid "" -"Also, the :meth:`dict.iterkeys`, :meth:`dict.iteritems` and :meth:`dict." +"Also, the :meth:`!dict.iterkeys`, :meth:`!dict.iteritems` and :meth:`!dict." "itervalues` methods are no longer supported." msgstr "" @@ -184,7 +184,7 @@ msgstr "" #: whatsnew/3.0.rst:173 msgid "" -":func:`range` now behaves like :func:`xrange` used to behave, except it " +":func:`range` now behaves like :func:`!xrange` used to behave, except it " "works with values of arbitrary size. The latter no longer exists." msgstr "" @@ -214,18 +214,19 @@ msgstr "" #: whatsnew/3.0.rst:195 msgid "" -":meth:`builtin.sorted` and :meth:`list.sort` no longer accept the *cmp* " -"argument providing a comparison function. Use the *key* argument instead. N." -"B. the *key* and *reverse* arguments are now \"keyword-only\"." +":meth:`sorted` and :meth:`list.sort` no longer accept the *cmp* argument " +"providing a comparison function. Use the *key* argument instead. N.B. the " +"*key* and *reverse* arguments are now \"keyword-only\"." msgstr "" #: whatsnew/3.0.rst:200 msgid "" -"The :func:`cmp` function should be treated as gone, and the :meth:`__cmp__` " -"special method is no longer supported. Use :meth:`__lt__` for sorting, :" -"meth:`__eq__` with :meth:`__hash__`, and other rich comparisons as needed. " -"(If you really need the :func:`cmp` functionality, you could use the " -"expression ``(a > b) - (a < b)`` as the equivalent for ``cmp(a, b)``.)" +"The :func:`!cmp` function should be treated as gone, and the :meth:`!" +"__cmp__` special method is no longer supported. Use :meth:`~object.__lt__` " +"for sorting, :meth:`~object.__eq__` with :meth:`~object.__hash__`, and other " +"rich comparisons as needed. (If you really need the :func:`!cmp` " +"functionality, you could use the expression ``(a > b) - (a < b)`` as the " +"equivalent for ``cmp(a, b)``.)" msgstr "" #: whatsnew/3.0.rst:207 @@ -234,9 +235,9 @@ msgstr "" #: whatsnew/3.0.rst:209 msgid "" -":pep:`237`: Essentially, :class:`long` renamed to :class:`int`. That is, " +":pep:`237`: Essentially, :class:`!long` renamed to :class:`int`. That is, " "there is only one built-in integral type, named :class:`int`; but it behaves " -"mostly like the old :class:`long` type." +"mostly like the old :class:`!long` type." msgstr "" #: whatsnew/3.0.rst:213 @@ -248,11 +249,11 @@ msgstr "" #: whatsnew/3.0.rst:217 msgid "" -"The :data:`sys.maxint` constant was removed, since there is no longer a " +"The :data:`!sys.maxint` constant was removed, since there is no longer a " "limit to the value of integers. However, :data:`sys.maxsize` can be used as " "an integer larger than any practical list or string index. It conforms to " "the implementation's \"natural\" integer size and is typically the same as :" -"data:`sys.maxint` in previous releases on the same platform (assuming the " +"data:`!sys.maxint` in previous releases on the same platform (assuming the " "same build options)." msgstr "" @@ -297,7 +298,7 @@ msgid "" "uses Unicode, encodings or binary data most likely has to change. The " "change is for the better, as in the 2.x world there were numerous bugs " "having to do with mixing encoded and unencoded text. To be prepared in " -"Python 2.x, start using :class:`unicode` for all unencoded text, and :class:" +"Python 2.x, start using :class:`!unicode` for all unencoded text, and :class:" "`str` for binary or encoded data only. Then the ``2to3`` tool will do most " "of the work for you." msgstr "" @@ -322,7 +323,8 @@ msgid "" "Like :class:`str`, the :class:`bytes` type is immutable. There is a " "separate *mutable* type to hold buffered binary data, :class:`bytearray`. " "Nearly all APIs that accept :class:`bytes` also accept :class:`bytearray`. " -"The mutable API is based on :class:`collections.MutableSequence`." +"The mutable API is based on :class:`collections.MutableSequence <collections." +"abc.MutableSequence>`." msgstr "" #: whatsnew/3.0.rst:274 @@ -337,10 +339,10 @@ msgstr "" #: whatsnew/3.0.rst:281 msgid "" -"The built-in :class:`basestring` abstract type was removed. Use :class:" +"The built-in :class:`!basestring` abstract type was removed. Use :class:" "`str` instead. The :class:`str` and :class:`bytes` types don't have " "functionality enough in common to warrant a shared base class. The ``2to3`` " -"tool (see below) replaces every occurrence of :class:`basestring` with :" +"tool (see below) replaces every occurrence of :class:`!basestring` with :" "class:`str`." msgstr "" @@ -442,9 +444,9 @@ msgid "" ":pep:`3107`: Function argument and return value annotations. This provides " "a standardized way of annotating a function's parameters and return value. " "There are no semantics attached to such annotations except that they can be " -"introspected at runtime using the :attr:`~object.__annotations__` " -"attribute. The intent is to encourage experimentation through metaclasses, " -"decorators or frameworks." +"introspected at runtime using the :attr:`!__annotations__` attribute. The " +"intent is to encourage experimentation through metaclasses, decorators or " +"frameworks." msgstr "" #: whatsnew/3.0.rst:363 @@ -570,7 +572,7 @@ msgstr "" #: whatsnew/3.0.rst:431 msgid "" -"The module-global :data:`__metaclass__` variable is no longer supported. " +"The module-global :data:`!__metaclass__` variable is no longer supported. " "(It was a crutch to make it easier to default to new-style classes without " "deriving every class from :class:`object`.)" msgstr "" @@ -714,15 +716,15 @@ msgid "" "and has additional keyword arguments *encoding*, *errors*, *newline* and " "*closefd*. Also note that an invalid *mode* argument now raises :exc:" "`ValueError`, not :exc:`IOError`. The binary file object underlying a text " -"file object can be accessed as :attr:`f.buffer` (but beware that the text " +"file object can be accessed as :attr:`!f.buffer` (but beware that the text " "object maintains a buffer of itself in order to speed up the encoding and " "decoding operations)." msgstr "" #: whatsnew/3.0.rst:529 msgid "" -":ref:`pep-3118`. The old builtin :func:`buffer` is now really gone; the new " -"builtin :func:`memoryview` provides (mostly) similar functionality." +":ref:`pep-3118`. The old builtin :func:`!buffer` is now really gone; the " +"new builtin :func:`memoryview` provides (mostly) similar functionality." msgstr "" #: whatsnew/3.0.rst:533 @@ -730,8 +732,9 @@ msgid "" ":ref:`pep-3119`. The :mod:`abc` module and the ABCs defined in the :mod:" "`collections` module plays a somewhat more prominent role in the language " "now, and built-in collection types like :class:`dict` and :class:`list` " -"conform to the :class:`collections.MutableMapping` and :class:`collections." -"MutableSequence` ABCs, respectively." +"conform to the :class:`collections.MutableMapping <collections.abc." +"MutableMapping>` and :class:`collections.MutableSequence <collections.abc." +"MutableSequence>` ABCs, respectively." msgstr "" #: whatsnew/3.0.rst:539 @@ -898,10 +901,10 @@ msgstr "" #: whatsnew/3.0.rst:615 msgid "" -":mod:`tkinter` (all :mod:`Tkinter`-related modules except :mod:`turtle`). " -"The target audience of :mod:`turtle` doesn't really care about :mod:" -"`tkinter`. Also note that as of Python 2.6, the functionality of :mod:" -"`turtle` has been greatly enhanced." +":mod:`tkinter` (all ``Tkinter``-related modules except :mod:`turtle`). The " +"target audience of :mod:`turtle` doesn't really care about :mod:`tkinter`. " +"Also note that as of Python 2.6, the functionality of :mod:`turtle` has been " +"greatly enhanced." msgstr "" #: whatsnew/3.0.rst:620 @@ -927,23 +930,23 @@ msgstr "" #: whatsnew/3.0.rst:631 msgid "" -"Cleanup of the :mod:`sys` module: removed :func:`sys.exitfunc`, :func:`sys." -"exc_clear`, :data:`sys.exc_type`, :data:`sys.exc_value`, :data:`sys." +"Cleanup of the :mod:`sys` module: removed :func:`!sys.exitfunc`, :func:`!sys." +"exc_clear`, :data:`!sys.exc_type`, :data:`!sys.exc_value`, :data:`!sys." "exc_traceback`. (Note that :data:`sys.last_type` etc. remain.)" msgstr "" #: whatsnew/3.0.rst:636 msgid "" -"Cleanup of the :class:`array.array` type: the :meth:`read` and :meth:`write` " -"methods are gone; use :meth:`fromfile` and :meth:`tofile` instead. Also, " -"the ``'c'`` typecode for array is gone -- use either ``'b'`` for bytes or " -"``'u'`` for Unicode characters." +"Cleanup of the :class:`array.array` type: the :meth:`!read` and :meth:`!" +"write` methods are gone; use :meth:`~array.array.fromfile` and :meth:`~array." +"array.tofile` instead. Also, the ``'c'`` typecode for array is gone -- use " +"either ``'b'`` for bytes or ``'u'`` for Unicode characters." msgstr "" #: whatsnew/3.0.rst:642 msgid "" -"Cleanup of the :mod:`operator` module: removed :func:`sequenceIncludes` and :" -"func:`isCallable`." +"Cleanup of the :mod:`operator` module: removed :func:`!sequenceIncludes` " +"and :func:`!isCallable`." msgstr "" #: whatsnew/3.0.rst:645 @@ -954,7 +957,8 @@ msgid "" msgstr "" #: whatsnew/3.0.rst:649 -msgid "Cleanup of the :mod:`random` module: removed the :func:`jumpahead` API." +msgid "" +"Cleanup of the :mod:`random` module: removed the :func:`!jumpahead` API." msgstr "" #: whatsnew/3.0.rst:651 @@ -963,8 +967,8 @@ msgstr "" #: whatsnew/3.0.rst:653 msgid "" -"The functions :func:`os.tmpnam`, :func:`os.tempnam` and :func:`os.tmpfile` " -"have been removed in favor of the :mod:`tempfile` module." +"The functions :func:`!os.tmpnam`, :func:`!os.tempnam` and :func:`!os." +"tmpfile` have been removed in favor of the :mod:`tempfile` module." msgstr "" #: whatsnew/3.0.rst:657 @@ -975,19 +979,19 @@ msgstr "" #: whatsnew/3.0.rst:661 msgid "" -":data:`string.letters` and its friends (:data:`string.lowercase` and :data:" -"`string.uppercase`) are gone. Use :data:`string.ascii_letters` etc. " -"instead. (The reason for the removal is that :data:`string.letters` and " +":data:`!string.letters` and its friends (:data:`!string.lowercase` and :data:" +"`!string.uppercase`) are gone. Use :data:`string.ascii_letters` etc. " +"instead. (The reason for the removal is that :data:`!string.letters` and " "friends had locale-specific behavior, which is a bad idea for such " "attractively named global \"constants\".)" msgstr "" #: whatsnew/3.0.rst:668 msgid "" -"Renamed module :mod:`__builtin__` to :mod:`builtins` (removing the " -"underscores, adding an 's'). The :data:`__builtins__` variable found in " +"Renamed module :mod:`!__builtin__` to :mod:`builtins` (removing the " +"underscores, adding an 's'). The :data:`!__builtins__` variable found in " "most global namespaces is unchanged. To modify a builtin, you should use :" -"mod:`builtins`, not :data:`__builtins__`!" +"mod:`builtins`, not :data:`!__builtins__`!" msgstr "" #: whatsnew/3.0.rst:675 @@ -1032,13 +1036,13 @@ msgid "" msgstr "" #: whatsnew/3.0.rst:705 -msgid ":exc:`StandardError` was removed." +msgid ":exc:`!StandardError` was removed." msgstr "" #: whatsnew/3.0.rst:707 msgid "" -"Exceptions no longer behave as sequences. Use the :attr:`args` attribute " -"instead." +"Exceptions no longer behave as sequences. Use the :attr:`~BaseException." +"args` attribute instead." msgstr "" #: whatsnew/3.0.rst:710 @@ -1124,10 +1128,10 @@ msgstr "" #: whatsnew/3.0.rst:768 msgid "" -":meth:`__getslice__`, :meth:`__setslice__` and :meth:`__delslice__` were " +":meth:`!__getslice__`, :meth:`!__setslice__` and :meth:`!__delslice__` were " "killed. The syntax ``a[i:j]`` now translates to ``a.__getitem__(slice(i, " -"j))`` (or :meth:`__setitem__` or :meth:`__delitem__`, when used as an " -"assignment or deletion target, respectively)." +"j))`` (or :meth:`~object.__setitem__` or :meth:`~object.__delitem__`, when " +"used as an assignment or deletion target, respectively)." msgstr "" #: whatsnew/3.0.rst:774 @@ -1138,13 +1142,13 @@ msgstr "" #: whatsnew/3.0.rst:777 msgid "" -"The :meth:`__oct__` and :meth:`__hex__` special methods are removed -- :func:" -"`oct` and :func:`hex` use :meth:`__index__` now to convert the argument to " -"an integer." +"The :meth:`!__oct__` and :meth:`!__hex__` special methods are removed -- :" +"func:`oct` and :func:`hex` use :meth:`~object.__index__` now to convert the " +"argument to an integer." msgstr "" #: whatsnew/3.0.rst:781 -msgid "Removed support for :attr:`__members__` and :attr:`__methods__`." +msgid "Removed support for :attr:`!__members__` and :attr:`!__methods__`." msgstr "" #: whatsnew/3.0.rst:783 @@ -1178,7 +1182,7 @@ msgstr "" #: whatsnew/3.0.rst:805 msgid "" -":pep:`3111`: :func:`raw_input` was renamed to :func:`input`. That is, the " +":pep:`3111`: :func:`!raw_input` was renamed to :func:`input`. That is, the " "new :func:`input` function reads a line from :data:`sys.stdin` and returns " "it with the trailing newline stripped. It raises :exc:`EOFError` if the " "input is terminated prematurely. To get the old behavior of :func:`input`, " @@ -1203,53 +1207,53 @@ msgid "" msgstr "" #: whatsnew/3.0.rst:823 -msgid "Moved :func:`intern` to :func:`sys.intern`." +msgid "Moved :func:`!intern` to :func:`sys.intern`." msgstr "" #: whatsnew/3.0.rst:825 msgid "" -"Removed: :func:`apply`. Instead of ``apply(f, args)`` use ``f(*args)``." +"Removed: :func:`!apply`. Instead of ``apply(f, args)`` use ``f(*args)``." msgstr "" #: whatsnew/3.0.rst:828 msgid "" "Removed :func:`callable`. Instead of ``callable(f)`` you can use " -"``isinstance(f, collections.Callable)``. The :func:`operator.isCallable` " +"``isinstance(f, collections.Callable)``. The :func:`!operator.isCallable` " "function is also gone." msgstr "" #: whatsnew/3.0.rst:832 msgid "" -"Removed :func:`coerce`. This function no longer serves a purpose now that " +"Removed :func:`!coerce`. This function no longer serves a purpose now that " "classic classes are gone." msgstr "" #: whatsnew/3.0.rst:835 msgid "" -"Removed :func:`execfile`. Instead of ``execfile(fn)`` use ``exec(open(fn)." +"Removed :func:`!execfile`. Instead of ``execfile(fn)`` use ``exec(open(fn)." "read())``." msgstr "" #: whatsnew/3.0.rst:838 msgid "" -"Removed the :class:`file` type. Use :func:`open`. There are now several " +"Removed the :class:`!file` type. Use :func:`open`. There are now several " "different kinds of streams that open can return in the :mod:`io` module." msgstr "" #: whatsnew/3.0.rst:841 msgid "" -"Removed :func:`reduce`. Use :func:`functools.reduce` if you really need it; " -"however, 99 percent of the time an explicit :keyword:`for` loop is more " +"Removed :func:`!reduce`. Use :func:`functools.reduce` if you really need " +"it; however, 99 percent of the time an explicit :keyword:`for` loop is more " "readable." msgstr "" #: whatsnew/3.0.rst:845 -msgid "Removed :func:`reload`. Use :func:`!imp.reload`." +msgid "Removed :func:`!reload`. Use :func:`!imp.reload`." msgstr "" #: whatsnew/3.0.rst:847 msgid "" -"Removed. :meth:`dict.has_key` -- use the :keyword:`in` operator instead." +"Removed. :meth:`!dict.has_key` -- use the :keyword:`in` operator instead." msgstr "" #: whatsnew/3.0.rst:854 diff --git a/whatsnew/3.12.po b/whatsnew/3.12.po index 09a68fcd7..d0cdd37c0 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -255,7 +255,7 @@ msgid "" "<unittest-TestCase-removed-aliases_>`_." msgstr "" -#: whatsnew/3.12.rst:1837 +#: whatsnew/3.12.rst:1843 msgid "New Features" msgstr "" @@ -1218,7 +1218,7 @@ msgid "" "Windows. (Contributed by Charles Machalow in :gh:`103179`.)" msgstr "" -#: whatsnew/3.12.rst:1541 +#: whatsnew/3.12.rst:1547 msgid "sqlite3" msgstr "" @@ -1261,7 +1261,7 @@ msgid "" "Hettinger in :gh:`95861`.)" msgstr "" -#: whatsnew/3.12.rst:898 +#: whatsnew/3.12.rst:2310 msgid "sys" msgstr "" @@ -1291,7 +1291,7 @@ msgid "" "Katriel in :gh:`102778`.)" msgstr "" -#: whatsnew/3.12.rst:1736 +#: whatsnew/3.12.rst:1742 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 " @@ -1465,7 +1465,7 @@ msgid "" "Benjamin Peterson in :gh:`96734`)." msgstr "" -#: whatsnew/3.12.rst:1581 +#: whatsnew/3.12.rst:1587 msgid "unittest" msgstr "" @@ -1658,11 +1658,11 @@ msgid "" "demos>`_. (Contributed by Victor Stinner in :gh:`97669`.)" msgstr "" -#: whatsnew/3.12.rst:2139 +#: whatsnew/3.12.rst:2145 msgid "Deprecated" msgstr "" -#: whatsnew/3.12.rst:1156 deprecations/pending-removal-in-3.14.rst:11 +#: whatsnew/3.12.rst:1156 deprecations/pending-removal-in-3.14.rst:4 msgid "" ":mod:`argparse`: The *type*, *choices*, and *metavar* parameters of :class:`!" "argparse.BooleanOptionalAction` are deprecated and will be removed in 3.14. " @@ -1677,33 +1677,33 @@ msgid "" "Python 3.14:" msgstr "" -#: whatsnew/3.12.rst:1165 deprecations/pending-removal-in-3.14.rst:20 +#: whatsnew/3.12.rst:1165 deprecations/pending-removal-in-3.14.rst:13 msgid ":class:`!ast.Num`" msgstr "" -#: whatsnew/3.12.rst:1166 deprecations/pending-removal-in-3.14.rst:21 +#: whatsnew/3.12.rst:1166 deprecations/pending-removal-in-3.14.rst:14 msgid ":class:`!ast.Str`" msgstr "" -#: whatsnew/3.12.rst:1167 deprecations/pending-removal-in-3.14.rst:22 +#: whatsnew/3.12.rst:1167 deprecations/pending-removal-in-3.14.rst:15 msgid ":class:`!ast.Bytes`" msgstr "" -#: whatsnew/3.12.rst:1168 deprecations/pending-removal-in-3.14.rst:23 +#: whatsnew/3.12.rst:1168 deprecations/pending-removal-in-3.14.rst:16 msgid ":class:`!ast.NameConstant`" msgstr "" -#: whatsnew/3.12.rst:1169 deprecations/pending-removal-in-3.14.rst:24 +#: whatsnew/3.12.rst:1169 deprecations/pending-removal-in-3.14.rst:17 msgid ":class:`!ast.Ellipsis`" msgstr "" -#: whatsnew/3.12.rst:1171 deprecations/pending-removal-in-3.14.rst:26 +#: whatsnew/3.12.rst:1171 deprecations/pending-removal-in-3.14.rst:19 msgid "" "Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" "`90953`.)" msgstr "" -#: whatsnew/3.12.rst:1174 deprecations/pending-removal-in-3.14.rst:29 +#: whatsnew/3.12.rst:1174 deprecations/pending-removal-in-3.14.rst:22 msgid ":mod:`asyncio`:" msgstr "" @@ -1715,7 +1715,7 @@ msgid "" "3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" -#: whatsnew/3.12.rst:1182 deprecations/pending-removal-in-3.14.rst:37 +#: whatsnew/3.12.rst:1182 deprecations/pending-removal-in-3.14.rst:30 msgid "" ":func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`, :meth:" "`asyncio.AbstractEventLoopPolicy.set_child_watcher` and :meth:`asyncio." @@ -1723,7 +1723,7 @@ msgid "" "removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" -#: whatsnew/3.12.rst:1188 deprecations/pending-removal-in-3.14.rst:43 +#: whatsnew/3.12.rst:1188 deprecations/pending-removal-in-3.14.rst:36 msgid "" "The :meth:`~asyncio.get_event_loop` method of the default event loop policy " "now emits a :exc:`DeprecationWarning` if there is no current event loop set " @@ -1768,31 +1768,31 @@ msgid "" "removal in Python 3.14:" msgstr "" -#: whatsnew/3.12.rst:1216 deprecations/pending-removal-in-3.14.rst:62 +#: whatsnew/3.12.rst:1216 deprecations/pending-removal-in-3.14.rst:55 msgid ":class:`!importlib.abc.ResourceReader`" msgstr "" -#: whatsnew/3.12.rst:1217 deprecations/pending-removal-in-3.14.rst:63 +#: whatsnew/3.12.rst:1217 deprecations/pending-removal-in-3.14.rst:56 msgid ":class:`!importlib.abc.Traversable`" msgstr "" -#: whatsnew/3.12.rst:1218 deprecations/pending-removal-in-3.14.rst:64 +#: whatsnew/3.12.rst:1218 deprecations/pending-removal-in-3.14.rst:57 msgid ":class:`!importlib.abc.TraversableResources`" msgstr "" -#: whatsnew/3.12.rst:1220 deprecations/pending-removal-in-3.14.rst:66 +#: whatsnew/3.12.rst:1220 deprecations/pending-removal-in-3.14.rst:59 msgid "Use :mod:`importlib.resources.abc` classes instead:" msgstr "" -#: whatsnew/3.12.rst:1222 deprecations/pending-removal-in-3.14.rst:68 +#: whatsnew/3.12.rst:1222 deprecations/pending-removal-in-3.14.rst:61 msgid ":class:`importlib.resources.abc.Traversable`" msgstr "" -#: whatsnew/3.12.rst:1223 deprecations/pending-removal-in-3.14.rst:69 +#: whatsnew/3.12.rst:1223 deprecations/pending-removal-in-3.14.rst:62 msgid ":class:`importlib.resources.abc.TraversableResources`" msgstr "" -#: whatsnew/3.12.rst:1225 deprecations/pending-removal-in-3.14.rst:71 +#: whatsnew/3.12.rst:1225 deprecations/pending-removal-in-3.14.rst:64 msgid "(Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.)" msgstr "" @@ -1873,7 +1873,7 @@ msgid "" "`102828`.)" msgstr "" -#: whatsnew/3.12.rst:1278 deprecations/pending-removal-in-3.14.rst:101 +#: whatsnew/3.12.rst:1278 deprecations/pending-removal-in-3.14.rst:94 msgid ":mod:`sqlite3`:" msgstr "" @@ -1908,7 +1908,7 @@ msgid "" "default. See :ref:`tarfile-extraction-filter` for details." msgstr "" -#: whatsnew/3.12.rst:1301 +#: whatsnew/3.12.rst:1301 deprecations/pending-removal-in-3.15.rst:49 msgid ":mod:`typing`:" msgstr "" @@ -1972,8 +1972,8 @@ msgstr "" msgid "" "Accessing :attr:`~codeobject.co_lnotab` on code objects was deprecated in " "Python 3.10 via :pep:`626`, but it only got a proper :exc:" -"`DeprecationWarning` in 3.12, therefore it will be removed in 3.14. " -"(Contributed by Nikita Sobolev in :gh:`101866`.)" +"`DeprecationWarning` in 3.12. May be removed in 3.15. (Contributed by Nikita " +"Sobolev in :gh:`101866`.)" msgstr "" #: deprecations/pending-removal-in-3.13.rst:2 @@ -2152,26 +2152,14 @@ msgstr "" msgid "Pending Removal in Python 3.14" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:4 -msgid "The import system:" -msgstr "" - -#: deprecations/pending-removal-in-3.14.rst:6 -msgid "" -"Setting :attr:`~module.__loader__` on a module while failing to set :attr:" -"`__spec__.loader <importlib.machinery.ModuleSpec.loader>` is deprecated. In " -"Python 3.14, :attr:`!__loader__` will cease to be set or taken into " -"consideration by the import system or the standard library." -msgstr "" - -#: deprecations/pending-removal-in-3.14.rst:16 +#: deprecations/pending-removal-in-3.14.rst:9 msgid "" ":mod:`ast`: The following features have been deprecated in documentation " "since Python 3.8, now cause a :exc:`DeprecationWarning` to be emitted at " "runtime when they are accessed or used, and will be removed in Python 3.14:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:31 +#: deprecations/pending-removal-in-3.14.rst:24 msgid "" "The child watcher classes :class:`~asyncio.MultiLoopChildWatcher`, :class:" "`~asyncio.FastChildWatcher`, :class:`~asyncio.AbstractChildWatcher` and :" @@ -2179,7 +2167,7 @@ msgid "" "Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:48 +#: deprecations/pending-removal-in-3.14.rst:41 msgid "" ":mod:`collections.abc`: Deprecated :class:`~collections.abc.ByteString`. " "Prefer :class:`!Sequence` or :class:`~collections.abc.Buffer`. For use in " @@ -2187,23 +2175,23 @@ msgid "" "abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:54 +#: deprecations/pending-removal-in-3.14.rst:47 msgid "" ":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." "localtime`. (Contributed by Alan Williams in :gh:`72346`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:57 +#: deprecations/pending-removal-in-3.14.rst:50 msgid "" ":mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or " "taken into consideration by the import system (:gh:`97879`)." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:60 +#: deprecations/pending-removal-in-3.14.rst:53 msgid ":mod:`importlib.abc` deprecated classes:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:73 +#: deprecations/pending-removal-in-3.14.rst:66 msgid "" ":mod:`itertools` had undocumented, inefficient, historically buggy, and " "inconsistent support for copy, deepcopy, and pickle operations. This will be " @@ -2211,7 +2199,7 @@ msgid "" "burden. (Contributed by Raymond Hettinger in :gh:`101588`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:79 +#: deprecations/pending-removal-in-3.14.rst:72 msgid "" ":mod:`multiprocessing`: The default start method will change to a safer one " "on Linux, BSDs, and other non-macOS POSIX platforms where ``'fork'`` is " @@ -2222,63 +2210,49 @@ msgid "" "``'fork'``. See :ref:`multiprocessing-start-methods`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:87 +#: deprecations/pending-removal-in-3.14.rst:80 msgid "" ":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." "PurePath.relative_to`: passing additional arguments is deprecated." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:91 +#: deprecations/pending-removal-in-3.14.rst:84 msgid "" ":mod:`pkgutil`: :func:`~pkgutil.find_loader` and :func:`~pkgutil.get_loader` " "now raise :exc:`DeprecationWarning`; use :func:`importlib.util.find_spec` " "instead. (Contributed by Nikita Sobolev in :gh:`97850`.)" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:96 +#: deprecations/pending-removal-in-3.14.rst:89 msgid ":mod:`pty`:" msgstr "" -#: deprecations/pending-removal-in-3.14.rst:98 +#: deprecations/pending-removal-in-3.14.rst:91 msgid "``master_open()``: use :func:`pty.openpty`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:99 +#: deprecations/pending-removal-in-3.14.rst:92 msgid "``slave_open()``: use :func:`pty.openpty`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:103 +#: deprecations/pending-removal-in-3.14.rst:96 msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:105 +#: deprecations/pending-removal-in-3.14.rst:98 msgid "" ":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` if :" "ref:`named placeholders <sqlite3-placeholders>` are used and *parameters* is " "a sequence instead of a :class:`dict`." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:109 -msgid "" -"date and datetime adapter, date and timestamp converter: see the :mod:" -"`sqlite3` documentation for suggested replacement recipes." -msgstr "" - -#: deprecations/pending-removal-in-3.14.rst:112 -msgid "" -":class:`types.CodeType`: Accessing :attr:`~codeobject.co_lnotab` was " -"deprecated in :pep:`626` since 3.10 and was planned to be removed in 3.12, " -"but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " -"in 3.14. (Contributed by Nikita Sobolev in :gh:`101866`.)" -msgstr "" - -#: deprecations/pending-removal-in-3.14.rst:119 +#: deprecations/pending-removal-in-3.14.rst:102 msgid "" ":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " "causes a :exc:`DeprecationWarning` to be emitted when it is used." msgstr "" -#: deprecations/pending-removal-in-3.14.rst:122 +#: deprecations/pending-removal-in-3.14.rst:105 msgid "" ":mod:`urllib`: :class:`!urllib.parse.Quoter` is deprecated: it was not " "intended to be a public API. (Contributed by Gregory P. Smith in :gh:" @@ -2343,6 +2317,18 @@ msgid "" msgstr "" #: deprecations/pending-removal-in-3.15.rst:40 +msgid ":mod:`types`:" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:42 +msgid "" +":class:`types.CodeType`: Accessing :attr:`~codeobject.co_lnotab` was " +"deprecated in :pep:`626` since 3.10 and was planned to be removed in 3.12, " +"but it only got a proper :exc:`DeprecationWarning` in 3.12. May be removed " +"in 3.15. (Contributed by Nikita Sobolev in :gh:`101866`.)" +msgstr "" + +#: deprecations/pending-removal-in-3.15.rst:51 msgid "" "When using the functional syntax to create a :class:`!NamedTuple` class, " "failing to pass a value to the *fields* parameter (``NT = " @@ -2353,7 +2339,7 @@ msgid "" "[])``." msgstr "" -#: deprecations/pending-removal-in-3.15.rst:47 +#: deprecations/pending-removal-in-3.15.rst:58 msgid "" ":class:`typing.TypedDict`: When using the functional syntax to create a :" "class:`!TypedDict` class, failing to pass a value to the *fields* parameter " @@ -2363,7 +2349,7 @@ msgid "" "fields, use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})``." msgstr "" -#: deprecations/pending-removal-in-3.15.rst:54 +#: deprecations/pending-removal-in-3.15.rst:65 msgid "" ":mod:`wave`: Deprecate the ``getmark()``, ``setmark()`` and ``getmarkers()`` " "methods of the :class:`wave.Wave_read` and :class:`wave.Wave_write` classes. " @@ -2376,16 +2362,28 @@ msgid "Pending Removal in Python 3.16" msgstr "" #: deprecations/pending-removal-in-3.16.rst:4 +msgid "The import system:" +msgstr "" + +#: deprecations/pending-removal-in-3.16.rst:6 +msgid "" +"Setting :attr:`~module.__loader__` on a module while failing to set :attr:" +"`__spec__.loader <importlib.machinery.ModuleSpec.loader>` is deprecated. In " +"Python 3.16, :attr:`!__loader__` will cease to be set or taken into " +"consideration by the import system or the standard library." +msgstr "" + +#: deprecations/pending-removal-in-3.16.rst:11 msgid "" ":mod:`array`: :class:`array.array` ``'u'`` type (:c:type:`wchar_t`): use the " "``'w'`` type instead (``Py_UCS4``)." msgstr "" -#: deprecations/pending-removal-in-3.16.rst:8 +#: deprecations/pending-removal-in-3.16.rst:15 msgid ":mod:`builtins`: ``~bool``, bitwise inversion on bool." msgstr "" -#: deprecations/pending-removal-in-3.16.rst:11 +#: deprecations/pending-removal-in-3.16.rst:18 msgid "" ":mod:`symtable`: Deprecate :meth:`symtable.Class.get_methods` due to the " "lack of interest. (Contributed by Bénédikt Tran in :gh:`119698`.)" @@ -2742,54 +2740,54 @@ msgid "" "`~zipimport.zipimporter.exec_module` instead." msgstr "" -#: whatsnew/3.12.rst:2234 +#: whatsnew/3.12.rst:2240 msgid "Removed" msgstr "" -#: whatsnew/3.12.rst:1359 +#: whatsnew/3.12.rst:1361 msgid "asynchat and asyncore" msgstr "" -#: whatsnew/3.12.rst:1361 +#: whatsnew/3.12.rst:1363 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:1368 +#: whatsnew/3.12.rst:1370 msgid "configparser" msgstr "" -#: whatsnew/3.12.rst:1370 +#: whatsnew/3.12.rst:1372 msgid "" "Several names deprecated in the :mod:`configparser` way back in 3.2 have " "been removed per :gh:`89336`:" msgstr "" -#: whatsnew/3.12.rst:1373 +#: whatsnew/3.12.rst:1375 msgid "" ":class:`configparser.ParsingError` no longer has a ``filename`` attribute or " "argument. Use the ``source`` attribute and argument instead." msgstr "" -#: whatsnew/3.12.rst:1375 +#: whatsnew/3.12.rst:1377 msgid "" ":mod:`configparser` no longer has a ``SafeConfigParser`` class. Use the " "shorter :class:`~configparser.ConfigParser` name instead." msgstr "" -#: whatsnew/3.12.rst:1377 +#: whatsnew/3.12.rst:1379 msgid "" ":class:`configparser.ConfigParser` no longer has a ``readfp`` method. Use :" "meth:`~configparser.ConfigParser.read_file` instead." msgstr "" -#: whatsnew/3.12.rst:1381 +#: whatsnew/3.12.rst:1385 msgid "distutils" msgstr "" -#: whatsnew/3.12.rst:1383 +#: whatsnew/3.12.rst:1387 msgid "" "Remove the :py:mod:`!distutils` package. It was deprecated in Python 3.10 " "by :pep:`632` \"Deprecate distutils module\". For projects still using " @@ -2798,17 +2796,17 @@ msgid "" "Victor Stinner in :gh:`92584`.)" msgstr "" -#: whatsnew/3.12.rst:1390 +#: whatsnew/3.12.rst:1394 msgid "ensurepip" msgstr "" -#: whatsnew/3.12.rst:1392 +#: whatsnew/3.12.rst:1396 msgid "" "Remove the bundled setuptools wheel from :mod:`ensurepip`, and stop " "installing setuptools in environments created by :mod:`venv`." msgstr "" -#: whatsnew/3.12.rst:1395 +#: whatsnew/3.12.rst:1399 msgid "" "``pip (>= 22.1)`` does not require setuptools to be installed in the " "environment. ``setuptools``-based (and ``distutils``-based) packages can " @@ -2816,7 +2814,7 @@ msgid "" "the build environment it uses for building a package." msgstr "" -#: whatsnew/3.12.rst:1401 +#: whatsnew/3.12.rst:1405 msgid "" "``easy_install``, ``pkg_resources``, ``setuptools`` and ``distutils`` are no " "longer provided by default in environments created with ``venv`` or " @@ -2826,35 +2824,35 @@ msgid "" "(typically, using pip)." msgstr "" -#: whatsnew/3.12.rst:1408 +#: whatsnew/3.12.rst:1412 msgid "(Contributed by Pradyun Gedam in :gh:`95299`.)" msgstr "" -#: whatsnew/3.12.rst:1411 +#: whatsnew/3.12.rst:1415 msgid "enum" msgstr "" -#: whatsnew/3.12.rst:1413 +#: whatsnew/3.12.rst:1417 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:1418 +#: whatsnew/3.12.rst:1422 msgid "ftplib" msgstr "" -#: whatsnew/3.12.rst:1420 +#: whatsnew/3.12.rst:1424 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:1425 +#: whatsnew/3.12.rst:1429 msgid "gzip" msgstr "" -#: whatsnew/3.12.rst:1427 +#: whatsnew/3.12.rst:1431 msgid "" "Remove the ``filename`` attribute of :mod:`gzip`'s :class:`gzip.GzipFile`, " "deprecated since Python 2.6, use the :attr:`~gzip.GzipFile.name` attribute " @@ -2863,11 +2861,11 @@ msgid "" "`94196`.)" msgstr "" -#: whatsnew/3.12.rst:1434 +#: whatsnew/3.12.rst:1438 msgid "hashlib" msgstr "" -#: whatsnew/3.12.rst:1436 +#: whatsnew/3.12.rst:1440 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 " @@ -2876,150 +2874,150 @@ msgid "" "Stinner in :gh:`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1470 +#: whatsnew/3.12.rst:1476 msgid "importlib" msgstr "" -#: whatsnew/3.12.rst:1445 +#: whatsnew/3.12.rst:1449 msgid "" "Many previously deprecated cleanups in :mod:`importlib` have now been " "completed:" msgstr "" -#: whatsnew/3.12.rst:1448 +#: whatsnew/3.12.rst:1452 msgid "" "References to, and support for :meth:`!module_repr` has been removed. " "(Contributed by Barry Warsaw in :gh:`97850`.)" msgstr "" -#: whatsnew/3.12.rst:1451 +#: whatsnew/3.12.rst:1455 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:1455 +#: whatsnew/3.12.rst:1459 msgid "" "Support for ``find_loader()`` and ``find_module()`` APIs have been removed. " "(Contributed by Barry Warsaw in :gh:`98040`.)" msgstr "" -#: whatsnew/3.12.rst:1458 +#: whatsnew/3.12.rst:1462 msgid "" "``importlib.abc.Finder``, ``pkgutil.ImpImporter``, and ``pkgutil.ImpLoader`` " "have been removed. (Contributed by Barry Warsaw in :gh:`98040`.)" msgstr "" -#: whatsnew/3.12.rst:1470 +#: whatsnew/3.12.rst:1476 msgid "imp" msgstr "" -#: whatsnew/3.12.rst:1464 +#: whatsnew/3.12.rst:1470 msgid "" "The :mod:`!imp` module has been removed. (Contributed by Barry Warsaw in :" "gh:`98040`.)" msgstr "" -#: whatsnew/3.12.rst:1467 +#: whatsnew/3.12.rst:1473 msgid "To migrate, consult the following correspondence table:" msgstr "" -#: whatsnew/3.12.rst:1472 +#: whatsnew/3.12.rst:1478 msgid "``imp.NullImporter``" msgstr "" -#: whatsnew/3.12.rst:1472 +#: whatsnew/3.12.rst:1478 msgid "Insert ``None`` into ``sys.path_importer_cache``" msgstr "" -#: whatsnew/3.12.rst:1473 +#: whatsnew/3.12.rst:1479 msgid "``imp.cache_from_source()``" msgstr "" -#: whatsnew/3.12.rst:1473 +#: whatsnew/3.12.rst:1479 msgid ":func:`importlib.util.cache_from_source`" msgstr "" -#: whatsnew/3.12.rst:1474 +#: whatsnew/3.12.rst:1480 msgid "``imp.find_module()``" msgstr "" -#: whatsnew/3.12.rst:1474 +#: whatsnew/3.12.rst:1480 msgid ":func:`importlib.util.find_spec`" msgstr "" -#: whatsnew/3.12.rst:1475 +#: whatsnew/3.12.rst:1481 msgid "``imp.get_magic()``" msgstr "" -#: whatsnew/3.12.rst:1475 +#: whatsnew/3.12.rst:1481 msgid ":attr:`importlib.util.MAGIC_NUMBER`" msgstr "" -#: whatsnew/3.12.rst:1476 +#: whatsnew/3.12.rst:1482 msgid "``imp.get_suffixes()``" msgstr "" -#: whatsnew/3.12.rst:1476 +#: whatsnew/3.12.rst:1482 msgid "" ":attr:`importlib.machinery.SOURCE_SUFFIXES`, :attr:`importlib.machinery." "EXTENSION_SUFFIXES`, and :attr:`importlib.machinery.BYTECODE_SUFFIXES`" msgstr "" -#: whatsnew/3.12.rst:1477 +#: whatsnew/3.12.rst:1483 msgid "``imp.get_tag()``" msgstr "" -#: whatsnew/3.12.rst:1477 +#: whatsnew/3.12.rst:1483 msgid ":attr:`sys.implementation.cache_tag <sys.implementation>`" msgstr "" -#: whatsnew/3.12.rst:1478 +#: whatsnew/3.12.rst:1484 msgid "``imp.load_module()``" msgstr "" -#: whatsnew/3.12.rst:1478 +#: whatsnew/3.12.rst:1484 msgid ":func:`importlib.import_module`" msgstr "" -#: whatsnew/3.12.rst:1479 +#: whatsnew/3.12.rst:1485 msgid "``imp.new_module(name)``" msgstr "" -#: whatsnew/3.12.rst:1479 +#: whatsnew/3.12.rst:1485 msgid "``types.ModuleType(name)``" msgstr "" -#: whatsnew/3.12.rst:1480 +#: whatsnew/3.12.rst:1486 msgid "``imp.reload()``" msgstr "" -#: whatsnew/3.12.rst:1480 +#: whatsnew/3.12.rst:1486 msgid ":func:`importlib.reload`" msgstr "" -#: whatsnew/3.12.rst:1481 +#: whatsnew/3.12.rst:1487 msgid "``imp.source_from_cache()``" msgstr "" -#: whatsnew/3.12.rst:1481 +#: whatsnew/3.12.rst:1487 msgid ":func:`importlib.util.source_from_cache`" msgstr "" -#: whatsnew/3.12.rst:1482 +#: whatsnew/3.12.rst:1488 msgid "``imp.load_source()``" msgstr "" -#: whatsnew/3.12.rst:1482 +#: whatsnew/3.12.rst:1488 msgid "*See below*" msgstr "" -#: whatsnew/3.12.rst:1485 +#: whatsnew/3.12.rst:1491 msgid "Replace ``imp.load_source()`` with::" msgstr "" -#: whatsnew/3.12.rst:1487 +#: whatsnew/3.12.rst:1493 msgid "" "import importlib.util\n" "import importlib.machinery\n" @@ -3036,48 +3034,48 @@ msgid "" " return module" msgstr "" -#: whatsnew/3.12.rst:1500 +#: whatsnew/3.12.rst:1506 msgid "Remove :mod:`!imp` functions and attributes with no replacements:" msgstr "" -#: whatsnew/3.12.rst:1502 +#: whatsnew/3.12.rst:1508 msgid "Undocumented functions:" msgstr "" -#: whatsnew/3.12.rst:1504 +#: whatsnew/3.12.rst:1510 msgid "``imp.init_builtin()``" msgstr "" -#: whatsnew/3.12.rst:1505 +#: whatsnew/3.12.rst:1511 msgid "``imp.load_compiled()``" msgstr "" -#: whatsnew/3.12.rst:1506 +#: whatsnew/3.12.rst:1512 msgid "``imp.load_dynamic()``" msgstr "" -#: whatsnew/3.12.rst:1507 +#: whatsnew/3.12.rst:1513 msgid "``imp.load_package()``" msgstr "" -#: whatsnew/3.12.rst:1509 +#: whatsnew/3.12.rst:1515 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:1511 +#: whatsnew/3.12.rst:1517 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:1516 +#: whatsnew/3.12.rst:1522 msgid "io" msgstr "" -#: whatsnew/3.12.rst:1518 +#: whatsnew/3.12.rst:1524 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." @@ -3086,22 +3084,22 @@ msgid "" "`94169`.)" msgstr "" -#: whatsnew/3.12.rst:1525 +#: whatsnew/3.12.rst:1531 msgid "locale" msgstr "" -#: whatsnew/3.12.rst:1527 +#: whatsnew/3.12.rst:1533 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:1532 +#: whatsnew/3.12.rst:1538 msgid "smtpd" msgstr "" -#: whatsnew/3.12.rst:1534 +#: whatsnew/3.12.rst:1540 msgid "" "The ``smtpd`` module has been removed according to the schedule in :pep:" "`594`, having been deprecated in Python 3.4.7 and 3.5.4. Use the :pypi:" @@ -3109,27 +3107,27 @@ msgid "" "(Contributed by Oleg Iarygin in :gh:`93243`.)" msgstr "" -#: whatsnew/3.12.rst:1543 +#: whatsnew/3.12.rst:1549 msgid "" "The following undocumented :mod:`sqlite3` features, deprecated in Python " "3.10, are now removed:" msgstr "" -#: whatsnew/3.12.rst:1546 +#: whatsnew/3.12.rst:1552 msgid "``sqlite3.enable_shared_cache()``" msgstr "" -#: whatsnew/3.12.rst:1547 +#: whatsnew/3.12.rst:1553 msgid "``sqlite3.OptimizedUnicode``" msgstr "" -#: whatsnew/3.12.rst:1549 +#: whatsnew/3.12.rst:1555 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:1552 +#: whatsnew/3.12.rst:1558 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 " @@ -3137,22 +3135,22 @@ msgid "" "default value which is also ``str``." msgstr "" -#: whatsnew/3.12.rst:1557 +#: whatsnew/3.12.rst:1563 msgid "(Contributed by Erlend E. Aasland in :gh:`92548`.)" msgstr "" -#: whatsnew/3.12.rst:1560 +#: whatsnew/3.12.rst:1566 msgid "ssl" msgstr "" -#: whatsnew/3.12.rst:1562 +#: whatsnew/3.12.rst:1568 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:1566 +#: whatsnew/3.12.rst:1572 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 " @@ -3160,7 +3158,7 @@ msgid "" "Stinner in :gh:`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1572 +#: whatsnew/3.12.rst:1578 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." @@ -3171,185 +3169,185 @@ msgid "" "`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1583 +#: whatsnew/3.12.rst:1589 msgid "Remove many long-deprecated :mod:`unittest` features:" msgstr "" -#: whatsnew/3.12.rst:1587 +#: whatsnew/3.12.rst:1593 msgid "A number of :class:`~unittest.TestCase` method aliases:" msgstr "" -#: whatsnew/3.12.rst:1590 +#: whatsnew/3.12.rst:1596 msgid "Deprecated alias" msgstr "" -#: whatsnew/3.12.rst:1590 +#: whatsnew/3.12.rst:1596 msgid "Method Name" msgstr "" -#: whatsnew/3.12.rst:1590 +#: whatsnew/3.12.rst:1596 msgid "Deprecated in" msgstr "" -#: whatsnew/3.12.rst:1592 +#: whatsnew/3.12.rst:1598 msgid "``failUnless``" msgstr "" -#: whatsnew/3.12.rst:1599 +#: whatsnew/3.12.rst:1605 msgid ":meth:`.assertTrue`" msgstr "" -#: whatsnew/3.12.rst:1593 whatsnew/3.12.rst:1595 whatsnew/3.12.rst:1597 -#: whatsnew/3.12.rst:1598 +#: whatsnew/3.12.rst:1599 whatsnew/3.12.rst:1601 whatsnew/3.12.rst:1603 +#: whatsnew/3.12.rst:1604 msgid "3.1" msgstr "" -#: whatsnew/3.12.rst:1593 +#: whatsnew/3.12.rst:1599 msgid "``failIf``" msgstr "" -#: whatsnew/3.12.rst:1593 +#: whatsnew/3.12.rst:1599 msgid ":meth:`.assertFalse`" msgstr "" -#: whatsnew/3.12.rst:1594 +#: whatsnew/3.12.rst:1600 msgid "``failUnlessEqual``" msgstr "" -#: whatsnew/3.12.rst:1600 +#: whatsnew/3.12.rst:1606 msgid ":meth:`.assertEqual`" msgstr "" -#: whatsnew/3.12.rst:1595 +#: whatsnew/3.12.rst:1601 msgid "``failIfEqual``" msgstr "" -#: whatsnew/3.12.rst:1601 +#: whatsnew/3.12.rst:1607 msgid ":meth:`.assertNotEqual`" msgstr "" -#: whatsnew/3.12.rst:1596 +#: whatsnew/3.12.rst:1602 msgid "``failUnlessAlmostEqual``" msgstr "" -#: whatsnew/3.12.rst:1602 +#: whatsnew/3.12.rst:1608 msgid ":meth:`.assertAlmostEqual`" msgstr "" -#: whatsnew/3.12.rst:1597 +#: whatsnew/3.12.rst:1603 msgid "``failIfAlmostEqual``" msgstr "" -#: whatsnew/3.12.rst:1603 +#: whatsnew/3.12.rst:1609 msgid ":meth:`.assertNotAlmostEqual`" msgstr "" -#: whatsnew/3.12.rst:1598 +#: whatsnew/3.12.rst:1604 msgid "``failUnlessRaises``" msgstr "" -#: whatsnew/3.12.rst:1598 +#: whatsnew/3.12.rst:1604 msgid ":meth:`.assertRaises`" msgstr "" -#: whatsnew/3.12.rst:1599 +#: whatsnew/3.12.rst:1605 msgid "``assert_``" msgstr "" -#: whatsnew/3.12.rst:1600 whatsnew/3.12.rst:1602 whatsnew/3.12.rst:1604 -#: whatsnew/3.12.rst:1605 +#: whatsnew/3.12.rst:1606 whatsnew/3.12.rst:1608 whatsnew/3.12.rst:1610 +#: whatsnew/3.12.rst:1611 msgid "3.2" msgstr "" -#: whatsnew/3.12.rst:1600 +#: whatsnew/3.12.rst:1606 msgid "``assertEquals``" msgstr "" -#: whatsnew/3.12.rst:1601 +#: whatsnew/3.12.rst:1607 msgid "``assertNotEquals``" msgstr "" -#: whatsnew/3.12.rst:1602 +#: whatsnew/3.12.rst:1608 msgid "``assertAlmostEquals``" msgstr "" -#: whatsnew/3.12.rst:1603 +#: whatsnew/3.12.rst:1609 msgid "``assertNotAlmostEquals``" msgstr "" -#: whatsnew/3.12.rst:1604 +#: whatsnew/3.12.rst:1610 msgid "``assertRegexpMatches``" msgstr "" -#: whatsnew/3.12.rst:1604 +#: whatsnew/3.12.rst:1610 msgid ":meth:`.assertRegex`" msgstr "" -#: whatsnew/3.12.rst:1605 +#: whatsnew/3.12.rst:1611 msgid "``assertRaisesRegexp``" msgstr "" -#: whatsnew/3.12.rst:1605 +#: whatsnew/3.12.rst:1611 msgid ":meth:`.assertRaisesRegex`" msgstr "" -#: whatsnew/3.12.rst:1606 +#: whatsnew/3.12.rst:1612 msgid "``assertNotRegexpMatches``" msgstr "" -#: whatsnew/3.12.rst:1606 +#: whatsnew/3.12.rst:1612 msgid ":meth:`.assertNotRegex`" msgstr "" -#: whatsnew/3.12.rst:1606 +#: whatsnew/3.12.rst:1612 msgid "3.5" msgstr "" -#: whatsnew/3.12.rst:1609 +#: whatsnew/3.12.rst:1615 msgid "" "You can use https://github.com/isidentical/teyit to automatically modernise " "your unit tests." msgstr "" -#: whatsnew/3.12.rst:1612 +#: whatsnew/3.12.rst:1618 msgid "" "Undocumented and broken :class:`~unittest.TestCase` method " "``assertDictContainsSubset`` (deprecated in Python 3.2)." msgstr "" -#: whatsnew/3.12.rst:1615 +#: whatsnew/3.12.rst:1621 msgid "" "Undocumented :meth:`TestLoader.loadTestsFromModule <unittest.TestLoader." "loadTestsFromModule>` parameter *use_load_tests* (deprecated and ignored " "since Python 3.5)." msgstr "" -#: whatsnew/3.12.rst:1619 +#: whatsnew/3.12.rst:1625 msgid "" "An alias of the :class:`~unittest.TextTestResult` class: ``_TextTestResult`` " "(deprecated in Python 3.2)." msgstr "" -#: whatsnew/3.12.rst:1622 +#: whatsnew/3.12.rst:1628 msgid "(Contributed by Serhiy Storchaka in :gh:`89325`.)" msgstr "" -#: whatsnew/3.12.rst:1625 +#: whatsnew/3.12.rst:1631 msgid "webbrowser" msgstr "" -#: whatsnew/3.12.rst:1627 +#: whatsnew/3.12.rst:1633 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:1632 +#: whatsnew/3.12.rst:1638 msgid "xml.etree.ElementTree" msgstr "" -#: whatsnew/3.12.rst:1634 +#: whatsnew/3.12.rst:1640 msgid "" "Remove the ``ElementTree.Element.copy()`` method of the pure Python " "implementation, deprecated in Python 3.10, use the :func:`copy.copy` " @@ -3358,22 +3356,22 @@ msgid "" "Stinner in :gh:`94383`.)" msgstr "" -#: whatsnew/3.12.rst:1641 +#: whatsnew/3.12.rst:1647 msgid "zipimport" msgstr "" -#: whatsnew/3.12.rst:1643 +#: whatsnew/3.12.rst:1649 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:1649 +#: whatsnew/3.12.rst:1655 msgid "Others" msgstr "" -#: whatsnew/3.12.rst:1651 +#: whatsnew/3.12.rst:1657 msgid "" "Remove the ``suspicious`` rule from the documentation :file:`Makefile` and :" "file:`Doc/tools/rstlint.py`, both in favor of `sphinx-lint <https://github." @@ -3381,7 +3379,7 @@ msgid "" "`98179`.)" msgstr "" -#: whatsnew/3.12.rst:1656 +#: whatsnew/3.12.rst:1662 msgid "" "Remove the *keyfile* and *certfile* parameters from the :mod:`ftplib`, :mod:" "`imaplib`, :mod:`poplib` and :mod:`smtplib` modules, and the *key_file*, " @@ -3391,33 +3389,33 @@ msgid "" "in :gh:`94172`.)" msgstr "" -#: whatsnew/3.12.rst:1664 +#: whatsnew/3.12.rst:1670 msgid "" "Remove ``Jython`` compatibility hacks from several stdlib modules and tests. " "(Contributed by Nikita Sobolev in :gh:`99482`.)" msgstr "" -#: whatsnew/3.12.rst:1667 +#: whatsnew/3.12.rst:1673 msgid "" "Remove ``_use_broken_old_ctypes_structure_semantics_`` flag from :mod:" "`ctypes` module. (Contributed by Nikita Sobolev in :gh:`99285`.)" msgstr "" -#: whatsnew/3.12.rst:1999 +#: whatsnew/3.12.rst:2005 msgid "Porting to Python 3.12" msgstr "" -#: whatsnew/3.12.rst:1677 +#: whatsnew/3.12.rst:1683 msgid "" "This section lists previously described changes and other bugfixes that may " "require changes to your code." msgstr "" -#: whatsnew/3.12.rst:1681 +#: whatsnew/3.12.rst:1687 msgid "Changes in the Python API" msgstr "" -#: whatsnew/3.12.rst:1683 +#: whatsnew/3.12.rst:1689 msgid "" "More strict rules are now applied for numerical group references and group " "names in regular expressions. Only sequence of ASCII digits is now accepted " @@ -3426,7 +3424,7 @@ msgid "" "(Contributed by Serhiy Storchaka in :gh:`91760`.)" msgstr "" -#: whatsnew/3.12.rst:1690 +#: whatsnew/3.12.rst:1696 msgid "" "Remove ``randrange()`` functionality deprecated since Python 3.10. " "Formerly, ``randrange(10.0)`` losslessly converted to ``randrange(10)``. " @@ -3438,7 +3436,7 @@ msgid "" "`86388`.)" msgstr "" -#: whatsnew/3.12.rst:1698 +#: whatsnew/3.12.rst:1704 msgid "" ":class:`argparse.ArgumentParser` changed encoding and error handler for " "reading arguments from file (e.g. ``fromfile_prefix_chars`` option) from " @@ -3448,21 +3446,21 @@ msgid "" "on Windows." msgstr "" -#: whatsnew/3.12.rst:1704 +#: whatsnew/3.12.rst:1710 msgid "" "Remove the ``asyncore``-based ``smtpd`` module deprecated in Python 3.4.7 " "and 3.5.4. A recommended replacement is the :mod:`asyncio`-based :pypi:" "`aiosmtpd` PyPI module." msgstr "" -#: whatsnew/3.12.rst:1708 +#: whatsnew/3.12.rst:1714 msgid "" ":func:`shlex.split`: Passing ``None`` for *s* argument now raises an " "exception, rather than reading :data:`sys.stdin`. The feature was deprecated " "in Python 3.9. (Contributed by Victor Stinner in :gh:`94352`.)" msgstr "" -#: whatsnew/3.12.rst:1713 +#: whatsnew/3.12.rst:1719 msgid "" "The :mod:`os` module no longer accepts bytes-like paths, like :class:" "`bytearray` and :class:`memoryview` types: only the exact :class:`bytes` " @@ -3470,7 +3468,7 @@ msgid "" "`98393`.)" msgstr "" -#: whatsnew/3.12.rst:1718 +#: whatsnew/3.12.rst:1724 msgid "" ":func:`syslog.openlog` and :func:`syslog.closelog` now fail if used in " "subinterpreters. :func:`syslog.syslog` may still be used in subinterpreters, " @@ -3482,7 +3480,7 @@ msgid "" "(Contributed by Donghee Na in :gh:`99127`.)" msgstr "" -#: whatsnew/3.12.rst:1727 +#: whatsnew/3.12.rst:1733 msgid "" "The undocumented locking behavior of :func:`~functools.cached_property` is " "removed, because it locked across all instances of the class, leading to " @@ -3494,14 +3492,14 @@ msgid "" "property getter function or around multi-threaded access points." msgstr "" -#: whatsnew/3.12.rst:1740 +#: whatsnew/3.12.rst:1746 msgid "" "When extracting tar files using :mod:`tarfile` or :func:`shutil." "unpack_archive`, pass the *filter* argument to limit features that may be " "surprising or dangerous. See :ref:`tarfile-extraction-filter` for details." msgstr "" -#: whatsnew/3.12.rst:1745 +#: whatsnew/3.12.rst:1751 msgid "" "The output of the :func:`tokenize.tokenize` and :func:`tokenize." "generate_tokens` functions is now changed due to the changes introduced in :" @@ -3513,15 +3511,15 @@ msgid "" "``f\"start {1+1} end\"`` the old version of the tokenizer emitted::" msgstr "" -#: whatsnew/3.12.rst:1754 +#: whatsnew/3.12.rst:1760 msgid "1,0-1,18: STRING 'f\"start {1+1} end\"'" msgstr "" -#: whatsnew/3.12.rst:1756 +#: whatsnew/3.12.rst:1762 msgid "while the new version emits::" msgstr "" -#: whatsnew/3.12.rst:1758 +#: whatsnew/3.12.rst:1764 msgid "" "1,0-1,2: FSTRING_START 'f\"'\n" "1,2-1,8: FSTRING_MIDDLE 'start '\n" @@ -3534,54 +3532,54 @@ msgid "" "1,17-1,18: FSTRING_END '\"'" msgstr "" -#: whatsnew/3.12.rst:1768 +#: whatsnew/3.12.rst:1774 msgid "" "Additionally, there may be some minor behavioral changes as a consequence of " "the changes required to support :pep:`701`. Some of these changes include:" msgstr "" -#: whatsnew/3.12.rst:1771 +#: whatsnew/3.12.rst:1777 msgid "" "The ``type`` attribute of the tokens emitted when tokenizing some invalid " "Python characters such as ``!`` has changed from ``ERRORTOKEN`` to ``OP``." msgstr "" -#: whatsnew/3.12.rst:1774 +#: whatsnew/3.12.rst:1780 msgid "" "Incomplete single-line strings now also raise :exc:`tokenize.TokenError` as " "incomplete multiline strings do." msgstr "" -#: whatsnew/3.12.rst:1777 +#: whatsnew/3.12.rst:1783 msgid "" "Some incomplete or invalid Python code now raises :exc:`tokenize.TokenError` " "instead of returning arbitrary ``ERRORTOKEN`` tokens when tokenizing it." msgstr "" -#: whatsnew/3.12.rst:1780 +#: whatsnew/3.12.rst:1786 msgid "" "Mixing tabs and spaces as indentation in the same file is not supported " "anymore and will raise a :exc:`TabError`." msgstr "" -#: whatsnew/3.12.rst:1783 +#: whatsnew/3.12.rst:1789 msgid "" "The :mod:`threading` module now expects the :mod:`!_thread` module to have " "an ``_is_main_interpreter`` attribute. It is a function with no arguments " "that returns ``True`` if the current interpreter is the main interpreter." msgstr "" -#: whatsnew/3.12.rst:1788 +#: whatsnew/3.12.rst:1794 msgid "" "Any library or application that provides a custom ``_thread`` module should " "provide ``_is_main_interpreter()``. (See :gh:`112826`.)" msgstr "" -#: whatsnew/3.12.rst:1793 +#: whatsnew/3.12.rst:1799 msgid "Build Changes" msgstr "" -#: whatsnew/3.12.rst:1795 +#: whatsnew/3.12.rst:1801 msgid "" "Python no longer uses :file:`setup.py` to build shared C extension modules. " "Build parameters like headers and libraries are detected in ``configure`` " @@ -3590,21 +3588,21 @@ msgid "" "in :gh:`93939`.)" msgstr "" -#: whatsnew/3.12.rst:1801 +#: whatsnew/3.12.rst:1807 msgid "" "``va_start()`` with two parameters, like ``va_start(args, format),`` is now " "required to build Python. ``va_start()`` is no longer called with a single " "parameter. (Contributed by Kumar Aditya in :gh:`93207`.)" msgstr "" -#: whatsnew/3.12.rst:1806 +#: whatsnew/3.12.rst:1812 msgid "" "CPython now uses the ThinLTO option as the default link time optimization " "policy if the Clang compiler accepts the flag. (Contributed by Donghee Na " "in :gh:`89536`.)" msgstr "" -#: whatsnew/3.12.rst:1810 +#: whatsnew/3.12.rst:1816 msgid "" "Add ``COMPILEALL_OPTS`` variable in :file:`Makefile` to override :mod:" "`compileall` options (default: ``-j0``) in ``make install``. Also merged the " @@ -3613,46 +3611,46 @@ msgid "" "`99289`.)" msgstr "" -#: whatsnew/3.12.rst:1816 +#: whatsnew/3.12.rst:1822 msgid "Add platform triplets for 64-bit LoongArch:" msgstr "" -#: whatsnew/3.12.rst:1818 +#: whatsnew/3.12.rst:1824 msgid "loongarch64-linux-gnusf" msgstr "" -#: whatsnew/3.12.rst:1819 +#: whatsnew/3.12.rst:1825 msgid "loongarch64-linux-gnuf32" msgstr "" -#: whatsnew/3.12.rst:1820 +#: whatsnew/3.12.rst:1826 msgid "loongarch64-linux-gnu" msgstr "" -#: whatsnew/3.12.rst:1822 +#: whatsnew/3.12.rst:1828 msgid "(Contributed by Zhang Na in :gh:`90656`.)" msgstr "" -#: whatsnew/3.12.rst:1824 +#: whatsnew/3.12.rst:1830 msgid "``PYTHON_FOR_REGEN`` now require Python 3.10 or newer." msgstr "" -#: whatsnew/3.12.rst:1826 +#: whatsnew/3.12.rst:1832 msgid "" "Autoconf 2.71 and aclocal 1.16.4 is now required to regenerate :file:`!" "configure`. (Contributed by Christian Heimes in :gh:`89886`.)" msgstr "" -#: whatsnew/3.12.rst:1830 +#: whatsnew/3.12.rst:1836 msgid "" "Windows builds and macOS installers from python.org now use OpenSSL 3.0." msgstr "" -#: whatsnew/3.12.rst:1834 +#: whatsnew/3.12.rst:1840 msgid "C API Changes" msgstr "" -#: whatsnew/3.12.rst:1841 +#: whatsnew/3.12.rst:1847 msgid "" ":pep:`697`: Introduce the :ref:`Unstable C API tier <unstable-c-api>`, " "intended for low-level tools like debuggers and JIT compilers. This API may " @@ -3660,84 +3658,84 @@ msgid "" "contents are marked by the ``PyUnstable_`` prefix in names." msgstr "" -#: whatsnew/3.12.rst:1847 +#: whatsnew/3.12.rst:1853 msgid "Code object constructors:" msgstr "" -#: whatsnew/3.12.rst:1849 +#: whatsnew/3.12.rst:1855 msgid "``PyUnstable_Code_New()`` (renamed from ``PyCode_New``)" msgstr "" -#: whatsnew/3.12.rst:1850 +#: whatsnew/3.12.rst:1856 msgid "" "``PyUnstable_Code_NewWithPosOnlyArgs()`` (renamed from " "``PyCode_NewWithPosOnlyArgs``)" msgstr "" -#: whatsnew/3.12.rst:1852 +#: whatsnew/3.12.rst:1858 msgid "Extra storage for code objects (:pep:`523`):" msgstr "" -#: whatsnew/3.12.rst:1854 +#: whatsnew/3.12.rst:1860 msgid "" "``PyUnstable_Eval_RequestCodeExtraIndex()`` (renamed from " "``_PyEval_RequestCodeExtraIndex``)" msgstr "" -#: whatsnew/3.12.rst:1855 +#: whatsnew/3.12.rst:1861 msgid "``PyUnstable_Code_GetExtra()`` (renamed from ``_PyCode_GetExtra``)" msgstr "" -#: whatsnew/3.12.rst:1856 +#: whatsnew/3.12.rst:1862 msgid "``PyUnstable_Code_SetExtra()`` (renamed from ``_PyCode_SetExtra``)" msgstr "" -#: whatsnew/3.12.rst:1858 +#: whatsnew/3.12.rst:1864 msgid "" "The original names will continue to be available until the respective API " "changes." msgstr "" -#: whatsnew/3.12.rst:1861 +#: whatsnew/3.12.rst:1867 msgid "(Contributed by Petr Viktorin in :gh:`101101`.)" msgstr "" -#: whatsnew/3.12.rst:1863 +#: whatsnew/3.12.rst:1869 msgid "" ":pep:`697`: Add an API for extending types whose instance memory layout is " "opaque:" msgstr "" -#: whatsnew/3.12.rst:1866 +#: whatsnew/3.12.rst:1872 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:1868 +#: whatsnew/3.12.rst:1874 msgid "" ":c:func:`PyObject_GetTypeData` and :c:func:`PyType_GetTypeDataSize` added to " "allow access to subclass-specific instance data." msgstr "" -#: whatsnew/3.12.rst:1870 +#: whatsnew/3.12.rst:1876 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:1873 +#: whatsnew/3.12.rst:1879 msgid "" ":c:macro:`Py_RELATIVE_OFFSET` added to allow defining :c:type:`members " "<PyMemberDef>` in terms of a subclass-specific struct." msgstr "" -#: whatsnew/3.12.rst:1876 +#: whatsnew/3.12.rst:1882 msgid "(Contributed by Petr Viktorin in :gh:`103509`.)" msgstr "" -#: whatsnew/3.12.rst:1878 +#: whatsnew/3.12.rst:1884 msgid "" "Add the new :ref:`limited C API <limited-c-api>` function :c:func:" "`PyType_FromMetaclass`, which generalizes the existing :c:func:" @@ -3745,29 +3743,29 @@ msgid "" "(Contributed by Wenzel Jakob in :gh:`93012`.)" msgstr "" -#: whatsnew/3.12.rst:1883 +#: whatsnew/3.12.rst:1889 msgid "" "API for creating objects that can be called using :ref:`the vectorcall " "protocol <vectorcall>` was added to the :ref:`Limited API <stable>`:" msgstr "" -#: whatsnew/3.12.rst:1887 +#: whatsnew/3.12.rst:1893 msgid ":c:macro:`Py_TPFLAGS_HAVE_VECTORCALL`" msgstr "" -#: whatsnew/3.12.rst:1888 +#: whatsnew/3.12.rst:1894 msgid ":c:func:`PyVectorcall_NARGS`" msgstr "" -#: whatsnew/3.12.rst:1889 +#: whatsnew/3.12.rst:1895 msgid ":c:func:`PyVectorcall_Call`" msgstr "" -#: whatsnew/3.12.rst:1890 +#: whatsnew/3.12.rst:1896 msgid ":c:type:`vectorcallfunc`" msgstr "" -#: whatsnew/3.12.rst:1892 +#: whatsnew/3.12.rst:1898 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 " @@ -3778,7 +3776,7 @@ msgid "" "`93274`.)" msgstr "" -#: whatsnew/3.12.rst:1900 +#: whatsnew/3.12.rst:1906 msgid "" "The :c:macro:`Py_TPFLAGS_MANAGED_DICT` and :c:macro:" "`Py_TPFLAGS_MANAGED_WEAKREF` flags have been added. This allows extensions " @@ -3786,32 +3784,32 @@ msgid "" "bookkeeping, using less memory and with faster access." msgstr "" -#: whatsnew/3.12.rst:1905 +#: whatsnew/3.12.rst:1911 msgid "" "API for performing calls using :ref:`the vectorcall protocol <vectorcall>` " "was added to the :ref:`Limited API <stable>`:" msgstr "" -#: whatsnew/3.12.rst:1909 +#: whatsnew/3.12.rst:1915 msgid ":c:func:`PyObject_Vectorcall`" msgstr "" -#: whatsnew/3.12.rst:1910 +#: whatsnew/3.12.rst:1916 msgid ":c:func:`PyObject_VectorcallMethod`" msgstr "" -#: whatsnew/3.12.rst:1911 +#: whatsnew/3.12.rst:1917 msgid ":c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET`" msgstr "" -#: whatsnew/3.12.rst:1913 +#: whatsnew/3.12.rst:1919 msgid "" "This means that both the incoming and outgoing ends of the vector call " "protocol are now available in the :ref:`Limited API <stable>`. (Contributed " "by Wenzel Jakob in :gh:`98586`.)" msgstr "" -#: whatsnew/3.12.rst:1917 +#: whatsnew/3.12.rst:1923 msgid "" "Add two new public functions, :c:func:`PyEval_SetProfileAllThreads` and :c:" "func:`PyEval_SetTraceAllThreads`, that allow to set tracing and profiling " @@ -3819,14 +3817,14 @@ msgid "" "(Contributed by Pablo Galindo in :gh:`93503`.)" msgstr "" -#: whatsnew/3.12.rst:1923 +#: whatsnew/3.12.rst:1929 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:1927 +#: whatsnew/3.12.rst:1933 msgid "" "The C API now permits registering callbacks via :c:func:" "`PyDict_AddWatcher`, :c:func:`PyDict_Watch` and related APIs to be called " @@ -3835,28 +3833,28 @@ msgid "" "`91052`.)" msgstr "" -#: whatsnew/3.12.rst:1933 +#: whatsnew/3.12.rst:1939 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:1937 +#: whatsnew/3.12.rst:1943 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:1942 +#: whatsnew/3.12.rst:1948 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:1946 +#: whatsnew/3.12.rst:1952 msgid "" "Add :c:func:`PyErr_GetRaisedException` and :c:func:" "`PyErr_SetRaisedException` for saving and restoring the current exception. " @@ -3866,14 +3864,14 @@ msgid "" "(Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:1954 +#: whatsnew/3.12.rst:1960 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:1958 +#: whatsnew/3.12.rst:1964 msgid "" "Add :c:func:`PyException_GetArgs` and :c:func:`PyException_SetArgs` as " "convenience functions for retrieving and modifying the :attr:`~BaseException." @@ -3881,71 +3879,71 @@ msgid "" "in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:1963 +#: whatsnew/3.12.rst:1969 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:1969 +#: whatsnew/3.12.rst:1975 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:1972 +#: whatsnew/3.12.rst:1978 msgid "``_Py_IMMORTAL_REFCNT``: The reference count that defines an object" msgstr "" -#: whatsnew/3.12.rst:1973 +#: whatsnew/3.12.rst:1979 msgid "as immortal." msgstr "" -#: whatsnew/3.12.rst:1974 +#: whatsnew/3.12.rst:1980 msgid "" "``_Py_IsImmortal`` Checks if an object has the immortal reference count." msgstr "" -#: whatsnew/3.12.rst:1975 +#: whatsnew/3.12.rst:1981 msgid "``PyObject_HEAD_INIT`` This will now initialize reference count to" msgstr "" -#: whatsnew/3.12.rst:1976 +#: whatsnew/3.12.rst:1982 msgid "``_Py_IMMORTAL_REFCNT`` when used with ``Py_BUILD_CORE``." msgstr "" -#: whatsnew/3.12.rst:1977 +#: whatsnew/3.12.rst:1983 msgid "``SSTATE_INTERNED_IMMORTAL`` An identifier for interned unicode objects" msgstr "" -#: whatsnew/3.12.rst:1978 +#: whatsnew/3.12.rst:1984 msgid "that are immortal." msgstr "" -#: whatsnew/3.12.rst:1979 +#: whatsnew/3.12.rst:1985 msgid "``SSTATE_INTERNED_IMMORTAL_STATIC`` An identifier for interned unicode" msgstr "" -#: whatsnew/3.12.rst:1980 +#: whatsnew/3.12.rst:1986 msgid "objects that are immortal and static" msgstr "" -#: whatsnew/3.12.rst:1981 +#: whatsnew/3.12.rst:1987 msgid "``sys.getunicodeinternedsize`` This returns the total number of unicode" msgstr "" -#: whatsnew/3.12.rst:1982 +#: whatsnew/3.12.rst:1988 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:1985 +#: whatsnew/3.12.rst:1991 msgid "(Contributed by Eddie Elizondo in :gh:`84436`.)" msgstr "" -#: whatsnew/3.12.rst:1987 +#: whatsnew/3.12.rst:1993 msgid "" ":pep:`684`: Add the new :c:func:`Py_NewInterpreterFromConfig` function and :" "c:type:`PyInterpreterConfig`, which may be used to create sub-interpreters " @@ -3953,27 +3951,27 @@ msgid "" "(Contributed by Eric Snow in :gh:`104110`.)" msgstr "" -#: whatsnew/3.12.rst:1993 +#: whatsnew/3.12.rst:1999 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:2001 +#: whatsnew/3.12.rst:2007 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:2004 +#: whatsnew/3.12.rst:2010 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:2008 +#: whatsnew/3.12.rst:2014 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 " @@ -3982,7 +3980,7 @@ msgid "" "necessary, the (internal-only) ``_PyObject_GET_WEAKREFS_LISTPTR()`` macro." msgstr "" -#: whatsnew/3.12.rst:2015 +#: whatsnew/3.12.rst:2021 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 " @@ -3990,13 +3988,13 @@ msgid "" "only field directly." msgstr "" -#: whatsnew/3.12.rst:2020 +#: whatsnew/3.12.rst:2026 msgid "" "To get a list of subclasses, call the Python method :py:meth:`~type." "__subclasses__` (using :c:func:`PyObject_CallMethod`, for example)." msgstr "" -#: whatsnew/3.12.rst:2024 +#: whatsnew/3.12.rst:2030 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 " @@ -4005,7 +4003,7 @@ msgid "" "`98836`.)" msgstr "" -#: whatsnew/3.12.rst:2030 +#: whatsnew/3.12.rst:2036 msgid "" "An unrecognized format character in :c:func:`PyUnicode_FromFormat` and :c:" "func:`PyUnicode_FromFormatV` now sets a :exc:`SystemError`. In previous " @@ -4014,13 +4012,13 @@ msgid "" "Storchaka in :gh:`95781`.)" msgstr "" -#: whatsnew/3.12.rst:2036 +#: whatsnew/3.12.rst:2042 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:2040 +#: whatsnew/3.12.rst:2046 msgid "" "Extension classes wanting to add a :attr:`~object.__dict__` or weak " "reference slot should use :c:macro:`Py_TPFLAGS_MANAGED_DICT` and :c:macro:" @@ -4034,7 +4032,7 @@ msgid "" "func:`PyObject_ClearWeakRefs`, as before." msgstr "" -#: whatsnew/3.12.rst:2052 +#: whatsnew/3.12.rst:2058 msgid "" "The :c:func:`PyUnicode_FSDecoder` function no longer accepts bytes-like " "paths, like :class:`bytearray` and :class:`memoryview` types: only the " @@ -4042,7 +4040,7 @@ msgid "" "Victor Stinner in :gh:`98393`.)" msgstr "" -#: whatsnew/3.12.rst:2057 +#: whatsnew/3.12.rst:2063 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 " @@ -4050,7 +4048,7 @@ msgid "" "Stinner in :gh:`98724`.)" msgstr "" -#: whatsnew/3.12.rst:2062 +#: whatsnew/3.12.rst:2068 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 " @@ -4058,7 +4056,7 @@ msgid "" "(Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2067 +#: whatsnew/3.12.rst:2073 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 " @@ -4066,25 +4064,25 @@ msgid "" "``_Py_GetGlobalRefTotal()``." msgstr "" -#: whatsnew/3.12.rst:2072 +#: whatsnew/3.12.rst:2078 msgid "" "The following functions now select an appropriate metaclass for the newly " "created type:" msgstr "" -#: whatsnew/3.12.rst:2075 +#: whatsnew/3.12.rst:2081 msgid ":c:func:`PyType_FromSpec`" msgstr "" -#: whatsnew/3.12.rst:2076 +#: whatsnew/3.12.rst:2082 msgid ":c:func:`PyType_FromSpecWithBases`" msgstr "" -#: whatsnew/3.12.rst:2077 +#: whatsnew/3.12.rst:2083 msgid ":c:func:`PyType_FromModuleAndSpec`" msgstr "" -#: whatsnew/3.12.rst:2079 +#: whatsnew/3.12.rst:2085 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 " @@ -4092,14 +4090,14 @@ msgid "" "initialization." msgstr "" -#: whatsnew/3.12.rst:2084 +#: whatsnew/3.12.rst:2090 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:2088 +#: whatsnew/3.12.rst:2094 msgid "" "Since ``tp_new`` overrides almost everything ``PyType_From*`` functions do, " "the two are incompatible with each other. The existing behavior -- ignoring " @@ -4108,17 +4106,17 @@ msgid "" "general workaround. One of the following may work for you:" msgstr "" -#: whatsnew/3.12.rst:2095 +#: whatsnew/3.12.rst:2101 msgid "If you control the metaclass, avoid using ``tp_new`` in it:" msgstr "" -#: whatsnew/3.12.rst:2097 +#: whatsnew/3.12.rst:2103 msgid "" "If initialization can be skipped, it can be done in :c:member:`~PyTypeObject." "tp_init` instead." msgstr "" -#: whatsnew/3.12.rst:2099 +#: whatsnew/3.12.rst:2105 msgid "" "If the metaclass doesn't need to be instantiated from Python, set its " "``tp_new`` to ``NULL`` using the :c:macro:" @@ -4126,20 +4124,20 @@ msgid "" "``PyType_From*`` functions." msgstr "" -#: whatsnew/3.12.rst:2104 +#: whatsnew/3.12.rst:2110 msgid "" "Avoid ``PyType_From*`` functions: if you don't need C-specific features " "(slots or setting the instance size), create types by :ref:`calling <call>` " "the metaclass." msgstr "" -#: whatsnew/3.12.rst:2108 +#: whatsnew/3.12.rst:2114 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:2111 +#: whatsnew/3.12.rst:2117 msgid "" ":c:var:`PyOS_InputHook` and :c:var:`PyOS_ReadlineFunctionPointer` are no " "longer called in :ref:`subinterpreters <sub-interpreter-support>`. This is " @@ -4147,14 +4145,14 @@ msgid "" "callbacks have no way of recovering extension module state)." msgstr "" -#: whatsnew/3.12.rst:2116 +#: whatsnew/3.12.rst:2122 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:2120 +#: whatsnew/3.12.rst:2126 msgid "" ":c:struct:`PyLongObject` has had its internals changed for better " "performance. Although the internals of :c:struct:`PyLongObject` are private, " @@ -4165,15 +4163,15 @@ msgid "" "a single machine word:" msgstr "" -#: whatsnew/3.12.rst:2128 +#: whatsnew/3.12.rst:2134 msgid ":c:func:`PyUnstable_Long_IsCompact`" msgstr "" -#: whatsnew/3.12.rst:2129 +#: whatsnew/3.12.rst:2135 msgid ":c:func:`PyUnstable_Long_CompactValue`" msgstr "" -#: whatsnew/3.12.rst:2131 +#: whatsnew/3.12.rst:2137 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 " @@ -4182,7 +4180,7 @@ msgid "" "create a new GitHub issue and CC ``@ericsnowcurrently``." msgstr "" -#: whatsnew/3.12.rst:2141 +#: whatsnew/3.12.rst:2147 msgid "" "In accordance with :pep:`699`, the ``ma_version_tag`` field in :c:type:" "`PyDictObject` is deprecated for extension modules. Accessing this field " @@ -4191,215 +4189,215 @@ msgid "" "PEP by Ken Jin.)" msgstr "" -#: whatsnew/3.12.rst:2146 +#: whatsnew/3.12.rst:2152 msgid "Deprecate global configuration variable:" msgstr "" -#: whatsnew/3.12.rst:2148 +#: whatsnew/3.12.rst:2154 msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug`" msgstr "" -#: whatsnew/3.12.rst:2149 +#: whatsnew/3.12.rst:2155 msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose`" msgstr "" -#: whatsnew/3.12.rst:2150 +#: whatsnew/3.12.rst:2156 msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet`" msgstr "" -#: whatsnew/3.12.rst:2151 +#: whatsnew/3.12.rst:2157 msgid ":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive`" msgstr "" -#: whatsnew/3.12.rst:2152 +#: whatsnew/3.12.rst:2158 msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect`" msgstr "" -#: whatsnew/3.12.rst:2153 +#: whatsnew/3.12.rst:2159 msgid ":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level`" msgstr "" -#: whatsnew/3.12.rst:2154 +#: whatsnew/3.12.rst:2160 msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import`" msgstr "" -#: whatsnew/3.12.rst:2155 +#: whatsnew/3.12.rst:2161 msgid ":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning`" msgstr "" -#: whatsnew/3.12.rst:2156 +#: whatsnew/3.12.rst:2162 msgid ":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings`" msgstr "" -#: whatsnew/3.12.rst:2157 +#: whatsnew/3.12.rst:2163 msgid "" ":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment`" msgstr "" -#: whatsnew/3.12.rst:2158 +#: whatsnew/3.12.rst:2164 msgid "" ":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode`" msgstr "" -#: whatsnew/3.12.rst:2159 +#: whatsnew/3.12.rst:2165 msgid "" ":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig.user_site_directory`" msgstr "" -#: whatsnew/3.12.rst:2160 +#: whatsnew/3.12.rst:2166 msgid "" ":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio`" msgstr "" -#: whatsnew/3.12.rst:2161 +#: whatsnew/3.12.rst:2167 msgid "" ":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " "and :c:member:`PyConfig.hash_seed`" msgstr "" -#: whatsnew/3.12.rst:2163 +#: whatsnew/3.12.rst:2169 msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated`" msgstr "" -#: whatsnew/3.12.rst:2164 +#: whatsnew/3.12.rst:2170 msgid "" ":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." "legacy_windows_fs_encoding`" msgstr "" -#: whatsnew/3.12.rst:2165 +#: whatsnew/3.12.rst:2171 msgid "" ":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." "legacy_windows_stdio`" msgstr "" -#: whatsnew/3.12.rst:2166 +#: whatsnew/3.12.rst:2172 msgid "" ":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding`" msgstr "" -#: whatsnew/3.12.rst:2167 +#: whatsnew/3.12.rst:2173 msgid "" ":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding`" msgstr "" -#: whatsnew/3.12.rst:2168 +#: whatsnew/3.12.rst:2174 msgid "" ":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." "filesystem_errors`" msgstr "" -#: whatsnew/3.12.rst:2169 +#: whatsnew/3.12.rst:2175 msgid "" ":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` (see :c:func:" "`Py_PreInitialize`)" msgstr "" -#: whatsnew/3.12.rst:2171 +#: whatsnew/3.12.rst:2177 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:2175 +#: whatsnew/3.12.rst:2181 msgid "" "Creating :c:data:`immutable types <Py_TPFLAGS_IMMUTABLETYPE>` with mutable " "bases is deprecated and will be disabled in Python 3.14. (:gh:`95388`)" msgstr "" -#: whatsnew/3.12.rst:2178 +#: whatsnew/3.12.rst:2184 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:2181 +#: whatsnew/3.12.rst:2187 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:2184 +#: whatsnew/3.12.rst:2190 msgid "" ":c:struct:`PyMemberDef`, :c:func:`PyMember_GetOne` and :c:func:" "`PyMember_SetOne`" msgstr "" -#: whatsnew/3.12.rst:2186 +#: whatsnew/3.12.rst:2192 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:2188 +#: whatsnew/3.12.rst:2194 msgid "" "The flags :c:macro:`Py_READONLY` (previously ``READONLY``) and :c:macro:" "`Py_AUDIT_READ` (previously all uppercase)" msgstr "" -#: whatsnew/3.12.rst:2191 +#: whatsnew/3.12.rst:2197 msgid "Several items are not exposed from :file:`Python.h`:" msgstr "" -#: whatsnew/3.12.rst:2193 +#: whatsnew/3.12.rst:2199 msgid ":c:macro:`T_OBJECT` (use :c:macro:`Py_T_OBJECT_EX`)" msgstr "" -#: whatsnew/3.12.rst:2194 +#: whatsnew/3.12.rst:2200 msgid ":c:macro:`T_NONE` (previously undocumented, and pretty quirky)" msgstr "" -#: whatsnew/3.12.rst:2195 +#: whatsnew/3.12.rst:2201 msgid "The macro ``WRITE_RESTRICTED`` which does nothing." msgstr "" -#: whatsnew/3.12.rst:2196 +#: whatsnew/3.12.rst:2202 msgid "" "The macros ``RESTRICTED`` and ``READ_RESTRICTED``, equivalents of :c:macro:" "`Py_AUDIT_READ`." msgstr "" -#: whatsnew/3.12.rst:2198 +#: whatsnew/3.12.rst:2204 msgid "" "In some configurations, ``<stddef.h>`` is not included from :file:`Python." "h`. It should be included manually when using ``offsetof()``." msgstr "" -#: whatsnew/3.12.rst:2201 +#: whatsnew/3.12.rst:2207 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:2206 +#: whatsnew/3.12.rst:2212 msgid "" "(Contributed in :gh:`47146` by Petr Viktorin, based on earlier work by " "Alexander Belopolsky and Matthias Braun.)" msgstr "" -#: whatsnew/3.12.rst:2209 +#: whatsnew/3.12.rst:2215 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:2214 +#: whatsnew/3.12.rst:2220 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:2217 +#: whatsnew/3.12.rst:2223 msgid "" "``_PyErr_ChainExceptions`` is deprecated. Use ``_PyErr_ChainExceptions1`` " "instead. (Contributed by Irit Katriel in :gh:`102192`.)" msgstr "" -#: whatsnew/3.12.rst:2220 +#: whatsnew/3.12.rst:2226 msgid "" "Using :c:func:`PyType_FromSpec`, :c:func:`PyType_FromSpecWithBases` or :c:" "func:`PyType_FromModuleAndSpec` to create a class whose metaclass overrides :" @@ -4739,86 +4737,86 @@ msgstr "" msgid ":c:func:`PyThread_ReInitTLS`: Unneeded since Python 3.7." msgstr "" -#: whatsnew/3.12.rst:2236 +#: whatsnew/3.12.rst:2242 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:2241 +#: whatsnew/3.12.rst:2247 msgid "Legacy Unicode APIs have been removed. See :pep:`623` for detail." msgstr "" -#: whatsnew/3.12.rst:2243 +#: whatsnew/3.12.rst:2249 msgid ":c:macro:`!PyUnicode_WCHAR_KIND`" msgstr "" -#: whatsnew/3.12.rst:2244 +#: whatsnew/3.12.rst:2250 msgid ":c:func:`!PyUnicode_AS_UNICODE`" msgstr "" -#: whatsnew/3.12.rst:2245 +#: whatsnew/3.12.rst:2251 msgid ":c:func:`!PyUnicode_AsUnicode`" msgstr "" -#: whatsnew/3.12.rst:2246 +#: whatsnew/3.12.rst:2252 msgid ":c:func:`!PyUnicode_AsUnicodeAndSize`" msgstr "" -#: whatsnew/3.12.rst:2247 +#: whatsnew/3.12.rst:2253 msgid ":c:func:`!PyUnicode_AS_DATA`" msgstr "" -#: whatsnew/3.12.rst:2248 +#: whatsnew/3.12.rst:2254 msgid ":c:func:`!PyUnicode_FromUnicode`" msgstr "" -#: whatsnew/3.12.rst:2249 +#: whatsnew/3.12.rst:2255 msgid ":c:func:`!PyUnicode_GET_SIZE`" msgstr "" -#: whatsnew/3.12.rst:2250 +#: whatsnew/3.12.rst:2256 msgid ":c:func:`!PyUnicode_GetSize`" msgstr "" -#: whatsnew/3.12.rst:2251 +#: whatsnew/3.12.rst:2257 msgid ":c:func:`!PyUnicode_GET_DATA_SIZE`" msgstr "" -#: whatsnew/3.12.rst:2253 +#: whatsnew/3.12.rst:2259 msgid "" "Remove the ``PyUnicode_InternImmortal()`` function macro. (Contributed by " "Victor Stinner in :gh:`85858`.)" msgstr "" -#: whatsnew/3.12.rst:2257 +#: whatsnew/3.12.rst:2263 msgid "Notable changes in 3.12.4" msgstr "" -#: whatsnew/3.12.rst:2260 +#: whatsnew/3.12.rst:2266 msgid "ipaddress" msgstr "" -#: whatsnew/3.12.rst:2262 +#: whatsnew/3.12.rst:2268 msgid "" "Fixed ``is_global`` and ``is_private`` behavior in ``IPv4Address``, " "``IPv6Address``, ``IPv4Network`` and ``IPv6Network``." msgstr "" -#: whatsnew/3.12.rst:2267 +#: whatsnew/3.12.rst:2273 msgid "Notable changes in 3.12.5" msgstr "" -#: whatsnew/3.12.rst:2287 +#: whatsnew/3.12.rst:2293 msgid "email" msgstr "" -#: whatsnew/3.12.rst:2273 +#: whatsnew/3.12.rst:2279 msgid "Headers with embedded newlines are now quoted on output." msgstr "" -#: whatsnew/3.12.rst:2275 +#: whatsnew/3.12.rst:2281 msgid "" "The :mod:`~email.generator` will now refuse to serialize (write) headers " "that are improperly folded or delimited, such that they would be parsed as " @@ -4828,11 +4826,11 @@ msgid "" "in :gh:`121650`.)" msgstr "" -#: whatsnew/3.12.rst:2284 +#: whatsnew/3.12.rst:2290 msgid "Notable changes in 3.12.6" msgstr "" -#: whatsnew/3.12.rst:2289 +#: whatsnew/3.12.rst:2295 msgid "" ":func:`email.utils.getaddresses` and :func:`email.utils.parseaddr` now " "return ``('', '')`` 2-tuples in more situations where invalid email " @@ -4843,3 +4841,14 @@ msgid "" "check if the *strict* paramater is available. (Contributed by Thomas Dwyer " "and Victor Stinner for :gh:`102988` to improve the CVE-2023-27043 fix.)" msgstr "" + +#: whatsnew/3.12.rst:2307 +msgid "Notable changes in 3.12.8" +msgstr "" + +#: whatsnew/3.12.rst:2312 +msgid "" +"The previously undocumented special function :func:`sys.getobjects`, which " +"only exists in specialized builds of Python, may now return objects from " +"other interpreters than the one it's called in." +msgstr "" diff --git a/whatsnew/3.4.po b/whatsnew/3.4.po index 81dff322e..fe3daabc7 100644 --- a/whatsnew/3.4.po +++ b/whatsnew/3.4.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -2797,7 +2797,7 @@ msgstr "" #: whatsnew/3.4.rst:1982 msgid "" -"A new opcode, :opcode:`LOAD_CLASSDEREF`, has been added to fix a bug in the " +"A new opcode, :opcode:`!LOAD_CLASSDEREF`, has been added to fix a bug in the " "loading of free variables in class bodies that could be triggered by certain " "uses of :ref:`__prepare__ <prepare>`. (Contributed by Benjamin Peterson in :" "issue:`17853`.)" diff --git a/whatsnew/3.6.po b/whatsnew/3.6.po index 9306695d5..286396db1 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -3360,10 +3360,10 @@ msgstr "" #: 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:" -"`CALL_FUNCTION`, :opcode:`CALL_FUNCTION_KW` and :opcode:" -"`BUILD_MAP_UNPACK_WITH_CALL` opcodes have been modified, the new :opcode:" -"`CALL_FUNCTION_EX` and :opcode:`BUILD_TUPLE_UNPACK_WITH_CALL` have been " +"and simpler implementation. The :opcode:`MAKE_FUNCTION`, :opcode:`!" +"CALL_FUNCTION`, :opcode:`!CALL_FUNCTION_KW` and :opcode:`!" +"BUILD_MAP_UNPACK_WITH_CALL` opcodes have been modified, the new :opcode:" +"`CALL_FUNCTION_EX` and :opcode:`!BUILD_TUPLE_UNPACK_WITH_CALL` have been " "added, and ``CALL_FUNCTION_VAR``, ``CALL_FUNCTION_VAR_KW`` and " "``MAKE_CLOSURE`` opcodes have been removed. (Contributed by Demur Rumed in :" "issue:`27095`, and Serhiy Storchaka in :issue:`27213`, :issue:`28257`.)" @@ -3371,7 +3371,7 @@ msgstr "" #: whatsnew/3.6.rst:2389 msgid "" -"The new :opcode:`SETUP_ANNOTATIONS` and :opcode:`STORE_ANNOTATION` opcodes " +"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 "" diff --git a/whatsnew/3.7.po b/whatsnew/3.7.po index 9e25487ba..04aa1d7d4 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -3531,14 +3531,14 @@ msgstr "" #: whatsnew/3.7.rst:2479 msgid "" -"There are two new opcodes: :opcode:`LOAD_METHOD` and :opcode:`CALL_METHOD`. " +"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:2482 msgid "" -"The :opcode:`STORE_ANNOTATION` opcode has been removed. (Contributed by Mark " -"Shannon in :issue:`32550`.)" +"The :opcode:`!STORE_ANNOTATION` opcode has been removed. (Contributed by " +"Mark Shannon in :issue:`32550`.)" msgstr "" #: whatsnew/3.7.rst:2489 diff --git a/whatsnew/3.8.po b/whatsnew/3.8.po index c22cb12ce..3366cbefe 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-11-01 00:21+0000\n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" "PO-Revision-Date: 2023-02-03 17:30+0300\n" "Last-Translator: \n" "Language-Team: TURKISH <python.docs.tr@gmail.com>\n" @@ -1774,7 +1774,7 @@ msgstr "kayıt tutma" #: whatsnew/3.8.rst:939 #, fuzzy msgid "" -"Added a *force* keyword argument to :func:`logging.basicConfig` When set to " +"Added a *force* keyword argument to :func:`logging.basicConfig`. When set to " "true, any existing handlers attached to the root logger are removed and " "closed before carrying out the configuration specified by the other " "arguments." @@ -4284,12 +4284,13 @@ msgstr "" "çağırmak için açık talimatlar yayınlar." #: whatsnew/3.8.rst:2155 +#, fuzzy msgid "" -"Removed opcodes :opcode:`BREAK_LOOP`, :opcode:`CONTINUE_LOOP`, :opcode:" -"`SETUP_LOOP` and :opcode:`SETUP_EXCEPT`. Added new opcodes :opcode:" -"`ROT_FOUR`, :opcode:`BEGIN_FINALLY`, :opcode:`CALL_FINALLY` and :opcode:" -"`POP_FINALLY`. Changed the behavior of :opcode:`END_FINALLY` and :opcode:" -"`WITH_CLEANUP_START`." +"Removed opcodes :opcode:`!BREAK_LOOP`, :opcode:`!CONTINUE_LOOP`, :opcode:`!" +"SETUP_LOOP` and :opcode:`!SETUP_EXCEPT`. Added new opcodes :opcode:`!" +"ROT_FOUR`, :opcode:`!BEGIN_FINALLY`, :opcode:`!CALL_FINALLY` and :opcode:`!" +"POP_FINALLY`. Changed the behavior of :opcode:`!END_FINALLY` and :opcode:`!" +"WITH_CLEANUP_START`." msgstr "" ":opcode:`BREAK_LOOP`, :opcode:`CONTINUE_LOOP`, :opcode:`SETUP_LOOP` ve :" "opcode:`SETUP_EXCEPT` kodları kaldırıldı. Yeni :opcode:`ROT_FOUR`, :opcode:" From 173a6da2cad61bb89e03ef5744c2ed7214b63dd0 Mon Sep 17 00:00:00 2001 From: python-docs-turkish <python.docs.tr@gmail.com> Date: Wed, 1 Jan 2025 00:23:26 +0000 Subject: [PATCH 2/2] Get changes from CPython Doc for 3.12 --- library/asynchat.po | 38 ++++++++++++++++++++++++++++++++++++++ library/asyncore.po | 38 ++++++++++++++++++++++++++++++++++++++ library/distutils.po | 35 +++++++++++++++++++++++++++++++++++ library/imp.po | 40 ++++++++++++++++++++++++++++++++++++++++ library/removed.po | 27 +++++++++++++++++++++++++++ library/smtpd.po | 40 ++++++++++++++++++++++++++++++++++++++++ 6 files changed, 218 insertions(+) create mode 100644 library/asynchat.po create mode 100644 library/asyncore.po create mode 100644 library/distutils.po create mode 100644 library/imp.po create mode 100644 library/removed.po create mode 100644 library/smtpd.po diff --git a/library/asynchat.po b/library/asynchat.po new file mode 100644 index 000000000..9a1b73554 --- /dev/null +++ b/library/asynchat.po @@ -0,0 +1,38 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: library/asynchat.rst:2 +msgid ":mod:`!asynchat` --- Asynchronous socket command/response handler" +msgstr "" + +#: library/asynchat.rst:10 +msgid "" +"This module is no longer part of the Python standard library. It was :ref:" +"`removed in Python 3.12 <whatsnew312-removed>` after being deprecated in " +"Python 3.6. The removal was decided in :pep:`594`." +msgstr "" + +#: library/asynchat.rst:14 +msgid "Applications should use the :mod:`asyncio` module instead." +msgstr "" + +#: library/asynchat.rst:16 +msgid "" +"The last version of Python that provided the :mod:`!asynchat` module was " +"`Python 3.11 <https://docs.python.org/3.11/library/asynchat.html>`_." +msgstr "" diff --git a/library/asyncore.po b/library/asyncore.po new file mode 100644 index 000000000..8fde34c24 --- /dev/null +++ b/library/asyncore.po @@ -0,0 +1,38 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: library/asyncore.rst:2 +msgid ":mod:`!asyncore` --- Asynchronous socket handler" +msgstr "" + +#: library/asyncore.rst:10 +msgid "" +"This module is no longer part of the Python standard library. It was :ref:" +"`removed in Python 3.12 <whatsnew312-removed>` after being deprecated in " +"Python 3.6. The removal was decided in :pep:`594`." +msgstr "" + +#: library/asyncore.rst:14 +msgid "Applications should use the :mod:`asyncio` module instead." +msgstr "" + +#: library/asyncore.rst:16 +msgid "" +"The last version of Python that provided the :mod:`!asyncore` module was " +"`Python 3.11 <https://docs.python.org/3.11/library/asyncore.html>`_." +msgstr "" diff --git a/library/distutils.po b/library/distutils.po new file mode 100644 index 000000000..b1957ab38 --- /dev/null +++ b/library/distutils.po @@ -0,0 +1,35 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: library/distutils.rst:2 +msgid ":mod:`!distutils` --- Building and installing Python modules" +msgstr "" + +#: library/distutils.rst:10 +msgid "" +"This module is no longer part of the Python standard library. It was :ref:" +"`removed in Python 3.12 <whatsnew312-removed-distutils>` after being " +"deprecated in Python 3.10. The removal was decided in :pep:`632`, which has " +"`migration advice <https://peps.python.org/pep-0632/#migration-advice>`_." +msgstr "" + +#: library/distutils.rst:16 +msgid "" +"The last version of Python that provided the :mod:`!distutils` module was " +"`Python 3.11 <https://docs.python.org/3.11/library/distutils.html>`_." +msgstr "" diff --git a/library/imp.po b/library/imp.po new file mode 100644 index 000000000..15d53130c --- /dev/null +++ b/library/imp.po @@ -0,0 +1,40 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: library/imp.rst:2 +msgid ":mod:`!imp` --- Access the import internals" +msgstr "" + +#: library/imp.rst:10 +msgid "" +"This module is no longer part of the Python standard library. It was :ref:" +"`removed in Python 3.12 <whatsnew312-removed-imp>` after being deprecated in " +"Python 3.4." +msgstr "" + +#: library/imp.rst:14 +msgid "" +"The :ref:`removal notice <whatsnew312-removed-imp>` includes guidance for " +"migrating code from :mod:`!imp` to :mod:`importlib`." +msgstr "" + +#: library/imp.rst:17 +msgid "" +"The last version of Python that provided the :mod:`!imp` module was `Python " +"3.11 <https://docs.python.org/3.11/library/imp.html>`_." +msgstr "" diff --git a/library/removed.po b/library/removed.po new file mode 100644 index 000000000..8b40748bd --- /dev/null +++ b/library/removed.po @@ -0,0 +1,27 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: library/removed.rst:7 +msgid "Removed Modules" +msgstr "" + +#: library/removed.rst:9 +msgid "" +"The modules described in this chapter have been removed from the Python " +"standard library. They are documented here to help people find replacements." +msgstr "" diff --git a/library/smtpd.po b/library/smtpd.po new file mode 100644 index 000000000..ff8e0d25b --- /dev/null +++ b/library/smtpd.po @@ -0,0 +1,40 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.12\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-01-01 00:22+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: library/smtpd.rst:2 +msgid ":mod:`!smtpd` --- SMTP Server" +msgstr "" + +#: library/smtpd.rst:10 +msgid "" +"This module is no longer part of the Python standard library. It was :ref:" +"`removed in Python 3.12 <whatsnew312-removed>` after being deprecated in " +"Python 3.6. The removal was decided in :pep:`594`." +msgstr "" + +#: library/smtpd.rst:14 +msgid "" +"A possible replacement is the third-party :pypi:`aiosmtpd` library. This " +"library is not maintained or supported by the Python core team." +msgstr "" + +#: library/smtpd.rst:17 +msgid "" +"The last version of Python that provided the :mod:`!smtpd` module was " +"`Python 3.11 <https://docs.python.org/3.11/library/smtpd.html>`_." +msgstr ""